CiscoView CD Installation Instructions

This instruction book provides information about installing and running CiscoView on your network management station. You can install CiscoView on a Solaris workstation, either as a standalone application or on top of the system network management platform.

CiscoView is a GUI-based device management software application that lets you access dynamic status, statistics, and comprehensive configuration information for Cisco Systems switch and internetworking products.

If you are installing CiscoView on a Network File System (NFS) mounted drive, you need root authority on the NFS partition.

System Requirements for CiscoView

This section provides CiscoView software and hardware requirements.

Software

• Solaris 2.4 or 2.5.1 operating system

• X11R4 or X11R5 windowing system

• The network management platform is optional but if HPOV is used, it must be HPOV 4.1 or HPOV 4.1.1

Hardware

• Sun SPARCstation color monitor

• 32 MB RAM

• 130 MB available hard drive space is required if you install all the device packages available for CiscoView. As you download device packages, space requirements increase. See the device's README file for the size of the installed file.

Mounting on Solaris

This section describes how to mount CiscoView CD on a Solaris 2.4 or 2.5.1 system. This section is a very general description. If you run into difficulty or if you have special requirements, consult your Sun documentation for more complete instructions.

Mounting from a Local CD-ROM Drive

Insert the CiscoView CD-ROM disk into the CD-ROM drive; then perform the following steps:

1. Become the superuser by entering su and the root password at the command prompt, or log in as root. The command prompt changes to the pound sign (#).
   
   
2. If the /cdrom directory does not already exist, enter the following command to create it:
   

# mkdir /cdrom

1. Mount the CD-ROM drive. The vold daemon process manages the CD-ROM device and performs the mounting. The CD-ROM may automatically mount onto the /cdrom/cdrom0 directory.
   

   If the CD-ROM is not mounted, mount it by entering:

   
   

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

If you get a mount error, refer to your Sun documentation for troubleshooting information.

1. To continue the installation, go to "Installing CiscoView."
   

Mounting from a Remote CD-ROM Drive

Insert the CiscoView CD-ROM disk into the CD-ROM drive; then perform the steps 1 through 6 on the remote machine.

1. Become the superuser by entering su and the root password at the command prompt, or log in as root. The command prompt changes to the pound sign (#).
   
   
2. If the /cdrom directory does not already exist, enter the following command to create it:
   

# mkdir /cdrom

1. Mount the CD-ROM drive. The vold daemon process manages the CD-ROM device and performs the mounting. The CD-ROM may automatically mount onto the /cdrom/cdrom0 directory.
   

   If the CD-ROM is not mounted, mount it by entering:

   
   

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

If you get a mount error, refer to your Sun documentation for troubleshooting information.

1. Edit the /etc/dfs/dfstab file and add the following line:
   

   share -F nfs -o ro /cdrom

   
   
   
2. Check to see if the machine is enabled as an NFS server by entering:
   

# ps -ef | egrep 'nfsd|mountd'

If your machine is enabled as an NFS server, you will see /usr/lib/nfs/nfsd and /usr/lib/nfs/mountd in the output of this command.

1. If the machine is not enabled as an NFS server, enable it by entering:
   

# /etc/init.d/nfs.server start

1. Go to the local machine.
   
   
2. Create a /cdrom directory, if one does not already exist, by entering the following command:
   

# mkdir -p /cdrom

1. Mount the CD-ROM drive by entering the following command:
   

# /usr/sbin/mount -r remote_machinename:/cdrom /cdrom

To continue the installation, go to "Installing CiscoView."

Installing CiscoView

This section describes how to install CiscoView. After you complete this entire section, go to "Loading Management Information Base (MIB)."

Starting an Installation

To install CiscoView on a Solaris platform, perform the following steps:

1. Change directories to the directory where you have mounted the CD, for example, /cdrom.
   
   
2. Enter
   

./setup.sh

To complete your installation, go to "Continuing the Installation."

Continuing the Installation

After you start the installation, a series of prompts appear. You can press Return to accept the default value (shown first in parentheses) for each prompt. This procedure does not describe each prompt that appears.

1. Respond to the copyright prompt:
   

Do you agree to the terms of this copyright (y/n)?

Enter y or n to continue the installation.

1. If you have an older version of CiscoView installed, you are prompted if it is OK to remove this older version. You cannot install CiscoView 4.0 if you have an older CiscoView installed.
   
   
2. The screen displays a series of prompts about the following variables:
   

• the installation location for CiscoView (you can change this when prompted),

• file owner and group,

• integration of CiscoView with a network management system, and

• device options and README files. You must select which devices you want to install from the list (the default is all devices).

  Enter all, 1, or press Return in response to each prompt to continue the installation.

  
  

---

Note You can press Ctrl-C at any time to terminate the installation. If you terminate before the installation is complete, you must perform the installation from the beginning.

---

1. The installation program displays a summary of your answers before you confirm the installation. Review this summary to check your responses to the installation prompts.
   

   If your responses are as you want them to be, enter y or press Return to perform the installation.

   
   

   As the installation proceeds, the file names are listed on the screen as they are installed. The engine takes approximately 7 to 15 minutes to install, depending on your system speed. Each CiscoView package takes approximately 3 to 5 minutes to install.

   
   
   
2. Check /tmp/ciscoinstall.log for errors. Save this file; it can help you with troubleshooting if you have problems with the installation.
   

   After the installation has been completed, messages similar to the following are shown on the screen:

   
   

INSTALLATION COMPLETE A complete logfile is located in /tmp/ciscoinstall.log. Update your PATH to include /opt/CSCOcv/bin.

1. To update your path
   

   For C Shell, source the CVinstall.cshrc file or add the following line to the .login (for each CiscoView user) or .cshrc file, log out and log back in:

   
   

source /opt/CSCOcv/etc/CVinstall.cshrc

For Bourne/Korn shell, source the CVinstall.sh file or add the following line to the .profile file, log out and log back in:

.	/opt/CSCOcv/etc/CVinstall.sh

Loading Management Information Base (MIB)

This section describes how to load CiscoView MIB files into HP OpenView.

HP Network Node Manager MIB Files

If you chose to integrate with HP OpenView during the CiscoView install, you were asked whether or not you wanted to load MIBs into HP OpenView at that time. If you chose not to load MIBs into HP OpenView, you can do it at any time after the install has completed.

Load the MIB files by entering:

# $NMSROOT/bin/cvinstall -f

Note that the system takes 15 to 20 minutes to load all MIB files.

To start CiscoView, go to "Starting CiscoView."

Starting CiscoView

This section describes how to start CiscoView from HP OpenView or from the UNIX command prompt on your system.

To start CiscoView from HP OpenView, go to "Starting CiscoView from HP OpenView." To start CiscoView from the UNIX command line, skip to "Starting CiscoView from the Command Line."

Starting CiscoView from HP OpenView

Before starting CiscoView from HP OpenView, launch HP OpenView by entering ovw on the UNIX command line.

To start CiscoView, select Monitor>CiscoView from the HP OpenView main window.

Starting CiscoView from the Command Line

Make sure that the PATH environment variable includes the path to the CiscoView executables.

From the UNIX command line, to start CiscoView without specifying a device, enter the following command at the system prompt:

% nmcview

From the UNIX command line, to start CiscoView and specify a device, enter the following at the system prompt:

% nmcview -host device_name -rd read_community_str

For example, the following command starts CiscoView and displays the device named "charlie" with the read community string "over."

% nmcview -host charlie -rd over

The CiscoView window is displayed with a graphical representation of the specified device (also referred to as a panel).

You are now finished with the installation. For more information on displaying devices in CiscoView, go to "Displaying a Device with CiscoView." If you are using CiscoView and need clarification on a particular feature, refer to the online help.

Displaying a Device with CiscoView

After you start CiscoView, you see the CiscoView main window. To display a device, follow these steps:

1. Select File>Open Device.
   

   The File>Open Device window is displayed.

   
   
   
2. Complete the fields in the File>Open Device window as follows:
   

   In the Host field, enter the host name or IP address of the device you want to display.

   
   

   In the Read Community field, enter the Read Community string specified by your network administrator (unless Public has already been specified).

   
   

   In the Write Community field, enter the Write Community string specified by your network administrator (unless Public has already been specified). The correct Write Community string allows you to change certain device settings.

   
   
   
3. Click OK to display the panel of the specified device.
   

To download additional devices, see the quick reference section, "Downloading Device Packages."

Removing Standalone CiscoView Files

To remove CiscoView, enter the following command:

# pkgrm CSCOcv

Downloading Device Packages

This section provides a quick reference to downloading device packages from CCO. If you do not have Internet access, skip this section (see "Additional Documentation"). For the detailed description of downloading devices, see the "Downloading Device Packages" chapter in the CiscoView Getting Started Guide.

---

Note You need to be root or the owner (as specified in the install), to perform the download.

---

1. Check the version number of CiscoView.
   

   Open CiscoView by entering nmcview from any directory on your workstation.

   
   

Select Help>About CiscoView. It should be Release 4.0 or later.

1. Close CiscoView by selecting File>Exit.
   
   
2. Create a permanent location for the cv_pkgs directory.
   

   Type mkdir /usr/nms/cv_pkgs to create a directory to store the cv_pkgs.

   
   

   Change to the /usr/nms/cv_pkgs directory by typing:

   
   

   cd/usr/nms/cv_pkgs

   
   
   
3. Access CCO.
   

   You can access CCO as a guest or as a registered user.

   
   

   To be granted special file access as a guest do the following:

   
   

   Call TAC at 1-800-553-2447 or 1-408-526-7209, state the product you are downloading, and you are transferred to the appropriate person to obtain your special access code.

   
   

   Open your Web browser and enter:

   
   

   http://www.cisco.com/public/library

   
   

   Enter your special access code in the Other Software Products/Special Files section.

   
   

   Select the device tar file and a download option.

   
   

   Reenter your password, if required.

   
   

   Save the device file in the cv_pkgs directory on your system.

   
   

   Go to Step 6, "Untar the Device Tar File."

   
   

   To access as a registered user do the following:

   
   

   Open your Web browser and access the Software Center by typing:

   
   

   http://www.cisco.com/kobayashi/sw-center/

   
   

   At the prompt, enter your CCO user ID and password.

   
   

   Proceed to Step 5, "Download the Device Tar File into the cv_pkgs Directory."

   
   
   
4. Download the device tar file into the cv_pkgs directory.
   

   There are two methods for downloading, downloading from CCO and downloading from FTP. For information on downloading from FTP, see the Software Center Web page or the CiscoView Getting Started Guide.

   
   

   In the Software Center, CiscoSoftware Products, Network Management (Mgmt) Products section, select the CiscoView Upgrade Planner pointer to the CiscoView packages. Packages are available from the "Download CiscoView Software Updates" section.

   
   

   To review the package README, click on the README filename and select a download option.

   
   

   To select a device tar file, click on the device filename and select a download option.

   
   

   Reenter your password, if required.

   
   

   If required, click Save File or File>Save As, depending on the browser you are using. If a filter window appears, enter the complete destination pathname for the downloaded device.

   
   

   If a filter window appears, enter the complete destination pathname in the Selection section of the filter window for the downloaded device, for example, /usr/nms/cv_pkgs/device_name.

   
   

   Close the Web browser.

   
   

   Go to Step 6, "Untar the device tar file."

   
   
   
5. Untar the device tar file.
   

   Enter tar -xvf file_name in the cv_pkgs directory, where file_name is the name of your device package.

   
   
   
6. Add the package file to CiscoView.
   

   Check the environment variable by entering env. It should include NMSROOT.

   
   

   If NMSROOT does not appear, set it by typing:

   
   

   setenv NMSROOT install_directory

   
   

   where install_directory is the name of the directory where CiscoView is installed, /opt/CSCOcv.

   
   

   Enter su root to login as root.

   
   

   Enter

   
   

   $NMSROOT/cvinstall /usr/nms/cv_pkgs/device_name.pkg

   
   

   to add the package file to CiscoView in the cv_pkgs directory.

   
   

The downloading is complete. If there are any problems, check the cvinstall.log file in your install directory or see the CiscoView Getting Started Guide for more detail.

Additional Documentation

The CiscoView Getting Started Guide contains information on the following:

• Performing Incremental Device Support: see "Downloading to a UNIX Workstation" in the chapter, "Downloading Device Packages."

The Cisco Network Management Support CD-ROM contains the latest Cisco network management device and application support files. These files are organized into product packages and provide up-to-date management support for the latest Cisco devices for all supported platforms. For more information, refer to your Product Catalog.

• Uninstalling CiscoView: see "Removing CiscoView" in the "Downloading Device Packages" chapter.

Troubleshooting

If you cannot open the specified device in CiscoView, you receive a message indicating that the device is unmanageable. This message indicates one of the following conditions:

• The SNMP server is not set in the device. You can still ping the device from the management station.

• You have entered an incorrect community string in the File>Open Device window.

• The management station cannot reach the device and cannot successfully ping the device.

• Check your device package and compare the date to the CCO device package version. Upgrade your device package to the latest version, if required.

Cisco Connection Online

Cisco Connection Online (CCO) is Cisco Systems' primary, real-time support channel. Maintenance customers and partners can self-register on CCO to obtain additional information and services.

Available 24 hours a day, 7 days a week, CCO provides a wealth of standard and value-added services to Cisco's customers and business partners. CCO services include product information, product documentation, software updates, release notes, technical tips, the Bug Navigator, configuration notes, brochures, descriptions of service offerings, and download access to public and authorized files.

CCO serves a wide variety of users through two interfaces that are updated and enhanced simultaneously: a character-based version and a multimedia version that resides on the World Wide Web (WWW). The character-based CCO supports Zmodem, Kermit, Xmodem, FTP, and Internet e-mail, and it is excellent for quick access to information over lower bandwidths. The WWW version of CCO provides richly formatted documents with photographs, figures, graphics, and video, as well as hyperlinks to related information.

You can access CCO in the following ways:

• WWW: http://www.cisco.com

• WWW: http://www-europe.cisco.com

• WWW: http://www-china.cisco.com

• Telnet: cco.cisco.com

• Modem: From North America, 408 526-8070; from Europe, 33 1 64 46 40 82. Use the following terminal settings: VT100 emulation; databits: 8; parity: none; stop bits: 1; and connection rates up to 28.8 kbps.

For a copy of CCO's Frequently Asked Questions (FAQ), contact ccohelp@cisco.com. For additional information, contact cco-team@cisco.com.

If you are a network administrator and need personal technical assistance with a Cisco product that is under warranty or covered by a maintenance contract, contact Cisco's Technical Assistance Center (TAC) at 800 553-2447, 408 526-7209, or tac@cisco.com. To obtain general information about Cisco Systems, Cisco products, or upgrades, contact 800 553-6387, 408 526-7208, or cs-rep@cisco.com