-
User Guide for Mobile Wireless Transport Manager 5.0
-
About This Document
-
MWTM Overview
-
Discovering Your RAN-O Networks Using MWTM
-
Getting Started with MWTM
-
Working with Views
-
Working with Events
-
Working with Nodes
-
Working with Interfaces
-
Viewing the Topology of the Network
-
Working with MWTM Statistics Reports
-
Configuring MWTM Security
-
Configuring MWTM for Your Network
-
Troubleshooting MWTM and the Network
-
Accessing MWTM Data from the Web Browser
-
Appendix A--MWTM Status Definitions
-
Appendix B--MWTM FAQs
-
Appendix C--MWTM Command Reference
-
Appendix D--MWTM MIB Reference
-
Appendix E--MWTM Trap Reference
-
Appendix F--Configuring MWTM to Run with Various Networking Options
-
Appendix G--MWTM Statistics Export File Formats
-
Appendix H--MWTM and Ports
-
Appendix I--Open Source License Notices for the Cisco Mobile Wireless Transport Manager
-
Glossary
-
Index
-
Feedback
Table Of Contents
Discovering Your RAN-O Networks Using MWTM
Launching the Discovery Dialog
Loading Seed Nodes and Seed Files
Changing an Existing Seed File
Creating and Changing Seed Files Using a Text Editor
Discovering Your RAN-O Networks Using MWTM
This chapter provides details on using MWTM to discover your RAN-O networks. It includes the following sections:
•
Launching the Discovery Dialog
•
Discovery Overview
MWTM uses a discovery process to populate the MWTM database, discovering the objects in your network. When a new node is discovered, it is added to the database. The node is set up to be polled if its SNMP access is defined as out-of-band. To prevent a node from being polled, right-click the node in a window, select Edit > RAN Properties, and change the SNMP access to in-band.
You can run Discovery if MWTM User-Based Access is disabled, or if it is enabled and you are a Network Administrator or System Administrator. (For more information about user authorization levels in MWTM, see the "Configuring MWTM User Authentication Levels (Server Only)" section on page 10-6.)
To discover your network in MWTM:
Step 1
Step 2
Step 3
Step 4
Step 5
•
•
•
Step 6
Step 7
Step 8
Related Topics:
•
•
Configuring SNMP Settings
Note
If MWTM User-Based Access is disabled, or if it is enabled and you are a Network Administrator or System Administrator, MWTM enables you to view and change some SNMP settings.
For more information about user authorization levels in MWTM, see the "Configuring MWTM User Authentication Levels (Server Only)" section on page 10-6.
For more information about SNMP, refer to "Configuring SNMP Support" in the Cisco IOS Release 12.2 Configuration Fundamentals Configuration Guide, Part 3, System Management.
To change SNMP settings in MWTM, start the MWTM client, as described in the "Starting the MWTM Client" section on page 3-4, then select Network > SNMP Configuration from the MWTM Main Menu. (If you have implemented MWTM User-Based Access, this option is available to users with authentication level Network Administrator [Level 4] and higher.)
MWTM displays the SNMP Configuration Dialog.
The SNMP Configuration Dialog is composed of the following sections:
MWTM also provides a set of commands that you can use to configure SNMP settings:
SNMP Configuration Menu
The menu on the SNMP Configuration Dialog provides the following options:
SNMP Settings Table
The SNMP settings table displays current SNMP information for nodes in MWTM. You can edit these fields in the SNMP Configuration Table.
The SNMP configuration table contains the following columns:
SNMP Configuration Table
The SNMP configuration table enables you to change SNMP settings for a node.
The SNMP configuration table contains the following fields:
IP Address Range or Hostname
IP address or DNS name of a node.
To change the IP address or DNS name of a node, select the node, enter the new address or name in the IP Address Range or Hostname field, then click Update.
IP addresses use the format x.x.x.x, where each x has one of the following values:
•
•
•
Unlike IP addresses, you cannot specify a range of node names or use wildcards in node names. Each node name corresponds to a single node in the network.
The default value for this field is the IP address *.*.*.*, which MWTM uses for all nodes not covered by other IP address ranges or names.
Read Community
SNMP community name to be used by the node for read access to the information maintained by the SNMP agent on the RAN-O node.
To change the SNMP community name for a node, select the node and enter the new name in the Read Community field, then click Update.
This new SNMP community name must match the name used by the node. The default name is public.
For information about exporting SNMP community names from CiscoWorks Resource Manager Essentials (RME), see the "Importing SNMP Community Names from CiscoWorks (Solaris Only)" section on page 11-2.
Timeout (secs)
Time, in seconds, MWTM waits for a response from the node.
If you determine that MWTM waits too long for a response from a node, or does not wait long enough, you can change the timeout value. To change the time that MWTM waits for a response from a node, select the node and enter the new timeout value in the Timeout (secs) field, then click Update.
The valid range is 1 to 60 seconds. The default value is 1 second.
Retries
Number of times MWTM attempts to connect to the node.
If you determine that MWTM retries a node too many times, or not enough times, you can change the number of retries. To change the number of times MWTM attempts to connect to a node, select the node and enter the new number in the Retries field, then click Update.
The valid range is 0 to 99. The default value is 2 retries.
Poll Interval (mins)
Time, in minutes, between polls for the node.
If you determine that MWTM polls a node too often, or not often enough, you can change the poll interval. To change the time, in minutes, between polls for a node, select the node and enter the new interval in the Poll Interval (mins) field, then click Update.
The valid range is 5 to 1440. The default value is 15 minutes.
SNMP Configuration Buttons
The SNMP Configuration Dialog contains the following buttons:
SNMP Configuration Commands
MWTM also provides the following SNMP-related commands:
•
•
•
•
•
For more information on the use of these commands, see the "MWTM Command Reference" section on page C-1.
Launching the Discovery Dialog
To launch the Discovery Dialog and begin the Discovery process, select Network > Network Discovery from the MWTM Main Menu. MWTM displays the Discovery Dialog.
The Discovery Dialog enables you to load and configure seed nodes, and use those seed nodes to discover the objects in your network.
If you start the MWTM client and the MWTM database is empty (including the very first time you start the MWTM client), MWTM automatically opens the Discovery Dialog so you can run Discovery and populate the database.
The Discovery Dialog is composed of the following sections:
Discovery Dialog Menu
The menu on the Discovery Dialog provides the following options:
Discovery Dialog Tabs
The Discovery Dialog contains the following tabs:
Seed Settings
Displays the Seed Settings panel in the Discovery Dialog.
Discovery
Displays the Discovery panel in the Discovery Dialog.
Loading Seed Nodes and Seed Files
MWTM enables you to load one or more new seed nodes, or to create, save, load, and delete existing MWTM seed files.
This section includes the following information:
•
Loading a Seed Node
To load a seed node, enter the name or IP address of the seed node in the IP Address or DNS Hostname field, and click Add Node (or press Enter). MWTM displays details of the SNMP settings for the seed nodes in the right pane of the window.
Continue adding seed nodes until you are certain that MWTM will be able to discover the entire network.
Loading a Seed File
If you have already created and saved one or more seed files, you can load a seed file, change the list of seed files, and select one seed file to be loaded automatically when the MWTM client is started or the Discovery Dialog is opened.
To load an existing seed file, select File > Load Seeds from the Discovery Dialog menu. SGM displays the Load File Dialog: Seed File List dialog.
The Load File Dialog: Seed File List contains the following fields and buttons:
Saving a Seed File
MWTM enables you to save a specific seed file, change the list of seed files, and select one seed file to be loaded automatically when the MWTM client is started or the Discovery Dialog is opened.
When you are satisfied that MWTM has discovered all of the nodes in the network, save the list of seed nodes in a seed file, using one of the following procedures:
•
•
MWTM stores the seed file in the seed file directory on the MWTM server:
•
•
Note
The Save File Dialog: Seed File List contains the following fields and buttons:
Creating a New Seed File
To create a new seed file in MWTM, launch the Discovery Dialog, as described in the "Launching the Discovery Dialog" section, then select the Seed Settings tab, if it is not already selected. MWTM displays the Seed Settings panel.
The Seed Settings panel in the Discovery Dialog enables you to create, save, load, and delete MWTM seed files.
The Seed Settings panel on the Discovery Dialog contains the following fields and buttons:
Seed Nodes
Lists the seed nodes currently defined in MWTM.
IP Address Range or Hostname
IP address of the seed node. The default is *.*.*.*.
Retries
Number of times MWTM attempts to connect to the seed node. The valid range is 0 to 99. The default value is 2.
Timeout (sec)
Time, in seconds, MWTM waits for a response from the seed node. The valid range is 0 (no timeout) to 9999. The default value is 1 second.
Read Community
SNMP community name for read access to the information maintained by the SNMP agent on the RAN-O device. This value can be up to 32 characters in length. Do not include special characters such as ` @ $ ^ * ' '' & |. This value is usually set to public (the default).
Poll Interval (mins)
Time, in minutes, between polls. The valid range is 0 to 9999. The default value is 15 minutes.
IP Address, Address range, Subnet, CIDR, or DNS Hostname
Address or name of the selected seed node.
To create a new seed file, enter the name or address of a seed node in this field. Examples of acceptable input include:
•
•
•
•
MWTM displays details of the SNMP settings for the seed node in the right pane of the window.
Continue to add as many seed nodes as necessary to discover your entire network.
When you are ready to save the list of seed nodes in a new seed file, select File > Save As from the Discovery Dialog menu. MWTM displays the Save File Dialog: Seed File List dialog. See the "Saving a Seed File" section for more information about saving seed files.
Add Node
Adds a new seed node to MWTM.
Delete Node
Deletes the selected seed node. MWTM deletes the seed node without asking for confirmation.
Next
Displays the Discovery panel in the Discovery Dialog.
If you enter a seed node IP address or name in the IP Address or DNS Hostname field, then click Next, MWTM automatically adds the seed node before displaying the Discovery panel.
Changing an Existing Seed File
To change an existing seed file in MWTM, load the seed file as described in the "Loading a Seed File" section.
To add another seed node to the seed file, enter the name or IP address of the seed node in the IP Address or DNS Hostname field, and click Add Node.
To delete a seed node from the seed file, select the seed node and click Delete.
When you are ready to save the modified seed file, use the procedure described in the "Saving a Seed File" section.
Creating and Changing Seed Files Using a Text Editor
A seed file is simply an unformatted list of seed node names. To create a seed file using a text editor, simply create a file and list the seed node names, one on each line, with no other formatting:
new-york-a
new-york-b
chicago-c
When you save and name the seed file, keep the following considerations in mind:
•
•
•
–
–
When MWTM loads the seed file, it verifies the syntax of the file, deleting blank lines and extraneous leading and trailing spaces as needed. MWTM also verifies that each seed node name resolves to a valid IP address. If a name does not resolve to a valid IP address, MWTM logs the erroneous entry and ignores it.
For example, given the following seed file:
new-york-a<space>
<space>new-york-b
zzzzzzzzzzzz
<blank line>
<tab>chicago-c<tab>
MWTM loads the following entries:
new-york-a
new-york-b
chicago-c
Running Discovery
The Discovery panel in the Discovery Dialog enables you to discover the objects in your network.
To display the Discovery panel, launch the Discovery Dialog, as described in the "Launching the Discovery Dialog" section, then select the Discovery tab in the Discovery Dialog, or click Next in the Seed Settings panel. MWTM displays the Discovery panel. (If you enter a seed node IP address or name in the IP Address, Address range, Subnet, CIDR, or DNS Hostname field, then click Next, MWTM automatically adds the seed node before displaying the Discovery panel.)
The Discovery panel is composed of the following sections:
Related Topics:
Discovery Settings
The Discovery Settings section of the Discovery panel contains the following fields and button:
If you run Discovery with Entire Network cleared, then you run Discovery with Entire Network selected, any Unmanaged nodes in the first Discovery are not rediscovered by the second Discovery.
To recover from this situation and generate a new, complete, and reliable MWTM database, you must perform one of the following procedures:
1.
2.
3.
Discovered Nodes
The Discovered Nodes section of the Discovery panel lists all nodes that have been discovered by MWTM (all nodes, including new and excluded nodes, not just the nodes in the current view). By default, this table is sorted by Status.
To see mouse over help popup for each column in the table, place the cursor over a column header.
If a cell is too small to show all of its data, place the cursor over the cell to see the full data in a mouse over help popup.
You can resize each column, or sort the table based on the information in one of the columns. By default, MWTM displays all of the columns in the Discovered Nodes section except Internal ID, Router Uptime, Reboot Reason, Process Traps, and Last Status Change.
•
•
See the "Resizing, Sorting, and Hiding Table Columns" section on page 3-30 for more information about resizing, sorting, displaying, or hiding columns.
The Discovered Nodes section contains the following columns and buttons:
Internal ID
Internal ID of the event. The internal ID is a unique ID for every object, assigned by MWTM for its own internal use. It can also be useful when the TAC is debugging problems.
Name
Name or IP address of the discovered node.
All discovered nodes are placed in a DEFAULT configuration view, which is stored on the MWTM server and shared by all MWTM clients. Initially, all clients use the DEFAULT view. Clients can then create their own views, which are subsets of the DEFAULT view, to meet their individual needs. However, the DEFAULT view stored on the MWTM server cannot be modified by the clients. It is always available, for users who need to view the entire network.
Primary SNMP Address
IP address of the node, used by SNMP to poll the node. (There might be other IP addresses on the node that are not the primary SNMP address.)
Device Type
Device type of the node. Possible values are:
•
•
•
•
•
•
•
•
IOS MIB Level
MIB conformance level used by the RAN-O device.
Trap Polling
Indicates whether trap polling is enabled or not. This checkbox is read-only.
•
•
Report Polling
Indicates whether report polling is enabled or not. This checkbox is read-only.
•
•
Router Uptime
Time the RAN-O device has been up, in days, hours, minutes, and seconds.
Reboot Reason
Reason for the last reboot of the RAN-O device.
Ignored
Indicates whether the node is to be included when aggregating and displaying MWTM status information:
•
•
This field can be edited by users with authentication level Power User (Level 2) and higher.
Process Traps
Indicates whether MWTM is to process traps from this node:
•
•
This field can be edited by users with authentication level Power User (Level 4) and higher.
Notes
Indicates whether there is a note associated with the node.
Events
Indicates whether there is a recent event associated with the node. (Even if the server purges all of the events associated with the node, MWTM continues to display the event icon in this field.)
During Discovery, MWTM might flag most nodes with an event icon (orange triangle). If the event icons are too distracting, select Edit > Clear All Events from the MWTM Main Menu to remove them.
Last Status Change
Date and time that the status of the node last changed.
Status
Current status of the node. Possible values are:
Active
Discovering
Polling
Unknown
Unmanaged
Waiting
Warning
For detailed definitions of each status, see the "Status Definitions for Nodes" section on page A-4.
Status Reason
Reason for the current status of the object.
For a full list of possible reasons, see the stateReasons.html file:
•
•
If the cell is too small to show all of the status reason, place the cursor over the cell to see the full status reason in a mouse over help popup.
The status reasons are listed in order of decreasing magnitude. If two or more reasons apply, the reason of greatest magnitude is displayed.
If the status reason is Unsupported Configuration, correct the configuration and enter the mwtm cleandiscover command to delete all current network data and begin a clean discovery of the RAN-O network. If the status reason is still Unsupported Configuration, enter the mwtm clean command to restore the MWTM server to a "clean" state, such as would exist after a new installation of MWTM. For more information on the use of these commands, see the "MWTM Command Reference" section on page C-1.
Back
Displays the Seed Settings panel in the Discovery Dialog.
Delete
Deletes the selected node or nodes from the Discovery database. MWTM deletes the nodes without asking for confirmation.
Poll Node
Begins a poll of all nodes selected in the Discovered Nodes section of the Discovery panel.
You cannot poll a node with a Primary SNMP Address of N/A:
•
•
Verifying Discovery
After you discover the network (see the "Discovery Overview" section), examine the Discovered Nodes table to verify that MWTM discovered all of the RAN-O nodes in the network. If you suspect that MWTM did not discover all of the RAN-O nodes, verify the following conditions:
•
•
•
•
•
•
