CiscoView CD Installation Instructions
for AIX

CiscoView is a device management application that provides dynamic status, statistics, and comprehensive configuration information for Cisco Systems' switched internetworking products. CiscoView allows you to display a graphical image of each network device, display configuration and performance information, and perform minor troubleshooting tasks.

You must be familiar with the Motif window management system and NetView for AIX to complete these tasks.

In addition to this booklet and the online help system, CiscoView documentation includes the CiscoView 4.0(1) on AIX Release Notes.

Table 1 explains when you would perform the procedures described in this booklet.

Preparing to Install CiscoView

Before you install and configure CiscoView, make sure the requirements in the following checklists are met:

• Hardware Requirements Checklist

• System Requirements Checklist

Hardware Requirements Checklist

CiscoView requires the following hardware:

• Any IBM RISC System/6000 workstation with Power architecture

• Color monitor

• PostScript-compatible printer (for printing window images)

• CD-ROM drive on the host system, or CD-ROM drive on an accessible remote host

System Requirements Checklist

CiscoView requires the following software products and conditions. Details and verification methods for each requirement are outlined in the paragraphs following this list.

• AIX--Version 4.1.5 or 4.2.

• NetView for AIX--Version 3.1 or 4.1 (optional). CiscoView can operate without NetView for AIX as described under "Starting CiscoView from the Command Line," so NetView for AIX is optional. Without NetView for AIX, however, you cannot graph information.

• System software--X Window System Version 11, Release 5; Motif Version 1, Release 2.

• RAM--32 MB or more.

• Hard disk space--1 MB in the / directory, 5 MB in /tmp directory, and 85 MB in the /usr directory.

• Cisco IOS software requirements--CiscoView requires the managed Cisco devices to be running specific versions of the Cisco IOS software. See the CiscoView 4.0(1) on AIX Release Note.

Verifying AIX Version

To ascertain the operating system level, perform the following steps:

1. Log in as root 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. Enter:
   

# oslevel

Output similar to the following appears:

4.2.0.0

This output indicates that AIX Version 4, Release 2 is installed.

Verifying System Software

If you will use CiscoView with NetView for AIX, verify the latest level installed on the host.

To do so, log in as root and enter:

# lslpp -l nv6000.base.obj

Output similar to the following appears:

Fileset Level State Description
-------------------------------------------------

Path: /usr/lib/objrepos   4.1.2.0 COMMITTED NetView for AIX Server-Base

This output indicates that NetView 4.1 is installed and committed on the AIX machine.

Verifying RAM Size

CiscoView requires a minimum of 32 MB of RAM. To find out how much RAM is available on your system, log in as root and enter the following command at the AIX prompt:

# lscfg | grep mem

Output similar to the following appears:

+ mem0        00-0B        32 MB Memory Card
+ mem1        00-0C        32 MB Memory Card

If your workstation does not have at least 32 MB of RAM, upgrade its memory.

Verifying Hard Disk Space

CiscoView requires 1 MB of disk space in the root directory, 85 MB of disk space in the /usr directory and 5 MB of disk space in /tmp directory.

To find out how much disk space is available on your system, enter the following at the command prompt:

% df -Ik

Output similar to the following appears:

Filesystem    Total KB    used    free %used Mounted on
/dev/hd4         16384   10008    6376   61% /
/dev/hd2       1003520  871324  132196   86% /usr
/dev/hd3         16384     732   15652    4% /tmp

The amount of disk space available in each filesystem appears in the free column. Note that 1,000 KB equals 1 MB. If you do not have sufficient space in the filesystem mounted on the /usr directory, you must create a filesystem mounted on the /usr/nms/CVapp directory.

To create a filesystem, we recommend that you contact a knowledgeable system administrator and use the System Management Interface
Tool (SMIT).

Removing Existing Version of CiscoView for AIX

If you are installing CiscoView for the first time, skip to the next section. If CiscoView is already installed, you must perform the following steps before installing the new version:

1. Set the NMSROOT environment variable with the following command:
   

# NMSROOT=/usr/nms; export NMSROOT

If you are using C shell, use the following command:

# setenv NMSROOT /usr/nms

1. Start SMIT by entering the following at the command prompt:
   

# smit

1. Select Communications Applications and Services.
   
   
2. Select Cisco Network-Management Applications for AIX.
   
   
3. Select CiscoView.
   
   
4. Select Maintenance.
   
   
5. Select Remove CiscoView for AIX Program.
   
   
6. Click OK in response to the "ARE YOU SURE?" prompt.
   

The uninstallation messages are also logged in /tmp/cv_deinstal. If CiscoView was successfully uninstalled, you can return to the main menu by selecting System Management in the Return To menu.

Installing and Configuring CiscoView

You use the System Management Interface Tool (SMIT), an IBM AIX system administration facility, to install and configure CiscoView from a local or remote CD-ROM drive. This section describes the graphical user interface (GUI) version of SMIT; you can use the ASCII version called SMITTY, if you prefer. Refer to your IBM documentation for more information about SMIT and SMITTY.

To install and configure CiscoView, you will do the following:

• Use SMIT to mount the CiscoView CD-ROM on the local filesystem from a local or remote CD-ROM drive

• Use SMIT to install CiscoView from CD-ROM

• Use SMIT to configure CiscoView

• Unmount the CD-ROM

When configuration is complete, go to the section, "Getting Started with CiscoView," for a sequence of steps for the first-time user.

Mounting from a Local or Remote CD-ROM Drive

You can install CiscoView from a CD-ROM drive attached to your system or from a drive connected to a remote host. You must first use SMIT to mount the local or remote device on the local AIX system.

Mounting from a Local CD-ROM Drive

To mount the CD-ROM on the filesystem from a local CD-ROM drive, use SMIT to perform the following steps on the local host:

1. Place the CD-ROM into its caddy, and insert it into the CD-ROM drive.
   
   
2. Log in as the root user.
   
   
3. Start SMIT by entering the following at the command prompt:
   

# smit

1. On SMIT's System Management menu, select Physical & Logical Storage.
   
   
2. Select File Systems.
   
   
3. Select Add/Change/Show Delete File Systems.
   
   
4. Select CDROM File Systems.
   
   
5. Select Add a CDROM File System.
   
   
6. Click the "DEVICE name" List button, and select the device name (such as /dev/cd0) from the list that appears.
   
   
7. Enter the name of a mount point directory (such as /cdrom) in the "Mount point" field.
   
   
8. Click OK and read the output.
   

   If you have already performed this procedure, or if another device is already mounted on the mount point, the process will fail.

   
   
   
9. Click Done.
   
   
10. Terminate SMIT by pressing F12 or by clicking Exit SMIT on the Exit menu.
    
    
11. Enter the following at the command prompt:
    

# smit mountfs

Mounting from a Remote CD-ROM Drive

To mount the CD-ROM on the local filesystem from a remote CD-ROM drive, first perform the following steps on the remote system:

1. Perform all steps exactly as listed under "Mounting from a Local CD-ROM Drive" on the remote system.
   
   
2. At the command prompt, enter smit mknfsexp.
   
   
3. Enter the "PATHNAME of directory to export" (such as /cdrom).
   
   
4. Use the arrow keys to change the "Mode to Export Directory" field to read-only.
   
   
5. Enter the appropriate information, if necessary, into any of the other fields.
   
   
6. Click OK, read the output, and then click Done.
   
   
7. Click Cancel to exit SMIT.
   

After working on the remote system, perform the following steps on the local system:

1. Log in as root.
   
   
2. Enter the following at the command prompt:
   

# mount \
remote_hostname:remote_exported_filesystem_name \ local_mount_point

For example, to mount the /cdrom remote filesystem from the machine zen to the local /cdrom directory, enter

# mount zen:/cdrom /cdrom

The CD-ROM is ready for software installation.

Installing CiscoView

Installation is the transfer of software from the distribution medium to the AIX system.

To install CiscoView from a mounted CD-ROM drive, perform the following steps:

# I_CDROM_PATH=/cdrom; export I_CDROM_PATH

# smit

1. On the System Management menu, select Software Installation and Maintenance.
   
   
2. On the next menu, select Install and Update Software.
   
   
3. If you have AIX 4.1.5, on the next menu, select Install and Update Selectable Software (Custom Install), then select Install Software Products at Latest Level, then select Install New Products at Latest Level. The "Install New Products at Latest Level" is displayed.
   

   If you have AIX 4.2, select Install and Update from LATEST Available Software. The "Install and Update from Latest Available Software" dialog box is displayed.

   
   
   
4. In the dialog box, click enter the directory where the CD-ROM is mounted (for example, /cdrom), or click List to see the local devices.
   
   
5. Click OK.
   

   The Install Software Products at Latest Available Level dialog box displays additional fields.

   
   
   
6. Click List next to the "SOFTWARE to install" field. After a brief delay, the Multi-Select List dialog box appears.
   
   
7. In the Multi-Select List dialog box, click the CiscoView module named CiscoView.base.obj.
   
   
8. Click OK.
   
   
9. In response to the "ARE YOU SURE?" prompt, click OK to install the module you just highlighted.
   

   While the animated man is running, SMIT installs CiscoView in the /usr/nms/CVapp directory, and CiscoView modifies SMIT to allow subsequent configuration and uninstallation of CiscoView.

   
   

   If the animated man raises his hands and SMIT displays OK, the process has succeeded. If the man falls down, installation has failed. If the reason for failure is not apparent, read the installation log file $HOME/smit.log and contact the Cisco Technical Assistance
   Center (TAC), if necessary.

   
   
   
10. Click Done, then Cancel.
    
    
11. If installation in Step 13 was successful, select Return To> System Management and go to the section "Configuring CiscoView."
    

    If the installation failed, terminate SMIT by pressing F12 or by clicking Exit SMIT on the Exit menu.

    
    

Starting SMIT

You need to start SMIT to perform any of the following tasks:

• Configuring CiscoView

• Performing Incremental Device Package Installation

• Performing CiscoView Maintenance Functions

• Performing CiscoView Maintenance Functions

To start SMIT when installation is complete, perform the following steps:

1. Start SMIT if you have not already done so:
   

# smit

1. On the initial SMIT menu, click Communications Applications and Services.
   
   
2. On the next menu, click Cisco Network Management Applications for AIX.
   
   
3. On the next menu, click CiscoView.
   

Configuring CiscoView

After installing CiscoView, follow these steps to configure the product.

1. Complete steps 1 through 4 in the procedure "Starting SMIT."
   
   
2. In the CiscoView dialog box, select Product Configuration.
   
   
3. In the Product Configuration dialog box, accept the defaults, or type values into each of the following fields.
   

   Product Group Name--Name of the AIX group which owns the CiscoView files. The default is bin. Click List to select one or more names from a list.

   
   

   Product User Name--AIX username of the individual assigned to the CiscoView files. The default is bin.

   
   

   Load MIBs Into NetView--The default is No. If you want to monitor MIBs through NetView, click List to select Yes.

   
   

   The procedure for loading MIBs takes a significant amount of time depending on the number of MIBs loaded.

   
   
   
4. Click OK, wait for the process to complete, and read the output.
   

If the animated man raises his hands and SMIT displays OK, the process has succeeded. If the man falls down, the configuration has failed. If the configuration fails, contact the TAC.

1. Click Done, then Cancel.
   
   
2. Terminate SMIT by pressing F12 or by clicking Exit SMIT on the Exit menu.
   

1. Unmount the CD by entering the following at the local or remote workstation where it is mounted:
   

# cd /
# umount /cdrom

AIX unmounts the CD-ROM device from the /cdrom directory.

1. Remove the CD-ROM caddy from the drive.
   

If your system does not have CiscoWorks installed, go to the section "Performing Incremental Device Package Installation." Otherwise, proceed to the section "Getting Started with CiscoView."

Performing Incremental Device Package Install Setup

To install devices incrementally on CiscoView 4.0(1) on AIX, use either of the following methods:

• Install from the CiscoView CD-ROM

  or

  
  

• Install from Cisco Connection Online (CCO). Instructions on how to download additional device support for CiscoView are on CCO and on the Cisco FTP server. The instructions are in the Software Image Library Enterprise Network Management section under CiscoView.

1. Set the NMSROOT environment variable with the following command:
   

# NMSROOT=/usr/nms/CVapp; export NMSROOT

If you are using C shell, use the following command:

# setenv NMSROOT /usr/nms/CVapp

1. Start SMIT if you have not already done so:
   

# smit

1. On the initial SMIT menu, click Communications Applications and Services.
   
   
2. On the next menu, click Cisco Network Management Applications for AIX.
   
   
3. On the next menu, click CiscoView.
   
   
4. On the CiscoView menu, click Device Package Install Setup.
   
   
5. In the field "Directory Containing Device Packages," enter the path where the device packages reside.
   
   
6. In the "Load MIBs into NetView" field, the default is No. If you want to load MIBs, click List.
   
   
7. If you performed Step 8, click Yes in the Single Select List dialog box to load MIBs into NetView.
   

1. Click OK, wait for the process to complete, and read the output.
   

   If the animated man raises his hands and SMIT displays OK, the process has succeeded. If the man falls down, incremental installation of the device packages has failed. If the incremental installation fails, contact a TAC representative.

   
   
   
2. Click Done, then Cancel.
   

The above procedure registers the directory containing the device packages and the options to load MIBs into NetView. After setting up the installation, refer to the next section for actually installing the device packages.

Performing Incremental Device Package Installation

If CiscoWorks and CiscoView are installed on your system, the device packages are installed at the same time. Follow the steps in this procedure if your system has CiscoView, but not CiscoWorks, and you want to install device package files that reside in a directory path on a system.

1. Set the NMSROOT environment variable with the following command:
   

# NMSROOT=/usr/nms/CVapp; export NMSROOT

If you are using C shell, use the following command:

# setenv NMSROOT /usr/nms/CVapp

1. Start SMIT if you have not already done so:
   

# smit

1. On the initial SMIT menu, click Communications Applications and Services.
   
   
2. On the next menu, click Cisco Network Management Applications for AIX.
   
   
3. On the next menu, click CiscoView.
   
   
4. In the CiscoView dialog box, click Device Package Installation.
   
   
5. In the field "Select Device Packages to Install" click List.
   
   
6. In the Multi-Select List dialog box, select the device packages you want to install and click OK.
   
   
7. Wait for the process to complete, and read the output.
   

   If the animated man raises his hands and SMIT displays OK, the process has succeeded. If the man falls down, the device package installation has failed. If the installation fails, contact the TAC.

   
   
   
8. Click Done, then Cancel.
   

Performing CiscoView Maintenance Functions

You can perform the following routine maintenance functions:

• Loading MIBs Into NetView

• Rebuilding All CiscoView Files

• Uninstalling CiscoView

Loading MIBs Into NetView

If you experience any corruption of your MIB database or the MIBs are not usable, you might want to consider reloading MIBs into NetView. The amount of time it takes to load MIBs into NetView depends on the number of MIBs being loaded.

To load MIBs into NetView:

1. Complete steps 1 through 4 in the procedure "Starting SMIT."
   
   
2. In the CiscoView dialog box, click Maintenance.
   
   
3. In the Maintenance dialog box, click Load all MIBs into NetView.
   
   
4. In response to the confirmation dialog box, click OK.
   

   While the animated man is running, the MIB files are being loaded. If the man raises his hands and SMIT displays OK, the MIB files are loaded. If the man falls down, loading of the MIB files has failed. If loading fails, contact the TAC.

   
   
   
5. Terminate SMIT by pressing F12 or by clicking Exit SMIT on the Exit menu.
   

Rebuilding All CiscoView Files

You can rebuild all CiscoView 4.0(1) on AIX configuration files if:

• You are not sure which device packages or files reside on your system.

• You wish to troubleshoot and rebuild existing CiscoView files because of suspected corruption or deletion of CiscoView configuration files.

To rebuild all CiscoView files, follow this procedure:

1. Complete steps 1 through 4 in the procedure "Starting SMIT."
   
   
2. In the CiscoView dialog box, click Maintenance.
   
   
3. In the Maintenance dialog box, click Rebuild all CiscoView config files.
   
   
4. In response to a confirmation dialog box, click OK.
   

   While the animated man is running, the CiscoView device package files are rebuilt. If the man raises his hands and SMIT displays OK, the rebuilding of configuration files has succeeded. If the man falls down, rebuilding has failed, and you should contact the TAC.

   
   
   
5. Terminate SMIT by pressing F12 or by clicking Exit SMIT on the Exit menu.
   

Uninstalling CiscoView

If you must uninstall the CiscoView product, perform these steps:

1. Log in as the root user.
   
   
2. Set the NMSROOT environment variable with the following command:
   

# NMSROOT=/usr/nms/CVapp; export NMSROOT

If you are using C shell, use the following command:

# setenv NMSROOT /usr/nms/CVapp

1. Start SMIT by entering the following at the command prompt:
   

# smit

1. On the System Management menu, select Communications Applications and Services.
   
   
2. On the next menu, select Cisco Network-Management Applications for AIX.
   
   
3. On the next menu, select CiscoView.
   
   
4. On the next menu, select Maintenance.
   
   
5. On the next menu, select Remove CiscoView for AIX program.
   
   
6. In response to the "ARE YOU SURE?" prompt, click OK.
   

   While the animated man is running, SMIT uninstalls the CiscoView product. If the man raises his hands and SMIT displays OK, the uninstallation process has succeeded. If the man falls down, uninstallation has failed, and you should contact the TAC.

   
   
   
7. Terminate SMIT by pressing F12 or by clicking Exit SMIT on the Exit menu.
   
   
8. If CiscoWorks is installed, you might have to unset the NMSROOT environment variable. Enter the following command:
   

$ unset NMSROOT

If you are using C shell, enter the following command:

% unsetenv NMSROOT

Both CiscoWorks and CiscoView use the same environment variable for locating specific files.

Getting Started with CiscoView

This section contains a two startup methods for the first-time user of CiscoView.

For details on CiscoView features, refer to the online help system.

Starting CiscoView from the Command Line

If your system does not have NetView for AIX, use this procedure.

To start CiscoView from the AIX command line and monitor a Cisco device, perform these steps.

1. Add /usr/nms/CVapp/bin to your PATH.
   
   
2. Start CiscoView by entering the following at the command line:
   

% nmcview

1. You must now specify a Cisco device to monitor.
   

   Select File> Open Device and enter a host name or IP address in the "Host" field, and then click OK.

   
   

   A graphical image of the device's back panel appears.

   
   

Starting CiscoView from NetView for AIX

To start CiscoView when NetView for AIX is installed on the host system, do the following:

1. Start NetView for AIX by entering the following at the command line:
   

% nv6000

1. Click the IP Internet symbol on NetView's root map. NetView displays all devices running IP, including Cisco devices.
   
   
2. To see an image of a device's control panels, highlight a Cisco device on the network map and select Monitor> CiscoView.
   

   If the CiscoView application is not visible on NetView's Monitor menu (and the configuration steps were successful), look for the ciscoview.reg file in the /usr/OV/registration/C directory. If the file is not there, contact the TAC.

   
   

Discovering New or Changed IP Devices

The default IP Internet map includes all IP devices connected to NetView when NetView is started. To discover newly added or modified IP devices, use NetView's Options> Manage Objects command as follows:

1. Click a device symbol on the default IP Internet map.
   
   
2. Select Options> Manage Objects. NetView displays a submap of the selected device's children that are reachable in one hop. Newly appearing children could have been added to the network or explicitly unmanaged by a previous user. All newly appearing children devices are now accessible by CiscoView.
   
   
3. Select File> Save Map As to save the database of devices you created.
   

   For detailed information on how to run Options> Manage Objects, refer to the online help.

   
   

Service and Support

This section describes how to contact Cisco Systems to order knowledge products and how to get service and support.

Cisco Connection Documentation

Cisco documentation and additional literature are available on a CD called Cisco Connection Documentation, Enterprise Series. The CD is updated and shipped monthly, so it might be more up to date than printed documentation. To order the Cisco Connection Documentation, Enterprise Series CD, contact your local sales representative or call Customer Service. The CD is available both as a single CD and as an annual subscription. You can also access Cisco technical documentation on the World Wide Web URL http://www.cisco.com.

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 cco-help@cisco.com. For additional information, contact cco-team@cisco.com.