AudioCodes Mediant 800 MSBG Instruction Manual

CLI Reference Guide
For System and VoIP Functionalities
Version 6.4
January 2012
Document # LTRT-17940
Mediant™ 800 MSBG
Mediant™ 1000 MSBG
SIP Protocol

CLI Reference Guide Contents
Version 6.4 3 January 2012
Table of Contents
1Introduction....................................................................................................... 11
2Getting Started.................................................................................................. 13
2.1 Connecting to the CLI.......................................................................................... 13
2.1.1 RS-232....................................................................................................................13
2.1.2 SSH.........................................................................................................................13
2.1.3 Telnet ......................................................................................................................13
2.2 CLI Structure ....................................................................................................... 14
2.2.1 Authentication .........................................................................................................14
2.2.2 Understanding Configuration Modes ......................................................................14
2.2.2.1 Basic Command Mode ............................................................................14
2.2.2.2 Enable Command Mode..........................................................................14
2.2.2.3 Understanding Configurations.................................................................15
2.2.3 Using CLI Shortcuts................................................................................................16
2.2.4 Common CLI Functions ..........................................................................................17
2.2.5 Understanding CLI Error Messages........................................................................18
3General Commands.......................................................................................... 19
3.1 configure system.................................................................................................. 19
3.2 configure data...................................................................................................... 20
3.3 copy (auxiliary file)............................................................................................... 21
3.4 copy (configuration file)........................................................................................ 23
3.5 copy cli-script....................................................................................................... 24
3.6 copy firmware...................................................................................................... 25
3.7 Debug Commands............................................................................................... 26
3.7.1 debug log ................................................................................................................26
3.7.2 debug speedtest......................................................................................................27
3.7.3 debug capture data physical................................................................................... 29
3.8 dir ........................................................................................................................ 31
3.9 disable.................................................................................................................32
3.10 enable.................................................................................................................. 33
3.11 enable password.................................................................................................. 34
3.12 erase ................................................................................................................... 35
3.13 reload .................................................................................................................. 36
3.14 telnet....................................................................................................................37
3.15 username administrator....................................................................................... 38
3.16 write.....................................................................................................................39
3.17 write factory......................................................................................................... 40
4System Commands .......................................................................................... 41
4.1 NTP.....................................................................................................................41
4.2 cli-terminal........................................................................................................... 42
4.3 clock.................................................................................................................... 44
4.3.1 summer-time...........................................................................................................45
4.4 logging.................................................................................................................46
4.5 mgmt-access-list.................................................................................................. 47
4.6 radius................................................................................................................... 49
4.7 web......................................................................................................................50
4.8 snmp....................................................................................................................51

CLI Reference Guide 4 Document #: LTRT-17940
System and VoIP Functionalities
4.9 snmp trap.............................................................................................................52
4.10 snmp trap destination........................................................................................... 53
4.11 snmp v3-users..................................................................................................... 54
4.12 tls.........................................................................................................................55
5VoIP Commands............................................................................................... 57
5.1 interface............................................................................................................... 57
5.1.1 E1/T1, bri.................................................................................................................57
5.1.2 fxs-fxo......................................................................................................................59
5.1.4 enm .........................................................................................................................61
5.1.5 debug capture voip..................................................................................................63
5.2 Network Interface Configuration........................................................................... 65
5.2.1 interface network-if..................................................................................................65
5.2.2 interface vlan........................................................................................................... 67
5.2.3 application_type......................................................................................................68
5.2.4 ip address................................................................................................................69
5.2.5 ip gateway...............................................................................................................70
5.2.6 ip name-server........................................................................................................71
5.2.7 desc.........................................................................................................................72
5.2.8 show mode.............................................................................................................. 73
5.3 routing static........................................................................................................ 74
5.4 qos vlan-mapping ................................................................................................ 75
5.5 qos application mapping...................................................................................... 76
5.6 coders-and-profiles coders-group ........................................................................ 77
5.7 coders-and-profiles ip-profile................................................................................ 78
5.8 coders-and-profiles tel-profile............................................................................... 80
5.9 control-network.................................................................................................... 82
5.9.1 NATTranslation .......................................................................................................82
5.9.2 dns Dns2Ip..............................................................................................................83
5.9.3 dns Srv2Ip...............................................................................................................84
5.9.4 ip-group...................................................................................................................85
5.9.5 proxy-ip ...................................................................................................................86
5.9.6 proxy-set .................................................................................................................87
5.9.7 sip-interface............................................................................................................. 88
5.9.8 srd ...........................................................................................................................89
5.10 ip-media ip-media-settings................................................................................... 90
5.11 ldap...................................................................................................................... 91
5.12 SAS.....................................................................................................................92
5.12.1 stand-alone-survivability .........................................................................................92
5.13 sip-definition ........................................................................................................ 94
5.13.1 account.................................................................................................................... 94
5.13.2 account setting........................................................................................................95
5.13.3 advanced settings ................................................................................................... 96
5.13.4 general settings.......................................................................................................98
5.13.5 proxy and registration............................................................................................ 100
5.14 sbc..................................................................................................................... 102
5.14.1 allowed-coders-group............................................................................................ 102
5.14.2 general-setting ...................................................................................................... 103
5.14.3 manipulations ip-inbound-manipulation ................................................................104
5.14.4 manipulations ip-outbound-manipulation..............................................................105
5.15 routing ............................................................................................................... 106
5.15.1 classification.......................................................................................................... 106
5.15.2 condition-table.......................................................................................................107

CLI Reference Guide Contents
Version 6.4 5 January 2012
5.15.3 ip2ip-routing ..........................................................................................................108
5.15.4 sbc-alternative-routing-reasons ............................................................................109
5.16 gw...................................................................................................................... 110
5.16.1 advance-application..............................................................................................110
5.16.2 analoggw...............................................................................................................112
5.16.2.1 chargecode............................................................................................112
5.16.2.2 fxo-setting ..............................................................................................113
5.16.2.3 keypad-features..................................................................................... 114
5.16.2.4 metering-tones.......................................................................................115
5.16.3 digitalgw ................................................................................................................116
5.16.3.1 digital-gw-parameters............................................................................116
5.16.4 dtmf-and-suppl dtmf-and-dialing...........................................................................118
5.16.5 dtmf-and-suppl supplementary-services...............................................................119
5.16.6 hunt-or-trunk-group...............................................................................................121
5.16.7 hunt trunk-group-setting........................................................................................122
5.16.8 manipulations........................................................................................................123
5.16.8.1 CauseMapIsdn2Sip ...............................................................................123
5.16.8.2 CauseMapSip2Isdn ...............................................................................124
5.16.8.3 NumberMapIp2Tel.................................................................................125
5.16.8.4 NumberMapTel2Ip.................................................................................126
5.16.8.5 SourceNumberMapIp2Tel .....................................................................127
5.16.8.6 SourceNumberMapTel2Ip .....................................................................128
5.16.8.7 calling-name-map-ip2tel ........................................................................129
5.16.8.8 calling-name-map-tel2ip ........................................................................ 130
5.16.8.9 general-setting.......................................................................................131
5.16.8.10phone-context-table...............................................................................132
5.16.8.11redirect-number-map-ip2tel ................................................................... 133
5.16.8.12redirect-number-map-tel2ip ...................................................................134
5.17 Configuring Voice Settings................................................................................. 135
5.17.1 media voice-processing ........................................................................................135
5.18 Configuring Fax/Modem..................................................................................... 137
5.18.1 media fax-modem t38 ...........................................................................................137
5.18.2 media fax-modem V1501......................................................................................138
5.18.3 media fax-modem bypass.....................................................................................139
5.19 Configuring RTP/RTCP Settings........................................................................ 140
5.19.1 media RTP-RTCP.................................................................................................140
5.20 Configuring IPM-Detectors Settings................................................................... 141
5.20.1 media IPM-detectors.............................................................................................141
5.21 Configuring General Media Settings: ................................................................. 142
5.21.1 media general ....................................................................................................... 142
5.22 Configuring Media Realm Settings..................................................................... 143
5.22.1 media realm .......................................................................................................... 143
5.23 Configuring Media Security Settings.................................................................. 144
5.23.1 media security.......................................................................................................144
5.24 Configuring RTP Payload Types Settings.......................................................... 145
5.24.1 media RTP-payload-types ....................................................................................145
5.25 Configuring QoE Settings .................................................................................. 146
5.25.1 media QoE ............................................................................................................146
5.26 Configuring In-band Signaling Settings.............................................................. 147
5.26.1 media in-band-signaling........................................................................................147
6Show Commands ........................................................................................... 149
6.1 show system...................................................................................................... 149
6.1.1 show system version.............................................................................................149

CLI Reference Guide 6 Document #: LTRT-17940
System and VoIP Functionalities
6.1.2 show system power...............................................................................................150
6.1.3 show system active-alarms................................................................................... 151
6.1.4 show system alarms-history..................................................................................152
6.1.5 show system assembly.........................................................................................154
6.2 show voip interface............................................................................................ 155
6.2.1 E1/T1, BRI.............................................................................................................155
6.2.2 FXS/FXO...............................................................................................................157
6.2.3 enm .......................................................................................................................158

CLI Reference Guide Contents
Version 6.4 7 January 2012
List of Tables
Table 2-1: CLI Shortcuts........................................................................................................................16
Table 2-2: Common CLI Commands.....................................................................................................17
Table 2-3: CLI Error Messages..............................................................................................................18

CLI Reference Guide 8 Document #: LTRT-17940
System and VoIP Functionalities
Reader's Notes

CLI Reference Guide Notices
Version 6.4 9 January 2012
Notice
This document describes the System and VoIP Command Line Interface (CLI) commands. of
AudioCodes Mediant 800 MSBG and Mediant 1000 MSBG Voice-over-IP (VoIP) SIP media
gateways.
Information contained in this document is believed to be accurate and reliable at the time of
printing. However, due to ongoing product improvements and revisions, AudioCodes cannot
guarantee accuracy of printed material after the Date Published nor can it accept responsibility
for errors or omissions. Updates to this document and other documents can be viewed by
registered customers at http://www.audiocodes.com/downloads.
© Copyright 2012 AudioCodes Ltd. All rights reserved.
This document is subject to change without notice.
Date Published: January-15-2012
Trademarks
AudioCodes, AC, AudioCoded, Ardito, CTI2, CTI², CTI Squared, HD VoIP, HD VoIP
Sounds Better, InTouch, IPmedia, Mediant, MediaPack, NetCoder, Netrake, Nuera, Open
Solutions Network, OSN, Stretto, TrunkPack, VMAS, VoicePacketizer, VoIPerfect,
VoIPerfectHD, What’s Inside Matters, Your Gateway To VoIP and 3GX are trademarks or
registered trademarks of AudioCodes Limited. All other products or trademarks are property
of their respective owners. Product specifications are subject to change without notice.
WEEE EU Directive
Pursuant to the WEEE EU Directive, electronic and electrical waste must not be disposed
of with unsorted waste. Please contact your local recycling authority for disposal of this
product.
Customer Support
Customer technical support and service are generally provided by AudioCodes’
Distributors, Partners, and Resellers from whom the product was purchased. For technical
support for products purchased directly from AudioCodes, or for customers subscribed to
AudioCodes Customer Technical Support (ACTS), contact [e-mail].
Abbreviations and Terminology
Each abbreviation, unless widely used, is spelled out in full when first used.

CLI Reference Guide 10 Document #: LTRT-17940
System and VoIP Functionalities
Related Documentation
Manual Name
SIP CPE Release Notes
Product Reference Manual for SIP Gateways and Media Servers
Mediant 800 MSBG Installation Manual
Mediant 800 MSBG SIP User's Manual
Mediant 1000 MSBG SIP Installation Manual
Mediant 1000 MSBG SIP User's Manual
Note: Throughout this manual, unless otherwise specified, the term device refers to
the Mediant 800 MSBG and Mediant 1000 MSBG.

CLI Reference Guide 1. Introduction
Version 6.4 11 January 2012
1 Introduction
This document provides a reference for the device’s System and VoIP Command Line
Interface (CLI) commands. It describes the syntax and use of all the CLI commands.

CLI Reference Guide 12 Document #: LTRT-17940
System and VoIP Functionalities
Reader’s Notes

CLI Reference Guide 2. Getting Started
Version 6.4 13 January 2012
2 Getting Started
2.1 Connecting to the CLI
MSBG’s CLI can be accessed via RS232 interface, Telnet or SSH protocols via the
Ethernet interface.
2.1.1 RS-232
The MSBG can be accessed via RS-232 by connecting a VT100 terminal to the device or
using a terminal emulation program with a PC. Most Windows® computers come with a
program called HyperTerminal®, which is located under Programs > Accessories >
Communications.
Once you have connected via a VT100 terminal and started the HyperTerminal program,
set the program settings as follows:

115200 baud rate

8 data bits

No parity

1 stop bit

No flow control
If you are using HyperTerminal, name your new connection and then set up the new
connection via the resulting dialog box. The box allows you to determine the type of
connection you are using. Verify COM1 and select OK.
Another dialogue box appears for entering the COM1 properties. Enter the program settings
in this box; select APPLY and then OK. You should then be presented with a terminal
window in which you can interface with your device.
2.1.2 SSH
The MSBG can be accessed by SSH protocol using SSH client software.
One of the most popular and freeware SSH client software is Putty, which can be
downloaded from the following URL:
http://www.chiark.greenend.org.uk/~sgtatham/putty/download.html
By default the SSH access is disabled. Enable SSH access via CLI (configure system >
cli-terminal > set ssh on > activate), or set the ‘SSHServerEnable’ini parameter to ‘1’.
2.1.3 Telnet
The MSBG can be accessed by Telnet protocol using Telnet client software. Most
Windows® computers come with a program called ‘Telnet’, which can be activated via the
Windows command-line.

CLI Reference Guide 14 Document #: LTRT-17940
System and VoIP Functionalities
2.2 CLI Structure
2.2.1 Authentication
When the device is accessed, the user is prompted to enter the device administrator’s
Username and Password.
The device administrator’s credentials are common to all AudioCodes management
interfaces (e.g. Web).
The default username and password are ‘Admin’, ‘Admin’ respectively.
2.2.2 Understanding Configuration Modes
As you begin communication, you should understand the command modes. Each command
mode enables the user to access more commands and to make more changes in
thedevice’s configuration.
The CLI has two command modes:

Basic

Enable
The two command modes are organized in a two-tiered hierarchy with Basic at the bottom
and Enable at the top.
2.2.2.1 Basic Command Mode
Interaction with your device begins at the Basic Command Mode. The commands
supported by this command tier are limited, as is interaction with the device itself. The Basic
Mode is for users without access to the higher-tiered commands, to keep them from
changing the preferred configurations of the device.
The Basic Mode is accessed by beginning a CLI session (after successful authentication)
and it enables the user to display system information and activate several debugging
facilities.
The Basic Mode prompt is ‘>’.
2.2.2.2 Enable Command Mode
Enable Command Mode is the high-level tier in the command hierarchy, basically one step
up from the Basic Mode. A password (‘Admin’ by default) is required to access the Enable
Mode.
From the Enable Mode, you can access the configurations of your product as well as
handle how your device boots and runs, among other things.
The Enable Mode is accessed by entering 'enable'while in the Basic Command Mode.
The Enable Mode prompt is ‘#’.

CLI Reference Guide 2. Getting Started
Version 6.4 15 January 2012
2.2.2.3 Understanding Configurations
Configurations are the means by which you set up your device and system according to
your personal requirements and preferences.
All configurations are accessed through the Enable Command Mode. The configuration is
divided into the following main configuration-sets:

configure system

configure voip
By typing "configure"at the Enable Mode prompt, you are ready to specify the
configuration you want to access. Each configuration-set contains a different set of the
command.
The "configure system"set contains the general and system oriented configuration
command of the device - for example, Syslog configuration.
The "configure voip"set contains VoIP-oriented configuration commands - for
example SIP, VoIP network interfaces and VoIP Media configurations.
The configuration command sets are broken down into categories of similar functions. For
example, all commands dealing with configuring the Ethernet interface are grouped
together, as are configuration commands dealing with hardware, virtual network, and so on.

CLI Reference Guide 16 Document #: LTRT-17940
System and VoIP Functionalities
2.2.3 Using CLI Shortcuts
The MSBG CLI provides several shortcuts to help you configure your MSBG product more
easily. See the following table for descriptions.
Table 2-1: CLI Shortcuts
Shortcut Description
Up arrow key To re-display a previously entered command, use the Up arrow key.
Continuing to press the Up arrow key cycles through all commands
entered, starting with the most recent command.
<Tab> key Pressing the <Tab> key after entering a partial (but unique) command
completes the command, displays it on the command prompt line, and
waits for further input.
Pressing the <Tab> key after entering a partial and not unique command
displays all completing options.
? The MSBG CLI contains help to guide you through the configuration
process. Using the question mark, do one of the following:
Displays a list of all subcommands in the current mode. For example:
(config)# interface ?
BVI bridge interface
GigabitEthernet GigabitEthernet
vlan Vlan interface
Displays a list of available commands beginning with certain letter(s). For
example:
(config)# interface G?
GigabitEthernet GigabitEthernet
Obtains syntax help for a specific command by entering the command, a
space, and then a question mark (?). The MSBG CLI displays the range of
values and a brief description of the next parameter expected for that
particular command. For example:
(config)# interface vlan ?
[1-3999] Vlan ID
In case there is a command that can be invoked (all its arguments are
inserted), using the question mark at its end displays <cr>. For example:
(config)# logging host 10.1.1.1 ?
<cr>
<Ctrl + A> Jump to the beginning of the displayed command line. This shortcut is
helpful when using the no form of commands (when available).
<Ctrl + E>
Jump to the end of the displayed command line.
<Ctrl + U> Clears the current displayed command line.
auto finish
You need only enter enough letters to identify a command as unique. For
example, entering "int G 0/0"at the configuration prompt provides you
access to the configuration parameters for the specified Gigabit-Ethernet
interface. Entering "interface GigabitEthernet 0/0"would work as
well, but is not necessary.

CLI Reference Guide 2. Getting Started
Version 6.4 17 January 2012
2.2.4 Common CLI Functions
The following table contains descriptions of common CLI commands.
Table 2-2: Common CLI Commands
Command Description
do Provides a way to execute commands in other command sets without
taking the time to exit the current command set. The following example
shows the do command, used to view the GigabitEthernet interface
configuration while in the virtual-LAN interface command set:
(config)# interface vlan 1
(conf-if-VLAN 1)# do show interfaces GigabitEthernet
0/0
no Undoes an issued command or disables a feature. Enter no before the
command:
no debug log
activate
Activates a command. When you enter a configuration command in the CLI,
the command is not applied until you enter the activate and exit
commands.
Note: Offline configuration changes require a reset of the device. A reset
can be performed at the end of the configuration changes. A required reset
is indicated by an asterisk (*) before the command prompt.
exit Leaves the current command-set and returns one level up. If issued on the
top level, the session ends.
For online parameters, if the configuration was changed and no activate
command was entered, the exit command applies the activate command
automatically. If issued on the top level, the session will end:
(config)# exit
# exit
(session closed)
display Shows the configuration of current configuration set.
help Shows a short help how-to string.
history Shows a list of previously run commands.
list Shows the available command list of the current command-set.
| <filter> Applied to a command output. The filter should be typed after the
command with a pipe mark (|)
Supported filters:
include <word> – filter (print) lines which contain <word>
exclude <word> – filter lines which does not contain <word>
grep <options> - filter lines according to grep common Unix utility options
egrep <options> - filter lines according to egrep common Unix utility
options
begin <word> – filter (print) lines which begins with <word>
between <word1> <word2> – filter (print) lines which are placed between
<word1> and <word2>
count – show the output’s line count
Example:
# show version | grep Number
;Serial Number: 2239835
;Slot Number: 1

CLI Reference Guide 18 Document #: LTRT-17940
System and VoIP Functionalities
2.2.5 Understanding CLI Error Messages
The following table lists and defines some of the more common error messages given in the
CLI.
Table 2-3: CLI Error Messages
Message Helpful Hints
Invalid command The command may not be valid in the current command mode, or you may
not have entered enough correct characters for the command to be
recognized. Try using ‘?’ to determine your error.
Incomplete
command You may not have entered all of the pertinent information required to make the command valid. Try using ‘?’ to determine your error.
Notes:
•Optional arguments in commands are marked in square brackets [ ].
•To ensure that all failed CLI commands’ error/information messages are
displayed in the CLI console, you can redirect these messages, received
from the Syslog console, to the CLI console by running the debug log
command. This command can be disabled by running the no debug log
command.

CLI Reference Guide 3. General Commands
Version 6.4 19 January 2012
3 General Commands
3.1 configure system
The following describes the System configuration commands. To access these commands,
enter configure system at the Enabled mode prompt.
Syntax:
configure system
Defaults:
NA
Command Modes:
Enable
Examples::
The following switches to the system configuration command-set.
# configure system
(config-system)#

CLI Reference Guide 20 Document #: LTRT-17940
System and VoIP Functionalities
3.2 configure data
This command switches the user to the Data configuration command-set.
Syntax:
configure data
Defaults:
NA
Command Modes:
Enable
Examples::
The following command switches to the data configuration command-set
# configure data
(config-data)#