-
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
MWTM Command Reference
This appendix provides the format and a brief description of the following MWTM commands, listed alphabetically. Each command is available on the server only, server and Solaris clients only, or server and all clients (including Windows) as indicated.
•
mwtm
mwtm
Server and Solaris/Linux Clients Only
Command Description
Displays the command syntax for the mwtm command and all of its options. The function of this command is identical to mwtm help.
List of MWTM Commands
mwtm adduser
Server Only
Full Syntax
mwtm adduser [username]
Command Description
If MWTM User-Based Access is enabled, adds the specified user to the authentication list.
When you add a user, MWTM prompts you for the following information:
•
•
•
–
–
–
–
–
See the "Implementing MWTM User-Based Access (Server Only)" section on page 10-2 for more information on authentication levels, and on the use of this command.
You must be logged in as the root user or as a super user to use this command.
Note
List of MWTM Commands
mwtm authtype
Server Only
Full Syntax
mwtm authtype [local | solaris | linux]
Command Description
Configures MWTM security authentication, as follows:
•
•
•
See the "Implementing MWTM User-Based Access (Server Only)" section on page 10-2 for more information on the use of this command.
You must be logged in as the root user or as a super user to use this command.
List of MWTM Commands
mwtm backup
Server Only
Command Description
Backs up MWTM data files to the MWTM installation directory. MWTM automatically backs up all data files at 1:30 AM each night, but you can use this command to back up the files at any other time.
•
•
To restore the MWTM data files from the previous night's backup, use the mwtm restore command. Do not try to manually extract the backup files.
You must be logged in as the root user (not as a super user) to use this command.
List of MWTM Commands
mwtm backupdir
Server Only
Full Syntax
mwtm backupdir [directory]
Command Description
Enables you to change the directory in which MWTM stores its nightly backup files. The default backup directory is the directory in which MWTM is installed:
•
•
If you specify a new directory that does not exist, MWTM does not change the directory, and issues an appropriate message.
You must be logged in as the root user or as a super user to use this command.
List of MWTM Commands
mwtm badloginalarm
Server Only
Full Syntax
mwtm badloginalarm [number-of-attempts | clear]
Command Description
If MWTM User-Based Access is enabled, number of unsuccessful login attempts allowed before MWTM generates an alarm.
The valid range is 1 unsuccessful attempt to an unlimited number of unsuccessful attempts. The default value is 5 unsuccessful attempts.
MWTM records alarms in the system security log file. The default path and filename for the system security log file is /opt/CSCOsgm/logs/sgmSecurityLog.txt. If you installed MWTM in a directory other than /opt, then the system security log file is located in that directory.
To view the system security log file, enter mwtm seclog. You can also view the system security log on the MWTM System Security Log Web page. For more information, see the "Viewing the MWTM System Security Log" section on page 13-41.
To reset the valid range back to 5 attempts, enter mwtm badloginalarm clear.
See the "Automatically Disabling Users and Passwords (Server Only)" section on page 10-8 for more information on the use of this command.
You must be logged in as the root user or as a super user to use this command.
List of MWTM Commands
mwtm badlogindisable
Server Only
Full Syntax
mwtm badlogindisable [number-of-attempts | clear]
Command Description
If MWTM User-Based Access is enabled, number of unsuccessful login attempts by a user allowed before MWTM disables the user's authentication. MWTM does not delete the user from the authentication list, MWTM only disables the user's authentication. To re-enable the user's authentication, use the mwtm enableuser command.
The valid range is 1 unsuccessful attempt to an unlimited number of unsuccessful attempts. The default value is 10 unsuccessful attempts.
To reset the valid range back to 5 attempts, enter mwtm badlogindisable clear.
See the "Automatically Disabling Users and Passwords (Server Only)" section on page 10-8 for more information on the use of this command.
You must be logged in as the root user or as a super user to use this command.
List of MWTM Commands
mwtm browserpath
Server and Solaris/Linux Clients Only
Command Description
Sets a user-defined MWTM Web browser path, and verifies that the browser specified by the user exists.
You must be logged in as the root user (not as a super user) to use this command.
List of MWTM Commands
mwtm certgui
Solaris Clients Only
Command Description
If Secure Sockets Layer (SSL) is implemented in your MWTM system, opens the MWTM Certificate Tool window, which enables you to manage SSL certificates on the MWTM client.
Note
You must be logged in as the root user (not as a super user) to use this command in Solaris.
List of MWTM Commands
mwtm certtool
Server and Solaris Clients Only
Full Syntax
mwtm certtool [clear | delete alias | export alias [-file filename] | import alias [-file filename] | list]
Command Description
If Secure Sockets Layer (SSL) is implemented in your MWTM system, enables you to manage SSL certificates on the MWTM client from the command line.
Note
Use the following keywords and arguments with this command:
•
The alias argument can be any character string; the host name of the server from which you are importing the certificate is a good choice.
To import the certificate from a file, specify the optional -file keyword and a filename.
•
To export the certificate to a file, specify the optional -file keyword and a filename.
•
•
•
Solaris Only: You must be logged in as the root user (not as a super user) to use this command in Solaris.
List of MWTM Commands
mwtm changes
Server Only
Command Description
Displays the contents of the MWTM CHANGES file. The CHANGES file lists all bugs that have been resolved in MWTM, sorted by release, from the current release back to Release 2.2.
•
•
List of MWTM Commands
mwtm clean
Server Only
Command Description
Removes all MWTM data from the MWTM server, excluding message log files, backup files, and report files. This command restores the MWTM server to a "clean" state, such as would exist after a new installation of MWTM, except for the presence of the retained files.
Data removed includes all MWTM data, notes, preferences, security settings, route files, seed files, event filters, report control files, and views, as well as any user-created files stored in MWTM directories.
You must be logged in as the root user (not as a super user) to use this command.
List of MWTM Commands
mwtm cleanall
Server Only
Command Description
Removes all MWTM data from the MWTM server, including message log files, backup files, report files, configuration settings, and security settings. This command restores the MWTM server to a "clean" state, such as would exist after a new installation of MWTM.
Data removed includes all MWTM data, notes, preferences, security settings, route files, seed files, event filters, report control files, views, message log files, backup files, and report files, as well as any user-created files stored in MWTM directories.
You must be logged in as the root user (not as a super user) to use this command.
List of MWTM Commands
mwtm cleandb
Server Only
Command Description
Removes all MWTM data from the MWTM server, including the core data model database, all view files, notes associated with objects, and event filters, but excluding message log files, backup files, report files, configuration settings, security settings, and route files. This command restores the MWTM server to a "clean" state, such as would exist after a new installation of MWTM, except for the presence of the retained files.
Data removed includes all MWTM data, notes, event filters, and views, as well as any user-created files stored in MWTM directories.
You must be logged in as the root user (not as a super user) to use this command.
List of MWTM Commands
mwtm cleandiscover
Server Only
Full Syntax
mwtm cleandiscover [seed-node] [seed-node]...
Command Description
Enables you to delete all current network data and begin a clean discovery of the network from the command line. Use the seed-node arguments to specify the DNS names or IP addresses of one or more seed nodes.
Note
Running this command does not remove any notes, preferences, views, message log files, backup files, or report files, nor any user-created files stored in MWTM directories.You must be logged in as the root user or as a super user to use this command.
List of MWTM Commands
mwtm cliconntimer
Server Only
Full Syntax
mwtm cliconntimer [number-of-seconds | clear]
Command Description
Specifies how long, in seconds, an MWTM client is to wait for a message from the MWTM server before exiting. If the timer expires, the client pings the server and takes the following action:
•
•
•
The valid range is 10 seconds to an unlimited number of seconds. The default value is 60 seconds.
To restore the default timeout of 60 seconds, enter the mwtm cliconntimer clear command.
Any changes you make take effect when you restart the MWTM server.
You must be logged in as the root user or as a super user to use this command.
List of MWTM Commands
mwtm client
Solaris/Linux Clients Only
Full Syntax
mwtm client [hostname]
Command Description
Starts an MWTM client on the specified host. If no host name is specified, starts an MWTM client on the default host, as specified during installation. See the "Connecting to a New Server" section on page 3-33 for information about determining the default host.
If you Telnet into a remote workstation, the DISPLAY variable must be set to your local display, or you cannot use this command. If the DISPLAY variable is not set automatically, you must set it manually. See the "Setting the DISPLAY Variable (Client Only)" section on page 11-30 for details.
List of MWTM Commands
mwtm clientlogs
Server Only
Command Description
Uses PAGER to display the MWTM client log files.
The MWTM client log files contain client console output for all MWTM clients, one file per local or remote client. The file for a client is created by MWTM automatically when the client starts.
•
•
List of MWTM Commands
mwtm clitimeout
Server Only
Full Syntax
mwtm clitimeout [number-of-minutes | clear]
Command Description
Specifies how long, in minutes, an MWTM client can be inactive before being disconnected automatically by MWTM.
This function is disabled by default. If you do not specify this command, clients are never disconnected as a result of inactivity.
If you enter the mwtm clitimeout command, the valid range is 1 minute to an unlimited number of minutes. There is no default value.
If you have enabled this function and you want to disable it (that is, never disconnect a client as a result of inactivity), enter the mwtm clitimeout clear command.
See the "Automatically Disabling Users and Passwords (Server Only)" section on page 10-8 for more information on the use of this command.
You must be logged in as the root user or as a super user to use this command.
List of MWTM Commands
mwtm cmdlog
Server Only
Full Syntax
mwtm cmdlog [clear | -r]
Command Description
Uses PAGER to display the contents of the system command log. 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 clear the log and restart the server, enter mwtm cmdlog clear.
To display the contents of the log in reverse order, with the most recent commands at the beginning of the log, enter mwtm cmdlog -r.
You must be logged in as the root user or as a super user to use this command.
List of MWTM Commands
mwtm console
Server Only
Command Description
Displays the contents of the console log file, sgmConsoleLog.txt. 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.
You must be logged in as the root user or as a super user to use this command.
List of MWTM Commands
mwtm countnodes
Server Only
Command Description
Displays a count of nodes in the current MWTM database.
You must be logged in as the root user or as a super user to use this command.
List of MWTM Commands
mwtm countobjects
Server Only
Command Description
Displays a count of all objects in the current MWTM database.
You must be logged in as the root user or as a super user to use this command.
List of MWTM Commands
mwtm cwsetup
Solaris Server Only
Full Syntax
mwtm cwsetup [install | uninstall]
Command Description
Manages the integration of MWTM with CiscoWorks:
•
–
–
•
Always run mwtm cwsetup uninstall before uninstalling CiscoWorks from your system.
You must be logged in as the root user (not as a super user) to use this command.
List of MWTM Commands
mwtm delete
Server Only
Full Syntax
mwtm delete node [all | node [node]...]
Command Description
Deletes objects from the MWTM database.
•
•
See the "Deleting a Node" section on page 6-48 for more information.
You must be logged in as the root user or as a super user to use this command.
List of MWTM Commands
mwtm deluser
Server Only
Full Syntax
mwtm deluser [username]
Command Description
If MWTM User-Based Access is enabled, deletes the specified user from the authentication list. To add the user back to the list, use the mwtm adduser command.
See the "Manually Disabling Users and Passwords (Server Only)" section on page 10-11 for more information on the use of this command.
You must be logged in as the root user or as a super user to use this command.
List of MWTM Commands
mwtm disablepass
Server Only
Full Syntax
mwtm disablepass [username]
Command Description
If MWTM User-Based Access is enabled and mwtm authtype is set to local, disables the specified user's authentication and password. MWTM does not delete the user from the authentication list, MWTM only disables the user's authentication and password.
•
•
If mwtm authtype is set to solaris, you cannot use this command. Instead, you must manage passwords on the external authentication servers.
See the "Manually Disabling Users and Passwords (Server Only)" section on page 10-11 for more information on the use of this command.
You must be logged in as the root user or as a super user to use this command.
List of MWTM Commands
mwtm disableuser
Server Only
Full Syntax
mwtm disableuser [username]
Command Description
If MWTM User-Based Access is enabled, disables the specified user's authentication. MWTM does not delete the user from the authentication list, MWTM only disables the user's authentication.
•
•
See the "Manually Disabling Users and Passwords (Server Only)" section on page 10-11 for more information on the use of this command.
You must be logged in as the root user or as a super user to use this command.
Note
List of MWTM Commands
mwtm discover
Server Only
Full Syntax
mwtm discover [seed-node] [seed-node]...
Command Description
Enables you to discover the network from the command line. Use the seed-node arguments to specify the DNS names or IP addresses of one or more seed nodes. For more information about seed nodes, see Loading Seed Nodes and Seed Files, page 2-11.
Note
You must be logged in as the root user or as a super user to use this command.
List of MWTM Commands
mwtm enableuser
Server Only
Full Syntax
mwtm enableuser [username]
Command Description
If MWTM User-Based Access is enabled, re-enables the specified user's authentication, which had been disabled either automatically by MWTM or by a super user.
The user's authentication is re-enabled with the same password as before.
See the "Enabling and Changing Users and Passwords (Server Only)" section on page 10-13 for more information on the use of this command.
You must be logged in as the root user or as a super user to use this command.
Note
List of MWTM Commands
mwtm eventeditor
Solaris/Linux Clients Only
Full Syntax
mwtm eventeditor [hostname]
Command Description
Starts an MWTM Event Configurator on the specified host. If no host name is specified, starts an MWTM Event Configurator on the default host, as specified during installation. See the "Connecting to a New Server" section on page 3-33 for information about determining the default host.
For more information about the MWTM Event Configurator, see the "Changing the Way MWTM Processes Events" section on page 5-17.
If you Telnet into a remote workstation, the DISPLAY variable must be set to your local display, or you cannot use this command. If the DISPLAY variable is not set automatically, you must set it manually. See the "Setting the DISPLAY Variable (Client Only)" section on page 11-30 for details.
mwtm eventlog
Server Only
Full Syntax
mwtm eventlog [clear | -r]
Command Description
Uses PAGER to display the contents of the MWTM event automation log. The event automation log lists all messages generated by scripts launched by event automation.
To clear the log and restart the server, enter mwtm eventlog clear.
To display the contents of the log in reverse order, with the most recent events at the beginning of the log, enter mwtm eventlog -r.
You must be logged in as the root user or as a super user to use this command.
List of MWTM Commands
mwtm evilstop
Server Only
Command Description
Forcefully stops all MWTM servers on the local host. This command can be useful if a normal mwtm stop does not stop the servers.
You must be logged in as the root user (not as a super user) to use this command.
List of MWTM Commands
mwtm export
Server Only
Full Syntax
mwtm export [-d {bar | comma | tab}] [all | nodes ]
Command Description
Exports current MWTM data.
By default, MWTM separates data fields with vertical bars (|). However, you can specify commas (,) or tabs as the separator:
•
•
•
By default, MWTM exports all data. However, you can limit the data that MWTM exports:
•
•
You must be logged in as the root user or as a super user to use this command.
List of MWTM Commands
mwtm export cw
Solaris Server Only
Full Syntax
mwtm export cw
Command Description
Exports current MWTM node names and read and write SNMP community names, in CiscoWorks import format, with fields separated by commas (,). You can export this data to a file, then use the file to import the devices into the CiscoWorks database.
You must be logged in as the root user or as a super user to use this command.
List of MWTM Commands
mwtm help
Server and Solaris/Linux Clients Only
Full Syntax
mwtm help [keyword]
Command Description
Displays the command syntax for the mwtm command and all of its options.
To see the command syntax for a specific keyword, enter mwtm help followed by that keyword. For example, if you enter mwtm help restart, MWTM displays:
mwtm restart - Restarts all MWTM Servers on the local host.mwtm restart web - Restarts Web servers on the local host.mwtm restart jsp - Restarts JSP servers on the local host.mwtm restart pm - Restarts Process Manager on the local host.List of mwtm Commands
mwtm inactiveuserdays
Server Only
Full Syntax
mwtm inactiveuserdays [number-of-days | clear]
Command Description
If mwtm User-Based Access is enabled, number of days a user can be inactive before disabling that user account.
This function is disabled by default. If you do not specify this command, user accounts are never disabled as a result of inactivity.
If you enter the mwtm inactiveuserdays command, the valid range is 1 day to an unlimited number of days. There is no default setting.
If you have enabled this function and you want to disable it (that is, prevent MWTM from automatically disabling user accounts as a result of inactivity), enter mwtm inactiveuserdays clear.
To re-enable the user's authentication, use the mwtm enableuser command.
See the "Automatically Disabling Users and Passwords (Server Only)" section on page 10-8 for more information on the use of this command.
You must be logged in as the root user or as a super user to use this command.
List of MWTM Commands
mwtm installlog
Server and Solaris/Linux Clients Only
Full Syntax
mwtm installlog [server | client]
Command Description
Displays the latest install log for the server or client. If you do not specify server or client, displays the latest install log for both the server and client.
You must be logged in as the root user or as a super user to use this command.
List of MWTM Commands
mwtm iosinfo
Server Only
Command Description
Displays the versions of IOS with which MWTM is compatible.
List of MWTM Commands
mwtm ipaccess
Server Only
Full Syntax
mwtm ipaccess [add [ip-addr] | clear | edit | list | rem [ip-addr] | sample]
Command Description
Enables you to create and manage a list of client IP addresses allowed to connect to the MWTM server.
The list of allowed client IP addresses is contained in the ipaccess.conf file. By default, when you first install MWTM, the ipaccess.conf file does not exist and MWTM allows all client IP addresses to connect to the MWTM server. To create the ipaccess.conf file and work with the list of allowed client IP addresses, specify one of the following keywords:
•
•
•
•
•
•
Any changes you make take effect when you restart the MWTM server.
See the "Limiting MWTM Client Access to the MWTM Server (Server Only)" section on page 10-32 for more information about using this command.
You must be logged in as the root user or as a super user to use this command.
List of MWTM Commands
mwtm jspport
Server Only
Full Syntax
mwtm jspport [port-number]
Command Description
Sets a new port number for the JSP server, where port-number is the new, numeric port number. MWTM verifies that the new port number is not already in use.
This command is needed only if you must change the port number after you install MWTM, because another application must use the current port number.
The new port number must contain only numbers. If you enter a port number that contains non-numeric characters, such as mwtm13, MWTM displays an error message and returns to the command prompt without changing the port number.
You must be logged in as the root user (not as a super user) to use this command.
List of MWTM Commands
mwtm keytool
Solaris Server Only
Full Syntax
mwtm keytool [clear | genkey | import_cert cert_filename | import_key key_filename cert_filename | list | print_csr | print_crt]
Command Description
If SSL is implemented in your MWTM system, manages SSL keys and certificates on the MWTM server.
If you installed the MWTM server and client on the same workstation, also automatically manages the certificates on the client.
Use the following keywords and arguments with this command:
•
•
•
•
•
•
•
See the "Implementing SSL Support in MWTM (Solaris Only)" section on page 10-22 for more information on the use of this command.
You must be logged in as the root user (not as a super user) to use this command.
List of MWTM Commands
mwtm killclients
Server Only
Command Description
Forcefully stops all MWTM clients, including Event Configurators, on the local host.
You must be logged in as the root user (not as a super user) to use this command.
List of MWTM Commands
mwtm listusers
Server Only
Full Syntax
mwtm listusers [username]
Command Description
If MWTM User-Based Access is enabled, lists all currently defined users in the authentication list, including the following information for each user:
•
•
•
•
To list information for a specific user, use the username argument to specify the user.
See the "Listing All Currently Defined Users (Server Only)" section on page 10-17 for more information on the use of this command.
You must be logged in as the root user or as a super user to use this command.
List of MWTM Commands
mwtm logger
Server Only
Command Description
Displays the system messages messageLog.txt file with tail -f.
To stop the display, enter Ctrl-c.
List of MWTM Commands
mwtm logtimemode
Server Only
Full Syntax
mwtm logtimemode [12 | 24]
Command Description
Sets the time mode for dates in log files (except sgmCommandLog.txt and sgmSecurityLog.txt):
•
•
You must be logged in as the root user or as a super user to use this command.
List of MWTM Commands
mwtm maxasciirows
Server Only
Full Syntax
mwtm maxasciirows [number-of-rows]
Command Description
Sets the maximum number of rows for MWTM ASCII Web output, such as displays of detailed debugging information.
If you enter this command without the number-of-rows argument, MWTM displays the current maximum number of rows. You can then change that value, or leave it as-is. The valid range is 1 row to an unlimited number of rows. The default value is 6000 rows.
You must be logged in as the root user or as a super user to use this command.
List of MWTM Commands
mwtm maxevhist
Server Only
Full Syntax
mwtm maxevhist [number-of-rows]
Command Description
Sets the maximum number of rows for MWTM to search in the event history logs. The event history logs are the current and archived MWTM network status logs for status change and SNMP trap messages. 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.
If you enter this command without the number-of-rows argument, MWTM displays the current maximum number of rows. You can then change that value, or leave it as-is. The valid range is 1 row to an unlimited number of rows. The default value is 15000 rows.
The default setting is sufficient in most MWTM environments. However, you might need to increase the setting if MWTM has archived a large number of event history logs, each log contains thousands of messages, and you want to search more than 15000 rows. However, be aware that increasing this setting can increase the search time.
You must be logged in as the root user or as a super user to use this command.
List of MWTM Commands
mwtm maxhtmlrows
Server Only
Full Syntax
mwtm maxhtmlrows [number-of-rows]
Command Description
Sets the maximum number of rows for MWTM HTML Web output, such as displays of statistics reports, status change messages, or SNMP trap messages.
If you enter this command without the number-of-rows argument, MWTM displays the current maximum number of rows. You can then change that value, or leave it as-is. The valid range is 1 row to an unlimited number of rows. The default value is 200 rows.
You must be logged in as the root user or as a super user to use this command.
List of MWTM Commands
mwtm mldebug
Server Only
Full Syntax
mwtm mldebug [mode]
Command Description
Sets the mode for logging MWTM debug messages:
•
•
•
•
•
•
•
•
•
•
•
•
This command can adversely affect MWTM performance. Use this command only under guidance from the Cisco TAC.
You must be logged in as the root user or as a super user to use this command.
List of MWTM Commands
mwtm motd
Server Only
Full Syntax
mwtm motd [cat | disable | edit | enable]
Command Description
Manages the MWTM message of the day file, which is a user-specified MWTM system notice. You can use the message of the day to inform users of important changes or events in the MWTM system. The message of the day also gives users an opportunity to exit the MWTM client before launching.
If the message of the day is enabled, it is displayed whenever a user attempts to launch an MWTM client:
•
•
Use the following keywords with this command:
•
•
•
•
See the "Displaying a Message of the Day (Server Only)" section on page 10-15 for more information on the use of this command.
You must be logged in as the root user or as a super user to use this command.
List of MWTM Commands
mwtm msglog
Server Only
Full Syntax
mwtm msglog [clear | -r]
Command Description
Uses PAGER to display the contents of the system message log.
To save the current contents of the log, clear the log, and restart the server, enter mwtm msglog clear.
To display the contents of the log in reverse order, with the most recent messages at the beginning of the log, enter mwtm msglog -r.
You must be logged in as the root user or as a super user to use this command.
List of MWTM Commands
mwtm msglogage
Server Only
Full Syntax
mwtm msglogage [number-of-days]
Command Description
Sets the maximum number of days to archive system message log files before deleting them from the MWTM server.
If you enter this command without the number-of-days argument, MWTM displays the current maximum number of days. You can then change that value, or leave it as-is. The valid range is 1 day to an unlimited number of days. The default value is 31 days.
You must be logged in as the root user or as a super user to use this command.
List of MWTM Commands
mwtm msglogdir
Server Only
Full Syntax
mwtm msglogdir [directory]
Command Description
Changes the default location of all MWTM system message log files. By default, the system message log files are located on the MWTM server at /opt/CSCOsgm/logs.
Note
Do not set the new directory to the same directory in which you are storing report files (mwtm repdir).After you change the directory, MWTM asks if you want to restart the MWTM server. The new directory takes effect when you restart the MWTM server.
You must be logged in as the root user or as a super user to use this command. If you are changing to a default location outside MWTM, you must have appropriate permissions for that location.
List of MWTM Commands
mwtm msglogsize
Server Only
Full Syntax
mwtm msglogsize [number-of-lines]
Command Description
Sets the maximum number of messages to write to the message log file before starting a new file.
If you enter this command without the number-of-lines argument, MWTM displays the current maximum number of messages. You can then change that value, or leave it as-is.
The valid range is 1000 messages to an unlimited number of messages. The default value is 10000 messages (approximately 2 MB). Therefore, the default message log file and its copy require approximately 4 MB, combined. If you specify a larger message log file size, the message log file and its copy require proportionally more space.
When changing the number of messages to display, keep in mind that every 5000 messages require approximately 1 MB. You need to balance your need to refer to old messages against the amount of space they take up.
You must be logged in as the root user or as a super user to use this command.
List of MWTM Commands
mwtm netlog
Server Only
Full Syntax
mwtm netlog [clear | -r]
Command Description
Uses PAGER to display the contents of the network status log.
To save the current contents of the log, clear the log, and restart the server, enter mwtm netlog clear.
To display the contents of the log in reverse order, with the most recent network status messages at the beginning of the log, enter mwtm netlog -r.
You must be logged in as the root user or as a super user to use this command.
List of MWTM Commands
mwtm netlogger
Server Only
Command Description
Displays the current contents of the network status log file with tail -f.
To stop the display, enter Ctrl-c.
List of MWTM Commands
mwtm newlevel
Server Only
Full Syntax
mwtm newlevel [username]
Command Description
If MWTM User-Based Access is enabled, changes the authentication level for the specified user. Valid levels are:
•
•
•
•
•
See the "Enabling and Changing Users and Passwords (Server Only)" section on page 10-13 for more information on the use of this command.
You must be logged in as the root user or as a super user to use this command.
List of MWTM Commands
mwtm passwordage
Server Only
Full Syntax
mwtm passwordage [number-of-days | clear]
Command Description
If MWTM User-Based Access is enabled and mwtm authtype is set to local, number of days allowed before forcing users to change passwords.
Note
This function is disabled by default. If you do not specify this command, users never need to change their passwords.
If you enter the mwtm passwordage command, the valid range is 1 day to an unlimited number of days. There is no default setting.
If you have enabled this function and you want to disable it (that is, prevent MWTM from forcing users to change passwords), enter mwtm passwordage clear.
Note
See the "Automatically Disabling Users and Passwords (Server Only)" section on page 10-8 for more information on the use of this command.
You must be logged in as the root user or as a super user to use this command.
List of MWTM Commands
mwtm patchlog
Server Only
Full Syntax
mwtm patchlog
Command Description
Uses PAGER to display the contents of the patch log, which lists the patches that have been installed on the MWTM server.
The default path and filename for the patch log file is /opt/CSCOsgm/install/sgmPatch.log. If you installed MWTM in a directory other than /opt, then the patch log file is located in that directory.
You must be logged in as the root user or as a super user to use this command.
List of MWTM Commands
mwtm poll
Server Only
Full Syntax
mwtm poll [node] [node]...
Command Description
Enables you to poll one or more known nodes from the command line. Use the node arguments to specify the DNS names or IP addresses of one or more known nodes.
You must be logged in as the root user or as a super user to use this command.
List of MWTM Commands
mwtm pollertimeout
Server Only
Full Syntax
mwtm pollertimeout [number-of-seconds]
Command Description
Specifies how long, in seconds, MWTM clients that are connected to the MWTM server can run a demand poller, as in a real-time data window or Web page, before MWTM automatically stops the poller to prevent unnecessary traffic on the network. When the demand poller times out, MWTM stops the poller and sends an appropriate error message to the client.
The valid range is 1 second to an unlimited number of seconds. The default timeout is 8 hours (28800 seconds).
After you change the timeout, MWTM asks if you want to restart the MWTM server. The new poller timeout takes effect when you restart the MWTM server.
See the "Server Status Information: Pollers" section on page 3-26 for more information on demand pollers.
You must be logged in as the root user or as a super user to use this command.
List of MWTM Commands
mwtm print
Server Only
Full Syntax
mwtm print {all | data | snmp | task}
Command Description
Displays information about server internal data, SNMP settings, running tasks, or all three.
You must be logged in as the root user or as a super user to use this command.
List of MWTM Commands
mwtm props
Server and Solaris/Linux Clients Only
Command Description
Displays the contents of the System.properties files for both MWTM server and client installs.
You must be logged in as the root user or as a super user to use this command.
List of MWTM Commands
mwtm readme
Server and Solaris/Linux Clients Only
Command Description
Displays the contents of the README file for MWTM.
List of MWTM Commands
mwtm reboot
Server Only
Command Description
Reboots the Solaris or Linux MWTM system.
Note
You must be logged in as the root user (not as a super user) to use this command.
List of MWTM Commands
mwtm repdir
Server Only
Full Syntax
mwtm repdir [directory]
Command Description
Sets the directory in which MWTM stores report files. See the "Working with MWTM Statistics Reports" section on page 9-1 for information about MWTM reports.
The default directory for report files is located in the MWTM installation directory:
•
•
Use this command if you want to use a different directory for report files, such as a Network File System location on another server.
Note
Do not set the new directory to any of the following: /usr, /var, /opt, or /tmp.
Do not set the new directory to the same directory in which you are storing message log files (mwtm msglogdir) or route table files (mwtm routedir).After you change the directory, MWTM asks if you want to restart the MWTM server. The new directory takes effect when you restart the MWTM server.
You must be logged in as the root user or as a super user to use this command.
List of MWTM Commands
mwtm rephelp
Server Only
Command Description
Displays help for all commands related to MWTM reports.
You must be logged in as the root user or as a super user to use this command.
List of MWTM Commands
mwtm replog
Server Only
Full Syntax
mwtm replog [clear | -r]
Command Description
Uses PAGER to display the contents of the system reports log. The reports log lists all messages related to the creation and maintenance of MWTM reports.
To clear the log and restart the server, enter mwtm replog clear.
To display the contents of the log in reverse order, with the most recent commands at the beginning of the log, enter mwtm replog -r.
The default path and filename for the system reports log file is /opt/CSCOsgm/logs/sgmReportLog.txt. If you installed MWTM in a directory other than /opt, then the system reports log file is located in that directory.
You must be logged in as the root user or as a super user to use this command.
List of MWTM Commands
mwtm restart
Server Only
Full Syntax
mwtm restart [jsp | pm | web]
Command Description
Restarts MWTM servers on the local host:
•
•
•
•
You must be logged in as the root user or as a super user to use this command.
List of MWTM Commands
mwtm restore
Server Only
Full Syntax
mwtm restore [ logs | reports | security]
Command Description
Restores the MWTM data files from the previous night's backup, stored in the MWTM installation directory:
•
•
To restore only specific parts of the MWTM data files, use the following keywords:
•
•
•
To change the directory in which MWTM stores these backup files, use the mwtm backupdir command.
You must be logged in as the root user (not as a super user) to use this command.
List of MWTM Commands
mwtm restoreprops
Server and Solaris/Linux Clients Only
Command Description
Restores the MWTM server and client System.properties files, and other important configuration files, to "clean" backup versions of the files.
You must be logged in as the root user (not as a super user) to use this command.
List of MWTM Commands
mwtm rootvars
Server and Solaris/Linux Clients Only
Command Description
Displays the contents of the /etc/CSCOsgm.sh file, which determines the root location of the MWTM server and client installation.
List of MWTM Commands
mwtm sechelp
Server Only
Command Description
Displays help for all commands related to MWTM security.
You must be logged in as the root user or as a super user to use this command.
List of MWTM Commands
mwtm seclog
Server Only
Full Syntax
mwtm seclog [clear | -r]
Command Description
Uses PAGER to display the contents of the system security log.
The following security events are recorded in the log:
•
•
•
•
•
•
•
•
To clear the log and restart the server, enter mwtm seclog clear.
To display the contents of the log in reverse order, with the most recent security events at the beginning of the log, enter mwtm seclog -r.
The default path and filename for the system security log file is /opt/CSCOsgm/logs/sgmSecurityLog.txt. If you installed MWTM in a directory other than /opt, then the system security log file is located in that directory.
See the "Displaying the Contents of the System Security Log (Server Only)" section on page 10-18 for more information on the use of this command.
You must be logged in as the root user or as a super user to use this command.
List of MWTM Commands
mwtm secondaryserver
Server Only
Full Syntax
mwtm secondaryserver [hostname [naming-port] | list]
Command Description
Configures a secondary MWTM server, where:
•
•
For best results, Cisco recommends that you configure the primary server and the secondary server as secondaries for each other.
If you use the mwtm secondaryserver command to configure a secondary MWTM server, but the primary MWTM server fails before you launch the MWTM client, then the MWTM client has no knowledge of the secondary server.
To list the secondary MWTM server that has been configured for this primary MWTM server, enter the mwtm secondaryserver list command.
You must be logged in as the root user or as a super user to use this command.
List of MWTM Commands
mwtm servername
Server and Solaris/Linux Clients Only
Full Syntax
mwtm servername [hostname]
Command Description
Resets the MWTM server' default host name, where hostname is the new default host name:
•
•
•
•
Note
List of MWTM Commands
mwtm setpath
Server and Solaris/Linux Clients Only
Full Syntax
mwtm setpath [username]
Command Description
Appends binary (bin) directories to the path for a user. This enables users to append the proper MWTM binary directories to their paths without manually editing the .profile and .cshrc files.
This command appends lines such as these to the user's .profile file:
PATH=$PATH:/opt/CSCOsgm/bin:/opt/CSCOsgmClient/bin # CiscoSGM
and appends lines such as these to the user's .cshrc file:
set path=($path /opt/CSCOsgm/bin /opt/CSCOsgmClient/bin) # CiscoSGM
Thereafter, you can enter MWTM commands like this:
mwtm help
instead of like this:
/opt/CSCOsgm/bin/mwtm help
When entering this command, keep the following considerations in mind:
•
•
–
–
–
•
•
List of MWTM Commands
mwtm snmpcomm
Server Only
Full Syntax
mwtm snmpcomm [name]
Command Description
Enables you to set a new default SNMP read community name. MWTM automatically updates the name in the SNMP parameters file. The default path and filename for the SNMP parameters file is /opt/CSCOsgm/etc/communities.conf.
You must be logged in as the root user or as a super user to use this command.
List of MWTM Commands
mwtm snmpconf
Server Only
Full Syntax
mwtm snmpconf [filename]
Command Description
Sets the file used for SNMP parameters, such as community names, timeouts, and retries.
The default path and filename for the SNMP parameters file is /opt/CSCOsgm/etc/communities.conf. If you installed MWTM in a directory other than /opt, then the file is located in that directory.
When you specify a new path or filename, MWTM restarts the servers.
Note
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.You must be logged in as the root user or as a super user to use this command.
List of MWTM Commands
mwtm snmpget
Server Only
Full Syntax
mwtm snmpget [-JJVM_ARG1 [-JJVM_ARG2]...] [-v snmp_version] [-c community_string] [-r retry] [-t timeout] [-d output_delimiter] [--header|--no-header] [--raw-octets|--no-raw-octets] [--str-octets|--no-str-octets] [--raw-timeticks|--no-raw-timeticks] [--resolve-integer|--no-resolve-integer] [--resolve-bits|--no-resolve-bits] [--get-sysuptime|--no-get-sysuptime] [--detect-mib-error] [--instance oids] [--int-instance integer] [--str-instance string] [hostname] [oid] [oid]...
Command Description
Queries the specified hostname using SNMP GetRequests. Use the following optional keywords and arguments with this command:
•
For example, by default JVM uses a maximum of 64 MB of memory. However, if you are walking a large table, JVM might require more memory. To enable JVM to use a maximum of 256 MB of memory, use the following option:
-J-Xmx256m
•
•
•
•
•
•
–
–
•
–
–
The other option for displaying octets is --str-octets|--no-str-octets.
•
–
–
The other option for displaying octets is --raw-octets|--no-raw-octets.
•
–
–
•
–
–
•
–
–
•
–
–
•
Sometimes multiple MIB variables are returned at the same time, some of which are in error, and some of which are not.
–
–
•
mwtm snmpget --instance 172.18.16.10 router_1 ipAdEntIfIndex ipAdEntNetMask
mwtm snmpget router_1 ipAdEntIfIndex.172.18.16.10 ipAdEntNetMask.172.18.16.10
•
•
mwtm snmpget --str-instance link_1 router_1 cItpSpLinksetState
mwtm snmpget router_1 cItpSpLinksetState.6.108.115.110.97.109.101
•
•
The default path for the SNMP parameters file, communities.conf, is /opt/CSCOsgm/etc/communities.conf. If you installed MWTM in a directory other than /opt, then the file is located in that directory. You can edit the file manually or using the MWTM client. See the "Configuring SNMP Settings" section on page 2-3 for more information.
You must be logged in as the root user or as a super user to use this command.
List of MWTM Commands
mwtm snmphelp
Server Only
Command Description
Displays help for all commands related to SNMP queries.
You must be logged in as the root user or as a super user to use this command.
List of MWTM Commands
mwtm snmpnext
Server Only
Full Syntax
mwtm snmpnext [-JJVM_ARG1 [-JJVM_ARG2]...] [-v snmp_version] [-c community_string] [-r retry] [-t timeout] [-d output_delimiter] [--header|--no-header] [--raw-octets|--no-raw-octets] [--str-octets|--no-str-octets] [--raw-timeticks|--no-raw-timeticks] [--resolve-integer|--no-resolve-integer] [--resolve-bits|--no-resolve-bits] [--get-sysuptime|--no-get-sysuptime] [--detect-mib-error] [--instance oids] [--int-instance integer] [--str-instance string] [hostname] [oid] [oid]...
Command Description
Queries the specified hostname using SNMP GetNextRequests. Use the following optional keywords and arguments with this command:
•
For example, by default JVM uses a maximum of 64 MB of memory. However, if you are walking a large table, JVM might require more memory. To enable JVM to use a maximum of 256 MB of memory, use the following option:
-J-Xmx256m
•
•
•
•
•
•
–
–
•
–
–
The other option for displaying octets is --str-octets|--no-str-octets.
•
–
–
The other option for displaying octets is --raw-octets|--no-raw-octets.
•
–
–
•
–
–
•
–
–
•
–
–
•
Sometimes multiple MIB variables are returned at the same time, some of which are in error, and some of which are not.
–
–
•
mwtm snmpget --instance 172.18.16.10 router_1 ipAdEntIfIndex ipAdEntNetMask
mwtm snmpget router_1 ipAdEntIfIndex.172.18.16.10 ipAdEntNetMask.172.18.16.10
•
•
mwtm snmpget --str-instance link_1 router_1 cItpSpLinksetState
mwtm snmpget router_1 cItpSpLinksetState.6.108.115.110.97.109.101
•
•
The default path for the SNMP parameters file, communities.conf, is /opt/CSCOsgm/etc/communities.conf. If you installed MWTM in a directory other than /opt, then the file is located in that directory. You can edit the file manually or using the MWTM client. See the "Configuring SNMP Settings" section on page 2-3 for more information.
You must be logged in as the root user or as a super user to use this command.
List of MWTM Commands
mwtm snmpwalk
Server Only
Full Syntax
mwtm snmpwalk [-JJVM_ARG1 [-JJVM_ARG2]...] [-v snmp_version] [-c community_string] [-r retry] [-t timeout] [-x maximum_rows] [-d output_delimiter] [--tabular|--no-tabular] [--getbulk|--no-getbulk] [--header|--no-header] [--raw-octets|--no-raw-octets] [--str-octets|--no-str-octets] [--raw-timeticks|--no-raw-timeticks] [--resolve-integer|--no-resolve-integer] [--resolve-bits|--no-resolve-bits] [--get-sysuptime|--no-get-sysuptime] [--detect-mib-error] [--instance oids] [--int-instance integer] [--str-instance string] [hostname] [oid] [oid]...
Command Description
Queries the specified hostname, using SNMP GetNextRequests to "walk" through the MIB. Use the following optional keywords and arguments with this command:
•
For example, by default JVM uses a maximum of 64 MB of memory. However, if you are walking a large table, JVM might require more memory. To enable JVM to use a maximum of 256 MB of memory, use the following option:
-J-Xmx256m
•
•
•
•
•
However, for every 10,000 rows walked, JVM requires an additional 10 MB of memory. You can use the -J keyword and argument to increase the memory available to JVM.
•
•
–
–
•
–
–
•
–
–
•
–
–
The other option for displaying octets is --str-octets|--no-str-octets.
•
–
–
The other option for displaying octets is --raw-octets|--no-raw-octets.
•
–
–
•
–
–
•
–
–
•
–
–
•
Sometimes multiple MIB variables are returned at the same time, some of which are in error, and some of which are not.
–
–
•
mwtm snmpget --instance 172.18.16.10 router_1 ipAdEntIfIndex ipAdEntNetMask
mwtm snmpget router_1 ipAdEntIfIndex.172.18.16.10 ipAdEntNetMask.172.18.16.10
•
•
mwtm snmpget --str-instance link_1 router_1 cItpSpLinksetState
mwtm snmpget router_1 cItpSpLinksetState.6.108.115.110.97.109.101
•
•
The default path for the SNMP parameters file, communities.conf, is /opt/CSCOsgm/etc/communities.conf. If you installed MWTM in a directory other than /opt, then the file is located in that directory. You can edit the file manually or using the MWTM client. See the "Configuring SNMP Settings" section on page 2-3 for more information.
You must be logged in as the root user or as a super user to use this command.
List of MWTM Commands
mwtm sounddir
Server Only
Full Syntax
mwtm sounddir [directory]
Command Description
Sets the directory in which the MWTM server stores event automation sound files. See the "Changing the Way MWTM Processes Events" section on page 5-17 for information about sound files.
The default directory for sound files is located in the MWTM installation directory:
•
•
Use this command if you want to use a different directory for MWTM server event automation sound files, such as a Network File System location on another server.
Note
You must be logged in as the root user or as a super user to use this command.
List of MWTM Commands
mwtm ssl
Server Only
Full Syntax
mwtm ssl [enable | disable | status]
Command Description
If you have obtained the SSL-enabled version of MWTM and installed an SSL key/certificate pair in MWTM, you can use this command to manage SSL support in MWTM:
•
•
•
See the "Implementing SSL Support in MWTM (Solaris Only)" section on page 10-22 for more information on the use of this command.
You must be logged in as the root user (not as a super user) to use this command.
List of MWTM Commands
mwtm sslstatus
Server Only
Command Description
If SSL is implemented in your MWTM system, displays current status for SSL support in MWTM, including whether SSL support is enabled or disabled and which SSL keys and certificates exist.
See the "Implementing SSL Support in MWTM (Solaris Only)" section on page 10-22 for more information on the use of this command.
You must be logged in as the root user (not as a super user) to use this command.
List of MWTM Commands
mwtm start
Server Only
Command Description
Starts all MWTM servers on the local host.
You must be logged in as the root user or as a super user to use this command.
List of MWTM Commands
mwtm start client
Server and all Clients
Full Syntax
mwtm start client [hostname]
Command Description
Starts an MWTM client on the specified host. If no host name is specified, starts an MWTM client on the default host, as specified during installation. See the "Connecting to a New Server" section on page 3-33 for information about determining the default host.
If you Telnet into a remote workstation, the DISPLAY variable must be set to your local display, or you cannot use this command. If the DISPLAY variable is not set automatically, you must set it manually. See the "Setting the DISPLAY Variable (Client Only)" section on page 11-30 for details.
This command has the same function as the mwtm client command.
List of MWTM Commands
mwtm start jsp
Server Only
Command Description
Starts the MWTM JSP Server on the local host.
You must be logged in as the root user or as a super user to use this command.
List of MWTM Commands
mwtm start pm
Server Only
Command Description
Starts the MWTM Process Manager and all managed processes on the local host.
You must be logged in as the root user or as a super user to use this command.
List of MWTM Commands
mwtm start web
Server Only
Command Description
Starts the MWTM Web Server on the local host.
You must be logged in as the root user or as a super user to use this command.
List of MWTM Commands
mwtm statreps clean
Server Only
Command Description
Removes all data from MWTM network statistics reports, restoring the reports to a "clean" state.
You must be logged in as the root user or as a super user to use this command.
List of MWTM Commands
mwtm statreps cleancustom
Server Only
Full Syntax
mwtm statreps cleancustom [tag]
Command Description
Removes all data from one or more MWTM custom statistics reports, restoring the reports to a "clean" state:
•
•
You must be logged in as the root user or as a super user to use this command.
List of MWTM Commands
mwtm statreps custage
Server Only
Full Syntax
mwtm statreps custage [number-of-days]
Command Description
Maximum number of days MWTM is to archive custom reports.
If you enter this command without the number-of-days argument, MWTM displays the current maximum number of days. You can then change that value, or leave it as-is. The valid range is 1 day to an unlimited number of days. The default value is 10 days.
This command has the same function as the mwtm repcustage command.
You must be logged in as the root user or as a super user to use this command.
List of MWTM Commands
mwtm statreps dailyage
Server Only
Full Syntax
mwtm statreps dailyage [number-of-days]
Command Description
Maximum number of days MWTM is to archive daily network statistics reports.
If you enter this command without the number-of-days argument, MWTM displays the current maximum number of days. You can then change that value, or leave it as-is. The valid range is 1 day to an unlimited number of days. The default value is 90 days.
This command has the same function as the mwtm repdailyage command.
You must be logged in as the root user or as a super user to use this command.
List of MWTM Commands
mwtm statreps diskcheck
Server Only
Full Syntax
mwtm statreps [diskcheck | nodiskcheck]
Command Description
Specifies whether MWTM is to verify that a disk has at least 10 MB of space remaining before generating network statistics reports:
•
•
If your system does not return the necessary amount of free space, in a correct format that MWTM can parse, this command enables MWTM to disable checking to allow reporting to continue.
You must be logged in as the root user or as a super user to use this command.
List of MWTM Commands
mwtm statreps enable
Server Only
Full Syntax
mwtm statreps [disable | enable]
Command Description
Enables MWTM to generate network statistics reports:
•
•
You must enter this command to enable MWTM to generate network statistics reports.
You must be logged in as the root user or as a super user to use this command.
List of MWTM Commands
mwtm statreps export
Server Only
Full Syntax
mwtm statreps [export | noexport]
Command Description
Specifies whether MWTM is to generate network statistics reports in export format:
•
•
Network statistics reports in export format are Zip files that contain comma-separated value (CSV) text files that you can download and unzip.
You must be logged in as the root user or as a super user to use this command.
List of MWTM Commands
mwtm statreps hourlyage
Server Only
Full Syntax
mwtm statreps hourlyage [number-of-days]
Command Description
Maximum number of days MWTM is to archive hourly network statistics reports.
If you enter this command without the number-of-days argument, MWTM displays the current maximum number of days. You can then change that value, or leave it as-is. The valid range is 1 day to an unlimited number of days. The default value is 31 days.
This command has the same function as the mwtm rephourlyage command.
You must be logged in as the root user or as a super user to use this command.
List of MWTM Commands
mwtm statreps servratio
Server Only
Full Syntax
mwtm statreps servratio [factor]
Command Description
Displays a gray background in the InSrv cell in a network statistics report, if the following condition is met:
Current In-Service < factor * Long-Term In-Service
The default value for factor is 0.95.
You must be logged in as the root user or as a super user to use this command.
mwtm statreps status
Server Only
Command Description
Displays the current status of all MWTM network statistics report parameters. These are the parameters that are set using the other mwtm statreps commands, such as mwtm statreps [disable | enable] and mwtm statreps [diskcheck | nodiskcheck].
You must be logged in as the root user or as a super user to use this command.
List of MWTM Commands
mwtm statreps timemode
Server Only
Full Syntax
mwtm statreps timemode [12 | 24]
Command Description
Sets the time mode for dates in network statistics reports:
•
•
You must be logged in as the root user or as a super user to use this command.
List of MWTM Commands
mwtm statreps timer
Server Only
Command Description
Displays the timer file for MWTM network statistics reports. The timer file is useful for identifying how much time MWTM spends gathering report data and generating reports.
You must be logged in as the root user or as a super user to use this command.
List of MWTM Commands
mwtm statreps utilratio
Server Only
Full Syntax
mwtm statreps utilratio [factor]
Command Description
Displays a gray background in the Send Utilization or Receive Utilization cell in a network statistics report, if the following condition is met:
Current Utilization > factor * Long-Term Utilization
The default value for factor is 1.50.
You must be logged in as the root user or as a super user to use this command.
List of MWTM Commands
mwtm status
Server Only
Command Description
Displays the status of all MWTM servers on the local host.
List of MWTM Commands
mwtm stop
Server Only
Command Description
Stops all MWTM servers on the local host.
You must be logged in as the root user or as a super user to use this command.
List of MWTM Commands
mwtm stopclients
Server and Solaris/Linux Clients Only
Command Description
Forcefully stops all MWTM clients on the local host.
You must be logged in as the root user (not as a super user) to use this command.
List of MWTM Commands
mwtm stop jsp
Server Only
Command Description
Stops the MWTM JSP Server on the local host.
You must be logged in as the root user or as a super user to use this command.
List of MWTM Commands
mwtm stop pm
Server Only
Command Description
Stops the MWTM Process Manager and all managed processes on the local host.
You must be logged in as the root user or as a super user to use this command.
List of MWTM Commands
mwtm stop web
Server Only
Command Description
Stops the MWTM Web Server on the local host.
You must be logged in as the root user or as a super user to use this command.
List of MWTM Commands
mwtm superuser
Server Only
Full Syntax
mwtm superuser [username]
Command Description
Enables the specified user to perform most functions that otherwise require the user to be logged in as the root user. (The root user can still perform those functions, too.) The specified user account must exist in the local /etc/passwd file. You cannot specify a user that is defined in a distributed Network Information Services (NIS) system.
Note
For a complete list of the MWTM commands that a super user cannot use, as well as other super user considerations, see the "Specifying a Super User (Server Only)" section on page 10-19.
You must be logged in as the root user (not as a super user) to use this command.
List of MWTM Commands
mwtm syncusers
Server Only
Command Description
If MWTM User-Based Access is enabled and mwtm authtype is set to solaris, synchronizes local MWTM passwords with Solaris.
See the "Manually Synchronizing Local MWTM Passwords (Server Only)" section on page 10-17 for more information on the use of this command.
You must be logged in as the root user (not as a super user) to use this command.
List of MWTM Commands
mwtm tac
Server Only
Command Description
Collects important troubleshooting information for the Cisco Technical Assistance Center, and writes the information to the /opt/CSCOsgm/tmp/cisco_sgm_tshoot.log file.
You must be logged in as the root user or as a super user to use this command.
List of MWTM Commands
mwtm telnetpath
Server and all Clients
Command Description
Specifies the path to the Telnet application to use for Telnet sessions on the MWTM client, as well as any special parameters to pass to the Telnet application.
•
•
You must be logged in as the root user (not as a super user) to use this command.
List of MWTM Commands
mwtm tnproxy
Server Only
Full Syntax
mwtm tnproxy [disable | enable | status]
Command Description
Manages a Telnet proxy. A Telnet proxy resides on a server and forwards Telnet requests from clients to network elements that are accessible only from that server. A Telnet proxy is typically used to enable remote clients on desktop networks to Telnet to network elements that otherwise would be unreachable.
•
•
•
You must be logged in as the root user or as a super user to use this command.
List of MWTM Commands
mwtm trapaccess
Server Only
Full Syntax
mwtm trapaccess [add [ip-addr] | clear | edit | list | rem [ip-addr] | sample]
Command Description
Enables you to create and manage a list of network element IP addresses allowed to send traps to the MWTM server.
The list of allowed network element IP addresses is contained in the trapaccess.conf file. By default, when you first install MWTM, the trapaccess.conf file does not exist and MWTM allows all IP addresses to send traps to the MWTM server. To create the trapaccess.conf file and work with the list of allowed client IP addresses, specify one of the following keywords:
•
•
•
•
•
•
Any changes you make take effect when you restart the MWTM server.
See the "Limiting Traps by IP Address (Server Only)" section on page 11-29 for more information about using this command.
You must be logged in as the root user or as a super user to use this command.
List of MWTM Commands
mwtm trapsetup
Server Only
Full Syntax
mwtm trapsetup [disable]
Command Description
Stops the MWTM server, configures MWTM to receive SNMP traps (or prevents MWTM from receiving traps), then restarts the MWTM server. MWTM gives you the option to receive traps natively or using HP OpenView.
When you select an SNMP trap port number for the MWTM server, make sure your network elements use the same SNMP trap port number. See the description of the snmp-server host command in the "RAN-O Requirements" section of the Cisco Mobile Wireless Transport Manager Installation Guide for more information.
To prevent MWTM from receiving traps, enter the mwtm trapsetup disable command. MWTM restarts the MWTM server.
You must be logged in as the root user (not as a super user) to use this command.
List of MWTM Commands
mwtm trapstatus
Server Only
Command Description
Displays the current trap reception configuration for MWTM, including:
•
–
–
•
•
•
List of MWTM Commands
mwtm uninstall
Server and Solaris/Linux Clients Only
Command Description
Uninstalls MWTM.
You must be logged in as the root user (not as a super user) to use this command.
List of MWTM Commands
mwtm unknownage
Server Only
Full Syntax
mwtm unknownage [number-of-days]
Command Description
Sets the maximum number of days to retain Unknown objects before deleting them from the MWTM database.
If you enter this command without the number-of-days argument, MWTM displays the current maximum number of days. You can then change that value, or leave it as-is. The valid range is 1 day to an unlimited number of days. The default value is 7 days. Setting this value to 0 days means that after one hour, Unknown objects will be deleted.
You must be logged in as the root user or as a super user to use this command.
List of MWTM Commands
mwtm updateuser
Server Only
Full Syntax
mwtm updateuser [username]
Command Description
If MWTM User-Based Access is enabled, changes the authentication level for the specified user. Valid levels are:
•
•
•
•
•
If mwtm authtype is set to local, this command also enables you to change the following settings:
•
See the "Enabling and Changing Users and Passwords (Server Only)" section on page 10-13 for more information on authentication levels, and on the use of this command.
You must be logged in as the root user or as a super user to use this command.
Note
List of MWTM Commands
mwtm useraccess
Server Only
Full Syntax
mwtm useraccess [disable | enable]
Command Description
Enables or disables MWTM User-Based Access.
User-Based Access provides multi-level password-protected access to MWTM features. Each user can have a unique user name and password. Each user can also be assigned to one of five levels of access, which control the list of MWTM features accessible by that user.
You must enable MWTM User-Based Access in order to use the associated MWTM security commands.
See the "Implementing MWTM User-Based Access (Server Only)" section on page 10-2 for more information.
You must be logged in as the root user or as a super user to use this command.
List of MWTM Commands
mwtm userpass
Server Only
Full Syntax
mwtm userpass [username]
Command Description
If MWTM User-Based Access is enabled and mwtm authtype is set to local, changes the specified user's MWTM security authentication password.
If the user's authentication has been disabled, either automatically by MWTM or by a super user, this command re-enables the user's authentication with a new password.
If sgm authtype is set to solaris, you cannot use this command. Instead, you must manage passwords on the external authentication servers.
See the "Enabling and Changing Users and Passwords (Server Only)" section on page 10-13 for more information on the use of this command.
You must be logged in as the root user or as a super user to use this command.
List of MWTM Commands
mwtm version
Server and Solaris/Linux Clients Only
Command Description
Displays version information for MWTM servers and clients on the local host.
List of MWTM Commands
mwtm viewlog
Server Only
Command Description
Uses PAGER to display the contents of the system message log.
To save the current contents of the log, clear the log, and restart the server, enter mwtm viewlog clear.
To display the contents of the log in reverse order, with the most recent messages at the beginning of the log, enter mwtm msglog -r.
This command has the same function as the mwtm msglog command.
You must be logged in as the root user or as a super user to use this command.
List of MWTM Commands
mwtm wall
Server Only
Full Syntax
mwtm wall message_string
Command Description
Sends a message to all clients connected to the server. For example:
./mwtm wall Server going down at 9:00 pm tonight.
sends the following message:
Server going down at 9:00 pm tonight.
MWTM ignores quotation marks in message_string. To include quotation marks, use the escape character (\) in combination with quotation marks. For example:
./mwtm wall Example of the \"mwtm wall\" command.
sends the following message:
Example of the "mwtm wall" command.
You must be logged in as the root user or as a super user to use this command.
List of MWTM Commands
mwtm webaccesslog
Server Only
Full Syntax
mwtm webaccesslog [clear | -r]
Command Description
Uses PAGER to display the MWTM system Web access log file for the server to which you are connected, and which is currently running the MWTM server. The system Web access log lists all MWTM system Web access messages that have been logged for the MWTM server. This provides an audit trail of all access to the MWTM server via the Web interface.
To clear the log and restart the server, enter mwtm webaccesslog clear.
To display the contents of the log in reverse order, with the most recent Web access messages at the beginning of the log, enter mwtm webaccesslog -r.
You must be logged in as the root user or as a super user to use this command.
List of MWTM Commands
mwtm weberrorlog
Server Only
Full Syntax
mwtm weberrorlog [clear | -r]
Command Description
Uses PAGER to display the MWTM Web server error log file for the server to which you are connected, and which is currently running the MWTM server. The Web server error log lists all MWTM Web error messages that have been logged for the MWTM Web server.
To clear the log and restart the server, enter mwtm weberrorlog clear.
To display the contents of the log in reverse order, with the most recent Web error messages at the beginning of the log, enter mwtm weberrorlog -r.
You must be logged in as the root user or as a super user to use this command.
List of MWTM Commands
mwtm weblogupdate
Server Only
Full Syntax
mwtm weblogupdate [interval | disable]
Command Description
Controls how often, in seconds, MWTM updates certain Web output.
When you enter this command, MWTM displays the current interval. You can then change that value, or leave it as-is. The valid range is 1 second to an unlimited number of seconds. The default value is 300 seconds (5 minutes).
To disable the update interval, enter the mwtm weblogupdate disable command. This option lessens MWTM's CPU usage on both the server and client.
You must be logged in as the root user or as a super user to use this command.
List of MWTM Commands
mwtm webnames
Server Only
Full Syntax
mwtm webnames [display | real]
Command Description
Specifies whether MWTM is to show real node names or display names in Web pages:
•
•
You must be logged in as the root user or as a super user to use this command.
List of MWTM Commands
mwtm webport
Server Only
Full Syntax
mwtm webport [port-number]
Command Description
Sets a new port number for the Web server, where port-number is the new, numeric port number. MWTM verifies that the new port number is not already in use.
The new port number must contain only numbers. If you enter a port number that contains non-numeric characters, such as mwtm13, MWTM displays an error message and returns to the command prompt without changing the port number.
You must be logged in as the root user (not as a super user) to use this command.
List of MWTM Commands
mwtm webutil
Server Only
Full Syntax
mwtm webutil [percent | erlangs]
Command Description
Specifies whether MWTM is to display send and receive utilization for linksets and links as percentages or in Erlangs, in Web pages:
•
•
See the "Working with MWTM Statistics Reports" section on page 9-1 for more information on the use of this command.
You must be logged in as the root user or as a super user to use this command.
List of MWTM Commands
mwtm who
Server Only
Command Description
Displays a list of all client user names and processes connected to the server.
List of MWTM Commands
mwtm xtermpath
Server or Solaris/Linux Clients Only
Command Description
Specifies the path to the xterm application to use for xterm sessions on the MWTM client, as well as any special parameters to pass to the xterm application.
The default path is /usr/openwin/bin/xterm.
If one of the special parameters that you pass to the xterm application is a title, the title can contain dashes (-) and underscores (_), but it cannot contain any spaces.
You must be logged in as the root user (not as a super user) to use this command.
List of MWTM Commands
