Validating Cis coWorks Installation

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

Vali dation Process Overview

The following main steps are used to validate a CiscoWorks installation:

Verify the environment variables and search paths in your .cshrc, .kshrc, or .profile file.
Start NetView for AIX and display CiscoWorks applications.
Customize CiscoWorks, such as colors and fonts (optional).
Use SMIT to display and control the CiscoWorks daemons and Sybase 10.0.2 dataserver (if necessary).

Verifying Environment Variables and Search Paths

To use NetView for AIX, CiscoWorks, and Sybase, you must verify that the appropriate environment variables and paths are set in your .cshrc, .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.

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

**Table 3-1: Environment V ariables and Directory Paths**
Environment Variable	Explanation
NMSROOT	Refers to the directory `/usr/nms` where the CiscoWorks software is installed.
SYBASE	Refers to the directory path where Sybase is located. The default is `$NMSROOT/sybase102`, which usually equates to `/usr/nms/sybase102.`
LANG	Must be `En_US.`
HHHOME	Refers to the directory where online help is stored. Must be `$NMSROOT/hyperhelp.`
HHPATH	Refers to the directory where the hypertext help program resides. Must be `$NMSROOT/hyperhelp/bin.`
PATH	Must include the directories /`usr/OV/bin`, `$NMSROOT/bin`, `$NMSROOT/etc`, and `$SYBASE/bin` (the directories for NetView for AIX, CiscoWorks, and Sybase).
MANPATH	Refers to the directory path for finding man pages. It should include `$NMSROOT/man`.
DISPLAY	Refers to the X11 display with which CiscoWorks operates. The default is `:0` or `hostname:0`.0.
DSQUERY	Refers to the Sybase data server to be used. The default is `CW_SYBASE.`
CW_POLLDB	Refers to the default CiscoWorks polling database name `polldb.`
CW_NMSDB	Refers to the default CiscoWorks network management database `nms.`
BACKUP_SERVER_NAME	Refers to the default Sybase backup server `CW_BACKUP_SERVER.`
BACKUP_SERVER_HOME	Refers to the default directory of the backup server, `$NMSROOT/sybase102/install.`
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	Enables Sybase ESQR to operate. The default is `/usr/nms/bin/syb/workbench/bin/vvtermcap.`

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

Because the environment variables set in a user's .kshrc or .cshrc or .profile files apply to that user only, the .cshrc or .kshrc or .profile file of every CiscoWorks user must be modified to include the variables . The following steps describe a method of concatenating a script of commands from the /usr/nms/install directory to each .cshrc or .kshrc or .profile file. When executed in the .cshrc or .kshrc or .profile file, the commands establish all required environment variables and paths for the user.

Step 1 Log in as the superuser.

For details, see "Becoming the Superuser" in the chapter "Installing and Configuring CiscoWorks."

Step 2 For a user using the K shell, append /usr/nms/install/install.kshrc to the end of the .kshrc file by entering the following command:

hostname# cat /usr/nms/install/install.kshrc >> .kshrc

For a user using the C shell, append /usr/nms/install/install.cshrc to the end of the .cshrc file by entering the following command:

hostname# cat /usr/nms/install/install.cshrc >> .cshrc

For a user using the Bourne shell, append /usr/nms/install/install.shrc to the end of the .profile file by entering the following command:

hostname# cat /usr/nms/install/install.shrc >> .profile

Step 3 Verify that the lines were added to the appropriate file by entering:

hostname# cat .kshrc

hostname# cat .cshrc

hostname# cat .profile

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

hostname% source .cshrc

For a user 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:

hostname% . .kshrc

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

hostname% . .profile

Step 5 Verify that the changes to the .cshrc or .kshrc file are active by viewing all active environment variables as follows:

For the C shell, enter the following:

hostname% printenv | more

For the K or Bourne shell, enter the following:

hostname% set | more

Note that the environment variables for NMSROOT and SYBASE are displayed. In addition, the paths are defined for CiscoWorks and Sybase executables and the CiscoWorks manual pages, as well as other system variables.

Note Individual users can edit their own .cshrc or .kshrc or .profile files by logging in with their user IDs and following the previous steps.

Starting CiscoWorks Applications

After proper installation and configuration, CiscoWorks applications are integrated into the structure of NetView for AIX. To verify the CiscoWorks installation and configuration, access NetView for AIX and display the menu of CiscoWorks applications as follows:

Step 1 Enter the following command at the command prompt to start NetView for AIX:

hostname% nv6000

The NetView for AIX default network map, Root, appears; Root displays all devices running the Internet Protocol (IP), including Cisco devices.

Step 2 Display CiscoWorks menu items under the NetView for AIX menus shown in Table 3-2.

**Table 3-2: CiscoWorks Applications under NetView for AIX**
NetView for AIX Menu	CiscoWorks Application	CiscoWorks Application Enabled When
Monitor	Description: Contacts CW - Health Monitor... CW - Environmental Monitor... CW - Real-Time Graphs... CW - Device Polling... CW - Polling Summary...	One Cisco device is selected on the network map. One Cisco device is selected on the network map. On the network map, one Cisco device is selected that contains an Environmental Monitor Card. One Cisco device is selected on the network map. Always enabled. Always enabled.
Administer> CW - System Administer> CW - Devices Administer> CW - Software Images Administer> CW - Security	Process Mgr... Global Command Mgr... Global Command Scheduler... Device Mgmt... Configuration Mgr... Configuration Snap-In Mgr... AutoInstall Mgr... Software Library Mgr... Software Inventory Mgr... Device Software Mgr... SA Password... Security Mgr... Domain Mgr... TACACS Mgr...	Always enabled. Always enabled. Always enabled. Always enabled. Always enabled. Always enabled. Always enabled. Always enabled. Always enabled. On the network map, one Cisco device is selected that contains Flash memory. Always enabled. Always enabled. Always enabled. Always enabled.
Diagnose	Network Conn.> CW - Path Tool CW - Show Commands...	Always enabled. One Cisco device is selected on the network map.
Misc	Sync w/Sybase... Sync Selected... CW - Login... CW - Logout... CW - ToolBox Sybase ESQR...	Always enabled. Always enabled. Always enabled. Always enabled. Always enabled. Always enabled.
Help	CW - Application Help	Always enabled.

If no CiscoWorks applications are visible under the NetView for AIX menus, the installation might have been unsuccessful. Look for the CiscoWorks file in the /usr/OV/registration/C directory. If the file is not there, contact a TAC representative.

After verifying that CiscoWorks applications appear in the NetView for AIX menus, see "Viewing CiscoWorks Daemons and the Sybase Dataserver," or go straight to the chapter "Getting Started on NetView."

Viewing CiscoWorks Daemons and the Sybase Dataserver

Perform these steps only when you suspect a problem with the operation of the CiscoWorks applications.

A daemon is a process that performs a specific background function on behalf of an application. CiscoWorks 4.0 has several daemons. SMIT offers control of the following CiscoWorks 4.0 daemon processes:

Log daemon
Polling daemon
Event Logger daemon
Syslog daemon
TACACS Authentication Server daemon
Sybase 10.0.2 Server daemon

Perform the following steps to display the status of, start, or stop CiscoWorks daemons:

Step 1 Log in as the superuser.

For details, see "Becoming the Superuser" in the chapter "Installing and Configuring CiscoWorks."

Step 2 Start SMIT:

hostname# smit

Step 3 On the main SMIT menu, select Communications Applications and Services.

Step 4 On the next menu, select Cisco Network Management Applications for AIX.

Step 5 On the next menu, select CiscoWorks 4.0.

Step 6 On the CiscoWorks 4.0 menu, select Control.

The Control menu appears.

Step 7 Click any one of the following choices:

Display CiscoWorks 4.0 daemon status--To find out whether each of the daemons are running.
Restart all CiscoWorks 4.0 daemons--Always stop the daemons before restarting them.
Stop all Running CiscoWorks 4.0 daemons--Before restarting the daemons.
Start / Stop / Status Sybase 10 dataserver for CiscoWorks--To access a dialog that lets you display the status of, stop, or start the Sybase dataserver.

: When you attempt to stop the dataserver, SMIT prompts you for the Sybase system administrator's password, which is sybasesa until you log directly onto the Sybase server and change it.

When you select Display, Restart, or Stop, SMIT performs the requested action and presents a separate screen to display the results. To dismiss the results screen, click Done and you return to the Daemon Control dialog.

Step 8 Terminate SMIT by pressing F12 or by selecting Exit SMIT on the Exit menu.

Table of Contents