Validating CiscoWorks Installation

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

Vali dation Process Overview

Follow these main steps to validate CiscoWorks installation:

Verify the environment variables and search paths in your .cshrc or .kshrc or .profile file.
Start your network management platform (NMP) software and display CiscoWorks applications.
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 file 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`	On Solaris, 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. The default is 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 NMS software, 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.
VVTERMCAP	Used by ESQR to handle the terminal I/O mappings. The default is `$NMSROOT/bin/syb/workbench/bin/vvtermcap`.

Verifying Changes to the .cshrc or .kshrc or .profile File

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

Set the values of the $NMSROOT, $MANPATH, $SYBASE, and other appropriate environment variables.
Set the path for the CiscoWorks and Sybase executable files.
Set the path for the CiscoWorks manual pages.

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 shell, refer to the instructions in the ".profile or .kshrc 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:

% source /opt/CSCOcwh/etc/install.cshrc

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:

% printenv | more

The values of the environment variables appear on screen. Check that values similar to the following are set:

NMSROOT =/opt/CSCOcwh SYBASE =/opt/CSCOsyb ESQRDIR= /opt/CSCOcwh/bin/syb/workbench/bin SQRDIR= /opt/CSCOcwh/bin/syb/workbench/bin VVTERMCAP =/opt/CSCOcwh/bin/vvtermcap TCL_LIBRARY= /opt/CSCOcwh/contrib/tcltk/lib/tcl TK_LIBRARY =/opt/CSCOcwh/contrib/tcltk/lib/tk HHHOME= /opt/CSCOcwh/hyperhelp HHPATH= /opt/CSCOcwh/hyperhelp/bin

XLIBI18N_PATH= /opt/CSCOcwh/hyperhelp/lib MANPATH =/usr/man:/opt/CSCOcwh/man BACKUP_SERVER_HOME =/opt/CSCOcwh/sybase BACKUP_SERVER_NAME =CW_BACKUP_SERVER CW_NMSDB= nms CW_POLLDB =polldb DSQUERY= CW_SYBASE

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 or .kshrc File Changes Using the Bourne or Korn Shell

If you are using the Bourne or Korn 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 enter: chsh username /bin/ksh.

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

Step 1 Check for the presence of the Bourne or Korn shell equivalent file install.shrc in the directory /opt/CSCOcws/etc by entering the following command:

ls /opt/CSCOcws/etc/install.shrc

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 or .kshrc file.

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

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

hostname# ..kshrc

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:

hostname# ..profile

Starting CiscoWorks Applicati ons

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

CiscoWorks is fully integrated with HP OpenView, so you can access CiscoWorks applications directly from the main window of the HP OpenView platform (as shown in Figure 3-1).

Figure 3-1: HP OpenView Main Window

To display the main window of the HP Open View platform, enter the following:

% ovw

Displaying CiscoWorks Applications on Solstice Site/SunNet/Domain Manager

This section briefly discusses how to start the Site/SunNet/Domain Manager Console to run CiscoWorks. For a more detailed description and options, refer to the Solstice Site/SunNet/Domain Manager User's Guide.

To access Site/SunNet/Domain Manager and CiscoWorks, perform the following steps:

Step 1 To start the Site/SunNet/Domain Manager Console initially (when there is no database present) or when you want to bring up the last map file, enter the following:

% snm

If problems occur, your PATH environment variable may not include a path to Site/SunNet/Domain Manager executables. You can enter a fully qualified path. In the following example, /opt/SUNWconn/bin is the path to the executables:

% /opt/SUNWconn/bin

Step 2 Load a database map file (in ASCII format) into the Site/SunNet/Domain Manager Console by selecting File>Load.

Step 3 To start the Site/SunNet/Domain Manager Console using other options than above, enter one of the following:

To start Site/SunNet/Domain Manager without a database map file (which clears the run-time database), enter the following:

: % snm -i

Caution The -i option in the command starts the Site/SunNet/Domain Manager Console and removes the current run-time database. If you have a run-time database and want to preserve it, do not use the -i option, or you will lose this data.

To start Site/SunNet/Domain Manager with a specified map file (map_name is an ASCII database file), enter the following:

: % snm map_name

For more information on starting the Site/SunNet/Domain Manager Console or troubleshooting startup problems, refer to the Solstice Site/SunNet/Domain Manager User's Guide.

Step 4 On Site/SunNet/Domain Manager, you can start CiscoWorks applications from either the Tools menu or the Glyphs menu. Figure 3-2 shows the CiscoWorks applications available on the Tools menu.

Figure 3-2: CiscoWorks Applications on the Site/SunNet/Domain Manager Tools Menu

Site/SunNet/Domain Manager has a menu that provides access to the CiscoWorks applications associated with a specific device. The menu becomes available when you click on a device icon.

To display the menu, select an icon and press the MENU mouse button. On Site/SunNet/Domain Manager, icons are called glyphs, and the menu (shown in Figure 3-3) is called the Glyph menu.

You can then select the Tools option from the menu to see a list of the applications associated with that device. From this menu, use the MENU mouse button to select the appropriate application to run.

Figure 3-3: CiscoWorks Applications on the Glyph Menu

Displaying CiscoWorks Applications on Enterprise Manager

This section briefly explains how to start the EM Viewer to run CiscoWorks. For a more detailed description and options, refer to the Solstice Enterprise Manager Reference Manual.

Perform the following steps to start CiscoWorks on the EM Viewer:

Step 1 Enter the following command:

% em_services -r

Step 2 Bring up the Application Launcher by entering the following command:

% /opt/SUNWconn/em/bin/em &

Step 3 Launch the EM Viewer from the Application Launcher window.

Step 4 On EM, you can start CiscoWorks applications from either the Tools menu or the Glyphs menu. Figure 3-4 shows the CiscoWorks applications available on the Tools menu.