|
|
CWSI Campus is a suite of network management applications that allow you to configure, monitor, and manage a switched internetwork. CWSI Campus includes the following applications:
The CWSI Campus installation automatically installs the Network Map, VlanDirector, UserTracking, and CiscoView applications. The TrafficDirector and AtmDirector applications are optional components.
This chapter includes the following information:
Table 3-1 provides a quick reference overview of how to install CWSI Campus, including references to where you can find more details about each task.
| Task | Steps | References | ||
|---|---|---|---|---|
| Step 1 Verify system requirements. | |||
Step 2 Install the browser you will be using. | ||||
Step 3 Save your SNM maps before installing CWSI Campus. | ||||
Step 4 Install the Essentials application. | ||||
Step 5 Select your seed device. | ||||
Step 6 Select the device packages you need based on the devices you plan to use. | ||||
| Step 1 Become superuser. | |||
Step 2 Mount the CWSI Campus CD-ROM. | ||||
Step 3 Run the installation program. | ||||
Step 4 Answer any questions that result from the installation program's checks. | ||||
Step 5 Complete the installation. | "Completing the Installation" section on | |||
Step 6 Verify your community strings. | "Completing the Installation" section on | |||
| Step 1 Install additional software required by several applications in the Campus suite. | |||
| Step 1 Start Campus, and the VlanDirector, AtmDirector, UserTracking, TrafficDirector, and CiscoView applications. |
Before you install CWSI Campus, perform the following steps:
Step 1 Verify system requirements.
For complete system and network requirements, see "Before You Begin."
Step 2 Install your browser.
Install the browser that you will be using (if you have not already done so). The browser is required to view the CWSI Campus online help. Launch the browser at least once to confirm the license registration.
Step 3 Install Resource Manager Essentials.
Follow the instructions provided in "Installing Essentials."
Step 4 Determine your seed device.
See "Determining Your Seed Device" for additional information.
Step 5 Determine which CiscoView device packages to install.
When CiscoView is installed during the CWSI Campus installation, the setup program will prompt you to select the device packages (.pkg files) you need based on the devices you plan to use. Make sure you know the types of devices you plan to use and manage on your network.
During the installation, you will be prompted for a seed device. The seed device is the device from which you start the discovery process. The seed device can be any Cisco device with the Cisco Discovery Protocol (CDP) enabled (for example, a Catalyst 5000 switch) and a valid read Simple Network Management Protocol (SNMP) community string.
The seed device you select during the CWSI Campus installation determines whether the product operates correctly. Verify that the seed device meets the following requirements before installing CWSI Campus:
If you have an ATM network, you need to select a LightStream 1010 switch as the seed device for the discovery. The LightStream 1010 switch should be located near a Catalyst 5000 switch on the network. This allows the LAN Emulation (LANE) components to be properly discovered using Interim Local Management Interface (ILMI).
Table 3-2 lists the Cisco software versions that support LANE discovery.
| Device | Version |
|---|---|
LightStream 1010 switch | Cisco IOS Release 11.2(8) |
Cisco routers | Cisco IOS Release 11.2(10) |
Catalyst 5000 series switches | NMP (2.4.3)/ATM 3.2(5) |
Catalyst 3000 series switches | 2.2(2) |
For Token Ring switching to work, specific software versions are needed, as listed in Table 3-3.
| Device | Version |
|---|---|
Catalyst 3900 Main | 3.0(2) |
Catalyst 3900 ATM | 1.2(3) |
Catalyst 5000 Supervisor Module | 3.2(2) |
Catalyst 5000 TokenRing Module | 3.2(2) |
Catalyst 5000 ATM Line Module | 70.1(1) |
This section provides a procedure for upgrading from CWSI Campus 2.2 to CWSI Campus 2.3. Before upgrading, consider the following:
# /opt/CSCOcwsi/bin/uninstall.sh
To upgrade to CWSI Campus 2.3, follow these steps:
Step 1 Close all CWSI Campus windows before upgrading and reinstalling CWSI Campus. Otherwise, the installation process aborts while trying to overwrite files that are in use.
Step 2 Start the installation process using the instructions in the "Installing CWSI Campus" section.
The installation process looks for any previous CWSI Campus installation and its version.
Step 3 Confirm whether you want to preserve the database and the data files when prompted. If you click No, these data files are overwritten. If you click Yes, a backup directory is created under the CWSI Campus installation directory.
The CWSI Campus database cwsi.db and the data files (ani.properties, atmd.properties, and communities.dat) are copied into this directory. These files are copied back to their original locations when the installation is complete.
The system displays information about the previous installation of CWSI: the installation folder, the database folder, the seed device, and the components that are installed (CiscoView, TrafficDirector and AtmDirector) if any.
The path of the web browser is also displayed.
The CiscoView devices directory is deleted to allow you to install the latest version of the device packages and avoid the possible incompatibility with the shared device files. You must select the previously installed packages in addition to the new packages.
Step 4 Reinstall and select the optional CWSI Campus components (TrafficDirector and AtmDirector) that were installed previously.
Step 5 Terminate the previously running dvtrapd process (a process used by TrafficDirector) by entering the following commands:
# ps -ef | grep dvtrapd # kill process_id
If you plan to install multiple copies of CWSI Campus on your network, you should be aware of how the CWSI Campus discovery process works in this environment.
The discovery process uses asynchronous network interface (ANI), which runs as a server process and exchanges information with other CWSI Campus applications running as clients. Each ANI server is intended to manage a single domain. Therefore, if you install another copy of CWSI Campus configured with the same ANI server name (the default is HostnameAniServer) in your network, unpredictable behavior might result depending on which ANI server the client chooses as its default ANI server.
If you want to install another copy of CWSI Campus to manage another domain, you must manually configure your systems to run separate ANI server processes. To configure your systems, follow these steps:
Step 1 Close all CWSI Campus applications.
Step 2 Run the stopcwsiserver script (see the section "Stopping and Starting CWSI Campus Processes" section).
Step 3 Locate and open the ani.properties file with a text editor.
The ani.properties file is located in the CWSIROOT/etc/cwsi directory, where CWSIROOT is the directory in which you installed CWSI Campus.
Step 4 Change the following line to rename the ANI server process running on your local workstation:
AniServer = <Hostname>AniServer
For example, if you just installed a Solaris version of CWSI Campus, you could rename the AniServer to SOLAniServer.
Step 5 Save the file and close your text editor.
Step 6 Run the startcwsiserver script (see the section ""Stopping and Starting CWSI Campus Processes" section.").
To install CWSI Campus, follow these steps:
Step 1 Become superuser by entering su and the root password at the command prompt, or log in as root.
Step 2 Insert the CWSI Campus CD-ROM into the CD-ROM drive.
Step 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.
Step 4 Enter the following commands:
# cd /cdrom/cdrom0 #./setup.sh
Step 5 Enter y to agree to the terms of the copyright.
Step 6 When prompted, select the optional components that you want to install.
1 CSCOtd5 TrafficDirector for HP-UX (PA_RISC) 5.6 2 CSCOatmd AtmDirector for HP-UX (PA_RISC) 2.3 Select optional components you wish to install (all/none/q)? [all]:
Step 7 Enter the appropriate option and press Return.
Step 8 Enter information or press Return for the default response (in square brackets) to the following requests:
Enter product location (PKGROOT): [/opt/CSCOcwsi] Enter database location: [/opt/CSCOcwsi/db/data] Enter seed device name or IP address: Enter ANI Server name: [hostnameAniServer] Enter full netscape browser executable pathname: Enter TCP port number to use for DB: [8000]
The values you enter or confirm are displayed.
Step 9 Enter y to accept these values.
As the installation proceeds, filenames for the CWSI Campus, CiscoView, TrafficDirector, and AtmDirector applications are displayed as they are installed. Each application takes approximately 10 minutes to install, depending on your system configuration.
Step 10 You are prompted to select all of the device packages you want to install.
Step 11 Select the numbers from the list that correspond to the device packages you want to install (for example "1 2 3"). You can also enter "all" or "none." The default is all.
Step 12 You are prompted if you want the README file displayed when the installation completes. Select y or n.
Other prompts appear depending on which application you have chosen to install. Refer to the "Installing TrafficDirector and AtmDirector" section in this chapter for specific instructions about installing these applications.
The TrafficDirector and AtmDirector applications are optional components. If you choose to install the TrafficDirector and AtmDirector applications, these components are installed automatically in the /opt/CSCOcwsi directory.
To complete your installation, follow these steps:
Step 1 Remove the CD-ROM and store it in a safe place.
Step 2 The /tmp/cwsiinstall.log file contains information for the CiscoView, TrafficDirector, and AtmDirector applications. Be sure to save this file to help you troubleshoot future installation problems.
Step 3 Verify your community strings.
If the read community strings in your network are different from the default "public," you will need to edit the communities file (communities.dat) after installing and before starting CWSI Campus and discovering your network. The communities.dat file is located in the install directory/etc/cwsi directory. For more information, see the Getting Started with CWSI Campus publication.
To install TrafficDirector standalone (independent of CWSI Campus), run the setup.sh installation script located in the CSCOtd5/install.td directory on the CD-ROM.
Several of the applications in the CWSI Campus suite require additional software which can be installed after you install CWSI Campus.
A TFTP server must be set up and configured if you plan to use the VMPS feature in UserTracking. For more information about installing and configuring a TFTP server, see the "Configuring a TFTP Server for Use with VMPS" chapter in the Using the CWSI Campus UserTracking Application publication.
This section explains how to install CWSI Campus if you have a previous version installed on your machine. This process involves the following major steps:
1. (Optional) Removing previous versions of CWSI Campus.
2. Close all CWSI Campus applications.
3. Running the CWSI Campus installation program to install the new version.
Step 1 (Optional) To remove previous versions of CWSI Campus, log in as root and then enter the uninstall command:
# /opt/CSCOcwsi/bin/uninstall.sh
The default CWSI Campus install directory is /opt/CSCOcwsi. If you installed CWSI Campus and its applications in a different directory, enter that directory instead.
Step 2 Close all CWSI Campus Applications.
Step 3 Run the CWSI Campus installation program to install the new version as explained in the "Upgrading to CWSI Campus 2.3" section.
The upgrade procedure is identical to performing a new installation.
To start CWSI Campus, enter the following command:
/opt/CSCOcwsi/bin/cwsi
After installing CWSI Campus 2.3, wait approximately 5 minutes before starting the product. If you attempt to start the product too soon, the following error message is displayed:
osagent could not find the object object_name. ANI server
Click OK, wait a few minutes, and then start the product again. This error does not affect product operation.
You can control CWSI Campus processes with command-line scripts; however, you must log in as root. To enter command-line scripts for stopping and restarting CWSI Campus processes, follow these steps:
Step 1 Stop the CWSI Campus client by closing the CWSI Campus Topology window.
Step 2 Open a command prompt or shell window.
Step 3 Enter the following command to stop the CWSI Campus processes.
# /opt/CSCOcwsi/bin/cwsi stopcwsiserver
When the prompt returns, all daemons have been stopped.
Step 4 Enter the following command to start the CWSI Campus processes.
# /opt/CSCOcwsi/bin/cwsi startcwsiserver
Wait until the prompt returns.
CiscoView is a device-focused application that you can easily start from HP-OV because of the device discovery process in HP-OV. The additional CWSI Campus functions require more detailed network-wide topology data than HP-OV can provide. The CWSI Campus discovery and database services must be running for these additional applications to function. Therefore, you must start these services from the CWSI Campus Network Map window.
Starting multiple instances of CWSI Campus applications terminates the currently launched instance of the application or produces a memory error. If you start multiple instances of a CWSI Campus application, terminate all instances and then start only one instance.
To remove CWSI Campus, you must log in as root and close all CWSI Campus windows.
Enter the uninstall command as follows:
# /opt/CSCOcwsi/bin/uninstall.sh
The default CWSI Campus install directory is /opt/CSCOcwsi. If you installed CWSI Campus and its applications in a different directory, enter that directory instead.
After uninstalling CWSI Campus, some directories and files might remain. In that case, delete these directories and files manually. If you are unable to delete them, and the message "the file is in use" appears, reboot your machine, then manually delete the remaining files.
Although TrafficDirector and CiscoView are standalone products, they cannot be uninstalled separately from the CWSI Campus package because they share components with CWSI Campus.
To add new devices to CiscoView, access Cisco Connection Online (CCO). Instructions on how to download additional devices for CiscoView using the cvinstall command are available on CCO or on the anonymous ftp server in the Network Management section of the Software Center. These instructions are also included in the CiscoView Incremental Installation Quick Reference publication, which is on the Documentation CD.
To incrementally add device support from CCO, follow these steps:
Step 1 If you installed CiscoView in a directory other than /opt/CSCOcwsi, use that directory name in this procedure.
Step 2 Download the device package files from CCO into the cv_pkgs directory.
Step 3 For CCO packages, untar the package by entering the following command:
# tar -xvf tar_filename
Step 4 Set your NMSROOT environment variable, as follows:
# setenv NMSROOT /opt/CSCOcwsi
Step 5 Go to the cv_pkgs directory:
# cd /cdrom/cdrom0/cv_pkgs
Step 6 To install the package, log in as root and enter the following command:
$NMSROOT/bin/cvinstall device_name.pkg
Posted: Wed Nov 17 16:12:16 PST 1999
Copyright 1989-1999©Cisco Systems Inc.