This equipment has been tested and found to comply with the limits for a Class A digital device, pursuant to Part 15 of FCC Rules. These limits are designed to provide reasonable protection against harmful interference when the equipment is operated in a commercial environment. This equipment generates, uses, and can radiate radio frequency energy and, if not installed in accordance with the instruction manual, may cause harmful interference to radio
communication. Operation of this equipment in a residential area is likely to cause harmful interference in which case the user will be required to correct the interference at the user’s own
expense.
Disclaimer
PLANET Technology does not warrant that the hardware will work properly in all environments
and applications, and makes no warranty and representation, either implied or expressed, with
respect to the quality, performance, merchantability, or fitness for a particular purpose.
PLANET has made every effort to ensure that this User’s Manual is accurate; PLANET disclaims liability for any inaccuracies or omissions that may have occurred.
Information in this User’s Manual is subject to change without notice and does not represent a
commitment on the part of PLANET. PLANET assumes no responsibility for any inaccuracies
that may be contained in this User’s Manual. PLANET makes no commitment to update or
keep current the information in this User’s Manual, and reserves the right to make improvements to this User’s Manual and/or to the products described in this User’s Manual, at any time
without notice. If you find information in this manual that is incorrect, misleading, or incomplete,
we would appreciate your comments and suggestions.
CE Declaration of conformity
This equipment complies with the requirements relating to electromagnetic compatibility, EN
55022 class A for ITE and EN 50082-1. This meets the essential protection requirements of the
European Council Directive 89/336/EEC on the approximation of the laws of the Member
States relating to electromagnetic compatibility.
Trademarks
All brand, company and product names are trademarks or registered trademarks of their respective companies.
This manual was designed for the technical and non-technical users of PLANET Internet telephony
gateway VIP-000/200/400/400FS/400FO. It contains information about the functions of VIP and instructions for its installation, basic configuration and operation in related chapters, and introduces
more advanced command line interface, firmware upgrade and appendix information. Read this
section carefully for important information about the manual’s organization.
Chapter 1: Overview
This chapter provides conceptual overview and description of VIP, explanation of how VIP interacts
with each for enabling VoIP services, and an overview of the required tasks
Chapter 2: Installing VIP
This chapter describes required steps to properly and safely install and configure VIP on your network
Chapter 3: VIP Concepts
This chapter gives information about VIP technology and describes basic concepts using VIP for
providing telephony services over IP network
Chapter 4: Configuring VIP from Web Browser
This chapter explains procedures for configuring VIP from a web browser
Chapter 5: Making a Call with VIP
This chapter explains how to make Internet calls from telephony devices connected to VIP directly
or indirectly.
Chapter 6: Troubleshooting Tips
This chapter provides troubleshooting information in case the user has problems installing or maintaining VIP.
Chapter 7: Command Line Interface
This chapter describes how to access the command line interface. It also contains information about
the commands used to configure VIP.
Chapter 8: Upgrading VIP
This chapter explains how to download new revision software and upgrade VIP.
Appendix A: Technical Specifications
This appendix lists VIP specifications and the assignment of pins of all the interface ports.
Appendix B: CLI Commands
This appendix provides a short description of each CLI command with a reference to the pages that
contain detailed information on the command.
Appendix C: Factory Default Settings
Preface
iii
VIP User’s Manual
This appendix lists factory settings of VIP.
Appendix D: Worksheets
This appendix provides some work sheets that you may use before configuring VIP.
Preface
iv
VIP User’s Manual
Important Safety Instructions
Before plugging VIP into an electrical outlet, carefully read all the installation instructions in Chapter
2.
For your own safety and the safety of your equipment, always take the following precautions:
• Follow instructions and warnings in the documentation.
• Never push any object through the fan vent or other openings in the equipment. Such
action may produce a short circuit, causing fire, electric shock, or equipment damage.
• Keep VIP away from all chemicals and sources of liquids.
Warning
• Connection of the RJ45 connector from a VIP to TNV circuits can cause permanent damage to
VIP.
• Incorrectly connecting telephony devices to the RJ11 port on the Telephony Interface
Module can cause permanent damage to the module.
Preface
v
VIP User’s Manual
Documentation Abbreviations
Throughout this guide, the user will come across a number of abbreviations that are common
throughout the industry. The user should be familiar with the following abbreviations:
ATPM
CLI
DSP
DTMF
E&M
FXO
FXS
H.323
ICMP
IMTC
IP
ITG
KTS
LAN
NVS
Address Translation and Parsing Manager
Command Line Interface
Digital Signal Processor
Dual Tone Multi-Frequency
Ear & Mouth
Foreign Exchange Office
Foreign Exchange Subscriber
ITU specification for multimedia transmission over IP net-
works
Internet Control Message Protocol
International Multimedia Telecommunications Consortium
Internet Protocol
Internet Telephony Gateway
Key Telephone System
Local Area Network
Non-Volatile Storage
LED
PBX
PSTN
RTP
TCID
TFTP
TIM
TNV
UDP
UTP
VAD
WAN
Preface
vi
Light Emitting Diode
Private Branch Exchange
Public Switched Telephone Network
Real-Time Transport
Telephony Channel Identifier
Trivial File Transfer Protocol
Telephony Interface Modules
Telephone Network Voltage
User Datagram Protocol
Unshielded Twisted Pair
Voice Activity Detection
Wide Area Network
VIP User’s Manual
Notation Conventions
Throughout this guide, different type styles and characters are used. These serve a variety of purposes as described below:
Convention Description
boldface Commands and keywords are in boldface.
italic Arguments for which you supply values are in italics.
courier Messages that VIP CLI displays are in plain courier font.
[ ] Elements in square brackets are optional.
{ x | y | z } Alternative but required elements are grouped in braces ({ }) and sepa-
rated by vertical bars ( | ).
[ x | y | z ] Optional alternative keywords are grouped in brackets ([ ]) and separated
by vertical bars ( | ).
string A nonquoted set of characters. Do not use quotation marks around the
string or the string will include the quotation marks.
2.3Installing the telephony interface module (VIP-000 only) 7
2.4Connecting to the telephony devices 7
2.5Connecting to the Network 8
2.6Providing Power to VIP 8
2.7Assigning IP address to VIP 8
Chapter 3VIP Concepts 9
3.1How VIP Operates 9
3.2ATPM 9
3.3Destination 9
3.4Hunt Group 10
3.5Dial Plan 10
Address Table 10
Hunt Group Table 11
Destination Table 11
3.6DTMF Relay 11
3.7Voice Codecs 11
Chapter 4Configuring VIP from a Web Browser 13
4.1Http setting mode 13
4.1.1 Dial Plan/ Dial Settings 15
4.1.1.1 Phone number 16
4.1.1.2 Hunt Group 18
Preface
viii
VIP User’s Manual
4.1.2 Clear DialPlan 22
4.1.3 Restore DialPlan 22
4.1.4 Save to NVRAM 23
4.2 View System Configurations 23
4.2.1 Firmware Version Information 24
4.2.2 H323 Parameters 24
4.2.3 Voice Coder Type 25
4.2.4 Voice Coder Information 25
4.2.5 Channel Parameters 26
4.2.6 Network Connection 27
4.2.6.1 DHCP Settings 27
4.2.6.2 PPPoE Settings 28
4.2.6.3 DDNS Settings 30
4.3 Configure System Settings 31
4.3.1 IP Settings 33
4.3.2 H323 Parameters 33
4.3.2.1 H323 General Parameter Settings 33
4.3.2.2 H323 Gatekeeper Settings 35
4.3.2.2 H323 Aliases Settings 36
Chapter 5Making a Call with VIP 37
5.1Making a call with VIP FXS Module 37
5.2Making a call with VIP FXO Module 37
5.3Making a call with VIP Application Sample 38
Making a call between gateway A and Gateway B 40
Case 2: Gateway Phone to PSTN Phone, 40
Case 3: PSTN Phone to Gateway Phone, 41
5.4Building up voice communication via VIP in Dynamic IP environment 41
Scenario I - VIP with built-in PPPoE, DHCP, and DDNS clients: 42
Scenario II: VIP co works with (NAT) router which has built-in DDNS client: 44
5.5PLAR (hotline) connection sample 49
FXO to FXS PLAR connection: 49
FXO to FXO PLAR connection: 50
7.8Network Commands 57
net reset 57
net set gateway ip_addr 57
net set http {on|off} 57
net set telnet {on|off} 57
net set ip ip_addr 57
net set ip_preced ip_preced 58
net set mask ip_mask 58
net set speed {10|100|auto} 58
net set user_pw password password 59
net show 59
net show hwstat 59
net set pppoe 60
net set dhcp 60
net set dyndns 60
7.9Configuration Management Commands 61
config {activate|store|erase} 62
show h323 62
show version 63
set h323 alias {add | del} {alias|all} 63
set h323 allow_call_wo_gk {true|false} 64
set h323 auto_answer {on|off} 64
set h323 call_name 64
set h323 cisco_t38 64
set h323 display_name display_name 65
set h323 dtmf_duration duration 65
set h323 endpoint_reg_type {gw | terminal} 65
set h323 endpoint_prefix 66
set h323 gk_addr ip_addr 66
set h323 gk_max_tries count 66
set h323 gk_mode {off | manual | auto} 66
set h323 h245_term_type terminal_type 67
Preface
x
VIP User’s Manual
set h323 h245_tunneling 67
set h323 imtc_dtmf {add|del} ip_addr 67
set h323 in_fast_start {on|off} 67
set h323 master_delay 68
set h323 nat_call {on|off} 68
set h323 out_fast_start {on|off} 68
7.12Tel Commands 81
tel show pcm_gain_level 81
tel show port [port#] 81
tel show ring_freq 81
tel set pcm_gain_level {1|2|3|4|5} 82
tel set ring_freq {1|2|3|4} 82
7.13E & M Signaling Commands 83
E&M Common Signaling Configuration Commands 83
set port port em clear_conf_detect 83
set port port em clear_conf_wait_max 83
set port port em clear_detect 83
set port port em connected_min 84
set port port em dial_tone 84
set port port em disable_hangup 84
set port port em guard_all 84
set port port em guard_out 85
set port port em offhook_db 85
set port port em onhook_db 85
set port port em size_detect 86
set port port emd in_delay_max 87
set port port emd in_delay_min 87
set port port emd in_digit_ign 87
set port port emd out_delay_check 88
set port port emd out_delay_dur_max 88
set port port emd out_delay_dur_min 88
set port port emd out_intg_check 88
set port port emw in_wink_digit_ignore 89
set port port emw in_wink_dur 89
set port port emw in_wink_wait_max 89
set port port emw in_wink_wait_min 90
set port port emw out_wink_dur_max 90
set port port emw out_wink_dur_min 90
set port port emw out_wink_wait_max 90
7.14Obsoleted Commands 91
Preface
xii
VIP User’s Manual
Chapter 8Upgrading and resetting VIP 92
8.1Firmware upgrade 92
TFTP server configuration 93
Trouble Shooting Tips 95
8.2CLI Commands in Download Mode 96
help 96
quit 96
set ip ip_addr 96
set gateway ip_addr 96
set mask ip_mask 97
start 97
This chapter illustrates an overview of PLANET Internet Telephony Gateway Family – VIP-000/
200/ 400/ 400FS/ 400FO and a detailed product description of features and capabilities.
1.1 Features
Via growth of Internet technology, Internet telephony service plays and turns into a cost-effective
and highly reliable substitution system of the old-time traditional PBX system. PLANET VoIP (Voice
over IP) system – VIP-000/ 200/ 400/ 400FS/ 400FO offer toll quality voice and real-time fax data
over IP networks. With optimized H323 architecture, PLANET VIP series are ideal solution for
various VoIP applications such as Headquarter and Branch Office communication, and IDD costeffective solution. With its intuitive user-friendly interface, PLANET VIP series may be installed
easily conveniently, and dramatically down cost the huge amount of IDD fee.
With embedded, efficient Real-Time Operating System, VIP series provides efficiency and feature
enhancement capabilities; being programmed with updated firmware users may have the most
flexibility and functionality to meet different kind of application requirement. It comes equipped with
remote management capabilities, configurable signaling to work with PBX, KTS, and/or telephone.
Building on state-of-the-art advanced VoIP related technology. PLANET VVIP series offers various
features: echo cancellation, Voice Activity Detection (VAD) , Comfort Noise Generation (CNG) , lost
packet recovery algorithms and optimized voice and FAX coders to bring users superior voice quality, and best compatibility with major Internet telephony service providers.
1.2 Networking Protocols
VIP supports several industry-standard networking protocols required for voice communication. The
following table describes these protocols.
Networking Protocol Description
Internet Protocol (IP) IP is a messaging protocol that addresses and sends packets across the
network. To enable IP protocol, VIP must have a static IP address, sub
and gateway assigned to it.
VoIP enables VIP to transfer voice communications over an IP network.
(VoIP)
Trivial File Transfer
Protocol (TFTP)
Real-Time Transport
(RTP)
Overview 1
VIP employs ITU-T H.323 protocol for setting up call with one another.
TFTP allows you to transfer files over the network. VIP implements a
TFTP client allowing you to download new revision firmware from a TFTP
server. The TFTP client requires a TFTP server in your network.
RTP is a standard for transporting real-time data over IP network. VIP
uses RTP protocol to send digitized and compressed voice packets.
VIP User’s Manual
1.3 Package Contents
The contents of your product should contain the following items:
l Internet Telephony Gateway 19” rack mountable version
l 90-240V AC power cord (VIP-000), AC-DC power adapter (VIP-200/400/400FS/400FO)
l 9-pin straight through RS-232 cable
l Rack mount brackets (2) and screws (4) (VIP-000 only)
l Quick Installation Guide
l User’s Manual CD
1.4 Front Panel
The front panel of VIP contains a RJ-45 Ethernet port, one DB9 RS-232 interface port, a push button and 16 LED indicators. The following figure illustrates the front panel of VIP.
Figure 1-1 VIP-000 Front Panel
Figure 1-2 VIP-200 Front Panel
Figure 1-3 VIP-400 Front Panel
Figure 1-4 VIP-400FS Front Panel
Overview
2
VIP User’s Manual
200:
Figure 1-5 VIP-400FO Front Panel
LED Indicators
The LED indicators on the front panel display the current status of VIP as described in the following
table:
Indicator Color Activity Indication
PWR Green On Power is supplied to the gateway.
SYSTEM Green Blinking The system is running. (Heartbeat LED)
LAN
Ÿ ACT
Ÿ 100M
Ÿ LNK
Ÿ COL
Slot A
Slot B
Slot A/ Slot B
Slot A/B
Channels
1-4 (For VIP-
2 channels)
Green
Green
Green
Green
Green
Green
On
On
Off
On
On
On
On
Blinking
Green Off
On
Blinking
Data is presented on LAN.
The gateway is connected to LAN at 100Mb/s.
The gateway is connected to LAN at 10Mb/s.
The gateway is connected to LAN.
Data collision is occurring on the network connection.
A slide-in module is plugged into slot A.
A slide-in module is plugged into slot B.
The system is updating the firmware.
The line is idle.
The line is being used.
The line is ringing.
Ports
VIP is equipped with an Ethernet interface with 10/100 Mbps auto-negotiation capability. The
Ethernet interface port is located on the front panel. In addition to the Ethernet interface port, there
is a 9-pin RS-232 interface port on the front panel. Their functions are described below:
Port Label Function
RJ45 LAN Connecting VIP to a 10/100 Mbps Ethernet network
9-pin RS-232 User Console Connecting VIP to a VT-100 terminal or terminal emulator for con-
figuring VIP
Overview
3
VIP User’s Manual
1 2 2 1
Reset Button
There is a push button located behind a small hole next to the SYSTEM LED. This button allows
you to reset VIP or force VIP to enter firmware upgrade mode.
Reset
Push a small, stiff object into the hole until the SYSTEM LED stops blinking, then release the button.
Force firmware download mode:
Powering on the gateway while pressing down the button for 5 seconds forces VIP to enter
download mode
1.5 Rear Panel
The rear panel of VIP-000 has two slots allowing the installation of up to two Telephony-InterfaceModules (TIM) . Each module is equipped with 4 telephony interface ports. Depending on the type
of the telephony interface module, the telephony interface ports may be connected to telephony devices, such as PBX, KTS, and telephone sets of central office. VIP-200 equips two FXS ports for
and VIP-400 equips with two FXO and two FXS ports. In addition to the TIM slots (ports), there is
an AC power receptacle and a power switch (power adapter: VIP-200/400) on the rear panel.
Slot ASlot B
90~240V
SLOT A
ELITE-FXO
SLOT B
ELITE-FXS
50~60
4 3
Figure 1-4 VIP-000 Rear Panel
Figure 1-5 VIP-200 Rear Panel
Figure 1-6 VIP-400 Rear Panel
Figure 1-7 VIP-400FS Rear Panel
Overview
4
VIP User’s Manual
Figure 1-8 VIP-400FO Rear Panel
Overview
5
VIP User’s Guide
Chapter 2 Installing VIP
This chapter gives information on how to install VIP.
2.1 Network Requirements
For VIP successfully operate in your network, your network must meet the following requirements:
1. A working 10/100 Base-T Ethernet. VIP connects to Internet via an Ethernet LAN.
2. IP network that supports gateway, and subnet mask. You’ll need a static IP address to assign
VIP.
2.2 Installing VIP
VIP can be used in a desktop configuration or mounted in a standard 19-inch rack enclosure (VIP000 only). Ensure that VIP is placed in a clean, well-ventilated, and vibration-free environment.
When VIP is placed on a desktop, be certain that the unit is placed on a sturdy, flat surface, near a
grounded power outlet. At least three inches of clearance must be provided on both sides of VIP
for well ventilation.
2.3 Installing the telephony interface module (VIP-000 only)
VIP allows the installation of up to two TIMs. The following steps illustrate how to install a TIM:
1. Unfasten the two screws holding the cover of the TIM slot A on the rear panel.
2. Remove the cover.
4. Before proceeding further, wear a grounded wrist strap.
5. Remove the TIM from its static-free bag. Holding the module such that the metal
bracket is facing toward you.
6. Carefully align the edge of the module facing away from you with the slide-in guide in-
side VIP, and insert the module into the slide-in slot until it is fully sited.
7. Fasten the screws on the module.
8. Repeat step 1 through 6 for slot B if you have two TIMs. If you have only a single TIM,
be certain to install it in slot A, otherwise, VIP won’t function.
2.4 Connecting to the telephony devices
VIP-000 supports three types of TIM. One is FXO, FXS and the other is E&M. Each module has
four ports for connecting to telephony devices. VIP-200 equips two FXS interface for connecting to
regular analog telephone sets or FAX machine. VIP-400 equips two FXO and two FXS interfaces to
have the great flexibility of PBX connection (FXO), and telephone or FAX machine connection
Installing VIP 7
VIP User’s Manual
(FXS). VIP-400FS equips four FXS interfaces telephone set or FAX machine connections (FXS).
VIP-400FO equips four FXO interfaces to have the great flexibility of PBX connection (FXO)
VIP-FXO module is designed for connecting to PBXs (extension line) or central office switches (CO
line).
VIP-FXS module is designed for connecting to analog telephone sets or G3 fax machines. Connecting the telephony devices to the appropriate RJ11 ports on the TIM.
VIP-E&M module is designed for connecting to equipment (such as PBX or channel bank) providing
the tie-line connection, type V, 4-wire. Connecting the tie-line port to the appropriate RJ45 port on
the TIM.
Warning: connection of incorrect telephony devices to the ports on the TIM can cause permanent
damage to the TIM and/or VIP.
2.5 Connecting to the Network
The RJ45 network port on the front panel supports 10/100 Mbps half-duplex connection to Ethernet
Network. You can use either category 3 or 5 straight-through UTP cable for 10 Mbps connections,
but use Category 5 for 100 Mbps connections. To connect to Ethernet, insert one end of the
Ethernet cable to the RJ45 port on the front panel of VIP and other end of the cable to an Ethernet
switching hub or repeater hub.
2.6 Providing Power to VIP
To provide AC power to VIP complete the following steps:
1. Turn the power switch on the rear panel of VIP to the off position.
2. Connect one end of the power cord that came with VIP to the power receptacle on the rear
panel.
3. Connect the other end of the power cord to an AC power outlet.
4. Turn the power switch on. VIP will perform power on self-test. After completing the self-test,
the SYSTEM LED blinks continuously and the TIM indicators on the front panel will turn on.
2.7 Assigning IP address to VIP
The IP address is the unique logical address identifying each IP node, such as VIP, on an IP network. An IP address is a 32-bit number expressed as four decimal numbers from 0 to 255 separated by periods. VIP needs a static IP address and be aware of the subnet mask and default
gateway (typically a router) of your network to be able to send to and receive data from the IP network. Consult your network manager to obtain a unique and static IP address for VIP, the IP subnet
mask and default gateway of your network, and fill out the work sheet in Appendix D before configuring the gateway. Procedures for assigning IP address, default gateway and subnet mask is available in Chapter 4.
Installing VIP
8
VIP User’s Manual
Chapter 3 VIP Concepts
VIP enables the transmission of voice and fax traffic over any IP network by digitizing voice and fax
signals, encapsulating the information within IP packets, and then sending the packets across the
IP network
3.1 How VIP Operates
1. The TIM inside VIP digitizes analog voice signals at 8 Kbps.
2. VIP system software handles the:
Ÿ Capture of telephone number presented as DTMF tones.
Ÿ Mapping the telephone number to the IP address of remote VIP.
Ÿ Setting up calls with remote VIPs utilizing H.323 call control protocol.
Ÿ Digitizing, compressing and encapsulating the voice into IP packets and transmission of the
IP packets onto the Ethernet LAN.
3. A router attached to the LAN forwards the IP packets across the WAN, where they will be received by another VIP at the remote.
4. The process is reversed at the remote VIP.
3.2 ATPM
To allow you to easily dial a telephone or fax on the network, VIP maps a series of dialed digits to
the IP address of the remote VIP whose phone or fax you are calling. This mapping information is
contained in a database inside each VIP called the dial plan.
Based on the dial plan the Address Translation and Parsing Manager (ATPM) inside VIP translates
telephony numbers to IP addresses of remote VIPs. The ATPM collects telephone number dialed
by users, decides whether the dial string is part of the dial plan and, if it is, maps it a remote VIP.
When the call is set up to the destination, a substring of the original dial string will be sent along to
the remote VIP.
3.3 Destination
The destination is where a call is terminated. Typically, for inbound calls from IP network, VIP terminals the call at one of the telephony ports. The destination for the call is the telephony port where
the call terminated. For calls initiated from telephony ports, VIP forward the call to a remote VIP via
IP network, and the remote VIP terminal the call. The destination of the call is the remote VIP.
VIP Concepts 9
VIP User’s Manual
3.4 Hunt Group
Instead of directly mapping a phone number to a destination, the ATPM first maps the phone number to a group of destinations known as a Hunt Group. A hunt group is a group of destinations that
are equivalent. For example, the customer support group of a company might have 20 peo-
ple who can handle support calls. Access to customer support is through a single phone
number but the next available support person is actually connected upon each incoming
call. These 20 phones would be configured as a hunt group. A hunt group consists of a
phone number and a list of destinations (members of the group). When an incoming phone
number matches the phone number of the hunt group, VIP attempts to terminate the call at each of
the destinations in the hunt group, one at a time until a call is successfully completed.
Every destination that can be reached by dialing a phone number is a member of at least one hunt
group. When an address is presented to ATPM for lookup, the output is a hunt group ID number.
As a second step, the hunt group ID is presented to ATPM to get the list of members. To effectively
bypass the hunt group feature, simply make a unique hunt group for each destination and one
member in each hunt group.
3.5 Dial Plan
The dial plan is a database inside VIP for the ATPM to map telephony numbers users dialed to the
IP address of remote VIPs. The dial plan consists of the destination table, hunt group table and the
address table. Users need to setup these tables, so that VIP knows how to setup calls with remote
VIPs.
Address Table
The address table maps a phone number to a hunt group. The table contains entries that specify
the following information:
• Telephone number
• The hunt group the phone number maps to.
• The minimum number of digits to collect before the ATPM starting address lookup.
• The maximum number of digits the ATPM collects before it considers the dial string is
complete.
• Number of digits forward to the destination.
Address table sample:
The destination table maps a destination to a telephony port or the IP address of a remote VIP.
Destination table sample
Dest id Mode Destination
------------------------------------------------------ 1 Local PORT = 0
3 Local PORT = 2
5 Local PORT = 4
11 H.323 Dest = 192.168.0.55/1720 TCP
12 DNS Dest = planetvip.dyndns.org /1720 TCP
3.6 DTMF Relay
Voice from PSTN is compressed by VIP before sending across the IP network and then decompressed by the destination VIP. The voice coders supported by VIP are designed for ideally compressing and decompressing human voice. If the compression / decompression process is performed on DTMF tone which needs to be conveyed across IP network, distortion might be too significant to be not cognizable in the receiving end. To overcome the shortcoming that the voice coders cannot perfectly encode DTMF tone, VIP encodes DTMF tone into special packets. The packets are then sent to the destination VIP via a separate IP connection. The destination VIP decodes
the packets, generates the DTMF tone, and then sends the tone to the PSTN. The way VIP handles DTMF tone is so called DTMF relay.
VIP handles DTMF relay per H.323 specifications. Certain third party VoIP devices may handle
DTMF relay per IMTC standard. For VIP to interoperate with those VoIP devices, users need to
specify which remote VoIP devices uses IMTC conforming DTMF relay technique. Refer to CLI
command set h323 imtc_dtmf {add|del} ip_addr for detailed information on how to select DTMF relay mode.
3.7 Voice Codecs
Voice codecs supported by VIP include G.711, G.723.1 5.3kbps, G.723.1 6.3kbps and G.729 AB.
When setting up a call, two VIP automatically negotiate with each other until an agreed upon codec
is determined.
VIP Concepts
11
VIP User’s Manual
Chapter 4 Configuring VIP from a Web Browser
This chapter explains procedures for configuring VIP from the web browser.
4.1 Http setting mode
This section describes the processes for setting up Internet Telephony Gateway once it has been installed. Microsoft Explorer version 4 or higher, or Navigator version 4.5 or higher can be used in this
section to view and change parameters.
PC Setup
In order to configure VIP, PC needs to have TCP/IP protocol and a compatible IP Address.
1. Connect VIP to network with a RJ-45 UTP cable. Power it on.
2. Find a PC, for example, Windows 2000. Under Windows 2000, select the Network Neighborhood
icon on the desktop, then select Properties. We will see a screen like below:
3. If a line like the one highlighted ("TCP/IP -> Network Card”) is not listed , select Add-Protocol-
Microsoft-TCP/IP-OK to add it.
4. Select Properties for the “TCP / IP -> Network card” entry. You will see a screen like the following:
5. On the IP Address table, enter values as follows:
Configuring VIP from a Web Browser 13
VIP User’s Manual
• Specify an IP address set ON.
• IP Address: 192.168.0.2
• Subnet Mask: 255.255.255.0
Restart your PC and Start your WEB browser.
6. In the Address box, enter the following:
http://192.168.0.1 (Default IP address in VIP-000/200/400/400FS/400FO.)
7. Press enter to confirm and you should find the screen below.
8. The User Name is administrator (all lower case). Password is 123. Both administrator and 123
are default strings from factory). For security reasons, please change and memorize the new password after this first setup.
9. Click “OK”. The main screen will appear as below.
Configuring VIP from a Web Browser
14
VIP User’s Manual
which allows one to
4.1.1 Dial Plan/ Dial Settings
Main Menu Function Briefings
1.Dial Plan Settings, which helps you configure the dial plan. You should complete the dial plan work
sheets before working on this menu.
2.View System Configurations, which includes the specific information related to version, network,
H.323, coder, and the channel of the gateway you are using.
3.Configure System Settings, which allows you to modify the system parameters as you wish.
Select Main Menu\Dial Plan Settings, we can find the following Dial Plan Menu.
Dial Settings
Common Dial
Parameters
Clear Dial Plan
Restore Dial
Plan
Store to
NVRAM
The Setup screen of the Dial Plan including:
• Telephone Settings, which allows one to
Add, Delete, Find, or List telephone numbers.
• Hunt Group Settings,
Add, Delete, Find, or List hunt group settings
• Destination Settings, which allows one to
Add, Delete, Find, or List destination settings
Defines the desired total dial time, first digit wait
time, inter-digit wait time, and the termination digit
Clears all telephone numbers, hunt groups, and
destinations settings, for both old and new ones
Retrieves all dial plan settings from the flash while
temporary settings will be cleared
Stores all settings that you have specified permanently
Configuring VIP from a Web Browser
15
VIP User’s Manual
fore the ATPM starting matching the dial string
4.1.1.1 Phone number
Please select Main Menu\Dial Plan\Phone/Hunt Group/Destination Settings, we can find
Phone/Hunt Group/Dest. Setting Menu. We are doing VIP telephone address table manage-
ment.
We can add (delete, find or list) desired telephone number mapping to hunt group at this menu.
Telephone
Number
Hunt
Group ID
Min. Digits
Max. Digits
Strip
Length
Append
Prefix
Telephone number to match. This is only part
of the total dialed string.
For each hunt group ID, you need to assign it
a unique identifier between 0 and 99.
Minimum number of digits to be collected bewith entries in the address table.
Maximum number of digits to be collected before the ATPM starting matching the dialed
string with entries in the address table.
The number of digits to be stripped at the beginning of the collected dial string before forwarding the string to the destination.
(Optional) Digit to be added before the beginning of the collected dial string before forwarding it to the destination.
To list the phone numbers, click on “List” and select “Telephone”, the screen will displayed as below:
Configuring VIP from a Web Browser
16
VIP User’s Manual
To delete / find a Telephone, select the option and telephone, you can key in the phone number to find
or delete. The right bottom screen will show the result.
Configuring VIP from a Web Browser
17
VIP User’s Manual
4.1.1.2 Hunt Group
Please select Main Menu\Dial Plan\Phone/Hunt Group/Destination Settings, we can find
Phone/Hunt Group/Dest. Setting Menu. We are doing VIP hunt group table management.
We can add (delete, find or list) desired hunt group ID mapping to destination ID at this menu. If you
want to make the port calls to the secondary receiver, you can click one “More Destinations” you can
then add the second, third receiver if the desired port/phone is busy.
We can add (delete, find or list) desired hunt group ID mapping to destination ID at this menu.
Configuring VIP from a Web Browser
18
VIP User’s Manual
4.1.1.3 Destination IP/ Destination Channel
Please select Main Menu\Dial Plan\Phone/Hunt Group/Destination Settings, we can find
Phone/Hunt Group/Dest. Setting Menu. We are doing VIP destination table management. One is
Remote Destination IP, one is Remote Host Name and the other is Local Destination Channel.
Configuring VIP from a Web Browser
19
VIP User’s Manual
We can add (delete, find or list) desired destination ID mapping to Remote Destination IP, Domain
Name or Local Destination Channel at this menu.
Please back to Dial Plan Menu.
Configuring VIP from a Web Browser
20
VIP User’s Manual
4.1.1.4 Common Parameter
Please select Main Menu\Dial Plan\Common Parameter Settings
This Common Parameter Settings is the same as previous ATPM system parameters description. .
Configuring VIP from a Web Browser
21
VIP User’s Manual
4.1.2 Clear DialPlan
Please select Main Menu\Dial Plan\Clear All Dial Plan Settings
Clear All Dial Plan Settings will clear all the settings you made before. However, the 'Clear All' is
only temporary if you do not store to the Flash Memory afterwards.
That is, to restore all the settings from the Flash Memory, you need only to click on the 'Restore All En-
tries' on the left frame, or to reboot the system (the settings can be restored ONLY IF YOU DID NOT
STORE the entries).
4.1.3 Restore DialPlan
Please select Main Menu\Dial Plan\Restore All Dial Plan Settings
Retrieve all dial plan settings from the flash memory. All temporary settings will be cleared.
Configuring VIP from a Web Browser
22
VIP User’s Manual
4.1.4 Save to NVRAM
Please select Main Menu\Dial Plan\ Save to NVRAM
Ready to store Dial Plan settings to Flash Memory
Please Back To Main Menu
4.2 View System Configurations
Please select Main Menu\View System Config.
Configuring VIP from a Web Browser
23
VIP User’s Manual
View System Config. Function Briefings.Six options available
1.Firmware Version Information, which shows the versions of each firmware component
2.Network Settings, which shows the IP-related settings, and the status of associated management
tools
3.H.323 Parameter Settings, which shows the H.323-related parameters associated with the gateway
4.Coding Profile Information, which shows the configurations related to a specific coding profile
5.Channel Settings, which shows the configurations associated with a specific channel
6.Network Connection, which shows type of connection enabled in VIP
4.2.1 Firmware Version Information
Please select Main Menu\View System Config.\Firmware Version Info.
This will show current VIP firmware version information.
Firmware Information:
Please select Main Menu\View System Config.\H.323 Parameter Settings
The H.323 Parameters Settings:
h323 display_name = Customer
h323 h245_term_type = 60
h323 rtp_port_base = 30000
h323 out_fast_start = off
h323 in_fast_start = off
h323 h245_tunneling = off
h323 cisco_t38 = on
h323 callSignalPort = 1720
h323 nat_call = on
h323 call_name =
h323 local_alert = off
h323 default_dtmf = H323 V2 Signal
No Alternate IP Defined!
h323 dns_ip = 168.95.192.1 Domain:
h323 gk_mode = off
h323 h245_timeout = 30000
h323 term_id =
Configuring VIP from a Web Browser
24
VIP User’s Manual
4.2.3 Voice Coder Type
Please select Main Menu\View System Config.\Coder Type
The Voice Coder For Each Line Module:
Voice coder is G.723 for Line Module 1.
Voice coder is G.723 for Line Module 2.
4.2.4 Voice Coder Information
Please select Main Menu\View System Config.\Coder Information
Configuring VIP from a Web Browser
25
VIP User’s Manual
4.2.5 Channel Parameters
Please select Main Menu\View System Config.\Channel Parameters
This command can show the desired channel setting of VIP.
Configuring VIP from a Web Browser
26
VIP User’s Manual
4.2.6 Network Connection
Please select Main Menu\View System Config\Network Connection
This command can display the type of connection currently enabled in VIP.
4.2.6.1 DHCP Settings
Display current DHCP status in VIP
Command Line Interface reference:
net set dhcp
net set dhcp command configures VIP to be DHCP client in order to obtain TCP/IP related pa-
rameters from ISP while VIP is deployed in DHCP environment.
Syntax Description
on
off
If DHCP client is enabled/disabled, VIP has to be rebooted to make the DHCP service
started/stopped.
Turn on DHCP client
Turn off DHCP client
Configuring VIP from a Web Browser
27
VIP User’s Manual
4.2.6.2 PPPoE Settings
Display current PPPoE status in VIP
Command Line Interface reference:
net set pppoe
The net set pppoe command configures PPPoE related parameters while VIP is deployed in
PPPoE environment.
Syntax Description
on
off
username
Configuring VIP from a Web Browser
28
Turn on PPPoE client
Turn off PPPoE client
PPPoE connection username provided by ISP
VIP User’s Manual
password
fix_ip
PPPoE connection password provided by ISP
Fixed IP address provided by ISP
If PPPoE client is enabled/disabled, VIP has to be rebooted to make the PPPoE service
started/stopped.
Configuring VIP from a Web Browser
29
VIP User’s Manual
4.2.6.3 DDNS Settings
Display current DDNS status in VIP
Command Line Interface reference:
net set dyndns
Configuring VIP from a Web Browser
30
VIP User’s Manual
DDNS service can help users to find each other in dynamic/static IP environment, and enable two
VIPs call each other with registered host names. To be fully functional, DNS server MUST be
added into H323 configuration while DDNS service is enabled.
DDNS clients supported in VIP are www.dyndns.org and www.dtdns.com currently.
If VIP DDNS client is enabled, users MUST register a DDNS name from the sites listed above be-
fore proceeding any further.
Syntax Description
on
off
If DDNS client is enabled, VIP has to be rebooted to make the DDNS service effective.
sub commands:
set dyndns add [serv_name] [host_name] [user_name] [password]
Adding applied DDNS name into VIP database.
Note: if multiple DDNS names are inserted, only the first one will be updated.
Syntax Description
serv_name
host_name
user_name
password
set dyndns delete [host_name]|all
Turn on DDNS client
Turn off DDNS client
DDNS service server (MUST be “dyndns” or “dtdns” for now)
DDNS name registered from DDNS service provider
Username used to update DDNS account
Password used to update DDNS account
Delete specified or all DDNS name(s) configured in VIP.
DDNS related parameters must be saved via commands: “config activate, config store” in
order to be effective.
4.3 Configure System Settings
Please select Main Menu\Configure System Settings
Configuring VIP from a Web Browser
31
VIP User’s Manual
System Config. Settings Function Briefings
1. IP Settings, which allows one to set the gateway's IP address, its subnet mask, and its Default
Gateway IP address.
2. H.323 Parameter Settings, which allows one to set the H.323 parameters, such as Fast Start
Mode, Gatekeeper Mode, etc.
3. Port Parameter Settings, which allows one to set parameters associated with each port, such as
transmission/receive gains, comfort noise level, etc.
4. Voice Coder Selection, which allows one to set the desired coder type, such as G.711, G.723 or
G.729A, in a per line module base.
5. Network Connection, which allows user to buildup Internet connection according to different con-
nection type, currently connection types supported in VIP are DHCP, PPPoE connections.
Configuring VIP from a Web Browser
32
VIP User’s Manual
4.3.1 IP Settings
Please select Main Menu\Configure System Settings\IP Settings
This screen can setup your VIP IP Address, Subnet Mask and Default IP Gateway Address. These
values will be valid after VIP reboot.
4.3.2 H323 Parameters
Please select Main Menu\Configure System Settings\H.323 Parameter Settings
There are H.323 General Parameter Settings, H.323 GateKeeper Settings, H.323 Aliases Settings.
4.3.2.1 H323 General Parameter Settings
Please select Main Menu\Configure System Settings\H.323 Parameter Settings\H.323 General
Parameter Settings
Configuring VIP from a Web Browser
33
VIP User’s Manual
1. Display Name: The default string is “Customer”.
This field is to set the display name information that is carried in the H.323 setup messages. Up to 48
characters can be entered.
2. Terminal Type: The default value is 60.
This field is to set the H.245 terminal type, which is used as part of the master/slave determination
process of H.245. Typically, setting a value of less than 50 will force slave operation, and a value of
greater than 200 will force the master operation.
3. RTP Port Base: The default value is 30000.
This field is to select the starting port number for assignment of RTP and RTCP ports. According to
the H.323 specification, RTP port number should be even in value, and the RTCP port number should
be one greater than the RTP port. Typically, numbers from 0 to 1023 are reserved on most systems.
4. Outgoing Fast Start: The default setting is off.
This field is to enable or disable the Faststart mode on the outgoing side of the link.
5. Incoming Fast Start: The default setting is off.
This field is to enable or disable the Faststart mode on the incoming side of the link.
6. NAT_Call Mode: default is ON:
Enables calls from remote sites, which use NAT routers with private IP networks behind.
7. Default DTMF Mode: H323 V2 Signal or IMTC. The default is H323 V2 Signal
8. DNS IP Address:
Specify DNS server IP address; this parameter is required while DDNS client is enabled in VIP.
9. Call Signal Port:
Allows users to select TCP port which H.225 listens for incoming call setup request. (CLI only)
10. Local Alert:
Configuring VIP from a Web Browser
34
VIP User’s Manual
VIP will generate ring back tone before receiving Alerting message from remote gateway. (CLI only)
11. Cisco T.38:
This option is used for FAX transmitting while VIP interoperating with Cisco 5300. (CLI only)
4.3.2.2 H323 Gatekeeper Settings
Please select Main Menu\Configure System Settings\H.323 Parameter Settings\H.323 GateKeeper Settings
Gate Keeper Mode: The default setting is off. This field is to select the co-operation mode with some
gatekeeper(s). Three options available:
off: disables gatekeeper co-operation,
auto: enables auto-discovery of the gatekeeper
manual: enables gatekeeper co-operation in manual operation (the gatekeeper address must be
properly assigned).
The following fields must be filled up when the Gate Keeper Mode is set to either auto
or manual.
Gate Keeper Address: Specify the gatekeeper address when configured to manual mode. When auto
mode is desired, this field should be set to auto.
Allow Calls Without Gate Keeper: This field is to inform the H.323 stack to allow calls when the end-
point is not registered with a gatekeeper.
Registration Type: This field is to set the endpoint registration type. This specifies how the endpoint
will register itself with the gatekeeper.
Max Registration Retries: This field is to control how many registration attempts will be made before
the endpoint considers itself to have failed registration.
You'll have to reboot the system to make your changes active!
Configuring VIP from a Web Browser
35
VIP User’s Manual
4.3.2.2 H323 Aliases Settings
Please select Main Menu\Configure System Settings\H.323 Parameter Settings\H.323 Aliases
Settings
Alias: This field is to create or delete aliases that are registered with the gatekeeper.
Configuring VIP from a Web Browser
36
VIP User’s Manual
Chapter 5 Making a Call with VIP
This chapter how to make phone calls from telephony devices connected to VIP directly or indirectly.
5.1 Making a call with VIP FXS Module
VIP has two slide-in modules. FXS module can connect to analogue phone directly, and FXO module can connect to PBX.
Connection: analogue telephone set connects to FXS module port
Operation:
1. Pick up this analogue telephone set, you can hear VIP dial tone at the telephone set
2. The related LED will be lighted at the green color when the telephone set is pick up.
For Example: If the telephone set is connected to the second port of FXS in slot B. When you
pick up the telephone set, the second LED will be at the green color, it means on, in slot B of
front panel.
3. We can dial the desired destination phone number at the telephone set. If the desired desti-
nation phone number is legal, VIP will play two quick address ack tones, Du Du, to destination.
If the desired destination phone number is illegal, VIP will play three quick out of service tones,
please check the dial plan and your desired destination phone number.
5.2 Making a call with VIP FXO Module
Connection: analogue telephone set connects to FXO module port
Operation:
1. Pick up this analogue telephone set, you can hear the PBX dial tone at the telephone set. In
some cases, you have to dial a specific number to get the connection between telephone set
and PBX.
Application Samples 37
VIP User’s Manual
810
800
Port 3
2. Dial the phone number which is connected between PBX and VIP FXO module port.
3. When VIP is connected, the related LED will be lighted green.
For Example: If the telephone set is connected to the third port of FXO in slot A. When the
PBX is connected to VIP FXO port, the third LED will be green, it means on, in slot A of front
panel.
4. We can dial the desired destination phone number on the telephone set. If the desired desti-
nation phone number is legal, VIP will plan two quick sounds, “Du Du”, to destination. If the
desired destination phone number is illegal, VIP will plan out of service sound, please check
the dial plan and your desired destination phone number.
5.3 Making a call with VIP Application Sample
PSTN
Phone A Number:
(03)12345678
PBX Number: (03)87654321
“0”
Slot B
FXO
Slot A
FXS
FXS
Port 5
899
GW A
Port 1
HUB
GW B
Slot A
FXS
FXS
Port 2
Port 1
201 200
551 550
Scenario description:
There are two gateways connected by a Hub. Gateway A is configured as following:
1 Gateway A IP: 192.168.0.20, mask IP: 255.255.255.0, gateway IP 0.0.0.0 (virtual IP)
2 Slot A plugs FXS module and slot B plugs FXO module
3 Port 1 of FXS in slot A has a telephone set connected, its phone number is 200
4 Port 3 of FXS in slot A has a telephone set connected, its phone number is 201
5 Port 1 of FXO in slot B is connected to PBX.
5.1 There are two telephone sets connected by PBX, their phone numbers are 800 and 810.
5.2 PBX has a number, 899, is connected to Port 1 of FXO in slot B.
5.3 PBX has an outside call to PSTN. Digit 0 is connected to outside call.
5.4 Phone number: (03) 87654321 is an PBX representative number. 03 is an area code.
6 There is telephone set, define phone A, its number is (03) 12345678.
Gateway B is configured as following:
Application Samples
38
VIP User’s Manual
1 Gateway B IP: 192.168.0.55, mask IP: 255.255.255.0, gateway IP 0.0.0.0 (virtual IP)
2 Slot A plugs FXS module and slot B is empty
3 Port 1 of FXS in slot A has a telephone set connected, its phone number is 550
4 Port 2 of FXS in slot A has a telephone set connected, its phone number is 551
------------------------------------------------------ 1 Local PORT = 0
2 Local PORT = 1
11 H.323 Dest = 192.168.0.20/1720 TCP
Making a call between gateway A and Gateway B
Case 1: Gateway Phone to Gateway Phone,
Gateway B phone 550 calls to Gateway A phone 200
Human operation at GW B
Caller side
Equipment operation
Pick up phone 550 1.VIP dial tone is heard.
2.the first LED will be at the
green color in slot A of front
panel.
Dial 200 1.Du Du is heard
2.VoIP communication is going
Ring back tone is heard 1.The first LED is lighting in slot
A of front panel.
Pick up phone 200
Enjoy VoIP Enjoy VoIP
The above process is the same as Gateway B phone 550 calls to Gateway A phone 201, 800 and 801.
Human operation at GW A
Receiver Side
Phone 200 is ringing
Case 2: Gateway Phone to PSTN Phone,
Gateway B phone 550 calls to phone A number (03) 12345678
Human operation at GW B
Caller side
Pick up phone 550 1.VIP dial tone is heard.
Dial 889
Ring back tone is heard 1.The first LED is lighting in slot B
Dial 0 1.Gateway A is connected to
PSTN dial tone is heard 1.Gateway B is connected to
Application Samples
40
Equipment operation Human operation at Phone A
Receiver Side
2.the first LED will be at the green
color in slot A of front panel.
1.Du Du is heard
2.VoIP Communication is going
of GW A front panel.
PBX outside call
gateway A by Hub
VIP User’s Manual
Human operation at Phone A,
2.Gateway A is connected to
PSTN
Dial 12345678
1.PSTN communication is going Phone 12345678 is ringing
Ring back tone is heard Phone 12345678 is ringing
Phone 12345678 picks up
Enjoy VoIP Enjoy VoIP
The above process is the same as Gateway A phone 200 (201, 800,801) calls to phone A number (03)
12345678
Case 3: PSTN Phone to Gateway Phone,
Phone A number (03) 12345678 calls to Gateway B phone 551
Caller side
Equipment operation
Pick up phone A 1.PSTN dial tone is heard.
Dial 87654321 1.Communication is going
2.PBX plays voice greeting
Dial 889
1.The first LED lights in green color
in slot B of front panel.
2.VIP dial tone is heard
Dial 551 1.Du Du is heard
2.VoIP Communication is going
Ring back tone is heard
1.The second LED is lighting in slot
A of GW B front panel.
Pick up phone 551
Enjoy VoIP Enjoy VoIP
The above process is the same as Phone A calls to phone numbers 200, 201, 800, 801 or 550
Human operation at Gateway B
phone 551, Receiver Side
Phone 551 is ringing
5.4 Building up voice communication via VIP in Dynamic IP environment
Previous section shows the steps how to build up a VIP-to-VIP connection in static IP address
environment. This section we will shows you how to connect two VIPs in a dynamic IP address
Application Samples
41
VIP User’s Manual
environment together via built-in PPPoE, DHCP, and DDNS clients.
Scenario I - VIP with built-in PPPoE, DHCP, and DDNS clients:
Assuming second VIP, called VIP B, located on site B with default setting as well. First of all, it is required to apply a DDNS name from http://www.dyndns.org respectively for VIPs on site A and site B.
(For example, the names are planetvip.dyndns.org for VIP on site A, and planetvip2.dyndns.org for VIP
on site B.)
planetvip.dyndns.org is applied for VIP on site A,
planetvip2.dyndns.org is applied for VIP on site B.
Other parameters on this topology:
VIP on site A has PPPoE, and DDNSclients enabled
VIP on site B has DHCP, and DDNS clients enabled.
Network topology can be shown below:
Application Samples
42
VIP User’s Manual
atpm store
VIP configuration (ADSL PPPoE connection) on site A:
PPPoE section:
net set pppoe on
net set pppoe user_name [my_name]
net set pppoe pw [my_password]
net reset
DNS server section:
set h323 dns_ip 168.95.192.1
config activate
config store
DDNS client section:
set dyndns add dyndns planetvip planetvip planetvip
123
DNS server settings will not take effect till system reboot.
Create an address entry for VIP on site A
atpm done
Application Samples
43
VIP User’s Manual
After these modifications, users on site A are able to dial “66 + telephone number” to connect users on
site B to have voice conversation. Users on site B are able to have voice communication via dialing
number “77 + telephone number” toward users on site A. (please note that there is a Max digits (8) limitation of dialstring in this case, users may modify this parameter to meet different needs.)
Scenario II: VIP co works with (NAT) router which has built-in DDNS client:
In this scenario, PLANET XRT 401B is used for DDNS and DMZ features illustration
<DDNS setting screen of XRT-401B>
a) Enable DDNS feature in XRT-401B.
b) Insert the registered DDNS name, and username/password applied from www.dyndns.org or
www.dtdns.com
c) Click “Apply”, and check if DDNS service is effective in machine status log.
Note:
DDNS feature might come from different router vendors. Please refer to respective user’s manual for
DDNS feature explanation and configuration
Please note that DDNS client in VIP series is not suggested working in NAT environment.
Application Samples
44
VIP User’s Manual
<DMZ setting screen of XRT-401B>
a) Enable DMZ feature in XRT-401B.
b) Go to “Advanced” – “Firewall” Option menu, and find the “DMZ” function.
c) Click on the “WAN IP“ tab to enable the desired IP address to destination VIP.
d) Click “Apply” to make DMZ feature effective on VIP.
Network topology can be shown below:
Application Samples
45
VIP User’s Manual
Commands used on this topology:
IP Configuration on VIP-000/200/400/400FS/400FO
1) net set ip: setup IP address on VIP
1) net set mask: setup IP mask in VIP
3) net set gateway : assign gateway IP address in VIP
4) net show: display VIP network related parameters.
H323 Configuration on VIP-000/200/400/400FS/400FO
Application Samples
46
VIP User’s Manual
1) set h323 dns_ip <dns_server_ip>:
Assign an effective DNS server IP for domain name resolution.
In this topology, DNS server is a MUST-HAVE parameter.
Note:
Please obtain DNS server from local ISP in order to have best efficiency for name resolution while making
domain name calls.
After adding the DNS server, please use "config store " to save settings, then reboot machine to make the
settings effective.
2) set h323 nat_call on: to have packet correctly resolved in NAT environment, this option MUST be en-
abled.
Network Deployment
DDNS service
planetvip.dyndns.org (61.155.107.86) is applied by XRT-401B on site A,
planetvip2.dyndns.org (216.94.170.66) is applied by XRT-401B on site B.
Other parameters on this connection :
VIP-000 on site A has DMZ, and nat_call enabled
VIP-000 on site B has DMZ, and nat_call enabled.
VIP-000 configuration on site A :
IP configuration :
net set ip 192.168.0.77
net set mask 255.255.255.0
Please refer to your application environment to fill these parame-
net set gateway 192.168.0.254
net reset
DNS server section
set h323 dns_ip [dns_ip]
DNS server settings will not take effect till system reboot.
config activate
config store
Dialplan settings
atpm req
atpm aadd 66 2 8 66 2
atpm hadd 66 2 66
Create an address entry for VIP-000 on site B
atpm dadd 66 dns planetvip2.dyndns.org
atpm done
atpm store
VIP configuration (cable connection) on site B:
DHCP section:
ters.
Application Samples
47
VIP User’s Manual
IP configuration :
net set ip 192.168.0.88
net set mask 255.255.255.0
Please refer to your application environment to fill these parame-
net set gateway 192.168.0.254
net reset
DNS server section
set h323 dns_ip [dns_ip]
DNS server settings will not take effect till system reboot.
After these modifications, users on site A are able to dial “66 + telephone number” to connect users on site B to
have voice conversation. Users on site B are able to have voice communication via dialing number “77 + tele-
phone number” toward users on site A. (please note that there is a Max digits (8) limitation of dialstring in this
case, users may modify this parameter to meet different needs.)
ters.
Create an address entry for ITG on site A
A key point in NAT-to-NAT VoIP communication, DMZ and DDNS functionality of the NAT routers
have to function CORRECTLY, or the voice communication might have one-way communication, i.e.
only WAN side voice can hear the voice from LAN side, but LAN side users cannot hear the voice from
WAN side.
Application Samples
48
VIP User’s Manual
VIP
VIP
VIP
VIPB
from VIP A
toward VIP
5.5 PLAR (hotline) connection sample
VIP is capable of automatically originate or forward an incoming call from Internet or PSTN line toward
another remote destination.
In this session, three sample topological graph are provided to illustrate PLAR feature in VIP:
FXO to FXS PLAR connection:
PSTN
(1234567)
FXO 205
-000 A
(192.168.0.1)
-000 B
(192.168.1.1)
FXS 201
Usage:
Users on site A (VIP A) pick up
the phone (502), and dial
1234567 to get the FXO port 201
0f VIP A, then VIP A will automatically direct the call to VIP B
phone number 201
Scenario description:
User on site A (VIP-000 A) wishes to have
telephone calls to user (201) on Site B (VIP-000 B)
to be automatically directed.
Solution
This can be achieved by setup a hotline (PLAR) on
-000 A.
Procedures:
Log on VIP A via telnet session or console port connection, and type the following commands:
set tcid 0 dial_in plar 20
config activate
config store
This part creates an address entry for
This part
setup the
hotline
Application Samples
B
49
VIP User’s Manual
VIP
VIP
from PBX B, user (502) dials 702 to talk to the extension
This can be achieved by setting up a hotline (PLAR)
VIPB
This part setup the hotline from VIP A
FXO to FXO PLAR connection:
-000 A
(192.168.0.1)
-000 B
(192.168.1.1)
FXO 201 FXO 201
PBX
Extension 502
set tcid 0 dial_in plar 20
config activate
config store
toward VIP B
Usage :
Users on site A (VIP A) pick up the phone (502),
and dial extension 501 to connect to VIP A, at
this time, VIP A will automatically connect to VIP
B FXO port 201 to get the dialtone from PBX B.
After the dialtone, users dial the extension
number (702) to start speaking.
PBX
Extension 702
User (502) on site A (VIP-000 A) wishes to have
telephone calls to extension (702) on Site B (VIP-000 B)
to be automatically forwarded, after hearing dialtone
702.
Solution:
on VIP-000 A.
Procedure:
Log on VIP A via telnet session or console port
connection, and type the following commands :
This section provides solutions for problems you may possibly encounter while installing and connecting your Internet Telephony Gateway.
Power (PWR) LED is not illuminate
1. Check the power adapter connection.
2. If the power adapter or power cord is connected to the gateway, check that the cord is securely plugged into the power socket on the rear of the console.
3. Check that the other end of the power adapter or power cord is securely plugged into the
power outlet.
4. If both ends of the power cord are properly connected and there is still no power, the
gateway might have a faulty power outlet, power adapter, or power cord.
5. Change to another power outlet or obtain another power adapter or power cord.
LNK LED is not illuminate
1. Check VIP was connected correctly:
a. Powered on
b. Correctly connected
2. Check if the cable connect to an end device is a standard straight through network
Ethernet cable.
3. Make sure connectors at both end are securely seated.
4. Check VIP IP setting is correct
Slot A/B LED is not illuminate
1. Check if the slide-in module card plugged into the port is securely seated.
2. Make sure that the slide-in module card is not damaged.
3. If problems still occur, then the slide-in module card may not be defined.
Line module port LED is not illuminate when pick up the phone
1. Check Slot A/B LED illuminate
2. Check the RJ11 telephone line is connected correctly between phone set and line module
port
There is no dial tone when pick up the phone
1. Check line module port LED illuminate
2. Check the RJ11 telephone line is connected correctly between phone set and line module
port
There is an out-of-service tone when dialing destination phone number
Command Line Interface 51
VIP User’s Manual
1. Check the dial plan setting (address table, hunt group table and destination table) at the
destination phone number
There is no connected tone when dialing destination phone number
1. Check the IP network (Ethernet cable, Ethernet port and GW IP setting) is connected correctly
2. Check the destination VIP and phone is available
Final Steps
If the procedures in this section have not solved the problem, reset the gateway several times
by turning the power on and off. If the problem still exists, contact customer support.
52
Command Line Interface
VIP User’s Manual
Chapter 7 Command Line Interface
VIP has a built-in command line interpreter and provide users a Command Line Interface (CLI).
You can configure VIP by entering commands from the CLI.
You can access the CLI from a VT-100 terminal or terminal emulator connected to the RS-232 port
on the front panel or through a Telnet session.
7.1 Connection through Serial Port
The serial port of VIP is fixed at the following settings:
Baud rate
Number of data bit
Parity check
Number of stop bit
Flow control
To access VIP through the RS-232 serial port, follow the steps below:
1. Insert one end of the serial cable that came with VIP into the 9-pin RS-232 port (labeled User
Console) on the front panel.
2. Insert the other end of the cable into your terminal’s serial port.
3. Configure the terminal so that settings for baud rate, number of data bit, parity check, number
of stop bit and flow control capability exactly match VIP’s serial interface. (Refer to you terminal
documentation for more information about setting up these features).
4. Press <Return> from the terminal.
5. VIP displays the following prompts on the terminal and you are ready to access the CLI then.
EVIP>
19,200
8
None
1
None
7.2 Connection through Telnet
To use Telnet, you must have previously set the IP address using the net set ip command for VIP.
Refer to the section describing the net set command later in this chapter for information about setting the IP address. Up to two sessions through Telnet are possible. To access VIP from a remote
host with Telnet, perform the following tasks:
Command Line Interface
53
VIP User’s Manual
command later in this
Task Prompt Type
From the remote host, enter the telnet command
followed by the IP address of VIP you want to access.
None
telnet ip_addr
When VIP prompts “Login:”, enter the user name
“administrator”
When VIP prompts “Password:”, enter the password. The default password is “123” unless a
password was previously established using the
net set user_pw command (Refer to the section
describing net setuser_pw
chapter for details about the setting password).
Upon successfully entered the password, VIP displays greeting message and the following prompts
and you are ready to access the CLI commands.
ITG>
Login:
Password: password
administrator
7.3 Command Help
Help for commands is provided by the CLI. Type help to see a listing of the top-level commands.
On most cases, if you enter a command using the wrong number of arguments or inappropriate arguments, the CLI will give further usage.
7.4 Designating IP Address
Some commands require an IP address, which must be designated in a standard format. The IP
address format is 32 bits, written as four octets separated by periods (dotted decimal format) that
are made up of a network section, an optional subnet section, and a host section, as shown in the
following example:
192.168.0.1
7.5 Designating Port Number
Some commands require a telephony port number. VIP designates the first port on TIM slot A as
port number 0, the 2nd port as port number 1 and so on. When a TIM is installed in slot B, the first
port is designated as port number 4, the 2nd one is designated as port number 5 and so on.
54
Command Line Interface
VIP User’s Manual
7.6 Command Reference
The following table list the CLI command in alphabetic order.
Command
Description
atpm Dial plan management command
clrscr Clear screen
config Configuration management command
download Download new revision code image from TFTP server
help Display help screen
net Set or display network parameters
ping Ping another Internet host
set Set system configuration
tel Set or display telephony port options
For the ease of understanding and explaining these commands, the commands are categorized
into the following command sets and the following sections explaining each set of the commands.
Command Set
Utility clrscr
Commands Function
General purpose utility commands
download
help
ping
Network net Commands for setting or displaying network
related parameters
Configuration
management
Dial plan
menagement
Telephony tel Commands for setting or displaying telephony
config
show
Commands for configuring VIP or displaying
configuration
set
atpm Commands for setting or displaying dial plan
related options
Command Line Interface
55
VIP User’s Manual
Causes ping to send one datagram per second, printing one line of
7.7 Utility Commands
clrscr
The clrscr command to clear the screen
Syntax Description
This command has no arguments or keywords
download
Use the download command to enter download mode for reading code image from a TFTP server
and program it to flash memory. Refer to 0 for detailed information on how to upgrade the system
software.
Syntax Description
This command has no arguments or keywords
Note
This command in available from serial interface. It is not available from Telnet unless the TFTP
loader is version 3.00 or higher.
help
The help command lists the top-level commands.
Syntax Description
This command has no arguments or keywords
ping
The ping command sends Internet Control Message Protocol (ICMP) echo request packets to another node on the network.
output for every response received.
The IP address or IP alias of the host.
(Optional) The number of packets to send
(Optional) Timeout value for the ping in millisecond
56
Command Line Interface
VIP User’s Manual
The IP address of the default gateway. IP address of 0.0.0.0 stands for no default
7.8 Network Commands
net reset
Use the net reset command to reset VIP. The CLI will prompt you to confirm the command before resetting VIP.
Syntax Description
This command has no arguments or keywords
net set gateway ip_addr
Use the net set gateway command to assign a default gateway (router) for VIP. The default
gateway routes packet data outside or your IP subnet.
Syntax description
ip_addr
Note
The new setting will not take effect until VIP is reset.
gateway.
net set http {on|off}
VIP allows you enable of disable its built-in HTTP server. Use the net set http command to enable or disable the HTTP server.
Syntax description
on
off
Enable HTTP server. This allows users to access VIP from web browser.
Disable HTTP server.
net set telnet {on|off}
VIP allows you enable of disable its built-in Telnet server. Use the net set telnet command to
enable or disable the Telnet server.
Syntax description
on
off
Enable Telnet server. This allows users to access VIP from web browser.
Disable Telnet server.
net set ip ip_addr
Use the net set ip command to assign an static IP address to VIP.
Syntax description
ip_addr
Note
Command Line Interface
The IP address of VIP.
57
VIP User’s Manual
The new IP address will not take effect until VIP is reset.
net set ip_preced ip_preced
VIP allows you to set the 8-bit Service Type field in the IP header for all the voice packets it sends
out. The Service Type field is broken down into five subfields, among which four subfileds are user
configurable. This command is used to set these subfields.
net set ip_preced ip_preced [d] [t] [r]
Syntax description
ip_preced
d
t
r
Default
ip_preced: 0
d: 0
t: 0
r: 0
Notes
The new setting will not take effect until the VIP is reset.
The 3-bit PRECEDENCE subfiled ranging from 0 through 7.
The D bit subfield, either 0 or 1.
The T bit subfield, either 0 or 1.
The R bit subfield, either 0 or 1.
net set mask ip_mask
Use the net set mask command to set the IP subnet mask for VIP.
Syntax description
ip_mask
The subnet mask of your network.
Note
The new setting will not take effect until VIP is reset.
net set speed {10|100|auto}
VIP allows you set the link speed for its Ethernet interface. Use the net set speed command to set
the Ethernet link speed.
Syntax description
10
100
58
Command Line Interface
Fixed the Ethernet speed at 10 Mbps
Fixed the Ethernet speed at 100 Mbps
VIP User’s Manual
auto
Enable the 10/100 Mbps auto-negoriation capablity.
net set user_pw password password
Use the net set user_pw command to change the password for Telnet user.
Syntax description
The new password. The password must be equal to or less than 7
password
alphanumeric characters. It must be identically typed twice for VIP to
be certain about the new password.
net show
The net show command displays all the network settings.
Syntax Description
This command has no arguments or keywords
Example
The following example shows how to display network settings:
ITG> net show <Enter>
******************* Net Parameters *******************
PPPoE = disabled
DYN DNS = disabled
DHCP client = disabled
Current active IP address = 192.168.0.1.
Current active subnet mask = 255.255.255.0.
IP precedence = 0 0 0 0
Ethernet MAC address = 00-30-4f-00-29-20
Ethernet speed setting = 10/100 Mbps auto-negotiation
USER password = 123
HTTP server = enabled
Telnet server = enabled
******************************************************
ITG>
net show hwstat
The net showhwstat command displays the hardware configuration of VIP.
Command Line Interface
59
VIP User’s Manual
Syntax Description
This command has no arguments or keywords
Example
The following example shows how to display hardware configuration:
ITG>net show hwstat <Enter>
****************** Hardware Configuration ******************
Flash: type-MX29L1611 64 sectors 64 KB/sector
RAM: 8 MB 256K x 32
LAN: 100 Mbps half duplex. Link UP
TIM slot A: type-FXS4 DSP-C549 codec-NW1034 Diag-OK
TIM slot B: type-FXO4 DSP-C549 codec-NW1034 Diag-OK
************************************************************
ITG>
net set pppoe
The net set pppoe command configures PPPoE related parameters while VIP is deployed in
PPPoE environment.
Syntax Description
on
off
username
password
fix_ip
Turn on PPPoE client
Turn off PPPoE client
PPPoE connection username provided by ISP
PPPoE connection password provided by ISP
Fixed IP address provided by ISP
net set dhcp
net set dhcp command configures VIP to be DHCP client in order to obtain TCP/IP related pa-
rameters from ISP while VIP is deployed in DHCP environment.
Syntax Description
on
off
Turn on DHCP client
Turn off DHCP client
net set dyndns
DDNS service can help users to find each other in dynamic/static IP environment, and enable two
VIPs call each other with registered host names. To be fully functional, DNS server MUST be
added into H323 configuration while DDNS service is enabled.
DDNS clients supported in VIP are www.dyndns.org and www.dtdns.com currently.
60
Command Line Interface
VIP User’s Manual
If VIP DDNS client is enabled, users MUST register a DDNS name from the sites listed above before proceeding any further.
Syntax Description
on
off
sub commands:
set dyndns add [serv_name] [host_name] [user_name] [password]
Adding applied DDNS name into VIP database.
Note: if multiple DDNS names are inserted, only the first one will be updated.
Syntax Description
serv_name DDNS service server (MUST be “dyndns” or “dtdns” for now)
host_name
user_name
password
set dyndns delete [host_name]|all
Delete specified or all DDNS name(s) configured in VIP.
Syntax Description
Turn on DDNS client
Turn off DDNS client
DDNS name registered from DDNS service provider
Username used to update DDNS account
Password used to update DDNS account
This command has no arguments or keywords.
7.9 Configuration Management Commands
The configuration management commands allow the user to set values for system configuration parameters. In addition, it provides mechanisms to allow a user to control when new parameter values are put in use.
The CLI maintains three areas where the parameters are stored:
Command Line Interface
61
VIP User’s Manual
Ÿ 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 VIP, 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 configactivate 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 VIP remains in operation. If VIP 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 parameter, settings won’t take effect until VIP reset. To ensure the H.323
setting to take effect, it is recommended to reset VIP after changing the settings using the set
command.
In summary:
Ÿ Use set commands to make configuration parameters changes in the Temporary area
Ÿ Use the config activate command to move the new values into the Active area, available for
use
Ÿ Use the config store command to save the new Active values in NVS
Ÿ Reset VIP after changing H.323 settings and storing the setting to NVS.
config {activate|store|erase}
Use the activate command to manage the configuration data. A sequence of set command is typically preceded by and/or followed by the config command for the set command to become active.
Syntax description
activate
store
erase
Move the configuration from temporary area to active area.
Store the active configuration data into non-volatile storage.
Erase the configuration from non-volatile storage.
show h323
The show h323 command displays the settings of the parameter that are related to H323 signaling
protocol.
Syntax Description
This command has no arguments or keywords
Example
62
Command Line Interface
VIP User’s Manual
The following example shows how to display the H323 parameters:
h323 display_name = Customer
h323 h245_term_type = 60
h323 rtp_port_base = 30000
h323 out_fast_start = off
h323 in_fast_start = off
h323 h245_tunneling = off
h323 cisco_t38 = on
h323 callSignalPort = 1720
h323 nat_call = on
h323 call_name =
h323 local_alert = off
h323 default_dtmf = H323 V2 Signal
No Alternate IP Defined!
h323 dns_ip = 168.95.192.1 Domain:
h323 gk_mode = off
h323 h245_timeout = 30000
h323 term_id =
show version
The show version command displays the version of various software components of VIP.
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
del
alias
Create an alias alias
Delete a previously created alias alias
Alias to be created or deleted
all Delete all previously created alias. This optional applies to del only
Command Line Interface
63
VIP User’s Manual
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 imcoming
calls from a remote VIP which is not registered with a gatekeeper.
Syntax Description
true
false
Default
VIP allows calls from VIP that is not registered with a gatekeeper.
Allow calls from VIP that is not registered with a gatekeeper.
Do not allow calls from VIP that is not registered with a gatekeeper.
set h323 auto_answer {on|off}
The set h323 auto_answer command is used to enable or disable early call setup connection. If
disabled, the call is not set up until the user initiates the connection.
Syntax Description
on
off
Enable H323 early call setup connection.
Disable H323 early call setup connection.
set h323 call_name
This command is used to set a string that VIP will encapsulate in the H.323 Setup message it sends
to a remote VoIP device when initiating a call.
set h323 call_name call_name
Syntax Description
call_name
Default
Null
Call name, up to 30 characters, to be encapsulated in the 3rd alias field of
srcAddress field of the H.323 call setup message
set h323 cisco_t38
Cisco FoIP solutions support standard T.38 fax. However, they expect their peer gateways initiating
Open Logical Channel (OLC) request, when it determines itself as a H.323 Master. For the ITG to
be aware of initiating OLC request when interoperating with Cisco gateway, this command is provided.
set h323 cisco_t38 {on | off}
Syntax Description
64
Command Line Interface
VIP User’s Manual
The string to be is inserted into the Q.931 display information field
on
off
Default
off
Initiates H.323 OLC under slave mode.
Waits for H.323 OLC from maser under slave mode.
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
Example
The following example sets the h323 display name as “my gateway”.
ITG> set h323 display_name my gateway
and in the sourceAddress field 2 of the H.323 setup-UUIE .
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
Default
The default setting is 300 milliseconds.
Duration for the DTMF tone in millisecond.
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 VIP will register itself with the gatekeeper, and has nothing to do with master/slave determination.
Syntax Description
gw
terminal
Default
VIP registers to gatekeeper as a H.323 Gateway.
VIP registers itself to gatekeeper as a H.323 Gateway
VIP registers itself to gatekeeper as a H.323 Terminal
Command Line Interface
65
VIP User’s Manual
set h323 endpoint_prefix
This command is used to set the H.323 prefix that VIP uses when registering to an H.323 gatekeeper. After registering to a gatekeeper using the prefix, the gatekeeper will map all Admission
Request with destination matching the prefix to VIP.
set h323 endpoint_prefix alias
Syntax Description
alias
Default
Null
H.323 alias of the prefix.
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 h323gk_max_triescount
The set h323 allow_call_wo_gk command is used to control how many registration attempts will
be made before VIP considers itself to have failed registration. Once this number of unsuccessful
attempts have been made, VIP will only be able to place calls if allow_calls_wo_gk is true.
Syntax Description
count
Default
The default number of registration attempt is 2.
Number of registration attempt
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 call is establishmet through a gatekeeper.
Syntax Description
off
manual
auto
Default
The gatekeeper operation is disabled.
66
Command Line Interface
Disables gatekeeper operation
Enables gatekeeper in manual discovery mode. The gk_addr must be set appropri-
ately.
Enables auto-discovery of the gatekeeper
VIP User’s Manual
ting the H.245 terminal type to a value less than 50 will force slave
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
A numerical value designating the H245 terminal type. Typically, set-
termmal_type
operation, and a value greater than 200 will force master operation
Example
The following example sets the h245 terminal type to 60.
ITG> set h323 h245_term_type 60
set h323 h245_tunneling
In order to conserve resources, synchronize call signaling and control, and reduce call setup time, it
may be desirable to convey H.245 messages within the Q.931 Call Signaling Channel instead of establishing a separate H.245 channel. This is so-called "tunneling". This command is used to set
tunneling feature. Syntax Description
on
off
Default
off
Turn on H.245 tunneling feature
Turn off H.245 tunneling feature
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, VIP 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
del
ip_addr
Default
VIP 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.
VIP sends DTMF digit to the remote VoIP device designated by IP address ip_addr
in IMTC conforming format.
VIP sends DTMF digit to the remote VoIP device designated by IP address ip_addr
in H.323 format.
IP address of the remote VIP
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 VIPs.
Command Line Interface
67
VIP User’s Manual
Syntax Description
on
off
Set H323 Faststart mode on
Set H323 Faststart mode off
set h323 master_delay
To be able to interoperate with certain H.323 terminals, such as Microsoft NetMeeting, the gateway
can not send out H.323 open logical channel message to its counter H.323 terminal immediately after completing H.323 maser slave determination phase. This command allows users to delay sending the H.323 Open Logical Channel message to its counter H.323 terminal.
set h323 master_delay {on | off}
Syntax Description
on
off
Default
Off
Delays sending H.323 open logical channel message.
Sends H.323 open logical channel message upon completing H.323 maser slave deter-
mination.
set h323 nat_call {on|off}
When VIP 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 enables VIP to connect to remote VIPs connecting to WAN via NAT capable router.
Syntax Description
on
off
Enable.
Disable.
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 VIPs.
Syntax Description
68
Command Line Interface
VIP User’s Manual
on
off
Set H323 Faststart mode on
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 a calls are made to remote VIPs, an RTP port is opened for each call. VIP 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
The starting port number for the assignment of RTP port. If rtp_port_base is as-
port_base
Example
The following example sets RTP base port number to 30000.
ITG> set h323 rtp_port_Base 30000
signed a value of 0, the assignment of 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.
7.10 Voice Coding Profile Configuration Commands
Coding profile is used to store coding parameters for voice and fax coding p that can be used by telephony port on VIP. VIP has built-in coding profiles, each having a unique profile ID and parameters for specific voice, fax or modem coder. Among these coding profiles, there are five may be
used for voice or fax applications. The following table summarizes coding profiles available for
voice and fax applications.
This session will introduce commands for setting the parameters for a particular coding profile. All
the commands in this session are of the same syntax as follows:
set coding profile_id option [option] . . .
Syntax for the profile_id is as follows:
profile_id
ID of the coding profile to be modified.
G.711 μ-law voice coder
Command Line Interface
69
VIP User’s Manual
7.10.1 Common Coding Profile Configuration Commands
set coding profile_id coding_type coding_type
Syntax description
coding_type
Parameter Description
Type of the codcc as defined in the following table.
g711_mu
g723_53
g723_63
g729ab
fax_t38
G.711 PCM u-law coding
G.723.1 5.3 kbps coding
G.723.1 6.3 kbps coding
G.729 annex A, annex B 8kbps coding
Fax Relay in T.38 mode
Note: Modification will not take effect till save and next reboot.
set coding profile_id cp_tone_detect {on | off}
This command is used to specify a secondary level of control of call progress tone detection. If the
call progress detection control for a telephony port is set to "As per coding profile" (refer to command “set port port cp_tone_det_ctrl”), this parameter determines if detection is to be enabled or
not.
Syntax description
on
off
Enable call progress tone detection.
Disable call progress tone detection.
set coding profile_id fax_tone_detect {on | off}
This command is used to specify a secondary level of control of V.21 fax tone detection. If the fax
tone detection control for a telephony port is set to "As per coding profile" (refer to command “set
port port fax_tone_det_ctrl”), this parameter determines if detection is to be enabled or not. For a
voice coder, fax tone detection has to be enabled, otherwise, telephony port never switches to fax
mode while the voice coder is active. For a fax profile it does not matter if the fax tone detection is
enabled or disabled.
Syntax description
on
off
Enable V.21 fax tone detection.
Disable V.21 fax tone detection.
set coding profile_id usage {voice | fax} {on | off}
Syntax description
70
Command Line Interface
VIP User’s Manual
The coding profile is allowed, if the parameter that follows is “on”, for being used
Voice
Fax
as voice coder.
The coding profile is not allowed, if the parameter that follows is “off”, for being
used as voice coder.
The coding profile is allowed, if the parameter that follows is “on”, for being used
as fax coder.
The coding profile is not allowed, if the parameter that follows is “off”, for being
used as fax coder.
VIP has built-in voice packet buffer, which allows VIP to remove packet jitter from the incoming
packet stream. VIP also implements an adaptive voice packet playback.This command is used to
enable/disable the adaptive playback function for a voice coding profile.
VIP supports DTMF Relay, in which DTMF tones are detected during voice processing, encoded into
H323-UserInformation packets and conveyed to the remote VIP via the H.323 call control band. This
command is used to enable or disable the DTMF Relay feature.
Syntax description
on
off
Detect DTMF tones while voice session is on-going, and send detected
DTMF digits to remote gateway via the H.323 call control band.
Do not detect DTMF tones. DTMF tones are compressed and send to
remote gateway the same as regular voice frame.
set coding profile_id max_delay
Voice packets from network may have traversed variable path and each packets have experienced different propagation delay. To ease this phenomenon, VIP has a built-in voice packet buffer, which
stores voice packets received from the network. The effect of non-uniform delay among packets is
known as jitter. The voice buffer allows VIP to remove the packet jitter from the incoming packet
stream before decompressing and sending the packet to telephony port for playing out. This command
is used to set the size of voice buffer.
Syntax description
delay
Notes
Command Line Interface
Value in milliseconds.
71
VIP User’s Manual
1. The maximum delay should be at least 2 packet times greater than the nominal delay. Refer to
command “set coding profile_id nom_delay” for details about setting nominal delay.
2. The maximum delay for each coder is shown in the following table:
Coding Type Maximum Delay
G.711 μ-law
145 ms
G.723 500 ms
G.729AB 500 ms
set coding profile_id min_delay
This command is used to set the time each voice packet is stored in the voice packet buffer before VIP
playing out the packet. It is only meaningful when the adaptive playback feature is disabled. Refer to
“set coding profile_id adaptive_playout” for details about adaptive playback feature.
Syntax description
delay
Value in milliseconds.
set coding profile_id nom_delay
Syntax description
Delay
Value in milliseconds.
set coding profile_id vad {on | off}
This command is used to enable/disable the Voice Activity Detector (VAD) for a coding profile.
Syntax description
On
Off
Enable VAD.
Disable VAD.
set coding profile_id vad_thresh
This command is used to set threshold level for the VAD for a coding profile.
Syntax description
threshold
Value in dBm, ranging from –20 to +10.
set coding profile_id vif
This command is used to set the size of the Voice Information Field (VIF), in bits, for a voice coder.
Syntax description
72
Command Line Interface
VIP User’s Manual
Hunt group table
Coding type Sampling time VIF
G.711 μ-law
10 ms 640
20 ms 1,280
30 ms 1,920
G.723 30 ms 192
60 ms 384
G.729AB 10 ms 80
20 ms 160
30 ms 240
40 ms 320
50 ms 400
60 ms 480
Note:
Size of the Voice Information Field (VIF), in bits, for a voice coder are related to the coding type and
the rate the voice coder samples a voice frame (the packet time), as shown in the table above. VIF
sizes of a coder of values other than those shown in the table are not valid.
7.11 Dial Plan Management Commands
Among the command sets supported by the CLI, the dial plan management commands are the
most sophisticated. Some of the dial plan management commands are only allowed when VIP is in
the atpm table update state. For ease of explaining, this command set is further categorized into
several sub command sets.
The following sections describe each sub command set and the commands.
Manage atpm address table atpm aadd
atpm adel
atpm afind
atpm alist
atpm slist
tion
atpm sys
Yes
No
No
Yes
Yes
No
No
No
Yes
74
Command Line Interface
VIP User’s Manual
Database Update Control Commands
atpm done
The atpm done command ends the atpm table update session and re-enables the address translation.
Syntax description
This command has no arguments or keywords
atpm erase
The atpm erase command erases the dial plan database from the non-volatile memory.
Syntax description
This command has no arguments or keywords
atpm purge {all|addr|dest|hunt}
Use the atpm purge command to delete all entries from the atpm tables.
Syntax description
all
addr
dest
hunt
Delete all entries from atpm ddress, destination and hunt group tables.
Delete all entries from atpm address table.
Delete all entries from atpm destination table.
Delete all entries from atpm hunt group table.
atpm req
The atpm req command starts the atpm table update session. Upon starting the atpm table update
session, the ATPM address translation is disabled, hence no phone call can be made, until a atpm
done command is issued.
Syntax description
This command has no arguments or keywords
atpm restore
The atpm restore command restores the whole dial plan from non-volatile storage to the atpm address, destination and hung group tables.
Syntax description
This command has no arguments or keywords
Command Line Interface
75
VIP User’s Manual
Destination ID. For each destination, you need to assign it a unique
atpm store [erase]
The atpm store command store all atpm tables into non-volatile memory.
Syntax description
(Optional) Erase the non-volatile before storing the dial plan data-
erase
base. This option is not recommended except the very first time you
use the atpm store command.
Destination Table Management Commands
atpm dadd dest_id port port#
The atpm dadddest_id port command adds an local destination entry into the atpm destination
table. A local destination entry is one of the telephony ports on VIP.
Syntax description
dest_id
port#
Example
The following example shows how to assign ID 1 to the first telephone port on TIM slot A and add
an entry in the destination table designating it.
ITG>atpm dadd 1 port 0 <Enter>
Destination ID. For each destination, you need to assign it a unique
identifier between 1 and 65536.
The number of the telephony port.
atpm dadd dest_id h323 dest_ip_addr [ip_port]
The atpm dadd dest_id h323 command adds a h323 type remote destination entry into the atpm
destination table. A remote destination entry is typically another VIP or H323 gateway.
Syntax description
dest_id
dest_ip_addr
ip_port
identifier between 1 and 65536.
The IP address of the remote destination.
(Optional) Base port number VIP uses to establish voice with that
remote destination.
Example
The following example shows how to add a remote destination whole IP address is 192.168.0.3 to
the destination table and assign an ID 200 to that destination.
ITG>atpm dadd 200 h323 192.168.0.3 <Enter>
76
Command Line Interface
VIP User’s Manual
atpm ddel dest_id
The atpm ddel command deletes an entry from the atpm destination table.
Syntax description
dest_id
ID of a previously added destination entry to be deleted from destination table.
atpm dfind dest_id
The atpm dfind finds and display an entry in the destination table.
Syntax description
dest_id
ID of a previously added destination entry to be displayed.
Example
The following example shows how to display a destination whose ID is 200.
ITG>atpm dfine 200 <Enter>
Dest id Mode Destination
-------------------------------------------------------------200 H.323 Dest = 192.168.0.3/1720 TCP
OK
EVIP>
atpm dlist
The atpm dlist displays all entries in the destination table.
Syntax description
1 Local PORT = 0
2 Local PORT = 1
3 Local PORT = 2
4 Local PORT = 3
5 Local PORT = 4
6 Local PORT = 5
7 Local PORT = 6
8 Local PORT = 7
11 H.323 Dest = 210.243.133.157/1720 TCP
OK
ITG>
Use the atpm hadd command to add an entry into the atpm hunt group table.
Syntax description
hunt_group_id
1
2
dest_id1
dest_id2
dest_id3 …
Example
The following example shows how to group destination 1, 2, 3 and 4 into a hunt group, assign it
hunt group ID 10, and specify hunt type 2 for this hunt group.
ITG>atpm hadd 10 2 1 2 3 4<Enter>
Hunt group ID. For each hunt group, you need to assign it a unique identifier
between 1 and 65536.
Hunt type 1. Hunt type 1 hunts destination within a hunt group starting from
the destination member just after the last used member.
Hunt type 2. Hunt type 2 hunts destination within a hunt group starting from
the first destination member.
ID of the first destination member in the hunt group.
(Optional)List of ID’s of additional destination members in the hunt group.
atpm hdel hunt_group_id
The atpm hdel command deletes an entry from the atpm hunt group table.
Syntax description
hunt_group_id
ID of the hunt group to be deleted from the hunt group table.
atpm hfind hunt_group_id
The atpm hfind finds and display an entry in the hunt group table.
Syntax description
hunt_group_id
ID of the hunt group to be displayed.
atpm hlist
The atpm hlist display all entries in the hunt group table.
Syntax description
Use the atpm sys command to set the time constraints for collection of dial digits.
Syntax description
dial_time
1st_digit_wait
inter_digit_wait
dial_term_digitr
The maximum time, in millisecond, allowed for entry of the entire
string of dial digits. At expiration, ATPM starts address lookup.
The maximum time, in millisecond, allowed between off-hook
and when the first dial digit is entered. At expiration, ATPM considers address lookup to fail.
The maximum time allowed between entry of each digit after the
previous digit. At expiration, ATPM starts address lookup.
(Optional) End of the dial string is declared when the digit is entered.
7.12 Tel Commands
tel show pcm_gain_level
The tel show pcm_gain_level command to display the gain level setting of the PCM codec’s re-
ceive channel.
Syntax Description
This command has no arguments or keywords
tel show port [port#]
The tel show port command displays the hook state of a telephony port.
Syntax Description
port#
Default
If the port number is not specified, the CLI displays hook state of all telephony ports.
Number of the port.
tel show ring_freq
The tel show ring_freq command to displays the frequency of the ring signal that VIP sends to
FXS ports..
Command Line Interface
81
VIP User’s Manual
tel set pcm_gain_level {1|2|3|4|5}
The FXO ports might be connected to central office switch or PBX via local loop which may of as
long as several miles. For compensating signal distortion in the local loop, VIP’s PCM codec is de-
signed in such a way that users might adjust it gain level before transmitting analog signal to the local loop. The tel set pcm_gain_level command is used to set the gain level for the PCM codec for
compensating signal loss in the local loop.
Syntax Description
1
2
3
4
5
Default
The default setting is -1 dB.
Note
The PCM gain level setting is only meaningful to FXO ports. It is not applicable to FXS ports.
Set gain level to –1 dB
Set gain level to 0 dB
Set gain level to +1 dB
Set gain level to +2 dB
Set gain level to +3 dB
tel set ring_freq {1|2|3|4}
Use the tel set ring_freq command to set the frequency of the ringer VIP uses to ring a FXS port.
Syntax Description
1
2
3
Set ring freq to 17 Hz
Set ring freq to 20 Hz
Set ring freq to 25 Hz
4
82
Command Line Interface
Set ring freq to 50 Hz
VIP User’s Manual
65535.
7.13 E & M Signaling Commands
E&M Common Signaling Configuration Commands
The E&M common signaling configuration commands are used to define common parameters used
on all E&M interfaces, regardless of their mode of operation (Wink Start, Delay Start, or Immediate
Start).
set port port em clear_conf_detect
This command is used to set the minimum duration of on-hook response on the M-lead that is required for clear confirm to be detected.
set port port em clear_conf_detect milliseconds
Syntax description
milliseconds
Default
5000
set port port em clear_conf_wait_max
This command is used to set the maximum duration to wait for an on-hook response on the M-lead
after going on-hook on the E-lead.
set port port em clear_conf_wait_max milliseconds
Syntax description
milliseconds
Default
10000
set port port em clear_detect
This command is used to specify the period of time M-lead needs to be on-hook before call clearing
is declared.
Time in milliseconds, ranging from 0 to
Time in milliseconds, ranging from 0 to 65535.
set port port em clear_detect milliseconds
Syntax description
milliseconds
Default
Command Line Interface
Time in milliseconds, ranging from 0 to 65535.
83
VIP User’s Manual
400
set port port em connected_min
This command is used to determine the minimum period of time (in milliseconds) that a connection
will be maintained. If the remote end disconnects during this interval, it will be acknowledged only at
the end of this interval.
set port port em connected_min milliseconds
Syntax description
milliseconds
Time in milliseconds, ranging from 0 to 65535.
Default
2000
set port port em dial_tone
This command is used to determine if dial tone should be generated on incoming calls.
set port port em dial_tone [on | off]
Syntax description
on
off
Generate dial tone.
Do not generate dial tone
Default
on
set port port em disable_hangup
This command is used to determine the time period (in milliseconds) a port will wait after hanging
up a call before signaling that it is in a disabled state.
set port port em disable_hangup milliseconds
Syntax description
milliseconds
Time in milliseconds, ranging from 0 to 65535.
Default
2000
set port port em guard_all
This command is used to set the period after an aborted call when no incoming calls will be neither
accepted nor outgoing calls initiated.
84
Command Line Interface
VIP User’s Manual
set port port em guard_all milliseconds
Syntax description
milliseconds
Time in milliseconds, ranging from 0 to 65535.
Default
400
set port port em guard_out
This command is used to set an additional period of time after guard_all when incoming calls will be
accepted but outgoing calls will not be initiated for aborted call.
set port port em guard_all milliseconds
Syntax description
milliseconds
Time in milliseconds, ranging from 0 to 65535.
Default
400
set port port em offhook_db
This command is used to set the off-hook debounce interval, in milliseconds.
set port port em offhook_db milliseconds
Syntax description
milliseconds
Time in milliseconds, ranging from 0 to 65535.
Default
50
set port port em onhook_db
This command is used to set the on-hook debounce interval, in milliseconds.
set port port em onhook_db milliseconds
Syntax description
Command Line Interface
85
VIP User’s Manual
milliseconds
Time in milliseconds, ranging from 0 to 65535.
Default
50
set port port em size_detect
This command is used to specify the period of time the M-lead needs to be off-hook before an incoming call is declared.
The E&M immediate start signaling configuration commands are used to define parameters specific
to E&M immediate start interface. These commands apply to E&M Immediate Start signaling protocol only.
set port port emi glare_report
This command is used to set a time period during which, if glare is detected, the interface will stay
off-hook and generate congestion tone.
set port port emi glare_report milliseconds
Syntax description
milliseconds
Time in milliseconds, ranging from 0 to 65535.
Default
5000
set port port emi wait_dsp_ready
This command is used to set a time period (in milliseconds) to wait for the DSP software to be
ready before digit collection can be enabled. If glare is detected during this period, the interface will
stay offhook and generate congestion tone.
set port port emi glare_report milliseconds
Syntax description
milliseconds
Time in milliseconds, ranging from 0 to 65535.
Default
86
Command Line Interface
Loading...
+ hidden pages
You need points to download manuals.
1 point = 1 manual.
You can buy points or you can get point for every manual you upload.