Quintum Technologies Tenor VoIP MultiPath User Manual

Page 1
®
Tenor VoIP MultiPath
Switch
Using SNMP
Tenor VoIP MultiPath Switch, Quintum, Qui nt um Technologies, Inc. are trademarks of Quintum Technologies, Inc.
P/N 480-0036-00-00 1-1
Page 2
What is SNMP?................................................................................................ 1-3
How does Tenor utilize SNMP?............................................................... 1-3
Installation Requirements .............................................................................. 1-4
Installation ....................................................................................................... 1-5
Download and install SNMP Related Files ............................................. 1-5
Configure network manager IP address .................................................. 1-7
Tenor CMS .............................................................................................. 1-7
Tenor Analog / Tenor Digital .................................................................. 1-8
Working with SNMP ...................................................................................... 1-10
View traps ............................................................................................... 1-10
View Alarm Status via Tenor icon .......................................................... 1-10
Launching Command Line Interface (CLI) from HP Openview ............ 1-10
Set up Tenor status polling....................................................................... 1-11
Set up Debug Message Display window ................................................. 1-11
1-2 P/N 480-0036-00-00
Page 3

What is SNMP?

Simple Network Managemen t Prot ocol (SNMP ) is the stan dard pr otocol used t o exch ange netw ork ma nagement information.
SNMP management requires two primary elements: a network manager and an SNMP agent. A network man­ager is the software running on a workstation through which the network administrator monitors and controls the different hardware and software systems that comprise a network. The agent is a piece of software running in a network equipment that implements the SNMP protocol. SNMP defines exactly how a network manager com­municates with an SNMP agent. For example, SNMP defines the format of requests that a network manager sends to an agent and the format of replies the agent returns.
Through an SNMP management system, the network manager can communicate and manage several different network devices at the same time. The network manager polls the SNMP agents (such as routers, hubs or net­work servers) for certain requested information. The agent will then gather information about the machine it is running on and carries requests from the network manager to read and change the information.

How does Tenor utilize SNMP?

The T enor unit su pports the SNMP protocol; specifically, Hewlett® Packard’ s HP Openview software acts as the SNMP network manager for the Tenor unit. Once you set up HP Open view to view and “au to-discove r” Tenor as a network device using SNMP, HP Openview will be able to issue commands, get responses, and perform cer­tain functions. For example, you can configure the SNMP agent in Tenor to generate and send traps for existing Tenor alarms to HP Openview.
A Tenor unit can report alarms to up to three network managers.
1-3 P/N 480-0036-00-00
Page 4

Installati on Requirem ents

You will need to install and run HP Openview NMS 6.0 in order to recognize the Tenor as an SNMP agent. Below are basic hardware and software requirements you will need to install HP Openview. See your HP Openview documentation for detailed information and installation instructions.
Minimum hardware requirements
Intel Pentium 120 Mhz processor-based computer
CD Drive
•96 MB RAM
250 MB free disk space on one drive
80 MB free page filing space
Software requirem ents
Microsoft Windows NT operating system (version 4.0), with TCP/IP version 4.0
Microsoft SNMP Agent (SNMP Services)
Microsoft Peer Web Services or Internet Information Server (IIS) version 4.0
Netscape Navigator web browser (version 4.06 or higher) or Microsoft Internet Explorer web browser (version 4.0 or higher) with Java/JavaScript options enabled
P/N 480-0036-00-00 1-4
Page 5

Installation

There are two steps you need to accomplish before HP Openview can interact with a Tenor unit as an SNMP agent.
Download and install HP Openview configuration files specific for Tenor
Configure the IP address of the network manager in the Tenor

Download and install SNMP Related Files

For HP Openview (network manager) to view and manage the Ten or as an SNMP agent, you must first down­load and install files from the www.quintum.com web site as follows:
1. Start up HP Openview. (For specific information, see the user documentation you received with the soft­ware.) There are two ways to download the applicable files: from the www.quintum.com web site or from the CD delivered with the system. To download from the web, go to step 2. Otherwise, for CD installation, go to step 5.
2. From the web site, access a web browser (i.e., Microsoft Internet Explorer, Netscape) and go to the web site www.quintum.com.
3. Download the installquintum.zip file to your PC.
4. Unzip the installquintum.zip file to the HP Openview root directory (this is the directory in which HP Openview was installed).
The following files will be listed:
installquintum.bat quintum.reg quintum.exe quintum.conf quintum.fields quintum_type connector_qdvoip connector_qavoip uninstallquintum.bat quintum_sym Tenor_chassis.ico Tenor_A.ico Tenor_D.ico
5. From the Quintum CD ROM, access the directory <CD ROM Drive>:\software\SNMP and download the files (the same files listed above) to the HP Openview root directory (this is the directory in which HP Openview was installed).
6. From the HP Openview root directory run installquintum.bat. Installation will begin. The following sec- tion lists where the installation files are copied and which files were modified. You can use this informa­tion to manually make changes to the files, if desired.
NOTE: If you have already ran t he installquintum.bat, you must fir st run th e installlquintum.bat clean com-
mand prior to reinstalling. This command will restore any changes made to the quintum files back to the default parameters (see below for which files are modified upon installation).
P/N 480-0036-00-00 1-5
Page 6
These lines are added to the file HPOVRoot\conf\oid_to_sym:
1.3.6.1.4.1.6618.1.1. 1:Connector:QDVOIP # QUINTUM Digital Tenor
1.3.6.1.4.1.6618.1.1.2:Connect or:QAVOIP # QUINTUM Analog Tenor
1.3.6.1.4.1.6618.1.1.10:Connection:QCVOIP # QUINTUM Chassis Tenor
These lines are added to the file HPOVRoot\conf\oid_to_type:
1.3.6.1.4.1.6618.1.1.1:Quin tum:Epilogue:H # Quintum-Digital Tenor
1.3.6.1.4.1.6618.1.1.2:Quin tum:Epilogue:H # Quintum-Analog Tenor
1.3.6.1.4.1.6618.1.1.10:Connection:Epilogue:H #QUINT UM Chassis Tenor
These lines are added to the file HPOVRoot\conf\C\trapd.conf using the "xnmevents -load" HPOV com­mand:
OID_ALIAS Quintum .1.3.6.1.4.1.6618 # # # EVENT Critical_Alarm .1.3.6.1.4.1.6618.2.0.1 "Status Events" Critical FORMAT Received trap: generic #$G specific #$S . $#args:$* SDESC T1IU_in_loopback;_network_request EDESC # # # EVENT Major_Alarm .1.3.6.1.4.1.6618.2.0.2 "Status Events" Major FORMAT Received trap: generic #$G specific #$S . $#args:$* SDESC Corruption_of_configuration_info. EDESC # # # EVENT Minor_Alarm .1.3.6.1.4.1.6618.2.0.3 "Status Events" Minor FORMAT Received trap: generic #$G specific #$S . $#args:$* SDESC RIU_not_installe EDESC # # # EVENT Report_Status_Alarm .1.3.6.1.4.1.6618.2.0.4 "Status Events" Normal FORMAT Received trap: generic #$G specific #$S . $#args:$* SDESC Uswcomment EDESC # # # EVENT Uswcomment .1.3.6.1.4.1.6618.2.0.0 "Status Events" Normal FORMAT Received trap: generic #$G specific #$S . $#args:$* SDESC Uswcomment
P/N 480-0036-00-00 1-6
Page 7
EDESC
• The quintum.exe file is added to the HPOVRoot\bin directory.
These files are added to the HPOVRoot\bitmaps\C directory:
T enor_chassis.ico Tenor_A.ico Tenor_D.ico
•The quintum.fields file is adde d to the HPOVRoot\fields\C directory, and is installed and verified using the "OVW -fields" command.
•The quintum.reg file is added to the HPOVRoot\registration\C directory.
These files are added to the D:\hpovnnm\symbols\C\Connector directory:
CONNECTOR_QDVOIP CONNECTOR_QAVOIP CONNECTOR_QCVOIP
7. HP Openview will then identify and “auto-discover” the Tenor unit as an SNMP agent. An icon will appear on the screen to represent each Tenor unit. See below. For illustration purposes, the Tenor CMS icon is shown.
Figure 5-1 Tenor SNMP Agent Icon

Configure network manager IP address

Through Tenor’s Command Line interface (CLI), you can configure the IP address for the network manage­ment site where HP Openview is running. Once the IP address is configured, the Tenor will be able to process and generate traps for existing alarms, which will enable HP Openview to monitor the Tenor unit for alarm states.

Tenor CMS

To set the IP address for the Tenor CMS, use the following CLI command:
con-MasterChassis> snmptrapip1 <ip >. This command configures the IP address of the network manage­ment site in the Tenor unit from which the SNMP traps will be generated. Valid entry: The index number of 1­3 (the index number is used to designate the index # for the network manager to be used) followed by the IP address for the network management site.You can assign a Tenor unit up to three network managers; each manager will have a different index number.
Assign an IP address for the Tenor CMS as follows:
NOTE: The following instructions assume your PC is running Windows 95 or later.
P/N 480-0036-00-00 1-7
Page 8
1. Click on Start> Run. The Run window will appear.
2. Type telnet in the Open box and click on Ok.
3. Click Connect> Remote System.
4. In the Host Name window, enter the IP address of the unit from which you would like to view alarms.
5. In the port window, choose telnet (port 23 is the default port for a telnet session).
6. From the TermType drop down list, select vt100.
7. Click Connect. A telnet session will be displayed. (To exit a telnet session at any time, type exit at the prompt.)
8. Enter the same password you set via CLI.
9. At the config - MasterChassis prompt, type set snmptrapip1 <ip>. For example, type set snmptrapip1
208.226.140.12. This will assign index of 1 to indicate the first network manager being assigned to that Tenor unit and assign the IP address 208.226.140.12 as the network manager. To assign the second snmptrap ip, type set snmptrapip2 <ip> and the third type set snmptrapip3 <ip>.
10. Repeat step 9 for each network manager (up to 3).
11. Type submit. The new IP address(es) will be submitted to the applicable Tenor unit.

Tenor Analog / Tenor Digital

To set the IP address for a Tenor Analog or Tenor Digital, use the following CLI command:
config sys snmptrapip <index><ip>. This command configures the IP address of the network management site in the Tenor unit from which the SNMP traps will be generated. Valid entry: The index number of 1-3 (the index number is used to d esi g nat e the i nd ex # for t he n etwo rk m a nager t o be us ed) f ol low ed b y t he IP address for the network management site.You can assign a Tenor unit up to three network managers; each manager will have a different index number.
Assign an IP address as follows:
NOTE: The following instructions assume your PC is running Windows 95 or later.
1. Click on Start> Run. The Run window will appear.
2. Type telnet in the Open box and click on Ok.
3. Click Connect> Remote System.
4. In the Host Name window, enter the IP address of the unit from which you would like to view alarms.
5. In the port window, choose telnet (port 23 is the default port for a telnet session).
6. From the TermType drop down list, select vt100.
7. Click Connect. A telnet session will be displayed. (To exit a telnet session at any time, type exit at the prompt.)
P/N 480-0036-00-00 1-8
Page 9
8. At the Pa s sword prompt, enter the same password you set via Tenor CAMWizard.
9. At the Quintum prompt, type config sys snmptrapip<index><ip >. For example, type config sys snmptrapip 3 208.226.140.121 (this will assign index of 1 to indicate the first network manager being assigned to that Tenor unit and assign the IP address 208.226.140.12 as the network manager).
10. Repeat step 9 for each network manager (up to 3).
11. Type submit. The new IP address(es) will be submitted to the applicable Tenor unit.
P/N 480-0036-00-00 1-9
Page 10

Working with SNMP

View traps

You can view the traps HP Openview received from the Tenor unit as follows:
NOTE: Ensure HP Openview is running.
1. From the HP Openview map where the Tenor units appear, right-click on the Tenor icon for which you want to view traps and select Alarms.
2. From the Alarm Categories window, click on All Alarms. All traps (alarm messages) will be listed in the order of which they occurred.

View Alarm St atus via T enor icon

Through the color of a Tenor icon on the HP Openview desktop, you can determine the alarm state of the unit as well as view the corresponding alarms. Valid icon colors are listed below.
Green Icon. No Alarm indicated.
Red Icon. Critical Alarm (used for when HP Openview cannot communicate with the Tenor or there is a severity level 1 alarm).
Orange Icon. Major Alarm (used for severity level 2 alarms).
Yellow Icon. Minor Alarm (used for severity level 3 alarms).
White Icon. Info Alarm (used for severity level 4 alarms).
View the alarms associated with a Tenor unit as follows:
NOTE: Ensure HP Openview is running.
1. From the HP Openview desktop, identify the icon for the Tenor unit from which you would like to view alarms.
2. According to the color of that icon, determine the alarm state from the list above.
3. T o view the alarms associated with that icon, right-click from any where on the HP Openview des ktop and select Alarms. The All Alarms Browser window will appear, which contains the list of alarms.

Launching Command Line Interface (CLI) from HP Openview

You can launch the Command Line Interface (CLI) from HP Openview as follows:
Launch Command Line Interface with pop-up menu as follows:
1. From the HP Openview desktop, right-click on the desired Tenor unit icon and (i.e, select Quintum CMS).
The CLI will launch with the IP address of the unit associated with that icon (the correct IP address will appear in the URL).
P/N 480-0036-00-00 1-10
Page 11
2. Configure the unit.
OR
Launch CLI by double-clicking as fo llows:
Launch Tenor CLI by double-clicking the icon as follows:
1. From the HP Openview desktop, double-click on the desired Tenor unit icon and select the unit type (i.e. Quintum CMS).
The CLI will launch with the IP address of the unit associated with that icon (the correct IP address will appear in the URL).
2. Configure the unit.

Set up Tenor status polling

The following explains how to configure HPOV to determine and display unit status if the Tenor is not config­ured to send traps. Polling is only intended for Tenor units which are not accessible to configure the network manager IP address using the Tenor’s Command Line Interface (CLI). We do not recommend polling more than 10 Tenor units.
1. From the HP Openview desktop, right-click on the desired Tenor unit icon and select Object Properties.
2. From the Attributes window, select the unit type (i.e.,) Quintum Tenor CMS attributes.
3. Click on Edit Attributes
4. Select Turn on Tenor Status Polling (the toggle allows you to set to True or False). Select True.
5. Click on Verify. After the verification is complete, click Ok.
Polling occurs in a 30 second interval, or whenever a Tenor trap is received.

Set up Debug Message Display window

The following explains how to dis play d ebug mes sages t hat are genera ted by the qui ntum.exe. T his win dow is used to troubleshoot HPOV processing events for the Tenor icons.
1. From the HP Openview desktop, right-click on the desired Tenor unit icon and select Object Properties.
2. From the Attribu tes window, select the unit type (i.e., Quintum Tenor CMS).
3. Click on Edit Attributes.
4. Select Turn on Deb ug Window (the toggle allows you to set to True or False). Select True.
5. Click on Verify. After the verification is complete, click Ok.
The Debug Message Display window will appear that displays debug messages being processed that are assi­cated with that icon, only one window can be opened at a time.
P/N 480-0036-00-00 1-11
Loading...