|
The configuration management commands allow the user to set values for system configuration parameters. In addition, they provide a mechanism to allow a user to control when new parameter values are put into use.
The Command Line Interface (CLI) maintains three areas where the parameters are stored:
- Temporary
- Active
- Non-volatile Storage (NVS)
When a set command is entered and processed, it changes the parameter value in the Temporary area. This does not affect current operation of the Elite Gateway*, which is using the values in the Active area. The config activate command moves configuration data from the Temporary area to the Active area, where it can actually be used. Thus a user can make multiple changes in the Temporary area using set commands, then put them into use with a single config activate command. (Note that the config activate command may only be used between calls, and will usually tear down any in-progress calls when invoked.)
Configuration data in the Active area is only available while the Elite Gateway remains in operation. If the Elite Gateway is reset, the Active area is reloaded from the data stored in NVS. Data in the Active area may be saved to NVS by entering the config store command.
For most of the H.323 parameters, settings won't take effect until the Elite Gateway is reset. To ensure the H.323 settings do take effect, it is recommended to reset the Elite Gateway after changing the settings using the set command.
In summary:
- Use set commands to make configuration parameter changes in the Temporary area
- Use the config activate command to move the new values into the Active area, making them available for use
- Use the config store command to save the new Active values in NVS
- Reset the Elite Gateway after changing H.323 settings and storing the settings to NVS.
For information on how to connect and use the CLI, see the Using the Command Line Interface document.
config {activate|store|erase}
Use the activate command to manage the configuration data. A sequence of set commands are typically preceded by and/or followed by the config command for the set command to become active.
Syntax description
| activate |
Move the configuration from temporary area to active area. |
| store |
Store the active configuration data into non-volatile storage. |
| erase |
Erase the configuration from non-volatile storage. | show h323
The show h323 command displays the settings of the parameters that are related to H323 signaling protocol.
Syntax Description
This command has no arguments or keywords.
Example
The following example shows how to display the H323 parameters:
Elite Gateway>show h323
h323 display_name = 'Customer'
h323 h245_term_type = 60
h323 rtp_port_base = 30000
h323 out_fast_start = on
h323 in_fast_start = on
h323 auto_answer = on
Call is connected automatically.
h323 nat_call = off
dtmf duration = 300 ms
No IMTC IP Defined!
h323 gk_mode = off
Elite Gateway> | | show version
The show version command displays the version of various software components of the Elite Gateway.
Syntax Description
This command has no arguments or keywords. set h323 alias {add | del} {alias|all}
The set h323 endpoint_prefix command is used to create and delete aliases that are registered with the Gatekeeper.
Syntax Description
| add |
Create an alias alias. |
| del |
Delete a previously created alias alias. |
| alias |
Alias to be created or deleted. |
| all |
Delete all previously created aliases. This optional applies to del only. | set h323 allow_call_wo_gk {true|false}
The set h323 allow_call_wo_gk command is used to inform the H.323 stack to allow incoming calls from a remote Elite Gateway which is not registered with a gatekeeper.
Syntax Description
| true |
Allow calls from Elite Gateway that is not registered with a gatekeeper. |
| false |
Do not allow calls from Elite Gateway that is not registered with a gatekeeper. | Default
The Elite Gateway allows calls from Elite Gateways that are not registered with a gatekeeper. set h323 auto_answer {on|off}
The set h323 auto_answer command is used to enable or disable an early call setup connection. If disabled, the call is not set up until the user initiates the connection.
Syntax Description
| on |
Enable H323 early call setup connection. |
| off |
Disable H323 early call setup connection. | set h323 display_name display_name
The set h323 display_name command is used to set the display name information that is carried in the H.323 setup messages.
Syntax Description
| display_name |
The string to be is inserted into the Q.931 display information field and in the source Address field 2 of the H.323 setup-UUIE. | Example
The following example sets the h323 display name as "my gateway":
Elite Gateway> set h323 display_name my gateway set h323 dtmf_duration duration
When sending dtmf, by default, the gateway will use H323 Version II standard dtmf signal except other specified (ex: IMTC_dtmf). User may specify the duration of the dtmf tone.
Syntax Description
| duration |
Duration for the DTMF tone in milliseconds. | Default
The default setting is 300 milliseconds. set h323 endpoint_reg_type {gw | terminal}
The set h323 endpoint_reg_type command is used to set the H.323 registration type. This should not be confused with the H.245 terminal type, although the two parameters should be programmed consistently. This parameter specifies how the Elite Gateway will register itself with the gatekeeper, and has nothing to do with master/slave determination.
Syntax Description
| gw |
The Elite Gateway registers itself to gatekeeper as a H.323 Gateway. |
| terminal |
The Elite Gateway registers itself to gatekeeper as a H.323 Terminal. | Default
The Elite Gateway registers to gatekeeper as a H.323 Gateway. set h323 gk_addr ip_addr
The set h323 gk_addr command is used to specify the address of the gatekeeper when configured for manual mode.
Syntax Description
| ip_addr |
IP address of the H.323 gatekeeper. | set h323 gk_max_tries count
The set h323 allow_call_wo_gk command is used to control how many registration attempts will be made before the Elite Gateway considers itself to have failed registration. Once this number of unsuccessful attempts have been made, the Elite Gateway will only be able to place calls if allow_calls_wo_gk is true.
Syntax Description
| count |
Number of registration attempts. | Default
The default number of registration attempts is 2. set h323 gk_mode {off | manual | auto}
The H.323 protocol allows calls to be established through H.323 gatekeeper. The set h323 gk_mode command is used to specify if a call is established through a gatekeeper.
Syntax Description
| off |
Disables gatekeeper operation. |
| manual |
Enables gatekeeper in manual discovery mode. The gk_addr must be set appropriately. |
| auto |
Enables auto-discovery of the gatekeeper. | Default
The gatekeeper operation is disabled. set h323 h245_term_type terminal_type
The set h323 h245_term_type command is used to set the H.245 terminal type. The terminal type is used as part of the master/slave determination process of H.245.
Syntax Description
| terminal_type |
A numerical value designating the H245 terminal type. Typically, setting the H.245 terminal type to a value less than 50 will force slave operation, and a value greater than 200 will force master operation. | Example
The following example sets the h245 terminal type to 60:
Elite Gateway> set h323 h245_term_type 60 set h323 imtc_dtmf {add|del} ip_addr
There are two ways VoIP gateway handles DTMF relay, per H.323 and IMTC specifications. By default, the Elite Gateway conveys DTMF digits in H.323 format. The set h323 imtc_dtmf command is used to specify how DTMF digits are to be conveyed to a remote VoIP device.
Syntax Description
| add |
Elite Gateway sends DTMF digit to the remote VoIP device designated by IP address ip_addr in IMTC conforming format. |
| del |
Elite Gateway sends DTMF digit to the remote VoIP device designated by IP address ip_addr in H.323 format. |
| ip_addr |
IP address of the remote Elite Gateway. | Default
The Elite Gateway sends DTMF digits in H.323 format, unless the call is destined for a remote VoIP device whose IP address has been set h323 imtc_dtmf added. set h323 in_fast_start {on|off}
The set h323 in_fast_start command is used to select the H.323 Faststart mode on for calls initiated from remote Elite Gateways.
Syntax Description
| on |
Set H323 Faststart mode on. |
| off |
Set H323 Faststart mode off. | set h323 nat_call {on|off}
When the Elite Gateway is installed in a network that connects to WAN via a router with Network Address Translation (NAT) feature, the NAT might block calls. The set h323 nat_call command is used to enable the Elite Gateway to connect to remote Elite Gateways connecting to WAN via a NAT capable router.
Syntax Description
set h323 out_fast_start {on|off}
The set h323 out_fast_start command is used to select the H.323 Faststart mode on for calls making toward remote Elite Gateways.
Syntax Description
| on |
Set H323 Faststart mode on. |
| off |
Set H323 Faststart mode off. | set h323 rtp_port_base port_base
The set h323 rtp_port_base command is used to select the starting port number for assignment of RTP ports. When calls are made to remote Elite Gateways, an RTP port is opened for each call. The Elite Gateway uses the port_base as the RTP port number for the first call, the next call uses the next successive port, and so on.
Syntax Description
| port_base |
Set H323 Faststart mode on. | The starting port number for the assignment of RTP port. If rtp_port_base is assigned a value of 0, the assignment of the port number will be dynamic. The port number can be specified from 0 to 32767. Typically, numbers from 0 to 1023 are reserved on most systems. The recommended value is 30000.
Example
The following example sets RTP base port number to 30000:
Elite Gateway> set h323 rtp_port_Base 30000
This applies to:
| 
