Auto-configuration Guide - Telco Support

Transcript

EdgeGate VoIP Gateway Auto-Configuration Guide AC-232/GW-232 AC-282/GW-282 GW-282S GW482S/GW483S/ GW483D Rev. H Revision History Revision Date Description A Dec 2004 Initial release for AC211 B July 2006 Added AC/GW-232, AC-282, GW-282S, GW-482S products and adapted to Version 4.57. C Nov 2007 Added GW-483S product. Adapted to version 5.8.3 D May 2009 Added GW-483D product. Added QoS configuration parameters. E June 2009 Added RSTP parameters. F August 2009 Added SIP security parameters for AC/GW-232. G December 2009 Added excluded VLAN ID range. H August 2010 Correct the battery traps support. Page 2 of 86 Rev. H The information in this document is subject to change without notice and describes only the product defined in the introduction of this document. This document is intended for the use of customers of Telco Systems only for the purposes of the agreement under which the document is submitted, and no part of it may be reproduced or transmitted in any form or means without the prior written permission of Telco Systems. The document is intended for use by professional and properly trained personnel, and the customer assumes full responsibility when using it. Telco Systems welcomes customer comments as part of the process of continuous development and improvement of the documentation. If the Release Notes that are shipped with the device contain information that conflicts with the information in the user guide or supplements it, the customer should follow the Release Notes. The information or statements given in this document concerning the suitability, capacity, or performance of the relevant hardware or software products are for general informational purposes only and are not considered binding. Only those statements and/or representations defined in the agreement executed between Telco Systems and the customer shall bind and obligate Telco Systems. Telco Systems however has made all reasonable efforts to ensure that the instructions contained in this document are adequate and free of material errors and omissions. Telco Systems will, if necessary, explain issues which may not be covered by the document. Telco Systems’ sole and exclusive liability for any errors in the document is limited to the documentary correction of errors. TELCO SYSTEMS IS NOT AND SHALL NOT BE RESPONSIBLE IN ANY EVENT FOR ERRORS IN THIS DOCUMENT OR FOR ANY DAMAGES OR LOSS OF WHATSOEVER KIND, WHETHER DIRECT, INCIDENTAL, OR CONSEQUENTIAL (INCLUDING MONETARY LOSSES), that might arise from the use of this document or the information in it. This document and the product it describes are the property of Telco Systems, which is the owner of all intellectual property rights therein, and are protected by copyright according to the applicable laws. Telco Systems logo is a registered trademark of Telco Systems, a BATM Company. BiNOS®, BiNOSCenter®, T-Marc®, T5 Compact™, T5C-XG™, T-Metro®, EdgeLink®, EdgeGate®, Access60®, AccessIP™, AccessMPLS™, AccessTDM™, AccessEthernet™, NetBeacon®, Metrobility®, and OutBurst® are trademarks of Telco Systems. Other product and company names mentioned in this document reserve their copyrights, trademarks, and registrations; they are mentioned for identification purposes only. Copyright © Telco Systems 2009. All rights reserved. Page 3 of 86 Rev. H Contacting Technical Support Telco Systems provides technical assistance for customers and partners. Users can obtain technical assistance by any of the following phone, fax and e-mail options: Web Access: http://www.telco.com/ BATM Advanced Communications—Main Support Center in Israel Tel: +972-4-993-5630 Fax: +972-4-993-7926 Email: mailto:[email protected] BATM/Telco Systems a BATM Company—for Americas Tel: 1-800-227-0937 (U.S.), 1-781-255-2120 (Outside U.S.) Fax: 1-781-255-2122 Email: [email protected] BATM Germany—for Northern Europe Tel: +49-241-463-5490 Fax: +49-241-463-5491 Email: [email protected] BATM France—for Southern Europe Tel: +33-15-671-2773 Fax: +33-14-377-1780 Email: [email protected] Telco Systems, a BATM Company Asia Pacific in Singapore Tel: +65-6-725-9901 Fax: +65-6-725-9889 Email: [email protected] Telco Systems Asia Pacific—Japan Tel: +81-3-5521-1705 Fax: +81-3-5510-9131 Email: [email protected] Page 4 of 86 Rev. H Contents CONTACTING TECHNICAL SUPPORT ............................................................................ 4 AUTO CONFIGURATION DOWNLOAD ON VOIP GATEWAYS................................................ 7 DOWNLOADING A CONFIGURATION FILE AND UPGRADE VERSIONS ........................... 7 Downloading the File Manually Using Telnet....................................................... 8 Downloading the File Manually Using the Web.................................................... 9 DHCP Automatic Configuration ........................................................................... 9 Fixed (Provisioned) HTTP or TFTP Automatic Configuration ........................... 14 Encrypting a Configuration File.......................................................................... 15 CONFIGURATION FILE PARAMETERS ......................................................................... 16 Auto Configuration and Copy .............................................................................. 16 Auto Configuration Parameters ........................................................................... 17 GW-282S Hardware Configuration Parameters ................................................. 22 NETWORKING PARAMETERS ...................................................................................................... 23 NETWORK AND IP INFORMATION CONFIGURATION PARAMETERS ............................ 23 NETWORK VLAN PARAMETERS ............................................................................... 25 NETWORK SERVICES PARAMETERS ........................................................................... 26 VOIP CONFIGURATION PARAMETERS...................................................................................... 29 SIP CONFIGURATION PARAMETERS .......................................................................... 29 MGCP CONFIGURATION PARAMETERS ..................................................................... 39 H.323 CONFIGURATION PARAMETERS ...................................................................... 42 H.323 and SIP Audio/CODEC Standards ........................................................... 45 MISCELLANEOUS CONFIGURATION PARAMETERS............................................................. 51 CLOCK AND CID LOCALIZATION CONFIGURATION PARAMETERS ............................. 51 RING SIGNAL FORMAT .............................................................................................. 52 PSTN (LIFE LINE) CONFIGURATION PARAMETERS ................................................... 52 SYSLOG DAEMON ADDRESS CONFIGURATION .......................................................... 53 UPLOAD SYSTEM CONFIGURATION FROM NVRAM ................................................. 54 PORT PROTOCOL CONFIGURATION ............................................................................ 54 OEM TYPE AND GENERIC MODE CONFIGURATION .................................................. 55 GAIN (VOLUME) CONFIGURATION ............................................................................ 55 KEYPAD CONFIGURATION ......................................................................................... 56 SIP ADVANCED CALLING FEATURES ........................................................................ 57 SIP DIRECT CALLING (PEER TO PEER) ...................................................................... 60 SIP CID CONFIGURATION WHEN CID INFORMATION IS MISSING............................. 60 When CID Name and Number are Missing ......................................................... 60 When CID Name is Missing and the Number is Available .................................. 60 SIP HALF CALL MODEL ............................................................................................ 61 VPN SOLUTION FOR SIP AND RTP PACKETS ............................................................ 61 SIP DISTINCTIVE RINGS AND CALL WAITING TONES ......................................................... 63 CALL PROGRESS TONES ............................................................................................ 65 CALL WAITING TONE CADENCES ............................................................................. 66 Detailed Configuration Description .................................................................... 66 Examples .............................................................................................................. 67 SNMP CONFIGURATION PARAMETERS ..................................................................... 67 Page 5 of 86 Rev. H SECURITY CONFIGURATION PARAMETERS ........................................................................... 70 PORT CONFIGURATION PARAMETERS .................................................................................... 74 IGMP CONFIGURATION PARAMETERS ..................................................................................... 76 IGMP CONFIGURATION ............................................................................................ 76 QOS CONFIGURATION PARAMETERS ....................................................................................... 78 RSTP CONFIGURATION PARAMETERS ..................................................................................... 80 CONFIGURATION FILE EXAMPLE .............................................................................................. 83 Page 6 of 86 Rev. F Auto Configuration Download on VoIP Gateways Telco Systems provides an automatic solution for upgrading and configuring the Telco Systems VoIP Gateways without the need for manual processes, by using the feature called Auto Configuration Download. The configuration file is downloaded automatically without the intervention of the service provider or the end user. The file is downloaded automatically to the Gateway via DHCP server, TFTP server or HTTP server. Downloading a Configuration File and Upgrade Versions A convenient way to set up the Gateway configuration is to download the configuration file to the Gateway. You can set the way in which the configuration file will be downloaded to the gateway. Any of the following download methods can be chosen. Manual download The configuration file and upgrade versions are downloaded directly via Telnet (see Downloading the File Manually Using Telnet) or the Web (see Downloading the File Manually Using the Web). DHCP server auto configuration (see DHCP Automatic Configuration) The configuration file and upgrade versions are downloaded automatically using a DHCP server that is located at the provider‟s network. The TFTP/HTTP server‟s IP address and the file name are provided by the DHCP server during the BOOTP process and at half lease time. You can set DHCP server Automatic Configuration either via the Web (see Setting DHCP Automatic Configuration via the Web) or via Telnet (see Setting DHCP Automatic Configuration via Telnet). Fixed (provisioned) TFTP/HTTP Auto Configuration (see Fixed (Provisioned) HTTP or TFTP Automatic Configuration) The configuration file and upgrade versions are downloaded automatically as needed during boot and at fixed polling intervals using a TFTP/HTTP server located at the provider‟s network. The TFTP/HTTP server IP address and the file name are provisioned into the gateway. You can set Fixed Automatic Configuration either via the Web (see Setting the TFTP/HTTP Server “Root” Configuration File via the Web) or via Telnet (see Setting the TFTP Server “Root” Configuration File via Telnet). Two kinds of configuration files can be downloaded: 1. “Root” configuration file - the first file to be downloaded. This file can include any of the Gateway configuration parameters and three execution flags. Each execution flag, when set, can initiate one of the following possible actions: Downloading a secondary General configuration file (when the following parameters, described in Example 2 after Table 2, are set as follows: AUTO_GEN_UPDATE is set to ENABLE and FILE_GEN_PARM_NAME is set to ipg_gen_sample.cfg). See Example 2 after Table 2. Upgrading the Gateway Application firmware (when the following parameters, described in Table 4, are set as follows: AUTO_APP_UPDATE is set to ENABLE and APP_FILE_NAME can be set for example to sip_282_4_42_23.rom). Upgrading the Gateway Loader firmware (when the following parameters, described in Table 6, are set as follows: AUTO_LDR_UPDATE is set to ENABLE and LDR_FILE_NAME can be set for example to upgr_282_4_42_24.rom). Auto Configuration Download on VoIP Gateways Page 7 of 86 Rev. H The “root” configuration file normally includes specific configuration parameters for the Gateway being loaded. Using the Gateway‟s MAC address we can identify each Gateway uniquely and therefore download to each Gateway its own “root” configuration file with the specific required parameters (Table 5). 2. “General” configuration file - The second configuration file will include general parameters, common to a few or all the Gateway units in the network and also the following execution flags. Upgrading the Gateway Application firmware (when the following parameters, described in Table 4, are set as follows: AUTO_APP_UPDATE is set to ENABLE and APP_FILE_NAME can be set for example to sip_282_4_42_23.rom). Upgrading the Gateway Loader firmware (when the following parameters, described in Table 6, are set as follows: AUTO_LDR_UPDATE is set to ENABLE and LDR_FILE_NAME can be set for example to upgr_282_4_42_24.rom). The configuration files can also include: The IP address of the TFTP/HTTP server (for example, the MNG_LOAD_IP parameter in Table 1 is set to tftp.telco.com). Firmware file names (the APP_FILE_NAME parameter in Table 4 can be set for example to sip_282_4_42_23.rom and the LDR_FILE_NAME parameter in Table 6 can be set for example to upgr_282_4_42_24.rom). Firmware file versions (for example, the APP_VERSION parameter in Table 4 is set to 4.42.23 and the LDR_VERSION parameter in Table 1 is set to 4.42.24). NOTE 1. If the Firmware file version parameters (APP_VERSION, LDR_VERSION) are used, the firmware will be upgraded only if a Firmware file version parameter differs from the corresponding parameter in the current firmware version. 2. The name of the “root” configuration file must comply with the format ipg_xxxx.cfg. 3. Configuration files must include the header “; Configuration Parameters. Don't edit this line!!!”. You will find an example for this file in this document or see file ipg_example.cfg. 4. To control when the new configuration parameters will be included use the „Automatic Configuration ID‟. See Set the Automatic Configuration ID. Downloading the File Manually Using Telnet IPG >commands IPG.Commands >copy 192.168.1.16 sip_282_4_42_23.rom Or: IPG.Commands >copy 192.168.1.16 ipg_282_00a012112233.cfg Auto Configuration Download on VoIP Gateways Page 8 of 86 Rev. H NOTE Copy will work only if the Auto Configuration flag is disabled. Downloading the File Manually Using the Web Figure 1: Download Page DHCP Automatic Configuration In DHCP download (BOOTP), the Gateway must be in DHCP mode. The name of the “root” configuration file and the IP of the TFTP/HTTP server are supplied to the Gateway when the Gateway queries the DHCP server for an IP address and a boot file, during boot and at half lease-time. Setting DHCP Automatic Configuration via the Web 1. Open the Network Status page (Figure 2) by clicking Network in the vertical menu bar at the left side of the screen. Auto Configuration Download on VoIP Gateways Page 9 of 86 Rev. H Figure 2: Network Status Page 2. In the horizontal menu bar at the top of the Network page, select Network Update (Figure 3). Verify that the Use DHCP to Obtain LAN configuration option is selected. Auto Configuration Download on VoIP Gateways Page 10 of 86 Rev. H Figure 3: Network Update Page 3. In the horizontal menu bar of the Network page, select AutoConfiguration (Figure 4). Verify that the Enable Automatic Configuration option is selected. Auto Configuration Download on VoIP Gateways Page 11 of 86 Rev. H Figure 4: Automatic Configuration Page 4. For Microsoft DHCP server: Select Use DHCP code options 66, 67 in the Gateway. In DHCP download (BOOTP), the Gateway must be in DHCP mode. The name of the “root” configuration file and the IP address of the TFTP server are supplied to the Gateway when the Gateway queries the DHCP server for an IP address and a boot file, during boot and at half lease-time. Reserve a station and define its MAC and IP. Add options 66, 67. o Option 66 (TFTP Server Name Option) - used to identify a TFTP server when the sname (the “root” file) field in the DHCP header is being used for DHCP options. o Option 67 (Bootfile Name Option) - used to identify a boot-file (the “root” file) when the file field is the DHCP header that is being used for DHCP options. Set the Automatic Configuration ID. Set the Automatic configuration ID to be different from the value on the DHCP Server. The Automatic configuration ID on the DHCP Server can be set to the value “always”, which causes the configuration file to be executed on every boot without comparing to the ID stored in the Gateway. 5. Click Save Settings to save the updated network settings. Auto Configuration Download on VoIP Gateways Page 12 of 86 Rev. H NOTE After entering and saving all configurations, you MUST reset the Gateway. Setting DHCP Automatic Configuration via Telnet 1. Use the set show dhcp (sh d) command in Network Configuration mode to verify that the configuration is obtained dynamically. IPG.Config.Network >show dhcp IPG.Config.Network > IPG.Config.Network > dhcp|dh = y If the configuration is not obtained dynamically, use the set dhcp (se dh) command in Network Configuration mode. IPG.Config.Network >set dhcp y 2. Use the set show autoconfig (sh a) command in Network Configuration mode to verify that the automatic configuration is enabled. IPG.Config.Network >show autoconfig IPG.Config.Network > IPG.Config.Network > autoconfig|a = y If the automatic configuration is not enabled, use the set autoconfig (se a) command in Network Configuration mode. IPG.Config.Network >set autoconfig y 3. For Microsoft DHCP server: Set the using of DHCP options 66, 67 by using the set options6667 (se o) command in Network Configuration mode. You can display the status of the DHCP options 66, 67 by using the show options6667 (sh o) command in Network Configuration mode. IPG.Config.Network IPG.Config.Network IPG.Config.Network IPG.Config.Network >set options6667 y >show options6667 > > options6667|o = y Set the Automatic configuration ID to a value different from the value on the DHCP server, by using the set id (se id) command in Network Configuration mode. You can display the Automatic configuration ID by using the show id (sh id) command in Network Configuration mode. To cause the configuration file to be executed on every boot and half lease time without comparing to the ID stored in the Gateway, set the ID at the DHCP server to always. IPG.Config.Network IPG.Config.Network IPG.Config.Network IPG.Config.Network >set id 5 >show id > > id|id = 5 Reboot the Gateway to effect the changes by using the reboot power (r p) command in Commands mode. IPG.Commands >reboot power Auto Configuration Download on VoIP Gateways Page 13 of 86 Rev. H IPG.Commands > Warning! Reset system (y/n) ? y Fixed (Provisioned) HTTP or TFTP Automatic Configuration You can supply the IP address of the HTTP/TFTP server and the name of the “root” configuration file directly to the Gateway, instead of through the DHCP options. During boot, and at defined polling periods, the Gateway will poll the TFTP/HTTP Server for a configuration file and will determine if an upgrade is needed. NOTE If Automatic Configuration is enabled, the IP address of the TFTP Server and the name of the “root” configuration file that are supplied by the user override the values obtained by the DHCP server. Setting the TFTP/HTTP Server “Root” Configuration File via the Web 1. Open the Network page (Figure 2). 2. In the horizontal menu bar of the Network page, select Network Update, You may select either of the following options: Use DHCP to obtain LAN configuration or Fixed LAN configuration (Figure 3). 3. In the horizontal menu bar of the Network page, select AutoConfiguration (Figure 4). Verify that the Enable Automatic Configuration option is set. 4. Set the polling time (in hours) in the Polling time (hours) field. The polling time sets the time period between Auto Configuration sessions. 5. Set the server protocol (HTTP or TFTP) in the Server protocol field. 6. Set the server IP address for the location of the configuration files in the Server IP field. 7. Set the name of the “root” configuration file in the File name field: The file name has the following syntax: ipg_xxxx.cfg where xxxx is free text, up to 97 characters in length. 8. Click on Save Settings to save the updated network settings. NOTE After entering and saving all configurations, you MUST reset the Gateway. Setting the TFTP Server “Root” Configuration File via Telnet 1. The Network configuration can be obtained dynamically or can be fixed. Use the set show dhcp (sh dh) command in Network Configuration mode to verify the DHCP configuration. IPG.Config.Network >show dhcp IPG.Config.Network > IPG.Config.Network > dhcp|dh = y If you wish to change the DHCP configuration use the set dhcp (se dh) command in Network Configuration mode. IPG.Config.Network >set dhcp y Auto Configuration Download on VoIP Gateways Page 14 of 86 Rev. H 2. Use the set show autoconfig (sh a) command in Network Configuration mode to verify that the automatic configuration is enabled. IPG.Config.Network >show autoconfig IPG.Config.Network > IPG.Config.Network > autoconfig|a = y If the automatic configuration is not enabled, use the set autoconfig (se a) command in Network Configuration mode. IPG.Config.Network >set autoconfig y 3. Set the TFTP server IP address for the location for the configuration files by using the set tftpip (se t) command in Network Configuration mode. Use the show tftpip (sh t) command in Network Configuration mode to verify the TFTP server IP address. IPG.Config.Network IPG.Config.Network IPG.Config.Network IPG.Config.Network >set tftpip 10.2.197.9 >show tftpip > > tftpip|t = 10.2.197.9 4. Set the “root” configuration file name by using the set file (se f) command in Network Configuration mode. Use the show file (sh f) command in Network Configuration mode to verify the name of the “root” configuration file. The file name has the following syntax: ipg_xxxx.cfg where xxxx is free text. IPG.Config.Network IPG.Config.Network IPG.Config.Network IPG.Config.Network >set file ipg_test.cfg >show file > > file|f = ipg_test.cfg 5. Reboot the Gateway to effect the changes by using the reboot power (r p) command in Commands mode. IPG.Commands >reboot power IPG.Commands > Warning! Reset system (y/n) ? y Encrypting a Configuration File The “root” file name must be of format ipg_xxxx.cfg, where xxxx is free text, up to 97 characters in length. To encrypt a configuration file: 1. Install the encryption key into the Gateway. The maximum size is 64 characters. 2. Encrypt the configuration file with the gwBin utility using the same encryption key that you entered into the Gateway. Make sure that the name given to the encrypted file is of format ipg_xxxx.cfg. Auto Configuration Download on VoIP Gateways Page 15 of 86 Rev. H Configuration File Parameters NOTE When setting a STRING parameter, blank characters may be used only if the string is enclosed in quotation marks (for example: IF0DNSHOSTNAME=“test host”). Auto Configuration and Copy The following table lists a collection of controls and data for file download of subsequent sessions. The values will be saved in the current session to be used in the next auto-config session, but not in the current session. To upgrade the Gateway firmware via a TFTP server set the following parameters: TFTP/HTTP server IP address (MNG_LOAD_IP parameter). Image file name or configurations file name (MNG_LOAD_NAME parameter). Table 1: Preset File Load Parameters Name Value Description Default MNG_LOAD_IP {A.B.C.D | STRING} TFTP server IP address or Domain name. Location for the software image files or configuration files. Will be used by all subsequent Auto Config or Copy sessions. Overrides DHCP TFTP server IP address in subsequent Auto Config sessions. None MNG_LOAD_NAME STRING Image file name or configurations file name. Will be used by all subsequent Auto Config or Copy sessions. Overrides DHCP TFTP file name in all subsequent Auto Config sessions. None See also AUTO_USE_MAC parameter in Table 5 (for AUTO_USE_MAC the maximum file name without the MAC is 85). Image file name (STRING): Image file name (valid only for copy sessions). The Image name length is up to 97 characters. The file name has the following syntax: pppp_hhh_M_N.rom pppp - protocol or upgrader name: “h323” or “mgcp” or “sip” or “upgr”. M - Major version number. N - Minor version number. hhh - unit type 483, 282 or 232. Configurations file name (STRING): The configuration file name length is up to 97 characters. The file name has the following syntax: ipg_xxxx.cfg xxxx - free text Example 1 The following example sets the TFTP server IP address to 10.2.42.55: Auto Configuration Download on VoIP Gateways Page 16 of 86 Rev. H MNG_LOAD_IP=10.2.42.55 Example 2 Example for upgrading software (copy only): COPY_LOAD_NAME = sip_282_4_20.rom Example 3 Example for auto configuration “Root” file name: MNG_LOAD_NAME = ipg_282.cfg Auto Configuration Parameters The Gateway, when shipped, already has code installed in its Flash ROM memory and is ready to run. Table 2, Table 3, Table 4, Table 5, Table 6 and Table 7 list the parameters for upgrading the Gateway‟s firmware with a new version of the ROM image and downloading configuration files. The following parameters are used for downloading firmware and configuration file control: Enable automatic configuration update (AUTO_CONFIG_ENABLE parameter). Local Automatic Configuration ID (FILE_PARM_NUM_UPDATE parameter). o For DHCP Auto Configuration the Gateway will run the configuration file only if the file name or ID is different from those currently stored in the Gateway. The ID can be set at the DHCP server to the value always, causing the configuration file to be executed on every boot without comparing to the ID stored in the Gateway (Example of file name with ID: ipg_12345.cfg, 8). o For Fixed Auto Configuration, the Gateway will run the configuration file only in one of the following cases: The Configuration ID is missing in the Configuration file – or – the Configuration ID is in the file but is equal to always – or – the Configuration ID differs from the local Configuration ID. For using DHCP code options 66 and 67 (USE_DHCP_OPTIONS_66_67 parameter). o Set option 66 as the IP of the TFTP server for the “root” configuration file. o Set option 67 as the name of the “root” configuration file. IP address of the TFTP/HTTP server (TFTP_SERVERIP parameter). The server‟s protocol for downloading (HTTP or TFTP) in Automatic Configuration (IF1AC_PROTOCOL parameter). Polling period in hours (IF1AC_POLLING parameter). Set the file name that you wish to download: o Configuration file: Auto Configuration Download on VoIP Gateways Page 17 of 86 Rev. H Enable automatic downloading of the configuration file (AUTO_GEN_UPDATE parameter in Table 3) and set the configuration file name (FILE_GEN_PARM_NAME parameter in Table 3). o Application image: Enable automatic downloading of the application image (AUTO_APP_UPDATE parameter in Table 4) and set the application image file name (APP_FILE_NAME parameter in Table 4) and version number (APP_VERSION parameter in Table 4). If APP_VERSION is used, the application image will be updated only if the version number of the installed application image differs from the APP_VERSION parameter. o Loader image: Enable automatic downloading of the loader image (AUTO_LDR_UPDATE parameter in Table 6) with the file name (LDR_FILE_NAME parameter in Table 6) and version number (LDR_VERSION parameter in Table 6). If LDR_VERSION is used, the loader image will be updated only if the version number of the installed loader image differs from the LDR_VERSION parameter. Set the maximum number of TFTP session retries (MAX_REPEAT_TFTP parameter in Table 7). Set the time delay in seconds after TFTP error (TIME_WAIT_TFTP parameter in Table 7). Use the gateway‟s MAC address for downloading a specific configuration file for each gateway (AUTO_USE_MAC parameter in Table 5). Table 2: Control Parameters Name Value Description Default AUTO_CONFIG_ENABLE {1 | 0} 1 - Enable automatic configuration update. 0 - Disable automatic configuration update 1 FILE_PARM_NUM_UPDATE STRING Local Automatic Configuration ID. DHCP Auto Configuration compares this value to the value that resides at the DHCP server (along with the file name). Fixed Auto Config compares this value to the value in the “Root” file that resides on the TFTP/HTTP server. If the values differ, an Auto Configuration process will take place. For fixed Auto Config, if in the cfg file this parameter is missing, it is taken as always. For DHCP Auto Config, if it is not available it is taken as 0. The Configuration ID is not case-sensitive. The length is 20 characters. 0 USE_DHCP_OPTIONS_66_67 {1 | 0} 1 - Use DHCP code options 66 and 67. 0 – Do not use DHCP code options 66 and 67. 1 TFTP_SERVERIP {A.B.C.D | STRING} IP address or Domain name of the TFTP/HTTP server for the remaining downloads of the current running Auto config session. Option to switch to another server None Auto Configuration Download on VoIP Gateways Page 18 of 86 Rev. H Name Value Description Default after downloading the “Root” file. IF1AC_PROTOCOL {TFTP | HTTP} The Server’s protocol for downloading in Automatic Configuration. TFTP IF1AC_POLLING <1-9999> Polling period in hours. After every poll period the unit checks if a new Automatic Configuration process should be initiated. 0 or empty disables the polling. 0 Example 1 The following example is for DHCP Auto Config: ; enable automatic configuration update AUTO_CONFIG_ENABLE=1 ; set the Local Automatic Configuration ID to “11” FILE_PARM_NUM_UPDATE=11 ; use DHCP code options 66, 67 USE_DHCP_OPTIONS_66_67=1 Example 2 The following example is for Fixed Auto Config: ; enable automatic configuration update AUTO_CONFIG_ENABLE=1 ; include Automatic Configuration ID to “always” FILE_PARM_NUM_UPDATE=always Table 3: Update General Configuration File Name Value Description Default AUTO_GEN_UPDATE {ENABLE | DISABLE} Enable or disable general file configuration. ENABLE FILE_GEN_PARM_NAME STRING The general file configuration name. For example: ipg_general.cfg The length is up to 97 characters. None Example The following example enables the general file configuration and sets the file name to ipg_general.cfg: AUTO_GEN_UPDATE=ENABLE FILE_GEN_PARM_NAME=ipg_general.cfg Auto Configuration Download on VoIP Gateways Page 19 of 86 Rev. H NOTE AUTO_GEN_UPDATE and FILE_GEN_PARM_NAME can only be in the root file. Table 4: Update Application Name Value Description Default AUTO_APP_UPDATE {ENABLE | DISABLE} Enable or disable the Automatic Application Update. ENABLE APP_FILE_NAME STRING Application image file name for the current session. The length is up to 97 characters. The file name has the following syntax: pppp_hhh_M_N.rom None pppp - protocol or upgrader name: “h323” or “mgcp” or “sip”. M - Major version number. N - Minor version number. hhh - unit type 483, 282 or 232. For example: h323_282_4_20.rom, sip_282_4_20.rom, mgcp_282_4_20.rom. STRING APP_VERSION Application image version number. 0-99.0-99.0-99xx where xx is an optional string. For example: 1.4.10 None Example The following example enables the Automatic Application Update and sets the file name to h323_282.rom with version 1.10: AUTO_APP_UPDATE=ENABLE APP_FILE_NAME=h323_282.rom APP_VERSION=1.10 Table 5: Use MAC Name Value Description Default AUTO_USE_MAC ?FILE Add the unit’s MAC address (not spoofed MAC) to the Root Configuration File name and to the Encryption key. FILE - the unit’s MAC preceded by “_” will be added to the Root Configuration file name. DIR - the unit’s MAC address suffixed by a backslash (“\”) will be added as a directory path to the Root Configuration file. FILE_H, DIR_H - same as FILE and DIR but only the last six digits of MAC are used. Note: If the Encryption key exceeds 50 None Auto Configuration Download on VoIP Gateways Page 20 of 86 Rev. H Name Value Description Default characters, the MAC is not added to the Encryption key. The maximum length of the file name is 85 if the MAC is not added, or 99 if the MAC is added. Value “?FILE” used in Version 4.5528 and later. Example The following command adds the last 3 bytes of the unit‟s MAC, preceded by an underscore character (“_”), to the Root Configuration file name and to the Root file encryption key: AUTO_USE_MAC=FILE_H ; Root config name will change from ipg_282.cfg to ipg_282_11abcd.cfg ; Encryption key will change from key to key_11abcd Table 6: Update Loader Name Value Description Default AUTO_LDR_UPDATE {ENABLED | DISABLED} Enable Automatic Loader Update. ENABLED LDR_FILE_NAME STRING Loader image name for current session. The file name has the following syntax: upgr_hhh_M_N.rom None hhh - unit type 483, 282 or 232 M - Major version number N - Minor version number For example: upgr_282_4_20.rom. The length is 97 characters. LDR_VERSION STRING Loader image version number. 0-99.0-99.0-99xx where xx is an optional string. For example: 1.4.10. None LOADER_REBOOT_TIME <15-240> minutes If the unit is in Loader mode and a valid application is missing, the unit will reboot after the period specified in this parameter. If this parameter is set to 0, the feature is disabled. Version 4.57 and later. 30 minutes Example The following example sets the file name to upgr_282_11016.rom with version 1.4.10: LDR_FILE_NAME=upgr_282_11016.rom LDR_VERSION=1.4.10 Auto Configuration Download on VoIP Gateways Page 21 of 86 Rev. H Table 7: Auto Configuration - TFTP Retries Name Value Description Default MAX_REPEAT_TFTP <1-65535> Number of Max Retries in a TFTP session. For example: 5 (times). If the MAX_REPEAT_TFTP parameter is set to 0, the unit will endlessly retry to download the configuration and image files. 5 In Version 4.57 and later, the delay between retries will start from the value indicated in the TIME_WAIT_TFTP parameter and will increment only 10 times. After incrementing 10 times, the delay will revert to the value of TIME_WAIT_TFTP. TIME_WAIT_TFTP <1-65535> Time Delay in seconds after a TFTP error. For example: 60 seconds. 60 Example The following example sets the number Max Retries in the TFTP session to 5 and the Time Delay in seconds after a TFTP error to 60: MAX_REPEAT_TFTP = 5 TIME_WAIT_TFTP = 60 GW-282S Hardware Configuration Parameters The available GW-282S hardware configuration parameters are listed in Table 8: GW-282S hardware types (PRODUCT_TYPE parameter). Table 8: GW-282S Hardware Configuration Parameters Name Value Description Default PRODUCT_TYPE {a | b} The product configuration type 282S-A (a) or 282S-B (b). b Example ; set the GW-282S hardware type to 282S-A PRODUCT_TYPE = a Auto Configuration Download on VoIP Gateways Page 22 of 86 Rev. H Networking Parameters Network and IP Information Configuration Parameters The parameters in Table 9 allow you to set the IP address of the network parameters. If you choose to assign the IP address via DHCP server, set the IF0DHCP parameter with the value DHCP. If you choose to assign the IP address statically, set the IF0DHCP parameter with the value FIXED and fill the IP parameters in Table 9. If you set the IF0DHCP parameter as FIXED, you can set the following IP parameters: IP Address (IF0IPADDRESS parameter). Subnet mask (IF0IPNETMASK parameter). Default gateway (IF0IPGATEWAY parameter). DNS server IP address (IF0IPDNS parameter). Secondary DNS server IP address (IF0IPDNS2 parameter). Host name (IF0DNSHOSTNAME parameter). Domain-name (IF0DNSDOMAINNAME parameter). Other parameters in Table 9 are: VoIP IP address (VOICE_IP parameter), VoIP network mask (VOICE_MASK parameter) and VoIP default gateway (VOICE_GATEWAY parameter). Use these parameters only if you wish to have different IP addresses for voice and for management of the unit. By default VOICE_IP is empty and the management IP parameters are used also for voice. The base number for the first local TCP port (TCP_USRSTART_PORT parameter). Table 9: Network and IP Information Configuration Parameters Name Value Description Default IF0DHCP {DHCP | FIXED} Choose whether to use a fixed IP address (use FIXED value) or a dynamically assigned IP address (use DHCP value) via DHCP. DHCP IF0IPADDRESS A.B.C.D The IP Address if FIXED was specified for the IF0DHCP parameter. None IF0IPNETMASK A.B.C.D The subnet mask if FIXED was specified for the IF0DHCP parameter. None IF0IPGATEWAY A.B.C.D The default gateway’s IP address if FIXED was specified for the IF0DHCP parameter. None IF0IPDNS A.B.C.D The DNS server IP address if FIXED was specified for the IF0DHCP parameter. None IF0IPDNS2 A.B.C.D The secondary DNS server IP address if FIXED was None Networking Parameters Page 23 of 86 Rev. H Name Value Description Default specified for the IF0DHCP parameter. IF0DNSHOSTNAME STRING The host name, if FIXED was specified for the IF0DHCP parameter. The length is 79 characters. None IF0DNSDOMAINNAME STRING The domain-name, if FIXED was specified for the IF0DHCP parameter. The length is 79 characters. None VOICE_IP A.B.C.D VoIP IP address of the Gateway. None VOICE_MASK A.B.C.D VoIP network musk of the Gateway. 255.255.0.0 VOICE_GATEWAY A.B.C.D VoIP default gateway’s IP address. None TCP_USRSTART_PORT <1024-4500> Base number for first local TCP port. Version 4.55.23 and later. 1024 DHCPCLIENT_VENDOR_INFO STRING Support for vendor information in DHCP client requests. To enable the option the user must set the parameter to a non empty value. DHCP client will use this string as the value for option 60. It will also invoke a request for option 43. After receiving the option 43, the DHCP client will use this value as vendor information for all subsequent usage of option 60. None DHCP_OPTION82 5 byte ASCI string, or 1 byte 0x00 and 4 bytes value when numeric Adds specific relay information as a DHCP option 82, sub-option 1 (Circuit-Id) in all Broadcast DHCP Discovery packets that originated from devices connected to GW/AC-232. Format of information: 5 bytes: 4 bytes: 1 byte: 4 bytes: 6 bytes: Feature supported only for GW/AC-232. Ver. 5.6.6 and later. None Example ; set the IP address of the unit to be fixed IF0DHCP=FIXED Networking Parameters Page 24 of 86 Rev. H ; set the IP address to 10.2.1.200 IF0IPADDRESS= 10.2.1.200 ; set the subnet mask to 255.255.255.0 IF0IPNETMASK=255.255.255.0 ; set the default gateway to 10.2.1.1 IF0IPGATEWAY=10.2.1.1 ; set the DNS server IP address to 10.2.1.2 IF0IPDNS=10.2.1.2 ; set the interface hostname to test_host IF0DNSHOSTNAME=test_host ; set the domain name to www.test.com IF0DNSDOMAINNAME=www.test.com Network VLAN Parameters The VLAN (Virtual Local Area Network) configuration parameters are listed in Table 10. NOTE Normal usage of the Gateway does not require using VLANs. To set VLANs on the Gateway, proceed as follows: Enable using 802.1q VLAN (VL_ENABLE parameter). Create VLAN ID and assign ports to it as tagged or untagged members (CREATE_VLAN parameter). In the AC-232 product, all VLANs defined on the port must be all T or all U. A combination of T and U on the same port is not allowed. Set the default VLAN (PVID) per port if the port is set as an untagged member in the VLAN (PORT_DEFAULT_VLAN parameter). Table 10: VLAN Configuration Parameters Name Value Description Default VL_ENABLE {0 | 1} 1 - Enable using 802.1q VLAN. This value must be set if you want to configure VLANs on the unit. 0 - Disable using 802.1q VLANs 0 CREATE_VLAN VLAN1,N|T|U,N|T|U, N|T|U, ,N|T|U, N|T|U, ,N|T|U, N|T|U, ,N|T|U, [N|T|U,] Create and assign a VLAN ID to ports (N=No VLAN, T=Tagged, U=Untagged). The first sign (N|T|U) refers to port 1 and the second sign refers to port 2 and so on up to port 4 on the GW232, up to port 8 or 9 on the GW-282/482 with GigE uplink, up to 9 on GW483S and up to 10 on GW483D All VLANs defined on the port must be all T or all U. 1,U,U,U,U,U,U,U,U,U Networking Parameters Page 25 of 86 Rev. H Name Value Description Default A combination of T and U on the same port is not allowed. For example: 409,N,T,U,N,U,N,N,T,U or 4095,,T,U,,U,,,T,U PORT_DEFAULT_VLAN VLAN1,VLAN2 Set the default VLAN per port. The first VLAN ID (VLAN1) refers to port 1 and the second VLAN ID refers to port 2 and so on up to port 4 on the GW-232, up to port 8 or 9 on the GW282/482 with GigE uplink, up to 9 for GW-483S and up to 10 on GW-483D 1,1,1,1,1,1,1,1,1 Example The following lines display how to enable VLAN on the unit and how to set those VLANs on the unit‟s ports: ; enable using VLANs VL_ENABLE=1 ; set the default VLAN of port 1 to 1 and the default VLAN of port 2 to 200 PORT_DEFAULT_VLAN 1,200, ; create VLAN ID 1 and set it untagged on ports 1 and 2 CREATE_VLAN 1,U,U,,,,,,, ; create VLAN ID 200 and set it tagged on ports 1 and 2 CREATE_VLAN 200,T,T,,,,,,, ; create VLAN ID 300 and set it untagged on port 1 and tagged on ports 2 and 5 CREATE_VLAN 300,U,T,,,T,,,, ; create VLAN ID 400 and set it tagged on ports 1, 5 and 8 and untagged on port 2 CREATE_VLAN 400,T,U,,,T,,,T, ; create VLAN ID 500 and set it untagged on ports 1, 2, 6 and 8 and tagged on port 9 CREATE_VLAN 500,U,U,,,,U,,U,T, ; create VLAN ID 600 CREATE_VLAN 600,,, ; create VLAN ID 700 and set it untagged on port 1 and no VLAN on port 2 CREATE_VLAN 700,U,N, ; create VLAN ID 800 CREATE_VLAN 800,,, Network Services Parameters Table 11 lists the VLAN configuration for the voice and management services. You can assign VLAN and priority tags to outgoing frames. This will cause the devices such as switches and routers in the LAN to serve the frames with higher priority queues and with lower delays. Service VLANs can be defined also for security reasons. Networking Parameters Page 26 of 86 Rev. H NOTE Before setting the VLAN configuration for the voice and management services you must enable the VLANs and create the VLANs that you want to use for these services. VLANs and VPT (VLAN Priority Tag) can be assigned to the following services: Management frames, including ping and voice (IF0VLANTAG and IF0PRIORITYTAG parameters) RTP (Real-time Transport Protocol) frames (VLANTAG_RTP parameter), you can also assign a priority and set the ToS (Type of Service) field in the IP header of the RTP frames (VLANTAG_RTP, PRIORITYTAG_RTP and TOS_VALUE parameters). The ToS for Call Signaling packets can be configured in the Gateway Web page Services. IGMP (Internet Group Multicast Protocol) frames (VPRIORITY_TAG_IGMP parameter), you can also assign a priority of the IGMP frames (VLANTAG_RTP, PRIORITYTAG_RTP parameter). VLAN IDs for excluded management frames (EXCL_MANAG_VLAN parameter). Start frames of the VoIP call session (VLANTAG_CALL and PRIORITYTAG_CALL parameters). Table 11: Voice and Management Services Configuration Name Value Description Default IF0VLANTAG <1-4095> The management VLAN ID. Empty Note: no VLAN is associated to management. IF0PRIORITYTAG <0-7> The priority of the management traffic. Empty Note: no priority is set for management traffic. VLANTAG_RTP <1-4095> RTP VLAN ID (overrides IF0VLANTAG setting). Empty Note: use IF0VLANTAG. PRIORITYTAG_RTP <0-7> RTP (Real-Time Transport Protocol) priority (overrides IF0PRIORITYTAG setting). Empty Note: use IF0PRIORITYTAG. TOS_VALUE <0-255> The RTP (Real-Time Transport Protocol) ToS (Type of Service). Version 4.57 and later. 184 (B8 Hex) SIP_IP_TOS <0-255> SIP signaling TOS Version 4.57 and later. 104 (68 Hex) H323_IP_TOS <0-255> H.323 signaling TOS Version 4.57 and later. 104 (68 Hex) MGCP_IP_TOS <0-255> MGCP signaling TOS Version 4.57 and later. 104 (68 Hex) VLAN_TAG_IGMP VLAN1,VLAN2 IGMP VLAN ID list None Networking Parameters Page 27 of 86 Rev. H Name Value Description Default (overrides IF0VLANTAG setting). Up to eight VLANs can be defined. VPRIORITY_TAG_IGMP <0-7> IGMP priority (overrides IF0PRIORITYTAG setting). Empty Note: use IF0VLANTAG EXCL_MANAG_VLAN <1-4095> VLAN IDs for excluded management frames. Management packets that will arrive on this VLAN will be discarded. Note: It VLANTAG_CALL <1-4095> Call VLAN ID. Empty Note: use IF0VLANTAG. PRIORITYTAG_CALL <0-7> The priority of the start frames of the VoIP call session. Empty Note: use IF0PRIORITYTAG. is possible to configure up to 16 excluded VLAN IDs separated by commas. Example The following example sets: Management VLAN to 127 Management‟s frame priority to 0 RTP VLAN to 400 RTP frames priority to 7 RTP TOS to 16 Call VLAN to 500 Priority of start frames of the VoIP call session to 0 IGMP VLAN to 300 IGMP frames priority to 5 List of excluded VLANs to 300, 600, 700, 800 IF0VLANTAG IF0PRIORITYTAG VLANTAG_RTP PRIORITYTAG_RTP TOS_VALUE VLANTAG_CALL PRIORITYTAG_CALL VLAN_TAG_IGMP PRIORITY_TAG_IGMP EXCL_MANAG_VLAN Networking Parameters = = = = = = = = = = 127 0 400 7 16 500 0 300 5 300,600,700,800 Page 28 of 86 Rev. H VoIP Configuration Parameters SIP Configuration Parameters The SIP (Session Initiation Protocol) is an Internet Engineering Task Force (IETF) standard protocol for initiating an interactive user session that involves multimedia elements such as video, voice, chat, gaming, and virtual reality. If the Gateway has SIP installed, you must configure the SIP Server IP address and other SIP parameters. Table 12, Table 13 and Table 14 list the SIP configuration parameters. The following SIP parameters can be defined: SIP server (Primary/Secondary) IP addresses or domain name (SERVERIP/SERVERIP2 parameters in Table 12).The main goal for supporting a secondary SIP proxy server is to provide redundancy in case of primary server failure. If this happens, the gateway tries to forward the outgoing INVITE and REGISTER packets to the secondary ip:port. Set SIP server (Primary/Secondary) port numbers (SERVERPORT/SERVERPORT2 parameters in Table 12). Domain name which is used in registration (DOMAINNAME parameter in Table 12). Choose whether or not the Gateway will send REGISTER request (SERVERREGISTER parameter in Table 12). Use the FXS default dial plan (>#|[2-9]xxxxxxxxx|1[2-9]xxxxxxxxx|x.T) or set your own dial plan (DIALPLAN parameter in Table 12). You can find more information regarding the dial plan format in the Administrator’s Guide. Set the SIP call control transport protocol (TRANSPORT_TYPE parameter in Table 12). For each phone line set the following: o Set the phone E164 number (LINExNUMBER parameter in Table 12). The E164 is the format of global switched telephone numbers as defined by the ITUT (International Telecommunications Union - Telecommunications Standardization Sector). The 16 digit number is split into international, national and user number portions. o Set the caller ID (LINExCALLERID parameter in Table 12). Enter the “Name” you want to show on the called party‟s Caller ID display. When you make a call from a line of the Gateway with the Caller ID inserted, the remote called party will receive this string. Gateway US version is factory set to FSK (Bellcore) CID. o Set block sending caller ID (KEY_BLOCK_CID parameter in Table 32) per call. Block Sending Caller ID Per Call can be configured in the Gateway Web Page at Miscellaneous > Calling. Set under “Handset Advanced Configuration.” o Set the SIP call-signaling port (LINExPORT parameter in Table 12). o Choose whether or not AEC is on (LINExAEC parameter in Table 12). The AEC (Automatic Echo Cancellation) reduces the amount of feedback the called party hears. VoIP Configuration Parameters Page 29 of 86 Rev. H o Set the Authentication user name (LINExAUTHUSER parameter in Table 12). A user name is associated with the password (LINExAUTHPSWD parameter in Table 12). Both fields are used to authenticate the user of the telephone line. SIP Timers T1, T2 configuration (SIP_UDP_T1 and SIP_UDP_T2 parameters in Table 12). Dead-Air Period at end of call. This option sets a period of silence (dead air) at the end of a call before hearing the busy tone. This dead-air time is needed by some Voice Mail to identify the end of the call. The dead-air parameter can be configured in the Gateway Web Page at Miscellaneous > Calling. Set the Dead-Air Configuration value from 0 to 65535 seconds. By default the parameter is set to zero and there is no dead-air period. Refer to Table 12 for the Auto Configuration parameter DEAD_AIR_PERIOD. Enable T.38 fax support (T38_SUPPORT parameter in Table 12). Set the NAT IP Address to be used for SIP (SIP_NAT_IP parameter in Table 13). If the IP address is not set the NAT option is disabled. Set the RTP (Real-time Transport Protocol)/RTPC port base (SIP_RTPPORTNUMBERS parameter in Table 13). SIP RTP Statistics of active calls can be sent to the Syslog in the Gateway Web Page at Miscellaneous > Syslog. At the Select Line Number field, select a line number or All (all lines) and then click Send Line Info. The RTP statistics can be viewed in Telnet and sent to Syslog using the Telnet Send command in IPG.Commands mode. Set the STUN server IP address and port (STUN_IP and STUN_PORT parameters in Table 14). The STUN (Simple Traversal of UDP through NATs) server is an implementation of the STUN protocol that enables STUN functionality in SIP-based systems. STUN is an application-layer protocol that can determine the public IP and nature of a NAT device that sits between the STUN client and STUN server. Set the SIP server settings, NAT settings and STUN server settings according to the way the Gateway is connected to the network: If the Gateway does not reside behind a NAT server and has an outbound (global) IP address you only need to set the SIP Server‟s IP address, port and domain name. If the Gateway resides behind a NAT server and wishes to communicate with the SIP server via a Proxy server: Set the SIP server IP address and port to the values of the Proxy server‟s IP address and port. Set the domain name to the SIP Server‟s Domain name. If the Gateway resides behind a NAT server and wishes to communicate with the SIP server using STUN support: Set the SIP server‟s IP address, port and domain name to the values of the SIP server‟s IP address, port and domain name. Set the STUN Server‟s IP address and port to the IP and port of the STUN server. Set sending (**) for Hook Flash (INFO_MIDCALL_SERVICE parameter). VoIP Configuration Parameters Page 30 of 86 Rev. H If the Gateway resides behind a NAT server and the outbound (global) IP is Static the Gateway could be configured to use the outbound (global) IP also for the SIP protocol. Set the SIP server‟s IP address, port and domain name to the values of the SIP server‟s IP address, port and domain name. Set the NAT IP address to the value of the Gateway‟s outbound IP address. Table 12: SIP Configuration Parameters Name Value Description Default SERVERIP {A.B.C.D | STRING} Primary SIP server domain name or IP address. The length of the domain name is up to 97 characters. Empty SERVERPORT Primary SIP server port number. 5060 SERVERIP2 {A.B.C.D | STRING} Secondary SIP server domain name or IP address. The length of the domain name is up to 97 characters. Empty SERVERPORT2 Secondary SIP server port number. Must be set when using Domain name for SERVERIP2 (SRV DNS not supported with this feature). 5060 DOMAINNAME STRING Domain name which is used in registration. The length is up to 50 characters. For example: LINExNUMBER@DOMA INNAME None SERVERREGISTER {YES | NO} Send REGISTER request. YES DIALPLAN STRING Dial plan matching string. The length is up to 254 characters. >#|[2-9]xxxxxxxx x| 1[29]xxxxxxxxx|x.T TRANSPORT_TYPE {UDP | TCP} SIP call control transport protocol. UDP LINExNUMBER { | STRING} E164 number of line x (x can be a number between 1 and 4; for the GW-232 and GW483S/GW-483D, x is 1 or 2). The length is up to 97 characters. None LINExCALLERID STRING Caller-ID string for line x (x can be a number between 1 and 4; for the None VoIP Configuration Parameters Page 31 of 86 Rev. H Name Value Description Default GW-232 and GW483S/GW-483D, x is 1 or 2). The length is up to 97 characters. LINExPORT SIP call-signaling port for line x (x can be a number between 1 and 4; for GW-232 and GW483S/GW-483D, x is 1 or 2). 5060 for x=1 5061 for x=2 5062 for x=3 5063 for x=4 LINExAEC {YES | NO} Choose whether or not AEC is used on line x (x can be a number between 1 and 4; for GW-232 and GW483S/GW-483D, x is 1 or 2). YES LINExAUTHUSER STRING Authentication user name for line x (x can be a number between 1 and 4; for GW-232 and GW483S/GW-483D, x is 1 or 2). The length is up to 97 characters. None LINExAUTHPSWD STRING Authentication password for line x (x can be a number between 1 and 4; for GW-232 and GW483S/GW-483D, x is 1 or 2). The length is up to 97 characters. None T38_SUPPORT {0 | 1} 1 - .T38 fax is supported (ON). 0 - T.38 fax is not supported (disabled). 0 T38_ECC_TYPE {REDUNDANCY | FEC} This attribute is specified for use with ITU-T Recommendation T.38 Annex D. During H.323 capabilities exchange, a gateway shall indicate its support of the available error protection schemes: parity FEC, or redundancy. If a capability is indicated to receive both parity error correction frames and redundant frames, then either scheme may be used. However, if a gateway indicates a capability to receive only redundant error protection frames, then the transmitting gateway may not send parity FEC frames. Version 4.57 and later. REDUNDANCY VoIP Configuration Parameters Page 32 of 86 Rev. H Name Value Description Default T38_RATE_MANAGEMENT {TRANSFERRED | LOCAL} Version 4.57 and later. TRANSFERRED INFO_MIDCALL_SERVICE {YES | NO} Enables or disables sending (**) for Flash Hook. When the parameter is enabled, also sending and playing Telephone events via SIP INFO on both lines is enabled and displaying CID from SIP Contact header. Ver 4.55 and later. NO SIP _UDP_T1 <100ms –1023 ms> SIP TIMER T1 value Ver 4.57 and later. 500 ms SIP _UDP_T2 <100ms –65535 ms> SIP TIMER T2 value Ver 4.57 and later. 4000 ms DIALPLANTIMER <1 – 30> seconds Sets the period of time before an attempt to make a call is made after dialing any number. Ver 4.56 and later. 6 seconds SIP_PKT_SIZE <1500-3000> Bytes Specifies the max size of the handled SIP packets. 1500 Bytes Table 13: SIP NAT Settings Name Value Description Default SIP_NAT_IP A.B.C.D IP Address to be used for SIP. If the IP address is not set, the NAT option is disabled. Blank SIP_RTPPORTNUMBERS <1-65535> RTP/RTCP Port Base. 16384 Table 14: SIP STUN Server Settings Name Value Description Default STUN_IP A.B.C.D STUN server IP Address. If the IP is not set, the STUN option is not used. None STUN_PORT STUN server port. 3478 Table 16 lists the SIP extensions parameters. The following parameters can be defined: Support PRACK method with provisional response reliability (SIP_SEND_PRACK parameter): Provides a standard reliability mechanism for provisional responses, which means that the Gateway is sending ACKs for provisional responses (180, 183, etc). Reference: RFC3262 (Reliability of Provisional Responses in the Session Initiation Protocol (SIP)). Encode SIP URI with user parameter (SIP_URI_USER_PARAM parameter): VoIP Configuration Parameters Page 33 of 86 Rev. H The set of valid telephone-subscriber strings is a subset of valid user strings. The user URI parameter exists to distinguish telephone numbers from user names that happen to look like telephone numbers. If the user string contains a telephone number formatted as a telephone-subscriber, the user parameter value “phone” SHOULD be present. Even without this parameter, recipients of SIP and SIPS URIs MAY interpret the pre-@ part as a telephone number if local restrictions on the name space for user name allow it. Reference: RFC3261, Section 19.1.1 (SIP and SIPS URI Components). INVITE Expires Timer value (SIP_INVITE_TIMER parameter): Defines the length of time we allow for an OK response to an INVITE. If the time elapses – we transmit a CANCEL to invalidate the INVITE. Reference: RFC3261, section 13.2.1 (Creating the Initial INVITE parameter). SIP Session Timer value (SIP_SESSION_TIMER parameter): Specifies the Session-Expires header in an INVITE request. Used as the SIP session‟s keep-alive mechanism. The extension defines two new header fields, Session-Expires, which conveys the lifetime of the session, and Min-SE, which conveys the minimum allowed value for the session timer. Reference: Draft-ietf-sip-session-timer-10.txt of the IETF (Internet Engineering Task Force). SIP Registration Timer Value (SIP_REGISTER_TIMER parameter): Specifies a suggested value that the server should take into consideration when it returns the Expires timer for registration in the OK response. The value is inserted in the Expires header. The server may choose another value, and the device will obey that value (reregister using the server‟s value). Reference: RFC3161, Section 10.2.1.1 (Setting the Expiration Interval of Contact Addresses). Flash Hook Timer (FLASH_HOOK_TIMER_MIN | MAX parameter): The Flash Hook Timer Min parameter defines the minimum time the telephone must be on the on-hook state before a flash-hook event is detected. The Flash Hook Timer Max parameter defines the minimum time the telephone must be in the on-hook state to be detected as an on-hook (disconnect) event. If Flash Hook Timer Max parameter value is set to a value equal or smaller than the Flash Hook Timer Min value, both parameters are set to their default values. The values of the parameters are set in 100 millisecond steps. “#” character Sent Escaped - %23 (FLASH_HOOK_TIMER_MIN | MAX) This parameter overrides Unreserved and User-Unreserved symbols in the user part of the user info. It sends % followed by the symbol‟s hex value, instead of the actual symbol. For example – “#” is sent as %23 by default. When setting SIP_USER_NON_ESCAPED to Yes, the symbol will be sent as “#”. 183 Session Progress (SIP_SEND_183_RTP parameter): A caller receiving a “183 Session Progress” response should only receive RTP at this stage. For devices that pass through Proxies for NAT (like pulver.com) sending RTP should be enabled. User-Agent for SIP Requests (USER_AGENT parameter): A default User-Agent header value “Telco Systems GW-YYY vXXX” (YYY is product type GW-282 or GW-483S/GW-483D or GW-232; vXXX is the software version) is sent in all SIP requests. The User-Agent header could be used for the identification of the VoIP Configuration Parameters Page 34 of 86 Rev. H Gateway by the Call Server. The Call Server could be configured to reject registration requests if the Gateway is set with a wrong identification value. The User-Agent header could include a different value from the default value if USER_AGENT parameter is configured. The USER_AGENT parameter could also include substitute parameters. The possible substitute parameters and their substituted values appear in Table 15 Example: For USER_AGENT=$mac1 $vendor The User-Agent header in the SIP packet will be as follows: User-Agent: aa:bb:cc:dd:ee:ff Telco Systems (aabbccddee is the unit‟s MAC address) Reboot request by SIP Notify message “Check-Sync” (NOTIFY_CHECK_SYNC parameter). Table 15: User-Agent Header Substitute Parameters Substitute Parameter Substituted Value Description $mac1 Substituted with the MAC address of the device in the form aa:bb:cc:dd:ee:ff. $mac2 Substituted with the MAC address of the device in the form aa-bb-cc-dd-ee-ff. $mac3 Substituted with the MAC address of the device in the form aabbccddeeff. $vendor Substituted with the string “Telco Systems”. $version Substituted with the version of the SIP Application. Table 16: SIP Extensions Name Value Description Default SIP_SEND_PRACK {YES | NO} Support PRACK method with provisional response reliability. NO SIP_URI_USER_PARAM {YES | NO} Encode SIP URI with user parameter. NO SIP_INVITE_TIMER <0-4294967295> INVITE Expires Timer value in seconds. None SIP_SESSION_TIMER <0-4294967295> SIP Session Timer value in seconds. Session will be refreshed at half the value of the SIP_SESSION _TIMER None SIP_REGISTER_TIMER <0-65535> SIP Registration Timer value in seconds. SIP Registration Timer value should NOT be lower than 10 seconds. Attempts to register will recur at every half of the SIP_REGISTER_TIMER value. 1800 SIP_SEND_183_RTP {YES | NO} To enable a caller receiving a “183 Session Progress” with SDP to start sending RTP. NO FLASH_HOOK_TIMER_MIN <100-10000ms> Minimum time for Flash Hook 200ms VoIP Configuration Parameters Page 35 of 86 Rev. H Name Value Description Default to be detected. The values are set in 100 millisecond steps. If max value is set to a value equal or smaller than the min value, both parameters are set to their default values. Version 4.57 and later. FLASH_HOOK_TIMER_MAX <100-10000ms> Minimum time for On-Hook (Disconnect) to be detected. The values are set in 100 millisecond steps. If max value is set to a value equal or smaller than the min value, both parameters are set to their default values. Version 4.57 and later. 1100ms SIP_USER_NON_ESCAPED {YES | NO} When YES, symbols like “#” will be sent “as is” and will not be escaped. Version 4.57 and later. NO USER_AGENT STRING User-Agent header value. Can also include substitute Parameters (see Table 15). The length is up to 63 characters. Version 4.45 and later. “Telco Systems hhh vX.X.X” Where: X.X.X is the version number. hhh is the unit type: GW-282, GW-232, GW-483S, GW-483D NOTIFY_CHECK_SYNC {CONF_FILE_POL L_NOW DISABLED | RESET } DISABLED - Check-Sync option is disabled. RESET- Check-Sync option is enabled. CONF_FILE_POLL_NOW Enables starting Auto Configuration when the CheckSync message is received. Note: System will reboot when message is received. Version 4.46 and later. DISABLED Example The following example shows how to change the User-Agent header value to “Telco Systems VoIP Gateway”: USER_AGENT = “Telco Systems VoIP Gateway” VoIP Configuration Parameters Page 36 of 86 Rev. H RFC2833 describes a protocol for sending Telephony events (Receiver ON/OFF Hook, Ring ON/OFF) and DTMF (Dual Tone Multi Frequency) digits in RTP (Real-time Transport Protocol) packets. This method is used as an alternative method for SIP protocol signaling frames to solve a variety of signaling delays. The Payload value is the Payload Type field of the RTP frame. Payloads 0-95 are well defined and reserved values by IANA. Payload values of 96-127 are free (dynamic) and are not reserved by the standards. If the RFC2833 protocol for Telephony events is enabled, voice packets can be suppressed during the transmission of the RFC2833 Telephone Event packets. Table 17 lists the SIP RTP Telephone Event Signaling (RFC2833) configuration parameters. The following parameters can be configured per line: Send Telephone Events via RFC2833 signaling using payload value or send DTMF via SIP_INFO (LINExOOBTELEVENTS and LINExTELEVENTPAYLOAD parameters): When enabled, the Gateway will send RFC2833 frames for the Telephony events and for the DTMF digits. Consult your Call server documentation to know if SIP INFO or RFC2833 option is supported and what Payload value is required. RFC2833 signaling using payload value (OOB RTP Telephone Event Signaling) can be configured per line in the Gateway Web Page at SIP > Line x. Suppress voice packets during RFC2833 Telephone Event packet transmission (LINExDROPVOICE parameter): Enabling this option preserves the original voice bandwidth and prevents the need for more bandwidth for the RFC2833 packets. Consult your Call server documentation for the preferred mode of operation. Squelch inband DTMF audio (LINExSQUELCHDTMF parameter). When the Squelch inband DTMF audio option is selected, DTMF audio tones (inband DTMF) are not transmitted in the audio stream. ABCD event signaling mode (LINExABCDMODE parameter): Two possible modes for RFC2833 Telephony events signaling (ABCD signaling packets) are available: o Transition mode: In this mode, the event packet is sent only at the moment of the event. o Continuous mode: In this mode, the event packet is sent continuously at the rate of the voice, as long as the event exists. The Continuous mode behaves better in situations of packet loss, preventing cases such as stuck ringers. Consult your Call server documentation for the preferred mode of operation. Play DTMF for Out Of Band RFC 2833 DTMF Events (LINExPLAYDTMF parameter): Enables generating DTMF tones for received OOB RFC 2833 DTMF events. Play DTMF tones received via SIP INFO (LINExPLAYINFODTMF parameter): Enables playing DTMF tones received via SIP INFO DTMF events per line. Play DTMF Tones can be configured in the Gateway SIP Web Page at SIP > Line 1 or Line 2. VoIP Configuration Parameters Page 37 of 86 Rev. H Table 17: SIP RTP Telephone Event Signaling (RFC2833) Configuration Parameters Name Value Description Default LINExOOBTELEVENTS {YES | NO | Send Telephone Events via NO RFC2833 signaling using OOB_RFC2833| OOB_SIP_INFO} payload type of the line x (x represents a line number between 1 and 4). Note: YES is the same as OOB_RFC2833. YES is supported for back compatibility with previous versions. OOB_SIP_INFO- Send DTMF via SIP INFO method Version 4.52 and later. LINExTELEVENTPAYLOAD <96-127> Payload value of the line x (x represents a line number between 1 and 4). Version 4.50 and later. 96 LINExDROPVOICE {YES | NO} Drop voice packets during RFC2833 Telephone Event packets of the line x (x represents a line number between 1 and 4). Version 4.50 and later. NO LINExSQUELCHDTMF {YES | NO} Squelch inband DTMF Audio of the line x (x represents a line number between 1 and 4). Version 4.50 and later. NO LINExABCDMODE {TRANSITION | CONTINUOUS} ABCD event signaling mode Audio of the line x (x represents a line number between 1 and 4). Version 4.50 and later. TRANSITION LINExPLAYDTMF {YES | NO} Generates DTMF tones for received OOB RFC 2833 DTMF events of the line x (x represents a line number between 1 and 4). Version 4.50 and later. NO LINExPLAYINFODTMF {YES | NO} Generates DTMF tones for received SIP INFO DTMF events per line. Version 4.55.18 and later. NO With adding new SIP parameters (SIP_SECURITY_ENABLE and SIP_SECURITY_ADDRESS), VoIP lines can accept SIP requests only from the SIP registration server and secured IP address when the SIP security feature is activated Table 18: SIP security Settings Name Value Description Default SIP_SECURITY_ENABLE Y|N Y- enabled N-disabled N VoIP Configuration Parameters Page 38 of 86 Rev. H Name Value SIP_SECURITY_ADDRESS {A.B.C.D | STRING} Description Default IP address or domain name of the trusted server Example The following example shows the configuration of a telephone connected to Line 1: SERVERIP = telco.com ; needed if server’s port is not default port 5060 SERVERPORT=5080 DOMAINNAME=telco.com LINE1NUMBER=7182345678 LINE1CALLERID=John Smith LINE1AUTHUSER=Johnny LINE1AUTHPSWD=!!@#$% ; SIP with NAT outbound proxy=telconat.com SERVERIP = telconat.com MGCP Configuration Parameters The MGCP (Media Gateway Control Protocols) is designed to control Telephony Gateways from external call control elements called media gateway controllers or call agents. A telephony gateway is a network element that provides conversion between the audio signals carried on telephone circuits and data packets carried over the Internet or over other packet networks. If the Gateway has MGCP installed, you need to configure the Call Agent IP address and other MGCP parameters. The MGCP configuration parameters are listed in Table 18. The following parameters can be defined: Call Agent IP address or FQDN address (CALLAGENTADDRESS parameter): FQDN (Fully-Qualified Domain Name) is a portion of an Internet Uniform Resource Locator (URL) that fully identifies the server program that an Internet request is addressed to. The FQDN includes the second-level domain name and any other levels. Set the address of the Call Agent or leave this field blank if you wish to obtain the Call Agent address from a DNS server. Call Agent port (CALLAGENTPORT parameter): Endpoint Gateway Domain Name (ENDPOINTDOMAINNAME parameter) Maximum delay before RSIP (MAXRSIPDELAY parameter): Maximum time in seconds allowed for the Restart in Progress message to be sent to the Call agent. Number of allocated Endpoints (PERM_ENDPOINT parameter): Number of phone lines permitted to register with the Call Agent. Support Message Piggybacking (PIGGYBACK parameter): When this option is enabled, the Gateway is permitted to send Piggyback messages (several MGCP messages sent in one UDP frame) to the Call agent. Support PacketCable NCS 1.0 (VER_NCS10 parameter). VoIP Configuration Parameters Page 39 of 86 Rev. H Support IETF MGCP 1.0 (RFC 2705) (VER_MGCP10 parameter). Maximum disconnect delay before RSIP (MAXRSIPDISCON parameter): If this parameter is not zero, MGCP RSIP will be sent when the link on the Uplink port goes up after being down for a period longer than the Max disconnect delay before RSIP parameter. Maximum packetization to be supported (MAXPACK parameter). Minimum packetization to be supported (MINPACK parameter). RSIP Keep Alive message (MGCP_KEEP_ALIVE_TIMER parameter). Table 18: MGCP Configuration Parameters Name Value Description Default CALLAGENTADDRESS {A.B.C.D | STRING} Address of primary MGCP call-agent. Can be an IP address or FQDN address. The length is up to 97 characters. Note: if Call Agent Address is not defined and CALL_SERVER_NAM E is defined, the Call Agent Address is sought in the DNS server using CALL_SERVER_NAM E CALLAGENTPORT Port number of primary MGCP call agent. 2427 ENDPOINTDOMAINNAME {STRING | MAC_DOMAI N_AUTO} A specific domain name for the unit. For example, if set to telco.com, the complete description of the unit during MGCP transactions will be aaln/[email protected]. If this field is set to MAC_DOMAIN_AUTO, the unit will use its MAC address followed by the unit’s domain name for the endpoint domain name (e.g., aaln/[email protected] o.com If this field is left blank, then the endpoint domain name defaults to the endpoint IP address (i.e. aaln/1@[a.b.c.d]), where a.b.c.d is the unit’s IP address. The length is up to 97 characters. MAC_DOMAIN_AUTO value supported in Version 4.57 and later. Note: Gateway’s IP address MAXRSIPDELAY <0 2147483648> Maximum time-delay in seconds before sending RSIP upon startup. The actual time before RSIP is sent will be a random value between 0 and 600 VoIP Configuration Parameters Page 40 of 86 Rev. H Name Value Description Default MAXRSIPDELAY. PERM_ENDPOINT <1-2> Number of allocated Endpoints. Number of phone lines permitted to register with Call Agent. Note: the minimum is 1 and the maximum is the number of telephone connectors. 2 Note: number of telephone connectors PIGGYBACK {YES | NO} Whether or not to transmit Piggybacked messages. YES VER_NCS10 {YES | NO} Whether or not to support the PacketCable NCS1.0 profile of MGCP. YES VER_MGCP10 {YES | NO} Choose whether or not to support the IETF MGCP1.0 profile of MGCP (RFC 2705). NO MAXRSIPDISCON <04294967295> The maximum disconnect delay before RSIP in seconds. 0 Note: RSIP is not sent when uplink is disconnected and reconnected. CALL_SERVER_NAME STRING CALL SERVER NAME (e.g. mgcp.udp). The length is up to 97 characters. Note: If Call Agent Address is not defined and CALL_SERVER_NAM E is defined, the Call Agent Address is sought in the DNS server using CALL_SERVER_NAM E. MAXPACK <10-100> Maximum packetization in steps of 10 ms to be supported in milliseconds. 100 MINPACK <10-100> Minimum packetization in steps of 10 ms supported in milliseconds. 10 MGCP_KEEP_ALIVE_TIMER <10-600 | 0> seconds When ON, a Keep Alive RSIP message is sent to help keep NAT binding when the MGCP gateway is behind NAT. 0 (Off) Version 4.56 and later. Example MGCP example for the case where only one telephone on Line 1 is permitted to register with the Call Agent: CALLAGENTADDRESS=66.33.22.11 ; needed if Call Agent’s port differs from default 2427 CALLAGENTPORT=2428 ; ENDPOINTDOMAINNAME could also be left empty ENDPOINTDOMAINNAME=282host.telco.com VoIP Configuration Parameters Page 41 of 86 Rev. H PERM_ENDPOINT=1 H.323 Configuration Parameters H.323 is a standard approved by the International Telecommunication Union (ITU) to promote compatibility in videoconference transmissions over IP networks. H.323 was originally promoted as a way to provide consistency in audio, video and data packet transmissions in the event that a Local Area Network (LAN) did not provide Guaranteed Service Quality (QoS). If the Gateway has H.323 installed you need to configure the Gatekeeper IP address and other H.323 parameters. The H.323 configuration parameters are listed in Table 19. The following H.3232 parameters can be defined: Choose whether or not to use GRQ (Gatekeeper Request) for gatekeeper address (GKDISCOVERY parameter). The GRQ is a Registration, Admission, and Status (RAS) message sent as a gatekeeper request. Enter the IP address of your gatekeeper (GATEKEEPERIP parameter). Set the IP address of the alternate H.323 gatekeeper (ALTGATEKEEPERIP parameter). If you want the alternate IP address of H.323 gatekeeper to be used, you need to enable this option (ALTERNATEGK parameter). Use the default dial plan (>#|[2-9]xxxxxxxxx|1[2-9]xxxxxxxxx|x.T) or set your own dial plan (DIALPLAN parameter). You can find more information regarding the dial plan format in the Administrator’s Guide. NOTE Setting the dial plan to include an option with # or ## as the only characters in the option will disable the Keypad Configuration feature. For each phone line, set the following: o Set the phone number with E164 alias (LINExNUMBER parameter). The E164 is the format of global switched telephone numbers as defined by the ITUT (International Telecommunications Union - Telecommunications Standardization Sector). The 16-digit number is split into international, national and user number portions. o Set the caller ID (CALLERIDNAMEx parameter). Enter the “Name” you want to show on the called party‟s Caller ID display. When you make a call from a line of the Gateway with the Caller ID inserted, the remote called party will receive this string. Gateway US version is factory set to FSK (Bellcore) CID. Set the H.323 alias (H323ALIASx parameter). The H.323 Alias is usually descriptive of the particular client terminal and usually contains alphanumeric characters. Enable the RRQ (FULLRRQx parameter). VoIP Configuration Parameters Page 42 of 86 Rev. H The RRQ is a RAS (Registration, Admission, and Status protocol) message sent as a registration request. The RRQ Keep Alive Timer (LINEx_H323_REG_KEEP_ALIVE parameter; „x‟ is the line number) is configurable per telephone line number. The timer‟s value is in seconds. The Actual interval between the RRV packets is 40% of the timer‟s value. Enable T38 fax support (T38FAXx parameter). The T38 is a Real time IP Fax Relay protocol. Set the DTMF Signaling parameters. Dual Tone Multi-Frequency (DTMF) identifies telephone buttons by a combination of two tones. When you press a button, two standard tones are sent. One tone uniquely indicates the row number and the other tone uniquely indicates the column number of the button that you press. Send In-band DTMF (INBANDDTMF parameter) Supports signaling tones within the audio channel. Send Out-of-band DTMF (OUTOFBANDDTMF parameter). Supports signaling tones outside the audio channel. H323 Signaling Ports (H323SIGPORT parameter). The endpoint‟s call-signaling port number. Disable fast connect ( LINEx_H323_DISABLE_FASTCONNECT parameters; „x‟ is the line number). Disable H.245 tunneling (LINEx_H323_DISABLE_H245TUNNELING parameters; „x‟ is the line number). Table 19: H.323 Configuration Parameters Name Value Description / Default GKDISCOVERY {YES | NO} Choose whether or not to use GRQ for gatekeeper address. DEFAULT: NO GATEKEEPERIP {A.B.C.D | STRING} IP address or domain name of H.323 gatekeeper. The length is 18 characters. DEFAULT: None ALTGATEKEEPERIP A.B.C.D IP address of alternate H.323 gatekeeper. DEFAULT: None ALTERNATEGK {ENABLED | DISABLED} Choose whether or not to support an alternate gatekeeper. DEFAULT: DISABLED DIALPLAN STRING Dial plan matching string. Warning: #, ## (as sole characters) will disable Keypad feature. DEFAULT: >#|[2-9]xxxxxxxxx| 1[2-9]xxxxxxxxx|x.T DIALPLANTIMER VoIP Configuration Parameters 1 – 30 seconds After dialing any number, this parameter represents the number Page 43 of 86 Rev. H Name Value Description / Default of seconds before an attempt is made to make a call. DEFAULT: 3 LINEx_H323_REG-KEEP_ALIVE <0-65535> RRQ Keepalive timer (per telephone line). The actual interval between RRQ packets is 40% of the timer’s value. x is the line number. DEFAULT: 1200 seconds LINExNUMBER E164 number (alias) of the line x (x can be a number between 1 and 4). DEFAULT: 555zzzx where zzz is the last number in the units IP address and x is the line number. CALLERIDNAMEx STRING Caller ID string for line x (x can be a number between 1 and 4). The length is up to 97 characters. DEFAULT: FSK H323ALIASx STRING H.323 alias for line x (x can be a number between 1 and 4). The length is up to 97 characters. DEFAULT: IPG-yyy-x Note: yyy is the Unit’s MAC H323_FORCE_G729x {YES | NO} Used to force G.729 (without A annex). Version 4.57 and later. DEFAULT: NO (DISABLED) FULLRRQx {ENABLED | DISABLED} Choose whether or not to send a full RRQ message instead of a lightweight RRQ message during RRQ KeepAlive for line x (x can be a number between 1 and 4). DEFAULT: DISABLED T38FAXx {ENABLED | DISABLED} Choose whether or not T38 fax is supported on line x (x can be a number between 1 and 4). DEFAULT: DISABLED INBANDDTMF {ENABLED | DISABLED} Choose whether or not to send inband DTMF tone. DEFAULT: ENABLED OUTOFBANDDTMF {ENABLED | DISABLED} Choose whether or not to send selected out-of-band DTMF messages. DEFAULT: ENABLED KEYPADTYPE {0 | 1 | 2} 0 - Q931 The Q.931 protocol contains control information that is exchanged with telephone networks. 1 - H245 Enables forwarding H.245 user input indication messages. VoIP Configuration Parameters Page 44 of 86 Rev. H Name Value Description / Default 2 - RFC2833 Enables the RFC2833 protocol for transmission of Telephony event packets. DEFAULT: 0 H323SIGPORT <0-65535> The actual ports used are base+x. Where x=1 for Line 1 and x=2 for Line 2. If only line 1 is available, static port 1720 can be used (base needs to be set to 1719). If both lines are available, dynamic ports should be used. Version 4.52 and later. DEFAULT: 4000 LINEx_H323_DISABLE_H245TUNNELING {YES | NO} Enable/disable H.245 tunneling Version 4.57 and later. DEFAULT: NO (ENABLED) LINEx_H323_DISABLE_FASTCONNECT {YES | NO} Enable/disable fast connect Version 4.57 and later. DEFAULT: NO (ENABLED) Example The following example sets the IP address of H.323 gatekeeper to 220.1.2.60, the dial plan matching string to 555xxxx|9xxxxxxx|x.T|># and the telephone numbers to 5551000 and 5551001: GATEKEEPERIP=220.1.2.60 DIALPLAN=555xxxx|9xxxxxxx|x.T|># LINE1NUMBER=5551000 LINE2NUMBER=5551001 H.323 and SIP Audio/CODEC Standards The H.323 and SIP Audio/CODEC standards are listed in Table 20. The Gateway supports G711 u-law and a-law standards by default. The user can set the Gateway to also support one of the three voice coding standards: G723, G726 or G729. Both ports will be allowed to use the selected option concurrently. The remaining ports (if any) will support G711 u-law and alaw. For every supported voice coding standard the user can enable/disable Silence Suppression and, except for G723, select the default Packetization period (as a multiple of 10ms in the range 10ms-100ms). The following parameters can be set: Audio/CODEC standard: G711 u-law (G711UON parameter), G711 a-law (G711AON parameter), G723 (G723ON parameter), G726 (G726ON parameter) and G729 (G729ON parameter). VoIP Configuration Parameters Page 45 of 86 Rev. H NOTE Only one complex code (G723, G726, and G729) can be selected. Set the Packetization period for: G711 u-law (G711UPACK parameter), G711 a-law (G711APACK parameter), G723 (G723PACK parameter), G726 (G726PACK parameter) and G729 (G729PACK parameter). Enable Silence Suppression support: G711 u-law (G711USS parameter), G711 a-law (G711ASS parameter), G723 (G723SS parameter), G726 (G726SS parameter) and G729 (G729SS parameter). Select either adaptive or fixed jitter buffer (JB_TYPE parameter) Note: FIXED is the default value for voice calls and is always used for fax sessions. Set the Fixed Jitter Buffer which is the fixed playout delay in milliseconds (FJB_DELAY parameter). The Jitter Buffer value for voice calls can be configured in the Gateway Web Page at the MGCP CODEC screen. The configuration range is 10-200 milliseconds in 10 millisecond steps. The default value is 100 milliseconds. Enable echo cancellation support: G711 u-law (G711UEC parameter), G711 a-law (G711AEC parameter), G723 (G723EC parameter), G726 (G726EC parameter) and G729 (G729EC parameter). Enable to force G729 without A annex (H323_FORCE_G729 parameter). Table 20: H.323 and SIP Audio/CODEC Configuration Parameters Name Value Description Default G711UON {YES | NO} Choose whether or not G711U is supported. YES G711AON {YES | NO} Choose whether or not G711A is supported. YES G723ON {YES | NO} Choose whether or not G723 is supported. NO G726ON {YES | NO} Choose whether or not G726 is supported. NO G729ON {YES | NO} Choose whether or not G729 is supported. NO G711USS {YES | NO} Choose whether or not silence suppression for G711U is supported. YES G711ASS {YES | NO} Choose whether or not silence suppression for G711A is supported. YES G723SS {YES | NO} Choose whether or not silence suppression for G723 is supported. YES G726SS {YES | NO} Choose whether or not silence suppression for G726 is supported. YES G729SS {YES | NO} Choose whether or not silence suppression for G729 is supported. YES G711UPACK Packetization period in milliseconds for G711U. The range is 10-100ms in steps of 10ms. 30 G711APACK Packetization period in milliseconds for G711A. The range is 10-100ms in steps of 10ms. 30 VoIP Configuration Parameters Page 46 of 86 Rev. H Name Value Description Default G723PACK Packetization period in milliseconds for G723. The ITU G.723 states that the Packetization period should be 30ms. The range is 10-100ms in steps of 10ms. 30 G726PACK Packetization period in milliseconds for G726. The range is 10-100ms in steps of 10ms. 30 G729PACK Packetization period in milliseconds for G729. The range is 10-100ms in steps of 10ms. 30 G711UEC {YES | NO} Choose whether or not echo cancellation for G711U is supported. YES G711AEC {YES | NO} Choose whether or not echo cancellation for G711A is supported. YES G723EC {YES | NO} Choose whether or not echo cancellation for G723 is supported. YES G726EC {YES | NO} Choose whether or not echo cancellation for G726 is supported. YES G729EC {YES | NO} Choose whether or not echo cancellation for G729 is supported. YES JB_TYPE {FIXED | ADAPTIVE} FIXED is selected for voice calls and is always used for fax sessions. FIXED AJB_MAXDELAY <10-200> milliseconds This parameter is effective when the JB_TYPE parameter is set to ADAPTIVE. 100 FJB_DELAY <10-200> milliseconds Fixed Jitter Buffer (FJB) period in milliseconds. 100 Example ; G711U is supported G711UON=YES ; G711A is supported G711AON=YES ; G723 is not supported G723ON=NO ; G729 is not supported G729ON=NO Additional SIP Audio/CODEC configuration parameters are listed in Table 21: Preferred CODEC per phone line (LINExFORCECODEC parameter). Preferred fax CODEC (FAX_CODEC parameter). Table 21: Additional SIP Audio/CODEC Configuration Parameters Name Value Description Default LINExFORCECODEC {G711U | G711A | G723 | G726 | G729 | NONE} Selects the preferred CODEC regardless of its position in the SDP packet during the CODEC negotiation No preferred CODEC is set and the first common CODEC in SDP CODEC list is selected. VoIP Configuration Parameters Page 47 of 86 Rev. H Name Value Description Default process for line x (x can be a number between 1 and 4). Version 4.44 and later. Note: In Version 4.56 software and later, this parameter can be used for both incoming and outgoing INVITE. Also, the G711 CODEC can be set first in the SDP if it is set as Preferred. Note: A preferred CODEC should be selected only if the CODEC is ON by default, or was set to ON with one of the following commands: G711UON, G711AON, G723ON, G726ON or G729ON. FAX_CODEC {G711A | G711U | NONE} Selects the preferred fax CODEC. Version 4.44 and later. G711U The MGCP Audio/CODEC standards are listed in Table 22. The Gateway supports G711 ulaw and a-law standards by default. The user can set the Gateway to also support one of the three voice coding standards: G723, G726 or G729. Both ports will be allowed to use the selected option. Set the Audio/CODEC standard: G711 u-law (G711UON parameter), G711 a-law (G711AON parameter), G723 (G723ON parameter), G726 (G726ON parameter) and G729 (G729ON parameter). Table 22: MGCP Audio/CODEC Configuration Parameters Name Value Description Default G711UON {YES | NO} Choose whether or not G711U is supported. YES G711AON {YES | NO} Choose whether or not G711A is supported. YES G723ON {YES | NO} Choose whether or not G723 is supported. NO G726ON {YES | NO} Choose whether or not G726 is supported. NO G729ON {YES | NO} Choose whether or not G729 is supported. NO AJB_MAXDELAY <10-200> milliseconds This parameter is effective when the JB_TYPE parameter is set to ADAPTIVE. 100 FJB_DELAY <10-200> Fixed (FJB) period in milliseconds. 100 RFC2833 describes a protocol for sending Telephony events (Receiver ON/OFF Hook, Ring ON/OFF) and DTMF digits in RTP packets. This method is used as an alternative method for the MGCP protocol signaling frames to solve a variety of signaling delays. The Payload value is Payload Type field of the RTP frame. Payloads 0-95 are well defined and reserved values by IANA. Payload values of 96-127 are free (dynamic) and are not reserved by the standards. If the RFC2833 protocol for Telephony events is enabled, voice packets can be suppressed during the transmission of the RFC2833 Telephone Event packets. The RFC2833 protocol configuration parameters are listed in Table 23. The following parameters can be defined: VoIP Configuration Parameters Page 48 of 86 Rev. H Suppress voice packets during RFC2833 Telephone Event packet transmission (DROPVOICE parameter): Enabling this option preserves the original voice bandwidth and prevents the need for more bandwidth for the RFC2833 packets. Consult your Call server documentation for the preferred mode of operation. Send Telephone Events via RFC2833 signaling using payload value (LINExOOBTELEVENTS and LINExTELEVENTPAYLOAD parameters): When enabled, the Gateway will send RFC2833 frames only for the Telephony events. To also support RFC2833 frames for the DTMF digits, set the OOBKEYPADEVENTS parameter. Send RFC2833 keypad events (OOBKEYPADEVENTS parameter): enables sending the DTMF digits 0-9,*,#. Consult your Call server documentation to learn if this RFC2833 option is supported and what payload value is required. Squelch inband DTMF audio value (SQUELCHDTMF parameter). When the Squelch inband DTMF audio option is selected, DTMF audio tones (inband DTMF) are not transmitted in the audio stream. ABCD event signaling mode (ABCDMODE parameter): Two possible modes for RFC2833 Telephony events signaling (ABCD signaling packets) are available: o Transition mode: In this mode, the event packet is sent only at the moment of the event. o Continuous mode: In this mode, the event packet is sent continuously at the rate of the voice, as long as the event exists. The Continuous mode behaves better in situations of packet loss, preventing cases such as stuck ringers. Consult your Call server documentation for the preferred mode of operation. Table 23: RFC2833 Out-of-band Telephone Events Signaling Configuration Parameters Name Value Description Default OOBTELEVENTS {YES | NO} Choose whether or not to send telephone events over RTP using RFC2833. NO OOBKEYPADEVENTS {YES | NO} Choose whether or not to send DTMF digits 0-9,*,# over RTP using RFC2833. Version 4.55.18 and later. NO DROPVOICE {YES | NO} Choose whether or not to drop voice packets during transmission of RFC2833 telephone event RTP packets. NO TELEVENTPAYLOAD <96-127> Payload code to use for RFC2833 telephone event packets. 96 SQUELCHDTMF {YES | NO} Choose whether or not to squelch DTMF audio (i.e. avoid transmitting DTMF tones in the audio stream). NO ABCDMODE {TRANSITION | CONTINUOUS} TRANSITION: ABCD signaling is sent only at ABCD event changes (e.g. hook status change). CONTINUOUS: ABCD signaling is sent TRANSITION VoIP Configuration Parameters Page 49 of 86 Rev. H Name Value Description Default continuously for the duration of an onhook state, and is not sent for an offhook state. PLAYDTMF {YES | NO} VoIP Configuration Parameters Generates DTMF tones for received OOB RFC 2833 DTMF events. Version 4.62 and later. NO Page 50 of 86 Rev. H Miscellaneous Configuration Parameters Clock and CID Localization Configuration Parameters The parameters for setting the clock to local time are listed in Table 24: NTP Server IP address (NTPSERVERIP parameter). Local time zone, relative to GMT (TIMEZONE parameter). Automatically adjusts the internal clock to daylight saving time according to the local time zone (DST parameter). The parameters for local country for local CID support are listed in Table 24: Choose the local country (COUNTRY parameter). The Country CID can be configured in the Gateway Web page Miscellaneous > Local > Caller ID. Table 24: Clock and CID Localization Configuration Parameters Name Value Description Default COUNTRY {USA | UK | BELGIUM | GERMANY | FRANCE | JAPAN | DENMARK | SWEDEN | ITALY} Country CID Denmark supported in Version 4.57 and later. USA NTPSERVERIP A.B.C.D IP address of the NTP server. None TIMEZONE Time in minutes from GMT. -480 Note: PST DST {YES | NO} Adjust for daylight saving when set to YES. NO LINExREVERSE_POLARITY {YES | NO} When YES, the FXS Port Reverse Line Polarity reverses the polarity of the associated telephone line during initialization the unit. The new reversed configuration will be considered the “Normal” polarity. Version 4.56.46 and later. NO LINExCALL_REVERSE_POLARITY {YES | NO} When set to YES: - The unit will reverse the line polarity compared to the normal idle state when sending an ACK message to an INVITE. - When the handset is NO Miscellaneous Configuration Parameters Page 51 of 86 Rev. H Name Value Description Default hung up, the line polarity will be returned to normal idle state. Version 4.56.46 and later. Example The following example enables the daylight saving time and sets the time zone 120 minutes behind GMT. DST=YES TIMEZONE=-120 NTPSERVERIP=clock.ntp.com Ring Signal Format There are two options for setting the Ring Signal: a Balanced Trapezoid at 20 Hz and an Unbalanced Sinusoid at 25 Hz. See the RING_FORMAT parameter in Table 25. The Ring Signal Format can be configured in the Gateway Web Page at Miscellaneous > Local. Select the desired Ring Format. Table 25: Ring Signal Format Name Value Description Default RING_FORMAT 1|0 Set to “1” for Unbalanced Sinusoid at 25 Hz. Set to “0” (default) for Balanced Trapezoid at 20 Hz. 0 (balanced trapezoid at 20 Hz) PSTN (Life Line) Configuration Parameters The parameters for enabling the PSTN (Public Switched Telephone Network) standby option are listed in Table 26. The PSTN, also referred to as the Plain Old Telephone Service (POTS), is the collection of worldwide interconnected voice-oriented public telephone networks, both commercial and government-owned. It is the aggregation of circuit-switching telephone networks. Table 26: PSTN (Life Line) Configuration Parameters Name Value Description Default PSTN_ENABLE {0 | 1} 1 - Enables PSTN standby option. 0 - Disables PSTN standby option. When enabled, if registration with the Call server is not 0 Miscellaneous Configuration Parameters Page 52 of 86 Rev. H Name Value Description Default achieved within 10 minutes after boot or there is a power outage or if three consecutive attempts to register fail, telephone line 1 will be connected to the PSTN port. Hz. Example The following example enables the PSTN standby option: PSTN_ENABLE=1 Syslog Daemon Address Configuration The Syslog Daemon Address Configuration table below describes the parameters for setting the Syslog server: Syslog Server IP address or domain name (SYSLOGD_ADDRESS parameter). Message severity level (MSG_SEVERITY_LEVEL parameter). The severity is inversely related to the specified level (0 represents highest severity, 7 represents lowest severity). When you specify a severity level, logging output of the specified level and all lower levels (higher severities) are enabled. NOTE If you do not want the logging facility to operate, do not set the Syslog server IP address (SYSLOGD_ADDRESS=””). For more information on the logging facility, see the Administrator’s Guide. Table 27: Syslog Daemon Address Configuration Name Value Description Default SYSLOGD_ADDRESS {A.B.C.D | STRING} Syslog server IP address or Domain name. None MSG_SEVERITY_LEVEL <0-7> Message severity level. 3 Note: Error level Example ; set the Syslog server IP address to 10.2.71.47 SYSLOGD_ADDRESS=10.2.71.47 ; set the severity level to 7 (debug) MSG_SEVERITY_LEVEL=7 Miscellaneous Configuration Parameters Page 53 of 86 Rev. H Upload System Configuration from NVRAM The system configuration from NVRAM can be uploaded to Syslog. This configuration can be performed in the Gateway Web Page at Miscellaneous > Syslog. Enter appropriate information and click Upload Config. The NVRAM entries will be received at the Syslog. The entries will be numbered. The last entry will be marked Total: #xxx, where xxx is the number of NVRAM entries. If not all entries were received, the user can repeat the request starting at any entry by entering the starting entry number in the Start Upload Entry field of the Syslog Web page. Port Protocol Configuration The parameters for setting the protocols ports in use are listed in Table 28: HTTP server port (HTTP_SERVER_PORT parameter). Telnet server port (TELNET_SERVER_PORT parameter). Syslog client port (SYSLOG_CLIENT_PORT parameter). TFTP client port (TFTP_CLIENT_PORT parameter). HTTP client port (HTTP_CLIENT_PORT parameter). Table 28: Port Protocol Configuration Name Value Description Default HTTP_SERVER_PORT <1-65535> HTTP server port. 80 TELNET_SERVER_PORT <1-65535> Telnet server port. Version 4.46 and later. 23 SYSLOG_CLIENT_PORT <1-65535> Syslog client port. Version 4.46 and later. 514 HTTP_CLIENT_PORT <1-65535> HTTP client port. Version 4.46 and later. HTTP = 80 TFTP_CLIENT_PORT <1-65535> TFTP client port. Version 4.46 and later. TFTP = 69 Note: The actual port in use is determined by the Auto Configuration Server Protocol parameter. Example ; set the Syslog server IP address to 10.2.71.47 SYSLOGD_ADDRESS=10.2.71.47 ; set the severity level to 7 (debug) MSG_SEVERITY_LEVEL=7 Example The following example changes the HTTP server port to 1422: HTTP_SERVER_PORT=1422 Miscellaneous Configuration Parameters Page 54 of 86 Rev. H OEM Type and Generic Mode Configuration The following parameters are listed in Table 29: OEM user (OEM_TYPE parameter) Option to set a factory default configuration that is different from the one that was set by the gateway manufacturer. Generic type (FIRM_CODE parameter) This option allows you to remove the “Telco Systems” brand name from the web management and Telnet. No other name will appear instead. Table 29: OEM Type Configuration Name Value Description Default OEM_TYPE STRING Defines an OEM user for changing parameters’ default values. All Configuration parameters tagged with ^^xxx^, where xxx is the OEM_TYPE name, will be restored during Set to defaults. The name is up to 19 characters in length. A short name is recommended; otherwise, it would not be possible to tag all parameters with the OEM parameter. Empty FIRM_CODE {0 | 1} 0 – Generic mode 1 – Telco Systems 1 Example ; define the OEM name OEM_TYPE=telco ; define that the ADV_SC_ENABLE parameter will be enabled by default when using “telco” OEM name ^^telco^ADV_SC_ENABLE=1 Line (input) gain for telephone ports. x represents the port number (1-4 for GW-282/482; 1-2 for GW483S/GW-483D and GW-232). Gain (Volume) Configuration Voice gain for FXS ports can be configured in the Gateway SIP Application Web Pages SIP Line1 and SIP Line2 > Gain Control Configuration. Table 30: Input and Output Gain for FXS Name Value Description Default INPUT_GAIN_LINEx -12 - +3 Line (input) gain for telephone ports. x represents the port number (1-4 for GW282/482; 1-2 for GW-483S/GW-483D and GW-232). Ver 4.57 and later. -3 OUTPUT_GAIN_LINEx -12 - +3 Output (headset) gain for telephone ports. x represents the port number (1-4 for GW282/482; 1-2 for GW-483S/GW-483D and -3 Miscellaneous Configuration Parameters Page 55 of 86 Rev. H Name Value Description Default GW-232). Ver. 4.57 and later. Keypad Configuration The Keypad configuration parameters are listed in Table 31. One way to perform basic configuration commands (e.g., set factory defaults, change the IP mode from DHCP to fixed, hear the current IP address announced), is to enter configuration commands using the telephone keypad. Use this option if you have lost normal access to the Gateway via a PC. The following commands are active ten minutes from boot on the telephone connected to line 1. To set the factory defaults (PHONE_FOR_DEFAULT parameter): Dial ##3332858 (D,E,F,A,U,L,T). Once the command is accepted, you will hear “DOT” announced over the headset, the Management LED (GW-282/482 and GW-232) on the front panel will glow a steady green and after about 30 seconds the unit will power up with factory defaults. To set the LAN IP mode: To change the LAN IP mode from DHCP to fixed or vice-versa, dial ##3427937 (D,H,C,P,Y,E,S) for DHCP (PHONE_FOR_DHCPYES parameter) or ##342766 (D,H,C,P,N,O) for fixed LAN IP 10.1.0.54 Mask 255.255.0.0 (PHONE_FOR_DHCPNO parameter). You will hear "DOT" announced over the headset, the Management LED on the front panel will glow a steady green for about 3 seconds and the unit will boot with the required IP setting. To hear the current LAN IP (PHONE_FOR_IPADDR parameter): address announced over the headset Dial ##472337 (I,P,A,D,D,R). Table 31: Keypad Configuration Name Value Description Default PHONE_FOR_DHCPYES STRING Alphanumeric string (maximum length 20) which represents the phone number value for setting LAN to use DHCP. When phone number is entered, AC parameter IF0DHCP=DHCP. Can be disabled by setting to any non-keypad character. ##3427937 Note: ##DHCPYES PHONE_FOR_DHCPNO STRING Alphanumeric string (maximum length 20) which represents the phone number value for setting LAN to use a fixed IP. Can be disabled by setting to any non-keypad character. When a phone number is entered, the following AC parameters are set: IF0DHCP=FIXED; set to FIXED IP configuration IF0IPADDRESS=10.1.0.54; IP address IF0IPNETMASK=255.255.0.0; Net mask IF0IPGATEWAY=""; No IP gateway ##342766 Note: ##DHCPNO Miscellaneous Configuration Parameters Page 56 of 86 Rev. H Name Value Description Default address PHONE_FOR_DEFAULT STRING Alphanumeric string (maximum length 20) which represents the phone number value for setting factory defaults. Can be disabled by setting to any non-keypad character. ##3332858 Note: ##DEFAULT PHONE_FOR_IPADDR STRING Alphanumeric string (maximum length 20) which represents the phone number value for hearing LAN IP over the handset. Can be disabled by setting to any non-keypad character. ##472337 Note: ##IPADDR Example 1 The following example sets a new key sequence for setting factory defaults (must start with ##): PHONE_FOR_DEFAULT=##123 Example 2 The following example disables the option to set factory defaults via the keypad: PHONE_FOR_DEFAULT=”” SIP Advanced Calling Features The SIP Advanced Calling features that can be configured are listed in Table 32. Most of SIP Advanced Calling features can be either enabled or disabled. By default, all Advanced Calling features are enabled. The assigned key sequences for using the Asterisk (*) calling features can also be configured. If a feature is disabled, its Asterisk key sequence is not in use and can be used for another feature. The Advanced Calling features can be configured in the Gateway Web page Miscellaneous > Calling. Following is a partial list of the Advanced Calling features that are set. For a full list see the Administrator’s Guide: Conditional Call Forwarding – To activate “Conditional Call Forwarding”, dial *1 (KEY_FWD_CONDITION parameter) and then dial the destination number. If the call has been made and the phone has not been picked up within 20 seconds, the call is forwarded to the destination number. To cancel Call Forwarding, dial *3 (KEY_FWD_OFF parameter). Unconditional Call Forwarding – To activate “Unconditional Call Forwarding”, dial *2 (KEY_FWD_ON parameter) and then dial the destination number. If the call has been made and the phone has not been picked up within 20 seconds, the call is forwarded to the destination number. To cancel Call Forwarding, dial *3 (KEY_FWD_OFF parameter). Do Not Disturb (DND) – To activate DND, dial *4 (KEY_DND_ON parameter). The caller will hear the “busy” tone. To cancel DND, dial *5 (KEY_DND_OFF parameter). Dialing to Last Received Caller (Call return) – To dial the last received caller, dial *69 (KEY_LAST_REDIAL parameter). Miscellaneous Configuration Parameters Page 57 of 86 Rev. H Block Last Received Caller – To block the last caller, dial *60 (KEY_LAST_BLOCK parameter). To start accepting calls from the blocked number again, dial *80 (KEY_LAST_ACCEPT parameter). To cancel the periodic Auto Redialing before the timeout has been reached, dial *86 (KEY_AUTO_REDIAL_OFF parameter). Auto Redial – When a number is dialed and the dialed number is busy, the Caller can activate Auto Redial by hanging up, dialing *66 (KEY_AUTO_REDIAL_ON parameter) and laying the handset down again. The Gateway will periodically dial the busy number for a default period of 30 minutes (TIMER_AUTO_REDIAL parameter). When the dialed number is reached the Caller will be notified with a special distinctive ring. When the Caller picks up the phone he will be immediately in the call. If the called party hangs up and the caller does not pick up the phone when the special ring tone is heard, then on the next attempt to use the phone the Caller will get a busy signal indicating that the Auto Redial service succeeded. To place the next call, the caller needs to hang up and pick up the phone again. Anonymous Call Rejection (ACR) - The Gateway can reject all calls with Anonymous CID (display name). Anonymous Call Rejection (ACR) can be Enabled/Disabled at the Gateway Web Page Miscellaneous > Calling. The keypad values for rejecting/receiving anonymous calls are also configurable. The default value to activate rejecting anonymous calls is *77 and to re-accept anonymous call is *78. The default value is ACR Enabled. Table 32: SIP Advanced Calling Name Value Description Default ADV_CALLING {{WAITING, WAITING_ID, CID, CONFERENCE, REDIAL_LAST, DIST_RINGS, TRANSFER, DND, FORWARD, BLOCK_LAST, BLOCK_CID, AUTO_REDIAL, ACR} | NO_ADV | }} Enable/Disable Advanced Calling features. To enable a partial list, set a list with the enabled features only. To disable all features, set parameter to NO_ADV. Note: - AUTO_REDIAL in version 4.52 and later. - BLOCK_CID in version 4.53.16 and later. Blank Note: all features are enabled. DEAD_AIR_PERIOD <0-65535> (seconds) Sets a period of silence (dead air) at the end of a call before hearing the busy tone. Version 4.54.33 and later. 0 (no dead-air period) KEY_ACR_ON *<1-999> Anonymous Call Rejection (ACR) Version 4.56.46 and later. *77 KEY_ACR_OFF *<1-999> Anonymous Call reAccepting (ACR). Version 4.56.46 and later. *78 KEY_BLOCK_CID *<1-999> Keypad value for Blocking Caller ID (per call). Version 4.53.16 and later. *70 KEY_FWD_CONDITION * Sets the Conditional Call Forwarding on. *1 Miscellaneous Configuration Parameters Page 58 of 86 Rev. H Name Value Description Default KEY_FWD_ON * Sets the Unconditional Call Forwarding on. *2 KEY_FWD_OFF * Sets the Call Forwarding off. *3 KEY_DND_ON * Sets the Do Not Disturb (DND) on. *4 KEY_DND_OFF * Sets the Do Not Disturb (DND) off. *5 KEY_TRANSFER * Sets the Blind Call Transfer. *98 KEY_LAST_REDIAL * Sets Dial last caller (Call return). *69 KEY_LAST_BLOCK * Sets the Block last caller. *60 KEY_LAST_ACCEPT * Sets the Accept last caller. *80 TIMER_AUTO_REDIAL <1-65535> The time period in seconds for dialing a busy number. Version 4.52 and later. 1800 KEY_AUTO_REDIAL_ON *<1-999> Activate Auto Redial by hanging up. Version 4.52 and later. *66 KEY_AUTO_REDIAL_OFF *<1-999> To cancel the periodic Auto Redialing before the timeout has been reached. Version 4.52 and later. *86 KEY_DIRECTCALL *<1-999> ** Example 1 The following example for SIP enables only Call Waiting and display of CID for Call Waiting: ADV_CALLING=WAITING,WAITING_CID Example 2 The following example disables all SIP advanced calling features: ADV_CALLING=NO_ADV Example 3 The following example for SIP sets a new key sequence for activating DND: KEY_DND_ON=*888 Miscellaneous Configuration Parameters Page 59 of 86 Rev. H SIP Direct Calling (Peer to Peer) It is possible to perform a direct SIP (Peer to Peer) call without the need to register on a SIP Server. To enable Direct calls, a URL entry including the user information, host and port must be configured. The Send Registration Request parameter SERVERREGISTER may be set to YES or NO. A dial tone is normally played only when the device is registered. A dial tone will be played even when the Send Registration Request field is set to NO if a Direct call URL entery exists. To perform a direct call, dial the default phone book entry activation key: “**” and then the index of the phone book entry (1-9). The default activation key can be changed via the KEY_DIRECTCALL parameter. See the “Advanced Calling” Table. Following are the Direct Calling parameters. Table 33: Direct Calling Auto Configuration Parameters Name Value Description Default SIP_PHONE_BOOKx x =1-9 @: Up to nine Direct call URL entries can be configured. The following lines describe the format of an entry Ver. 5.5.26 None userinfo {numeric | string} max 64 characters None host {A.B.C.D | string} SIP Host max 49 characters None port <1-65535> UDP port 5060 SIP CID Configuration When CID Information is Missing When CID Name and Number are Missing It is possible to configure a string that will be displayed on the telephone for cases that the CID name and number are missing in the SIP INVITE message. This is done by configuring the Auto Configuration parameter CID_CNAM_ANONYMOUS with a valid CID string. This string is sent to the telephone. By default the parameter is null and an empty string is sent to the telephone. When CID Name is Missing and the Number is Available It is possible to configure the string that will be displayed on the telephone for cases that the CID name is missing but the number is available in the SIP INVITE message. To configure this option use the Auto Configuration parameter CID_CNAM_UNKNOWN. If this parameter is set to “Y” only the CID number is sent to the telephone and it is up to the telephone to determine the CID name to be displayed. By default the value is “N” and the CID number is sent to the telephone as CID name and CID number. The CID name displayed by some telephones is shorter than the CID number. Setting CID_CNAM_UNKNOWN to “N” might cause telephones with only one display window to display the CID number shorter than ten digits. Miscellaneous Configuration Parameters Page 60 of 86 Rev. H Table 34: CID Missing Configuration Parameters Name Value Description Default CID_CNAM_ANONYMOUS string CID string that will be sent to the telephone if CID name and number are missing in the SIP INVITE. None CID_CNAM_UNKNOWN {Y|N} If this parameter is set to “Y” only the CID number is sent to the telephone and it is up to the telephone to determine the CID name to be displayed. If the value is “N” and the CID number is sent to the telephone as CID name and CID number Ver. 4.60.35 and later N SIP Half Call Model A SIP calling model called “Half Call Model” can be used for supporting SIP Call Hold, Call Waiting and 3-way calling. When operating in this mode, if a user presses the hook-flash, the unit does not park the existing conversation and give dial tone - but simply sends a NOTIFY to the Proxy Server. The Proxy takes care of switching the RTP streams to the Call Waiting call, and the same for the 3-way calling feature. As far as the unit is concerned, there is always only one conversation between itself and the Proxy. To activate this mode, set Auto Configuration parameter HALF_CALL_MODE=YES. The gateway will include SUBSCRIBE in the “Allow:” header field, at the start of the conversation, immediately following the 200 OK sent by the Proxy. The Proxy is required to send a 'SUBSCRIBE' request with an 'Event: telephone-event' header field in it. By default the Auto Configuration parameter is set to “NO” and the option is disabled. Table 35: Half Call Model Configuration Parameters Name Value Description Default HALF_CALL_MODEL {YES | NO} When operating in this mode, if a user presses the hook-flash, the unit does not park the existing conversation and give dial tone - but simply sends a NOTIFY to the Proxy Server Ver 4.62.14 NO VPN Solution for SIP and RTP Packets An option to set a proprietary VPN for SIP and RTP packets. Once the VPN option is enabled, all SIP and RTP packets will be encapsulated and will be sent to the VPN server. All SIP and RTP packets coming from the VPN server are also expected to be encapsulated with the VPN. The VPN feature can be configured via the following Auto Configuration parameters: DVPN_SERVERADDR (IP address of remote VPN server), DVPN_SERVERPORT (port of remote VPN server), DVPN_LOCALPORT (local port for receiving incoming VPN packets) and DVPN_ENCFORMAT (eight bits encoding flag that will be placed at the beginning of the VPN header). By default, the parameters DVPN_SERVERADDR and DVPN_SERVERPORT are null, DVPN_ENABLE is set to NO and the feature is disabled. Miscellaneous Configuration Parameters Page 61 of 86 Rev. H Table 36: VPN for SIP and RTP Auto Configuration Parameters Name Value Description Default DVPN_ENABLE {YES | NO} Enable the DVPN feature No DVPN_SERVERADDR {A.B.C.D | string} IP address of remote VPN server Null DVPN_SERVERPORT 0-65535 Port number of remote VPN server Null DVPN_LOCALPORT 0-65535 Local port for receiving VPN packets. 7000 DVPN_ENCFORMAT 0-255 Encoding flag that will be placed at the beginning of the VPN header 0 Miscellaneous Configuration Parameters Page 62 of 86 Rev. H SIP Distinctive Rings and Call Waiting Tones The parameters for SIP support for distinctive rings and distinctive call waiting tones are listed in Table 38. This feature enables the called party to identify the caller based on Distinctive Rings and Call Waiting Tones. The feature is dependent on the remote caller or the SIP server for including the Alert-Info header with the appropriate Ring Name in the INVITE message for the Distinctive Ring or Call Waiting Tone. Eight Ring Cadences (patterns) with eight Ring Names used by both telephone lines can be configured for the Distinctive Rings and six Ring Cadences (with the same Ring Names as for the Distinctive rings) are used for the Call Waiting Tones. The default values for the Ring Cadences and their Ring Names are based on the five Bellcore GR-506-CORE ring patterns. If the Ring Name in Alert-Info header is not recognized or is not supplied, the standard Bellcore Ring pattern 1 is always used and cannot be changed to another pattern. The default Alert-Info Ring names can be configured to different names but the default names will also be recognized. Table 37 lists the default Ring Cadences with their associated names. Eight defaults are used by the Distinctive Rings and six defaults - by the Call Waiting Tones. The default values are used when the tables are left blank. Table 37: Default Ring Cadences with Associated Names Ring Number Ring Cadence Alert-Info Ring Name 1 ON 2000 ms OFF 4000 ms Bellcore-dr1 2 ON 800 ms OFF 400 ms ON 800 ms OFF 4000 ms Bellcore-dr2 3 ON 400 ms OFF 200 ms ON 400 ms OFF 200 ms ON 800 ms OFF 4000 ms Bellcore-dr3 4 ON 300 ms OFF 200 ms ON 1000 ms OFF 200 ms ON 300 ms OFF 4000 ms Bellcore-dr4 5 ON 500 ms OFF 20 ms Bellcore-dr5 6 ON 2000 ms OFF 4000 ms Bellcore-dr6 7 ON 2000 ms Bellcore-dr7 SIP Distinctive Rings and Call Waiting Tones Page 63 of 86 Rev. H Ring Number Ring Cadence Alert-Info Ring Name OFF 4000 ms 8 ON 2000 ms OFF 4000 ms Bellcore-dr8 The following parameters can be set: Alert-Info ring name (RING_NAME_x parameter: RING_NAME_1 through RING_NAME_8). Distinctive Ring cadences (RING_1x parameter: RING_1 through RING_8). Call Waiting Ring Tones (CALLWAITING_x parameter: CALLWAITING_1 through CALLWAITING_6). Table 38: SIP Distinctive Rings and Call Waiting Tones Name Value Description Default RING_NAME_x STRING Option to identify the caller based on a distinct ring. Ring Names are used for Distinctive Rings and Call Waiting tones. The names are sent in the Alert-Info header of the INVITE message to indicate the ring that should be played. x range is 1-8. Empty Note: default names Bellcore-drx (x=1..8) are used. RING_x STRING Distinctive Rings Cadences (patterns) associated with the Ring Names (RING_NAME_x). The parameter can be: ON, OFF, IDLE, R-repeat, time in milliseconds. x range is 1-8. Example: RING_2=ON(200),OFF(300),ON(100),O FF(400),ON(200),IDLE(4000),R Empty Note: RING_1-RING_5 use the 5 standard Bellcore Rings. RING_6-RING_8 by default use Bellcore standard ring 1. CALLWAITING_x STRING Call Waiting tone Cadences (patterns) associated with the Ring Names (RING_NAME_x). x range is 1-6. Note: For setting values other than default, see the following description for Call Waiting Tone Cadences. Empty Note: RING_1-RING_5 use the 5 standard Bellcore Rings. RING_6 uses Bellcore standard ring 1. Example The following example replaces the standard Bellcore-dr1 ring. When either the name Bellcore-dr1 or fax_ring is sent, the configured RING_1 will be heard: RING_NAME_1=fax_ring RING_1=ON(2000),OFF(2000),ON(1000),R SIP Distinctive Rings and Call Waiting Tones Page 64 of 86 Rev. H Call Progress Tones Call Progress Tones are audible signals that are used to inform the user of the progress of a call. By default standard Bellcore tones are used. The Tones can be configured to support local country standards or to support a user‟s flavor of tones. The Call Progress Tones can be configured in the Web page Miscellaneous > Ring Tones > Call Progress Tones. Table 39: Configurable FXS Progress Tones Name Value Description / Default / Version DIALTONE Frequency@Power #Cadence The Dial Tone indicates that the network is ready to accept a phone number. Ver 4.57 and later. Default: 350@-12+440@-12#ON(100),R BUSY Frequency@Power #Cadence This tone is played in the headset when the destination number is engaged or when a call is ended. Ver. 4.57 and later. Default: 480@-12+620@-12#ON(500),OFF(500),R NETWORK_BUSY Frequency@Power #Cadence The Reorder Tone, also known as Network Busy or Fast busy sounding like a fast busy signal, is played in the headset if a call cannot be completed due to a network error other than destination busy (line is engaged). Ver. 4.57 and later. Default: 480@-12+620@-12#ON(250),OFF(250),R OFFHOOK_WARNING Frequency@Power #Cadence Receiver off-hook (ROH) warning tone. Warning tones are heard when the receiver is left off hook. When the receiver is picked up a dial tone is heard for the first 10 seconds. After 10 seconds a Busy tone is heard for 20 seconds (value of OFFHOOK_WARNING_TIMER) and then followed by a Receiver off-hook (ROH) warning tone for another 60 seconds. Ver. 4.57 and later. Default: 1400@-6+2060@-6+2450@-6+2600 @-6#[ON(100), OFF(100)]200 OFFHOOK_WARNING_TIMER <0-65535> seconds Period of the Busy tone when receiver is left off hook. The period of the ROH tone is three times the period of the Busy tone. If the Busy tone period is set to zero, only the dial tone will be heard when the receiver is left off hook. Version 4.54.33 and later. Default: 20 RINGBACK Frequency@Power #Cadence Indicates that the dialed number is being alerted (called). Ver. 4.57 and later. Default: 440@-12+480@2#ON(2000),OFF(4000),R CONFIRM Frequency@Power #Cadence Indicates that the network has processed a request received by the caller, e.g. activation/deactivation of call forwarding. Ver. 4.57 and later. Default: SIP Distinctive Rings and Call Waiting Tones Page 65 of 86 Rev. H Name Value Description / Default / Version 350@-12+440@-12#ON(100),OFF(100),R STUTTER_DIAL Frequency@Power #Cadence Indicates there is a message waiting. Ver. 4.57 and later. Default: 350@-13+440@13#[ON(100),OFF(100)]10 RING_0 Cadence Indicates to the callee that his number is being called. This tone is audible by the callee. Ver. 4.57 and later. Default: ON(2000),OFF(4000),ON(2000),R HOLD Frequency@Power #Cadence Hold tone can be played in the Handset while the line is on Hold. Ver. 4.58 and later Example: 600@19#ON(100),OFF(100),ON(100),OFF(100), ON(100),IDLE(9500),R Default: None Call Waiting Tone Cadences The Miscellaneous Ring tones Web page includes the table Call Waiting Tone Cadences for configuring Distinctive Call Waiting tones. The table includes six entries. The five entries after the first entry are used when the remote caller or SIP server include the Alert-Info header with an appropriate Ring Name for the required Distinctive Call Waiting tone. If the Ring Name is not recognized or not supplied, a default tone is used. The first entry is used to configure the default Call Waiting tone. In previous versions the default Call Waiting tone was not configurable. The default Call Waiting tone is heard 5 times and has the Format: 440@-13#[on(300),IDLE(3700)]5 To change the tone to be heard 4 times use the format: 440@-13#[on(300),IDLE(3700)]4 Following is a detailed description for configuring the Call Waiting Tone Cadences table. Detailed Configuration Description An entry in the preceding tables has the form: Frequency@Power#Cadence or Cadence Frequency – Frequency of the tone in Hz; Power- Power of the tone in dBm, i.e. it is relative to 1mW and may take negative values meaning that the power of the tone volume is less than 1mW; You can also use: Frequency@Power+ Frequency@Power+ … which means that а compound tone, comprising different harmonic signals (with different frequencies and levels) is used. Cadence – Ring pattern SIP Distinctive Rings and Call Waiting Tones Page 66 of 86 Rev. H Cadence includes Sequences. Sequence: ON(Timeval) or ON(Timeval), OFF(Timeval), …, where Timeval is the duration in milliseconds that the tone is active (ON) or non-active (OFF). Example: ON(100), OFF(200), ON(300) A Sequence can be repeated a number of times: [sequence]number where number is the number of times the sequence is repeated Example: [ON(100), OFF(200), ON(300), OFF(400)]3 A Sequence can be inactive for a specified time period or it can be repeated indefinitely: [Sequence]number,R or [Sequence]number,IDLE(Timeval),R R - means the given Sequence is repeated indefinitely. IDLE(Timeval) - means the Sequence is inactive for Timeval milliseconds. Example: [ON(100), OFF(200), ON(300), OFF(400)]3, IDLE(2000),R Examples Example 1 - European dial tone 425@-5#ON(1000),R The tone is frequency 425Hz at level -5dbm and is repeated indefinitely. Example 2 1800@100#[ON(500),OFF(100),ON(100)]4,ON(100),OFF(100),IDLE(2000),R The Sequence ON-OFF-ON is repeated 4 times. After that, the Sequence ON(100), OFF(100) and then Idle for two seconds is repeated indefinitely. The default Ring Cadences with their associated names are listed in Table 37 Eight defaults are used by the Distinctive Rings and six defaults - by the Call Waiting Tones. The default values are used when the tables are left blank. SNMP Configuration Parameters Refer to the following tables for related SNMP information: Table 40 lists the global parameters for setting the SNMP (Simple Network Management Protocol). Table 41 lists the parameters for setting the SNMP traps configuration. Table 42 lists the parameters for setting the SNMP community configuration. SIP Distinctive Rings and Call Waiting Tones Page 67 of 86 Rev. H Table 43 lists the parameters for setting the SNMP system configuration. Table 40: SNMP Global Configuration Parameters Name Value Description Default SNMP_ENABLE {0 | 1} 0 = SNMP Disable 1 = SNMP Enable 1 TEMPERATURE_POLLING_TIME <1-> Minimum retransmit period (minutes) of the temperature. 600 Table 41: SNMP Traps Configuration Parameters Name Value Description Default TRAPHOSTIPADDRESS A.B.C.D IP address of the Trap Host. None TRAPHOSTCOMMUNITY STRING Trap Host Community. public IS_TEMPERATURE_TRAP {0 | 1} 0 - Disable the CPU Temperature Exceeded high light trap. 1- Enable the CPU Temperature Exceeded high light trap. Note: Not supported on GW-232/AC-232. IS_DOOR_OPENED_TRAP {0 | 1} 0 - Disable the Door Opened trap. 1 - Enable the Door Opened trap. Note: Supported only on GW-282S, GW-483S, and GW-483D. IS_DOOR_CLOSED_TRAP {0 | 1} 0 - Disable the Door Closed trap. 1 - Enable the Door Closed trap. Note: Supported only on GW-282S, GW-483S, and GW-483D. IS_BATTERY_LOW_TRAP {0 | 1} 0 - Disable the Battery Low trap. 1 - Enable the Battery Low trap. Note: Supported only on GW-282S, GW-483S, and GW-483D. IS_LINKUP_TRAP {0 | 1} 0 - Disable the LinkUp trap. 1 - Enable the LinkUp trap. IS_LINKDOWN_TRAP {0 | 1} 0 - Disable the LinkDown trap. 1 - Enable the LinkDown trap. Table 42: SNMP Community Configuration Parameters Name Value Description Default SNMPREADCOMMUNITY STRING SNMP read Community Public SNMPWRITECOMMUNITY STRING SNMP write Community Private SIP Distinctive Rings and Call Waiting Tones Page 68 of 86 Rev. H Table 43: SNMP System Configuration Parameters Name Value Description Default SNMPSYSNAME STRING MIB-II system name. None SNMPSYSCONTACT STRING MIB-II system contact string. None SNMPSYSLOCATION STRING MIB-II system location string. None Example The following example enables SNMP on the GW-282 Gateway: ; enable SNMP SNMP_ENABLE = 1 ; set the IP address of the trap host to 10.2.1.5 TRAPHOSTIPADDRESS = 10.2.1.5 ; set the trap host community to public TRAPHOSTCOMMUNITY = public ; set the read community to private SNMPREADCOMMUNITY = private ; set the write community to public SNMPWRITECOMMUNITY = public ; set the MIB-II system name to GW-282 SNMPSYSNAME = GW-282 ; set the MIB-II system contact string to [email protected] SNMPSYSCONTACT = [email protected] ; set the MIB-II system location string to building_3A SNMPSYSLOCATION = building_3A SIP Distinctive Rings and Call Waiting Tones Page 69 of 86 Rev. H Security Configuration Parameters In today‟s networks, security is very important for protecting the Gateway and your local network from hackers. The following security features are available in the Gateway (Table 44): Advanced security - specifying a list of IP addresses that can manage the Gateway (ADV_SC_ENABLE parameter). Up to eight IP addresses can be set in the IP address list. The IP addresses of stations permitted to manage the unit with HTTP or Telnet can be configured in the Gateway Web Page at Security > Advanced. The IP Address of the HTTP server used in Auto Configuration must also be added to the table if Advanced Security is enabled. DHCP security – to receive an IP address and other configuration parameters only from the DHCP servers that are listed in the IP address list (DHCP_SC_ENABLE parameter). Up to eight IP addresses can be set in the IP address list. The management port number (MANAGER_PORT parameter). When setting a port as manager, the management can be done only from this port. The IP addresses list, up to eight IP addresses used to set the allowed management station (advanced security feature) and DHCP servers (DHCP security feature), is described in Table 44 (IP_SCRT_1, IP_SCRT_2, IP_SCRT_3, IP_SCRT_4, IP_SCRT_5, IP_SCRT_6, IP_SCRT_7 and IP_SCRT_8 parameters). A subnet mask field (IP_MASK_SCRT_x) allows defining an IP subnet instead of a single IP address. NOTE To permit management of the Gateway only to specified stations, you must enter the IP address for each station allowed. If no stations are specified, all stations are permitted to manage the Gateway. Blocking the Gateway management via HTTP and/or Telnet on the LAN interfaces (Table 45). Installing an Encryption Key in order to use encryption with a configuration file (Table 46). Table 44: Advanced Security Configuration Name Value Description Default ADV_SC_ENABLE {1 | 0} 1 - Advanced Security enabled. 0 - Advanced Security disabled. 0 DHCP_SC_ENABLE {1 | 0} 1 - DHCP Security enabled. 0 - DHCP Security disabled. 0 MANAGER_PORT The management port number. The ports number is in range <1-8> (for GW-282 with GigE uplink the port number is in range <1-9>). Empty IP_SCRT_x A.B.C.D Management IP Address Empty Security Configuration Parameters Page 70 of 86 Rev. H Name Value Description Default IP_MASK_SCRT_x A.B.C.D Subnet Mask Address Empty x is 1-8 for up to 8 stations. Example ; disable advanced security DV_SC_ENABLE = 0 ; enable DHCP security DHCP_SC_ENABLE = 1 ; set management IP address 1 to 10.2.42.55 IP_SCRT_1 = 10.2.42.55 ; set management IP address 2 to 10.2.42.12 IP_SCRT_2 = 10.2.42.12 ; set management IP address 3 to 10.2.156.150 IP_SCRT_3 = 10.2.156.150 The service access security configuration options are listed in Table 45. Table 45: Service Access Configuration Parameters Name Value Description Default TELNET_ENABLE {1 | 0} 1 - Enable Telnet 0 - Disable Telnet 1 USER_LEVEL_ACCESS {Y | N} Choose whether or not to allow User Mode Access. In this mode, the user will have limited Web access (some screens are blocked) while the Admin has full access. Version 4.44 and later. N Note: This parameter is valid only in the AC/GW-232 products. CLI_HIDDEN_PSW STRING Password for controlling access to the Command Line Interface (CLI). “” By default, no password is assigned. Note for CLI_HIDDEN_PSW: When the CLI_HIDDEN_PSW parameter is not empty, CLI activity will be disabled and concealed (hidden from view), including the CLI prompt. Typing a character or pressing the Return key will not result in a visible on-screen response. Only entering the correct password will return the CLI display to its normal state. Example 1 The following example enables Telnet on the unit: TELNET_ENABLE = 1 Example 2 ; disable the password for accessing the CLI: CLI_HIDDEN_PSW = "" Security Configuration Parameters Page 71 of 86 Rev. H ; set password for accessing the CLI to cli_pasword CLI_HIDDEN_PSW = cli_pasword The encryption configuration parameters are listed in Table 46: Encryption key up to 64 characters that will be used to decrypt the “Root” configuration file (CFG_PASSWORD parameter). Encryption key up to 64 characters that will be used to decrypt the General configuration file (CFG_GEN_PSWD parameter). Table 46: Encryption Configuration Parameters Name Value Description Default CFG_PASSWORD STRING Encryption key up to 64 characters that will be used to decrypt the “Root” configuration file. See also AUTO_USE_MAC parameter in Table 5. Empty Note: “Root” configuration file is not encrypted. CFG_GEN_PSWD STRING Encryption key up to 64 characters that will be used to decrypt the General configuration file. AUTO_USE_MAC does not alter the key. Empty Note: General configuration file must not be encrypted. The parameters for setting/updating the Admin and User passwords using clear text in a configuration file are listed in Table 47: Setting the admin password (ADMIN_PASS parameter). Setting the user password (USER_PASS parameter). Removing the admin password (ADMIN_REMOVE_PASS parameter). Removing the user password (USER_REMOVE_PASS parameter). Table 47: Admin and User Password Configuration Name Value Description Default ADMIN_PASS STRING The admin password. This password is encrypted and saved. The length is up to 20 characters. Version 4.44 and later. Note: After setting the admin password, this parameter will not appear in the configuration file since it is encrypted. None USER_PASS STRING The user password, which is encrypted and saved. The length is up to 20 characters. Version 4.44 and later. Notes: - This parameter is valid only in the AC/GW232 products and only if USER_LEVEL_ACCESS has been set. - After setting the user password, this parameter will not appear in the configuration file since it is encrypted. None Security Configuration Parameters Page 72 of 86 Rev. H Name Value Description Default ADMIN_REMOVE_PASS Y Removes the admin password. Version 4.44 and later. None USER_REMOVE_PASS Y Removes the user password. Version 4.44 and later. None Example ; setting the admin password to “root” ADMIN_PASS = root ; setting the user password to “user_1” USER_PASS = user_1 ; Removing the admin password ADMIN_REMOVE_PASS = Y ; Removing the user password USER_REMOVE_PASS = Y Security Configuration Parameters Page 73 of 86 Rev. H Port Configuration Parameters The available port configuration parameters: status (enable, disable) and duplex speed (autonegotiated, half-10, full-10, half-100, full-100, half-1000 and full-1000) are listed in Table 48. NOTE To set the port configuration for all ports, set the PORT_CONFIG parameter for each port separately. It is also possible to set the type of the eighth port for GW-282 (the ninth port in GW-282S) to copper or fiber, depends on the uplink‟s type. Table 48: Port Configuration Parameters Name Value Description Default PORT_CONFIG ,{E | ENABLE | D | DISABLE}, {A | AUTONEGOTIATE | HALF10 | FULL10 | HALF100 | FULL100 | HALF1000 | FULL1000} Port number, status, and duplex-speed. The port number range is <1-8>. For Gateways with the GigE uplink, the range is <1-9>. ENABLE, AUTONEGOTIATE PORT8_FO_TX {TX | FO} Sets the type of the eighth port for GW-282 (the ninth port in GW-282S). TX – copper port FO – fiber port TX Example 1 ; enable port 1 on auto-negotiation mode PORT_CONFIG 1,ENABLE,AUTONEGOTIATE ; enable port 2 on auto-negotiation mode PORT_CONFIG 2,E,A Example 2 ; enable port 1 on auto-negotiation mode PORT_CONFIG 1,,A ; enable port 2 on auto-negotiation mode PORT_CONFIG 2,, Example 3 ; disable port 1 and set the duplex-speed mode to half-10 PORT_CONFIG 1,DISABLE,HALF10 ; disable port 2 and set the duplex-speed mode to half-100 PORT_CONFIG 2,D,HALF100 Port Configuration Parameters Page 74 of 86 Rev. H Example 4 ; disable port 1 on auto-negotiation mode PORT_CONFIG 1,D, ; enable port 1 and set the duplex-speed mode to full-100 PORT_CONFIG 2,E,FULL100 Example 5 ; setting the eighth port (or ninth port in GW-282S) to copper PORT8_FO_TX=TX ; setting the eighth port (or ninth port in GW-282S) to fiber PORT8_FO_TX=FO Port Configuration Parameters Page 75 of 86 Rev. H IGMP Configuration Parameters IGMP Configuration By default IGMP is enabled, however in order to activate the service, VLANs must be enabled and an IGMP service must be set. Refer to 282/482/232 User guide for detailed IGMP configuration settings. The parameters for setting the IGMP (Internet Group Multicast Protocol) configuration are listed in Table 49: Enable IGMP (IGMP_ENABLE parameter). NOTE When IGMP is enabled the IGMP VLANs must also be configured (VLAN_TAG_IGMP parameter in Table 11). Enable multiple hosts per port or only single host per port (SINGLE_HOST parameter). Set the Last Member Query Interval (IGMP_SPEC_QUERY_RESP_INT parameter). The expected response time, in seconds, for answering a specific query. Increasing the response time makes the traffic less bursty, by spreading out host responses over a larger interval. Set the The IGMP Proxy IP address (IGMP_PROXY_IP parameter). Enable IP Multicast Flooding (MCST_FLOODING_ENABLE parameter). NOTE You can set IP multicast non-flooding range with the UNKNOWN_MULTICAST_MIN and UNKNOWN_MULTICAST_MAX parameters. The Minimum IP address in the IP Multicast non-flooding range (UNKNOWN_MULTICAST_MIN parameter). The Minimum IP address in the IP Multicast non-flooding range (UNKNOWN_MULTICAST_MAX parameter). Table 49: IGMP Configuration Parameters Name Value Description Default IGMP_ENABLE {0 | 1} 0 - Disable IGMP. 1 - Enable IGMP. 1 SINGLE_HOST {0 | 1} 0 - Enable multiple hosts per port. 1 - Enable only single host per port. 0 IGMP Configuration Parameters Page 76 of 86 Rev. H Name Value Description Default IGMP_SPEC_QUERY_RESP_INT Last Member Query Interval (in units of 100 milliseconds). Range: 5-100 10 IGMP_PROXY_IP A.B.C.D The IGMP Proxy IP address. None IGMP_MIN_QUERY Minimum Query interval. General queries received within an interval less than the IGMP_MIN_QUERY are not transferred to the IGMP hosts Range: 5-4294967295 seconds 5 MCST_FLOODING_ENABLE {0 | 1} 0 - Disable IP Multicast Flooding. 1 - Enable IP Multicast Flooding. Note: You can set IP multicast non-flooding range with the UNKNOWN_MULTICAST_MIN and UNKNOWN_MULTICAST_MAX parameters. 0 UNKNOWN_MULTICAST_MIN A.B.C.D The Minimum IP address in the IP Multicast non-flooding range. 224.0.1.0 UNKNOWN_MULTICAST_MAX A.B.C.D The maximum IP address in the IP Multicast non-flooding range. 239.255.255.255 LAST_MEMB_QUERY_CNT <1-9> The number of group-specific queries sent before the unit assumes that there are no local members on a port. The number is effective only if SINGLE_HOST is not enabled. Example ; enable IGMP IGMP_ENABLE=1 ; disable IP multicast flooding MCST_FLOODING_ENABLE=0 ; set the minimum IP address in the IP multicast non-flooding range to 224.0.1.0 UNKNOWN_MULTICAST_MIN=224.0.1.0 ; set the maximum IP address in the IP multicast non-flooding range to 239.255.255.255 UNKNOWN_MULTICAST_MAX=239.255.255.255 ; enable multiple hosts per port SINGLE_HOST=0 ; set the Last Member Query Interval to 10x100 milliseconds IGMP_SPEC_QUERY_RESP_INT=10x ; set the IGMP Proxy IP address to 11.22.33.44 IGMP_PROXY_IP =11.22.33.44 IGMP Configuration Parameters Page 77 of 86 Rev. H QoS Configuration Parameters The available QoS configuration parameters: global priority mapping, default port priority, 802.1p and DiffServ mapping per port, egress and ingress limit are listed in Table 48. Table 50: QoS Configuration Parameters Name Value Description QOS_COS_MAP <8021p>, - QOS_COS_USE_PRIO <8021p>, QOS_COS_DEFAULT EGRESS_LIMIT INGRESS_LIMIT ; [; QoS Configuration Parameters Default <8021p> is in the Disabled [||| ] format. It describes the mapping of the 802.1p priority to the local traffic classes in the range <03> is in the [||| ] format. It describes the mapping of the DiffServ to the local traffic in the range <0-3> is a priority list and the following rules are used: “-“ means empty list - 1,2,3 – coma-separated list of values - 1-3 – a hyphenated range of priorities <8021p> represents Disabled the list of ports on which 802.1p to Traffic Class (TC) mapping is applied represents the list of ports on which DiffServ to TC mapping is applied is a comaseparated list of ports. “-“ means empty list. - is a comaDisabled separated list that represents the mapping between TC priorities and the relevant ports. describes a Disabled list of ports, the rate Page 78 of 86 Rev. H Name Value ] Description Default they share and the ratio to be used for sharing. The format is []:, where: - is an integer followed by “k/K/m/M” to note when to use kbps or Mbps. is comma-separated list of :. Example 1 ;This defines a global priority map where traffic class is: ;0 - for 802.1p priority 0,1,2,3 and DiffServ 0,1,2…60 ;1 - for 802.1p priority 4,5,6 ;2 - no mapping to this TC ;3 - for 802.1p priority 7 and DiffServ 61,62,63 QOS_COS_MAP=[0-3|4,5,6|-|7],[0-60|-|-|61,62,63] QOS_COS_MAP=[-|-|-|-],[0-60|-|-|61,62,63] NOTE When 8021p and diffserv are simultaneously configured, only 8021p parameters will be considered. Example 2 ;This will setup the default TC as follows: ;0 – ports 1,5,9,10 (for 9 and 10 –there is no value, therefore it is ;0) ;1 – ports 2,6 ;2 – ports 3,7 ;3 – ports 4,8 QOS_COS_DEFAULT=0,1,2,3,0,1,2,3 Example 3 ;If all ports have links then the actual rates will be: ;Port 1 - 1Mbps ; 2 – 2Mbps ; 3 – 3Mbps ;If port 2 goes down, then the rate will be recalculated to: ;Port 1 – 6*1/4=1.5Mbps ;Port 3 – 6*3/4=4.5Mbps EGRESS_LIMIT=[1:1M,2:2M,3:3M]:6M QoS Configuration Parameters Page 79 of 86 Rev. H RSTP Configuration Parameters The available RSTP configuration parameters are listed in the table below: Table 51: RSTP Configuration Parameters Name Value Description Default RSTP_ENABLE {0 | 1} 0 RST_BRIDGE_PRIORITY <0-61440> RST_BRIDGE_MAX_AGE <6-28> RST_BRIDGE_HELLO_TIME <1-9> RST_BRIDGE_FORWARD_DELAY <4-30> RST_FORCE_VERSION {0 | 2} RST_PORT_PRIORITY <0-240>, <0-240>, <0-240>, <0-240>, <0-240>, <0-240>, <0-240>, <0-240>, <0-240>, <0-240>, RST_PORT_ADMIN_EDGE {0 | 1},{0 | 2},{0 | 3},{0 | 4},{0 | 5},{0 | 6},{0 | 7},{0 | 8},{0 | 9},{0 | 10}, <0-2>, <0-2>, <02>, <0-2>, <0-2>, <0-2>, <0-2>, <02>, <0-2>, <0-2>, Enables/Disabl es RSTP. 0 – Disables RSTP 1 – Enables RSTP Sets the RSTP bridge priority. The priority must be in steps of 4096. Sets the bridge max-age in seconds Sets the bridge hello-time in seconds Sets the bridge forward-delay in seconds Set RSTP/STP compatibility Sets priority for all ports. Only values divisible by 16 are accepted (e.g. 0, 16, 32, 48…). The priority must be in steps of 16. Marks a port as an edge-port. Sets the link type of the port. 2 - Auto Considers the switch to be connected to a point-to-point LAN segment if any of the following conditions are true: a) The switch concerned 2,2,2,2,2,2,2,2,2,2, RST_PORT_ADMIN_P2P RSTP Configuration Parameters 32768 20 2 15 2 128,128,128,128,128, 128,128,128,128,128, 0,0,0,0,0,0,0,0,0,0, Page 80 of 86 Rev. H Name PORT_PATH_COST Value <1-200000000>, <1-200000000>, <1-200000000>, <1-200000000>, <1-200000000>, <1-200000000>, <1-200000000>, <1-200000000>, <1-200000000>, <1-200000000>, Description supports autonegotiation, and the autonegotiation function has determined that the LAN segment is to be operated in full duplex mode. b) The switch entity has been configured by management means for full duplex operation. Otherwise, the MAC is considered to be connected to a LAN segment that is not point-topoint (shared media). 1 - Point-toPoint Considers the switch to be connected to a point-to-point LAN segment which forces the operational link-type to be point-to-point. 0 - Shared Considered the switch to be connected to a shared media LAN segment which forces the operational link-type to be shared. Sets the RSTP port path-cost for all ports. Default 20000, 20000, 20000, 20000, 20000, 20000, 20000, 20000, 20000, 20000, Example 1 RSTP_ENABLE=1 ;Enables the RSTP. RSTP Configuration Parameters Page 81 of 86 Rev. H Example 2 RST_BRIDGE_PRIORITY=4096 ;Sets the bridge priority to 4096. Example 3 RST_BRIDGE_MAX_AGE=6 ;Sets the bridge max-age to 6 seconds. Example 4 RST_BRIDGE_HELLO_TIME=1 ;Sets the bridge hello-time to 1 second. Example 5 RST_BRIDGE_FORWARD_DELAY=20 ;Sets the bridge forward-delay to 20 seconds. Example 6 RST_FORCE_VERSION=0 ;Set RSTP/STP compatibility to version 0. Example 7 RST_PORT_PRIORITY=160,128,128,128,128,128,128,128,128,128, ;Sets the priority on port 1 to 160 and sets all other ports to 128. Example 8 RST_PORT_ADMIN_EDGE=0,2,0,0,0,0,0,0,0,0, ;Sets port 2 as edge port. Example 9 RST_PORT_ADMIN_P2P=2,2,2,0,2,2,2,2,2,2, ;Sets port 4 as shared other ports to auto. Example 10 PORT_PATH_COST=200000,200000,100,100,200000,200000,200000,200000,2000 0,20000, ;Sets the path-cost on port 3 and port 4 to 100 and sets all other ports to 200000. RSTP Configuration Parameters Page 82 of 86 Rev. H Configuration File Example ; Configuration Parameters. Don't edit this line !!! ; ; ; Networking Parameters ; ; LAN Network Interface Configuration Parameters ; ; set the IP address of the unit to be fixed IF0DHCP=FIXED ; ; ; set the IP address of the unit to 9.2.1.100 IF0IPADDRESS=9.2.1.100 ; set the subnet mask of the unit to 255.255.255.0 IF0IPNETMASK=255.255.255.0 ; ; VoIP Configuration Parameters ; SIP Configuration Parameters ; ; set the SIP domain name SERVERIP=fwd.pulver.com DOMAINNAME=fwd.pulver.com SERVERPORT=5060 SERVERREGISTER=YES ; set the transport protocol to be UDP TRANSPORT_TYPE=UDP ; set the Caller-ID string for line x LINE1CALLERID=TEST ; set the line x to 512-266-1234 LINE1NUMBER=5122661234 LINE1AUTHPSWD=letmein LINE1CALLERID=5122661234 LINE1AUTHUSER=5122661234 LINE1PORT=5060 LINE1AEC=ON ; support reliable provisional response transmission SIP_SEND_PRACK=YES ; ;=================================================================== ; SIP NAT Settings. ;=================================================================== ; SIP STUN Server Settings. ; ; set STUN server IP address to 10.2.1.2 STUN_IP=10.2.1.2 ; set STUN server port to 15100 STUN_PORT=15100 ; ;=================================================================== ; SIP Extensions ;=================================================================== ; SIP RTP Telephone Event Signaling (RFC2833) Configuration ;=================================================================== ; For SIP CODEC configuration parameters see H323 & SIP CODEC ; Configuration File Example Page 83 of 86 Rev. H ; configuration. ;=================================================================== ; VoIP Configuration Parameters ; ; MGCP Configuration Parameters ; ;=================================================================== ; ; VoIP Configuration Parameters ; ; H.323 Configuration Par ; ;=================================================================== ; VoIP Configuration Parameters ; ; H323 & SIP Audio CODEC Configuration Parameters ; ; set only G711U and G711A support G711UON=YES G711AON=YES G723ON=NO G726ON=NO G729ON=NO ; set that silence suppression for G711U and G711A is supported G711USS=YES G711ASS=YES G723SS=NO G726SS=NO G729SS=NO ; ;==================================================================== ; VoIP Configuration Parameters ; ; MGCP Audio CODEC Configuration Parameters ; ;=================================================================== ; ; VoIP Configuration Parameters ; ; RFC2833 Out-of-band Telephone Events Signaling ; Configuration Parameters. ; ;=================================================================== ; ; LAN Configuration Parameters ; ; DHCP Server Configuration Parameters ; ;=================================================================== ; ; LAN Configuration Parameters ; ; Port Forwarding Configuration Parameters ; ;=================================================================== ; Miscellaneous Configuration Parameters ; ; Clock & CID Localization Configuration Parameters ; ; set the CID Country to USA COUNTRY=USA Configuration File Example Page 84 of 86 Rev. H ; set the IP address of the NTP server to 192.100.1.1 NTPSERVERIP=192.100.1.1 ; set the Time Zone to -120 minutes TIMEZONE=-120 ; adjust for day light savings DST=YES ; ;=================================================================== ; ; Security Configuration Parameters. ; ; Advanced Security Configuration ; ;=================================================================== ; ; Security Configuration Parameters. ; ; Service Access Configuration Parameters ; ; disable using HTTP on the LAN interface HTTPLAN=NO ; disable using Telnet on the LAN interface TELNETLAN=NO ; disable User Mode Access (only AC-232/GW-232) USER_LEVEL_ACCESS=N ; ; disable using Telnet TELNET_ENABLE = 0 ; ;=================================================================== ; ; Config Port Configuration Parameters ; ; set port 0: enable in auto-negotiation mode PORT_CONFIG 0,E,A ;=================================================================== ; ; Auto Configuration and Copy ; ; Preset file Load Parameters ; ; This group is a collection of controls and data for file download ; of subsequent sessions. The values will be saved in current session ; but will not be used by the current session. ; ; -----------------------------------------------------------------; set the TFTP server IP address for the location of the software ; image files or MNG_LOAD_IP=192.100.97.1 ; ; -----------------------------------------------------------------; ; set the image file name MNG_LOAD_NAME = sip_282_4_20.rom ; set the configurations file name MNG_LOAD_NAME = ipg_282.cfg ; ;=================================================================== ; ; Auto Configuration Parameters Configuration File Example Page 85 of 86 Rev. H ; ; Control Parameters ; ; enable the auto configuration update AUTO_CONFIG_ENABLE=1 ; set the Configuration ID to “always” FILE_PARM_NUM_UPDATE= always ; set the IP address of the TFTP server for the remaining downloads TFTP_SERVERIP=192.100.97.1 ; set the protocol to be used in Automatic Configuration IF1AC_PROTOCOL=TFTP ; set the pooling period to 24 hours IF1AC_POLLING=24 ; ;- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - ; Update General Configuration file ; ; enable update of the general configuration file for file named ; ipg_general.cfg AUTO_GEN_UPDATE=ENABLE FILE_GEN_PARM_NAME=ipg_general.cfg ; ;- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - ; ; Update Application ; ; enable application image update for file named h323_282.rom version 1.10 AUTO_APP_UPDATE=ENABLE APP_FILE_NAME=sip_282_4_20.rom APP_VERSION=1.10 ; ;- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - ; ; Update Loader ; ; enable Automatic Loader Update AUTO_LDR_UPDATE=ENABLE Automatic Loader Update ; set the loader image name to upgr_282_11016.rom version 1.10 LDR_FILE_NAME=upgr_282_11016.rom LDR_VERSION=1.10 ; ;- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - ; ; Auto Configuration ; TFTP Retries. ; ; set 5 TFTP Retries MAX_REPEAT_TFTP = 5 ; set the Time Delay after TFTP error to 60 seconds TIME_WAIT_TFTP = 60 Configuration File Example Page 86 of 86