3Com 5210 manual

CommW orks 5210 IP T elephony Manager User Guide Release 2.3 Part Number 10044879[...]

[...]

CommW orks 5210 IP T elephony Manager User Guide Release 2.3 Part Number 10044879[...]

Copyr ight © 2 001, 3C om Corp oration . All r ights r eserv ed. No pa rt of th is docu mentat ion may be repr oduc ed in an y form or by any means or used to make any deriv ativ e work (such as translation, transformation, or adaptation) without written perm ission from 3Com Corporation . 3Com Co rporatio n reserve s the righ t to re vise this d [...]

C ONTENTS C ONTENTS A BOUT T HIS G UIDE Finding I nformation ............... ............. ............ ............. .................... ............. ............. ......... xi ii Convention s .......................... ................... ............. ............. ................... ............. ............. ...xi v Related Documenta tion [...]

vi Auto Resp onse ........ ............. ............. ................... ............. ............. ............. .................... .. 31 AutoRespo nse Conf iguration .. ............. ............ .................... ............. ............. ............. .. 3 1 Setting Au thorized S tations... ............. ............. ................[...]

vii 4 M AINTENAN CE Upgrading Software .............. ................... ............. ............. ................... ............. ............. ...69 Software Upgrad e Methods ... ............. ............. ................... ............. ............. ............. ...70 Upgrading the Softw are ... ............. ............ .............[...]

viii B C OMMAND L INE I NTERFA CE General Syntax ................ ............. ............. ................... ............. ............. ................... ....... 10 1 IP T elephon y Manager C onsole .... ............. ............ ............. .................... ............. ............. 10 4 Config uration ................. ..........[...]

ix L IST OF T ABLES Table 1 Content Descrip tion..... ................... ............. ............. ................... ............. .......... xiii Table 2 Notice Icon Des criptio n ................... ............. ............. ............. ................... .......... xiv Table 3 Text C onvention D escriptio ns.......... ............. ...[...]

x L IST OF F IGUR ES Figure 1 Performance Window .......................... ............. ............. ................... ............. .... 23 Figure 2 Media Gat eway Netw ork Time Protocol W indow .... .................... ............. .......... 2 9 Figure 3 Server Ne twork Time P rotocol W indow ............. ............. ............. ....[...]

xi Figure 54 Communi ty String Wa rning Mess age ......... .................... ............. ............. .......... 7 9 Figure 55 Device Deta ils Dial og Box .............. ............. .................... ............. ............. .......... 7 9 Figure 56 Inventory Wi ndow ................... ............. ............. ................... [...]

[...]

A BOUT T HIS G UIDE About This Guide conta ins an overview of the IP T el ephony Manager User Guide, describes wher e to fin d specific i nformation, li sts conventions and rel ated documentation, and expla ins how to contact CommWorks Corporation. This guide describes how t o install, configur e, and operate I P T eleph ony Manager , as well as ho[...]

xiv A BOUT T HIS G UIDE Conventions The followin g tables lis t conventions in this guide. Related Documentation The following documents contain i nformation about the components of th e CommWorks IP T elephony Platf orm: ■ Comm Works IP T elep hony S yste m Sof tware Ins talla tion Guid e ■ Comm Works IP T e lephon y O verview Guid e ■ Comm [...]

Cont act ing Comm Work s xv ■ CommWor ks IP T elephony Pa rameter (MIB) Ref erence Guide ■ CommWor ks IP T elephony T rap (Ala rm) Refer ence Guide ■ CommWorks 4007 SS7 Si gnaling Gateway Operation and Main tenance Gui de Contacting Co mmWork s For informati on about Customer S ervice, i ncluding support, training, c ode rel eases and updat e[...]

[...]

1 I NSTALLATION This chapter con tains an overview of IP T elephony Manager and install ation proced ures for UNIX. This chapter con tains the following topics : ■ Overview ■ Management W orkstation ■ Prer equisit es ■ Befor e Y ou Begin ■ Removing Pr evious V ersions ■ Installin g IP T elephony Manager ■ Starting IP T elephony Manage[...]

18 C HAPTER 1: I NSTALLATION The management st ation uses Management Infor mation Bases (MIBs) , defined for each car d in the hub, to issue commands to the NMC. The NMC executes the command s and obtains the resul ts using a pr oprietary CommWorks prot ocol. The NMC uses SNMP to send these res ults to the management station. The NMC communicates w[...]

Before Yo u Begin 19 T able 6 lists the softwar e requir ements needed to achie ve the best performance fr om IP T elephony Manager . If you a re installi ng HP OpenVi ew for the f irst time, temporarily disable autodiscove r y . Do not all ow OpenView to discover the devices on your network automat ically . This eases integra tion with IP T elepho[...]

20 C HAPTER 1: I NSTALLATION If you are using HP OpenView , you must ins tall it befor e you install IP T elephony Manager . If not, HP OpenV i ew does not integr ate correctly . Make sure IP T elephony Manager and HP OpenView are i nstalled on the same system. Remember to disabl e HP O penV iew autodiscovery before you do a fi rst time instal l/in[...]

Install ing IP Teleph ony Manager 21 8 From the command li ne prompt, type the fol lowing commands and press Return after each: TCMHOME=<installation directory> (for example, /opt/tcm) export TCMHOME mkdir -p $TCMHOME cd cdrom/cdrom0/tcm_sol (for HP, tcm_ux) ./install A message appears: The script will make adjustments, only as need ed, to sy[...]

22 C HAPTER 1: I NSTALLATION Starting IP T elephony Manager After yo u complete the installati on and modify the path statement, you can start IP T elep hony Manager . T o start the IP T elephony Manager , from the command line pro mpt, type one of these commands: # xtcmvfpd or # xtcmvfpd < target chassis IP address> The first command causes [...]

Connecting to Entit ies 23 T o view the e ntity aft er the it i s connected us ing IP T elephony Manag er: 1 Start I P T elephony Manager . 2 Clic k File and th en clic k Open from the IP T elephony Manger Consol e window . 3 Select the enti ty from the lis t. 4 Clic k OK . The entity appear s in graphical form. When selected, the entity is blue; w[...]

24 C HAPTER 1: I NSTALLATION Integrating with HP OpenView The IP T elephony M anager in stallation script instal ls OpenView integr ation files to the appr opriate OpenView Network Node Manager subdir ectories . OpenView in tegration occ urs as part of the IP T elephony Mana ger install ation, when the OpenView envir onmental varia bles are set bef[...]

Inte gra ting wi th HP Ope nVi ew 25 If CommW orks devices were popul ated in OpenView b efore IP T elephony Manager was instal led, the network map will not displ ay the CommWorks bitmaps corr ectly aft er IP T elephony Manager in tegration. Thi s occurs even if the CommWorks menu options ar e not enabled and the i sUSREntNetHub cap abilit y is n [...]

26 C HAPTER 1: I NSTALLATION Linking CommWorks Objects If you choos e to insta l l HP OpenView , you must install it befo re IP T elephony Manager . This lets you start IP T elephony Manager dir ectly from HP OpenView . T o link CommWorks objects in HP OpenView to IP T elephony Manager , use the following procedur e. 1 Ty p e : #cd $OV_BIN #./ovsta[...]

2 C ONFIGURATION This chapter des cribes how to configur e CommWorks IP T eleph ony M anager . This chapter con tains the following topics : ■ Management Stat ion Configuration ■ Component Configur ation ■ Synchr onizing Network Time ■ Auto Response ■ Setting Aut horized Stati ons ■ Defining a Range of IP Addresses f or Authorized Acces[...]

28 C HAPTER 2: C ONFIGURATI ON Component Configuration The IP T elephony Manager Console window is used to selec t target components whenever you are performi ng configuration, s ending commands, or upgrading component s through softwar e download. Launching t he Configuration T ool Ther e are t wo ways to la unch the Configura tion T ool: ■ From[...]

Synch ronizing Networ k Time 29 Selecting Pub lic NTP Servers 1 From a ny computer wit h internet acces s, access the following webs ite: http://www .eecis.udel.edu/~mi lls/ntp/cloc k1.htm 2 From th e website, r ecord the IP addr esses for t wo separate active servers. One is used as the primar y NTP server , and the other is used as the secondary [...]

30 C HAPTER 2: C ONFIGURATI ON 5 Enter the Primary and Sec ondary NTP IP Addr esses (r efer to Reco rdin g the NTP IP Addr esses ). 6 Set the Operational Mode t o Unicast . 7 Click Set . Setting the NTP Parameters for the Other Entiti es For each Gatekeepe r , SIP Proxy Serve r , and Back-end Server: 1 Using IP T elephony Manager , open the targete[...]

Auto Response 31 Auto Respo nse AutoResponse let s network managers define a set of act i ons (auto r esponse script) to be taken automaticall y when a speci fied event occurs in the chassis. The event may be speci fic to a particular modul e (NAC or NMC) in a given slot of the chassis , or specific to a particul ar entity (such as a singl e modem [...]

32 C HAPTER 2: C ONFIGURATI ON 3 Select the ev ent from the Event dr op-down list. 4 Select wha t you want the system to do when the selected even t occurs fr om the A vailable Responses lis t and click Add . The res ponse is added to the Responses Configu red list box. 5 Click OK . The res ponse scripts ar e loaded. Responses c an only be ad ded o[...]

Setting Authorized Stations 33 Figure 6 Author ized Stations Add W indow 4 In the Add dialog box, ent er the IP address fo r the workstation you ar e curr ently working fr om and click OK . The Authorized S tations Completi on window appears with the newl y added IP addres ses listed. Figure 7 Author ized Station Complet ion W indow For informati o[...]

34 C HAPTER 2: C ONFIGURATI ON Defining a Range of IP Addresses for Authorized A ccess Y ou can de fine a range of IP addr esses for aut horized acce ss by using the Network Mask fi eld in the author ized access list. The network mas k that you type in this fiel d masks the IP addr ess for t hat entry to define a range of aut horized IP addre sses.[...]

Threshol d Monitoring C onfiguration 35 Figure 9 Paramet er Group Se lection Window The Thr eshold Monitor Conf iguration window appear s. Figure 10 Confi guring Thresholds Window[...]

36 C HAPTER 2: C ONFIGURATI ON The followin g table contains the fiel ds and the values of the Configuri ng Thre shold window . Ta b l e 8 Thr eshold Monit or Configur ation Fields Field Name Description Possible Sele ctions Thresh old Object Objec t ID which is to be monito red. This h a s 4294 967294 at the end if an obje ct with multip le instan[...]

Addi ng a T hresho ld P aramet er 37 5 After you have set the trap t hreshold s on the Gatek eeper , SIP Pr oxy Ser ver , or any of t he Back-e nd S erv ers, you mus t restar t the SNMP age nt. R efer to Restarti ng Other Entities in Ch apte r 4 for mo re infor matio n. Adding a Threshold Parame ter T o ad d a par amete r to mo nito r: 1 Open a con[...]

38 C HAPTER 2: C ONFIGURATI ON Figur e 11 Select ing an Entity W indow 4 From the Parameter Gr oup Selection window , select Thre shold Monitor Configuratio n . Figur e 12 Paramete r Group Selection W indow The Thre shold Monitor Configurati on window appears.[...]

Addi ng a T hresho ld P aramet er 39 Figure 13 Confi guring Thresholds Window 5 Configur e the fie l ds in the Configuri ng Threshold window as need ed. Refer to Ta b l e 8 . Click Set . 6 Set Thr eshold Row Status to cr eateAndGo . As shown i n the foll owing figur e.[...]

40 C HAPTER 2: C ONFIGURATI ON Figur e 14 Adding Th reshold Parameters Window 7 Click Set . 8 If you changed the thr eshold parame ters on the Gatekeeper , SIP Proxy Serve r , or an y of the Back- end S erv ers, yo u mus t restart th e SNM P ag ent. R efer to Restarti ng Other Entities in Chapter 4 for mo re inform ation . Editing a Thr eshold Para[...]

Editin g a Threshold Parameter 41 4 From the Par ameter Group Select ion window , select Threshold Monitor Configuration . Figure 16 Para meter Grou p Selection W indow The Thr eshold Monitor Conf iguration window appear s. Figure 17 Confi guring Thresholds Window[...]

42 C HAPTER 2: C ONFIGURATI ON 5 Set Thr eshold Row Statu s to not ins serv ice . 6 Change the c onfiguration as you need, r efer to Ta b l e 8 , and click Set . 7 Set the Threshold Ro w Status to a ctive . The followin g figur e shows the Thr eshold Parameter dr op-down list. Figur e 18 Editing Thr eshold Parameter s W indow 8 Click Set . 9 If you[...]

Saving an d Restori ng Configurations 43 Saving and Restoring Configurations The Save configur ation utility perfor m s a discover y of the configuration of a device and sav es it to a file. Af ter it is saved t o a file, the Restor e configurat ion utilit y is used to restor e the configur ation to that device, or it can be used to apply the file [...]

44 C HAPTER 2: C ONFIGURATI ON Figur e 19 Save Cha ssis NVRAM Dialog Box 2 Enter or select t he .nvr fi le you ar e saving to and clic k OK . The default di rectory for .nvr files is : $TCMHOME/data/nvr am/. If you are saving or res toring from the comman d line and you are not using the x prefix opti on, progress is report ed as status messages on[...]

Saving an d Restori ng Configurations 45 Figure 20 Rest ore Chassis NVRAM Dialog Box 2 Enter or selec t the .whb file you are r estoring fr om and click OK . The defaul t dire ctor y for .nv r files is : $TCMH OME /data /nvr am/. If you ar e saving or rest oring from the command line and you ar e not using the x prefix option, pr ogress is repor te[...]

46 C HAPTER 2: C ONFIGURATI ON Not all components support the Sav e to NVRAM feature. For those that support t his feature , the HIPer DSP and NMC cards, you must select the right command type a nd group. For example, the modem software co m mand group is available onl y when you sel ect modems at the channel leve l, as opposed to select ing the wh[...]

Saving an d Restori ng Configurations 47 Figure 21 Save Chas sis CFM Dialog Box 3 Enter or selec t the .cfm file you ar e saving to and click OK . The defaul t dire ctor y for .nv r files is : $TCMH OME /data /nvr am/. If you ar e saving or rest oring from the command line and you ar e not using the x prefix option, pr ogress is repor ted as status[...]

48 C HAPTER 2: C ONFIGURATI ON Figur e 22 Restor e Chassis CFM Dialo g Box 2 Enter or select t he .cfm file you are restori ng from and c lick OK . The default di rectory for .cfm files is: opt/tcm/data/ cfm/tch. If you are saving or res toring from the comman d line and you are not using the x prefix opti on, progress is report ed as status messag[...]

3 N AVIGATING AND U SING TH E S YSTEM This chapt er describes th e menus in the I P T elephony Manag er . The function of the menus can vary dependi ng on the component, i f that is the case, then you are referr ed to that individual component ’ s user manual. This chapter con tains the following topics : ■ Accessing IP T elep hony M anager Win[...]

50 C HAPTER 3: N AVIGATING AND U SING THE S YSTEM Figur e 23 IP T elephony Manager Con sole W indow The IP T elephony Manager Console window cont ains a graphical repr esentation of the T otal Cont rol ch assis. The vi ew can be change d by the View menu to s ee the fr ont or ba ck of the ch assis. Select the are a of the chassis on the IP T elepho[...]

Accessin g IP Telepho ny Manager Wi ndow 51 Figure 24 IP T elephony Man ager Server W indow T o perform a function on t he Gatekeeper , SIP Proxy Se rver , or Back-end Server , click on the se rver icon and simply choose the command from the main menu. The r emainder of thi s section descr ibes the f unctions locate d on the main men u. As you can [...]

52 C HAPTER 3: N AVIGATING AND U SING THE S YSTEM File Menu The file menu is used t o open devices on the system, save and r estore configura tions, and to i mport Softwar e download fi les. Figur e 25 shows an example of the File menu from the Medi a Gateway . Figur e 25 File Menu Open Submenu The Open submenu displays t he Device List window . It[...]

File M enu 53 Save Chassis NVRAM Submenu The Save Chassis NVRAM sub m enu saves the Media Gateway chassi s configurat ion to a spe cific fil e on NVRAM. Refer to Chapter 2 for mor e informati on on saving the chassi s to NVRAM (IP T elephony Manager Chassis Console only). Restor e Chassis NVRAM Submenu The Restor e Chassis NVRAM submenu restor es t[...]

54 C HAPTER 3: N AVIGATING AND U SING THE S YSTEM Vie w Me nu The View menu lets you adjust the way IP T elephony Manager display s the console or server window . Figur e 28 Vi ew Me nu Other Side Submenu The Other Side submenu displ ays the r everse s ide of the chas sis. This guide shows the front p anel of the chas sis. Figu re 28 shows the back[...]

View Menu 55 Figure 30 Icon View W indow The first ic on displays the Command T ool dialog box fo r the chosen entity . The second icon display s the Configuration menus. The thir d icon displays the softwar e download dialog box for the sel ected entity . The forth icon dis plays diagnostics informat ion for the selecte d entity .[...]

56 C HAPTER 3: N AVIGATING AND U SING THE S YSTEM Configuration Menu The Configurat ion menu is used to set the V oIP chassis to your envi ronment req u ire m e nt s. Figur e 31 Configur ation Menu Progr amm ed Settings Submenu The Prog rammed Settings submenu display s the Configuration T ool window for the sele cted entity . Parameters for a give[...]

Configu ration Menu 57 Figure 32 EdgeSer ver Pro Car d Parameter Gr oup Wi ndow The Configurati on T ool menu contains the foll owing fields: ■ Selected targets — T he n ame of th e targe t to be c onf igured from thi s menu that was selecte d from t he IP T elephony Manager chass is or server . Displays the slot a nd channel numbers of the sel[...]

58 C HAPTER 3: N AVIGATING AND U SING THE S YSTEM Figur e 33 Example of Hi Per DSP Modem Identifi cation Configuration T able Click on the cel l with the setti ng you want to edit. If a value is r ead-only , the cursor c hanges to the “ No ” sign when plac ed over the cel l. If the value can be modified, an arr ow appears in the value fiel d. W[...]

Configu ration Menu 59 ■ Exit — Closes the window and displays the p revious wi ndow . ■ Adjusting Column Width — Y ou can a djust the c olumn width using t he mouse. Plac e the cursor over the c olumn divisor line until it changes to a bar and arr ow , then click and dr ag the line left or right. Action/Commands Submenu The Action/Commands[...]

60 C HAPTER 3: N AVIGATING AND U SING THE S YSTEM ■ Execute — Exec utes the selected command for the sel ected targets. ■ Close — Close s the Command T ool window . Software Download Submenu The Softwar e Download submenu displays the fil es to be downloaded for the specifi ed entity . Y ou then selec t the files you nee d to be downloaded [...]

Configu ration Menu 61 For example, 0000000010010000 means t hat DIP switches 8 and 5 ar e ON and all others ar e off. ■ Software V ersion — V ersio n of sof tware cu rrently in stalle d in th e component's f lash RAM. Y ou can perform the following ta sks from this window: ■ Save — Sa ves the inventory data tab le to an ASCII text fil[...]

62 C HAPTER 3: N AVIGATING AND U SING THE S YSTEM Figur e 37 Auto Response Window The AutoRespon se dialog box contains the foll ow ing fiel ds and buttons: ■ Selected T argets — This box shows the slot(s) or channel(s) select ed in the chassis di splay . ■ Event — Click thi s box to select an event. If you sel ect an event that r equir es [...]

Fault Menu 63 Fault Menu The Fault menu lets you enable /disable traps and de fine the trap ’ s dest ina tion. Figure 38 Faul t M enu T rap Settings Submenu The T rap Setting submenu define s the traps for the specifi ed entity . Refer to the indiv idual component user guide fo r information about setting t his for your V oIP component. Figure 39[...]

64 C HAPTER 3: N AVIGATING AND U SING THE S YSTEM T rap Destinati on Submenu The T rap Destinat ion submenu defines and modifies wher e the traps ar e sent. Refer to the indi vidual component user guide for inf ormation about sett ing this f or your V oIP component. Figur e 40 T rap Destin ation W indow Performance Menu The Perform ance menu lets y[...]

Security Menu 65 Figure 42 Perf ormance Monitor Menu After you cli ck OK, a table, or graph appe ars showing the events you selec ted in real time mode. Security Menu The Securit y menus lets you se t the SNMP communit y strings and mai ntain the management c apabilities at the select ed station. Figure 43 Securi ty M enu[...]

66 C HAPTER 3: N AVIGATING AND U SING THE S YSTEM Community Names Submenu The Community Names submenu lets you set the SNMP community strings. The IP T elephony Manager defaul t value for SNMP community string is publi c for r ead only and pr iva te for read -wri te. T o cha nge the def ault va lues , you must first change the c om munity s tring o[...]

Security Menu 67 ■ Modify — Brin gs up a dialog box for changi ng the network mask or com men t for th e sele cted d evi ce. (Y ou mu st sel ect an entry from the lis t befor e using thi s button.) ■ Del ete — Del etes the s elected en try . When you click Add , the Authoriz ed Stations Add dialog box appears. Figure 45 Author ized Stations[...]

[...]

4 M AINTENANCE This chapt er describes h ow to use I P T elephony Manager to upgrade s oftware and perform general maintenanc e tasks on CommW orks IP T elephony Plat for m ca rds. This chapter con tains the following topics : ■ Upgrading Softwar e ■ Command T ool ■ Restarti ng Other Entities ■ Setting Manua l Switchovers ■ Changing the S[...]

70 C HAPTER 4: M AINTENANCE Back-end Servers: ■ CommWorks SNMP SubAgent ■ OOBMan ■ Prov isioning Serve r ■ Dir ectory Mapping Server ■ Accounting Ser ver ■ Billing S upport Server Remote upgrades of the above listed firmware card s are also accomplis hed through th e use of SDL- 2. SMS is no longer used for this purpos e. Softwar e Upgr[...]

Upgrad ing So ftwar e 71 ■ Extr act s the CA B file from th e DMF file. ■ Extracts the instal lation files fr om the CAB file. ■ Runs the setup. T able 9 list s a comparison of the ins t allat ion methods. Upgrading the Softwar e After you have decided what method you want to install the upgrades, you a re ready to upgra de you r syst em wi t[...]

72 C HAPTER 4: M AINTENANCE If you do not have unzip ca pabilities on your UNIX sy stem, you can download the free ware from the internet and install it on your system. 3 Select the compone nt to which you want to download software. The Media Gateway , Gatekeeper , SIP Pr oxy Ser ver or select the Back-en d Server . 4 If you selected a ser ver to d[...]

Comman d Too l 73 When the softwar e download is co m plete, a gree n box appears under the command status. 9 Clic k OK when finished. Command T ool The Command T ool is used to perf orm hardwar e and softwar e commands on a selected componen t, such as busy-out, disco nnect, res et, or save to NVRAM. As an ex ample, the proce dures in thi s sectio[...]

74 C HAPTER 4: M AINTENANCE Figur e 48 Example HiP er DSP Hardware Commands Figur e 49 shows the software commands that can be execut ed for the HiPer DSP car d. Figur e 49 Example HiP er DSP Software Commands 1 Select the ty pe of command you want to perform from the Command to Execute or Categ ory drop-down boxes. 2 Click Execute at the bottom of[...]

Restarting Othe r Entities 75 Figure 50 Exampl e Media Gateway Command Statu s Color Codes Restarting Other Entities Y ou can res tart the Gatekeeper s, Back-end Servers, and SIP Prox y Servers gracefull y or by a hard r estart. A graceful restart cl oses all open applic ations on the server , closes th e operating system, and t hen restarts the co[...]

76 C HAPTER 4: M AINTENANCE The entit y has been s uccessfully restart ed. Restarting after Parameter Change s Ther e are v arious parameter s located und er the Configurat ion menu that can be se t to me et you r requiremen ts. The pa rame ters th at are prefix ed wit h an asteris ks (*) r equire that the ent ity be r estarted when changes ar e ma[...]

Settin g Manual Switchov ers 77 For the Back-end Ser vers: ■ Accounting S er ver — r estart 3Com Accounting service on IP T elephony Manager , or stop and start 3Com V oIP Accounting Data servi ce applet on the W indows NT machine. ■ Directory Mapping Server — r estart 3Com Dir ectory service on IP T elephony Manager , or stop and sta rt 3C[...]

78 C HAPTER 4: M AINTENANCE Changing the SNMP Community Strings The I P T elephony Manager defaul t value for SNMP community string i s public for r ead only a nd private for read- write . T o chan ge th e defa ult values you m ust first cha nge the community string on the devices and th en on IP T elephony Manager . For securi ty reasons, you cann[...]

Changing the SNMP Comm unity Strings 79 A warning message app ears verifying t hat you ar e about to c hange the community st ring and that thi s change will impact any user who trie s to connect to the IP T elephony Mana ger chassis. Figure 54 Community String W arning Message After you make this cha nge, the current active IP T elep hony M anager[...]

80 C HAPTER 4: M AINTENANCE 6 Click OK . 7 If you changed the 3Com SNMP Community String s on the Gatekeeper , SIP Prox y Server , or any of the Back-end Ser vers, you must re start the SNMP agent. Refer to Restarting Othe r Entities for more inf ormat ion. T o change the I P T elephony Mana ger community str i ng thr ough the command line e nter: [...]

Displaying I nventory Informa tion 81 Displaying Inve ntory Information The IP T elephony Ma nager can display the inst alled components on your V oIP system; such as the ser ial numbers, hardwar e and softwar e versio n, DIP switch sett ings , and m emo ry for ea ch ca rd. T o display invent ory information fr om the IP T elephony Manager Conso le[...]

[...]

A E RR OR M ESSA GES Over view Error messa ges are divided int o two types: ■ Invo ca tion E rrors — result fr om missing or inval id use of command syntax, and are r eported immediat ely to stderr . They include: ■ Command Line T arget Sele ction ■ Cha ssi s Rest ore ■ Cha ssi s Save ■ Command T ool ■ Configurati on T ool ■ Softwar[...]

84 A PPENDIX : E RR OR M ESSAGES Invocation Err ors This topic describes the er ror mess ages that can occur from a command syntax err or . The invocati on errors categori es listed here ar e: ■ Command Line T arget Selecti on ■ Chassis R estore ■ Chassis S ave ■ Command T ool ■ Configurat ion T ool ■ Software Download ■ Te s t To o l[...]

Invocatio n Errors 85 Channel range con t ai ns zero : < target speci fication > A channel range incl udes 0 (e.g., S1C0-2). Time slot ra nge c ontains zero: < target specif ication > A time slot range cont ains zero. Expecte d slot-level target : < target spec ificat ion > The target speci fication began with a slot-l evel target[...]

86 A PPENDIX : E RR OR M ESSAGES Err or , unexpec ted command li ne format The user did not suppl y an IP addre ss, or (Non-GUI only) did not pr ovide a filena me. Command T ool The foll owing are t he Command T ool er ror messages and what they indicate. Missing -E opti on The user di d not choose a co m mand to exec ute using the - E option. (Non[...]

Invocatio n Errors 87 Error: T oo many targe ts specified The user s pecified mor e than on e IP addre ss/slot-cha nnel combination. ( There is mor e than on e white sp ace-separated word in the target list.) Inva lid targe t name The target does not spe cify a valid IP addr ess or host name. Software Download The foll ow ing ar e the S oftware Dow[...]

88 A PPENDIX : E RR OR M ESSAGES Extens ion is no t ’ sdl ’ Fata l Erro r (tcmsdl). Non fatal err or (xtc m sdl). This err or occurs if the speci fied SDL file does not have the corr ect extension (* .sdl). For tcmsdl , an err or message i s displayed on the scr een or output to the log file, and th en th e util ity te rmin ates . For xt cmsd l[...]

Invocatio n Errors 89 Error: T oo many targe ts specified The user s pecified mor e than on e IP addre ss/slot-cha nnel combination. ( There is mor e than on e white sp ace-separated word in the target list.) Invalid target fo rmat The target does not spe cify a valid IP addr ess or host name. Missin g -T option The user did not choose a tes t to e[...]

90 A PPENDIX : E RR OR M ESSAGES Error: insufficie nt argum ents A "-a", "- m", or "-d" dir ective ended unexpecte dly . Error: no target supplied The user did not suppl y an IP addre ss or host name on the command line. Error: invalid target for mat The targe t is not a valid IP address or host name, or contains slot/[...]

Execut ion Err ors 91 Error cons tructing target s pecifica tion...h ostnam e no longer valid? The user was pr om pted for tar get slot/channels usi ng the chassis select ion dialog. Afte r targets wer e selected, the constr uction of a target fail ed, probabl y because an IP host name could not be found in the hosts dat abase even th ough the host[...]

92 A PPENDIX : E RR OR M ESSAGES Miss ing or invali d de vice.d at fil e! IP T elephony Manage r has a cor rupt device conf iguration schema, or other inte r nal e rror . Missing or in vali d softw are.dat file ! IP T elephony Manage r has a cor rupt device conf iguration schema, or other inte r nal e rror . IP T eleph ony Manage r Disc overy er ro[...]

Execut ion Err ors 93 The select ed co nfigurat ion file was saved from a chas sis o f a different s ize. C ontinu e? Select eit her Y es or No. .whb file does not match chassis size Fata l error un less -F (force mism atch ) is spe cified . The sele cted configura tion file is from a chassi s with a different card configura tion. Conti nue? Select[...]

94 A PPENDIX : E RR OR M ESSAGES Ther e are no command s for this typ e of device. The device confi guration files do not lis t any commands for the target devic e. Inval id gr oup name: < name > The device confi guration files do not lis t < name > as a valid group. Invali d comma nd: < name > The device confi guration files do n[...]

Execut ion Err ors 95 Cannot lo ad between cha nnel and car d levels The "load f rom" sour ce is at channel lev el while the target devices are at c ard level, or vi ce versa. Missin g devi ce configur ation file There i s no configur ation schema file for the target devi ces. There are no configu rable p arameters for th is type o f card[...]

96 A PPENDIX : E RR OR M ESSAGES Canc el Executi on and exit pr ogram? Issued in a "Y es/No" dialog when user quits fr om window frame while command/test i s in progre ss. (GUI, warning only) Pr ogram exit d uring executi on The command or test pr ogram was terminated (e .g., by a signal) while a command or test was in pr ogress. ( Non-GU[...]

Execut ion Err ors 97 Selecte d device is not a modem The target slot is not a modem. Channel number out of rang e: < numb er > The target channel number is invalid for the parti cular type of car d. No D S0 assign ed to m odem. T e st aborted . The modem does not have a time sl ot assignment and tone test is ther efore impossible . Extra tar[...]

98 A PPENDIX : E RR OR M ESSAGES Commun ity strin g and Comment too long. T runcate? Issued i n an "OK/Cancel" dial og when a community string and/or c om ment is enter ed that is too long. (GUI, warning only) T r ap que ry ov erride s -a/ -m/-d The user specif ied both -q (query) and -a /-m/-d (table manipula tion) arguments; onl y -q wi[...]

Execut ion Err ors 99 < filena me > does not exi st Fata l Error (tc msdl ). Nonf ata l error (xtc msd l). This e rror occu rs if you sele cted a filename t hat does not exist. For tcmsdl, an err or message is display ed on the scr een or output to the log file, and then the utility ter minates. For xtcm sdl, click OK t o bring up th e Select[...]

100 A PPENDIX : E RRO R M ESSAGES SNMP Set Fa iled Fata l error . This er ror occ urs if th e targ et card is co mm unica ting with th e Softwar e Download util ity , but does not respon d corre ctly to a SNMP Set command. The e xact SNMP err or is di splayed. For tcmsdl , an err or message i s displayed on the scr een or output to the log file, an[...]

B C OMMAND L INE I NTERFAC E The command line interfac e consists of a number of non-inte ractive commands or utilities. T hese utiliti es are run at the c ommand line fr om a shell prompt or a shel l script. This appendix contai ns the following catator gies of commands: ■ General Syn tax ■ IP T elephony Manager Consol e ■ Configurati on ■[...]

102 A PPENDIX : C OMMAND L INE I NTERFACE An "x" place d at the beginning of any IP T elephony Manage r command omits command parameters and the target sl ot and channel designation-onl y the target IP addr ess or hostname is r equired. Graphi c user interfaces (GUIs) , such as the IP T elephony Manager device dis play , appear and assi s[...]

Gener al Syntax 103 For instance , to display Help for t he Softwa re Download util ity , type the following command: tcmsdl -h [-c readcomm][-C writecomm] readc omm — read only communit y string writ ecomm — r ead/write communi ty string Used to specify th e SNMP community strings that have been ass igned to the device. Note tha t these switch[...]

104 A PPENDIX : C OMMAND L INE I NTERFACE S Sets target slots i n the specif ied range C Sets target channels i n the specif ied range. If omitt ed, execution at the car d level i s assu med. T Sets target timesl ots in the specified range . If omitted, exec ution at the channel ( span line) le vel is assumed. When used with the Command T ool, this[...]

Conf igura tio n 105 Configuration The configurat ion command line interf ace (CLI) uses the foll owing syntax: tcmget command: tcmget [-h] [-l logfile ] [-c re adcomm] [-C writecomm] [-z] [-L] [-a] [-f file ] [-F] [ -G group [ parameter ]...]... target tcmset c om mand: tcmset [-c readcomm] [-C writecomm] [-h] [-l l ogfile] [-z] [-L] [-f filename [...]

106 A PPENDIX : C OMMAND L INE I NTERFACE -f ( filename ) ■ tcmget: Place the r esult output of the get operati on in a file given by < filena me > (stdout can be desi gnated using a filename o f ’ - ’ ). ■ tcmset: Read the output of the get operation fr om the file given by < filena me > and use it to set the va lues. For examp[...]

Conf igura tio n 107 ( parameter ) Parameter whose value is to be prin ted (for tcmget) or se t (for tcmset). (For example, ’ Ser ial Number ’ .) Each parameter shoul d be separated by a space and r equires pr oper shell quoting. At least one par ameter should be supplie d per gr oup, unless -L (list parameter s by group) is specifi ed. Paramet[...]

108 A PPENDIX : C OMMAND L INE I NTERFACE Specifi es slots or channels to be issued commands. T arget has the following format: < IP-host >:S< s-range >[,C< c-range >][,S< s-r ange > [,C< c-range >]...] where I P-host can be IP-dot notati on, or a host name that is defined in the host da tabase or /etc /hosts fi le. ?[...]

Actions/C ommands 109 Actions/Commands The command utility uses the fol lowing syntax: tcmcmd [-q] -E command -G group [-P parameter ][-F][-p seconds ] target Query Curr ent Command Status (-q) Wher e: [-q] Disp la ys th e result of the last issu ed c omm and the selec ted targ ets Example: tcmcmd [-q] target -E command command — a su bstring of [...]

110 A PPENDIX : C OMMAND L INE I NTERFACE [-p seconds] Sets amount of time, in seconds, between pol ls. Target Follows ge neral syntax . Note that if you omit a ch annel range, the command is assu med to b e t arge ted at t he sl ot level. This ap plies as wel l to time slot designati ons for commands sent to T1 car ds-if the timesl ot is omitte d,[...]

SNMP Com mands 111 SNMP Commands This descri bes how to set SNMP community stri ngs and how to monitor the SNM P pa rame ters. For securit y reasons, you can not view the community strin gs through IP T elephony Manager . Setting SNMP Community Strings This sect ion describes how to set the SNMP community str i ngs. [x]tcmcs [-h] [-c] readCommunity[...]

112 A PPENDIX : C OMMAND L INE I NTERFACE Wher e: -l ( logfile ) Log file for system diagn ostic messages. GUI defaul t: log to UNIX syslog; CLI default: stderr . Speci fy ’ - ’ (hyphen) to r everse these two behavi ors. -h Displays this he lp message. -c (readcomm) SNMP read communit y string. -C (writecomm) SNMP write community stri ng. -z Di[...]

SNMP Com mands 113 -G (BI) Selects a gr oup, followed by a list of paramet ers within that gr oup which are to be retr ieved. (For exampl e, ’ NM C Identif i cation ’ .) Group speci fications must appear after al l other command arguments, and befor e the target . Group name s are matched using subst ring comparison against the list of known gr[...]

114 A PPENDIX : C OMMAND L INE I NTERFACE T one T est This secti on describes how to send and rec eive a tone test. Send T one T est (-S) The followin g command causes the modem to send a tone of th e specif ied fr equency , duration, and amplit ude. tcmtone -S[-t][-s num ][-p num ] [freq[hz][ level [db]]] target Wher e: -S Initia tes send tone tes[...]

Modem Tests 115 Receive T one T est (-R) Use the followin g command to r eceive a tone test: tcmtone -R [-t] [-s num ] [-p nu m ] target Modem T ests tcmtest -T test [-s num ] target Query Curren t T est Status T o query a modem to deter mine whether a test is alr eady in progr ess, send the following command: tcmtest [-q] target Te s t Ty p e ( - [...]

116 A PPENDIX : C OMMAND L INE I NTERFACE Device Save and Restore The f ollowing commands ar e used to save and res tore the confi guration on the specifi ed device. Save Configur ation tcmsave -f filename target Wher e: filename The .whb output fil e to w hich the conf iguration is stor ed. target The IP addr ess or hostname of the device. For exa[...]

Softwa re Dow nload 117 Softwar e Download T o run tcmsdl, is sue the following command: tcmsdl [-s sdlfile ] [-n nacfile ] [-F] [-v] target Wher e: sdlfile The SDL file name (if omitted, uses l atest version ava ilable for card type). nacfile The NAC file name (if om itted, uses latest versio n available for car d type). -F Force download to an NM[...]

118 A PPENDIX : C OMMAND L INE I NTERFACE Filename Pr efixes Filename pr efixes indicat e which component type uses a given SDL or NAC file. In most c ases, the NAC and SDL files for a given c omponent have the same pref ix. Ther e are some exce ptions, such as the Sing le T1 Card, as shown in the table bel ow: Software Download Prog ress Message s[...]

Featu re Enable 119 Featur e Enable The following command li ne launches the Featur e Enable option: tcminv [-l logfile ] [-h] [-c re adcomm] [-C writecomm] [ target ] Wher e: -l logfile The log file for syst em diagnost ic messages. The GUI log fi le default is th e UNIX syslog fi le. The CLI defa ult is stderr . Y ou can rever se these def aults [...]

120 A PPENDIX : C OMMAND L INE I NTERFACE Wher e: IP-host Can be in IP-dot notat ion, or a host name that is define d in the host data base or etchos ts file. :S< Slot > The decimal number r epre senting the location of t he car d in the chassis. Inventory Use the followi ng syntax to launch the Inventory utili ty: tcminv [-l logfile ] [-h][...]

Autho ri zed Sta tion T ool 121 -f filename The file to sa ve inventory to (f or CLI only). target Spe cifi es ch assis ho st(s ) to be d ispla ye d. The form at f or targe t is a s fo llows : < IP-hos t > C an be in IP-dot notat ion, or a host name that is defined i n the host databa se or / etc/h osts file . Authorized Station T ool The Aut[...]

122 A PPENDIX : C OMMAND L INE I NTERFACE target An optional parameter tha t specif ies the IP addre ss or hostname of the NMC in which stations ar e being config ured If no ta rget is speci fied, the GU I beha ves as if -h wa s the on ly par amet er passed. The format for target is as foll ows: < IP-host > IP-host can be in IP-dot not ation,[...]

AutoResponse 123 AutoResponse The AutoRe sponse can be invoked by the followi ng syntax: tcmarsp [-E event ] [-h] [ target ] Wher e: -E event Specifies which event to us e as the default. The specif ied parameter must be a subst ring of one of the event des criptive strings desc ribed below . Substrings that match at the beginnin g of the descripti[...]

124 A PPENDIX : C OMMAND L INE I NTERFACE Slot Level Events and Response s The followin g are the events and th e responses to the events fro m the AutoResponse command Events: ■ Module I nserted ■ Module Re -initializ ed ■ Module Re m oved ■ Module Non- operational ■ Module W atchdo g T ime-out Responses (t he "(N)" notat ion i[...]

AutoResponse 125 ■ Reset By DT E ■ DTE T ransmit Idle ■ Block Err or Count at Thr eshold ■ Fallback Count at Thr eshold ■ Dial Out Login Fai l ur e ■ Dial Out Restri cted Number ■ Dial In Login Fail ure ■ Dial Back Restric ted Number ■ Dial Back Using Rest ricted Modem ■ Login Atte m pt Limit Exceeded ■ User Black listed ■ A[...]

126 A PPENDIX : C OMMAND L INE I NTERFACE ■ T est Modem ■ T est Analog NIC ■ T est Analog Phone Line ■ Restor e Analog Phone Line ■ Busy out DS0 - T1 Slot (N) Span ( N) Channel (N) ■ Restor e DS0 - T1 Slot (N) Span (N) Channel (N) ■ Mod em Softw ar e Reset ■ T erminate Connection ■ Busy Out Ana log Phone Line -h Displays the comma[...]

AutoResponse 127 :S< s-range > A decimal number of a range s1-s 2 (wher e s1 and s2 are deci m al numbers separated by a li teral hyphen) r epresenting the locati on of the card(s ) in the chassis. :C< c-range > A decimal number or a range c1-c 2 (wher e c1 and c2 are decimal numb ers separated by a literal hyphen) r epresenti ng the ch[...]

128 A PPENDIX : C OMMAND L INE I NTERFACE[...]

C G LOSSARY This appendix lis ts acr onyms and terminology used in the Co m mWor ks V oIP applicati on. A-Link Access link. S S7 Signali ng link used to connect the Signal ing T ransfer P oint (STP) and Signal ing Switch Point (SSP) . ACF Admissi on Confirm — This is a call flo w mes sage . AMI Alt er nate Mark Invers ion — A line encoding sc h[...]

130 A PPENDIX : G LOSSARY CD Colli sion Detect ion — A process wher e a simultan eous transmission has ta ken place. W orkstati ons can determine if this has happened if th ey do not recei ve an acknowledg ement fr om the recei ving station wit hin a certain amount of time. When thi s occurs, the workstation wi ll try again. CDR Call Detail Reco [...]

Appe ndi x : Gl os sary 131 CSMA Carrier Sense Multiple Acce ss — Media-access mech anism wherein devices r eady to transmit data first check the channel for a carrier . If no carrier is sense d for a specifi c period o f time , a device can transm it. If two devices tran smit at once, a collis ion occurs and is de tected by all col liding devic [...]

132 A PPENDIX : G LOSSARY DRAM Dynamic Random Access Me mory — The reada ble/writable memo ry used to stor e data in PC s. DRAM store s each bit of infor mation in a "c ell" composed of a capacitor and a tran sistor . DRJ Disen gage Reject — This is a c all fl ow m essag e. DRQ Disen gage Request — This is a call fl ow mess age . DS[...]

Appe ndi x : Gl os sary 133 ESD Electrostatic Discharge — Discharge of s tored st atic electricit y that can damage electr onic eq uipment a nd impair e lectrical circ uitry , r esulting in complet e or inter mittent fa ilures. ESF Extended Su per Frame — Framing type used on T1 cir cuits that con sists of 24 frames of 192 bits each , with the [...]

134 A PPENDIX : G LOSSARY IDE Integrat ed Drive Electr onics — St andard i nterface to the hard disk dri ve on the PC. IEC Internatio nal Electr otechni cal Commiss ion — The in ter natio nal standar ds body for electr otechnol ogy . IIS Internet I nformation Server — Micr osoft Windows NT web based server . It all ows you to cr eate contr ol[...]

Appe ndi x : Gl os sary 135 LRJ Location Reject — This is a call f low mes sage . LRQ Location Request — This is a call flow mess age. MBP Management Bus Protoco l — This prot ocol was developed by 3Com and is used i n the NMC to commu nicate to th e other cards in the T otal C ontrol chassis. MFC Multifr equency Compe lled — An E1 call set[...]

136 A PPENDIX : G LOSSARY OOBMAN Out-of-band Manage r — OOBMan is an a pplication that r uns on 3Com W indows NT components of th e CommWorks IP T elephony platfor m . It is desi gned to allow a user to dial into an NT device, using a termin al emulation pr ogram such as Hyperterminal , and view or modify various configura tion informatio n on th[...]

Appe ndi x : Gl os sary 137 RCF Registrat ion Confirm — Th is is a call flow message. RISC Reduced Inst ruction Se t Computer — Centra l processing unit ar chitectur e that gre atly red uces proc essing time by having fewer , simpler instruction s progr ammed into ROM, bu t allowing for comp lex pro cessing by combini ng these simple instru cti[...]

138 A PPENDIX : G LOSSARY SS7 Signa ling Sy stem 7 — A globa l standar d for tel ecommunicati ons as defin ed by the Internatio nal T elecommuni cation Union (ITU ). The SS7 standar d defines the pr ocedure pr otocol by which net work elements in the PSTN exchan ge informatio n over a digi tal signaling networ k. SMS System Ma nagement Services ?[...]

Appe ndi x : Gl os sary 139 TDMA Time Divisi on Multipl exing Adap ter — A device that allows analog voice and da ta devices to wor k throug h an ISDN connecti on. The term inal adapter i s a pr otocol convert er that a dapts equi pment not designed f or ISDN, s uch as phon es, faxes, and modems. TF T P T riv ial Fi le T ransf er P rotocol — si[...]

140 A PPENDIX : G LOSSARY ZCS Zer o Code Suppr ession — U sed primarily wit h T1. The insertio n of a one bit to pr event the tr ansmission of eight consec utive zer os on an active line . When ei ght or mor e consecutive zer os are det ected on the line, the syst em considers the line inacti ve, and rele ases the line.[...]

I NDEX Symbols .cfm files 48 .dmf 69 .nvr files 44 , 47 A access ing IP T ele phony Mana ger 49 acronyms 129 Action/Comman ds menu 59 adjusting co lumn width 59 author ized a ccess 66 authorized acc e ss lis t cleari ng 80 Author ized St ation T o ol command 12 1 Author ized St ations conf igurin g 32 Author ized St ations Add windo w elements 67 A[...]

142 L LED Pol l Info menu 54 LED s tatus 54 linking objects in HP Open View 26 M making c hange s 73 managemen t functions 66 managemen t station clea ring 80 configur ation 27 manua l Gate keepe r switch over 77 menu Action/Com mands 59 Autho rized St ations 66 AutoRespo nse 61 Chassis S ave All 52 Community Names 66 Configur ation 56 Exit 53 Faul[...]

[...]

CommWorks Corporation 3800 Golf Road Rolling Meadows, IL 60008 ©2001 3Com Cor poratio n All righ ts reser ved Printed in the U. S.A. Part Num ber 10044 879[...]