C H A P T E R 4 Getting Started This chapter provides information about starting and stopping the Cisco Mobile Wireless Transport Manager (MWTM), and an overview of how to use the MWTM to manage your Cisco IP Transfer Point (ITP) or Radio Access Network-Optimization (RAN-O) installation.
Chapter 4 Getting Started Starting the MWTM Client Tip For a definition of MWTM nodes, see What is ITP?, page 1-6 and What is RAN-O?, page 1-7. Because the MWTM application comprises a server component and a client component, you must start both components to run the application. To start the MWTM server on a Solaris or Linux system: Step 1 You must be logged in as the root user or as a superuser, or your login must have administrator privileges.
Chapter 4 Getting Started Starting the MWTM Client Before Starting the MWTM Client When you start an MWTM client, the version and release of the client must match that of the MWTM server. If there is a client-server mismatch, the MWTM displays a warning message when you try to start the client. If you have a web browser installed, the MWTM optionally opens a web page from which you can download an allowed, matching client.
Chapter 4 Getting Started Discovering Your Network Access the Node You use the MWTM to link to the node by using the connection protocol (Telnet or SSH) that you set in the Node SNMP and Credentials dialog box (see Credentials Fields, page 3-21). To access the node, right-click a node in a window, then choose Node > Connect to from the right-click menu.
Chapter 4 Getting Started Discovering Your Network Step 5 Select the Seed Settings tab, if it is not already selected. You use the Seed Settings tab to create, save, load, and delete MWTM seed files. Load one or more seed nodes, or an existing seed file, by using the procedures in Loading Seed Nodes and Seed Files, page 4-7. Step 6 Select the Discovery tab, or click Next. You use the Discovery tab to discover the objects in your network. See Running Discovery, page 4-13 for more information.
Chapter 4 Getting Started Discovering Your Network Launching the Discovery Dialog To launch the Discovery dialog box and begin the Discovery process, choose Network > Network Discovery from the MWTM main menu. The MWTM displays the Discovery dialog box. Figure 4-1 Discovery Dialog with Seed Settings Displayed You use the Discovery dialog box to load and configure seed nodes, and use those seed nodes to discover the objects in your network.
Chapter 4 Getting Started Discovering Your Network Menu Command Description File > Close (Ctrl-W) Closes the current window. Edit > Node SNMP and Credentials Editor (Alt-D) Opens the Node SNMP and Credentials Editor dialog box. Help > Topics (F1) Displays the table of contents for the MWTM online help. Help > Window (Shift-F1) Displays online help for the current window. Help > About (F3) Displays build date, version, SSL support, and copyright information about the MWTM application.
Chapter 4 Getting Started Discovering Your Network Loading a Seed Node To load a seed node, enter the name or IP address of the seed node in the IP Address, Address range, Subnet, CIDR, or DNS Hostname field, and click Add Node (or press Enter). Note Follow the guidelines for IP addresses in SNMP Configuration Table, page 3-16. The MWTM displays details of the SNMP settings for the seed nodes in the Seed Details pane.
Chapter 4 Getting Started Discovering Your Network Field or Button Description Make this my preferred start option Specifies whether the selected seed file should be loaded automatically whenever this MWTM client is started or the Discovery dialog box is opened. By default, this check box is unchecked for all seed files. That is, no seed file is loaded automatically when the MWTM client is started or the Discovery dialog box is opened.
Chapter 4 Getting Started Discovering Your Network Note If another user modifies and saves the seed file before you save your changes, the MWTM asks if you want to overwrite that user’s changes. If you choose to do so, the other user’s changes are overwritten and lost. If you choose not to do so, your changes are lost, unless you save the seed file to a different filename.
Chapter 4 Getting Started Discovering Your Network Field or Button Description Number of Files (displayed in bottom left corner) Total number of seed files and folders. OK Saves the seed file and any changes you made to the seed file list and closes the dialog box. To save the seed file with a new name, you can either save the file with: • A completely new name. Enter the new name and click OK. • An existing name, overwriting an old seed file. Select the name in the list and click OK.
Chapter 4 Getting Started Discovering Your Network Field or Button Description Read Community SNMP community name for read access to the information maintained by the SNMP agent on the node. This value can be up to 32 characters in length. Do not include special characters such as the opening single quote ('), at symbol (@), dollar sign ($), caret (^), closing single quote ('), double quote ("), ampersand (&), or pipe (|). This value is usually set to public (the default).
Chapter 4 Getting Started Discovering Your Network Creating and Changing Seed Files Using a Text Editor A seed file is simply an unformatted list of seed node names. To create a seed file by using a text editor, simply create a file and list the seed node names, one on each line, with no other formatting: new-york-a new-york-b chicago-c When you save and name the seed file, remember: • You can use any letters, numbers, or characters in the name that your operating system allows, except blanks.
Chapter 4 Getting Started Discovering Your Network Figure 4-4 Discovery Tab Before Discovery The Discovery tab comprises: • Discovery Settings, page 4-15 • Discovered Nodes, page 4-17 Related Topics: • Discovery Overview, page 4-4 • Polling a Node, page 8-70 User Guide for the Cisco Mobile Wireless Transport Manager 6.
Chapter 4 Getting Started Discovering Your Network Discovery Settings The Discovery Settings pane of the Discovery tab contains: Field or Button Description Entire Network Check box used to specify the extent of the network discovery: • To discover the entire network, check this check box. This is called recursive discovery, and it is the default setting.
Chapter 4 Getting Started Discovering Your Network Field or Button Description Discover Network Begins discovering the network. Click Discover Network to begin Discovery. If you have not defined at least one seed node in the Seed Settings tab, the MWTM prompts you to do so. When Discovery begins: • The Discover Network button changes to Stop Discovery. • The Discovery In Progress message appears in the title bar of all MWTM client windows. Discovery progresses in bursts.
Chapter 4 Getting Started Discovering Your Network To recover from this situation and generate a new, complete, and reliable MWTM database, you must perform one of these procedures: • Run Discovery again, with Entire Network and Delete Existing Data checked. • Change the Unmanaged nodes to managed status. See Unmanaging and Managing Nodes or ITP Signaling Points, page 6-38 for more information. • Poll the nodes that were Unmanaged in the first Discovery.
Chapter 4 Getting Started Discovering Your Network You can resize each column, or sort the table based on the information in one of the columns. By default, the MWTM displays all of the columns in the Discovered Nodes section except Internal ID, Uptime, Reboot Reason, Process Traps, and Last Status Change. • To display hidden columns, right-click in the table heading and select the check boxes for the columns that you want to display.
Chapter 4 Getting Started Discovering Your Network Column or Button Description Node Type Type of node. Node types can be specific to ITP, RAN-O, or generic to both.
Chapter 4 Getting Started Discovering Your Network Column or Button Description Trap Polling (RAN-O only) Indicates whether trap polling is enabled. This field is read-only. If you want to: Report Polling • Enable trap polling for the RAN-O node, set ipran-mib snmp-access to outOfBand on the node. • Disable trap polling for the RAN-O node, set ipran-mib snmp-access to inBand on the node. Indicates whether report polling is enabled on the web interface.
Chapter 4 Getting Started Discovering Your Network Column or Button Description Status Reason Reason for the current status of the signaling gateway-mated pair. For a full list of possible reasons, see the stateReasons.html file. If you installed the MWTM in: • The default directory, /opt, then the file is located at /opt/CSCOsgm/apache/share/htdocs/eventHelp directory. • A different directory, then the help directory and file reside in that directory.
Chapter 4 Getting Started Displaying the MWTM Main Window • (ITP only) The missing nodes are connected to the seed nodes by SCTP connections, not just serial connections. If they are not connected by SCTP connections, you must add the missing nodes to the seed file as seed nodes. See Changing an Existing Seed File, page 4-12 for more information. • You selected Entire Network when you ran Discovery. If you suspect that you did not, run Discovery again with Entire Network selected.
Chapter 4 Getting Started Displaying the MWTM Main Window Figure 4-6 Discovery Dialog Figure 4-7 MWTM Main Window The MWTM main window is the primary window of the MWTM client interface. It is the first window to appear when you launch the MWTM client. It displays basic information about the events and objects that the MWTM discovers.
Chapter 4 Getting Started Displaying the MWTM Main Window Navigational Features To help you keep track of which view you are currently using, as well as other important information, most MWTM windows display the name of the system on which the MWTM server is running in the title bar. This information appears across the bottom of the window: • A “locked padlock” symbol if the MWTM server has a security certificate. To see the certificate, click the symbol.
Chapter 4 Getting Started Displaying the MWTM Main Window MWTM Client Navigation Tree The MWTM Client navigation tree displays objects in a variety of formats and views. The DEFAULT view, and other views that you can create, display a hierarchy of the objects that the MWTM manages.
Chapter 4 Getting Started Displaying the MWTM Main Window Note For additional features that appear only in the navigation tree of the web interface, see MWTM Web Interface Navigation Tree, page 11-3. MWTM Client Content Area The content area in the right pane displays detailed information about your network, such as configuration and historical data. To view detailed information for an object, click the object in the navigation tree.
Chapter 4 Getting Started Displaying the MWTM Main Window Figure 4-8 Summary Statistics Window The Summary Statistics window provides basic summary information about all discovered network objects that the MWTM discovered. For detailed information on objects within Summary Lists, see Displaying Object Windows, page 6-2. You can resize each column, or sort the table based on the information in one of the columns.
Chapter 4 Getting Started Displaying the MWTM Main Window Column Description Status Current status of the network objects. Possible values are: Unknown (red) Unavailable (red) Inactive (red) Failed (red) Down (red) Blocked (red) Pending (red) Warning (yellow) Shutdown (blue) InhibitLoc (blue) InhibitRem (blue) Discovering (cyan) Polling (cyan) Waiting (gray) Unmanaged (gray) Active (green) For detailed definitions of each status for each type of network object, see Appendix E, “Status Definitions.
Chapter 4 Getting Started Displaying the MWTM Main Window Column Description Signaling Gateway Mated Pairs (ITP only) Total number of discovered signaling gateway-mated pairs with the indicated status. Interfaces Total number of discovered interfaces with the indicated status. RAN Backhauls Total number of discovered RAN backhauls with the indicated status. RAN Shorthauls Total number of discovered RAN shorthauls with the indicated status.
Chapter 4 Getting Started Displaying the MWTM Main Window Displaying Alarms Note For details about viewing alarms using the MWTM web interface, see Displaying Alarms, page 11-27. You use the MWTM to view a summary of all currently active alarms in your network, including the current status of the associated network object. An active alarm is a network object with this status: • A node or interface that is Warning (yellow) or worse and is not Ignored.
Chapter 4 Getting Started Displaying the MWTM Main Window The active alarms table contains: Column Description Type Type of network object associated with the selected alarm. To see all higher-level alarms associated with the network object, select the turner beside the object. The MWTM displays the higher-level alarms below the selected alarm. For example, if you select the turner beside a link, the MWTM displays the alarms for the linkset, signaling point, and node associated with that link.
Chapter 4 Getting Started Displaying the MWTM Main Window Column Description Status Reason Reason for the current status of the network object associated with the selected alarm. For a full list of possible reasons, see the stateReasons.html file. If you installed the MWTM in: • The default directory, /opt, then the file is located at /opt/CSCOsgm/apache/share/htdocs/eventHelp directory. • A different directory, then the help directory and file are located in that directory.
Chapter 4 Getting Started Using the MWTM Main Menu Using the MWTM Main Menu The MWTM main menu appears in the menu bar of most MWTM windows. Some menu items do not appear on some windows. In addition, menu items that are dimmed are not available on that window. For detailed information about the menu options provided by other windows, see the descriptions of those windows.
Chapter 4 Getting Started Using the MWTM Main Menu Menu Command Description File > Print (Ctrl-P) Opens the Print window where you can: • Specify options for printing • Print the current window • Save the current window to a file The MWTM printing options require that you define a printer on your system. If you choose File > Print and the Print window does not appear, ensure you have defined a printer on your system.
Chapter 4 Getting Started Using the MWTM Main Menu Menu Command Description Edit > Delete (Delete) Deletes the currently selected element or elements from the MWTM database. The MWTM displays the Confirm Deletion dialog box. To: • Delete the selected elements, click Yes. The items are deleted from the MWTM database and the Confirm Deletion dialog box is closed. • Retain the selected elements, click No. The items are kept in the MWTM database and the Confirm Deletion dialog box closes.
Chapter 4 Getting Started Using the MWTM Main Menu Menu Command Description Network > Poll Nodes > Clean Poll (Alt-C) Polls all selected nodes and removes any Unknown objects after the completion of the poll. If you have implemented MWTM User-Based Access, this option is available to users with authentication level Network Operator (level 3) and higher.
Chapter 4 Getting Started Using the MWTM Main Menu Menu Command Description View > Cisco.com Displays the Cisco.com Home Page in a web browser. Go > Back (Alt-Left Arrow) 1 Navigates back to the last window viewed in this session. Go > Forward (Alt-Right Arrow) 1 Navigates forward to the last window viewed in this session. Go > Back > List of Windows Navigates back to a window viewed in this session. The MWTM maintains a list of up to 10 Back windows.
Chapter 4 Getting Started Using the MWTM Main Menu Menu Command Description Tools > Event Editor (Alt-B) Launches the Event Editor, which you use to: • Customize the visible category, severity, color, and message associated with events • Configure sounds for the MWTM to play for different types of events • Load, save, and deploy customized event configurations.
Chapter 4 Getting Started Accessing the MWTM through a Web Browser Menu Command Description Tools > CiscoWorks > CiscoView (Ctrl-3) Links to CiscoView, which provides a real-time, color-coded, graphical representation of Cisco objects. You can use CiscoView to quickly identify an incorrect status on a port or interface. This option is dimmed if the selected node is not an ITP or RAN-O node, or in Unmanaged status or has a Device Type of Unknown.
Chapter 4 Getting Started Accessing the MWTM through a Web Browser GUI Features Historical Data Web Interface Client Interface X Notes You enter a start and stop time for the data you are interested in, and the MWTM retrieves the data from its database. You can access the web interface display from the right-click menus in the client interface. Real-time Data X The MWTM periodically polls the node for real-time data, and updates the charts and graphs as new data is received.
Chapter 4 Getting Started Loading and Saving MWTM Files Figure 4-10 MWTM Web Interface For detailed information about the MWTM web interface, see Chapter 11, “Accessing Data from the Web Interface.” Loading and Saving MWTM Files You use the MWTM to quickly and easily load and save MWTM files. The files are on the MWTM server and you can load them on any connected MWTM client.
Chapter 4 Getting Started Loading and Saving MWTM Files Note Launched From Choose Window Launched Notes Preferences window File > Load System Default Prefs None See Displaying the Preferences Menu, page 5-3. Route Table dialog box File > Load Load File Dialog: Route See Loading an Existing Table File List Route Table File, page 13-12. View Editor window File > Load Load File Dialog: View See Loading a List Client-Specific View, page 7-15.
Chapter 4 Getting Started Using the Windows Start Menu Using the Windows Start Menu This section includes: • Changing the Default MWTM Server Name, page 4-43 • Launching the MWTM Client, page 4-43 • Launching the MWTM DOS Prompt, page 4-44 • Launching the MWTM Event Editor, page 4-44 • Launching the MWTM SSL Certificate Tool, page 4-44 • Displaying the MWTM README File, page 4-44 • Uninstalling the MWTM, page 4-44 Changing the Default MWTM Server Name If the IP address or hostname to which y
Chapter 4 Getting Started Exiting the MWTM Client Launching the MWTM DOS Prompt To launch a DOS prompt for the MWTM from the Windows Start menu, choose Start > Programs > Cisco MWTM Client > MWTM DOS Prompt. The MWTM opens a DOS window, starting in the \bin directory: • If you installed the MWTM client in the default directory, C:\Program Files, then the DOS prompt starts at C:\Program Files\MWTMClient\bin.
