|
|
CWSI Campus is a suite of network management applications that allows you to configure, monitor, and manage a Cisco switched internetwork. CWSI Campus includes the following applications:
The CWSI Campus installation automatically installs the Network Map, VlanDirector, CiscoView, and UserTracking applications. The TrafficDirector and AtmDirector applications are optional components.
You can select and start up both CiscoView and TrafficDirector applications from HP OpenView (HP-OV) Manager or SunNet Manager (SNM). The additional CWSI Campus functions, including the CWSI Campus topology mapping services, VlanDirector, AtmDirector, and UserTracking applications, must be started from the main CWSI Campus interface, which is started from Solaris as part of the normal start-up procedures for CWSI Campus.
TrafficDirector and CiscoView are device-focused applications and are easily started from HP-OV and SNM, based upon the device discovery process within HP-OV and SNM. The additional CWSI Campus functions require more detailed network-wide topology data than HP-OV and SNM can provide. The CWSI Campus discovery and database services must be running for these additional applications to function, which means you need to start these services from the CWSI Campus Network Map window.
This chapter consists of the following sections:
Table 3-1 provides an overview of the process for installing CWSI Campus and references to more details about each task. The information in the rest of this chapter follows the same order as the quick reference. You can use the quick reference as a checklist when performing the procedures.
| Task | Steps | References | ||
|---|---|---|---|---|
| Step 1 Verify system requirements. | "Before You Begin" chapter | ||
Step 2 Install the browser you will be using. | "Installing Your Browser" section | |||
Step 3 Save your SunNet Manager maps before installing CWSI Campus. | "Saving SNM Maps" section | |||
Step 4 Install the Essentials application. | "Installing Essentials" chapter | |||
Step 5 Select your seed device. | "Installing CWSI Campus" section | |||
Step 6 Select the device packages you need based on the devices you plan to use. | "Determining Which CiscoView Device Packages To Install" section | |||
| Step 1 Become superuser. | "Installing CWSI Campus" section | ||
Step 2 Mount the Essentials CD-ROM. | "Installing CWSI Campus" section | |||
Step 3 Run the installation program. | "Installing CWSI Campus" section | |||
Step 4 Answer any questions that result from the installation program's checks. | "Installing CWSI Campus" section | |||
Step 5 Complete the installation. | "Completing the Installation" section | |||
Step 6 Verify your community strings. | ||||
| Step 1 Start CWSI Campus, and the VlanDirector, AtmDirector, UserTracking, TrafficDirector, and CiscoView applications. | "Starting CWSI Campus" section |
Before you install CWSI Campus, ensure that your system has been set up properly. To set up your system, perform the following procedures in the sequence noted:
1. Patch Requirement for JRE 1.1.6 on Solaris 2.5.1
2. Patch Requirement for Sun XServer Software
3. Verifying System and Network Requirements
5. Installing Resource Manager Essentials
7. Determining Your Seed Device
8. Determining Which CiscoView Device Packages To Install
Before installing CWSI Campus, you must install a patch for the Java Runtime Environment (JRE) 1.1.6 for Solaris 2.5.1 and reboot your system. To do this, follow these steps:
1. Go to the Sun Microsystems website for Solaris 7 Product Line, Java Runtime Environment (JRE) for Solaris 2.5.1 at the following URL:
2. Click Download JRE 1.1.6 for Solaris Production Release.
3. Click Submit to download the following default selections:
Version = JRE 1.1.6v3 Production Release (8/24/98)
Platform = Solaris 2.5.1/2.6 Sparc Edition JDK (Native Threads)
License Agreement = I have read and agree to the License terms.
4. Complete the personal information form and click Submit.
5. Under Download, click Patches for Solaris 2.5.1/2.6.
6. When the security warning is displayed, verify that the sparc_jdk_patches_tar.Z filename is displayed as the file that will be downloaded and click OK.
7. After the file has been downloaded to your system, enter the following command to untar the file:
# zcat sparc_jdk_patches_tar.Z | tar xvf -
8. Four files are decompressed from this tar file: 105490-04.tar, 103566-25.tar, 103640-17.tar, and 105280.tar. Each file contains a Solaris patch. For Solaris 2.5.1 and CWSI Campus, you must install 103640-17.tar or later.
9. Enter the following command:
# tar -xvf patch_filename
where patch_filename is the patch file, in this case 103640-17.tar.
10. Change to the patch_filename directory and follow the instructions in the Install.info file to install the patch.
11. Reboot your system.
XServer software occasionally crashes when CWSI Campus topology is displayed. This might be related to the presence of a specific (but undetermined) device in the ANI database. This is a bug in the Sun XServer software, which is fixed by patch 105790 from Sun.
For complete system and network requirements, see the chapter "Before You Begin."
Install the browser that you will be using, if you have not already installed it. Launch the browser at least once to confirm the license registration. Note the browser location. The install program will need the full executable pathname.
If you decide to use Netscape as your browser and it has not already been installed, you can install it any time. Starting CWSI Campus help does not provide the interaction for you to view and accept the Netscape licensing information. You must start Netscape at least once before starting CWSI Campus help so you can accept the Netscape licensing information. If you do not start Netscape before starting CWSI Campus help, CWSI Campus help will not start.
Install the Essentials application from the CD provided. Follow the instructions provided in the chapter "Installing Essentials."
If you use SunNet Manager (SNM), save your SNM maps before installing CWSI Campus.
During installation, you are 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 series 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:
For LANE discovery to work, specific software versions are needed, as listed in Table 3-2.
| 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) |
When CiscoView is installed during the CWSI Campus installation, you are prompted 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 on using and managing in your network.
This section provides a procedure for upgrading from CWSI Campus 2.1 or 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 installation guide.
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.
In Solaris, 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 <Hostname>AniServer) 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").
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.").
To install CWSI Campus:
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 You are prompted to select the optional components that you want to install.
1 CSCOtd5 TrafficDirector for Solaris (sparc) 5.6 2 CSCOatmd AtmDirector for Solaris (sparc) 2.2 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: Enter full netscape browser executable pathname:
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 following sections for specific instructions about installing these applications.
When installing CiscoView, you will see the following prompt:
CWSI detected in /opt/CSCOcwsi Installing CiscoView in /opt/CSCOcwsi. Files installed will belong to user: bin group: bin Use this owner and group (y/n)? [y]
To install CiscoView:
Step 1 Note that the default installation process installs CiscoView in the /opt/CSCOcwsi directory with the user and group both set to bin. Press Return or enter y to accept the default or enter n to change the directory and the user or group members.
Step 2 At the prompt, enter the number corresponding to the device file you want to install. To install all the CiscoView device files, press Return or enter y.
Step 3 Enter y to display the current CiscoView release notes after installing CiscoView.
A summary of your responses is displayed before you confirm the CiscoView installation.
Step 4 Enter y if the summary is correct. If you need to change anything, enter n to return to the CiscoView configuration prompts and change the responses you entered.
If other components can be installed, the following menu reappears:
1 CSCOtd5 TrafficDirector for Solaris (sparc) 5.6 2 CSCOatmd AtmDirector for Solaris (sparc) 2.2 Select optional components you wish to install (all/none/q)? [all]:
Step 5 Select another component or enter q to exit from the menu. If you select another component, refer to the "Installing TrafficDirector and AtmDirector" section.
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.
If other components can be installed, the following menu reappears:
1 CSCOtd5 TrafficDirector for Solaris (sparc) 5.6 2 CSCOatmd AtmDirector for Solaris (sparc) 2.2 Select optional components you wish to install (all/none/q)? [all]:
Select another component or enter q to exit from the menu.
To complete your installation, follow these steps:
Step 1 Remove the CD-ROM and store it in a safe place.
Step 2 The /tmp/cwsinstall.log file contains information for the CiscoView, TrafficDirector, and AtmDirector applications. Be sure to save this file to help you troubleshoot future installation problems.
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 file is named communities.dat and is located in the install directory/etc/cwsi directory. For more information, see Getting Started with CWSI Campus.
Start CWSI Campus using the following startup command:
# /opt/CSCOcwsi/bin/cwsi
Start the VlanDirector, AtmDirector, UserTracking, TrafficDirector, and CiscoView applications from the main CWSI Campus topology window.
If you have not installed a particular component (such as AtmDirector), that option is not available in the main CWSI Campus menu.
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 start the product again. This error does not affect product operation.
You can control the CWSI Campus processes using 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.
Before uninstalling CWSI Campus, close all CWSI Campus windows. To remove CWSI Campus, you must log in as root. Enter the uninstall command as follows:
# /opt/CSCOcwsi/bin/uninstall.sh
TrafficDirector and AtmDirector cannot be uninstalled separately from the CWSI campus package because they share components with CWSI Campus.
After you uninstall CWSI Campus, some directories and files might remain. If this is the 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 system. You should then be able to delete the remaining files.
The CiscoView installation on Solaris might fail if you do not install a Hewlett-Packard (HP) patch. This patch is required to install NNM 4.1 on Solaris 2.5.1 and must be installed before installing NNM 4.1. This patch is also required to run a license server on Solaris 2.5.1. If your license server is on a different machine, this patch is not necessary.
Both patches consist of a tar file and a text file describing the patch. To obtain a patch, follow these steps:
Step 1 Enter the following URL:
ftp://ovweb.external.hp.com/pub/cpe/patches/nnm/4.1x
Step 2 Click on the appropriate links to get to your software patch.
CiscoView installation uses the Solaris pkgadd utility. When pkgadd finishes installing CiscoView, the screen shows that the installation was successful but does not quit. Enter Q to exit the pkgadd utility.
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 CiscoView Incremental Installation Quick Reference, 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 by entering the following command:
# 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: Thu Sep 30 11:39:57 PDT 1999
Copyright 1989-1999©Cisco Systems Inc.