cc/td/doc/product/rtrmgmt/sw_ntman/cwsimain/cwsi_1
hometocprevnextglossaryfeedbacksearchhelp
PDF

Table of Contents

CWSI Installation Guide for UNIX

CWSI Installation Guide for UNIX

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:

Instructions are also provided for removing CWSI from each system type.

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.


CWSI System Requirements
Requirement Sun HP
Hardware Sun SPARCstation

Color monitor

 HP 9000 Series 700

Color monitor

Software Operating System
Solaris 1.x (SunOS 4.1.3, SunOS 4.1.3_U1, or SunOS 4.1.4)

Solaris 2.4 or 2.5 with recommended patches as of March 16, 1996

 HP/UX 9.05, HP/UX 9.07, HP/UX 10.01, HP/UX 10.10
Available Disk Space 112 MB for full installation 120 MB for full installation
RAM 32 MB 32 MB
Windowing System X11R4 or X11R5

OpenWindows 3.0, 3.3, and Motif 1.2

 X11R4 or X11R5

HPVUE, Motif 1.2

Network management software (not required) SunNet Manager 2.2.2

HP OpenView 3.3

Disk Space Required for Various Components
Component Disk Space
Base 400 KB
Each switch 5 KB
Each module per switch 20 KB
Each VLAN 2 KB

If an example network contains 100 switches with 3 modules per switch and 500 VLANs, the following formula calculates the space required:

400 KB + (100 x 5 KB) + (300 x 20 KB) + (500 x 2 KB) = 7850 KB

Preparing to Install CWSI

Note the following information before you install CWSI:

Installing CWSI on SunOS

To install CWSI on SunOS, follow these steps:


  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

  1. Mount the CD-ROM by entering the following command: 
# mount -rt hsfs /dev/sr0 /cdrom
# cd /cdrom
# ./extract_unbundled

Make sure to include the ./ in the extract_unbundled command.



  1. Respond to the program prompt: 
Do you want to continue (y/n)?

  1. Enter y to accept the copyrights for CWSI and terms of the Cisco licensing agreement.

    As the installation begins, a series of prompts is displayed.



  2. Press Return to accept the default value (shown in square brackets) for each prompt.

    The screen displays a warning that the installation runs some commands as superuser.



  3. Enter y at the prompt to continue with the installation.

  4. CiscoView is configured first. The screen displays the following prompts. Press Return to accept the defaults. 
Should (CiscoView for SunOS) be installed in /usr/nms (y/n)? [y]
Note The default destination for CWSI is /usr/nms/cvapp if CiscoWorks is already installed. 
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. Enter y to install all the CiscoView device files.

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



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

    A summary of your answers displays before you complete the CiscoView installation. This summary lets you review your responses to the installation prompts.



  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 that you entered.

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



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

    A summary of your responses lets you confirm the TrafficDirector installation.



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

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



  6. 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 answers displays before you confirm the VlanDirector installation.



  7. If the summary is correct, enter y to begin the installation. If not, entering n returns you to the VlanDirector configuration prompts and allows you to change the responses that you entered.

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

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

INSTALLATION COMPLETE A complete logfile is located in /tmp/ciscoinstall.log.  Update your PATH to include /usr/nms/bin, etc.
===================================================
========= Software Install Tool Completed. =========
===================================================

  1. Enter the following commands as superuser to unmount the CD-ROM: 
# cd /
# umount /cdrom

  1. Remove the CD-ROM and store it in a safe place.
Note Be sure to save the installation log file or files to help you troubleshoot future installation problems.

  1. Set paths for CWSI by adding the following lines to the .cshrc file (csh) or .profile file (sh or ksh) for each user:

    csh

    setenv PATH $(PATH):/usr/nms/bin
source /usr/nms/TrafficDirector/.traffdir

    sh or ksh

    PATH=$PATH:/usr/nms/bin
. /usr/nms/TrafficDirector/.traffdir
    Note If you installed CWSI in a directory other than /usr/nms/bin, use that directory name in the lines above.

    Removing CWSI from SunOS

    If you installed a previous version of CWSI, it is not necessary to remove the previous version before installing the new version. This information is provided in case you want to remove CWSI for other reasons.

    To remove CWSI, follow these steps:


    1. Enter the following commands: 
    # cd /var/sadm/csco
# ./rmprod ciscoview
# ./rmprod vlandirector
# /bin/rm -rf install_directory
    Note The default CWSI install directory on SunOS is /usr/nms. The rm -rf command removes the directory tree and all the files in it, including your VlanDirector databases, if you previously installed them there.

    1. Enter the following command: 
    # rm -rf /var/tmp/unbundled

    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.

    Installing CWSI on Solaris

    To install CWSI on Solaris, follow these steps.

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


    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
# pkgadd -d .

    Make sure to include the space and period at the end of the pkgadd command.


    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, TrafficDirector, and VlanDirector files are listed on the screen as they are installed. Each part takes approximately 5 to 10 minutes to install, depending on your system speed. CiscoView is installed first. The system displays the following prompts: 


    Should (CiscoView for Solaris 3.1(1.0)) be installed in /opt/CSCOcv (y/n)? [y]
    Note If the destination directory does not exist on your system, you are prompted to create it. Enter 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.

      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.


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



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

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



    5. 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.

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

      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.



    7. 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.  Update your PATH to include /usr/nms/bin, etc.
===================================================
========= Software Install Tool Completed. =========
===================================================
    Note 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.

    1. The pkgadd 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.
    Note Be sure to save the installation log file or files to help you troubleshoot future installation problems.

    1. To set the paths for CWSI, add the following lines to the .cshrc file (csh) or .profile file (sh or ksh) for each user:

      csh

      setenv PATH $(PATH):/opt/CSCOcv/bin
source /opt/CSCOcv/TrafficDirector/.traffdir

      sh or ksh

      PATH=$PATH:/opt/CSCOcv/bin
. /opt/CSCOcv/TrafficDirector/.traffdir
      Note If you installed CWSI in a directory other than /opt/CSCOcv, use that directory name in the lines above.

      Removing CWSI from Solaris

      To remove CWSI, follow these steps:


      1. Enter the following commands: 
      # pkgrm CSCOtd
# pkgrm CSCOvlan
# pkgrm CSCOcv
# /bin/rm -rf install_directory
      Note The default CWSI install directory is /opt/CSCOcv. The rm -rf command removes the entire directory tree and all the files in it, including your VlanDirector databases, if you previously installed them there.

      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.

      Installing CWSI on HP/UX 9

      To install CWSI on HP/UX 9, follow these steps:


      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. Become the superuser by entering su and the root password at the command prompt, or log in as root.

      4. If the /cdrom directory does not already exist, enter the following command to create it: 
      # mkdir /cdrom

      1. Enter the following command: 
      # mount -r cdrom_device /cdrom

      where cdrom_device is the pathname of the CD-ROM device on your system.


      Note This pathname depends upon the SCSI ID of the CD-ROM device. For example, if the CD-ROM device has a SCSI ID of 6, the pathname will be /dev/dsk/c201d6s0; if the SCSI ID is 4, the pathname will be /dev/dsk/c201d4s0, and so on.

      1. Enter the following commands at the system prompt: 
      # cd /cdrom
# ./setup.sh

      Make sure to include the ./ in the setup.sh command.



      1. Respond to the program prompt: 
      Do you want to continue (y/n)?

      1. Enter y to accept the copyrights for CWSI and terms of the Cisco licensing agreement, and the installation begins.

        You are prompted to indicate which CWSI applications you want to install.



      2. Enter the appropriate option and press Return.

        After you start the installation, a series of prompts is displayed. Press Return to accept the default value (shown first in parentheses) for each prompt.


        For each application you install, you are warned that the installation runs some commands as superuser.



      3. Enter y at the prompt to continue with the installation.

        CiscoView is installed first. The screen displays a series of prompts.



      4. Press Return to accept the defaults. The screen prompts as follows: 
      Should (CiscoView for HP/UX) be installed in /usr/nms (y/n)? [y]
      Note The default destination for CWSI is /usr/nms/cvapp if CiscoWorks is already installed. 
      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]

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



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

        A summary of your answers displays before you confirm the CiscoView installation.



      2. 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.

        You are prompted for your TrafficDirector serial number, password, and expiration date, which are found on a pink sheet in your CWSI package. Enter each of these items when prompted and press Return to continue.


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



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

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



      4. 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 lets you confirm the VlanDirector installation.



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

      All the items you specified are now installed. As the installation proceeds, filenames for the CiscoView, TrafficDirector, and VlanDirector files are listed on the screen as they are installed. Each product takes approximately 5 to 10 minutes to install, depending on your system speed.

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

      INSTALLATION COMPLETE A complete logfile is located in /tmp/ciscoinstall.log.  Update your PATH to include /usr/nms/bin, etc.
===================================================
========= Software Install Tool Completed. =========
===================================================

      1. Enter the following commands to unmount the CD-ROM: 
      # cd /
# umount /cdrom

      1. Remove the CD-ROM and store it in a safe place.
      Note Be sure to save the installation log file or files to help you troubleshoot future installation problems.

      1. Set the paths for CWSI by adding the following lines to the .cshrc file (csh) or .profile file (sh or ksh) for each user:

        csh

        setenv PATH $(PATH):/usr/nms/bin
source /usr/nms/TrafficDirector/.traffdir

        sh or ksh

        PATH=$PATH:/usr/nms/bin
. /usr/nms/TrafficDirector/.traffdir
        Note If you installed CWSI in a directory other than /usr/nms/bin, use that directory name in the lines above.

        Removing CWSI from HP/UX 9

        To remove CWSI, follow these steps:


        1. Enter the following commands: 
        # rmfn -l CVIC
# rmfn -l CISCO-VIEW
# rmfn -l VLAN-DIRECTOR
# rm -rf install_directory
        Note The default CWSI install directory is /usr/nms. The rm -rf command removes the directory tree and all the files in it, including your VlanDirector databases, if you previously installed them there.

        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.

        Installing CWSI on HP/UX 10

        To install CWSI on an HP/UX 10 system, follow these steps:


        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

        1. Enter the following command: 
        # mount -r cdrom_device /cdrom

        where cdrom_device is the pathname of the CD-ROM device on your system.


        Note This pathname depends upon the SCSI ID of the CD-ROM device. For example, if the CD-ROM device has a SCSI ID of 6, the pathname will be /dev/dsk/c201d6s0; if the SCSI ID is 4, the pathname will be /dev/dsk/c201d4s0, and so on.

        1. Enter the following commands at the system prompt: 
        # cd /cdrom
# ./setup.sh

        Make sure to include the ./ in the setup.sh command.


        The system displays the space requirements for CWSI and prompts for the directory where you want to install CWSI.


        Enter directory to install CWSI into? [/opt/CSCOcv]

        1. Press Return to accept the default or enter another directory name.
        Note If you already have CiscoWorks installed, the default CWSI directory is /opt/CSCOcwh/CVapp.

        The system displays the space available in the chosen directory.



        1. Respond to the program prompt: 
        Do you want to continue (y/n)?

        Enter y to accept the copyrights for CWSI and terms of the Cisco licensing agreement, and the installation begins.


        You are prompted to indicate which components of CWSI you wish to install.



        1. Enter the appropriate option and press Return.

          A series of prompts is displayed.



        2. Press Return to accept the default value (shown first in parentheses) for each prompt.
        Note For each package you install, you are warned that the installation runs some commands as superuser. Enter y at the prompt to continue with the installation.

        1. CiscoView is configured first. The screen displays a series of prompts about the following variables: 
        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. Enter y to install all of the CiscoView device files.

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



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

          A summary of your responses lets 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 variables you entered.

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



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

          A summary of your answers lets you confirm the TrafficDirector installation.



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

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



        6. 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 lets you confirm the VlanDirector installation.



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

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

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

        INSTALLATION COMPLETE A complete logfile is located in /tmp/ciscoinstall.log.  Update your PATH to include /usr/nms/bin, etc.
===================================================
========= Software Install Tool Completed. =========
===================================================

        1. Enter the following commands as superuser to unmount the CD-ROM: 
        # cd /
# umount /cdrom

        1. Remove the CD-ROM and store it in a safe place.
        Note Be sure to save the installation log file or files to help you troubleshoot future installation problems.

        1. Set the paths to the CWSI binaries by adding the following lines to the .cshrc file (csh) or .profile file (sh or ksh) for each user:

          csh

          setenv PATH $(PATH):/opt/CSCOcv/bin
source /opt/CSCOcv/TrafficDirector/.traffdir

          sh or ksh

          PATH=$PATH:/opt/CSCOcv/bin
. /opt/CSCOcv/TrafficDirector/.traffdir
          Note If you installed CWSI in a directory other than /opt/CSCOcv, use that directory name in the lines above.

          Removing CWSI from HP/UX 10

          To remove CWSI from an HP/UX 10 system, follow these steps:


          1. Enter the following commands: 
          # swremove -v CISCOVIEW
# swremove -v VLANDIRECTOR
# swremove -v CWSI
# rm -rf install_directory

          You will be prompted to confirm each removal.


          Note The default CWSI install directory is /opt/CSCOcv (or /opt/CSCOcwh/CVapp if CiscoWorks is already installed). The rm -rf command removes the entire directory tree and all the files in it, including your VlanDirector databases, if you previously installed them there.

          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.

          Installing CWSI on a CiscoWorks System

          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.

          Product Home Directories

          CiscoWorks and CWSI cannot share the same home directory. Both products attempt to install themselves into /usr/nms unless you specify otherwise. If CiscoWorks is detected while CWSI is being installed, CWSI is placed in a subdirectory inside the CiscoWorks home directory, CVapp. Therefore, if the default locations were used, CiscoWorks would be installed in /usr/nms and CWSI would be installed in /usr/nms/CVapp.

          Both products contain environment setup scripts in their etc directory. The CiscoWorks setup file is by default in /usr/nms/etc/install.cshrc, and the CWSI setup file is found in /usr/nms/CVapp/etc/CVinstall.cshrc.

          Setting Up Environments

          To set up your CiscoWorks environment, enter the following at the C shell prompt:

          % source /usr/nms/etc/install.cshrc

          or enter the following at the Bourne or Korn shell prompt:

          $. /usr/nms/etc/install.sh

          To set up your CWSI environment, enter the following at the C shell prompt:

          % source /usr/nms/etc/CVapp/CVinstall.cshrc

          or enter the following at the Bourne or Korn shell prompt:

          $. /usr/nms/etc/CVapp/CVinstall.sh

          Setting Paths

          To set up your CiscoWorks path, enter the following at the C shell prompt:

          % setenv PATH $(PATH):/usr/nms/bin

          To set up your CWSI path, enter the following at the C shell prompt:

          % setenv PATH $(PATH):/usr/nms/CVapp/bin

          or enter the following at the Bourne or Korn shell prompt:

          $ PATH=$PATH:/usr/nms/bin:/usr/nms/CVapp/bin
$ export PATH

          To set up the TrafficDirector environment, enter the following command:

          % source /usr/nms/TrafficDirector/.traffdir

          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.

hometocprevnextglossaryfeedbacksearchhelp
Copyright 1989-1997 © Cisco Systems Inc.