background image

CommWorks  5210
IP Telephony Manager

User Guide
Release 2.3
Part Number 10044879

Summary of Contents for CommWorks 5210

Page 1: ...CommWorks 5210 IP Telephony Manager User Guide Release 2 3 Part Number 10044879 ...

Page 2: ......

Page 3: ...CommWorks 5210 IP Telephony Manager User Guide Release 2 3 Part Number 10044879 ...

Page 4: ...5 Nov 1995 or FAR 52 227 14 June 1987 whichever is applicable You agree not to remove or deface any portion of any legend provided on any licensed program or documentation contained in or delivered to you in conjunction with this User Guide Unless otherwise indicated 3Com registered trademarks are registered in the United States and may or may not be registered in other countries 3Com the 3Com log...

Page 5: ...eper and Media Gateway Connectivity 23 Integrating with HP OpenView 24 Fixing Incorrect Maps 24 Removing HP OpenView Integration 25 Erasing IP Telephony Manager 25 Verifying the Installation 25 Linking CommWorks Objects 26 2 CONFIGURATION Management Station Configuration 27 Component Configuration 28 Launching the Configuration Tool 28 Synchronizing Network Time 28 Setting the Time Zone 28 Recordi...

Page 6: ...M 47 3 NAVIGATING AND USING THE SYSTEM Accessing IP Telephony Manager Window 49 File Menu 52 Open Submenu 52 Chassis Save All Submenu 52 Save Chassis NVRAM Submenu 53 Restore Chassis NVRAM Submenu 53 Save CFM Submenu 53 Restore CFM Submenu 53 Import SDL Files Submenu 53 Exit Submenu 53 View Menu 54 Other Side Submenu 54 LED Poll Info Submenu 54 Show Toolbar Submenu 54 Configuration Menu 56 Program...

Page 7: ...Authorized Access Lists 80 Displaying Inventory Information 81 A ERROR MESSAGES Overview 83 Invocation Errors 84 Command Line Target Selection 84 Chassis Restore 85 Chassis Save 85 Command Tool 86 Configuration Tool 86 Software Download 87 Test Tool 88 IP Telephony Manager Console 89 Tone Send Receive 89 Trap Destination 89 Execution Errors 90 All Applications 90 Chassis Restore 92 Chassis Save 93...

Page 8: ...ers 111 Tone Test 114 Send Tone Test S 114 Receive Tone Test R 115 Modem Tests 115 Query Current Test Status 115 Test Type T 115 Duration s 115 Device Save and Restore 116 Save Configuration 116 Restore Configuration 116 Software Download 117 Upgrade File Identification 117 Filename Prefixes 118 Software Download Progress Messages 118 Feature Enable 119 Inventory 120 Authorized Station Tool 121 CL...

Page 9: ...Table 6 Software Prerequisites 19 Table 7 Files added to HP OpenView Windows Directories 27 Table 8 Threshold Monitor Configuration Fields 36 Table 9 Upgrade Option Comparison 71 Table 10 Zip File Contents 71 Table 11 Sample Breakdown of SDL and NAC Filenames 117 Table 12 Filename Prefixes 118 Table 13 Software Download Progress Message Descriptions 118 Table 14 CLI Parameter Descriptions 122 ...

Page 10: ...anager Console Window 50 Figure 24 IP Telephony Manager Server Window 51 Figure 25 File Menu 52 Figure 26 Device List Window 52 Figure 27 Software Download Window 53 Figure 28 View Menu 54 Figure 29 LED Poll Info Window 54 Figure 30 Icon View Window 55 Figure 31 Configuration Menu 56 Figure 32 EdgeServer Pro Card Parameter Group Window 57 Figure 33 Example of HiPer DSP Modem Identification Configu...

Page 11: ...xi Figure 54 Community String Warning Message 79 Figure 55 Device Details Dialog Box 79 Figure 56 Inventory Window 81 ...

Page 12: ......

Page 13: ...talservice commworks com If the information in the release notes differs from the information in this guide use the information in the release notes Finding Information The following table lists the location of specific information Table 1 Content Description If you are looking for Go to System overview Chapter 1 Hardware and software requirements Chapter 1 Software installation procedures Chapter...

Page 14: ...ce Icon Description Icon Notice Type Description Information Note Information that contains important features or instructions Caution Information to alert you to potential damage to a program system or device Warning Information to alert you to potential personal injury or fatality May also alert you to potential electrical hazard ESD Information to alert you to take proper grounding precautions ...

Page 15: ...mer Service including support training code releases and updates contracts and documentation visit our website at http totalservice commworks com Refer to the Documentation CD ROM for information about product warranty Before contacting CommWorks Technical Support have this information available Contract number Problem description Symptoms Known causes CommWorks products Software and hardware vers...

Page 16: ......

Page 17: ...rk Application Cards NACs and Network Interface Cards NICs through a Network Management Card NMC installed on the CommWorks 5210 IP Telephony Platform Two protocols govern these management functions Simple Network Management Protocol SNMP between the NMC and the management station and a proprietary CommWorks protocol between the NMC and the managed cards IP Telephony Manager communicates with the ...

Page 18: ...nt System to monitor the status of all elements of the CommWorks platform and to act as an alarm server Use IP Telephony Manager to configure and monitor all the components of the CommWork s platform such as configuring operational parameters upgrading software and backing up and restoring configurations Table 4 lists the additional management software for your workstation Prerequisites Table 5 li...

Page 19: ...ve any previous versions of IP Telephony Manager This chapter assumes you are running the Korn shell For installation instructions for the C or Bourne shells refer to the readme file HP Platform HP 712 100 or higher Model 712 Workstation 64 MB RAM minimum 1 GB Hard Disk Space Space must be available on one partition Swap space is recommended to be at or above 200 MB CD ROM Drive Color Monitor Ethe...

Page 20: ...ager CommWorks recommends that you save the existing configuration data and log files Option 1 Option 1 To remove a previous version of IP Telephony Manager without erasing your existing IP Telephony Manager database files 1 Type cd TCMHOME 2 Type Remove Option 2 To completely remove a previous version of IP Telephony Manager including all IP Telephony Manager database files 1 Type cd TCMHOME 2 Ty...

Page 21: ...o you wish to continue y n 9 Type y and then press Return The installation proceeds listing files as they are installed The following message appears to indicate the installation has completed successfully TCM installation is complete You can now enable HP Overview autodiscovery on your system Setting PATH and LD_LIBRARY_PATH Before you can start IP Telephony Manager you must add TCMHOME to the PA...

Page 22: ... not appear set and export the paths according to the instructions in this chapter For a complete description of the menus on the GUI refer to Chapter 3 Navigating and Using the System Connecting to Entities CommWorks IP Telephony Manager lets you configure and monitor any CommWorks IP Telephony entity for example the Media Gateway Gatekeeper Accounting Server Billing Support Server on your system...

Page 23: ...er to Media Gateway connectivity use the following procedure 1 Using IP Telephony Manager Console window select the edge server card 2 On the menu bar select Performance and then Performance Monitor The Select Entity window appears 3 Select the entity 3Com Gateway and then click OK The Performance window appears Figure 1 Performance Window 4 Select Gatekeepers from the Functional Group 5 Select Cu...

Page 24: ...tegration files cd TCMHOME ovw 4 Install the integration files Install You can run the TCMHOME ovw Install script at any time You do not need to run TCMHOME ovw Remove before running TCMHOME ovw Install again HP OpenView integrates the IP Telephony Manager icons this lets you access IP Telephony Manager from HP OpenView Fixing Incorrect Maps If you populate CommWorks devices in OpenView before you...

Page 25: ...CMHOME ovw Remove r While all CommWorks files are removed from HP OpenView no changes are made to the runtime databases One of the primary purposes of removal is to prepare for a new installation Erasing IP Telephony Manager To erase IP Telephony Manager from HP OpenView replace the current maps with new ones You can also delete and rediscover all the CommWorks devices from each map Verifying the ...

Page 26: ...ony Manager use the following procedure 1 Type cd OV_BIN ovstart ovw 2 Go to the chassis to be linked and then click on it 3 Right click and select Symbol Properties from the pop up menu 4 Under Behavior click Execute 5 Under Application Action click USRRobotics USRVFPD 6 Click Target Objects click Add and then click OK 7 Click OK on the window that appears 8 Double click the object with the chass...

Page 27: ...ic term edge server to refer to either the edge server card or the EdgeServer Pro card Management Station Configuration You should not need to configure your management station after installing IP Telephony Manager for UNIX IP Telephony Manager adds the following files to locations as set up in OV_BIN ov envvars sh Table 7 Files added to HP OpenView Windows Directories Category File location Field...

Page 28: ...eper SIP Proxy Server and Back end Server to Greenwich Mean Time GMT and use the Network Time Protocol NTP on all system components Setting the Time Zone For each Gatekeeper SIP Proxy Server and Back end Server in the IP telephony network set the time zone to GMT 1 From the Windows desktop click Start then Settings and then click Control Panel 2 Double click Date Time The Date Time Properties wind...

Page 29: ...parameters must be set for the HiPer NMC card in each Media Gateway chassis the Gatekeepers SIP Proxy Servers and the Back end Servers All Media Gateway chassis components are automatically synchronized through the controlling HiPer NMC after it is configured for NTP Setting the NTP Parameters for the HiPer NMC For the HiPer NMC card in each Media Gateway chassis do the following 1 Using IP Teleph...

Page 30: ... Manager open the targeted server 2 Select the server icon 3 Select Configuration then Programmed Settings from the IP Telephony Manager Console window 4 Select 3Com SNMP Agent from the Select Entity drop down list 5 Click OK 6 Select Network Time Protocol A window similar to the following appears Figure 3 Server Network Time Protocol Window 7 Enter the Primary and Secondary NT IP addresses refer ...

Page 31: ...ccurs for the NMC to invoke the appropriate response because these responses are programmed into the NMC When there are thresholds for an event they must be programmed through the Configuration Tool For example the Connection Time Limit Expired event requires that you specify the Connection Time Limit threshold AutoResponse Configuration To define the automatic responses 1 Click one or a group of ...

Page 32: ...ameters window displays Setting Authorized Stations The chassis Network Management Card NMC contains an authorized access list that lets you limit management capability to specific management stations on your network After you have created entries in the authorized access list only those management stations can send SNMP requests to that device To set up an authorized access list 1 Open a console ...

Page 33: ...letion Window For information about setting the network mask refer to Defining a Range of IP Addresses for Authorized Access later in this chapter 5 Click Add to add additional entries for other workstations you want to grant management access 6 Repeat these steps for each device on your network 7 If you changed the authorized stations on the Gatekeeper SIP Proxy Server or any of the Back end Serv...

Page 34: ...g provides local monitoring of any MIB object s value and establishes threshold levels for which events can be generated You can select which objects to monitor and designate the threshold levels Threshold values can be provisioned independently to issue events if the actual values cross the thresholds This is different from trap filtering which describes how to configure the frequency of the trap...

Page 35: ...Threshold Monitoring Configuration 35 Figure 9 Parameter Group Selection Window The Threshold Monitor Configuration window appears Figure 10 Configuring Thresholds Window ...

Page 36: ...0 sec 15 sec 30 sec 1 minute 15 minutes 30 Minute Threshold Type Type of the collection None Delta The difference between the start and the end of the period is used Absolute The actual value is used Threshold Alarm Value Threshold which if crossed results in a trap An integer value If you set the Threshold Type to Absolute a trap is sent when the current value is greater than the integer value yo...

Page 37: ...he threshold object If an object is not active then it has a state of none If an object is above threshold then this object will show that state If an Object has cleared the threshold then it will show that state If an object is not a part of the CommonAgent the thresholdState will become invalid If an object is not internally accessible then it will have a state of Inaccessible This is a read onl...

Page 38: ...URATION Figure 11 Selecting an Entity Window 4 From the Parameter Group Selection window select Threshold Monitor Configuration Figure 12 Parameter Group Selection Window The Threshold Monitor Configuration window appears ...

Page 39: ...arameter 39 Figure 13 Configuring Thresholds Window 5 Configure the fields in the Configuring Threshold window as needed Refer to Table 8 Click Set 6 Set Threshold Row Status to createAndGo As shown in the following figure ...

Page 40: ... 4 for more information Editing a Threshold Parameter To edit a parameter that is being monitored 1 Open a console window for the device where the threshold is going to be edited For the Media Gateway you need to select the edge server card 2 From the Configuration menu click Programmed Settings 3 Select the 3COM SNMP SubAgent from the Select Entity window For Back end Servers and the Gatekeeper s...

Page 41: ...meter 41 4 From the Parameter Group Selection window select Threshold Monitor Configuration Figure 16 Parameter Group Selection Window The Threshold Monitor Configuration window appears Figure 17 Configuring Thresholds Window ...

Page 42: ...s Window 8 Click Set 9 If you changed the threshold parameters on the Gatekeeper SIP Proxy Server or any of the Back end Servers you must restart the SNMP agent Refer to Restarting Other Entities in Chapter 4 for more information Threshold Traps IP Telephony Manager issues the following traps depending on the Threshold event severity configured Threshold Warning Threshold Critical Threshold Inform...

Page 43: ...access memory NVRAM The Media Gateway s current configuration can be saved to its NVRAM and later retrieved through a direct command or by resetting the component NMC Save Chassis to NVRAM An entire device s configuration can be saved to the NMC NVRAM Saving Chassis Configurations from CFM This feature lets you save the configurations of every component of a device to a file for example the config...

Page 44: ...x option progress is reported as status messages on screen For more information refer to Appendix B Command Line Interface The Chassis Save Progress window appears 3 When the save is completed click OK Restoring a Chassis Configuration from NVRAM To restore a Media Gateway chassis configuration from NVRAM using IP Telephony Manager 1 From the IP Telephony Manager Console window select File menu an...

Page 45: ...ed click OK Component Save to NVRAM Some device components such as modems store their settings in their own NVRAM and use them for power on and reset defaults To save a component s settings to NVRAM 1 Select the component whose configuration you are saving on the IP Telephony Manager console display 2 Select Configuration from the IP Telephony Manager Console window 3 Select Action Commands from t...

Page 46: ...is configuration to that device by using the Restore Chassis from NVRAM command To execute the Save Chassis to NVRAM and Restore Chassis from NVRAM commands follow this procedure 1 Select the NMC card or management module from the IP Telephony Manager console window 2 Select Actions Commands from the Configuration menu The Command window appears 3 Select Save Chassis from NVRAM or Restore Chassis ...

Page 47: ...us messages on screen For more information refer to Appendix B Command Line Interface The Chassis Save Progress window appears 4 When the save is completed click OK Restoring a Configuration from CFM Use the following procedure to restore the configuration of the Media Gateway chassis Gatekeeper SIP Proxy Server or Back end Server to the Configuration File Manager CFM using the IP Telephony Manage...

Page 48: ...e and you are not using the x prefix option progress is reported as status messages on screen For more information refer to Appendix B Command Line Interface The Chassis Restore Progress window appears 3 When the save is completed click OK 4 Restart the SIP Proxy server to ensure that the Back end server addresses from the restore are used Refer to the CommWorks 4220 SIP Proxy Server Guide for mor...

Page 49: ...hony Media Gateway The server menus are similar to the windows described here Accessing IP Telephony Manager Window There are two main menus in the IP Telephony Manager One is for the Media Gateway chassis and the other one is for the Back end Server s Gatekeeper or SIP Proxy Server To access the either main menu from the command line prompt type one of these commands xtcmvfpd or xtcmvfpd target c...

Page 50: ...just outside the LEDs to select the whole card For Network Interface Cards NICs click the connectors The card s identity appears to the left of the IP Telephony Manager Console window To select more than one channel or entity at a time hold down the Shift key You can select only one type of card at a time for example you can select two HiPer DSP Modem cards but not a HiPer DSP card and some other ...

Page 51: ... simply choose the command from the main menu The remainder of this section describes the functions located on the main menu As you can see the Chassis Console window and the Server windows contain the same menu items For ease of reference the IP Telephony Manager Console windows are used as examples It is noted when a drop down submenu is for the IP Telephony Manager Chassis Console only ...

Page 52: ... Figure 25 shows an example of the File menu from the Media Gateway Figure 25 File Menu Open Submenu The Open submenu displays the Device List window It lets you to access other devices on your VoIP system Figure 26 Device List Window Chassis Save All Submenu The Chassis Save All submenu saves to entire chassis configuration to NVRAM IP Telephony Manager Chassis Console only ...

Page 53: ...ve CFM Submenu The Save CFM Submenu saves the chassis or server configuration to a specified Configuration File Management CFM file Refer to Chapter 2 for more information about saving the Media Gateway chassis or the server from a CFM file Restore CFM Submenu The Restore CFM submenu restores the chassis or server configuration by using a specified CFM file Refer to Chapter 2 for more information ...

Page 54: ... The Other Side submenu displays the reverse side of the chassis This guide shows the front panel of the chassis Figure 28 shows the back of the Media Gateway chassis IP Telephony Manager Chassis Console only LED Poll Info Submenu The LED Poll Info submenu displays the status of the LED lights Figure 29 LED Poll Info Window Show Toolbar Submenu The Show Toolbar submenu displays four icons ...

Page 55: ...splays the Command Tool dialog box for the chosen entity The second icon displays the Configuration menus The third icon displays the software download dialog box for the selected entity The forth icon displays diagnostics information for the selected entity ...

Page 56: ...Settings submenu displays the Configuration Tool window for the selected entity Parameters for a given component may be divided into several groups When you select the Configuration Tool the Parameter Group drop down box appears prompting you to select a parameter group You must select a group from the Parameter Group drop down box to continue Figure 32 shows an example of the CommWorks EdgeServer...

Page 57: ... component in slot 4 of a device has been selected This field is read only Card Level and Channel Level Parameter Groups IP Telephony Manager components have different parameter groups depending on whether you have selected the whole component or individual channels within a component After selecting a parameter group the configuration table appears and lists the current settings for each selected...

Page 58: ...lue is not changed in the component until you click Set After a Set is issued and the value is changed in the component the color returns to normal Other fields on the Configuration Tool menu are Window Title Bar Displays the target device IP address Get Button Triggers the SNMP Get operation for the selected parameter group The Get operation updates the display with the last saved values Set Butt...

Page 59: ... and channels that receives the command Category Some cards have different command categories If the selected targets have only one command category this box is grayed out Command to Execute Click this box to select the command you want to execute for the selected targets Force Command The card may be in a state where the selected command is normally rejected for example a modem in dial mode Check...

Page 60: ...dow contains the following fields Slot Each entry in the inventory data table is labeled by its slot number in the chassis Description Textual description of the displayed chassis Serial Number Serial number of the component Product Code Hardware product code of the component Hardware version Hardware version of the component DRAM KB Amount of dynamic RAM installed in the component Flash RAM Amoun...

Page 61: ...at Figure 36 shows the Inventory Print menu Figure 36 Inventory Print Menu The Inventory Print menu contains the following selections Print Target Selects whether to print to file or print to a printer Print Format Selects whether to print in postscript format or ASCII text format Print Command Postscript output is piped to this command The TCM_PRINT_COMMAND system parameter sets the default AutoR...

Page 62: ... space Monitor this gauge to avoid programming too many responses to a single event Available Responses Response Script The responses available for the event appear on the left and the responses configured for the event appear on the right Refer to AutoResponse Editing for information about configuring the list When you select a response that has descriptors a window of descriptor options appears ...

Page 63: ... define the trap s destination Figure 38 Fault Menu Trap Settings Submenu The Trap Setting submenu defines the traps for the specified entity Refer to the individual component user guide for information about setting this for your VoIP component Figure 39 Trap Setting Window ...

Page 64: ...tination Window Performance Menu The Performance menu lets you define the events on your system that IP Telephony Manager is to monitor Figure 41 Performance Window Performance Monitor Submenu The Performance submenu lets you define the events that you want IP Telephony Manager to monitor and it then report on those events You can also view historical information Refer to the individual component ...

Page 65: ...fter you click OK a table or graph appears showing the events you selected in real time mode Security Menu The Security menus lets you set the SNMP community strings and maintain the management capabilities at the selected station Figure 43 Security Menu ...

Page 66: ...ntain the management and security functions for the specified station The chassis Network Management Card NMC contains an authorized access list that lets you limit management capability to certain management stations on your network After you create entries in the authorized access list only those management stations can send SNMP requests to that device For information about setting the authoriz...

Page 67: ...u click Add the Authorized Stations Add dialog box appears Figure 45 Authorized Stations Add Window The Authorized Stations Add window contains the following fields Destination IP Displays the IP address of the authorized station Network Mask Displays the network mask for the destination IP address that defines a range of IP addresses for authorized stations Comment Displays a user entered descrip...

Page 68: ......

Page 69: ...n Unless otherwise specified this document uses the generic term edge server to refer to either the edge server card or the EdgeServer Pro card Upgrading Software You can upgrade the Media Gateway Gatekeeper SIP Proxy and Back end Server software using SDL 2 IP Telephony Manager uses SDL 2 functionality to perform upgrades through SNMP and TFTP using a file structure of dmf You can upgrade the sof...

Page 70: ... a Total Control NIC then transfer a file using any serial communications program that supports ZMODEM file transfers Refer to the Total Control 1000 Media Gateway Guide for more information SNMP MIB Browser and TFTP Server If the other two options are not available you can use an SNMP MIB browser and an TFTP Server to upgrade the firmware over an IP network SDL2 Utility The SDL2 utility runs on W...

Page 71: ...C 1 Extract the DMF files using the UNIX unzip command The following table lists the contents of the zip file 2 Copy the DMF files to the opt tcm data sdl directory Table 9 Upgrade Option Comparison Option Advantages Disadvantages IP Telephony Manager Includes all necessary tools Can perform remotely Can upgrade more than one card at a time Must install IP Telephony Manager first Serial Connection...

Page 72: ... download to you are prompted to select an entity 5 From the Configuration menu click Software Download IP Telephony Manager associates the files with the correct component Figure 46 Software Download Dialog Box 6 Click Browse A new window appears showing all the software files Figure 47 Software Download Select a File Window 7 Click the software version you want to send to the selected component ...

Page 73: ...performed for You can also launch the Command Tool from The network management platform network map either OVW Network Node Manager or SNM highlight the icon for a IP Telephony Manager Console device then select Actions Commands from the Configuration menu The UNIX command line use the xtcmcmd command specifying the target device IP address or hostname and the target slots and channels For complet...

Page 74: ...executed for the HiPer DSP card Figure 49 Example HiPer DSP Software Commands 1 Select the type of command you want to perform from the Command to Execute or Category drop down boxes 2 Click Execute at the bottom of the window 3 After executing the command compare the results with the color coded key below the status box ...

Page 75: ...hard restart To restart the Gatekeeper Back end Servers and SIP Proxy Server 1 Using IP Telephony Manager open the Media Gateway chassis 2 Click File and then click Open 3 Select the entity you are configuring from the Device List 4 Click OK 5 Select the entity icon 6 From the IP Telephony Manager Console window select Configuration then Actions Commands 7 When prompted to select an entity click W...

Page 76: ...r with an asterisk the entity selected will need to be restarted for the new values to be recognized If you need to restart the Gateway you need to restart the edge server Plugin Manager Service EPMS To restart the EPMS you can either restart the 3Com Gateway on IP Telephony Manager or stop and start the EPMS service from the service applet on the Windows NT machine Refer to the Total Control 1000...

Page 77: ...n 3 Select the Gatekeeper you are configuring from the Device List If the Gatekeeper is not listed see Connecting to Entities in Chapter 1 4 Click OK 5 Select the server graphic 6 Click Actions Commands from the Configuration menu 7 When prompted to select an entity click 3Com Gatekeeper in the list box and then click OK The Command Tool dialog box appears 8 Click Switchover Commands in the Catego...

Page 78: ...e devices and then on IP Telephony Manager For security reasons you cannot view the community strings through IP Telephony Manager To change the SNMP community strings on the devices from the IP Telephony Manager main window 1 Select Community Name from the Security menu Figure 52 Community Name Drop Down The Community Name dialog window appears Figure 53 Community Name Dialog Window 2 Enter the c...

Page 79: ...pened chassis until you specify the same community strings for IP Telephony Manager You have changed the SNMP community strings on the devices The next steps changes the community string for the IP Telephony Manager There are two methods available either through IP Telephony Manager or through the Command Line interface To change the IP Telephony Manager community string through IP Telephony Manag...

Page 80: ...ne Interface Clearing Authorized Access Lists If your management station is listed in the authorized access list 1 Open a console window for the device whose authorized access list you want to clear 2 From that console window click Security then Authorized Stations 3 Click the IP address to be cleared from the authorized access list and then click Delete Repeat this step for each entry until you h...

Page 81: ...ts on your VoIP system such as the serial numbers hardware and software version DIP switch settings and memory for each card To display inventory information from the IP Telephony Manager Console window click Configuration menu and then select Inventory The Inventory window appears with the information Figure 56 Inventory Window ...

Page 82: ......

Page 83: ...ssis Restore Chassis Save Command Tool Configuration Tool Software Download Test Tool IP Telephony Manager Console Tone Send Receive Trap Destination Execution Errors result from problems occurring after an application is successfully launched They include All Applications Chassis Restore Chassis Save Command Tool Configuration Tool Test Tool IP Telephony Manager Console Tone send receive Trap Des...

Page 84: ...ction is not allowed target specification The application cannot be invoked at the slot level Channel selection is not allowed target specification The application cannot be invoked at channel level e g software download Time slot selection is not allowed target specification The application cannot be invoked at time slot level True for all except commands Slot number out of range target specifica...

Page 85: ...nown and the application does not allow operation against unknown cards Mismatched targets slot number slot number The two slots contain cards that are not compatible for the present application s purposes Time slot selection not applicable target specification There is no time slot level support for the particular card for which a time slot specification was given e g the card is not a T1 or ISDN...

Page 86: ... that does not allow forcing The F option will be ignored Non GUI warning only Error invalid poll interval value value for p option The poll interval value given on the command line is not a positive integer Error cannot use E and q at the same time The user specified both a command and a command query This is not allowed Error No target specified The user did not supply at least an IP address or ...

Page 87: ... is not the same card type Only the first mismatch is displayed For tcmsdl an error message is displayed on the screen or output to the log file and then the utility automatically terminates For xtcmsdl clicking on the OK button of the dialog box terminates the utility All selected slots are empty Fatal error Selected slots do not contain a card For tcmsdl an error message is displayed on the scre...

Page 88: ...the SDL file was not For tcmsdl an error message is displayed on the screen or output to the log file and then the utility terminates For xtcmsdl click OK to bring up the Select Files dialog box and select the correct file filename does not match card type type Fatal Error tcmsdl Nonfatal error xtcmsdl This error occurs if the SDL file and the NAC file apply to different card types For tcmsdl an e...

Page 89: ...elephony Manager Console error message and what it indicates Error Too many targets specified The user specified more than one IP address host name There is more than one white space separated word in the target list Tone Send Receive The following are the Tone Send Receive error messages and what they indicate Error Invalid amplitude value value The amplitude level given on the command line is ou...

Page 90: ...expected argument argument A directive other than a m or d was seen on the command line Warning trap directives on GUI command line are ignored The user provided a m or d directives to the GUI xtcmtrap Execution Errors This section describes all error messages that can occur as after an application is successfully launched The execution errors categories listed here are All Applications Chassis Re...

Page 91: ...out or an SNMP protocol error If it is a protocol error the SNMP variable information in the error response can be seen in the IP Telephony Manager log e g syslog SNMP Get Next error An error occurred while IP Telephony Manager was issuing an SNMP operation either a timeout or an SNMP protocol error If it is a protocol error the SNMP variable information in the error response can be seen in the IP...

Page 92: ...estore error messages and what they indicate Configuration parse error specific error The chassis configuration file being restored is invalid and the restore will not occur Nonfatal configuration parse warnings are also produced File is not a Chassis Configuration File The user specified a file that does not begin with the CommWorks chassis configuration file header Can t access filename The user...

Page 93: ...n deadlock due to a system error or unusual race condition There is no matching configuration to save No working known cards in the chassis contain any configurable parameters to be saved Command Tool The following are the Command Tool error messages and what they indicate An unrecoverable error has occurred An SNMP error or other problem prevented the cycle of commands from being issued to all ta...

Page 94: ...ly The command will not be executed Slot number graphical selection of time slots in this card is not supported IP Telephony Manager is not able to present a selection dialog for the given card The card type is not supported by this particular version of IP Telephony Manager target Non command operation Reported in the command tool final summary when a modem test or other non command result is in ...

Page 95: ...files do not list any tests for the target device Invalid Test string The specified test is not in the list of valid tests Selected device is not a modem Test Tool may be invoked only against modems No Software Commands found The Test Tool could not locate the list of tests within the Software Commands group of the device configuration file This indicates a probable internal error or corrupt devic...

Page 96: ...uld not acquire ownership of chassis status file Launched processes will perform their own discovery This usually means that the user launching the IP Telephony Manager Console does not have write ownership of the chassis status information file for this chassis This can occur if a user such as root opens a IP Telephony Manager Console and exits it and other users then launch IP Telephony Manager ...

Page 97: ...ts which will be ignored Warning only Test in progress Stop it before exiting Issued in a Yes No dialog when user quits from window frame while a tone test is in progress GUI warning only Trap Destination The following are the Trap Destination error messages and what they indicate Invalid IP address ip addr The IP address entered is not a valid dot notation IP address or host name in the host data...

Page 98: ...entered as data Non GUI warning only Software Download The following are the Software Download error messages and what they indicate IP Telephony Manager Discovery Error Device not responding Fatal error The Software Download utility was unable to discover some or all of the cards in the chassis For tcmsdl an error message is displayed on the screen or output to the log file and then the utility a...

Page 99: ...s wrong software type filename has a crc error Fatal Error tcmsdl Nonfatal error xtcmsdl This error occurs if the internal header or the SDL or NAC file is incorrect For tcmsdl an error message is displayed on the screen or output to the log file and then the utility terminates For xtcmsdl click OK to bring up the Select Files dialog box and select an uncorrupted SDL or NAC file If one is not avai...

Page 100: ...et card s Flash ROM is not erased within the specified timeout 600 seconds For tcmsdl an error message is displayed on the screen or output to the log file and then the utility automatically terminates For xtcmsdl clicking the OK button of the dialog box terminates the utility TFTP error Fatal Error This is a series of errors that can occur when the Software Download utility is overwriting the tar...

Page 101: ...Telephony Manager Console Configuration Actions Commands Set Trap Destination Monitoring SNMP Parameters Tone Test Modem Tests Device Save and Restore Software Download Feature Enable Inventory Authorized Station Tool AutoResponse General Syntax The following command parameters are available for all utilities x command l logfile h c readcomm C writecomm target Brackets indicate that the parameter ...

Page 102: ... modem go off hook you could simply send the following command xtcmcmd 192 78 203 68 First the device display appears allowing you to select targets for the command After you select your targets the Command window appears allowing you to select and execute the Off Hook command l logfile The filename for the log If omitted from the command line messages are sent to the screen by default handled as ...

Page 103: ...ess or hostname for the device on which the operation is to be performed Some utilities require a more specific target designation that includes slot and channel T1 cards also allow timeslot designations for some utilities The x command prefix requires only the IP address or hostname even if the command calls for specific slots and channels The following format is for an unlimited number of target...

Page 104: ...nly one type of component can be selected at a time For example you can select all HiPer DSP channels but you CANNOT select a HiPer DSP channel and a T1 DS0 Target Examples 193 77 205 45 193 77 205 45 S3C4 S4C1 S5C2 4 193 77 205 45 S3 12C1 4 scotty S17 scotty S1C2T2 12 IP Telephony Manager Console To launch the IP Telephony Manager Console use one of the following commands xtcmvfpd or xtcmvfpd tar...

Page 105: ... parameters for the tcmget and tcmset commands are described below Parameters are shown in parenthesis after the flag name as appropriate c readcomm SNMP read community string C writecomm SNMP write community string h Displays this help message l logfile Log file for system diagnostic messages GUI default log to UNIX syslog CLI default stderr Specify hyphen to reverse these two behaviors z Disable...

Page 106: ...lename target This is most appropriate if there is only one current target being retrieved F This flag is available in the tcmget command only List full name of each parameter in the result output Otherwise the abbreviated parameter names supplied in the G argument will be used G group Selects a group followed by a list of parameters within that group which are to be retrieved for tcmget or set fo...

Page 107: ...is parameter is available in the tcmset command only Value of the parameter Parameters can be one of the following value types Integer Decimal numeric value Display String Printable characters suitably quoted Octet String Printable characters or an ASCII hex string beginning with 0x any string starting with 0x is assumed to be ASCII hex IP Address IP dot notation Object Identifier Must be a valid ...

Page 108: ...where c1 and c2 are decimal numbers and is a literal hyphen representing the location of channel s on the specified card s tcmget examples tcmget G NMC Identification Serial Number 192 77 203 74 S17 or using substring matching rules tcmget G nmc id serial number 192 77 203 74 S17 To list parameters in NMC tests and system group tcmget L G nmc tests G system group 192 77 203 74 S17 tcmset examples ...

Page 109: ...ommand substrings can mean different commands depending on which group is selected and whether the command is being executed at the slot level or channel level For example for a modem reset will perform a Hardware Reset at the slot level but a Software Reset at the channel level For a T1 card software will initiate a Software Download if the Hardware group is selected but a Software Reset if the S...

Page 110: ...Trap Destination Entries q Use the following command tcmtrap target q To Add a Trap Destination Entry a Use the following command notice that the target must be supplied tcmtrap target a ipaddr trapcomm comment Where ipaddr IP address of destination device to be added trapcomm Community string to supply with trap comment Insert a descriptive comment use shell quoting if necessary To Modify a Trap ...

Page 111: ... SNMP write community string h Displays this help message l logfile Log file for system diagnostic messages GUI default log to UNIX syslog CLI default stderr Specify hyphen to reverse these two behaviors z Disable set logging for this application target IP address or hostname in hosts database e g etc hosts of the chassis to be configured Monitoring SNMP Parameters This section describes how to mo...

Page 112: ...SNMP write community string z Disable set logging for this application L List all groups or if G is provided list parameters for each group specified as part of a G argument f filename Specifies the file to which to save the query result D delimiter Supplies field separators for a saved file If this is omitted fields are padded with spaces to make columns line up p Specifies time between polls num...

Page 113: ...supplied per group unless L list parameters by group is specified Parameter names are matched using substring comparison against the list of known parameter names within the currently selected group Substring matching has the same initial match priority and ambiguity rules as for group name matching target Specifies slots or channels to be issued commands Target has the following format IP host S ...

Page 114: ...fter exiting program s Specifies duration number in seconds Default 10 p Specifies time between polls num in seconds Default 1 Freq Specifies frequency Must be one of the following 404 1004 2804 Default 404 If specified frequency must appear after all other flags and before level and target Hz Optional ignored hz or Hz can be included for clarity Level Specifies amplitude integer in dBm Valid rang...

Page 115: ...t of tests Local Analog Loop Back Local Digital Loop Back Remote Digital Loop Back V54 Local Analog Loop Back V54 Remote Digital Loop Back Self Tests Test RAM Test ROM Test NVRAM Idle Phone Line Test A substring match to the beginning of a command string has precedence over internal matches For example local analog executes the Local Analog Loop Back test not the V54 Local Analog Loop Back test Ma...

Page 116: ...ple the utility saves the configuration data from the chassis with the IP address of 193 72 205 76 to a file called CHASSIS1 WHB Restore Configuration To run tcmrestore issue the following command tcmrestore f filename F target Where filename Filename of the whb file with the configuration to be restored F Force restore Restore configuration from whb file regardless of component mismatch For examp...

Page 117: ...le tcmsdl s qf020202 sdl n qf030000 nac 192 77 203 127 S11 12 This example uses the Quad Modem SDL file qf020202 sdl and Quad Modem NAC file qf030000 nac to update the modem code in slots 11 and 12 of the chassis with IP address 192 77 203 127 Upgrade File Identification SDL and NAC filenames contain identifying information about card type version level and file type The examples below show how to...

Page 118: ...n Server vn SIP Proxy Server Table 13 Software Download Progress Message Descriptions Message Description Additional Information BEGIN Software Download utility invoked Command is issued from the UNIX shell BDISC Begin chassis discovery IP address EDISC End chassis discovery IP address BCONN Begin connection to chassis IP address CONN Chassis connection established IP address BSDL Begin downloadin...

Page 119: ...ng C writecomm The SNMP write community string target An optional parameter that specifies the chassis device to be feature enabled If no target is specified the GUI presents the file selection dialog and proceeds with file based feature enable If the target is specified the GUI invokes manual feature enable The format for target is as follows IP host S slot SIG Software Download utility received ...

Page 120: ...comm d delimiter f filename target Where l logfile The log file for system diagnostic messages The GUI log file default is the UNIX syslog file The CLI default is stderr You can reverse these defaults by specifying a hyphen h Displays the command line parameters and the descriptions of the parameters and their flags c readcomm The SNMP read community string C writecomm The SNMP write community str...

Page 121: ...ol can be accessed using the following syntax x tcmauth l logfile h c readcomm C writecomm target q a ipaddr mask comment m ipaddr mask comment d ipaddr Where l logfile The log file for system diagnostic messages The GUI log file default is the UNIX syslog file The CLI default is stderr You can reverse these defaults by specifying a hyphen h Displays the command line parameters and the description...

Page 122: ...rder they appear in the command line These CLI parameters are described in the following table Table 14 CLI Parameter Descriptions Parameter Description q Lists all Authorized Station currently configured in the target NMC and then exits This overrides the specification of a m or d a Adds an Authorized Station to the Authorized Station Table Ipaddr IP address of the new station Mask New network ma...

Page 123: ...tch is case insensitive If no event is specified the GUI defaults to the entire list of AutoResponse events Chassis Level Events and Responses The following are the events and the responses to the events from the AutoResponse command Events PSU Voltage Out of Range PSU Failed Fan Failed HUB Temperature Out of Range Global Timer 1 Expired Global Timer 2 Expired Global Timer 3 Expired Global Timer 4...

Page 124: ...Configure Module from NMC NVRAM Configure Module from NMC Factory Defaults Remove Module from Service Restore Module to Service Test Module Reset Module Busy Out Module s Analog Phone Lines Restore Module s Analog Phone Lines The last two responses pertaining to analog phone lines are not available on slots that contain an unknown card type Modem Channel Level Events and Responses The following ar...

Page 125: ... Limit Exceeded Modem Watchdog Reset Management Bus Failure DTR True DTR False Modem Ring No Answer DTE Ring No Answer No Dial Tone No Loop Current Detected Global Timer 1 Expired Global Timer 2 Expired Global Timer 3 Expired Global Timer 4 Expired Packet Bus Active Packet Bus Lost Responses the N notation indicates that the response requires a parameter Generate AutoResponse SNMP TRAP ID N Delay ...

Page 126: ...ons of the parameters and their flags c readcomm The SNMP read community string C writecomm The SNMP write community string target An optional parameter that specifies the IP address or hostname of the NMC in which stations are being configured If no target is specified the GUI behaves as if h was the only parameter passed The format for target is as follows IP host S s range C c range S s range C...

Page 127: ...n the chassis C c range A decimal number or a range c1 c2 where c1 and c2 are decimal numbers separated by a literal hyphen representing the channel number s on the specified cards Only the IP address of the of the chassis needs to be specified If this is the case a graphical window will open showing the VFPD allowing the user to graphically select the desired targets ...

Page 128: ...128 APPENDIX COMMAND LINE INTERFACE ...

Page 129: ...e has been detected AS Autonomous System An independent system AUX Auxiliary Backup or acting as a redundancy on the system B8ZS Binary Eight Zero Code Suppression Line code type used on T1 and E1 circuits A special code replaces any eight consecutive zeros that are sent over the link This code is then interpreted at the remote end of the connection This technique guarantees ones density independe...

Page 130: ...pt or a shell script CMOS Complementary Metal Oxide Semiconductor CNG Comfort Noise Generation The process of adding white noise to the voice channel so the people know the connection is still good when neither party is talking CO Central Office The telephone company facility where the request for service comes through the switching equipment and the requests for service gets routed CommWorks IP T...

Page 131: ...lows network administrators to centrally manage and automate the assignment of Internet Protocol IP addresses in their organization s network DHTML Dynamic Hypertext Markup Languages A name for a set of programs that developers can use to create Web pages that update themselves on the fly Dynamic HTML makes your Web documents more interactive than HTML DIMM Dual Inline Memory Module Has a 10 highe...

Page 132: ...hat is activated to let the DCE know when the DTE is ready to send and receive data DTS Data Transformation Service Technology designed for bypassing functions for short hop line of sight applications It never converts to analog Its main use is in high volume data only applications in urban areas where line costs are higher ECC Error Correcting Code Code that determines whether line noise has caus...

Page 133: ...r is defined by the H 323 standard GRJ Gatekeeper Reject This is a call flow message GRQ Gatekeeper Request This is a call flow message GSM Global System for Mobile Communications The European standard for digital cellular service using slow frequency hopping and TDMA GW VoIP Media Gateway A CommWorks VoIP device that can interconnect networks with different incompatible communications protocols T...

Page 134: ...dard Architecture The most common bus architecture on the motherboard of a MS DOS based computer ISDN Integrated Service Digital Network A system that provides simultaneous voice and high speed data transmission through a single channel to the user ISDN is an international standard for end to end digital transmission of voice data and signaling ITG Internet Telephony Gateway A bridge between tradi...

Page 135: ...lic Land Mobile Network PLMN within a country NAC Network Application Card In the Total Control chassis this card is located in the front of the chassis It allows communication to the VoIP application NIC Network Interface Cards In the Total Control chassis this card is located in the back of the chassis It allows access to the network NMC Network Management Card The NMC provides the management of...

Page 136: ...mary Rate Interface is split into 23 B channels and one 64 Kbps D channel PRI is delivered over the same physical link as a T1 or 1 55 Mbps link In Europe PRI is split into 30 B channels and one 64 k bit second D channel and is delivered over the same physical link as an E1 PSI Power Supply Interface The card on the chassis that controls the power for the chassis PSTN Public Switched Telephone Net...

Page 137: ...ten used for flow control between a modem and serial port SCSI Small Computer System Interface The way the peripherals communicate with the computer s main processor SDL Signaling Data Link or Software Download SF Super Frame Common framing type used on T1 circuits SF consists of 12 frames of 192 bits each with the 193rd bit providing error checking and other functions SF is superseded by ESF but ...

Page 138: ... SS Silence Suppression A way to save on bandwidth by not transmitting the silences or gaps in conversation A voice compression process where the time when there is no voice being transmitted over the line during a conversation that space is filled with data and video transmission on the line SST Silence Suppression Threshold The limit of silence allowed on the voice transmission before data and v...

Page 139: ...aboratory that examines and tests items submitted by their manufactures for safety UNC Names Universal Naming Convention Names Naming conventions for file names or other resources beginning with indicating that they exist on a remote computer URJ Unregistration Reject This is a call flow message URQ Unregistration Request This is a call flow message UTP Unshielded Twisted Pair Four pair wire mediu...

Page 140: ...n Used primarily with T1 The insertion of a one bit to prevent the transmission of eight consecutive zeros on an active line When eight or more consecutive zeros are detected on the line the system considers the line inactive and releases the line ...

Page 141: ...65 changing 78 setting 66 component changing 52 configuration 28 Configuration 31 44 menu 56 configuration 31 component 28 configuration command line interface command configuration 105 Configuration Tool window elements 57 Configuration window 58 elements 57 configuring authorized access 66 Authorized Stations 32 AutoResponse 31 IP Telephony Manager 56 management station 27 parameters 76 restorin...

Page 142: ... 47 chassis 46 chassis configuration 47 command line 47 configuration 43 configuration NVRAM 44 restoring chassis CFM 53 restoring chassis NVRAM 53 restoring configurations 116 S Save CFM menu 53 save chassis NMC 46 Save Chassis NVRAM menu 53 saving chassis CFM 53 command line 45 47 configuration 43 configuration NVRAM 43 52 saving configurations 116 SDL 60 SDL file 53 SDL 2 69 SDL2 utility 70 sec...

Page 143: ......

Page 144: ...CommWorks Corporation 3800 Golf Road Rolling Meadows IL 60008 2001 3Com Corporation All rights reserved Printed in the U S A Part Number 10044879 ...

Reviews: