cc/td/doc/product/rtrmgmt/cwparent/cw40
hometocprevnextglossaryfeedbacksearchhelp
PDF

Table of Contents

Validating CiscoWorks Installation

Validating CiscoWorks Installation

To validate CiscoWorks installation and configuration, you must edit the .cshrc or .kshrc or .profile file on your system. This chapter describes how to complete the validation of your CiscoWorks installation.

Validation Process Overview

Follow these main steps to validate CiscoWorks installation:


  1. Verify the environment variables and search paths in your .cshrc or .kshrc or .profile file.

  2. Start your network management platform (NMP) software and display CiscoWorks applications.

  3. Use the Process Manager window to display the CiscoWorks processes.

Verifying Environment Variables and Search Paths

To use your network management platform software, CiscoWorks and Sybase, you must verify that the appropriate environment variables and paths are set in your install.cshrc or .cshrc file or .kshrc or .profile file.


Note Common desktop environment (CDE) users should edit the .dtprofile file instead of the .profile file. For information on editing your .dtprofile file, refer to your CDE documentation.

Environment variables define how your particular system is set up, such as how directory paths locate specific files. Table 3-1 explains the environment variables and paths.


Table 3-1: Environment Variables and Directory Paths
Environment
Variable or Path
Explanation
NMSROOT CiscoWorks is installed in the directory /opt/CSCOcwh. If the software was installed in a different directory, substitute the appropriate directory path to ensure a correct definition of the NMSROOT environment variable.
SYBASE Directory path where Sybase is located. If you select the default, the Sybase software is installed in the directory /opt/CSCOsyb. The SYBASE variable refers to the NMSROOT variable and the Sybase directory following it.
CW_NMSDB Name of nms database. Default for the database is nms.
CW_POLLDB Name of the poll database. Default for the database is polldb.
PATH Directory path for your NMS software and various CiscoWorks directories (including $NMSROOT/bin, $NMSROOT/etc, and $SYBASE/bin). The path should be specified to include HP OpenView, CiscoWorks, and Sybase.
MANPATH Directory path for the CiscoWorks manual pages.
HHHOME Home directory where the CiscoWorks online help system is located.
HHPATH Directory path for the CiscoWorks online help system files.
XLIBI18N_PATH Library path for HyperHelp. The default is $HHHOME/lib.
TCL_LIBRARY Directory path for the TCL libraries.
TK_LIBRARY Directory path for the TK libraries.
DSQUERY Sybase server name. The default is CW_SYBASE.
ESQRDIR Directory path of the Easy SQL report generator (Sybase ESQR).The default is $NMSROOT/bin/syb/workbench/bin.
SQRDIR Directory path of the Easy SQL report generator (Sybase ESQR).The default is $NMSROOT/bin/syb/workbench/bin.

Verifying Changes to the .cshrc File

The installation and configuration scripts make the following changes to the $NMSROOT/etc/install.cshrc file:

Different steps are required to verify the .cshrc file changes depending on which shell you use. If you use a C shell, refer to the instructions in the ".cshrc File Changes Using the C Shell" section. If you are using a Bourne or Korn shell, refer to the instructions in the ".profile File Changes Using the Bourne or Korn Shell" section.

.cshrc File Changes Using the C Shell

Verify that the correct changes were made to the install.cshrc file by performing the following steps:

Step 1 Execute the commands in the new install.cshrc file by entering the following command:

Note the install.cshrc file is in the /opt/CSCOcwh/etc default directory.


Step 2 Display the new values of the environment variables defined for your login account by entering the following command:

The values on your screen will be different from those displayed above if you specify path names other than the defaults during installation and configuration.


Step 3 To copy the install.cshrc file into your existing .cshrc file, open both files with a text editor and copy the text from the install.cshrc file into the .cshrc file. Save the file and exit the editor when finished.

.profile File Changes Using the Bourne or Korn Shell

If you are using the Bourne shell, you cannot use the source command to run the install.cshrc file. You must manually change the .profile file to set the appropriate options.

Time Saver To change your default shell to the Bourne or Korn shell, enter the following: chsh username /bin/sh or chsh username /bin/ksh.

To make the correct changes to the install.cshrc file or add those changes to your existing .profile file, perform the following steps:

Step 1 Check the presence of the Bourne or Korn shell equivalent file install.shrc in the directory /opt/CSCOcwh/etc/ as follows:

Step 2 To copy the install.shrc into your existing .profile or .kshrc file, open your .profile or .kshrc file and copy the text from the install.shrc file into the .profile file or .kshrc file.

Step 3 Save the file and exit the editor when you are finished.

Step 4 For users using the K shell, enter the following command to ensure that the changes made to the .kshrc file become a part of the user's active environment:

For users using the Bourne shell, enter the following command to ensure that the changes made to the .profile file become part of the user's active environment:


Starting CiscoWorks Applications

Once you install and configure CiscoWorks and verify the install.cshrc file, you can start your network management platform software and display CiscoWorks applications. After you start CiscoWorks, you can verify that the appropriate CiscoWorks processes are running by opening the Process Manager window.

The Process Manager window tracks several different types of CiscoWorks processes or daemons. A daemon is a process that performs a specific function for the system.

Refer to your platform-specific instructions to start the CiscoWorks applications.

Displaying CiscoWorks Applications on HP OpenView

To start HP OpenView and CiscoWorks, perform the following steps:

Step 1 To start HP OpenView, enter the following command:

% ovw
% /opt/OV/bin/ovw


The HP OpenView default network map (shown in Figure 3-1) appears.



Figure 3-1: CiscoWorks Menu Options within HP OpenView

CiscoWorks applications are distributed among the HP OpenView menus. CiscoWorks menu items begin with CW.


Step 2 Select Administer>CW - System>CW - Process Mgr.

The Process Manager window (shown in Figure 3-2) opens.



Figure 3-2: Process Manager Window

Step 3 To start a process, click the On checkbox next to it.

If the process starts successfully, the On checkbox is enabled.


Step 4 To exit the Process Manager application, select File>Exit.

After validating CiscoWorks installation as described in this chapter, proceed to the section "Learning to Use CiscoWorks" in the "Getting Started on HP OpenView" chapter to learn some simple tasks associated with CiscoWorks.

hometocprevnextglossaryfeedbacksearchhelp
Copyright 1989-1997 © Cisco Systems Inc.