background image

P/N 480-0049-00-13

5-1

C

hapter 5: Getting Started: Command Line 

Interface (CLI)

This chapter tells you how to use access and use the CLI.  Specifically, the following topics are included:

  

!

CLI Description 

!

Access CLI

!

Configuration via CLI 

Summary of Contents for Tenor DX

Page 1: ...Switch Product Guide P N 480 0049 00 13 Tenor and Quintum are registered trademarks PacketSaver Quintum Technologies Inc Risk Free VoP VoIP Made Easy TASQ SelectNet and SelectNet Technology are tradem...

Page 2: ...consumption 1 5 Easy Connect to Console 1 5 Powerful System Monitoring 1 5 Capabilities 1 6 Virtual Tie Line 1 6 SNMP Support 1 6 Call Detail Recording 1 6 IVR RADIUS Support 1 6 NATAccess 1 7 Call R...

Page 3: ...IP Address 3 12 Change IP Address 3 13 Load Software Upgrade 3 15 Chapter 4 Getting Started Tenor Configuration Manager Tenor Monitor Overview 4 2 Tenor Configuration Manager 4 3 Getting Started with...

Page 4: ...7 System Alarms Overview 7 2 Monitor Alarms 7 2 How to Read Alarms 7 2 Valid Alarms 7 4 View Alarms 7 7 Display all Alarms 7 7 Display Active Alarms 7 7 Display Alarm History 7 8 Chapter 8 Diagnostic...

Page 5: ...P N 480 0049 00 13 Preface 1 About this Guide...

Page 6: ...or Configuration Manager Tenor Monitor This chapter tells you how to use the Tenor Configuration Manager and Tenor Monitor to configure monitor the unit Chapter 5 Getting Started Command Line Interfac...

Page 7: ...pecial text that are designed to reveal supplemental information Note Warn ing and Caution See below A NOTE provides additional helpful information This information may tell you how to do a certain ta...

Page 8: ...ts and Index tells you where to find information eas ily Extensive configuration help is available via the Tenor Configuraton Manager and Tenor Monitor online help systems or the Command Line Interfac...

Page 9: ...pter gives you a general overview of the Tenor DX including feature descriptions and capa bilities Specifically the following topics are covered A description of Tenor DX Features Capabilities Call Ro...

Page 10: ...r of VoIP channels is equal to half the number of PSTN channels The MultiPath Switch configuration enables connectivity between the customer equipment i e PBX PSTN and VoIP Network The Gateway is main...

Page 11: ...ateway configurations Tenor Digital DX MultiPath Configurations Spans Available RJ 45 port for T1 E1 connection VoIP Channels Supported Usage DX2008 2 8 VoIP connections T1 E1 DX2016 2 16 VoIP connect...

Page 12: ...set all configuration parameters such as unit signaling and call type features as well as monitor the unit for alarms and call information In addition you can configure the unit via Command Line Inte...

Page 13: ...directly connected to the unit you are able to configure the unit via Command Line Inter face CLI Powerful System Monitoring There are many different ways to monitor the health of the unit including L...

Page 14: ...ple tion of each call typically for accounting purposes A CDR is a string of data that contains call information such as call date and time call duration calling party and called party Tenor DX may st...

Page 15: ...um network security NATAccess simplifies deployment by elim inating the need to place the Tenor on a public IP network Using NATAccess provides easy secure expansion between multiple VoIP sites In add...

Page 16: ...gure 1 3 Line Circuit Call Routing Trunk Circuit Originated Calls A call coming from a Trunk Circuit may be switched to either the data network as a VoIP call a Line Circuit or trunk typically for con...

Page 17: ...red as a local phone number the call will be sent to a Line circuit for termination otherwise the call is considered a Hop Off call and the Tenor sends it out through a Trunk Circuit span typically co...

Page 18: ...Line Circuits Hop Off Directory Number A Hop off PBX call travels over IP and then hops off into the pub lic network PSTN on the distant side to reduce or eliminate public toll charges also known as...

Page 19: ...3 digit dialing plan through the Tenor DX you are able to configure the unique pattern dialing plan structure including number length You are able to configure which dial plan to use for incoming and...

Page 20: ...oints controlled by a Gatekeeper Endpoints can be gate ways i e Tenor DX terminals and or multipoint conferencing units MCUs Endpoints establish control channels with a gatekeeper for registration adm...

Page 21: ...ment accounting billing and charging Gatekeepers also provide call routing services Specifically the Tenor DX Gatekeeper provides the functions which follow Address Translation The gatekeeper translat...

Page 22: ...ter and request permission to enter the gate keeper s zone the gatekeeper will confirm or deny access to the network The gatekeeper authorizes network access and protects the integrity of the network...

Page 23: ...coding like H 323 And SIP supports user mobility using proxies and redirecting requests to your current location When configured for SIP the Tenor will act as a SIP User Agent Endpoint as defined in I...

Page 24: ...1 Chapter 2 Hardware Components This chapter tells you what is contained in your hardware package A description of each component is also included Specifically the following topics are covered Hardwar...

Page 25: ...ypes of signaling supported Channel Associated Signaling CAS and Common Channel Signaling CCS Adjacent port pairs i e 1 2 3 4 etc are configured by default to connect to each other power off bypass wh...

Page 26: ...sted in Table 2 2 Figure 2 3 DB 9 Female Connector Pin Order Table 2 2 Serial RS232 DB 9 Connector Pinouts Pin Signal Definition Color 1 TX Transmit Data White w orange 2 TX Transmit Data Orange 3 RX...

Page 27: ...2 4 P N 480 0049 00 13 Chapter 2 Hardware Components 7 N C No Connect 8 N C No Connect 9 N C No Connect Pin Function Description...

Page 28: ...t connected or other receive errors Green Indicates B channels are busy Off The port is empty LAN1 LAN2 LAN 2 is reserved for future use Link ACT Green On Link is good Flashing Line is working properl...

Page 29: ...AC outlet for power Power Switch Switch to turn power on and off Ground Screw An earth ground screw provided to connect to earth ground using a Ground Safety Cable if your AC power plug only has two...

Page 30: ...identify the proper connector to accommo date your specific networking requirements The RJ 45 ISO 8877 connector is the EIA TIA standard for Unshielded Twisted Pair UTP cable the wiring color codes a...

Page 31: ...tions are applicable to the RJ 45 cable provided Figure 2 6 RJ 45 10 100BT Connector Pinouts Table 2 5 RJ 45 10 100BT Connector Pinouts Pin Signal Definition Color 1 TX Transmit Data White w orange 2...

Page 32: ...een The color specifica tions are applicable to the RJ 45 straight cable provided Figure 2 7 RJ 45 T1 E1 PRI Connector Pinouts Table 2 6 RJ 45 Connector Pinouts for T1 E1 PRI Pin Signal Definition Col...

Page 33: ...icable to the RJ 45 crossover cable provided Figure 2 8 RJ 45 Crossover Cable Pinouts Table 2 7 RJ 45 Connector Pinouts for T1 E1 PRI 1 8 port Pin Signal Definition Color for Connector 1 Color for Con...

Page 34: ...Figure 2 9 and Figure 2 10 Figure 2 9 DB 9 Male Connector Pin Order Figure 2 10 DB 9 Female Connector Pin Order Figure 2 11 DB 9 Connector Pinouts Table 2 8 DB 9 Connector Pinouts Pin Function Descrip...

Page 35: ...hapter gives you installation instructions as well as how to position the Tenor DX successfully within your network Specifically the following topics are covered Installation Connection Install Ground...

Page 36: ...t exceed the temperature and humidity guidelines outlined in Appendix A Technical Specifications Avoid exposing the chassis to excessive vibrations Mechanical loading of rack should be considered so t...

Page 37: ...ou received with the rack Required Materials 19 rack not included with system 8 32 x 3 8 screws qty 2 included with system screws as required by your rack manufacturer Install the chassis in a rack as...

Page 38: ...the wall Pre installation Guidelines Ensure the wall is level and stable Do not attach the unit to a temporary wall Ensure the wall mounting area is within cord distance of the power outlet Required M...

Page 39: ...w included with the package See Figure 3 3 3 Position and attach the other mounting bracket using a screw existing in the system and the remaining screw in the package See Figure 3 3 Figure 3 3 Wall M...

Page 40: ...ther end of the RJ 45 cable to your PBX See Chapter 2 Hardware Components for the RJ 45 cable pinouts you can use to acquire another cable or adapter that may be required to connect your specific PBX...

Page 41: ...e for specific configuration information Figure 3 5 Connect to Trunk Interface 1 Plug one end of the straight through RJ 45 cable into one of the eight network ports on the front of the unit The cable...

Page 42: ...AN 1 is available for use LAN 2 is reserved for future use Figure 3 6 Connect to Ethernet Hub Switch 1 Plug one end of the grey or white RJ 45 Ethernet cable into the port labeled LAN 1 2 Plug the oth...

Page 43: ...ow it is assumed you are connecting to a Windows PC Figure 3 7 Connect to PC Com Port 1 Insert the male end of the DB 9 cable into the port labeled Console See Chapter 2 Hardware Compo nents for RS 23...

Page 44: ...ill need to connect the grounding screw to a Ground Safety Cable which can then be connected to an approved safety earth ground Connect the Ground Safety Cable as follows 1 Unscrew the existing screw...

Page 45: ...power cord to an AC outlet 2 Locate the on off switch on the back of the unit and click the switch to On The unit will power up and the LEDs will flash and turn off the power LED will remain lit For...

Page 46: ...sign the IP address will be the same but the software specific instructions will be different Consult the applicable documentation for more information You can re configure the IP address using the pr...

Page 47: ...uter which routes packet data outside of your LAN and enter its IP address 18 A message will appear on the screen Tenor Digital Ethernet Interface successfully configured The Tenor will restart using...

Page 48: ...security purposes Step through each of the following parameters and enter the correct values for your installation IP address Subnet Mask and Default Gate way 14 At the Quintum prompt type ei to reac...

Page 49: ...00 13 3 15 Chapter 3 Installation Load Software Upgrade To upgrade the software download the upgrade from the CD ROM you received with the unit or download the latest software documentation from www...

Page 50: ...rted Tenor Configu ration Manager Tenor Monitor This chapter tells you how to get started configuring and monitoring the Tenor DX through the Tenor Config uration Manager and the Tenor Monitor Overvie...

Page 51: ...on any PC you simply designate the IP address for the Tenor product i e Tenor DX on which you would like to configure or perform monitoring functions The Tenor Configuration Manager and Tenor Monitor...

Page 52: ...h sig naling and trunk group information Getting Started with Configuration This section gives instructions for getting started with the Tenor Configuration Manager For detailed infor mation about the...

Page 53: ...ich you would like to view call events Call Detail Record CDR Monitor Through the CDR Monitor you are able to view the Call Detail Record for each call including the call connect disconnect times call...

Page 54: ...0 13 5 1 Chapter 5 Getting Started Command Line Interface CLI This chapter tells you how to use access and use the CLI Specifically the following topics are included CLI Description Access CLI Configu...

Page 55: ...Groups These can be added or removed as necessary you are able to assign an identifier to each option you create For example when creating a new ISDN signaling group you may assign the name 5ESSPRI F...

Page 56: ...order to make it function correctly Telnet Connection Once the Tenor DX has been initially configured with an IP address network and is connected the easiest way to connect to the Tenor DX and use the...

Page 57: ...ch as Tenor DX 1 6 Click Ok 7 Choose a connection port on your PC from the Connect Using drop down list box i e Direct to Com 1 Click Ok The Com 1 properties window will be displayed 8 From the Bit Pe...

Page 58: ...nd Line Interface Configuration via CLI Once you are connected to the Command Line Interface you can configure the system as well as perform diagnostics and monitor system information For specific inf...

Page 59: ...etail Recording This chapter tells you how to display and understand the Call Detail Recording CDR feature Examples are included later Specifically the following topics are included Overview CDR Descr...

Page 60: ...view CDRs for the Tenor DX unit through the Command Line Interface CLI or through Tenor Monitor The information for accessing CDRs via CLI is detailed in this chapter see the Tenor Configuration Mana...

Page 61: ...software components to cre ate billing reports view call records and generate daily weekly monthly statistics reports The last 9600 CDRs generated are stored by the Tenor DX unit in a circular buffer...

Page 62: ...the CDRServer s Used when the Tenor DX establishes connection with CDR server CDRPassWord Password to be used by the CDR server s CDRFormat This configuration parameter command is used to choose whic...

Page 63: ...h the CDR server and the Tenor DX unit it will be able to establish a TCP IP session with the server on its own Setup CDR Server and assign password Before the CDR server can collect CDRs you must ins...

Page 64: ...ill be configured to either 9002 9003 9004 or 9005 see the Command Line Interface user guide for specific information Whether the Tenor DX unit establishes the connection with the CDR server or the CD...

Page 65: ...all ID 17325551212 Called Number 15 Duration 20000207062812 Call Initiation Time 20000207062815 Call Connected Time 2000020706283030 Call Disconnected Time 16 Cause Code 208 226 140 57 Local IP Addres...

Page 66: ...igits for hour mm 2 digits for minutes ss 2 digits for seconds Cause Code The Q 931 cause value assigned if the call is not connected Possible common entries are listed below This field will be blank...

Page 67: ...all is switched from VoIP to circuit The entry will be in the following format yyyymmddhhmmss where yyyy 4 digits for year mm 2 digits for month dd 2 digits for day hh 2 digits for hour mm 2 digits fo...

Page 68: ...aps around at 4 294 967 295 When a Tenor unit resets the sequence number starts from 1 again If the system has a problem and loses connectivity the CDR server can send the Tenor DX unit the last Call...

Page 69: ...entifies which device interface the call came in on Valid entry 1 PBX 2 PSTN This field will be empty if the call is an incoming VoIP call Incoming Channel If the call is incoming this field identifie...

Page 70: ...nts The number of bad quality events that occur during a VoIP call This number deter mines the overall quality of the call Autoswitch Flag The terminating side of the autoswitch call initially termina...

Page 71: ...7 1 Chapter 7 System Alarms This chapter tells you how to use the Alarm Manager to view and understand alarms generated by the system Specifically the following topics are included Overview Monitor A...

Page 72: ...occurred on channel number etc There are two alarm types displayed Active Alarms and Alarm His tory An Active Alarm list displays all the alarms still active on the system these alarms have not been c...

Page 73: ...d on Slot 1 or 2 Slot 1 refers to the system controller functions slot 2 refers to DSP functions Device Defines which device the alarm occurred on Always device 0 Digital Interface Defines which inter...

Page 74: ...g signal or frame has been lost Critical Layer 2 Down Indicates that Layer 2 protocol is down Critical Ethernet Disconnected Ethernet cable has been disconnected from the System Controller or CPU Card...

Page 75: ...em signal ing interfaces or other major operation Major File Missing in the File Server This alarm will be reported to the system when a partic ular voice prompt file is not found in the IVR Prompt Se...

Page 76: ...Credit time 1 RADIUS Server Credit time 6 sec RADIUS Server Invalid error code Informational Gatekeeper status Reports the status of the Gatekeeper Informational Miscellaneous information Miscellaneo...

Page 77: ...ll be displayed See section How to Read Alarms for field definitions Figure 7 1 Alarm sample Display Active Alarms 1 Through CLI access the Monitor prompt 2 Type alarm a The active alarms will be list...

Page 78: ...arm without a command following it both active alarms and the alarm history will be dis played Figure 7 3 Alarm History Sample IP Sequence Type Severity Desc Slot Device Digital Interface Channel Date...

Page 79: ...s well as how to maintain the health of your system You will find information about how to view the unit s LEDs as well as how to interpret the chassis alarms and check basic connections Specifically...

Page 80: ...fit snugly in each front panel jack Faulty connections may cause a number of network interfacing or connection issues If you suspect the problem to be on the network end contact your Central Office to...

Page 81: ...Line Inter face CLI cannot be established using Tel net The IP address of the Tenor DX unit may be incorrect Check Ethernet Cable Verify the IP address of Tenor DX Check the Default Gate way Subnet Ma...

Page 82: ...essary See Chapter 5 Getting Started Command Line Interface CLI Ping Unit Ping enables you to ping an IP address See Chapter 8 Diagnostics Maintenance Chapter 4 Getting Started Tenor Configuration Man...

Page 83: ...mation 2 Access the Config VOIPNetwork 1 prompt 3 Type setfactory You will be asked if you are sure you want to set the unit back to factory defaults 4 Type yes to confirm type no to cancel the restor...

Page 84: ...erface CLI as follows 1 Access the CLI through a Telnet session See Chapter 5 Getting Started Command Line Interface CLI for more information 2 Access the Config module 3 Type date followed by mm dd y...

Page 85: ...fice to verify proper operation After completing all troubleshooting maintenance procedures and reviewing the Common Symptoms Prob lems section you can contact the Customer Service Department at the f...

Page 86: ...A 1 P N 480 0049 00 13 Appendix A Specifications Approvals...

Page 87: ...tomatic Call Detection Voice Modem Fax Line Side PBX Trunk Side PSTN Connections Interface T1 E1 and Fractional T1 E1 with a built in CSU T1 E1 Signaling Channel Associated Signaling CAS Common Channe...

Page 88: ...cm Weight 7 2 lbs 3 24 kg Electrical Ethernet Standard 10 100Base T RJ 45 interface IEEE 802 3 PBX PSTN Standard RJ 45 Connectors 8 RJ 45 connectors for T1 E1 connection to the PBX and the digital ne...

Page 89: ...cifications Approvals Agency Approvals EMC FCC Part 15 Class A ICES 003 AS NZS 354 95 EN55022 98 Class A EN55024 98 EN61000 3 2 95 EN61000 3 3 95 TELECOM FCC Part 68 CS 03 TS016 TS038 TBR4 ISDN Layer4...

Page 90: ...on must be provided by the Telephone Company The REN Ringer Equivalence Number is used to determine the number of devices that may be connected to a telephone line Excessive RENs on a telephone line m...

Page 91: ...e to Quintum Technologies or to one of our authorized agents In the event service is required refer to the Technical Support insert for information If the device is causing harm to the telephone netwo...

Page 92: ...ertified connector assembly The customer should be aware that compliance with the above conditions may not prevent degradation of service in some situations Repairs to certified equipment should be ma...

Page 93: ...t under the terms of EU Directives 2002 96 EC and 2003 108 EC These directives are now being transposed into law by the individual EU member states At the end of life of this equipment it must be disp...

Page 94: ...S038 AS NZS 354 95 TBR4 ISDN Layer 1 3 GB9254 98 GB4943 95 GB17625 1 98 NOM 019 SCFI 1998 Manufacturer Quintum Technologies Inc Manufactured By Quintum Technologies Inc 71 James Way Eatontown NJ USA T...

Page 95: ...uit originated calls 1 8 virtual tie line 1 6 CDR connect with server 6 6 connect with Tenor 6 6 definition 6 3 output 6 7 overview 6 2 CLI access via serial port 5 4 access via Telnet 5 3 configurati...

Page 96: ...NATAccess 1 7 P PacketSaver 1 5 Password change 8 5 Ping command 8 4 R Rack install 3 3 RADIUS 1 6 Reset 8 5 RJ 45 2 7 RJ 45 Crossover 2 10 S SelectNet 1 4 SIP 1 15 Specifications electrical A 3 envir...

Page 97: ...A component used to termi nate a digital circuit i e T1 line at a customer site D Diagnostic Mode A CLI module which provides a set of utilities to perform diagnostic and testing procedures DSP Digita...

Page 98: ...IP network S SelectNet The next generation of TASQ technology the functionality monitors your data network for jit ter latency and packet loss and transparently switches customer calls to the PSTN whe...

Page 99: ...P N 480 0049 00 13 Glossary 3 Zone A group of endpoints e g gateways terminals etc in one corporate site...

Page 100: ...exclusive remedy shall be at Quintum s option i repair or replace ment of the software media or hardware that does not meet Quintum s Limited Warranty with new or like new software media or hardware...

Page 101: ...rrier is to be used who should pay for the shipment and any labels to be put on the package Unless otherwise directed by Quintum s Customer Services Representative please return product to Quintum at...

Page 102: ......

Reviews: