cc/td/doc/product/mels/cm1500
hometocprevnextglossaryfeedbacksearchhelp
PDF

Table Of Contents

Operation

Overview

SNMP

SNMP Variables

SNMP Traps

Telnet

ocmstate

clockset

snmpconfig


Operation


This chapter describes the operation of the NEMI, and includes the following sections:

Overview

SNMP

Telnet

Overview

The NEMI can be accessed through the network in three different ways: SNMP, Telnet, or FTP.

You can monitor the state of the connected chassis of the Cisco Metro 1500 series system most effectively with SNMP. With a small amount of network traffic, you can read the complete state of the chassis. Events are reported immediately to a management station.

To configure the system or to see a detailed view of a component, you can use Telnet or HyperTerminal with a Laplink cable. After logging in to the NEMI, you can process commands to read or to configure values.

Use FTP for file transfer between the NEMI and your management station. For example, when loading the Management Information Base (MIB) file from the NEMI to your management station or when doing software updates on the NEMI.

SNMP

SNMP defines three ways for a network management system to communicate to a network element:

get provides the requested value

getNext provides the next available value

set changes a value.

Events are reported by the network element with an SNMP trap.

Variables are located in a tree-like structure and coded with Abstract Syntax Notation One (ASN.1). The variable 1.3.6.2.1.1.1.0 is the system description, defined in RFC 1213. To make the SNMP values human readable, a MIB file containing names for the variables is supplied. RFC 1213 contains a MIB file for some standard variables. Using RFC 1213, the variable 1.3.6.2.1.1.1.0 is iso.org.dod.internet.mgmt.mib-2.system.sysDescr.0. Vendors of network elements that use nonstandard variables must supply customers with their private MIB file. The Cisco Metro 1500 series MIB file is posted at ftp://ftp.cisco.com/pub/mibs.

The Cisco Metro 1500 series system can be managed by any network management program that supports SNMP.

SNMP Variables

The NEMI supports the variables defined in RFC 1213. The most often used variables in system tree 1.3.6.2.1 are sysDescr, sysName, sysContact, and sysLocation. The variable sysDescr is a unique text string that is always
"Metro 1500 Series." The variable sysName is the hostname of the system and is set by the netconfig command. The variables sysLocation and sysContact are where the system is located and who is responsible for it. The variables sysName and sysContact can be changed either by the snmpconfig command or by SNMP set instructions. In RFC 1213 there are many variables defined for interface statistics and routing tables. For detailed information, refer to RFC 1213 documentation.

In addition to the standard variables, Cisco Metro 1500 series supports specific variables. The MIB tree has information on the housing management system and information common to all inserted slots. Figure 5-1 shows the complete MIB tree beginning from root.

Figure 5-1 MIB Tree

Using the SNMP manager, you can read the status values of the unit. The community string used to read the values is public. If you need to set values, use the community string private. Be careful with this community string, because every SNMP manager in the network can change status values of the unit when using the private community string. Refer to Table 5-1 through Table 5-6 for SNMP variables.

Housing

The Housing subtree ( Figure 5-2) describes the information on the main system and the internal bus system. Table 5-1 describes the variables.

Figure 5-2 Housing Subtree

Table 5-1 Housing Variables 

Main Tree
Subtree
Type
Description

metro1500
Housing

metro1500Manufacturer

String

Manufacturer.

 

metro1500MainType

String

Type of system.

 

metro1500MainSerialNumber

String

Serial number.

 

metro1500MainHardwareVersion

String

Hardware version number.

 

metro1500MainSoftwareVersion

String

Software version number.

 

metro1500MainBusMessages

Integer

Number of received messages on the internal bus. This should be a large integer value.

 

metro1500MainBusErrors

Integer

Number of transmission errors on the internal bus. This should be a small integer value.

 

metro1500MainLastEvent

Integer

Number of the last event. It is cleared when a new event occurs or 10 minutes after the last event. Use this value for periodically polling.

 

metro1500MainMotd

String

Message of the day.

 

metro1500MainTrapsinkTable

Table

Table of trap sinks.

 

metro1500MainLogFileTable

Table

Table of log files.


Slot Table

The slot table subtree ( Figure 5-3) describes all the common values of the installed slots. Table 5-2 describes the variables.

Figure 5-3 Slot Table Subtree

Table 5-2 Slot Table Variables 

Main Tree
Subtree
Type
Description

metro1500
SlotTable

metro1500SlotNumber

Integer

Number of the installed device

 

metro1500Type

String

Type of the installed device

 

metro1500SlotTypeNumber

String

Number of the devices:
0 - hotStandbyConverter
1 - metro1500Converter
2 - NEMI
3 - DEMI
4 - switch
5 - other

 

metro1500SerialNumber

Integer

Serial number

 

metro1500HardwareVersion

String

Hardware version

 

metro1500SoftwareVersion

String

Software version

 

metro1500Temperature

Integer

Environmental temperature of the device in degrees Celsius

 

metro1500BoardVoltage

Integer

Supply voltage on the device in millivolts

 

metro1500DetailInfo

Object Identifier

Link to a table where special information on this device type is available

 

metro1500EPLDVersion

Integer
0 to 255

Software version of the programmable logic circuit


Power Supplies and Fan

The power supply and fan subtrees ( Figure 5-4) have two variables: one contains the part number and the other contains the on/off status. Table 5-3 and Table 5-4 describe the variables.

Figure 5-4 Power Supply and Fan Subtrees

Table 5-3 Power Supplies Subtree

Main Tree
Subtree
Type
Description

metro1500
PSTable

metro1500PS
Number

Integer

Number of the power supply:
1 and 2 - NEMI power supplies
3 and 4 - NEMI fan power supplies
5 and 6 - DEMI power supplies
7 and 8 - DEMI fan power supplies

 

metro1500PSOn

Integer

Power supply status:
1 - on
2 - off


Table 5-4 Fan Subtree

Main Tree
Subtree
Type
Description

metro1500
FanTable

metro1500FanNumber

Integer

Number of the fan:
1 and 2 - NEMI fans
3 and 4 - DEMI fans

 

metro1500FanOn

Integer

Fan status:
1 - on
2 - off


Channel Module

The channel module subtree ( Figure 5-5) contains information on the installed channel modules. Table 5-5 describes the variables.

Figure 5-5 Channel Module Subtree

Table 5-5 Channel Module Variables 

Main Tree
Subtree
Type
Description

metro1500Converter
Table

metro1500Converter
Number

Integer

Number of installed channel modules.

 

metro1500RxLoc

Integer

Status of the local receiver:
1 - on
2 - off

 

metro1500TxLoc

Integer

Status of the local transmitter:
1 - on
2 - off

 

metro1500TxLocC

Integer

Current of the local transmitter in milliamperes. This value is available if a current sensor is installed.

 

metro1500TxLocTemp

Integer

Temperature of the local transmitter in degrees Celsius. This value is available if a current sensor is installed.

 

metro1500RxRem

Integer

Status of the remote receiver:
1 - on
2 - off

 

metro1500TxRem

Integer

Status of the remote transmitter:
1 - on
2 - off

 

metro1500TxRemC

Integer

Current of the remote transmitter in milliamperes. This value is available if a current sensor is installed.

 

metro1500TxRem
Temp

Integer

Temperature of the remote transmitter in degrees Celsius. This value is available if the transmitter is cooled.

 

metro1500RxRem2

Integer

Status of the second remote receiver:
1 - on
2 - off
This value is only available if a second remote receiver is installed.

 

metro1500ClockState

Integer

Status of the clock:
1 - on
2 - off
3 - fail

This value is only available if a clock is installed.

 

metro1500ClockFreq

Integer

Frequency of the clock in Mbps.
This value is only available if a clock is installed.

 

metro1500LocLoop

Integer

Status of the local loop:
1 - on
2 - off

 

metro1500RemLoop

Integer

Status of the remote loop:
1 - on
2 - off


Switch

The switch subtree ( Figure 5-6) contains the information on installed switches. Table 5-6 describes the variables.

Figure 5-6 Switch Subtree

Table 5-6 Switch Variables 

Main Tree
Subtree
Type
Description

metro1500
SwitchTable

metro1500SwitchNumber

Integer

Switch number

 

metro1500SwitchLine

Integer

Active switch line:
1 - line A
2 - line B

 

metro1500SwitchMode

Integer

Switch mode:
1 - automatic
2 - locked

 

metro1500SwitchLaserOn

Integer

Reference laser status:
1 - on
2 - off

 

metro1500SwitchLineAavail

Integer

Line A availability:
1 - available
2 - not available

 

metro1500SwitchLineBavail

Integer

Line B availability:
1 - available
2 - not available


SNMP Traps

Failures and changes in state are stored in log files. SNMP traps are sent to the defined trap sinks. See Table 5-7 for a description of the log files.

Table 5-7 SNMP Log Files

Log File
Description

/etc/FlashLog.log

Events are logged permanently.

/temp/RAMLog.log

Events are logged in memory. This log file is erased every time the NEMI reboots.


Enter less /temp/RAMLog.log or less /etc/FlashLog.log to see the logged events.

In the case of errors, traps are sent automatically to the IP addresses defined as trap sinks. These traps deliver a slot number, a power supply number, or a fan number. Table 5-8 through Table 5-10 show a list of the error classes.

Table 5-8 Main System Traps

Trap No.
Trap Name
Variable
Description
Default Priority

1

metro1500HardwareAdded

metro1500SlotNumber

Hardware is added to the system.

1

2

metro1500HardwareDeleted

metro1500SlotNumber

Hardware is deleted from the system.

1

3

metro1500PSNotFail

metro1500PSNumber

Power supply starts working.

4

4

metro1500PSFail

metro1500PSNumber

Power supply fails.

4

5

metro1500FanNotFail

metro1500FanNumber

Fan starts working.

4

6

metro1500FanFail

metro1500FanNumber

Fan fails.

4

7

metro1500BusNotFail

-

Internal bus starts working.

4

8

metro1500BusFail

-

Internal bus fails.

4


Table 5-9 Channel Module Traps 

Trap No.
Trap Name
Variable
Description
Default Priority

20

metro1500RxLocOn

metro1500SlotNumber

Local receiver is on.

4

21

metro1500RxLocOff

metro1500SlotNumber

Local receiver is off.

4

22

metro1500TxLocOn

metro1500SlotNumber

Local transmitter is on.

20

23

metro1500TxLocOff

metro1500SlotNumber

Local transmitter is off.

20

24

metro1500RxRemOn

metro1500SlotNumber

Remote receiver is on.

4

25

metro1500RxRemOff

metro1500SlotNumber

Remote receiver is off.

4

26

metro1500TxRemOn

metro1500SlotNumber

Remote transmitter is on.

20

27

metro1500TxRemOff

metro1500SlotNumber

Remote transmitter is off.

20

28

metro1500RxRem2On

metro1500SlotNumber

Second remote receiver is on.

4

29

metro1500RxRem2Off

metro1500SlotNumber

Second remote receiver is off.

4

30

metro1500TxRem2On

metro1500SlotNumber

Second remote transmitter is on.

20

31

metro1500TxRem2Off

metro1500SlotNumber

Second remote transmitter is off.

20

32

metro1500ClockNoFail

metro1500SlotNumber

Clock is working.

4

33

metro1500ClockFail

metro1500SlotNumber

Clock fails.

4

34

metro1500ClockChange
Frequency

metro1500SlotNumber

Multifrequency clock changes frequency.

4

35

metro1500LocLoopOff

metro1500SlotNumber

Local loop is on.

4

36

metro1500LocLoopOn

metro1500SlotNumber

Local loop is off.

4

37

metro1500RemLoopOn

metro1500SlotNumber

Remote loop is on.

4

38

metro1500RemLoopOff

metro1500SlotNumber

Remote loop is off.

4


Table 5-10 Switch Traps 

Trap No.
Trap Name
Variable
Description
Default Priority

40

metro1500switchReference
LaserOn

metro1500SlotNumber

Reference laser is switched on.

4

41

metro1500switchReference
LaserOff

metro1500SlotNumber

Reference laser is switched off.

4

42

metro1500switchtoA

metro1500SlotNumber

Switch goes to line A.

4

43

metro1500switchtoB

metro1500SlotNumber

Switch goes to line B.

4

44

metro1500switchAutomatic

metro1500SlotNumber

Switch goes to automatic mode.

4

45

metro1500switchLocked

metro1500SlotNumber

Switch goes to locked mode.

4

46

metro1500switchLineAavail

metro1500SlotNumber

Line A is now available.

4

47

metro1500switchLineA
Notavail

metro1500SlotNumber

Line A is not available.

4

48

metro1500switchLineBavail

metro1500SlotNumber

Line B is now available.

4

49

metro1500switchLineB
Notavail

metro1500SlotNumber

Line B is not available.

4

50

metro1500bufferOverflow

metro1500SlotNumber

The traps followed by three traps of the same type are dropped.

4


Telnet

The Telnet protocol is designed to work between any host and any terminal. It operates in a client/server environment in which one host negotiates a session on another host. During the negotiation process, the two hosts agree on the parameters governing the session. You need a username and password on the Telnet server. The base Telnet protocol specification is defined in RFC 854.

ocmstate

After logging in, you can use the ocmstate program to get basic information on the system. Figure 5-7 shows an example.

Figure 5-7 Output from ocmstate

Table 5-11 describes the ocmstate options.

Table 5-11 ocmstate Options

Option
Description

e

Expert mode, change settings.

l

Get information.

p

Update the information periodically.

s

Show transmitter and receiver states.

?

Get version details.

0 to 19

Get slot information.


To get more information about the installed Wavelength Channel Modules (WCMs), you can enter ocmstate -l ( Figure 5-8). You can also use ocmstate -p, which forces ocmstate to update its output periodically.

Figure 5-8 Output from ocmstate -l

After entering ocmstate -s, you get information on the status of all local and remote receivers and transmitters ( Figure 5-9).

Figure 5-9 Output from ocmstate -s

To get the version information, enter ocmstate -?. Inputs with the format of ocmstate - # are also supported. Figure 5-10 shows the result of an ocmstate -3.

Figure 5-10 Output from ocmstate -3


Note If you want to perform set actions, enter e, for the expert mode option.


In expert mode you have the option to change the loop settings and the transmitter settings.

Figure 5-11 shows the output from the ocmstate -e -3 command.

Figure 5-11 Output from ocmstate -e -3

If you select s, you see the prompt as shown in Figure 5-12.

You can enter l or r to toggle the remote or local loop.

Figure 5-12 Loop Settings

If you select t, you see the prompt as shown in Figure 5-13.

Figure 5-13 Laser Settings

In expert mode you can also set the Remote Switch Module (RSM). If the RSM is installed at slot 9 and you enter ocmstate -e -9, the result is shown in Figure 5-14.

After execution of the lock or unlock command, you get a short report as shown in Figure 5-14.

Figure 5-14 Output from switchsetting

clockset

If you want to directly set multiclock options, use the clockset program. After typing clockset the main information screen appears.

Type in the desired slot number to view the card and receive options. A shortcut command is available for directly accessing cards in specific slots. Type the following to directly access a card in any given slot.

clockset-[slotnumber]

If you want to get version information, type clockset -?

snmpconfig

While netconfig is used to customize SNMP for just one network manager address with a standard configuration, snmpconfig is used for fine tuning the SNMP parameters. The snmpconfig command can address up to 10 network managers. Events and manager can be configured with different priorities to adjust the SNMP behavior to your requirements. Log files are treated in the same way as network manager addresses.

Events have assignable priorities ranging from 1 (very important), to 10 (informal), and 20 (don't report).

Trap sink reporting and logging into the log files is controlled by assigning to these receivers a reporting level with the same range from 1 to 10. See Figure 5-15.

By entering the snmpconfig command, you will get the main screen, which shows most of the SNMP settings ( Figure 5-15).

Figure 5-15 Main Screen

The first two lines of Figure 5-15 describe the settings of the log files. While the RAM log file has the priority 10 (get all events), the Flash log file gets only important information. Two trap sinks are defined (SNMP managers that receive SNMP traps) with priority 5. There is an option for setting the communities for read and write and to set system location and system contact, which is described later in this section.

Use the snmpconfig commands to fine tune the parameters for the network:

Add a new trap sink by entering a. You must enter a new IP address, a community string, and a priority level. The new trap sink is shown on the screen.

Delete an existing trap sink by entering d. A list of all trap sinks is shown and you have to enter the number of the trap sink to delete it.

Change the settings of the log files by entering l. You can change the size and the priorities of the files.

Change the priorities of any event by entering e. A list of all events and priorities is shown and can be changed.

Test the settings by entering the number of the trap sink or the log file. Enter f, r, or a number between 0 and 9. A list of all events is shown, which is sent to the specified log file or trap sink.

The previous settings are used for reporting SNMP traps, the next four settings change the behavior for the SNMP get and set instructions. The read community string is used for any SNMP get or getnext instruction. The instruction is only answered by the SNMP agent on the correct (read or write) community string. The write community string is sent with every SNMP set instruction. The instruction is only executed on the correct write community string. The community strings are used to increase security on SNMP.

The standard SNMP variables, system location and system contact, are defined in RFC 1213. They are used to manage SNMP agents on a large network. System location should be a short string that describes the location of the SNMP agent. System contact is the person who is responsible for this agent. These values can be set by snmpconfig. By entering s, save and exit, the settings are stored. The settings are activated after the next reboot.


Note The computer must be rebooted to have these settings take effect.



hometocprevnextglossaryfeedbacksearchhelp

Posted: Tue Apr 26 05:59:07 PDT 2005
All contents are Copyright © 1992--2005 Cisco Systems, Inc. All rights reserved.
Important Notices and Privacy Statement.