|
The Initialization chapter explained how to assign basic configuration information (including an IP address, net mask, and default gateway address) to a SwitchProbe device. This chapter explains how to use the Agent Configuration Utility to customize a SwitchProbe device and its interfaces.
Throughout many of the procedures, you will need to access the Agent Configuration Utility and navigate through various menus to configure your SwitchProbe device to best suit your monitoring needs.
A community name is a tool that SNMP uses to authorize communication between devices. Authorization is based upon the commonality of each device's community name. Devices that have the same read community namefor example "look"can obtain (get) information from each other.
The importance of a community name and its security function is evident when you think of communication between a SwitchProbe device and a management station. If the read community name established for a SwitchProbe device is different from the read community name associated with that SwitchProbe device at the management station, the management station will not be able to obtain information from that SwitchProbe device.
The read community name can be any 32-byte ASCII character string. The default value is "public."
To change the read community name, follow these steps:
Step 1 From the Agent Configuration Utility main menu, enter 4 and press Enter.
Step 2 Enter the name you want to assign as the SwitchProbe read community and press Enter.
The Agent Configuration Utility main menu displays again with the new name in the read community field. However, this new name will not take effect until you reset the SwitchProbe agent.
For more information about resetting the SwitchProbe agent, see "Resetting a SwitchProbe Device Agent."
The following example shows the Agent Configuration Utility main menu:
***** Ethernet SwitchProbe Rev 4.5 *****
Interface number : 1
[1] Change IP Address 172.20.57.219
[2] Change Net Mask 255.255.255.192
[3] Change Default Gateway Address 172.20.57.193
[4] Change Read Community public
[5] Change Write Community public
[8] Select Interface ETHERNET
[9] Change Server Address 172.20.57.253
[10] Upgrade Software
[11] Enter Command-line mode
[12] Reset Agent
[31] Go to Next Page
Enter your response or hit Esc to Abort
Selection#: 4
New Read Community [public]:
A community name is a tool that SNMP uses to authorize communication between devices. Authorization is based upon the commonality of each device's community name. Devices that have the same write community namefor example "tell"can send (set) information to each other.
The importance of a community name and its security function is evident when you think of communication between a SwitchProbe device and a management station. If the write community name established for a SwitchProbe device is different than the write community name established at the management station, the management station will not be able to send information to that SwitchProbe device.
The write community name can be any 32-byte ASCII character string. The default value is "public."
To change the write community name, follow these steps:
Step 1 From the Agent Configuration Utility main menu, enter 5 and press Enter.
Step 2 Enter the name you want to assign as the SwitchProbe's write community and press Enter.
The Agent Configuration Utility main menu displays again with the new name in the write community field. However, this new name will not take effect until you reset the SwitchProbe agent.
For more information about resetting the SwitchProbe agent, see "Resetting a SwitchProbe Device Agent."
Using the Cisco Configuration Protocol, the SwitchProbe device can automatically download configuration information (such as domains, property files, and so on) from the TrafficDirector application whenever the device boots or resets. The server IP address identifies the system to which the SwitchProbe device will send configuration requests whenever the device boots or resets.
To enter or modify a SwitchProbe device server address, follow these steps:
Step 1 From the Agent Configuration Utility main menu, enter 9 and press Enter.
Step 2 Enter the IP address of the desired server and press Enter.
The Agent Configuration Utility main menu is displayed again with the new address in the server address field. This new address takes effect immediately.
Most changes to a SwitchProbe device agent settings do not take effect until you reset the agent. Therefore, if you make changes to the agent settings, you must reset the agent before you exit the Agent Configuration Utility.
To reset a SwitchProbe device agent, follow these steps:
Step 1 Access the Agent Configuration Utility main menu.
Step 2 Enter 12 and press Enter.
The following message is displayed:
WARNING: agent will be reset, confirm [n] y
To save the new settings, go to Step 3; otherwise, go to Step 4.
Step 3 Enter y and press Enter to save the new settings.
The SwitchProbe device reboots with the new settings in its agent code.
Step 4 Enter n and press Enter if you do not want to save the new agent settings.
The new settings will remain in their respective fields and appear to be in effect; however, the settings previously in the SwitchProbe device when it was last reset, will be applied.
When you use the Select Probe Mode option, the following three options are displayed in a sub-menu:
These options allow you to set the mode of the Multiport Fast Ethernet SwitchProbe device interfaces.
To select the mode, follow these steps:
Step 1 Access the Agent Configuration Utility.
Step 2 Enter the desired option number and press Enter.
The Agent Configuration Utility main menu is displayed again. New values do not take effect until you reset the SwitchProbe agent.
For more information about resetting the SwitchProbe agent, see "Resetting a SwitchProbe Device Agent."
All SwitchProbe devices contain more than one interface. The selected interface number always appears in the upper left portion of the Agent Configuration Utility menu. The topology of that interface appears next to the Select Interface menu option.
To modify the parameters of a SwitchProbe device interface, you must first select that interface. If the selected interface is not the interface you want, you must select the correct interface.
To do so, follow these steps:
Step 1 From the Agent Configuration Utility main menu, enter 8 and press Enter.
The Select Interface Screen is displayed:
Selection# 8
Select the interface:
[1] ETHERNET MODE = MANAGE + MONITOR
[2] SERIAL MODE = MANAGE
[3] ETHERNET MODE = MONITOR
New interface [1]:
A list containing the interface number, topology, and mode of each of the SwitchProbe device interfaces is displayed. The number of the selected interface appears next to the New Interface label at the bottom of the screen.
Step 2 Select a different interface by entering the interface number.
For example, if a WAN interface is identified as interface 3, enter 3 and press Enter. If the interface you want is already selected, press Enter.
The Agent Configuration Utility main menu is displayed again. The number of the selected interface is displayed in the upper left area of the screen (next to the interface number label).
SwitchProbe devices use network interfaces to receive network traffic, or to exchange management data with a management station, or to perform both tasks simultaneously. Each interface in a SwitchProbe device is set to a default mode during manufacturing.
The task that a particular interface performs is determined by the interface modeManage, Monitor, or Manage + Monitor.
Table 7-1 describes the interface modes.
This Mode... | Performs This Function |
Manage | Exchanges (sends and receives) management data with an attached management station. |
Monitor | Receives network traffic for mapping statistical information into standard RMON-based counters. |
Manage + Monitor | Exchanges management data and receives network traffic on the same interface. |
The Configure Interface Options (option 14) of the Agent Configuration Utility main menu allows you to change the mode of a SwitchProbe device's currently selected interface.
To change the mode, follow these steps:
Step 1 Access the Agent Configuration Utility main menu.
Step 2 Verify the interface in the Select Interface field.
If the interface you want to configure appears in this field, proceed to Step 3. Otherwise, select the interface you want to configure. For more information, see "Selecting the Interface."
Step 3 Enter 14 and press Enter at the Selection # prompt.
The interface options menu is displayed. The number of the current selected interface is listed next to the interface number label.
For more information about interface numbers, see "Interface Numbers" in the next section.
Step 4 Enter 11 and press Enter to toggle the setting of the interface manage mode.
The setting will change to its opposite value (on to off, or off to on).
Step 5 Enter 12 and press Enter to toggle the setting of the interface monitor mode.
The setting will change to its opposite value (on to off, or off to on).
The interface options menu is displayed again with any new value in the manage mode or monitor mode fields. However, changes do not take effect until you exit the interface options menu.
Step 6 Enter 13 and press Enter.
Step 7 Reset the SwitchProbe agent.
For more information about resetting the SwitchProbe agent, see "Resetting a SwitchProbe Device Agent."
Each interface in a SwitchProbe device is assigned an interface number. Because every SwitchProbe device has at least one network interface card and only one PCC interface card, Cisco Systems assigns interface 1 and interface 2 to these interfaces, respectively.
WAN, Fast Ethernet, and ATM SwitchProbe devices contain special interface options described in the following sections:
The Configure Interface Options sub-menu contains additional options when you select a WAN interface. These options allow you to customize a WAN interface to monitor Frame Relay data.
To accurately monitor the selected WAN Frame Relay segment, verify that the WAN interface is correctly configured for the network segment you are monitoring. For more information, see "DLCI MonitoringWAN SwitchProbe Device" in "DLCI & VPI/VCI Monitoring."
The following section explains each of the options in the sub-menu for monitoring WAN Frame Relay segments:
To set interface options to monitor Frame Relay on a WAN network segment, follow these steps:
Step 1 From the Agent Configuration Utility, enter 8 and press Enter.
Step 2 Select the number corresponding to the WAN interface you want to configure and press Enter.
Step 3 Enter 14 and press Enter.
Step 4 Select the number corresponding to the option you want to toggle (on or off) and press Enter.
Step 5 Enter 12 and press Enter.
Step 6 Reset the SwitchProbe agent.
For more information about resetting the SwitchProbe agent, see "Resetting a SwitchProbe Device Agent."
The Configure Interface Options sub-menu contains two special options when you select a single or multiport Fast Ethernet interface. These options allow you to customize the Fast Ethernet interface.
To set interface options for a Fast Ethernet interface, follow these steps:
Step 1 From the Agent Configuration Utility, enter 8 and press Enter.
Step 2 Select the number corresponding to the Fast Ethernet interface you want to configure and press Enter.
Step 3 Enter 14 and press Enter.
Step 4 Select the number corresponding to the option you want to toggle (on or off) and press Enter.
The Interface Options Menu is displayed again with any new values in the appropriate fields. However, changes do not take effect until you exit the Interface Options Menu.
Step 5 Enter 12 and press Enter.
Step 6 Reset the SwitchProbe agent.
For more information about resetting the SwitchProbe agent, see "Resetting a SwitchProbe Device Agent."
On Fast Ethernet SwitchProbe devices, you can include or exclude dribble errors as part of the CRC/align error count. The following applies:
To change the discard_dribbles option, follow these steps:
Step 1 Access the Agent Configuration Utility.
Step 2 Enter 8 and select the Fast Ethernet interface.
Step 3 Enter 11 and press Enter.
Step 4 Use the get if_options discard_dribbles command to check the current status of the discard_dribbles option.
Step 5 Enable or disable the option as follows:
The Configure Interface Options sub-menu contains a special option when you select an ATM interface.
Toggle rawhdr_captureAllows you to include the VPI/VCI information in any data capture of the interface's packets.
To change the current setting in the Toggle rawhdr_capture field, follow these steps:
Step 1 From the Agent Configuration Utility, enter 8 and press Enter.
Step 2 Select the number corresponding to the ATM interface and press Enter.
Step 3 Enter 14 and press Enter.
Step 4 To change the setting in the Toggle rawhdr_capture field to its opposite value (on to off, or off to on), enter the option number 8 and press Enter.
The Interface Options Menu is displayed again with the new value in the Toggle rawhdr_capture field. However, changes do not take effect until you exit the Interface Options Menu.
Step 5 Enter 12 and press Enter.
Step 6 Reset the SwitchProbe agent.
For more information about resetting the SwitchProbe agent, see "Resetting a SwitchProbe Device Agent."
When you select Change ATM MIB Parameters from the Agent Configuration Utility main menu, options appear in a sub-menu that allow you to perform the following tasks:
The following list summarizes each of the options:
To modify the value of an ATM MIB parameter, follow these steps:
Step 1 From the Change ATM MIB Parameters sub-menu, enter an option number and press Enter.
Step 2 Enter the desired value and press Enter.
Step 3 Return to the Agent Configuration Utility main menu by entering 8 and pressing Enter.
The Agent Configuration Utility main menu is displayed again. New values do not take effect until you reset the SwitchProbe agent.
For more information about resetting the SwitchProbe agent, see "Resetting a SwitchProbe Device Agent."
When you select Configure Agent Options from the Agent Configuration Utility main menu, a sub-menu of options and their current state (on or off) are displayed in a sub-menu. These options allow you to control specific enhanced functionality of a SwitchProbe device.
To toggle the setting of an option, follow these steps:
Step 1 Enter the option number and press Enter.
Step 2 To return to the Agent Configuration Utility main menu, enter 9 and press Enter.
The following list summarizes each of the agent options:
SwitchProbe devices automatically install the RMON1 and RMON2 protocol domains when booted. You cannot deinstall network-layer protocol domains that the SwitchProbe device installs automatically. Instead, when you remove a network-layer protocol domain, host and conversation groups are disabled for the protocol domain; the domain remains installed on the agent with only the statistics group enabled.
Table 7-2 shows the list of protocol domains the SwitchProbe device automatically installs upon reset.
AOL | DLSW_WR | IPIP | NNTP | SNA | VINES |
---|---|---|---|---|---|
ARP | DNS_TCP | IPIP4 | NOTESTCP | SNA_TCP | VINESIPC |
AT_ATP | DOOM | IPV6 | NOVRIP | SNMP | VINESIPC |
AT_DSP | EGP | IPX | NOVSAP | SNMPTRAP | VINESRTP |
AT_NBP | FTP-CTRL | IPX1_UDP | NTP | SOCKET | VINESSPP |
AT_RTMP | FTP-DATA | NB_DGM_T | ORACLSQL | SQLNET_N | XNS |
AT_RTREQ | GGP | NB_NS_T | OSI | SUNRPC | XNS_PEP |
AT_ZIP | HTTP | NB_SSN_T | OSPF | SUNRPC_T | XNS_RIP |
ATALK | HTTPS | NCP | REALAUD | TCP | XNS_SPP |
BGP_TCP | ICMP | NET~ | RIP | TCP~ | XWINDOW |
COMPUSRV | IGMP | NETB | RMON | TELNET |
|
DECLAT | IGRP | NEWS_TCP | SIPP-AH | TFTP |
|
DECNET | IP | NEWS_UDP | SIPP-ESP | UDP |
|
DLSW_RD | IP~ | NFS | SMTP | UDP~ |
|
You can configure default RMON1/RMON2 parameters set in the SwitchProbe device when it boots. The configuration you specify applies to all SwitchProbe interfaces. For example, if you set max_host to a maximum of 10000, each interface can track statistics for 10000 hosts.
Table 7-3 shows the RMON1 parameters you can configure.
Select This Parameter... | To Configure |
---|---|
[1] Change max_host | Maximum number of hosts for which each interface tracks MAC-layer statistics. |
[2] Change max_matrix | Maximum number of conversations for which each interface tracks MAC-layer statistics. |
[3] Change sh_buckets | Maximum number of buckets each interface uses to store short-term history statistics. |
[4] Change lh_buckets | Maximum number of buckets each interface uses to store long-term history statistics. |
[5] Change sh_interval | Interval at which the SwitchProbe device gathers and stores short-term history statistics for each interface. |
[6] Change lh_interval | Interval at which the SwitchProbe device gathers and stores long-term history statistics for each interface. |
[7] Change dlci_sh_buckets | Maximum number of buckets the SwitchProbe device uses to store short-term history statistics for each DLCI. |
[8] Change dlci_lh_buckets | Maximum number of buckets the SwitchProbe device uses to store long-term history statistics for each DLCI. |
[9] Change dlci_sh_interval | Interval at which the SwitchProbe device gathers and stores short-term history statistics for each DLCI. |
[10] Change dlci_lh_interval | Interval at which the SwitchProbe device gathers and stores long-term history statistics for each DLCI. |
[11] Toggle start_stats | Tracking of RMON1 statistics for each interface and all DLCIs during boot. |
[12] Toggle start_history | Tracking of short- and long-term history statistics for each interface and all DLCIs during boot. |
Table 7-4 shows the RMON2 parameters you can configure.
Select This Parameter... | To Configure |
---|---|
[1] Change nl_hosts | Maximum number of hosts for which each interface tracks network-layer statistics. |
[2] Change al_hosts | Maximum number of hosts for which each interface tracks application-layer statistics. |
[3] Change nl_matrix | Maximum number of network-layer conversations for which each interface tracks statistics. |
[4] Change al_matrix | Maximum number of application-layer conversations for which each interface tracks statistics. |
[5] Change dlci_nl hosts | Maximum number of hosts for which each DLCI tracks network-layer statistics. |
[6] Change dlci_al_hosts | Maximum number of hosts for which each DLCI tracks application-layer statistics. |
[7] Change dlci_nl_matrix | Maximum number of network-layer conversations on which each DLCI stores statistics. |
[8] Change dlci_al_matrix | Maximum number of application-layer conversations on which each DLCI stores statistics. |
[9] Change host_aging_frequency | Frequency (in seconds) at which each interface ages its host tables. |
[10] Change matrix_aging_frequency | Frequency (in seconds) at which each interface ages its conversation tables. |
[11] Toggle start_protocol_dist | Tracking of protocol distribution statistics during boot. |
[12] Toggle start_nl_host | Tracking of network-layer host statistics during boot. |
[13] Toggle start_nl_matrix | Tracking of network-layer conversations during boot. |
[14] Toggle enable_other_domains | The other domain feature (represented by the display of a tilde [~] next to a domain name in a domain name list). This feature is enabled by default. If this feature is disabled, the device will not allow installation or monitoring of the tilde domains. Refer to the Using the Campus TrafficDirector Application publication for a description of tilde domains. |
[15] Toggle enable_all_host | Booting of the device with the HOST group enabled for all default domains. This feature is disabled by default. This flag also automatically turns on the start_nl_host flag. (The HOST group is not installed on any of the default domains if the start_nl_host flag is set to off.) |
[16] Toggle enable_all_matrix | Booting of the device with the MATRIX (Conversation) group enabled for all default domains. This feature is turned off by default. This flag automatically also turns on the start_nl_matrix flag. (The MATRIX group is not installed on any of the default domains if the start_nl_matrix flag is set to off.) |
To configure RMON1/RMON2 parameters for all SwitchProbe device interfaces, follow these steps:
Step 1 Access the Agent Configuration Utility.
Step 2 Enter 31 and press Enter.
Step 3 Do one of the following:
Step 4 Do one of the following:
Step 5 From the main menu, enter 12 for the new settings to take effect.
SwitchProbe devices are shipped with the latest version of agent firmware already installed in both EPROM and FLASH memory. However, as Cisco Systems develops and releases new agent firmware, the firmware that was shipped with the SwitchProbe device may no longer be the most current version. You might want to upgrade or update the agent software in your SwitchProbe device.
Cisco Systems' TrafficDirector network management application supports the most current release of the agent firmware. This agent firmware resides in a hexadecimal file in the $NSHOME/binagent directory. The exact name of the file varies according to the model number of the SwitchProbe device.
Table 7-5 lists the firmware file names associated with each SwitchProbe device.
SwitchProbe Devices | Firmware File Name |
---|---|
Ethernet | ns6010.hex |
Token Ring | ns6020b.hex and nstr.adp |
Ethernet/Token Ring | ns6030.hex |
FDDI | ns7100.hex & nsfddi.adp |
Fast Ethernet | ns7200hd.hex and ns7200fd.hex |
Multiport Ethernet | ns7300.hex |
WAN/Ethernet | ns6050.hex |
Multiport T1/E1 WAN | ns8700.hex |
HSSI | ns7400.hex |
ATM | ns8100.hex |
Fast EtherChannel | ns8200.hex |
You can download the appropriate hex file to the SwitchProbe FLASH memory using Trivial File Transfer Protocol (TFTP). By default, SwitchProbe devices boot from FLASH memory. Therefore, when you download new agent firmware in the SwitchProbe device, the SwitchProbe device will load the new agent firmware in FLASH memory during boot.
You can perform all upgrades from any TFTP server (such as a Sun SPARCstation) on which the TFTP daemon is turned on in the /etc/inetd.conf file, and having a /tftpboot directory present.
To upgrade the firmware in a SwitchProbe device, follow these steps:
Step 1 Copy or FTP (in binary mode) the agent firmware file to the /tftpboot directory of the TFTP server.
Step 2 Use the agent console or the TrafficDirector Remote Login application to access the Agent Configuration Utility.
Step 3 Enter 9 and press Enter if you need to set the server address.
Step 4 Enter the address and press Enter when the agent prompts for the TFTP server address.
Step 5 Verify that the server address is correct before proceeding to the next step.
Step 6 Enter 10 and press Enter to initiate the TFTP transfer process and invoke the tftp client in the SwitchProbe agent.
A status report of the tftp upgrade process appears on the screen. A message indicates that the flash upgrade has been performed successfully.
Step 7 Reset the SwitchProbe agent.
For more information about resetting a SwitchProbe device, see "Resetting a SwitchProbe Device Agent."
The SwitchProbe device reboots using the new agent firmware in the SwitchProbe FLASH memory.
You can upgrade the Token Ring or FDDI firmware that resides in FLASH on the Token Ring/FDDI module in SwitchProbe device. To upgrade the FLASH on the Token Ring or FDDI adapter, enter command-line mode, then enter one of the following commands:
do tftp nstr.adp (for Token Ring SwitchProbe Device)
or
do tftp nsfddi.adp (for FDDI SwitchProbe Device)
nstr.adp is the image file for the Token Ring FLASH.
nsfddi.adp is the image file for the FDDI FLASH.
To upgrade the firmware in FLASH memory on the HSSI SwitchProbe devices, follow these steps:
Step 1 Retrieve the image file from Cisco Systems and copy it to the /tftpboot directory on your Trivial File Transfer Protocol (TFTP) server.
Step 2 Access the Agent Configuration Utility.
Step 3 Enter 8 and press Enter.
Step 4 Enter 3 to select the HSSI interface and press Enter.
Step 5 Enter 11 and press Enter.
Step 6 Enter the following command:
do tftp nshssi.hex
nshssi.hex is the image filename
WAN SwitchProbe devices automatically generate Simple Network Management Protocol (SNMP) traps when there is a change in permanent virtual circuit (PVC) status.
You can configure a SwitchProbe device to send SNMP traps to port 162 or 395 (the default), or to both ports, by configuring the value of the trap_port object.
Step 7 Enter the get speed command to check the current speed of the Fast Ethernet interface.
Step 8 Enter the set speed new_speed command to reset the speed.
new_speed is 10 or 100 (Mbps).
The correct speed is detected when the SwitchProbe device reboots. If there is no link (for example, if the cable is not attached), the speed is automatically set to 100 Mbps.
Posted: Wed Oct 2 08:31:38 PDT 2002
All contents are Copyright © 1992--2002 Cisco Systems, Inc. All rights reserved.
Important Notices and Privacy Statement.