CWSI Installation Guide for Solaris

CiscoWorks for Switched Internetworks (CWSI) is a set of three network management applications: CiscoView, VlanDirector, and TrafficDirector.

This booklet provides the following information and procedures:

• System and Network Requirements

• Preparing to Install CWSI

• Installing CWSI

• Installing CWSI with CiscoWorks

• Starting CWSI

• Removing CWSI

• Adding New Device Support for CiscoView

• Additional Documentation

System and Network Requirements

Before you install CWSI, make sure your system has enough disk space and meets the requirements listed in Tables 1 and 2.

Preparing to Install CWSI

Note the following information before you install CWSI:

• Locate the pink sheet in the CWSI package containing the TrafficDirector serial number, password, and expiration date (referred to as the evaluation number, evaluation password, and evaluation expiration date on the pink sheet). You will need to enter this information during the installation.

• You can install CWSI on a local disk or on a network-mounted Network File System (NFS) disk to which you have root access.

• If you install CWSI on a computer that already has CiscoWorks installed, follow the procedure "Installing CWSI with CiscoWorks" before you install CWSI.

• If you use SunNetManager, save your SNM maps before installing CWSI.

• You can terminate the installation by pressing Ctrl-C. If you terminate before the installation is complete, you must restart at
  Step 1.

• Only members of the group specified during installation are permitted to run CWSI. During installation, if you chose the default (user: bin; group: bin) as the permitted group, only the superuser is permitted to run CWSI.

Installing CWSI

If your system already has a previous version of CWSI installed, remove it before installing the current version. Follow the instructions in the section "Removing CWSI," and then install the current version of CWSI.

Installing CWSI on Solaris involves the following main steps:

• Starting the CWSI Installation

• Installing CiscoView

• Installing VlanDirector

• Installing TrafficDirector

• Understanding Default Home Directories

• Setting Paths and Environments for CWSI

Starting the CWSI Installation

1. Become the superuser by entering su and the root password at the command prompt, or log in as root.
   
   
2. Insert the CWSI CD-ROM into the CD-ROM drive.
   
   
3. If the /cdrom directory does not already exist, enter the following command to create it:
   

# mkdir /cdrom

The CD-ROM is automatically mounted into the /cdrom/cdrom0 directory. If you are running File Manager, a separate File Manager window displays the contents of the CD-ROM.

1. Enter the following commands:
   

# cd /cdrom/cdrom0
# ./setup.sh

You are prompted to confirm that you want to install all of the CWSI applications.

1. Enter the appropriate option and press Return.
   

   After you start the installation, a series of prompts is displayed.

   
   
   
2. Press Return to accept the default value (shown first in parentheses) for each prompt. The Cisco copyright information is displayed as each component is installed.
   

As the installation proceeds, filenames for the CiscoView, VlanDirector, and TrafficDirector files are listed on the screen as they are installed. Each part takes approximately 10 to 15 minutes to install, depending on your system speed.

Installing CiscoView

CiscoView is installed first. The system prompts you to confirm or change the directory in which CiscoView is installed, the user and group members, and the directory in which the CiscoView application default files are copied:

Should (CiscoView for Solaris 4.0(1.0)) be installed in /opt/CSCOcv (y/n)? [y]
Files installed will belong to user: bin group: bin
Use this owner and group (y/n)? [y] 
Do you want to copy CiscoView application default files into /usr/lib/X11/app-defaults (y/n)? [y]

1. Press Return after each prompt to install all of the CiscoView device files. If you accept the defaults, all CiscoView device packages are installed.
   

   You are prompted to view the current CiscoView release note after CiscoView has been installed.

   
   
   
2. Enter y to view this information. (The release note is also included in your CWSI package.)
   

   A summary of your responses is displayed before you confirm the CiscoView installation.

   
   
   
3. If the summary is correct, enter y. If not, entering n returns you to the CiscoView configuration prompts and allows you to change the responses you entered.
   

   If you enter y, the CiscoView package is installed. Each CiscoView device file takes approximately 3 to 5 minutes to install.

   
   

Installing VlanDirector

VlanDirector is installed next. You are prompted to specify the database owner, group, and data file directory for VlanDirector.

1. Enter the desired values or press Return to use the defaults. Make sure the user/group you enter is correct for the user or users who intend to use VlanDirector.
   

A summary of your responses displays before you confirm the VlanDirector installation.

1. If the summary is correct, enter y to install VlanDirector. If not, entering n returns you to the VlanDirector configuration prompts and allows you to change the responses you entered.
   

   After the installation is complete, this message appears on the screen:

   
   

INSTALLATION COMPLETE A complete logfile is located in /tmp/ciscoinstall.log. 

Installing TrafficDirector

TrafficDirector is installed last. You are prompted to enter your TrafficDirector serial number, password, and expiration date, which are found on a pink sheet in your CWSI package.

1. Enter each of these items when prompted and press Return to continue.
   

   A summary of your responses displays before you confirm the TrafficDirector installation.

   
   
   
2. If the summary is correct, enter y to complete the installation. If not, entering n returns you to the TrafficDirector configuration prompts and allows you to change the variables you entered.
   

Completing the Installation

To complete your installation, follow these steps:

1. The setup menu is redisplayed after the installation is complete. Type q to exit the menu. No command is needed to unmount the CD-ROM.
   
   
2. Remove the CD-ROM and store it in a safe place.
   
   
3. The /tmp/ciscoinstall.log file contains information for the CiscoView installation only; TrafficDirector and VlanDirector installation log files are in /tmp/tdinstall.log and /tmp/vlaninstall.log, respectively.
   

   Be sure to save the installation log file or files to help you troubleshoot future installation problems.

   
   

Understanding Default Home Directories

Table 3 lists the default home directories for each application package.

Setting Paths and Environments for CWSI

If you installed the application packages in their default directories (see Table 3), you can add the following lines to the .cshrc file (csh) or .profile file (sh or ksh) for each user:

setenv PATH $(PATH):/opt/CSCOcv/bin
setenv PATH $(PATH):/opt/CSCOvlan/bin
source /opt/CSCOtd/.traffdir.cshrc

PATH=$PATH:/opt/CSCOcv/bin
PATH=$PATH:/opt/CSCOvlan/bin
. /opt/CSCOtd/.traffdir.sh

Installing CWSI with CiscoWorks

If you install CWSI on a computer that already has CiscoWorks installed, set up your CiscoWorks environment and then set up your CWSI path before using the software. Use the procedures that apply to your platform and configuration:

• Installing CWSI on Solaris 2.4 or 2.5 with SNM 2.3

• Installing CWSI on Solaris 2.5 with HP OpenView 4.1

• Understanding Default Home Directories (with CiscoWorks)

• Setting Environments for CWSI (with CiscoWorks)

Installing CWSI on Solaris 2.4 or 2.5 with SNM 2.3

To install CiscoWorks 3.2 with CWSI 1.X on a Solaris 2.4 or 2.5 platform with SNM 2.3 or Hewlett Packard (HP) OpenView 3.3, follow these steps:

1. Install CiscoWorks. DO NOT install the CiscoView application that comes bundled with CiscoWorks.
   
   
2. Install CWSI, including CiscoView, using the procedure in the "Installing CWSI" section. Choose all CiscoView packages that apply to your network.
   

Installing CWSI on Solaris 2.5 with HP OpenView 4.1

To install CiscoWorks 3.2 with CWSI 1.X on a 2.5 platform with HP OpenView 4.1, follow these steps:

1. Install CiscoWorks. DO NOT install the CiscoView application that comes bundled with CiscoWorks.
   
   
2. Install CWSI, including CiscoView, using the procedure in the "Installing CWSI" section. Choose all CiscoView packages that apply to your network.
   

Understanding Default Home Directories (with CiscoWorks)

Table 3 lists the default home directories for each application package. If CiscoWorks is present and installed in /opt/CSCOcwh, CiscoView is installed in a different directory (opt/CSCOcwh/CVapp). TrafficDirector and VlanDirecor are installed in the same directory whether CiscoWorks is present or not.

Setting Environments for CWSI (with CiscoWorks)

To set the environment setup scripts for CWSI (when installed with CiscoWorks), add the following lines to the .cshrc file (csh) or .profile file (sh or ksh) for each user:

setenv PATH $(PATH):/opt/CSCOcwh/CVapp/bin
setenv PATH $(PATH):/opt/CSCOvlan/bin
source /opt/CSCOtd/.traffdir.cshrc

PATH=$PATH:/opt/CSCOcwh/CVapp/bin
PATH=$PATH:/opt/CSCOvlan/bin
. /opt/CSCOtd/.traffdir.sh

Starting CWSI

Removing CWSI

You must remove packages in a specific order; otherwise, the pkgrm command will fail. To remove CWSI, follow these steps in the order presented:

1. Enter the following commands:
   

# pkgrm CSCOtd
# pkgrm CSCOvlan
# pkgrm CSCOcv
# /bin/rm -rf install_directory

1. Remove the .cvlanrc file from your home directory, if it is present. Also remove all files with names ending in .map from your home directory.
   

If this attempt also fails, remove the remaining files using the following command:

# /bin/rm -rf install_directory

Adding New Device Support for CiscoView

To add new devices to CiscoView (incremental installations), access the Cisco Systems online support channel, Cisco Connection Online (CCO). Instructions on how to download additional devices for CiscoView using the cvinstall command are on CCO or on the anonymous ftp server, in the Network Management section of the Software Center (formerly called the Software Image Library) or on the Incremental Instructions document found on the Cisco Enterprise Customer Documentation CD.

If you do not have Internet access, you can add devices from the Network Management Support CD. This is a separate CD that contains additional devices not included on the CWSI CD.

To incrementally add device support from the Network Management Support CD or from CCO, use the following procedure.

1. Download the device package files from the Support CD or CCO into the cv_pkgs directory.
   
   
2. For CCO packages, untar the package by entering the following command:
   

# tar -xvf tar_file_name

1. Set your NMSROOT environment variable, as follows:
   

# setenv NMSROOT /opt/CSCOcv

1. Go to the cv_pkgs directory by entering the following command:
   

# cd /cdrom/cdrom0/cv_pkgs

1. To install the package, log in as root and enter the following command:
   

$NMSROOT/bin/cvinstall device_name.pkg

Additional Documentation

Cisco documentation and additional literature are available in a CD-ROM package, which ships with your product. The Documentation CD-ROM, a member of the Cisco Connection Family, is updated monthly. Therefore, it might be more up to date than printed documentation. To order additional copies of the Documentation CD-ROM, contact your local sales representative or call customer service. The CD-ROM package is available as a single package or as an annual subscription. You can also access Cisco documentation on the World Wide Web at http://www.cisco.com, http://www-china.cisco.com, or http://www-europe.cisco.com.