-
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
Becoming the Root User (Server Only)
Starting the MWTM Server (Server Only)
Before Starting the MWTM Client
Starting the MWTM Client on Solaris/Linux
Starting the MWTM Client on Windows
Starting the MWTM Client for the First Time
Right-Click Menu for All Alarms
Right-Click Menu for a Specific Alarm
Viewing a Summary of Network Objects
Right-Click Menu for the Summary Lists
Viewing the Topology of the Network
Viewing Server Status Information
Server Status Information: Fields and Buttons
Server Status Information: Processes
Server Status Information: Pollers
Server Status Information: Tasks
Server Status Information: Clients
Finding Information in a Window
Resizing, Sorting, and Hiding Table Columns
Viewing Real-Time Data for a Node
Changing Real-Time Poller and Counter Settings
Integrating MWTM with Other Products
Integrating MWTM with HP OpenView
Integrating MWTM with CiscoWorks
Launching the CiscoWorks Device Center
Forwarding Traps to Other Hosts (Server Only)
Exporting Current MWTM Data for Network Objects
Exporting Current MWTM Node Names and SNMP Community Names
Launching the MWTM Event Configurator
Changing the Default MWTM Server Name
Changing the Default MWTM Telnet Path
Launching the MWTM SSL Certificate Tool
Using the MWTM Command Line Interface
Running Simultaneous MWTM Sessions
Getting Started with MWTM
This chapter provides information about starting and stopping MWTM, and provides an overview of how to use MWTM to manage your Radio Access Network-Optimization (RAN-O) installation.
This chapter includes the following information:
•
Becoming the Root User (Server Only)
•
•
•
•
•
•
•
•
•
•
•
•
For detailed information about MWTM's supported platforms, and hardware and software requirements, see the Cisco Mobile Wireless Transport Manager Installation Guide.
Note
Becoming the Root User (Server Only)
Some MWTM procedures require you to be logged in as the root user.
Caution
If you are not logged in, log in as the root user:
> login: root
> Password: root-password
If you are already logged in, but not as the root user, use the su command to change your login to root:
# su
# Password: root-password
Starting the MWTM Server (Server Only)
Before starting an MWTM server, verify the following prerequisite conditions:
•
•
•
•
To enable traps on the RAN-O device, enter the following:
snmp-server enable traps snmp authentication linkdown linkup coldstart warmstartsnmp-server enable traps ipran•
To receive the traps on a host, enter the following on the RAN-O device:
snmp-server host IP_address version 2c v2cBecause the MWTM application is comprised of a server component and a client component, you must start both components to run the application.
To start the MWTM server on a Solaris/Linux system, enter the following commands:
# cd /opt/CSCOsgm/bin
# ./mwtm start
Note
Starting the MWTM Client
This section contains the following information:
•
•
•
•
Before Starting the MWTM Client
When you start an MWTM client, the version and release of the client must match that of the MWTM server, and the patch level must be greater than or equal to that of the server. For example, the following MWTM client-server connections are allowed:
The following MWTM client-server connections are not allowed:
Table 3-2 Disallowed MWTM Client-Server Connections
5.0.0
5.1.0
5.1.0
5.0.0
If there is a client-server mismatch, MWTM displays a warning message when you try to start the client. If you have a Web browser installed, MWTM optionally opens a Web page enabling you to download an allowed, matching client. See the "Downloading the MWTM Client from the Web" section on page 13-50 for more information about downloading the MWTM client.
Starting the MWTM Client on Solaris/Linux
To start the MWTM client on a Solaris/Linux system on which the MWTM server is installed, make sure the MWTM server is running, then enter the following commands:
# cd /opt/CSCOsgm/bin
# ./mwtm client
To start the MWTM client on a Solaris/Linux system other than the one on which the MWTM server is installed, make sure the MWTM server is running, then enter the following commands:
# cd /opt/CSCOsgmClient/bin
# ./mwtm client
To start the MWTM client on a Solaris/Linux system other than the one on which the MWTM server is installed, and connect to an MWTM server other than the default server, enter the following commands:
# cd /opt/CSCOsgmClient/bin
# ./mwtm client server_name_or_ip_address
where server_name_or_ip_address is the name or IP address of the Solaris/Linux system on which the MWTM server is running.
Starting the MWTM Client on Windows
To start the MWTM client on a Windows system, select Start > Programs > Cisco MWTM Client > Launch MWTM Client, or double-click the MWTM Client icon on the Windows desktop.
Starting the MWTM Client for the First Time
When you start MWTM for the first time, MWTM displays the Discovery Dialog and the MWTM Main Window.
The MWTM Main Window is the primary MWTM window. It is the first window to appear when you launch the MWTM client. It displays basic information about the events and objects that MWTM discovers.
When you start MWTM for the first time, if you did not configure the MWTM server to automatically discover your network the first time the server starts after installation, the MWTM database contains no information, and the MWTM Main Window is blank. The database is populated, and reflected in the MWTM Main Window, when you run Discovery for the first time; MWTM displays the Discovery Dialog to make it easier for you to do so. In fact, any time you start the MWTM client and the MWTM database is empty, MWTM automatically opens the Discovery Dialog so you can run Discovery and populate the database. For more information about Discovery, see the "Discovery Overview" section on page 2-1.
The events and objects that MWTM discovers are displayed in the left and right panes of the MWTM Main Window.
MWTM also uses the right pane of the MWTM Main Window when displaying more detailed information about your network, such as configuration details and real-time data.
Viewing the MWTM Main Window
The MWTM Main Window is the primary MWTM client window. It is the first window to appear when you launch the MWTM client. It displays basic information about the events and objects that MWTM discovers in the left and right panes. MWTM also uses the right pane of the MWTM Main Window when displaying more detailed information about your network, such as configuration details and real-time data.
For detailed descriptions of the information that is displayed in the MWTM Main Window, see the following sections:
•
Using the MWTM Main Menu
The MWTM Main Menu appears in the menu bar of most MWTM windows.
Some menu items do not appear on some windows. In addition, menu items that are grayed-out are not available on that window.
For detailed information about the menu options provided by other windows, see the descriptions of those windows.
The MWTM Main Menu provides the following menu options:
File > Load DEFAULT View
(Ctrl-D)Loads the DEFAULT view, which is the view into which MWTM places all discovered objects when discovering the network. The DEFAULT view is stored on the MWTM server and shared by all MWTM clients, but it cannot be modified by the clients.
File > Load View
(Ctrl-L)Loads an already existing view. MWTM prompts you for the name of the view you want to load:
•
•
File > Save View
(Ctrl-S)Saves the current view:
•
•
If you have implemented MWTM User-Based Access, this option is available to users with authentication level Power User (Level 2) and higher.
File > Save View As
Opens the Save File Dialog: View List, which enables you to enter or select a file name under which to save the current view.
If you have implemented MWTM User-Based Access, this option is available to users with authentication level Power User (Level 2) and higher.
File > Connect to New Server
(Ctrl-O)Connects to a new server. MWTM prompts you for the new server's name or IP address, and UDP port number.
MWTM stops the MWTM client, then restarts the client connected to the new server.
File > Print
(Ctrl-P)Enables you to:
•
•
•
The MWTM printing options require that you define a printer on your system. If you select File > Print and the Print window does not appear, make sure you have defined a printer on your system.
File > Exit
(Ctrl-Q)Exits the MWTM application, after prompting you for confirmation.
If you are working in a custom view (that is, not the DEFAULT view), MWTM automatically saves any changes you made to the view.
Edit > Views
(Ctrl-M)Opens the View Editor Window.
Edit > Find
(Ctrl-F)Opens the Find dialog, which enables you to find a specific object, event, or text in the window.
If you select an object in the left pane of the MWTM Main Window, this option is grayed-out and cannot be selected.
Edit > Clear All Events
(Ctrl-E)Deletes the event icon (orange triangle) from MWTM displays for all known objects. The actual events are not deleted from MWTM, only the event icon for all known objects.
Note
Edit > Delete
(Delete)Deletes the currently selected element or elements from the MWTM database. MWTM displays the Confirm Deletion dialog:
•
•
•
Note
If you have implemented MWTM User-Based Access, this option is available to users with authentication level Network Administrator (Level 4) and higher.
Edit > Preferences
(Ctrl-H)Opens the Preferences window.
Network > SNMP Configuration
(Ctrl-B)Opens the SNMP Configuration Dialog.
If you have implemented MWTM User-Based Access, this option is available to users with authentication level Network Administrator (Level 4) and higher.
Network > Network Discovery
(Ctrl-Y)Opens the Discovery Dialog.
If you have implemented MWTM User-Based Access, this option is available to users with authentication level Network Administrator (Level 4) and higher.
Network > Poll Nodes > Normal Poll
(Alt-N)Polls all selected RAN-O nodes.
If you have implemented MWTM User-Based Access, this option is available to users with authentication level Network Operator (Level 3) and higher.
Network > Poll Nodes > Clean Poll
(Alt-C)Polls all selected RAN-O nodes and removes any Unknown objects after the completion of the poll.
If you have implemented MWTM User-Based Access, this option is available to users with authentication level Network Operator (Level 3) and higher.
View > Show Topology
(Ctrl-T)Opens the Topology Window.
View > MWTM Server > Home Page
Displays the MWTM Server Home Page in a Web browser.
View > MWTM Server > Telnet To
(Ctrl-N)Opens a Telnet window to the server.
View > MWTM Server > Status Information
Opens the Server Status Information Window.
View > Network Status Dashboard
Displays the MWTM Node Dashboard in a Web browser.
View > Event History > Status Changes
Displays the MWTM Network Status Log for Status Change Messages in a Web browser, with messages displayed for all known objects.
View > Event History > SNMP Trap Messages
Displays the MWTM Network Status Log for SNMP Trap Messages in a Web browser, with messages displayed for all known objects.
View > Event History > Status and Trap Messages
Displays the MWTM Network Status Log for Status Change Messages and SNMP Trap Messages in a Web browser, with messages displayed for all known objects.
View > Event History > Network Status Metrics
Displays the MWTM Network Status Log for Metrics in a Web browser, with metrics displayed for all known objects.
View > Event History > Network Status Archives
Displays all archived Status Change Messages and SNMP Trap Messages in a Web browser.
View > User Audit > User Actions
Displays action messages in the system log, in a Web browser.
View > User Audit > User Accounts
Displays information about all user accounts that have been defined for the MWTM server, in a Web browser.
View > User Audit > Security Log
Displays the contents of the MWTM system security log file for the server to which you are connected, and which is currently running the MWTM server, in a Web browser.
View > User Audit > Command Log
Displays the contents of the MWTM command log file for the server to which you are connected, and which is currently running the MWTM server, in a Web browser. The command log lists all mwtm commands that have been entered for the MWTM server, the time each command was entered, and the user who entered the command.
View > User Audit > Connected Clients
Lists all MWTM clients that are currently connected to the MWTM server, in a Web browser. It also lists all Solaris/Linux users that are logged in to the MWTM server.
View > Message of the Day
Opens the Message of the Day dialog.
View > Cisco.com
Displays the Cisco.com Home Page in a Web browser.
Reports > Router Node IOS Versions
Displays the RAN-O Node IOS Versions for the server to which you are connected, and which is currently running the MWTM server, in a Web browser.
Go > Back
(Alt-Left)Navigates back to the last window viewed in this session.
Go > Forward
(Alt-Right)Navigates forward to the last window viewed in this session.
Go > Back > List of Windows
Navigates back to a window viewed in this session.
MWTM maintains a list of up to 10 Back windows.
Go > Forward > List of Windows
Navigates forward to a window viewed in this session.
MWTM maintains a list of up to 10 Forward windows.
Tools > Event Configurator
(Alt-E)Launches the Event Configurator, which enables you to customize the displayed category, severity, color, and message associated with events; configure sounds for MWTM to play for different types of events; and load, save, and deploy customized event configurations.
If you have implemented MWTM User-Based Access, this option is available to users with authentication level Network Operator (Level 3) and higher.
Tools > Event Sounds
(Alt-U)Opens the Event Sound Filters dialog, which enables you to define sounds that the MWTM client is to play when specific events are logged.
Products > CiscoWorks >
Device Center
(Ctrl-2)Links to the CiscoWorks Device Center, which provides a number of Web-based functions, including reachability trends, response time trends, interface status, Syslog browsing, and detailed inventory. MWTM prompts you for a CiscoWorks user ID and password before linking to CiscoWorks.
The link to CiscoWorks has the following prerequisites:
•
•
This option is grayed-out if the selected node is not a RAN-O node, or if the selected node is in Unmanaged status or has a Device Type of Unknown. (CiscoWorks cannot monitor a non-RAN-O, Unmanaged, or Unknown node.)
This option is not displayed if you did not specify a CiscoWorks server during installation. See the "Installing MWTM on Solaris" and "Installing MWTM on Windows" chapters of the Cisco Mobile Wireless Transport Manager Installation Guide for more information.
Products > CiscoWorks >
CiscoView
(Ctrl-3)Links to CiscoView, which provides a real-time, color-coded, graphical representation of Cisco devices. You can use CiscoView to quickly identify an incorrect status on a port or interface.
This option is grayed-out if the selected node is a non-RAN-O node, or if the selected node is in Unmanaged status or has a Device Type of Unknown. (CiscoWorks cannot monitor a non-RAN-O , Unmanaged, or Unknown node.)
This option is not displayed if you did not specify a CiscoWorks server during installation. See the "Installing MWTM on Solaris" and "Installing MWTM on Windows" chapters of the Cisco Mobile Wireless Transport Manager Installation Guide for more information.
Help > Topics
(F1)Displays the table of contents for the MWTM online help.
Help > Window
(Shift-F1)Displays online help for the current window.
Help > About
(F3)Displays build date, version, SSL support, and copyright information about the MWTM application.
Topology Tools > Zoom In
(Ctrl-=)Makes the map twice as large.
Note
Topology Tools > Zoom Out
(Ctrl-- or Ctrl-Minus)Makes the map half as large.
Note
Topology Tools > Zoom Area
Zooms in on the selected area of the map.
Note
Topology Tools > Zoom Fit
Adjusts the size of the map to fit in the window. This is the default setting the first time the map is displayed.
Note
Topology Tools > Layout > Circular
Displays the map in a circular layout.
Note
Topology Tools > Layout > Spring
Displays the map in a spring layout. That is, nodes with the most links are drawn closer to the center of the map, while nodes with fewer links are drawn farther away. This is the default setting the first time the map is displayed.
Note
Topology Tools > Restore Positions
Restores the view to the last saved view.
Note
Topology Tools > Save As JPEG
(Ctrl-J)Opens the Save as JPEG dialog, enabling you to save the topology map to a JPEG file.
Note
Topology Tools > Magnetic Grid
Opens the Magnetic Grid Settings dialog.
Note
Topology Tools > Align
Opens the Align Objects dialog, which enables you to align two or more objects on the topology map.
Note
Topology Tools > Exclude from View
Excludes the selected node from the current view. See the "Creating a New View" section on page 4-31 for more information about excluding nodes.
Note
This option is grayed-out if the selected node is not a RAN-O node.
Topology Tools > Open Parent View
Opens the parent view of the currently displayed view in the Topology Window.
Note
This option is grayed-out if the currently displayed view is the highest level parent view.
Topology Tools > Close View
Closes the currently displayed view in the Topology Window.
Note
This option is grayed-out if the currently displayed view is the highest level parent view.
Viewing Alarms
MWTM enables you to view a summary of all currently active alarms in your network, including the current status of the associated network object. An active alarm is a network object with the following status:
•
•
To see a summary of all currently active alarms, click Alarms in the left pane. MWTM displays the Active Alarms Window in the right pane. For more information, see the "Viewing Alarms" section.
Right-click Alarms in the left pane to display the right-click menu for all alarms. For more information, see the "Right-Click Menu for All Alarms" section.
Right-click an alarm in the right pane to display the right-click menu for a specific alarm. For more information, see the "Right-Click Menu for a Specific Alarm" section.
Viewing Alarms
To view alarms, select Alarms in the left pane of the MWTM Main Window. MWTM displays the Active Alarms Window.
The Active Alarms Window provides basic information about all currently active alarms in your network, that are not excluded from your current view. MWTM updates the information in the window at least once every minute.
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, this table is sorted by Age, with the most recent alarms at the top, and MWTM displays all of the columns in the table except Last Status Change.
•
•
See the "Resizing, Sorting, and Hiding Table Columns" section for more information about resizing, sorting, displaying, or hiding columns.
The active alarms table contains the following columns:
Type
Type of network object associated with the selected alarm.
To see all higher-level alarms associated with the network object, select the turner beside the object. MWTM displays the higher-level alarms below the selected alarm.
Name
Name of the network object associated with the selected alarm.
Status
Current status of the network object associated with the selected alarm. Possible values are:
Unknown
Unavailable
Inactive
Failed
Down
Pending
Warning
Shutdown
Discovering
Polling
Waiting
Unmanaged
Active
For detailed definitions of each status for each type of network object, see the "MWTM Status Definitions" section on page A-1.
Status Reason
Reason for the current status of the network object associated with the selected alarm.
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.
Last Status Change
Date and time that the status of the network object associated with the selected alarm last changed.
Age
Age of the selected alarm, in days, hours, and minutes.
Note
Right-Click Menu for All Alarms
To see the right-click menu for all active alarms, select Alarms in the left pane and click the right mouse button. The active alarms right-click menu provides the following options:
Right-Click Menu for a Specific Alarm
The active alarms table provides a subset of the MWTM Main Menu as a right-click menu. To see this menu, select an alarm and click the right mouse button. The alarm right-click menu provides the same options as the right-click menu for the associated network object, plus the following additional options:
Caution
Viewing Events
To see all events discovered by MWTM, click Events in the left pane. MWTM displays the Event Window in the right pane. For more information, see the "Working with Events" section on page 5-1.
Right-click Events in the left pane to display the right-click menu for all events. For more information, see the "Right-Click Menu for All Events" section on page 5-3.
Right-click an event in the right pane to display the right-click menu for a specific event. For more information, see the "Right-Click Menu for a Specific Event" section on page 5-3.
Viewing a Summary of Network Objects
MWTM enables you to view basic summary information about all discovered network objects, including their status and the number of each object with that status.
To see a summary of all network objects discovered by MWTM, click Summary Lists in the left pane. MWTM displays the Summary Statistics Window in the right pane. For more information, see the "Viewing the Summary Lists" section.
Right-click Summary Lists in the left pane to display the right-click menu for the summary lists. For more information, see the "Right-Click Menu for the Summary Lists" section.
Note
Viewing the Summary Lists
To view the summary lists, select Summary Lists in the left pane of the MWTM Main Window. MWTM displays the Summary Statistics Window.
The Summary Statistics Window provides basic summary information about all discovered network objects that have been discovered by MWTM.
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, this table is sorted by Status, with failures (red statuses) at the top.
•
•
See the "Resizing, Sorting, and Hiding Table Columns" section for more information about resizing, sorting, displaying, or hiding columns.
The summary list table contains the following columns:
Status
Current status of the network objects. Possible values are:
Unknown
Unavailable
Inactive
Failed
Down
Blocked
Pending
Warning
Shutdown
Discovering
Polling
Waiting
Unmanaged
Active
For detailed definitions of each status for each type of network object, see the "MWTM Status Definitions" section on page A-1.
Total
Total number of network objects with the indicated status.
Objects in hidden columns are not included in the totals.
Nodes
Total number of discovered nodes with the indicated status.
Right-Click Menu for the Summary Lists
To see the right-click menu for the summary lists, select Summary Lists in the left pane and click the right mouse button. The summary lists right-click menu provides the following options:
Viewing Views
To see all views currently configured on this MWTM client, select the turner beside Summary Lists, then click Views in the left pane. MWTM displays the View Window in the right pane. For more information, see the "Viewing Basic Information for Views" section on page 4-4.
To display all views currently configured on this MWTM client in the left pane, select the turner beside Views. Then, you can select one of the views to display the View Details Window for that view in the right pane. For more information, see the "Viewing Detailed Information for a View" section on page 4-9.
To display the DEFAULT view, select the turner beside Views, then select DEFAULT to display the View Details Window for the DEFAULT view in the right pane. For more information, see the "Viewing Detailed Information for a View" section on page 4-9.
Right-click Views in the left pane to display the right-click menu for all views. For more information, see the "Right-Click Menu for All Views" section on page 4-4.
Right-click a view in the right pane to display the right-click menu for a specific view. For more information, see the "Right-Click Menu for a Specific View" section on page 4-5.
Viewing Nodes
To see all nodes discovered by MWTM, select the turner beside Summary Lists, then click Nodes in the left pane. MWTM displays the Node Window in the right pane. For more information, see the "Viewing Basic Information for Nodes" section on page 6-1.
To display all nodes discovered by MWTM in the left pane, select the turner beside Nodes. Then, you can select one of the nodes to display the Node Details Window for that node in the right pane. For more information, see the "Viewing Detailed Information for a Node" section on page 6-10.
Right-click Nodes in the left pane to display the right-click menu for all nodes. For more information, see the "Right-Click Menu for All Nodes" section on page 6-3.
Right-click a node in the right pane to display the right-click menu for a specific node. For more information, see the "Right-Click Menu for a Specific Node" section on page 6-4.
Viewing Interfaces
To see all interfaces discovered by MWTM, select the turner beside a node in the left pane. To see detailed information about an interface, select the interface in the left pane. MWTM displays the Interface Window in the right pane. For more information, see "Viewing Detailed Information for an Interface" section on page 7-1.
Right-click an interface in the left pane to display the right-click menu. For more information, see the "Interface Details: Right-Click Menu" section on page 7-2.
Viewing the Topology of the Network
To see a topology (graphical) view of the objects in your network select View > Show Topology in the MWTM Main Menu. MWTM displays the Topology Window in a new window. For more information, see the "Viewing the Topology of the Network" section on page 8-1.
Viewing MWTM Data on the Web
MWTM enables you to access MWTM data from the MWTM Server Home Page, using a Web browser. To do so, select View > MWTM Server > Home Page in the MWTM Main Menu. MWTM displays the MWTM Server Home Page in a Web browser. For more information, see the "Accessing MWTM Data from a Web Browser" section on page 13-1.
Viewing Server Status Information
MWTM enables you to view detailed information about the processes, pollers, tasks, and clients for the server to which you are connected, and which is currently running the MWTM server.
To display server status information, select View > MWTM Server > Status Information in the MWTM Main Menu. MWTM displays the Server Status Information window.
The Server Status Information window is composed of the following sections:
•
•
•
•
•
Server Status Information: Fields and Buttons
The Server Status Information window contains the following fields and buttons:
Server Status Information: Processes
The Server Status Information: Processes section lists the processes that make up the MWTM server.
The Processes table contains the following columns:
Name
Name of the process, such as AppServer.
Process ID
Number to uniquely identify the process.
Is Running
Indicates whether the process is running (true) or not (false).
Server Status Information: Pollers
The Server Status Information: Pollers table lists the detail and demand pollers that are currently being processed by the MWTM server.
The Server Status Information: Pollers table contains the following columns:
Poller ID
Number to uniquely identify each MWTM detail poller that is currently active.
MWTM detail pollers collect detailed data (such as real-time data, statistics, route detail, and so on) that is not collected by the regular MWTM poller.
Client Host
Name of the MWTM client that started the detail poller.
Interval
Poll interval for the detail poller, in hours, minutes, and seconds.
Iteration
Number of times the detail poller is to poll. If this field displays Forever, the detail poller will never stop polling, until requested to stop by the MWTM client.
Next Poll
Time until the next poll, in hours, minutes, and seconds.
Time Limit
Time remaining, in hours, minutes, and seconds, until the poller times out. When the poller times out, MWTM automatically stops the poller to prevent unnecessary traffic on the network and sends an appropriate error message to the client.
By default, MWTM allows pollers to run up to 8 hours. To change that setting, see the description of the mwtm pollertimeout command in the "mwtm pollertimeout" section on page C-36.
Description
Description of the detail poller.
Server Status Information: Tasks
The Server Status Information: Tasks table lists long-running services being performed by the MWTM server.
The Server Status Information: Tasks table contains the following columns:
Server Status Information: Clients
The Server Status Information: Clients table contains the following columns:
Viewing Online Help
MWTM provides the following online help options in the MWTM Main Menu:
•
•
•
Related Topics:
•
Finding Information in a Window
Sometimes it can be difficult to find a specific piece of information, such as a node name or event text, in a window. MWTM enables you to search for a character string in a window.
To find and highlight a character string in a window, select Edit > Find from the MWTM Main Menu. MWTM displays the Find dialog.
The Find dialog contains the following fields and buttons:
Resizing, Sorting, and Hiding Table Columns
The columns in some tables in MWTM can be resized, sorted, or hidden to meet your specific needs. MWTM automatically saves your new settings and, thereafter, launches the client with the new settings.
•
Changes you make to an object's Components or Recent Events table in the MWTM Main Window are reflected in all Components or Recent Events tables in the MWTM Main Window for all other objects. The changes are not reflected in Show In New Window windows or Real-Time Data and Charts windows.
Depending on your system, as well as other factors, MWTM windows can sometimes display so small that text is illegible, and columns and text entry fields are very narrow and unusable. If this happens, resize the window and widen the individual columns until the information is again legible and the columns and text entry fields are usable.
•
–
–
Changes you make to an object's Components or Recent Events table in the MWTM Main Window are reflected in all Components or Recent Events tables in the MWTM Main Window for all other objects. The changes are not reflected in Show In New Window windows or Real-Time Data and Charts windows.
•
•
•
•
Editing Object Properties
MWTM enables you to quickly and easily edit some properties of nodes and views. For more information, see the following sections:
•
•
Attaching Notes to Objects
MWTM enables you to quickly and easily attach notes to objects in the MWTM database. For more information, see the following sections:
•
•
•
Printing MWTM Windows
You can print most MWTM windows, as well as the topology map, for those times when you need hardcopy.
To print an MWTM window, select File > Print from most MWTM windows (for example, the MWTM Main Window or Topology Window).
MWTM displays the Print dialog.
The Print dialog enables you to specify print settings, such as which printer to print to, whether to send output to a file (the default location for the print file is your home directory), and whether to print duplex.
Note
When you are satisfied with your print settings, click Print. MWTM prints the map.
To exit the Print dialog at any time without printing, click Cancel.
Loading and Saving MWTM Files
MWTM enables you to quickly and easily load and save MWTM files. The files are stored on the MWTM server and can be loaded on any connected MWTM client.
To display a Load File Dialog, use one of the following procedures:
•
•
•
•
•
To display a Save File Dialog, use one of the following procedures:
•
•
•
•
Viewing Real-Time Data for a Node
MWTM enables you to view detailed statistics for a selected node.
To display detailed statistics for one of these nodes, select the Shorthaul Performance or Backhaul Performance tab in the Node Details window.
For more information, see the following sections:
•
•
Changing Real-Time Poller and Counter Settings
MWTM provides three pollers for use in the MWTM client GUI and Web pages: a fast poller, a slow poller, and a status refresh poller. MWTM enables you to change settings for those pollers, and also enables you to specify how you want MWTM to aggregate displayed counter values.
To change MWTM poller refresh and counter display settings, use one of the following methods:
•
•
Connecting to a New Server
MWTM enables you to connect the client to a new MWTM server. For example, you can monitor two or more networks from the same MWTM client, simply by switching servers. Or, if you have two MWTM servers monitoring the same network, and one server fails, the MWTM client automatically switches to the secondary server.
If you want to determine the default host name before you connect to the new server, it is contained in the SERVER_NAME entry in the System.properties file:
•
•
To connect the client to a new server, select File > Connect to New Server from the MWTM Main Menu. MWTM displays the Connect to New Server Dialog.
The Connect to New Server Dialog contains the following fields and buttons:
Integrating MWTM with Other Products
MWTM does not require either CiscoWorks or HP OpenView, but MWTM does integrate with those products to provide added value. See the following sections for more information:
•
•
•
Integrating MWTM with HP OpenView
MWTM can integrate with HP OpenView during installation, registering to receive forwarded traps. See the "Installing MWTM on Solaris" chapter of the Cisco Mobile Wireless Transport Manager Installation Guide for more information.
You can also integrate MWTM with HP OpenView after installation, using the mwtm trapsetup command. See the "mwtm trapsetup" section on page C-69 for more information.
Integrating MWTM with CiscoWorks
MWTM can integrate with CiscoWorks during installation, registering with CiscoWorks as an installed application. See the "Installing MWTM on Solaris" and "Installing MWTM on Windows" chapters of the Cisco Mobile Wireless Transport Manager Installation Guide for more information.
You can also integrate MWTM with CiscoWorks after installation, using the mwtm cwsetup command. See the "mwtm cwsetup" section on page C-16 for more information.
When MWTM is integrated with CiscoWorks, you can launch the CiscoWorks Device Center and CiscoView from the MWTM Main Menu. See the following sections for more information:
•
Launching the CiscoWorks Device Center
The CiscoWorks Device Center provides a number of useful Web-based device-monitoring functions, including reachability trends, response time trends, interface status, Syslog browsing, and a detailed inventory.
To link MWTM to the Device Center:
Step 1
Step 2
Step 3
Step 4
Launching CiscoView
CiscoView provides a real-time, color-coded, graphical representation of Cisco devices. You can use CiscoView to quickly identify an incorrect status on a port or interface. If you are running CiscoWorks on UNIX or Windows, you can access CiscoView through the link to the Web version of CiscoWorks.
To link MWTM to CiscoView:
Step 1
Step 2
Step 3
Forwarding Traps to Other Hosts (Server Only)
MWTM enables you to forward SNMP traps to other SNMP servers, or hosts. This enables MWTM to function as a trap multiplexer, integrating with high-level event- and alarm-monitoring systems such as the Cisco Info Center (CIC), HP OpenView, and Micromuse's Netcool suite of products. These systems can provide a single high-level view of all alarm monitoring in your network, making it easier to detect and resolve problems.
To enable MWTM to forward SNMP traps to other hosts, specify the list of hosts in the TrapForwarder.properties file. The default file is located in the MWTM properties directory:
•
•
In the TrapForwarder.properties file, begin all comment lines with a pound sign (#).
All other lines in the file are host definition lines, with the following format:
SERVERxx=dest-address[:portno]
where:
•
•
•
For example, the following host definition line:
SERVER02=64.102.86.104:162
enables MWTM to forward traps to Server 02, with IP address 64.102.86.104, on port 162.
Any changes you make to the TrapForwarder.properties file take effect when you restart the MWTM server. Thereafter, MWTM forwards all traps from the listed hosts except:
•
•
Version 2c traps that do not have the agent IP address already specified in the varbind list are modified to include the agent IP address in the varbind list.
You can also forward MWTM events to other hosts, in the form of SNMP traps. For more information, see the "Forwarding Events as Traps to Other Hosts" section on page 5-35.
Exporting MWTM Data
MWTM enables you to export its data for use by other products, such as CiscoWorks or Microsoft Excel. This section includes the following information:
•
•
•
Exporting Current MWTM Data for Network Objects
You can use the MWTM command line interface (CLI) to export all MWTM data, or to export only selected MWTM data.
To export all current MWTM data, with fields separated by vertical bars (|; this is the default setting), enter the mwtm export all command with the -d bar keywords:
mwtm export all -d bar
To export all MWTM data with fields separated by commas (,), specify the -d comma keywords:
mwtm export all -d comma
To export all MWTM data with fields separated by tabs, specify the -d tab keywords:
mwtm export all -d tab
To export only node-specific MWTM data, specify the node keyword:
mwtm export nodes
You can also specify the -d comma or -d tab keywords on any of these object-specific mwtm export commands.
Here is sample output for the mwtm export nodes command:
mwtm-sun24:2> ./mwtm export nodes# v5.0.0.9# t1122238712043|Sun Jul 24 16:58:32 EDT 2005## Total 12 nodes# name|displayname|sgmid|old_description|cllicode|ipaddress| old_pointcode|old_secondary|old_capability|state|statetimestamp| ioslevel|devicetype|usericonname|sysdescr|lastpolltimestamp| lastpolltime|avgpolltime|old_lasterrormsg| old_lasterrortime|notesexist|old_variant|sysuptime|rebootreason| statereason|discoveredtime|eventRcvd|telnetTo|ignore|customDisplayname|processTraps|nsocon fig|mtp3offload|rfpeerstate|trapPollingEnabled| reportPollingEnabledRNC_to_ems1941kb|RNC_to_ems1941kb|1215|not_used| not_used|null|not_used|not_used|not_used|Unmanaged|1121953480035|0|RNC|null|null|-1|-1|-1| not_used|not_used|false|not_used|-1|null|0| 1121953480036|false|null|false|null|true|not_used|not_used|not_used| false|false|BSC_to_ems1941kb|BSC_to_ems1941kb|1219|not_used|not_used| null|not_used|not_used|not_used|Unmanaged|1121953480044|0|BSC|null| null|-1|-1|-1|not_used|not_used|false|not_used|-1|null|0|1121953480045|false|null|false|nu ll|true|not_used|not_used|not_used|false|false| BSC_to_ems1941kb|BSC_to_ems1941kb|1223|not_used|not_used|null|not_used|not_used|not_used|U nmanaged|1121953480050|0|BSC|null|null|-1|-1|-1| not_used|not_used|false|not_used|-1|null|0|1121953480050|false|null| false|null|true|not_used|not_used|not_used|false|false| BSC_to_ems1941kb|BSC_to_ems1941kb|1227|not_used|not_used|null|not_used|not_used|not_used|U nmanaged|1121953480055|0|BSC|null|null|-1|-1|-1| not_used|not_used|false|not_used|-1|null|0|1121953480055|false|null| false|null|true|not_used|not_used|not_used|false|false| ems1941kb.cisco.com|ems1941kb.cisco.com|1182|not_used|not_used| [172.18.156.21][20.1.1.254]|not_used|not_used|not_used|Unknown| 1122221399654|1|CiscoMWR-1941-DC|null|sysDescr|1122220550854|170|170| not_used|not_used|false|not_used|22232166|reload|8|1121953480066|false|null|false|null|tru e|not_used|not_used|not_used|false|false| RNC_to_ems1941ka|RNC_to_ems1941ka|1291|not_used|not_used|null|not_used|not_used|not_used|U nmanaged|1121953480230|0|RNC|null|null|-1|-1|-1| not_used|not_used|false|not_used|-1|null|0|1121953480230|false|null| false|null|true|not_used|not_used|not_used|false|false| BSC_to_ems1941ka|BSC_to_ems1941ka|1294|not_used|not_used|null|not_used|not_used|not_used|U nmanaged|1121953480231|0|BSC|null|null|-1|-1|-1| not_used|not_used|false|not_used|-1|null|0|1121953480231|false|null| false|null|true|not_used|not_used|not_used|false|false| BSC_to_ems1941ka|BSC_to_ems1941ka|1297|not_used|not_used|null|not_used|not_used|not_used|U nmanaged|1121953480233|0|BSC|null|null|-1|-1|-1| not_used|not_used|false|not_used|-1|null|0|1121953480233|false|null| false|null|true|not_used|not_used|not_used|false|false| BSC_to_ems1941ka|BSC_to_ems1941ka|1300|not_used|not_used|null|not_used|not_used|not_used|U nmanaged|1121953480234|0|BSC|null|null|-1|-1|-1| not_used|not_used|false|not_used|-1|null|0|1121953480234|false|null| false|null|true|not_used|not_used|not_used|false|false| ems1941ka.cisco.com|ems1941ka.cisco.com|1233|not_used|not_used| [172.18.156.20][20.1.1.253]|not_used|not_used|not_used|Warning| 1122221418932|1|CiscoMWR-1941-DC|null|sysDescr|1122238176675|312|314| not_used|not_used|false|not_used|1752636|reload|60|1121953480235|false|null|false|null|tru e|not_used|not_used|not_used|false|false| JMX0710L3S9|JMX0710L3S9|1786|not_used|not_used|null|not_used|not_used|not_used|Waiting|112 1957445502|0|IPDevice|null|null|-1|-1|-1|not_used|not_used|false|not_used|-1|null|0|112195 7445502|false|null|false|null|true|not_used|not_used|not_used|false|false|JMX0710L2YY|JMX0 710L2YY| 3608|not_used|not_used|null|not_used|not_used|not_used|Waiting| 1121986548590|0|IPDevice|null|null|-1|-1|-1|not_used|not_used|false| not_used|-1|null|0|1121986548590|false|null|false|null|true|not_used| not_used|not_used|false|false|#For more information about the use of the mwtm export command, see the "mwtm export" section on page C-21.
Exporting Current MWTM Node Names and SNMP Community Names
To export current MWTM node names and read and write SNMP community names, in CiscoWorks import format, with fields separated by commas (,), specify the cw keyword:
mwtm export cw
You can export this data to a file, then use the file to import the devices into the CiscoWorks database.
For more information about the use of the mwtm export cw command, see the "mwtm export cw" section on page C-21.
Viewing RAN Data Export Files
MWTM provides yearly, monthly, daily, and hourly RAN data export files for all nodes and interfaces known to MWTM.
To view RAN data files, select RAN Backhaul Utilization from the MWTM Server Home Page. This action opens the MWTM - RAN Backhaul Utilization Statistics page. Then select a year, month, day, or hour for a specific node. This action displays capacity planning and backhaul utilization statistics for the selected node and interval.
To export the RAN data, click RAN Data Export from the menu bar of the MWTM - RAN Backhaul Utilization Statistics page. This action opens the File Download window. Click Open to view the export data or Save to download the export file to your computer.
Using the Windows Start Menu
This section includes the following information:
•
•
•
•
•
Launching the MWTM Client
To launch the MWTM Client, select Start > Programs > Cisco MWTM Client > Launch MWTM Client from the Windows Start menu, or double-click the MWTM icon on the desktop. MWTM launches the MWTM Client.
Launching the MWTM Event Configurator
To launch the MWTM Event Configurator, select Start > Programs > Cisco MWTM Client > Launch MWTM Event Configurator from the Windows Start menu.
Changing the Default MWTM Server Name
If there is a failure of the IP address or host name to which your MWTM client is bound, you can change the default MWTM server name from the Windows Start menu.
To change the default MWTM server name, use the following procedure:
Step 1
Step 2
Step 3
See the "Connecting to a New Server" section for more information about changing the default MWTM server name.
Changing the Default MWTM Telnet Path
MWTM provides a default Telnet interface for Telnet sessions, but you can also specify a path to a different Telnet application, if you prefer.
To specify the path to the new Telnet application, use the following procedure:
Step 1
Step 2
Step 3
Step 4
Launching the MWTM DOS Prompt
To launch a DOS prompt for MWTM from the Windows Start menu, select Start > Programs > Cisco MWTM Client > MWTM DOS Prompt. MWTM opens a DOS window, starting in the bin directory:
•
•
Launching the MWTM SSL Certificate Tool
To launch the MWTM SSL Certificate Tool from the Windows Start menu, select Start > Programs > Cisco MWTM Client > MWTM SSL Certificate Tool.
Uninstalling MWTM
You can uninstall MWTM from the Windows Start menu. For details, see the "Uninstalling MWTM" section of the Cisco Mobile Wireless Transport Manager Installation Guide.
Viewing the MWTM README File
The MWTM README file contains late-breaking information about MWTM that might not be found in the other product documentation. To open the MWTM README file from the Windows Start menu, select Start > Programs > Cisco MWTM Client > View README.
Using the MWTM Command Line Interface
MWTM provides a command line interface that enables you to interact with the MWTM and with the Cisco IOS software operating system by entering commands and optional arguments. For more information, see the "MWTM Command Reference" section on page C-1.
Running Simultaneous MWTM Sessions
MWTM uses a client/server architecture that allows you to run multiple sessions of the MWTM client simultaneously. Central services and database functions are provided on an MWTM server that communicates with multiple MWTM clients. You can install the MWTM client software on the same system as the MWTM server, or on a different system on the same network as the MWTM server.
Note
MWTM recommends a maximum of 20 clients per MWTM server. If you connect more than 20 clients to a single server, the server requires additional memory and a more powerful CPU.
Exiting the MWTM Client
When you are finished monitoring network performance statistics, you can exit the MWTM client using the following procedure:
Step 1
Step 2
