|
This chapter allows you to customize the way your LightStream 2020 enterprise ATM switch displays and logs traps. The procedures in this chapter provide you with a great deal of flexibility in trap management. Use these procedures to:
Figure 2-1, Figure 2-2, and Figure 2-3 show how traps flow through the LightStream 2020 node. They also show the CLI commands that you can use to affect the flow of traps. Each of these commands is explained in more detail within this chapter.
You determine which traps are displayed by setting the trap reporting threshold, or trap level. There are four trap reporting threshold settings: operational, informational, trace, and debug.
Table 2-1 shows the effect of setting the trap reporting threshold at different levels. As indicated in the table, if you enable a certain trap level, then traps at and above that priority are reported. For instance, if you set the trap reporting threshold to trace, trace traps and all higher priority traps (informational, operational, and SNMP) are reported; debug traps are not reported.
Table 2-1 Trap Reporting Thresholds
Figure 2-4 identifies the different places in the system where you can set the trap reporting threshold. In essence, setting the trap reporting threshold creates a trap filter that either passes the trap to the next process in the system or drops it. At each trap filter, you can set the reporting threshold to operational, informational, trace, or debug.
As shown in Figure 2-4, you can filter traps:
The following sections describe how you can change the various trap filter settings. However, the default settings are appropriate for most networks.
Setting the trap reporting threshold for a particular process determines which traps generated by that process are passed to the MMA. Traps that are passed from the processes into the MMA are, by default, logged in the trap log. The default trap reporting threshold for all processes is informational. This level is appropriate for most applications. (Note that the console port transmits all traps that are recorded in the trap log.)
Figure 2-5 shows what happens when a process filter is set to the default, informational.
Follow the procedure below to set the trap reporting threshold for processes.
If you need instructions on changing the target switch, refer to the LightStream 2020 Network Operations Guide.
Step 2 Set the SNMP community to a read/write community by entering the following at the cli> prompt:
<community name> = The SNMP read/write community that you want to access.
Step 3 Enter the following at the cli> prompt to display a list of the processes:
This command lists the PID (process identification) numbers and alias names of all the processes running on this LightStream 2020 switch. The PID numbers follow the term Name: lwmaTrapCliAlias and the alias names follow the term Value, as shown in Figure 2-6.
Select the process(es) you want from the list.
Step 4 To set the trap reporting threshold for a selected process, enter the following at the cli> prompt:
{<#>|<alias>} = The process number or alias name.
<value> = oper
Step 5 Verify the process trap reporting threshold by entering the following at the cli> prompt:
The trap reporting threshold for the specified process filter is changed to the level you specified. All traps at that new level (and higher) are passed from the process to the MMA.
The trap reporting threshold for the chassis determines which traps are passed from the MMA to the CLI process and to the NMS. The default trap reporting threshold for the chassis is operational. This level is appropriate for most networks.
Figure 2-7 shows what happens when the chassis filter is set to the default, operational, and the process filter has been set to its default, informational.
Note The traps that are passed to the CLI process from the MMA must also pass the CLI session
filter (see the section that follows,
"Setting the Trap Reporting
Threshold for a CLI Session
") to be displayed. The traps passed to the NMS from the MMA are
displayed on the NMS, unless the NMS has its own filtering capabilities.
Note The trap reporting threshold for the chassis is normally set during network configuration. If
you want to temporarily change the configured setting, use the procedure below. (The change will
be lost if the switch reboots.) If you want to make a permanent change to the Trap Filter attribute,
use the LightStream 2020 configurator to edit the configuration and update the appropriate node, as
described in the LightStream 2020 Configuration Guide.
If you need instructions on changing the target switch, refer to the LightStream 2020 Network Operations Guide.
Step 2 Set the SNMP community to a read/write community by entering the following at the cli> prompt:
<community name> = The SNMP read/write community that you want to access.
Step 3 Set the trap reporting threshold for the chassis filter by entering the following at the cli> prompt:
<value> = oper (default)
Step 4 Verify that the trap reporting threshold has been changed by entering the following at the cli> prompt:
The trap reporting threshold for the chassis filter is changed to the level you specified. All traps at that new level (and higher) are sent to the CLI and the NMS.
The trap reporting threshold setting for the CLI session determines which traps are displayed by the terminal running the CLI session. The default trap reporting threshold for the CLI is debug. This level is appropriate for most applications.
Figure 2-8 shows what happens when the CLI session filter is set to the default, debug, and the process and chassis filters have also been set to their defaults.
If you need instructions on changing the target switch, refer to the LightStream 2020 Network Operations Guide.
Step 2 Enter the following at the cli> prompt to set the trap reporting threshold for the CLI:
<value> = off displays no traps
Step 3 Verify that the trap reporting threshold for the CLI has been changed by entering the following at the cli> prompt:
The trap reporting threshold for the CLI session filter is changed to the level you specified. All traps at that new level (and higher) are displayed by the CLI.
The trap reporting threshold setting for the console filter in each LightStream 2020 switch determines which traps are displayed on the local console (if the node has a local console). By default, traps are displayed automatically whenever a console is started. The default trap reporting threshold for the console filter is informational. This level is appropriate for most applications. (Note that the console port transmits all traps that are recorded in the trap log; disabling individual traps does not prevent them from displaying on the console.)
Figure 2-9 shows what happens when the console filter is set to the default, informational, and the process filter has also been set to its default, informational.
Follow the procedure below to set the trap reporting threshold for the filtering mechanism.
If you need instructions on changing the target switch, refer to the LightStream 2020 Network Operations Guide.
Step 2 Set the SNMP community to a read/write community by entering the following at the cli> prompt:
<community name> = The SNMP read/write community that you want to access.
Step 3 Set the trap reporting threshold for the console or turn off the console display by entering the following at the cli> prompt:
<value> = off displays no traps
Step 4 Verify that the console trap reporting threshold has been changed by entering the following at the cli> prompt:
The trap reporting threshold for the console is changed to the level you specified. All traps at that new level (and higher) are displayed by the console.
There are three places that it is possible to view traps:
On the LightStream 2020 console or in the CLI, traps are displayed in the format described in the section "Trap Types" in the chapter "About LightStream 2020 Traps." Trap messages may be interleaved with the other information displayed by the CLI, depending on how your system is set up. Figure 2-10 shows a typical CLI display including traps.
If you use an NMS, the message format may vary from the format described earlier, but the content is the same. (Refer to the NMS documentation for information on viewing traps there.)
You can log the traps that occur on each LightStream 2020 switch. The traps are stored on the NP of the switch in a file called mma.traplog in the /usr/tmp/mma directory. This circular file can store approximately 6000 traps before the oldest trap is overwritten by the newest trap. Which traps are logged is determined by the trap reporting thresholds set for each process. This section tells you how to enable, disable, and view the trap log.
You may also be able to log traps at the NMS. Refer to the NMS documentation for more information.
This section tells you how to enable or disable the trap log for a particular LightStream 2020 switch. Traps cannot be logged unless the trap log is enabled.
The default setting for the trap log is enabled (on). This setting is appropriate for most networks.
You usually specify whether the trap log is enabled or disabled during network configuration. If you want to temporarily change the configured setting, use the procedure below. (The change is lost if the system is rebooted.) If you want to make a permanent change to the Trap Log Status attribute, use the LightStream 2020 configurator to edit the configuration and update the appropriate node, as described in the LightStream 2020 Configuration Guide.
If a node's trap log file is moved or deleted, trap logging is effectively disabled. If the file /usr/tmp/mma/mma.traplog is not present, you can use this procedure to re-enable trap logging.
If you need instructions on changing the target switch, refer to the LightStream 2020 Network Operations Guide.
Step 2 Set the SNMP community to a read/write community by entering the following at the cli> prompt:
<community name> = The SNMP read/write community that you want to access.
Step 3 Enable or disable the trap log for a particular chassis by entering the following at the cli> prompt:
<value> = onenables the trap log (default)
Step 4 Verify that the traplog has been enabled or disabled for a particular chassis by entering the following at the cli> prompt:
The trap log for the specific chassis is enabled or disabled, as specified.
Any traps passed from the software processes to the MMA are recorded in a circular file, /usr/tmp/mma/mma.traplog. This section tells you how to view the trap log from LynxOS, view the trap log from the CLI, and copy the file to another workstation so you can view it there.
If you are working in the LynxOS shell, you can view the trap log by entering the following at the prompt:
For more information on the cbufpr command, refer to the LightStream 2020 NP O/S Reference Manual.
If you are working in the CLI, you can view the trap log by entering the following at the CLI prompt:
You can use the optional -tail argument with the show file command to display the last 20 (or so) lines of the log file. For more information on the show file command, refer to the LightStream 2020 CLI Reference Manual.
If you are working in the CLI, you can use the following procedure to move the trap log to another system. If you are working in the LynxOS shell, you can just use ftp.
Note Before attempting to move the trap log from the NP, obtain a user name and password for an
account on the workstation or host where you want to place the trap log.
Step 2 Enter the protected mode password when you see the following prompt:
Step 3 To unwind the circular log file, type the following at the *cli> prompt:
The traplog file is a temporary file.
Step 4 At the *cli> prompt, enter:
You are prompted to log in to the workstation or host.
Step 5 Log in to the workstation or host.
Step 6 To place the trap log file in any directory other than the login directory on the workstation or host, enter cd <directory name> to change to the correct working directory.
Step 7 Enter the following at the ftp> prompt:
[<new name>] = The file name identifying the chassis or the appropriate directory name for the file. For example, if you are moving a trap log for a switch called Light5, the new name could be mma_Light5.traplog.
This command sends the log file to the specified workstation or host. The system tells you when the file transfer is complete.
Step 8 Enter the following at the ftp> prompt:
Use any more or cat command or a screen editor such as emacs or vi to view the mma.traplog file on the workstation or host.
Step 9 To remove the temporary traplog file, type
Figure 2-11 shows an example of a trap log. Traps with no switch name have been generated by the local node. Traps that include a switch name have been generated by another LightStream 2020 node and reported to the local node.
You can control the reporting of individual traps. This gives you greater flexibility in choosing which traps are reported. Using the capabilities provided in this area, you can:
These capabilities are especially useful for advanced debugging and troubleshooting. Because it is anticipated that only experienced users need this functionality, the commands associated with individual traps must be executed from the CLI in protected mode.
Note The console port transmits all traps that are recorded in the trap log; disabling individual
traps does not prevent them from displaying on the console.
This section tells you how to turn a particular trap on or off in a specific process. Turning a trap on in a particular process allows it to be passed to the MMA, even if it has a severity level below the trap reporting threshold set for the process. This allows you to report a particular trap without reporting all traps at that level. This procedure is especially important during troubleshooting and debugging.
Figure 2-12 shows the effect of turning a trap on when the process filter is set to the default, informational.
In some cases you may have multiple instances of the same process running. Therefore, you can also turn a trap on globally so that it affects the trap in each instance of the process.
The default for all traps in all processes is off. When a trap is set to off (the default), the trap is passed to the MMA only if its severity level is equal to or higher than the trap reporting threshold setting of the process filter.
Step 2 Enter the protected mode password when you see the following prompt:
Step 3 Verify that the target switch is correct by entering the following at the cli> prompt:
If you need instructions on changing the target switch, refer to the LightStream 2020 Network Operations Guide.
Step 4 Set the SNMP community to a read/write community by entering the following at the *cli> prompt:
<community name> = The SNMP read/write community that you want to access.
Step 5 To determine which processes are running on this node, enter the following at the *cli> prompt:
Find the process you want in the resulting list. Figure 2-6 shows the output from this command.
Step 6 Turn a trap on or off as follows:
For a trap in one instance of a process, at the *cli> prompt, enter:
Or for a trap in multiple instances of a process (globally), at the *cli> prompt, enter:
Step 7 To display the status of each trap in the selected process, enter the following at the *cli> prompt:
The trap(s) that you have turned on pass to the MMA whenever that trap is generated in the selected process. Traps that are turned off pass to the MMA only if they have an equal or higher severity level than the process filter.
This section tells you how to enable or disable individual traps for all processes. (Compare this with the previous procedure, which lets you enable or disable a trap for one particular process.) When you disable a trap in a switch, the MMA discards it rather than passing it on to the display device. You may want to disable a trap if it recurs regularly and you feel that its display is unnecessary.
Figure 2-13 shows what happens when traps are enabled, which is the default.
Step 2 Enter the protected mode password when you see the following prompt:
Step 3 Verify that the target switch is correct by entering the following at the *cli> prompt:
If you need instructions on changing the target switch, refer to the LightStream 2020 Network Operations Guide.
Step 4 Set the SNMP community to a read/write community by entering the following at the *cli> prompt:
<community name> = The SNMP read/write community that you want to access.
Step 5 At the *cli> prompt, enter:
Step 6 Enter the following at the *cli> prompt to display the status of each trap in the MMA:
The disabled trap for the selected node is not passed to the CLI or displayed on a third-party NMS. The status display shows traps as either on, off, or disabled. If the status is either on or off, the trap is enabled. Otherwise the trap is disabled. See the section "Turning a Trap On or Off in a Specific Process
" earlier in this chapter for a description of on and off.
This section tells you how to view the status of every trap within a particular process or for an MMA. The status display shows traps as either on or off and enabled or disabled. See the section "Turning a Trap On or Off in a Specific Process
" earlier in this chapter for a description of on/off. See the section "Enabling/Disabling a Trap for All Processes
" earlier in this chapter for a description of enabled/disabled.
If you need instructions on changing the target switch, refer to the LightStream 2020 Network Operations Guide.
Step 2 Set the SNMP community to a read/write community by entering the following at the cli> prompt:
<community name> = The SNMP read/write community that you want to access.
Step 3 At the cli> prompt, enter:
If you need instructions on changing the target switch, refer to the LightStream 2020 Network Operations Guide.
Step 2 Set the SNMP community to a read/write community by entering the following at the cli> prompt:
<community name> = The SNMP read/write community that you want to access.
Step 3 At the cli> prompt, enter:
If you enter show trap ndd_3 ndd_4 ndd_5 ndd_1001, the status of these traps is displayed, as shown in Figure 2-14.
If you enter show trap "*" the status of all traps in the MMA is shown in Figure 2-15. (Figure 2-15 is a partial display. Several screens of traps are displayed when you issue this command.)
The cli.groups file defines groups of traps. You can use this file as an argument for the commands described in the two preceding procedures. If you do not create and maintain this file, you must manually enter each trap number used with those commands.
Follow the procedure below to create the cli.groups file.
Step 2 Enter the protected mode password when you see the following prompt:
Step 3 Escape from the CLI to the LynxOS bash shell by entering the following at the *cli> prompt:
Step 4 Move to the /usr/app/base/config directory by entering the following at the prompt:
Step 5 Invoke the vi editor by entering the following at the prompt:
When the editor opens the file, enter the group names and trap numbers in the format shown below. Note that each group definition begins with a colon.
The contents of your file will be similar to this:
Step 6 When you have finished entering the group names and trap numbers in the file, exit the vi editor by pressing the [Esc] key or ^[ followed by typing:
Step 7 To return to the CLI, enter the following at the prompt:
Step 8 To exit protected mode, enter the following at the *cli> prompt:
Traps Reported
Trap
Reporting Threshold
OPER
INFO
TRACE
DEBUG
SNMP
Figure 2-4 By setting the trap reporting threshold at a particular trap filter, you can prevent traps from being passed to the next process
Setting the Trap Reporting Threshold for Processes
Figure 2-5 Traps of all priority levels are generated by the software process. However, only SNMP, operational, and informational traps are passed to the MMA.
Procedure
Step 1 Verify that the target switch is correct by entering the following at the cli> prompt:
Figure 2-6 Typical walksnmp display.
info (default)
trace
debug
Expected Results
Setting the Trap Reporting Threshold for the Chassis
Figure 2-7 Although SNMP, operational, and informational traps are received by the MMA, only SNMP and operational traps are passed to the CLI process and the NMS because the chassis filter is set to operational.
Step 1 Verify that the target switch is correct by entering the following at the cli> prompt:
info
trace
debug
Expected Results
Setting the Trap Reporting Threshold for a CLI Session
Figure 2-8 All traps reported to the MMA are displayed in the CLI. Setting the default to debug ensures that any trap (regardless of its level) is displayed in the CLI. This is important because you can override the filter settings on an individual trap basis (by turning it on) using the procedures in the section "Managing Individual Traps".
Procedure
Step 1 Verify that the target switch is correct by entering the following at the cli> prompt:
oper
info
trace
debug (default)
Expected Results
Setting the Trap Reporting Threshold for the Console
Figure 2-9 All SNMP, operational, and informational traps passed to the MMA are displayed on the local console.
Procedure
Step 1 Verify that the target switch is correct by entering the following at the cli> prompt:
oper
info (default)
trace
debug
Expected Results
Viewing Traps
Figure 2-10 Typical CLI traps display.
Logging Traps
Enabling or Disabling the Trap Log
Caution
If you disable the trap log for a particular switch, you will not have a record of the traps that were reported if a problem occurs. Procedure
Step 1 Verify that the target switch is correct by entering the following at the cli> prompt:
offdisables the trap log
Expected Results
Viewing the Trap Log
Procedure 1: Viewing the Trap Log from LynxOS
Procedure 2: Viewing the Trap Log from the CLI
Moving the Trap Log from the NP
Step 1 To enter protected mode, needed to execute the shell command, at the cli> prompt, enter:
Expected Results
Figure 2-11 Trap log example.
Managing Individual Traps
Turning a Trap On or Off in a Specific Process
Figure 2-12 Turning a trap on overrides the trap reporting threshold of the process filter. If the filter is set to informational, and you turn on a particular debug trap, then that debug trap is also passed to the MMA.
Procedure
Step 1 At the cli> prompt, enter:
Expected Results
Enabling/Disabling a Trap for All Processes
Figure 2-13 The MMA checks to see if the trap is enabled or disabled. If the trap is enabled and its severity level is equal to or greater than the CLI session and console filters, the trap is passed to the CLI and the NMS. If the trap is disabled, it is dropped.
Procedure
Step 1 At the cli> prompt, enter:
Expected Results
Displaying Trap Status
Procedure 1: View the Status of One or More Traps for a Process
Step 1 Verify that the target switch is correct by entering the following at the cli> prompt:
Procedure 2: View the Status of One or More Traps for an MMA
Step 1 Verify that the target switch is correct by entering the following at the cli> prompt:
Expected Results
Figure 2-14 Sample status display for specific traps.
Figure 2-15 Sample status display for all traps.
Creating the cli.groups File
Procedure to Create the cli.groups File
Step 1 To enter protected mode, enter the following at the cli> prompt:
Posted: Thu Jan 23 20:55:11 PST 2003
All contents are Copyright © 1992--2002 Cisco Systems, Inc. All rights reserved.
Important Notices and Privacy Statement.