Validating CiscoWorks Installation

To validate the CiscoWorks installation and configuration, you must edit the .cshrc file on your system. Follow the procedures in this chapter to complete the validation of your CiscoWorks installation.

Validation Process Overview

This section briefly summarizes the steps you should follow to complete the CiscoWorks installation and configuration and to validate the installation. These steps are explained in detail following:

1. Define environment variables and the search paths.
   
   
2. Start the SNM Console and view CiscoWorks applications.
   
   
3. Display the CiscoWorks processes by using the Process Manager window.
   

Defining Environment Variables and Search Paths

To use SNM, CiscoWorks, and Sybase, you must define the appropriate environment variables and paths in your .cshrc file.

Environment variables define how your particular system is set up, such as directory paths that specify the location of files (either manual pages or software). The environment variables and paths are explained in in Table 4-1.

Environment Variables and Directory Paths

Environment Variable or Path	Explanation
SNMHOME	Refers to the directory path for SNM software. If you do not already have the environment variable SNMHOME set for SunNet Manager, you must define it.
NMSROOT	Refers to the directory /usr/nms where the CiscoWorks software was installed. 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	Refers to the directory path $NSMROOT/ sybase. In this case, the Sybase software was installed in the /usr/nms/sybase directory. The SYBASE variable refers to the NMSROOT variable and the sybase directory following it.
PATH	Refers to the directory path for $SNMHOME/bin, $NMSROOT/bin, $NMSROOT/etc, and $SYBASE/bin. The path should be specified for SNM, CiscoWorks, and Sybase.
MANPATH	Refers to the directory path for the CiscoWorks manual pages.
DISPLAY	Refers to the environment variable for the monitor on which CiscoWorks displays. The default is :0 or <hostname>:0

Editing the .cshrc File

The addition of environment variables and path names to your .cshrc file will be applicable only to your login account. If you have other system administrators or network managers who need access to CiscoWorks, edit their .cshrc files and add the information specified in the following procedure.

The following steps describe how to add the appropriate environment variables and path names to the .cshrc file or the .login file. If you installed SNM, CiscoWorks, and Sybase software in directories other than the default directories, substitute the correct directory paths.

Step 1 Log in as a superuser.

Step 2 Using a text editor such as vi, access the .cshrc file on your system.

This script resides in your home directory.

Step 3 Add the following lines to the .cshrc file, making sure you enter the uppercase and lowercase characters as shown. Substitute the appropriate directory path for each environment variable, if necessary. Note that the set path line should include any existing set path definitions in the file.

#Set environment variables for SNM, CiscoWorks, and Sybase
setenv SNMHOME /usr/snm
setenv NMSROOT /usr/nms
setenv SYBASE $NMSROOT/sybase
#Set path for SNM
set path = ($path $SNMHOME/bin)
#Set path for CiscoWorks and Sybase executables
set path = ($path $NMSROOT/bin $NMSROOT/etc $SYBASE/bin)
#Set path for CiscoWorks man pages
if (!($?MANPATH)) setenv MANPATH /usr/man
setenv MANPATH "$MANPATH":"$NMSROOT"/man

Step 4 At the UNIX prompt, enter the following command to ensure that the changes made to the .cshrc file become a part of your active system environment.

hostname% source .cshrc

Verifying Changes to the .cshrc File

After you edit the .cshrc file, verify that the changes you made are active. Enter the following command at the UNIX prompt to display the edited .cshrc file:

hostname% printenv | more

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

Displaying CiscoWorks Applications

To verify the CiscoWorks installation and configuration, access SNM and display the CiscoWorks applications.

For detailed information on how to start the SNM Console, refer to the SunNet Manager 2.0 User's Guide.

---

Note The -i option in the command starts the SNM Console and removes the run-time database that you created previously. If you already created a run-time database in SNM and wish to preserve it, do not use the -i option, so you can later load your database file from the Console.

---

Upgrading from a Previous Version of CiscoWorks

If you are upgrading from a previous version of CiscoWorks, perform the following steps to view CiscoWorks applications:

Step 1 Save your network map.

Display your existing network map then select Save from the File menu of the SNM Console.

Step 2 Enter the following command at the UNIX prompt:

hostname % snm -i

Step 3 When the SNM Console window appears, reload your network map.

Select Load from the File menu.

Step 4 Select the Tools menu to display the Tools options.

Installing Ciscoworks for the First Time

If you are installing CiscoWorks for the first time, perform the following steps to view CiscoWorks applications.

Step 1 Enter the following command at the UNIX prompt:

hostname % snm -i

Step 2 Select the Tools menu to display the Tools options.

Figure 4-1 shows the Tools menu with both SNM tools and CiscoWorks applications. CiscoWorks applications are prefixed by CW.

Figure 4-1: Tools Menu with CiscoWorks Applications

If the Tools menu does not contain the CiscoWorks applications, perform the getagents procedure for SNM as explained in the SNM documentation. Then restart SNM and check the Tools menu again. You may not be able to use all applications until you complete the rest of the procedures in this chapter.

Viewing CiscoWorks Processes

Use the CiscoWorks Process Manager application to select different types of CiscoWorks processes or daemons. A daemon is a process that performs a specific function for the system. Each CiscoWorks process performs specific functions. For example, the Device Monitor daemon polls for information about devices on your network and forwards this information to SNM.

The Process Manager monitors the following seven CiscoWorks daemon processes: nmlogd, nmpolld, nmeventd, nmdevmond, syslogd, TACACS Authentication Server, and dataserver. Figure 4-2 shows the Process Manager window with the processes.

Figure 4-2: Process Manager Window

By default, the first four CiscoWorks processes in the Process Manager window are running whenever you reboot your system. These processes can run continuously, even if SunNet Manager is not running on your system. To verify that the appropriate CiscoWorks processes are running, you must access the Process Manager window.

To invoke the Process Manager application, perform the following steps:

Step 1 From the Tools menu, select Process Mgr.

The Process Manager window appears.

Step 2 To start a process, click on the On button next to it.

If the process starts successfully, the On button will appear dark. If an error message indicates that the process could not be started, check your SNM Console window for an error message.

Step 3 To exit the Process Manager application, select Exit from the File menu.

After validating the CiscoWorks installation as described in this chapter, proceed to Chapter 5, "Learning to Use CiscoWorks," to learn some simple tasks associated with CiscoWorks.