TANDBERG GW Data port Command Interface User Guide
1. Introduction
The TANDBERG GW Data port Command Interface User Guide contains guidelines on how
to use the textual command interface supported by the GW. The Data port Command
Interface can be accessed through Telnet via the LAN interface or through RS-232 by
connecting a serial cable to the serial interface connector, referred to as the Data port (ref.
chapter
the RS-232 connection.
If, after reading this manual, you require additional information concerning the use of the
TANDBERG GW Data port Command Interface, please contact your local TANDBERG
dealer who will be able to supply you with relevant information for special applications.
2). Three Telnet sessions can be connected to the GW at the same time in addition to
3
TANDBERG GW Data port Command Interface User Guide
2. Connecting to the Data port Command Interface through the
RS-232 port.
The RS-232 port is a 9-pin, female, D-sub connector located on the front of the GW. The port
is configured as a DCE (Data Communications Equipment). The RS-232 port is default set to
115200 baud, 8 data bits, none parity and 1 stop bit from factory. The RS-232 port is also
referred to as the Data port.
2.1. Hardware and Cabling
The pin outs for the RS-232 are defined in the following table (the DTE, Data Terminal
Equipment, could be a PC or other device capable of serial communication).
Pin no Signal Description Direction
1 CD Carrier detect To DTE
2 RD Receive data To DTE
3 TD Transmit data From DTE
4 DTR Data terminal ready From DTE
5 Ground
6 DSR Data set ready To DTE
7 RTS Ready to send From DTE
8 CTS Clear to send To DTE
9 RI Ring indicator To DTE
NOTE! A straight through cable should be used between the TANDBERG GW’s RS-232 port
and the DTE.
The figure below illustrates the recommended cable-wiring scheme for connecting the GW to
a PC through RS-232.
TANDBERGGW PC
DCE, 9 pin DTE, 9 pin
1 CD 1 CD
2 RD 2 RD
3 TD 3 TD
4 DTR 4 DTR
5 GND 5 GND
6 DSR 6 DSR
7 RTS 7 RTS
8 CTS 8 CTS
9 RI 9 RI
DTR and RTS are ignored. DSR, CD, and CTS are always asserted, while RI is not used.
4
TANDBERG GW Data port Command Interface User Guide
2.2. Troubleshooting
If communication cannot be established between the PC/terminal and the TANDBERG GW’s
Data port the following should be checked:
• Verify that the serial cable is a straight through 9-pin to 9-pin cable
• Confirm that the configuration of the PC/terminal’s serial RS-232 port is identical to
the configuration of the TANDBERG GW RS-232 port.
•Verify that the PC/terminal’s serial RS-232 port is working properly by connecting it
back-to-back to another PC/terminal and send characters in both directions
1
.
1
It requires a null-modem cable to perform this test
5
TANDBERG GW Data port Command Interface User Guide
3. Connecting to the Data port Command Interface using Telnet
The TANDBERG 3GW has one LAN port.
The GW’s Telnet server provides access to the Data port Command Interface through a
10/100 base T network interface supporting the TCP/IP protocol.
When connected to the 3G Gateway, type tsh to start a t-shell from the command line. The
Telnet client will receive a welcome message similar to the following:
NOTE! If the TANDBERG 3GW is protected by an IP password you will be prompted to enter
this password before you can access the Data port Command Interface via Telnet.
6
TANDBERG GW Data port Command Interface User Guide
4. The TANDBERG 3G Gateway Commands
4.1. Introduction
Typing ‘?’ or ‘help’ when connected to the Data Port Command Interface will return a list of
valid commands. The commands are used to control the functions of the 3G Gateway. A
command may be followed by a set of parameters and sub-commands. This chapter gives a
description of all valid commands for the 3G Gateway.
4.1.1. Command format
Typing ‘?’ or ‘help’ after a command will result in a usage text (*h of help response) being
displayed. Usage text gives information about the command format, i.e. valid parameters,
sub-commands etc. An example is shown below (the user input is shown in bold).
Xconf Gateway Service 1 ServiceType ?
*h xConfiguration Gateway Service [1..100] ServiceType:
<None/DiD/IVR/Phonebook>
Numbers 1-100 and None/DiD/IVR/Phonebook are parameters of the configuration (Xconf)
command. Parameters
are arguments upon which the command will operate. Required
parameters are denoted by: < >, while optional parameters are denoted by: [ ]. All possible
values for given parameters are separated with slashes ( / ). For some parameters, only their
names are supplied within the brackets. In these cases specific parameter values need to be
substituted for the parameter names. Allowed parameter values, unless obvious, are provided
when the commands are discussed.
Sub-commands
are commands grouped together within a command. Different sub-commands
within a command may have different parameter sets. In the example below: Address and
Authentication are sub-commands to the command H323Gatekeeper. In the same sense
Mode, ID and Password are sub commands of H323Gatekeeper Authentication.
NOTE! The Data port Command Interface is not case sensitive.
4.1.2. Command types
The commands can be divided into two major classes:
• Parameter Configuration Commands, Xconf.
• Status Commands, Xstat.
7
TANDBERG GW Data port Command Interface User Guide
•User Commands, Xcom.
Parameter Configuration Commands
are commands that set a system parameter to a specific
value. E.g.: The command Xconf telnet mode: "on" enables telnet access on the gateway. If
the command is syntactically correct the GW returns OK, otherwise the GW returns
ERROR. When the parameter is successfully changed, the GW will return the command with
the new value. An example is shown below (the user input is shown in bold).
Xconf telnet mode: "on"
OK
*c xConfiguration Telnet Mode: On
When issuing a Parameter Setting Command without a parameter, the GW will return the
command with the current setting. E.g.:
Xconf telnet mode
*c xConfiguration Telnet Mode: On
OK
Status Commands
are commands that list different sets of system parameters. Status
commands are automatically called when corresponding parameters are being changed.
4.2. The commands
The commands are divided into five groups: System Configuration Commands, General GW
Commands, System Status Commands, Debug Commands and Special Commands.
8
TANDBERG GW Data port Command Interface User Guide
4.2.1. System Configuration Commands
Command: Description:
H323Gatekeeper
H323CallSetup
IP
Sets gatekeeper parameters.
NOTE! H.323 services must be set before the GW can be registered to a
gatekeeper.
H323Gatekeeper Address <IPAddr>
or
H323Gatekeeper Authentication Mode <Auto/off>
or
H323Gatekeeper Authentication ID: <S: 0, 50>
Or
H323Gatekeeper Authentication Password: <S: 0, 50>
---
sub-commands:
•Authentication Mode configures the use of authentication
against a gatekeeper.
•Authentication ID Configures the user name used within an
authentication challenge
•AuthenticationPassword sets the password used within the
Example of H323CallSetup feedback:
*c xConfiguration H323CallSetup Mode: Direct
Configures the LAN interfaces when static IP address allocation is used.
NOTE! The GW needs to reboot before the changes will take effect.
IP Assignment: <DHCP/Static>
or
IP Address <IPAddr>
or
IP Address Subnetmask <Subnetmask>
or
IP Address Gateway <IPAddr>
or
IP Address DNS Server [1..5] Address <IPAddr>
or
IP Address DNS Domain Name <S: 0, 64>
---
parameters:
9
TANDBERG GW Data port Command Interface User Guide
•DNS Server: Number identifying one of 5 DNS servers which
can be configured. If this parameter is omitted the command
applies to the first configuration (1).
sub-commands:
•Assignment: Selects between DHCP (Dynamic Host
Configuration Protocol) or static IP address allocation. When
DHCP is selected the GW will automatically receive all the
necessary information from the DHCP server. This function
should be used when the GW is connected to a LAN using
DHCP. When using this mode, IP-address and IP-subnet mask
are not used because the DHCP server supplies these parameters.
• Address: Sets the static IP address for the given LAN interface.
• Subnetmask: Sets the subnet mask variable. Subnet mask
defines the network class. If the setting is 255.255.255.0 the local
network will support up to 256 nodes, denoting a class C
network. If the setting is 255.255.0.0 the local network is a class
B network with 65536 addressable nodes.
•Gateway: Sets the gateway IP address. If a gateway is located on
the LAN and the GW needs to reach nodes through this gateway,
the gateway address can be set using the gateway variable (the IP
address of the gateway will be set automatically if the GW is in
DHCP mode)
•Domain Name: Sets the domain name string of which the
gateway is part of. Minimum 0, maximum 64 characters.
Example of IP Address feedback:
*c xConfiguration IP Address: "127.0.0.1"
Ethernet
Sets LAN port speed.
NOTE! The GW needs to reboot before the changes will apply.
Ethernet <speed>
---
parameters:
•speed: auto/10half/10full/100half/100full. The speed is either
set to auto or manually from 10mb half duplex to 100mb full
duplex. When set to auto the GW will automatically negotiate
with the network and use the best available setting.
Example of Ethernet feedback:
*c xConfiguration Ethernet Speed: Auto
ISDN
Defines various ISDN protocol settings.
ISDN IncomingBearerCapability: <UDI/All>
or
ISDN OutgoingBearerCapability: <H324m/UDI>
or
ISDN BRI SwitchType: <NI/ATT/Euro/Japan>
or
ISDN PRI SwitchType: <NI/ATT/Euro/Japan>
or
ISDN PRI Interface LowChannel: <1..31>
---
Parameters:
sub-commands:
10
TANDBERG GW Data port Command Interface User Guide
Within ISDN different bearer capabilities are used to signal the type of date
(Voice, Data, H320, H324M), which is used by switches and other
equipment to determine what to do with the data or the call (compand
neglect etc).
•IncomingBearerCapability: sets the ISDN bearer capability of
the incoming 3G calls. In some situations the non correct UDI
bearer is used in stead of the right H324M capability. This setting
makes it possible to accept incoming 3G calls both situations..
•OutgoingBearerCapability: sets the ISDN bearer capability for
the outgoing 3G calls. In some situations the switch does not
accept calls which use the correct H324M capability. This setting
makes it possible to use the gateway in these situations (UDI).
•BRI SwitchType: Sets the switch type of the gateway in case of a
BRI version.
• PRI SwitchType: Sets the switch type of the gateway in case of a
PRI version.
•PRI Interface LowChannel: This parameter sets the lowest
channel to start with when making outgoing call (to 3G handsets)
Example of ISDN feedback:
*c xConfiguration ISDN IncomingBearerCapability: All
*c xConfiguration ISDN OutgoingBearerCapability: UDI
*c xConfiguration ISDN BRI SwitchType: Euro
*c xConfiguration ISDN PRI SwitchType: Euro
*c xConfiguration ISDN PRI Interface LowChannel: 1
E1
E1 is the configuration of CRC4 for the ISDN PRI lines.
E1 Interface CRC4: <On/Off>
Example of E1 feedback:
*c xConfiguration E1 Interface CRC4: Off
HTTPS
Enables or disables access to HTTPS services.
NOTE! Changes become effective after reboot
HTTPS Mode <On/Off>
Example of HTTPS feedback:
*c xConfiguration HTTPS Mode: Off
HTTP
Enables or disables access to HTTP services.
NOTE! Changes become effective after reboot.
HTTP Mode <On/Off>
Example of HTTP feedback:
*c xConfiguration HTTP Mode: On
SNMP
Configures the SNMPmib.
Note! For more information about SNMP please read the TANDBERG
SNMP application note.
SNMP Mode < On/Off/ReadOnly/TrapsOnly >
or
SNMP CommunityName: <S: 0, 16>
or
SNMP SystemContact: <S: 0, 70>
or
11
TANDBERG GW Data port Command Interface User Guide
SNMP SystemLocation: <S: 0, 70>
or
SNMP HostIPAddr [1..3]: <IPAddr>
---
parameters:
• Mode: < On/Off/ReadOnly/TrapsOnly >
• Community Name: Text string of maximum 16 characters.
• System Contact: Text string of maximum 70 characters
• System Location: Text string of maximum 70 characters
• Host IP Addr: The IP addresses of max 3 SNMP trap hosts
sub-commands:
• Mode enables or sets the mode of SNMP support
• Community Name is used to authenticate SNMP requests.
SNMP requests must have this ‘password’ in order to receive a
response from the SNMP agent in the gateway.
•System Contact, Used to identify the system contact via SNMP
tools such as HPOpenView or TANDBERG Management Suite
•System Location Used to identify system location via SNMP
tools such as HPOpenView or TANDBERG Management Suite
•Host IP Addr identifies the IP-address of the SNMP manager.
Up to three different SNMP Trap Hosts can be defined. Your
LAN administrator should provide the correct values for these
fields
Example of SSH feedback:
*c xConfiguration SSH Mode: On
TELNET
Enables or disables telnet interface on the 3G GW
Telnet Mode: <On/Off>
---
Example of TELNET feedback:
*c xConfiguration Telnet Mode: On
SystemUnit
Sets the 3G GW name and password
SystemUnit Name: <S: 0, 50>
or
SystemUnit Password: <S: 0, 16>
---
Parameters:
• Name: Text string of maximum 50 characters
• Password: Text string of maximum 16 characters
12
TANDBERG GW Data port Command Interface User Guide
sub-commands
• Name, sets the name of the 3G Gateway
• Password, sets the password of the 3G gateway
Example of SystemUnit feedback:
*c xConfiguration SystemUnit Name: ""
13
TANDBERG GW Data port Command Interface User Guide
4.2.2. General GW Commands
Command: Description:
Gateway
This command is used to configure the 3G gateway dialling rules, like for
example direct inward dialling, H323 call prefixes and dial in numbers. It is
possible to define 100 services, each with the parameters:
• Description indicates the user applied name of the service
• InNetType indicates the dial in for this particular service
configuration.
•OutNetType indicates the dial out for this particular service
configuration
•InPrefix will be used for matching the incoming called
number/address and is used to register with the gatekeeper in case
call type is H323
•InPostfix is the part of the dialed number that will be
removed/replaced.
•ServiceType indicates whether this service is a direct inward dialing,
a phonebook or an IVR service is.
•OutPrefix and OutPostfix will be used to construct the
number/address that will be called (if applicable) using this service.
Service [1..100] Description: <S: 0, 30>
or
Service [1..100] InNetType: <H324m/3G/H323 >
or
Service [1..100] OutNetType: <H324m/3G/H323 >
or
Service [1.. 100] InPrefix: <S: 0, 30>
or
Service [1.. 100] InPostfix: <S: 0, 30>
or
Service [1.. 100] ServiceType: <None/DiD/IVR/Phonebook >
or
Service [1.. 100] OutPrefix: <S: 0, 30>
or
Service [1.. 100] OutPostfix: <S: 0, 30>
or
LoadLimit: <0..100>
---
Parameters:
sub-commands:
•Description: This is a friendly name for the service configured like
for example 3G to H323 and 3G hotline to H323
• InNetType.
• OutNetType
• InPrefix.
• InPostfix
• ServiceType
• OutPrefix
• OutPostfix
• LoadLimit The GW will signal busy to the gatekeeper when the
current load on the GW reaches this limit. The current system load
can be monitored by the status command SystemLoad
14
TANDBERG GW Data port Command Interface User Guide
Example of Gateway feedback:
*c xConfiguration Gateway Service 1 Description: ""
*c xConfiguration Gateway Service 1 ServiceType: DiD
*c xConfiguration Gateway Service 1 InNetType: H324m/3G
*c xConfiguration Gateway Service 1 InPrefix: 6789""
*c xConfiguration Gateway Service 1 InPostfix: ""
*c xConfiguration Gateway Service 1 OutNetType: H324m/3G
*c xConfiguration Gateway Service 1 OutPrefix: "5"
*c xConfiguration Gateway Service 1 OutPostfix: ""
*c xConfiguration Gateway LoadLimit: 100
When dialling the number 67890000 there will be a match with “0000” as the
significant number. The H.323 number to call is: 50000 (construction: prefix +
significant numbers + postfix). When dialling number 67894321 this will
match with “4321” as the significant number. The H.323 number to call is:
54321 (construction: prefix + significant numbers + postfix)
ExternalManager
This command sets the path and address of TMS server.
ExternalManager Path: <S: 0, 255>
or
ExternalManager Address: <IPAddr>
--
sub-commands:
• Path
• Address, the IP address of the manager
Example of ExternalManager feedback
*c xConfiguration ExternalManager Path:
"tms/public/external/management/SystemManagementService.asmx"
*c xConfiguration ExternalManager Address: ""
CorporateDirectory
This command sets the path and address of the Corporate Directory
(phonebook) server.
CorporateDirectory Address: <IP Addr>
or
CorporateDirectory Path: <S: 0, 255>
--
sub-commands:
• Path, the path of the HTTP request
• Address, the IP address of the manager
Example of Corporate Directory feedback
*c xConfiguration CorporateDirectory Path:
"tms/public/external/phonebook/PhoneBookService.asmx"
*c xConfiguration CorporateDirectory Address: ""
NTP
This command sets the address of the NTP server.
NTP Address: <IP Addr>
--
sub-commands:
•Address, the IP address of the server
Example of NTP feedback
*c xConfiguration NTP Address: "131.188.3.220"
Options
View and adapt option keys
15
TANDBERG GW Data port Command Interface User Guide
NOTE! The GW needs to reboot before the changes will take effect.
, which uniquely identifies a signaling
point, in this case the 3G Gateway, within a telephone network. This
number consists of three parts, i.e. a network, cluster and member
number, and will be provided by the network operator.
•NetworkIndicator:,A two bit data field within the Service
Information Octet of the Message Signal Unit that permits
discrimination between national and international messages.
•Law: audio standard: Either ALAW or ULAW. An a-law algorithm
is a standard companding, i.e. compressing and expanding, algorithm,
used in European digital communication systems to optimize, i.e.
modify, the dynamic range of an analog signal for digitizing. The µlaw algorithm is similar to a-law and used in North American and
Japanese systems.
• LinkSet Mode: Enable or disable linksets.
• LinkSet DPC: Uniquely identifies the destination signaling point of
the link. This can differ from the DPC of the trunk, e.g. the DPC of a
Signaling Transfer Point (STP), see example 2 below.
• LinkSet Link Mode: Enable a link in a link set.
• LinkSet Link Trunk: Number of the trunk (1 - 4) in which a time
slot is reserved for signaling.
•LinkSet Link Timeslot: Number of the time slot, within
aforementioned trunk, reserved for signaling.
•LinkSet Link SLC: A Signaling Link Code is a unique link number
provided by the network operator to identify a link.
• Trunk Mode: Enable or disable a trunk.
• Trunk DPC: Uniquely identifies the destination signaling point of
the trunk. It will be provided by the network operator.
•Trunk CircuitIdentificationCode: The Circuit Identification Code
is a unique identifier for a data time slot in a cable (trunk). In this
case the CIC acts as base address and can be defined for each SS7
trunk and sets the first time-slot number of the respective SS7 trunk.
•Route DPC: Unique identifier indicating the destination signaling
point of a trunk.
•Route Priority: Priority level of the route to the destination signaling
point. Fail-over signaling paths will be followed according to this
priority.
•Route LinkSet: Indicates the link to the destination signaling point
according to the above mentioned priority setting.
For more details on the sub-commands please read the chapter about SS7
17
TANDBERG GW Data port Command Interface User Guide
in the 3G Gateway User Manual.
Example of SS7 feedback:
*c xConfiguration SS7 OPC: 0
*c xConfiguration SS7 NetworkIndicator: National0
*c xConfiguration SS7 Law: ALaw
*c xConfiguration SS7 LinkSet 1 Mode: Off
*c xConfiguration SS7 LinkSet 1 DPC: 0
*c xConfiguration SS7 LinkSet 1 Link 1 Mode: Off
*c xConfiguration SS7 LinkSet 1 Link 1 Trunk: 0
*c xConfiguration SS7 LinkSet 1 Link 1 Timeslot: 0
*c xConfiguration SS7 LinkSet 1 Link 1 SLC: 0
*c xConfiguration SS7 LinkSet 1 Link 2 Mode: Off
*c xConfiguration SS7 LinkSet 1 Link 2 Trunk: 0
*c xConfiguration SS7 LinkSet 1 Link 2 Timeslot: 0
*c xConfiguration SS7 LinkSet 1 Link 2 SLC: 0
*c xConfiguration SS7 LinkSet 2 Mode: Off
*c xConfiguration SS7 LinkSet 2 DPC: 0
*c xConfiguration SS7 LinkSet 2 Link 1 Mode: Off
*c xConfiguration SS7 LinkSet 2 Link 1 Trunk: 0
*c xConfiguration SS7 LinkSet 2 Link 1 Timeslot: 0
*c xConfiguration SS7 LinkSet 2 Link 1 SLC: 0
*c xConfiguration SS7 LinkSet 2 Link 2 Mode: Off
*c xConfiguration SS7 LinkSet 2 Link 2 Trunk: 0
*c xConfiguration SS7 LinkSet 2 Link 2 Timeslot: 0
• ProductType, the name of the product, e.g. 3G Gateway
• Uptime, the time the system is running since the last reboot in seconds
• Software
o Version, the unique name of the software
o Name,
o ReleaseDate, the time and date of the build of this software
o Configuration
• Telephony, the amount of supported voice channels
• VideoTelephony, the amount of supported video
channels
•Hardware
o Version, software ID
o SerialNumber, software serial number
o MainBoard, the ID of the main board
o AdditionalBoard, indicates extra boards in the box
o Configuration:
• PRI, the amount of PRIs in the target system
• BRI, the amount of BRIs in the target system
• TemperatureCelcius, temperature of the main board in Celcius
• TemperatureFahrenheit, temperature of the main board in Fahrenheit
Displays the session legs within gateway calls. Every session can have a
maximum of three legs: calling and called party and the phonebook or IVR menu.
Call
Parameters:
•Status [1 .. 360], the status of the different session legs.
NTP
Returns the IP address of the NTP server.
Status format:
<Status>
<Address>
<Port>
<Last Update>
<Last Correction>
---
Parameters:
• Status, indicates whether the NTP server is active or not.
• Address, the IP address of the NTP server.
• Port, is default 123.
• LastUpdate, indicates the last update date and time.
• Last Correction, the time correction in seconds.
Example of NTP feedback:
*s NTP (status=Active):
Address: "131.188.3.220"
Port: 123
LastUpdate: "2006-04-10 15:21:14"
26
TANDBERG GW Data port Command Interface User Guide
LastCorrection: 1
*s/end
4.2.4. Debug Commands
Command: Desription:
Syslog
Enables a real-time log of Bonding, H.221 and H.323, H324m, ISDN, RTSP, IVider,
SIP and IVider Engine activity.
Note! Logging via the serial port is limited by the speed of the serial port, which
might result in loss of logging data. Therefore, it is advised to use Telnet instead.
Syslog <Level> <Mask>
Level [0..3]: no logging when level = 0
Mask: With this Mask the logging of different components can be turned on. The
mask has to be used as a bit mask.
For instance to view the logging of the H324m, SIP and IVider components, the mask
value equals 1 + 16 + 32 = 49
4.2.5. Special Commands
Command: Description:
Boot
DefaultValuesSet
FeedbackRegister
Reboots the system.
xCommand Boot
This command is used to restore factory default settings. Issuing this command
with no parameters will restore all settings except network settings and option
keys.
DefaultValuesSet Level: <1 .. 3>
Example (restore all default factory setting):
xCommand DefaultValuesSet
*r Result (status=OK): /
*r/end
OK
Command used to instruct the system to return XML feedback over HTTP(S)
to specific URLs. What parts of the Status and Configuration XML documents
to monitor are specified by XPath expressions. The system supports issuing
27
TANDBERG GW Data port Command Interface User Guide
feedback to 3 different URLs. The system allows a total of 20 XPath
expressions to be registered, with a maximum of 15 for a single URL.
Parameters:
•ID: <1 .. 3> ID for the registration. If this parameter is omitted the
system uses the first vacant ID.
• URL(r): <S: 0, 256> The URL to post feedback to.
The special command xfeedback lets the user register user defined
XPath expressions (with possible exposure options) to monitor changes
in the data. Whenever there is a change in one or more elements
addressed by a registered XPath expression, the part of the element
structure containing these changes will be returned. The system
supports a total of 20 registered expressions, with a total of 15
expressions for one session.
TANDBERG GW Data port Command Interface User Guide
or: xfeedback list
(note: deregistration with index=0 will deregister all registered expressions)
Examples:
"xfeedback register status/call" - to monitor call changes
"xfeedback register status/call--" - to monitor only call state changes
"xfeedback register configuration" - to monitor all configuration changes
Xhistory
The special command xhistory presents the status of the last 255 calls,
made to or from the3G Gateway, via a cyclic buffer mechanism.
NOTE! If the 3G Gateway is registered with a Video Portal, the call
history can only be shown on the respective Video Portal.