Error Messages

This appendix lists common error messages associated with CiscoWorks installation and configuration. With each error message, an explanation of what might have caused the error is included, as well as a description of how to resolve the problem.

Error messages are listed alphabetically.

Error Message Checksum error.

Explanation    The UNIX tar file became corrupt.

Recommended Action    Reinstall CiscoWorks. If this does not correct the Checksum error, contact your CiscoWorks service representative for a new installation CD.

Error Message Error installing NMS. The following files are either missing or corrupt: 10485760 ./sybase/SUN4/data/master.dat Error installing NMS The above files were found to be of a different size than those written on the distribution media. A problem occurred in the installation which prevented them from being correctly extracted. Refer to the installation instructions for possible causes. The list of expected files can be found in /user/nms/.install/find.sort.install and the list of failed files is in /usr/nms/.install/missing.files.

Explanation    The most probable cause for this error is that there was not enough room in the installation directory for CiscoWorks.

Another possible cause is that the CD-ROM drive malfunctioned. If you have a SPARC station 1 or 2 system, this is the likely cause if the installation process took much less than 20 minutes and ended by abruptly displaying a long list of files on the screen.

Recommended Action    Expand your partition to allow CiscoWorks to be installed correctly; then reinstall CiscoWorks. Use a different CD-ROM drive if necessary. If you are not able to correct the problem, contact a Cisco Systems service representative for assistance.

Error Message Error: Problem with initializing Sybase server.

Explanation    The most probable cause for this error is that the rc.local file attempted to invoke the nmstartup command, but Sybase was not yet configured.

Recommended Action    Check the NMSROOT and SYBASE environment variables. Check the Sybase configuration and rerun the ncsconfigure script, if necessary. If this does not resolve the problem, contact a Cisco Systems service representative for assistance.

Error Message FAIL: cmd: xnmgrapher; err:2

Explanation    This message appears if you try to launch the HP OpenView Grapher from CiscoWorks Real-Time Graphs or Health Monitor application and the path where the HP OpenView Grapher is located is not set in the PATH environment.

Recommended Action    Exit all applications and OpenView Windows. Set the PATH environment to include the directory where OpenView Grapher is located. Restart CiscoWorks applications.

Error Message Invalid password or no Sybase server running.

Explanation    The password used for Sybase was incorrect when you upgraded your existing version of CiscoWorks.

Recommended Action    Identify and provide the correct password for Sybase. Refer to "Sybase Password " in Chapter 2, "Preparing to Install CiscoWorks ."

Error Message Sybase server is not responding. Please check your old server.

Explanation    If you are upgrading your version of CiscoWorks, the Sybase server must be running when you are installing the new version of CiscoWorks. If that is not the case, this error message will display on your screen.

Recommended Action    Make sure that the Sybase server is running by using the nmstartup command. Then try to run the installation script again.

Error Message Sybase would not install.

Explanation    The Sybase software cannot be installed on your system for one of the following reasons:

• There is inadequate disk space on the system for completing the installation of Sybase software.

• The system kernel is not modified. If your system has insufficient memory, the kernel of the system may not be modified to reflect the Sybase changes.

• The hostname could not be resolved because of the large size of the /etc/hosts file.

Recommended Action    Check the /tmp/log and ncskernel.log files for the cause of the error message.

Recommended Action    Use the df command (on a Sun platform) or dbf (on an HP-UX platform) to determine whether your system has enough disk space for Sybase installation.

Recommended Action    If the kernel was not modified, edit the kernel configuration file manually to add the Sybase modifications.

Recommended Action    If a hostname was unresolved, contact the system administrator responsible for maintaining the /etc/hosts file or the DNS database.

Error Message The Database was not properly built

Explanation    When specifying the directory path for CiscoWorks installation, you used the link directory /usr/nms/sybase/install. You cannot use the link directory.

Recommended Action    Rerun the installation phase usr/tmp/unbundled/ncs/ configure. When prompted for a directory path, use /disk/nms/sybase/ install.

Error Message The /sys/sun directory does not exist!

Explanation    If you allowed the installation script to edit the kernel configuration file in the /sys/sun/ARCH/conf directory (where ARCH could be sun4c, sun4m, or sun4n) and made Sybase-related changes to the kernel, the kernel attempts to find the script in the /sys/sun directory. This error message is displayed if that directory does not exist.

Recommended Action    Check the directory structure on your system to locate the sys/sun directory. If this directory is missing, refer to the Sun System Administration Guide for information on the correct directory structure for your system.

Error Message Unable to copy old vmunix! Check /tmp/log file.

Explanation    When the configuration script edits the /sys/sun/conf/config file and creates a new kernel, it attempts to save the old kernel in the vmunix.syb_inst file. At least 3 megabytes (MB) of disk space is required to save the old kernel as a backup.

Recommended Action    Use the df command to check the amount of disk space available on your system. At least 3 MB of disk space is required to save the old kernel in old/vmunix.

Error Message Unable to make directory.

Explanation    CiscoWorks is attempting to create a directory, but is unable to do so because of restricted permissions assigned to the directory above the directory currently being created.

Recommended Action    Change the permissions to the appropriate directory to enable CiscoWorks to create a directory below it. For information on the chmod command, refer to the Sun System Administration Guide or the UNIX manual page.

Error Message You must be logged into the system as root to run this script!

Explanation    When installing or configuring CiscoWorks, you must log in as a superuser. When you log in as a regular user, your permissions are inadequate for CiscoWorks to complete the installation and configuration process.

Recommended Action    Log in as a superuser to the system where CiscoWorks is being installed or configured.