Table of Contents

Workgroup MIB Reference

Workgroup MIB Reference

This appendix describes how to access the Cisco Management Information Base (MIB), a set of private extensions to the Internet standard MIB II. These extensions include variables that you can set or read to provide information on network devices and interfaces.


Note The Cisco MIB is provided with all Cisco software releases and with CiscoWorks router management software.

The Internet standard MIB II is documented in RFC 1213, Management Information Base for Network Management of TCP/IP-based Internets: MIB-II.

Downloading the Cisco Workgroup MIB File

The Catalyst 5000 series switch supports all standard traps defined in the standard MIBs listed in Chapter 1, "Product Overview." Cisco-proprietary traps used by the Catalyst 5000 series switch are documented in the CISCO-STACK-MIB.my file.

You can download a copy of the CISCO-STACK-MIB.my file in two ways:

Using FTP to Download the MIB File

To download the CISCO-STACK-MIB.my MIB file using FTP, perform these steps:

Step 1 From a UNIX server, enter this command at the system prompt:

$ ftp ftp.cisco.com


The system displays a login prompt.


Step 2 Log in with the username anonymous, as follows:

Name (ftp.cisco.com:user): anonymous


The system displays a password prompt.


Step 3 Enter your full e-mail address in the following format:

Password: user@domain_name


For example:


Password: jdoe@cisco.com


The system displays an ftp> prompt.


Step 4 Change directories to pub/mibs, as follows:

ftp> cd pub/mibs


Step 5 Change to the directory containing the CISCO-STACK-MIB.my file, as follows:

ftp> cd v1 (for SNMP version 1)


or


ftp> cd v2 (for SNMP version 2)


Step 6 Use the get command to download a copy of the CISCO-STACK-MIB.my file, as follows:

ftp> get CISCO-STACK-MIB.my


The get command downloads the CISCO-STACK-MIB.my file to your directory.


Step 7 Exit FTP by entering quit at the ftp> prompt, as follows:

ftp> quit


Using CCO to Download the MIB File

You can also use CCO to download the CISCO-STACK-MIB.my MIB file. You can access CCO through either a character-based interface or a multimedia World Wide Web (WWW) browser interface. The character-based interface, called CCO Classic, allows people without direct Internet access to use virtually all of the CCO features. CCO Classic supports Xmodem, Ymodem, Zmodem, Kermit, FTP, Internet e-mail, and fax download options and can be accessed using the Telnet protocol. The multimedia browser interface provides richly formatted documents with photographs, figures, graphics, and video. Both methods also provide hyperlinks to related information.

Table C-1 shows the modem settings that you should use to access CCO.


Table  C-1: Modem Settings for Accessing CCO
Modem Setting Value
Terminal emulation VT100
Data bits 8
Parity None
Stop bits 1
Baud rate Up to 28.8 kbps

To access CCO from North America, dial 408 526-8070; from Europe, dial 33 1 6446 40 82.

Accessing CCO Using a Multimedia Browser

To access CCO using a multimedia WWW browser, perform these steps:

Step 1 Go to one of the following WWW locations to reach the CCO home page:

Step 2 From the CCO home page, go to the public/mibs/supportlists/wsc5000/supportlist.html hypertext link. (The full URL for this page is http://www.cisco.com/public/mibs/supportlists/wsc5000/supportlist.html.) The browser displays the Catalyst 5000 MIB Support List page.

Step 3 Read the instructions at the top of the Catalyst 5000 MIB Support List page and then select the appropriate CISCO-STACK-MIB.my hypertext link. The browser displays the CISCO-STACK-MIB.my file.

Step 4 Save the CISCO-STACK-MIB.my file as text using the Save as... command from your browser's File pulldown menu. You can also send the file to yourself using the Mail Document... command from the browser's File menu.

Accessing CCO Using a Character-Based Interface

To access CCO using a character-based interface, perform these steps:

Step 1 From a system capable of running the Telnet protocol, enter this command:

% telnet cco.cisco.com


The system displays a login prompt.


Step 2 Log in as cco, as follows:

login: cco


The system displays messages similar to the following and prompts you to specify a terminal type:


Last login: Tue Dec 17 17:14:51 from dynaserv-noc-use


Welcome to CCO Classic....
Enter terminal type (<cr>=vt100, ? for help):


Step 3 Press Return to select VT100 terminal emulation.

The system displays messages similar to the following:


_________________________________________________________________
  Cisco Systems, Incorporated - Cisco Connection Online (CCO)
                     [Enhanced for Lynx!]
_________________________________________________________________
* Enter CCO as a Registered User
* Enter CCO as a Guest User (public information)
* Perform an Online Registration (Maintenance Contract required)
* Help
________________________________________________________________


Step 4 Select Enter CCO as a Guest User (public information), and press Return.

The system displays the Welcome to Cisco Connection Online screen.


Step 5 Select Software Image Library and press Return.

The system displays the Software Image Library (p1 of 4) screen.


Step 6 Select v1 (for SNMP version 1) or v2 (for SNMP version 2) and press Return.

The system displays the first page of the CISCO-STACK-MIB.my file.


Step 7 Press P.

The system displays the Printing Options (CCOLynx Version 2.5) screen.


Step 8 Select the Mail the file option and press Return.

The system prompts you for a valid Internet mail address.


Step 9 Enter your e-mail address at the prompt, as follows:

Please enter a valid internet mail address: user@domain_name


The CCO Classic interface sends the CISCO-STACK-MIB.my file to the specified e-mail address.


Simple Network Management Protocol Description

The Cisco MIB variables are accessible through the Simple Network Management Protocol (SNMP), which is an application-layer protocol designed to facilitate the exchange of management information between network devices. The SNMP system consists of three parts: SNMP manager, SNMP agent, and MIB.

Instead of defining a large set of commands, SNMP places all operations in a get-request, get-next-request, and set-request format. For example, an SNMP manager can get a value from an SNMP agent or store a value into that SNMP agent. The SNMP manager can be part of a network management system (NMS), and the SNMP agent can reside on a networking device such as a router. You can compile the Cisco MIB with your network management software. If SNMP is configured on a Catalyst 5000 series switch, the SNMP agent can respond to MIB-related queries being sent by the NMS.

An example of an NMS is the CiscoWorks network management software. CiscoWorks uses Cisco MIB variables to set device variables and to poll devices on the internetwork for specific information. The results of a poll can be displayed as a graph and analyzed to troubleshoot internetwork problems, increase network performance, verify the configuration of devices, monitor traffic loads, and more.

As shown in Figure C-1, the SNMP agent gathers data from the MIB, which is the repository for information about device parameters and network data. The agent can send traps, or notification of certain events, to the manager. The Cisco trap file, mib.traps, which documents the format of the Cisco traps, is available on the Cisco host cco.cisco.com.


Figure C-1: SNMP Network

The SNMP manager uses information in the MIB to perform the operations described in Table C-2.


Table  C-2: SNMP Manager Operations
Operation Description
get-request Retrieve a value from a specific variable.
get-next-request Retrieve a value from a variable within a table.1
get-response The reply to a get-request, get-next-request, and set-request sent by an NMS.
set-request Store a value in a specific variable.
trap An unsolicited message sent by an SNMP agent to an SNMP manager indicating that some event has occurred.

1 With this operation, an SNMP manager does not need to know the exact variable name. A sequential search is performed to find the needed variable from within a table.

Internet MIB Hierarchy

The MIB structure is logically represented by a tree hierarchy. (See Figure C-2.) The root of the tree is unnamed and splits into three main branches: International Telecommunication Union Telecommunication Standardization Sector (ITU-T), International Organization for Standardization (ISO), and joint ISO/ITU-T.


Note The ITU-T carries out the functions of the former Consultative Committee for International Telegraph and Telephone (CCITT).

These branches and those that fall below each category have short text strings and integers to identify them. Text strings describe object names, and integers allow computer software to create compact, encoded representations of the names. For example, the Cisco MIB variable authAddr is an object name and is denoted by 5, which is listed at the end of its object identifier number 1.3.6.1.4.1.9.2.1.5.

The object identifier in the Internet MIB hierarchy is the sequence of numeric labels on the nodes along a path from the root to the object. The Internet standard MIB is represented by the object identifier 1.3.6.1.2.1. It also can be expressed as iso.org.dod.internet.mgmt.mib. (See Figure C-2.)


Figure C-2: Internet MIB Hierarchy

Cisco Workgroup MIB

The private Cisco MIB is represented by the object identifier 1.3.6.1.4.1.9, or iso.org.dod.internet.private.enterprise.cisco. The Cisco MIB is split into two main areas: Workgroup Products and Cisco Management.


Note Local variables do not change; they are supported by the Cisco Workgroup MIB in each subsequent system software release. As indicated by the name, temporary variables might have a limited time span or change with each system software release. (See Figure C-3.)

In Figure C-3, the stack MIB group is identified by 1; its subgroup, called tftp grp, is identified by 5. Therefore, the variable in the subgroup tftp grp has an object identifier (OID) of 1.3.6.1.4.1.9.5.1.5.1. The appended 0 indicates that 1.3.6.1.4.1.9.5.1.5.1.0 is the one and only instance of this variable.


Figure C-3: Cisco Private MIB Hierarchy



Copyright 1989-1997 © Cisco Systems Inc.