Installing the TrafficDirector Application on Solaris Systems

Product Overview

Installation Notes

Preparing to Install the TrafficDirector Application

Web Browser Requirements

Minimum Server Requirements

Installing the TrafficDirector Application

Configuring a Web Browser

Starting and Using the TrafficDirector Application

Shutting Down the TrafficDirector Application

Additional Installation Tasks

Removing the TrafficDirector Application

Installing the TrafficDirector Application on Solaris Systems

This chapter describes preparing to install and installing the TrafficDirector application on a Solaris system. It consists of:

Product Overview

The TrafficDirector application allows you to monitor traffic and diagnose developing problems on network segments. If your network contains segments that use SwitchProbe devices, Network Analysis Modules, and switches, the TrafficDirector application will help you monitor these segments.

The TrafficDirector application lets you monitor and record information about network usage, events, and trends, and identify and isolate many fault conditions.

The TrafficDirector application consists of a centralized, SNMP-compatible network management console and data-gathering agents located at various points on a network.

You can use the TrafficDirector application to perform several basic functions:

Monitor network traffic and measure data flow.

Set limit conditions on network traffic and generate alarms if those limits are exceeded.

Capture and display fully decoded network traffic.

Collect statistical data and record it to examine later.

Interpret raw network data and translate that data into a graphical form that you can display and analyze.

Obtain real-time updates from all segments of a widely dispersed enterprise network.

Installation Notes

Before beginning the installation, consider the following:

The TrafficDirector installation takes approximately 5 minutes.
Successful use of the TrafficDirector application depends on your system being properly configured.
Ensure that you know the root password for your system. You must perform the installation as the root user.
Ensure that you know the absolute path of the executable for your web browser, and that the browser meets the requirements noted in the "Web Browser Requirements" section.
If you are running Solaris 2.5.1, determine if the volume daemon is running by entering the following command at the shell prompt:

ps -edf | grep vold

If you see several lines that contain the words vold and grep vold, this indicates that a volume daemon is running. Therefore, you can skip Step 1 through Step 3, and start with Step 4 in the "Installing the TrafficDirector Application" section.
If you do not see several lines that contain the words vold and grep vold, no volume daemon is running. You must complete all steps in the "Installing the TrafficDirector Application" section.

The TrafficDirector software is installed in the default directory /opt/CSCOtd5. If you select another directory during the installation, the TrafficDirector software is installed there instead.

Caution Cisco Systems strongly recommends that you use the default installation path of /opt/CSCOtd5. If you wish to override the default and install the software in a preexisting location, you should install the software in a directory subordinate to that location (for example, /alternate_location/CSCOtd5).

Appendix A describes how to set up a SQL database.
Appendix B lists the directories created during the installation.

Preparing to Install the TrafficDirector Application

The following sections describe prerequisites and other factors you should consider before installing the TrafficDirector application.

Web Browser Requirements

To view the online help, you must install a web browser on the UNIX workstation on which the TrafficDirector software will be installed. This installation supports Netscape Navigator, Release 4.6.1.

Minimum Server Requirements

The minimum server system requirements for the TrafficDirector application are shown in Table 2-1.

.
Table 2-1: Server System Minimum Requirements

Requirement Type Minimum Requirement

System hardware
and operating system

Sun SPARCstation or compatible.

Solaris 2.5.1 or later.

OpenWindows 3.3 (SunOS patch number 100444-x must be applied when using without Motif) or Motif Windows Manager (GUI applications are statically linked to Motif 1.2.4 and X11R5 libraries).

Memory (RAM)

256 MB minimum.

SVGA monitor

Resolution of 800 X 600 with 256 colors.

Available disk space

For real-time monitoring---25 MB minimum.

For reporting---120 MB minimum.

Additional software

You must install CiscoWorks2000 CD One before you install the TrafficDirector software. See Installing and Setting Up CiscoWorks2000 CD One on Solaris.

Requirement Type	Minimum Requirement
System hardware and operating system	Sun SPARCstation or compatible. Solaris 2.5.1 or later. OpenWindows 3.3 (SunOS patch number 100444-x must be applied when using without Motif) or Motif Windows Manager (GUI applications are statically linked to Motif 1.2.4 and X11R5 libraries).
Memory (RAM)	256 MB minimum.
SVGA monitor	Resolution of 800 X 600 with 256 colors.
Available disk space	For real-time monitoring---25 MB minimum. For reporting---120 MB minimum.
Additional software	You must install CiscoWorks2000 CD One before you install the TrafficDirector software. See Installing and Setting Up CiscoWorks2000 CD One on Solaris.

Installing the TrafficDirector Application

Caution You must install CiscoWorks2000 CD One before you can install the TrafficDirector application. For more information, see Installing and Setting up CiscoWorks2000 CD One on Solaris.

To run the installation program, follow these steps:

Step 1 Insert the TrafficDirector CD-ROM into a CD-ROM drive.

Step 2 Log into the system as the root user.

Step 3 Enter the following mount command and press Enter:

Note The actual syntax you use may differ slightly depending on your system configuration. Substitute the appropriate values where necessary.

mount -r -F hsfs /dev/sr0 /cdrom

Step 4 Enter the following command to change directories:

cd /cdrom/cdrom0/install.td5

Step 5 At the shell prompt, enter the following command to run the installation script:

./setup.sh

Note To stop the installation procedure at any time, press Ctrl-C. This command terminates the last UNIX command you entered and returns you to the shell prompt. Continue the installation by reentering the last UNIX command, or discontinue the installation procedure.

Step 6 The installation script prompts you to enter the product location. Accept the default location of /opt/CSCOtd5 or enter an alternate installation location.

Step 7 Press Enter.

The installation script prompts you to enter the full Netscape browser executable pathname.

Step 8 Enter the absolute path to your installed web browser. For example:

/usr/local/bin/cnetscape

Note The installation procedure does not allow you to leave this information blank, but does allow you to specify an incorrect location during the installation. The installation procedure will recognize the location as incorrect, but will allow you to continue.

You must correct this after completing the installation. If you set the browser path incorrectly, users cannot use the TrafficDirector online help. See the "Configuring a Web Browser" section for configuration instructions.

Step 9 The installation script prompts you to confirm that the installation location and browser executable path are correct. If correct, press Enter, or enter N and press Enter to change the information.

The installation script unpackages the files, extracts them to the installation location you specified, then performs the installation.

When the installation is complete, the following messages are displayed:

## Executing postinstall.script.
 
The file /opt/CSCOTD5/.traffdir.sh or .traffdir.cshrc contains the shell cmds required to set the environment for running TrafficDirector.
 
The file /opt/CSCOtd5/X/RMONmanager is the application resources file for TrafficDirector. You may want to modify this file in order to customize the application, for example, to change the screen background colors.
 
Installation completed.
 
To start TrafficDirector from a shell command line, follow these steps:
 
1) Make sure your DISPLAY variable is set correctly, and X binaries are in your path.
 
2) Issue the command:
 
For csh:
 
%(source /opt/CSCOtd5/.traffdir.cshrc;/opt/CSCOtd5/bin/tdir)&
 
For sh or ksh:
 
#(./opt/CSCOtd5/.traffdir.sh;/opt/CSCOtd5/bin/tdir)&
 
(Do not forget the `.dot' at the beginning followed by space)
 
Installation of <CSCOtd5> was successful.

Step 10 Issue the appropriate command to eject the CD.

Step 11 Remove the TrafficDirector CD-ROM from the drive.

Step 12 Enter the appropriate command to unmount the CD-ROM.

Step 13 Log out of the root user account.

Configuring a Web Browser

To effectively use the TrafficDirector online help feature, you must install and configure a web browser on your system and create a link that points to the browser.

Note Because the TrafficDirector installation is performed by the root user (and, therefore, the files are owned by root), you must make the changes while logged into the system as the root user.

If you chose not to configure the web browser during the installation procedure, you can set up the link now.

Edit the .traffdir.cshrc or .traffdir.sh file and add a line similar to the one in the following example, to point to the location of your web browser:

setenv HTMLBIN install_path

where install_path is the absolute path of the web browser executable.

For example, if your browser is installed in your home directory, your path would look similar to the following:

setenv HTMLBIN /home/netscape/netscape

Starting and Using the TrafficDirector Application

To start the TrafficDirector application in the background, follow these steps:

Step 1 Make sure your DISPLAY variable is set correctly, and X binaries are in your path.

Step 2 Enter the following command:

For csh:

%(source /opt/CSCOtd5/.traffdir.cshrc;/opt/CSCOtd5/bin/tdir)&

For sh or ksh:

#(. /opt/CSCOtd5/.traffdir.sh;/opt/CSCOtd5/bin/tdir)&

The TrafficDirector main window (Figure 2-1) is displayed.

Figure 2-1: TrafficDirector Main Window

For more comprehensive information, read Using the Campus TrafficDirector Application.

Shutting Down the TrafficDirector Application

When you run the TrafficDirector application, it starts the dbchkd daemon that launches all daemons responsible for logging and reporting. At regular intervals, dbchkd checks to see that all logging and reporting daemons are running, and if necessary, restarts daemons that are not running, thereby ensuring the integrity of logging and reporting.

If you find it necessary to shut down the TrafficDirector application, when you close the TrafficDirector main window (using File > Exit from the menu bar), a confirmation window is displayed, asking if you want to shut down all daemons.

Do one of the following:

Click Yes to shut down all daemons and suspend all logging. Doing so does not affect information currently logged and counters are not reset. Logging continues when you restart the TrafficDirector application.
Click No to allow all daemons to continue running and logging in the background even through the TrafficDirector application is not running.

Additional Installation Tasks

After you have installed the TrafficDirector application, and have verified that you can open it on your network management station and have configured a SQL server database for logging data for create trend reports, follow these steps:

Configure the management software so that devices performing data collection are recognized.
Define the type of data to be monitored, including protocols, topologies, and views of network traffic.
Establish how much data you want to capture for real-time monitoring, including any limits and associated actions.
Configure alert messages and parameters so they are triggered when established limits are reached.
Determine the content and appearance of printed statistical reports.
Modify the default aging, baseline, and utilization parameters, if necessary.

For more information about these tasks, see Using the Campus TrafficDirector Application.

Removing the TrafficDirector Application

To remove the TrafficDirector application, follow these steps:

Step 1 Shut down the TrafficDirector application.

Step 2 Click Yes to shut down all TrafficDirector-related daemons.

Step 3 Log into the system as the root user.

Step 4 Insert the TrafficDirector CD-ROM into a CD-ROM drive.

Step 5 Enter the following mount command and press Enter:

Note The actual syntax you use may differ slightly depending on your system configuration. Substitute the appropriate values where necessary.

mount -r -F hsfs /dev/sr0 /cdrom

Step 6 Enter the following command to change directories:

cd /cdrom/cdrom0/install.td5

Step 7 At the shell prompt, enter the following command to run the uninstallation script:

./uninstall.sh

Step 8 At the following confirmation prompt, enter Y and press Enter to continue with the uninstallation, or enter N and press Enter to cancel the uninstallation.

Uninstall TrafficDirector? (y/n)? [n]

Step 9 At the next confirmation prompt, enter Y and press Enter to continue, or enter N and press Enter to cancel.

Do you want to remove this package?

Step 10 The uninstallation procedure continues.

Note The uninstallation procedure does not remove any files created after the TrafficDirector installation (for example, configuration data, user data, and so on). You must remove this data manually. Note, however, that this data cannot be recovered once it has been removed.

Table of Contents

Installing the TrafficDirector Application on Solaris Systems