Table Of Contents
Getting Started with IPM
Starting IPM
Running Simultaneous IPM Sessions
Configuring the IPM Components
Define a Source Router
Define a Target
Select a Predefined Operation
Define a Collector
Viewing IPM Results
Viewing Response Time Data in Real Time
Viewing Response Time Statistics
Printing IPM Data
Exiting the IPM Client
Getting Started with IPM
The chapter provides information on starting the IPM application and configuring a collector to gather response time data. It includes the following major sections:
•
Starting IPM
•Running Simultaneous IPM Sessions
•Configuring the IPM Components
•Viewing IPM Results
•Printing IPM Data
•Exiting the IPM Client
Starting IPM
Because the IPM application is comprised of a server component and a client component, you must start both components to run the application. If you have installed the IPM server and client on the same workstation, then you can start the IPM database server, IPM server, and IPM client using a single command. You can also start the IPM client server and client separately.
To start the IPM server, database server, and client, enter the following commands:
To start just the IPM server and database, enter the following commands:
To start just the IPM client on a Solaris workstation, enter the following commands:
If you installed the IPM client on a different Solaris workstation from the IPM server, you must issue the ipm start command from the /opt/CSCOipmClient/bin directory. To start the IPM client on a different Solaris workstation from the IPM server, enter the following commands:
# cd /opt/CSCOipmClient/bin
To start the IPM client on a Windows NT workstation, follow these steps:
Step 1 Make sure the IPM server that you are connecting to is running on a UNIX workstation.
Step 2 Open the Cisco Internetwork Performance Monitor 2.0 program folder.
Step 3 Double click on the IPM client.
Tips You can also start the IPM client by double clicking on the IPM client icon on your desktop.
When the IPM client starts, it displays the IPM Main window ().
Figure 2-1 IPM Main Window
When you start IPM for the first time, the IPM Main window contains no collectors. As you configure collectors, they are displayed in this window. Each collector is a combination of a configured source, a target, and an operation. For each collector, you specify parameters for gathering statistics, generating event notifications, and scheduling.
Running Simultaneous IPM Sessions
IPM software release 2.0 uses a client/server architecture that allows you to run multiple sessions of the IPM client simultaneously. This release provides central services and database functions on an IPM server that communicates to multiple IPM clients. You can install the IPM client software on the same workstation as the IPM server or on a workstation that is on the same network as the IPM server.
Configuring the IPM Components
To collect response-time data using IPM, you must define a collector in a source router. A collector is a definition of a source router, a target device, an operation, and a collector schedule.
To monitor response time data with IPM, you must complete the following tasks:
•Define a Source Router
•Define a Target
•Select a Predefined Operation
•Define a Collector
Define a Source Router
IPM source routers are the routers from which packets are sent to measure and store response-time data. Each source router must contain the Cisco IOS software RTR feature.
To define a new source router, follow these steps:
Step 1 Verify that the SNMP read community and write community strings are configured properly on the router and verify that the router is configured to send RTR-generated traps to your NMS host. For information on configuring SNMP on the source router, see the "Configuring Your Routers to Send RTR-Related Traps" section in "Preparing to Install" chapter of the Internetwork Performance Monitor User Guide.
Step 2 From the IPM Main window (), select Configure > Source Router. The Source Router window () is displayed.
Figure 2-2 Source Router Window
Step 3 From the Source Router window, select Edit > Add. The Add Source Router window () is displayed.
Figure 2-3 Add Source Router Window
Step 4 In the Source Router field, enter the IP address or host name of the router on which the source resides. This host name can be from 1 to 64 characters.
Step 5 In the Read Community field, enter the community name (or password) for read access to the information maintained by the SNMP agent. This value can be from 1 to 32 characters. The default value is public.
Step 6 In the Write Community field, enter the community name (or password) for write access to the information maintained by the SNMP agent. This value can be from 1 to 32 characters.
Step 7 Click OK to configure this source. IPM attempts to locate the router and determine whether or not it is SNMP enabled with the correct community string. If the router is successfully located, IPM adds it to the Source Router window. If IPM cannot reach the router, IPM displays an error message and redisplays the Add Source Router window.
Note If the hostname cannot be resolved by reverse address resolution, then IPM displays the IP address for the source router instead of a host name.
For information on using a seed file to add source routers to IPM, see the "Adding Source Routers Using a Seed File" section in the "" chapter. For information on modifying or deleting source routers, see the "Working with Source Routers" section in the "" chapter.
Define a Target
IPM targets are destination devices for which you want to gather response-time data. A target can be an SNA host or any IP-addressable device.
To define a device as a target, follow these steps:
Step 1 Select Configure > Target from the IPM Main window (). The Target window () is displayed.
Figure 2-4 Target Window
Step 2 From the Target window, select Edit > Add. The Add Target window () is displayed.
Figure 2-5 Add Target Window
Step 3 In the Target Type field, select the protocol type to be used with this target. The possible values are:
•IP—IP/ICMP Echo. Requires a destination IP address or host name.
•SNA LU0—SNA LU type 0 connection to Cisco's NSPECHO host application. Requires the host name defined for the SNA PU connection to VTAM.
•SNA LU2—SNA LU type 2 connection to Cisco's NSPECHO host application. Requires the host name defined for the SNA PU connection to VTAM.
•SNA SSCP—SNA SSCP-LU Native Echo. Requires the host name defined for the an SNA PU connection to VTAM.
Step 4 If the target type is IP, enter the IP address or host name of the target device in the IP Address or Host Name field. This is the name that appears in the Target field when you define a collector.
Step 5 For SNA Echo or SNA SSCP Echo, enter the SNA host name of the target device in the VTAM PU Name field. This is the name that appears in the Target field when you define a collector.
Step 6 For target type, SNA Echo, enter the eight-character SNA log mode name to be used to access the NSPECHO host application in the SNA Log Mode Name field. If you omit this value, default session parameters are used when communicating with the NSPECHO application running on the mainframe.
The SNA host uses this name to find the log mode table entry that defines session parameters. If you omit this name, the SNMP agent in the source router sends a name of all blanks to the SNA host, which then uses a set of default session parameters for the echo session.
Step 7 Click OK. IPM closes the Add Target window and the newly defined target is added to the list of defined targets in the Target window.
Note If you specify an IP address instead of a hostname and that IP address cannot be resolved by reverse address resolution, then IPM assumes that the IP address is valid and does not resolve to a host name.
For information on using a seed file to add targets to IPM, see the "Adding Targets Using a Seed File" section in the "" chapter. For information on modifying or deleting targets, see the "Working with Target Devices" section in the "" chapter.
Select a Predefined Operation
When you install IPM, a group of predefined operations are provided. Use one of these operations when you define a collector. You can also define one or more new operations to fit your needs. For information on defining a new operation, see the "Adding a New Operation" section in the "" chapter.
The predefined operations are described in .
Table 2-1 Predefined Operations
Operation
|
Description
|
default-ip-echo-monitored
|
Monitors end-to-end response time in an IP network without gathering statistics.
|
default-ip-echo-statistics
|
Gathers statistics for end-to-end response time in an IP network.
|
default-path-echo-monitored
|
Monitors hop-by-hop response time in an IP network without gathering statistics.
|
default-path-echo-statistics
|
Gathers statistics for hop-by-hop response time in an IP network.
|
default-sna-lu0-echo
|
Monitors end-to-end response time in an SNA network using LU0 without gathering statistics.
|
default-sna-sscp-echo
|
Monitors end-to-end response time in an SNA network using SSCP protocol without gathering statistics.
|
For information on defining, modifying, or deleting operations, see the "Working with Operations" section in the "" chapter.
Define a Collector
Defining a collector involves selecting a source router, a target, an operation, and a collector schedule.
Note After you configure a collector, you cannot change its attributes.
To define a new collector, follow these steps:
Step 1 From the IPM Main window (), select Edit > Add. The Add Collector window () is displayed.
Figure 2-6 Add Collector Window
Step 2 From the Source Routers list, select the router to designate as the source router for collecting data.
Step 3 From the Target Names list, select the device to designate as the target.
Step 4 From the Operation Names list, select the operation and type to use for this collector.
Step 5 To configure the schedule for the collector when you start it, enable the OnDemand option.
Step 6 To specify when the collector starts, choose one of the following options in the Start Time field:
•Now—Starts the collector immediately.
•Date & Time—Starts the collector at the date and time that you specify.
Step 7 To specify how long the collector runs, choose one of the following options in the Duration field:
•Forever—Starts the collector to run continuously until you stop it.
•Days/Hours/Mins—Stops the collector after the specified length of time has elapsed.
Step 8 Click OK. The collector that you defined is displayed in the list of collectors in the IPM Main window.
For information on using a seed file to add collectors to IPM, see the "Adding Collectors Using a Seed File" section in the "" chapter. For information on viewing or deleting collectors, see the "Working with Collectors" section in the "" chapter.
Viewing IPM Results
As your collectors begin to collect response time information and the information is stored in the IPM database, you are able to view the resulting statistical data. You view the response-time results from any of the collectors listed on the IPM Main window and see whether or not that collector is active or inactive.
IPM provides two methods for reviewing response-time data:
•Viewing Response Time Data in Real Time
•Viewing Response Time Statistics
Viewing Response Time Data in Real Time
The Real Time Display window allows you to view response time data for an active collector as the data is being collected. This data is only displayed in real time, it is not stored in the IPM database.
To view response-time data in real time, follow these steps:
Step 1 From the IPM Main window (), select the collector to be viewed.
Step 2 Select View > Display Real-time. The Real Time Display window () is displayed.
Figure 2-7 Real Time Display Window
Response-time data is displayed as soon as the frequency interval elapses. Data points will be added to the graph for each interval that the response time is measured for the selected collector.
Viewing Response Time Statistics
To view response time statistics, follow these steps:
Step 1 From the IPM Main window (), select the collector to be viewed.
Step 2 Select View > Display Stats. The Time Filter window () is displayed.
Figure 2-8 Time Filter Window
In this window, you select the starting and ending time for the statistics that you want to view. These times relate to when the statistics are gathered by the collector, not when you want to view them. When this window is displayed, it already contains the starting and ending times for the collector, so you can press Enter to view statistics for that time period.
Step 3 In the Start Time field, specify the starting time for the response-time statistics you want to view. This marks the earliest statistics you want to view. For example, although your collector gathered statistics from 10:00 to 23:00, you may be interested in only those gathered from 11:00 to 13:00. In this case, you would indicate 11:00 as the start time.
You can specify the Start Time in one of these ways:
•You can accept the default value by pressing Enter (go to Step 4).
•Whether the selected collector is active or inactive, you can enter an exact starting time in the format MM/DD/YY:hh:mm:ss. If you use this method, you must enter the date and time completely using the correct delimiters.
You can enter a starting time earlier than the time when the selected collector started gathering statistics, but the displayed statistics start when the collector starts. For example, if you enter a starting time of 10/24/96:12:00:00, but the collector started collecting data at 10/24/96:13:00:00, the displayed statistics will begin with data starting at 10/24/96:13:00:00.
Step 4 In the End Time field, enter the ending time (the latest statistics) for the response-time statistics you want to view. For example, although your collector collected statistics from 10:00 to 23:00, you may be interested in only those gathered from 11:00 to 13:00. In this case, you would indicate 13:00 as the end time.
You can specify the end time in one of the following ways:
•You can accept the default value by pressing Enter.
•You can enter an ending time that is later than the time when the selected collector stopped gathering statistics, but the displayed statistics stop when the collector stopped. For example, if you enter an ending time of 10/24/96:12:00:00, but the collector stopped collecting data at 10/24/96:11:00:00, the displayed statistics will include data only up to 10/24/96:11:00:00.
Step 5 In the Statistics Format field, specify the initial increment for the granularity to be used for displaying the response-time statistics graphs. Choose one of the available options: Hourly, Daily, Weekly, or Monthly.
Step 6 Click OK. The Response Graphs window () is displayed.
Step 7 Select one of the path icons to see all the hops for that path, and then select one of the hops. The response-time statistics for that hop are displayed in the Response Graphs window.
Figure 2-9 Response Graphs Window
Printing IPM Data
You can print the data for each of the graphs in the Response Graphs window.
To print the data of an a IPM graph, follow these steps:
Step 1 From the Response Graphs window (), select File > Print.The Print Dialog window () is displayed.
Figure 2-10 Print Dialog Window
Step 2 Enter data in the following fields:
•Copies—Specify the number of copies that you want to print.
•Print to—Specify whether you want the data printed to a printer or saved to a file. If printing to a printer, specify the name of the printer. If saving to a file, specify the directory and filename.
•Paper Size—Specify whether you want the data printed on Letter, Legal, Executive, or A4 paper.
•Orientation—Specify whether you want the data printed in a Landscape or Portrait orientation on the page.
Step 3 Click Print.
Exiting the IPM Client
When you have finished configuring collectors or viewing response-time statistics, exit the IPM client by completing the following steps:
Step 1 From the IPM Main window (), select File > Exit. A confirmation window () is displayed.
Figure 2-11 Confirmation Window for Exiting IPM
Step 2 Click Yes to close the IPM client application. Active collectors will continue to run and gather response time data.
Note When you exit the IPM client, all IPM servers continue to run and gather response time data. To shut down the servers, use the ipm stop command. To stop gathering data, stop the collectors before exiting the IPM client. The collectors remain on the routers until you uninstall the IPM software.
Feedback
