-
User Guide for the Cisco Mobile Wireless Transport Manager 6.1.1
-
Table of Contents
-
Preface
-
Overview
-
Configuring Security
-
Setting Up Your Server
-
Getting Started
-
Basic Operations
-
Understanding Basic Object Functions
-
Managing Views
-
Understanding Detailed Object Functions
-
Managing Alarms and Events
-
Viewing Network Topology
-
Accessing Data from the Web Interface
-
Viewing Administrative Information from the Web Interface
-
Managing Reports
-
Editing an ITP Route Table File
-
Editing an ITP Global Title Translation Table
-
Editing ITP MLR Address Table Files
-
Client Object Map Reference
-
Command Reference
-
FAQs
-
Troubleshooting the MWTM and the Network
-
Status Definitions
-
MIB Reference
-
Trap Reference
-
Configuring MWTM to Run with Various Networking Options
-
MWTM Ports
-
Glossary
-
Index
-
Feedback
Table Of Contents
Viewing Administrative Information from the Web Interface
Viewing MWTM System Information
Viewing MWTM User Action Messages
Viewing All Archived MWTM Messages
Viewing System Status Information
Viewing the Event Automation Log
Viewing Web Configuration Properties
Viewing Trap Forwarding Properties
Viewing Administrative Information from the Web Interface
The MWTM web interface Administrative page provides access to MWTM system information, including messages, logs, status, and properties.
This section contains:
•
Viewing MWTM System Information
•
To access the Administrative page of the MWTM web interface, click Administrative in the navigation tree in the left pane. The right pane displays the information indicated in the following table:
Note
System Information
•
•
•
•
•
CSG1 OS README•
CSG2 OS README•
GGSN OS README•
HA OS README•
•
•
•
•
•
•
•
•
•
•
•
•
–
RAN MIBs–
ITP MIBs–
CSG1 MIBs–
CSG2 MIBs–
GGSN MIBs–
BWG MIBs–
HA MIBs–
For details, see Viewing MWTM System Information.
System Messages
•
•
•
•
•
Shows tabular information about different types of system messages.
For details, see Viewing System Messages.
System Status
•
•
•
•
•
Shows the output of these system commands:
•
•
•
•
•
For details, see Viewing System Status Information.
System Logs
•
•
•
•
•
•
•
•
•
Shows the contents of these system logs:
•
•
•
•
•
•
•
•
For details, see Viewing System Logs.
Properties
•
•
•
•
•
Shows the contents of these system property files:
•
•
•
•
•
For details, see Viewing System Properties.
Viewing MWTM System Information
Depending upon which type(s) of network you are managing, you can view the following MWTM system information from the MWTM web interface by clicking Administrative in the navigation tree in the left pane:
•
To access the MWTM README page, choose README from the Administrative page.
•
•
–
–
–
–
–
–
–
To access the MWTM ITP OS README page, choose ITP OS README from the Administrative page.
•
–
–
–
To access the MWTM IPRAN OS README page, choose IPRAN OS README from the Administrative page.
•
To access the MWTM CSG1 OS README page, choose CSG1 OS README from the Administrative page.
•
To access the MWTM CSG2 OS README page, choose CSG2 OS README from the Administrative page.
•
To access the MWTM GGSN OS README page, choose GGSN OS README from the Administrative page.
•
To access the MWTM HA OS README page, choose HA OS README from the Administrative page.
•
•
MWTM-OS-Info-BWG file. This file contains a list of the supported OS software images for BWG.To access the MWTM BWG OS README page, choose BWG OS README from the Administrative page.
•
Each MIB appears in a list as a clickable link. You can open or download the contents of the MIB by clicking the MIB name. See Appendix F, "MIB Reference," for a complete list and high-level description of each supported MIB.
To access the MIBs page, choose MIBs from the Administrative page of the MWTM web interface.
Viewing System Messages
You can view the following MWTM system messages from the MWTM web interface by clicking Administrative in the navigation tree in the left pane:
Note
•
•
•
Viewing Info Messages
You can view info messages by clicking Administrative > Info Messages, or Info from the web page menu bar, if visible.
The System Messages: Last number Info Messages page shows informational messages in the MWTM system log. These messages can be useful when diagnosing and correcting MWTM operational problems.
The Last Info Messages table contains:
Viewing Error Messages
The System Messages: Last number Error Messages page shows error messages stored in the MWTM system log. These messages can be useful when diagnosing and correcting MWTM operational problems.
To access this page, click:
•
•
The Last Error Messages table contains:
Viewing MWTM User Action Messages
The System Messages: Last number Action Messages page shows user action messages stored in the MWTM system log. These messages can be useful when diagnosing and correcting MWTM operational problems, and when monitoring audit trails of user actions.
To access this page, use one of these procedures. Click:
•
•
The MWTM shows the System Messages: Last number Action Messages page. The System Messages: Last number Action Messages page has these sections:
Last Action Messages Menu
By default, the MWTM shows action messages of all classes on the System Messages: Last number Action Messages page. However, the MWTM provides menu options that enable you to display only messages of a specific class on the page.
The Last Action Messages menu contains:
Last Action Messages Table
The Last Action Messages table contains:
Viewing All Archived MWTM Messages
The System Message Archives: All Messages page shows all archived messages in the MWTM system logs, including:
•
•
•
•
•
•
•
To access the System Message Archives: All Messages page, use one of these options. Click:
•
•
On the System Message Archives: All Messages page, messages are archived by timestamp. Each archived file contains all MWTM system messages for a single session for the server to which you are connected, and which is currently running the MWTM server. (If you restart the server, the MWTM creates a new file.)
To view archived messages, click a timestamp. The System Messages Archive: Last number All Messages page appears, which shows all messages that were in the system log at the specified timestamp.
Note
The Last All Messages table contains this information (without column headers):
Viewing System Status Information
You can view this MWTM system status information from the Administrative page:
Viewing System Status
To access system status information, click Administrative > System Status. (The MWTM might take a few seconds to display this page.) This page shows the status of all MWTM servers, local clients, and processes.
Viewing System Versions
To access version information, click Administrative > System Versions. (The MWTM might take a few seconds to display this page.) This page shows version information for all MWTM servers, clients, and processes.
Viewing Connected Clients
To access connected client information, click Administrative > Connected Clients. This page lists all MWTM clients that are currently connected to the MWTM server. It also lists all Solaris and Linux users that are logged in to the MWTM server.
Viewing User Accounts
To access user account information, click Administrative > User Accounts. This page shows information about all user accounts that have been defined for the MWTM server. If no user accounts have been defined, the MWTM shows this message:
User Database is EmptyThe user accounts page displays the output of the mwtm users command. For example:
/opt/CSCOsgm/bin/mwtm usersUser Name Last Login Level Name & Number Status-----------------------------------------------------------------User1 Wed Jan 17 14:03:13 EST 2007 System Admin 5 [Account Enabled]User2 Unknown System Admin 5 [Account Enabled]User3 Wed Jan 17 13:43:30 EST 2007 System Admin 5 [Account Enabled]User Based Access Protection is Enabled.Authentication type = localThe the mwtm users command output contains:
User Name
The MWTM user for whom a User-Based Access account has been set up.
Last Login
Date and time the user last logged in to the MWTM.
Level Name & Number
Authentication level and number for the user. Valid levels and numbers are:
•
•
•
•
•
Status
Current status of the user's account. Valid status settings are:
•
•
–
–
–
Viewing License Information
To access license information and to verify license compliance, click Administrative > License Information.
MWTM displays the output from the following command:
/opt/CSCOsgm/bin/mwtm licenseinfo
When you select Administrative > License Information, MWTM displays the number of devices and cards that are managed by the MWTM software. For example, for an mSEF network, MWTM displays the number of 7600, 7300, and 7200 devices in addition to the number of SAMI cards. For ITP networks, MWTM displays the number of 7600, including the number of different types of cards on the 7600 device, 7300, 7200, and 2800 devices.
Viewing System Logs
From the Administrative page, you can view:
•
Viewing the Install Log
The Install Log shows the contents of the MWTM installation log file for the server to which you are connected, and which is currently running the MWTM.
To access the Install Log, click Administrative > Install Log. You can also view the Console Log with the mwtm installlog command.
Viewing the Console Log
The Console Log shows the contents of the MWTM system console log file for the server to which you are connected, and which is currently running the MWTM. The console log file contains unexpected error and warning messages from the MWTM server, such as those that might occur if the MWTM server cannot start. It also provides a history of start-up messages for server processes and the time each message appeared.
To access the Console Log, click Administrative > Console Log. You can also view the Console Log with the mwtm console command.
Viewing the Command Log
The Command Log shows the contents of the MWTM system command log file for the server to which you are connected, and which is currently running the MWTM server. The system 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.
To access the Command Log, click Administrative > Command Log. You can also view the Command Log with the mwtm cmdlog command.
The MWTM Command Log page appears. The Command Log table contains:
Viewing the Event Automation Log
The Event Automation Log shows the contents of the system event automation log file for the server to which you are connected, and which is currently running the MWTM server. The system event automation log lists all messages that event automation scripts generate.
The default path and filename for the system event automation log file is /opt/CSCOsgm/logs/eventAutomationLog.txt. If you installed the MWTM in a directory other than /opt, then the system event automation log file is in that directory.
To access the Event Automation Log, click Administrative > Event Automation Log. You can also view the Event Automation Log with the mwtm eventautolog command.
Related Topic
Changing the Way the MWTM Processes Events, page 9-25.
Viewing the Security Log
The Security Log shows 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. The system security log lists:
•
•
•
•
The default path and filename for the system security log file is /opt/CSCOsgm/logs/sgmSecurityLog.txt. If you installed the MWTM in a directory other than /opt, then the system security log file is in that directory.
To access the Security Log, click Administrative > Security Log. You can also view the Security Log with the mwtm seclog command.
The Last Security Entries table contains these columns:
Viewing the Install Log
The Install Log shows the contents of the MWTM system installation log. The installation log contains messages and other information recorded during installation, which can be useful when troubleshooting problems. The Install Log also records the installer's selections (for example, whether the installer chose to configure the MWTM to receive SNMP traps).
The default path and filename for the install log file is /opt/CSCOsgm/install/cisco_sgmsvr_install.log. If you installed the MWTM in a directory other than /opt, then the install log file is in that directory.
To access the Install Log, click Administrative > Install Log. You can also view the Install Log with the mwtm installlog command.
Viewing the Web Access Logs
The Web Access Logs page shows a list of web access log files for the server to which you are connected, and which is currently running the MWTM server. The web access log lists all system web access messages that have been logged for the MWTM server, providing an audit trail of all access to the MWTM server through the MWTM web interface.
The default path and filename for the web access log file is /opt/CSCOsgm/apache/logs/access_log. If you installed the MWTM in a directory other than /opt, then the web access log file is in that directory.
To access the Web Access Logs page, click Administrative > Web Access Logs. You can also view the Web Access Logs page using the mwtm webaccesslog command.
Viewing the Web Error Logs
The Web Error Logs page shows a list of web error log files for the server to which you are connected, and which is currently running the MWTM server. The web server error log lists all system web error messages that have been logged for the MWTM web server. You can use the web error log to troubleshoot the source of problems that users may have encountered while navigating the MWTM web interface.
The default path and filename for the web error log file is /opt/CSCOsgm/apache/logs/error_log. If you installed the MWTM in a directory other than /opt, then the web error log file is in that directory.
To access the Web Error Logs page, click Administrative > Web Error Logs. You can also view the Web Error Logs page using the mwtm weberrorlog command.
Viewing the Report Log
The Report Log shows the message log for ITP reports for the server to which you are connected, and which is currently running the MWTM server. You can view this log to determine the beginning and finish times for report generation. The log also records errors that occurred during report generation (for example, server connection errors).
The default path and filename for the report log file is /opt/CSCOsgm/logs/sgmReportLog.txt. If you installed the MWTM in a directory other than /opt, then the report log file is in that directory.
To access the Report Log, click Administrative > Report Log. You can also view the Report Log with the mwtm replog command.
Viewing the Report Timers
To access the Report Timers, click Administrative > Report Timers.
The Report Timers displays the output of the following command:
/opt/CSCOsgm/bin/mwtm statrep timer
The output displays the timer file for MWTM network statistics reports. The timer file is useful for identifying how much time the MWTM spends gathering report data and generating reports.
Viewing Properties
Property files for the MWTM are in the /opt/CSCOsgm/properties directory. You can view these MWTM properties from the Administrative page.
•
•
Viewing System Properties
To access the System Properties file, click Administrative > System in the Properties pane. The MWTM shows the contents of the /opt/CSCOsgm/properties/System.properties file.
The System Properties file contains MWTM server and client properties that control various MWTM configuration parameters.
You can change some of the system properties using MWTM commands:
For these system properties, you can view related documentation:
CLIENT_PORT
DATASERVER_PORT
LOGINSERVER_PORT
RMIREGISTRY_PORT
MAX_CHART_SERIES
Viewing Server Properties
To access the Server Properties file, click Administrative > Server in the Properties pane. The MWTM shows the contents of the /opt/CSCOsgm/properties/Server.properties file.
The Server Properties file contains various properties that control the MWTM server.
You can use MWTM commands to change these server properties:
DEMAND_POLLER_TIMELIMIT
SNMP_MAX_ROWS
UNKNOWN_AGING_TIMEOUT
To change poller parameters in the Server Properties file, see the "Changing MWTM Server Poller Settings" section on page 3-2.
Viewing Web Configuration Properties
To access the Web Configuration Properties file, click Administrative > WebConfig in the Properties pane. The MWTM shows the contents of the /opt/CSCOsgm/properties/
WebConfig.properties file.The Web Configuration Properties file contains properties that control the configuration of the MWTM web interface. For example:
MAX_ASCII_ROWS = 6000MAX_HTML_ROWS = 100# The selectable page sizes start at MIN_SELECTABLE_PAGE_SIZE and doubles until# the MAX_SELECTABLE_PAGE_SIZE value is reached# (e.g. 25, 50, 100, 200, 400, 800)MIN_SELECTABLE_PAGE_SIZE = 25MAX_SELECTABLE_PAGE_SIZE = 800LOG_UPDATE_INTERVAL = 300WEB_UTIL = percentWEB_NAMES = displayMAX_EV_HIST = 15000You can use the MWTM to change the web configuration properties:
LOG_UPDATE_INTERVAL
To control how often, in seconds, the MWTM updates certain web output, use the mwtm weblogupdate command. The valid range is 1 second to an unlimited number of seconds. The default value is 300 seconds (5 minutes).
MAX_ASCII_ROWS
To set the maximum number of rows for MWTM ASCII web output, such as displays of detailed debugging information, use the mwtm maxasciirows command. The valid range is 1 row to an unlimited number of rows. The default value is 6,000 rows.
MAX_EV_HIST
To set the maximum number of rows for MWTM to search in the event history logs, use the mwtm maxevhist command. The event history logs are the current and archived MWTM network status logs for status change and SNMP trap messages. The MWTM sends the results of the search to the web browser, where the results are further limited by the setting of the mwtm maxhtmlrows command. The valid range is 1 row to an unlimited number of rows. The default value is 15,000 rows.
MAX_HTML_ROWS
To set the maximum number of rows for MWTM HTML web output, such as displays of statistics reports, status change messages, or SNMP trap messages, use the mwtm maxhtmlrows command. This lets you select a page size (if you have not explicitly chosen a page size). Once you select a page size from any page, the MWTM remembers your preference until you delete your browser cookies. The default value is 100 rows.
MIN_SELECTABLE_PAGE_SIZE
This setting determines the minimum page size for the user to select from the Page Size drop-down menu. The page size values start with the MIN_SELECTABLE_PAGE_SIZE and double until they reach the MAX_SELECTABLE_PAGE_SIZE.
MAX_SELECTABLE_
PAGE_SIZEThis setting determines the maximum page size for the user to select from the Page Size drop-down menu. The page size values start with the MIN_SELECTABLE_PAGE_SIZE and double until they reach the MAX_SELECTABLE_PAGE_SIZE.
WEB_NAMES
To specify whether the MWTM should show real DNS names or display names in web pages, enter the mwtm webnames command. To show:
•
•
WEB_UTIL
To specify whether the MWTM should display send and receive as percentages or in Erlangs in web pages, enter the mwtm who command. To show:
•
•
See Displaying RAN-O Statistics, page 11-21 and Displaying Error Statistics, page 11-25 for more information.
See Chapter 13, "Managing Reports" for more information on send and receive for linksets and links.
Each of the web configuration commands requires you to be logged in as the root user, as described in the "Becoming the Root User (Server Only)" section on page 4-2, or as a superuser, as described in the "Specifying a Super User (Server Only)" section on page 2-17.
Related Topic
Viewing Reports Properties
To access the Reports Properties file, click Administrative > Reports in the Properties pane. The MWTM shows the contents of the /opt/CSCOsgm/properties/Reports.properties file.
The Reports Properties file contains properties that control various aspects of the reports that are available in the MWTM web interface.
You can use MWTM commands to change these reports properties:
Viewing Trap Forwarding Properties
To access the Trap Forwarding Properties file, click Administrative > TrapForwarding in the Properties. The MWTM shows the contents of the /opt/CSCOsgm/properties/TrapForwarder.properties file.
The Trap Forwarder Properties file contains a list of the destination addresses for the trap forwarder. Enter each destination address on its own line and use this format:
SERVERxx=destination_IP_address[:port_number]
The port_number parameter is optional.
