
Table of Contents
Troubleshooting CiscoWorks Errors
Troubleshooting CiscoWorks Errors
This appendix contains the following sections:
Each error message covered includes an explanation of what might have caused the error and a description of how to resolve the problem.
For information on all Cisco device error messages that are logged in the CiscoWorks centralized log file, refer to the Router Products Configuration and Reference publication if you have Cisco Systems Software Release 8.3 or earlier. If you have Release 9.0 or later, refer to the System Error Messages, Release 9.0.
For information on Sybase errors, refer to the Sybase documentation packaged with CiscoWorks.
For UNIX and SunNet Manager error messages, refer to the appropriate Sun documentation.
Running CiscoWorks Applications from the Command Line
You can run CiscoWorks from a supported graphical user interface or from the UNIX command line. If you experience problems using the graphical user interface, you might prefer to use the command line to bring up the applications. This section describes the command line syntax used to bring up all the CiscoWorks applications.
To start CiscoWorks applications from the command line, perform the following steps:
Step 1 To change directories to access the CiscoWorks applications, commands, or daemons, enter the following command:
%
cd $NMSROOT/bin
- The files can be located in either $NMSROOT/bin or $NMSROOT/etc.
Step 2 To start any CiscoWorks application, command, or daemon, enter the appropriate command from the following list:
- nmautoinst---AutoInstall Manager application
- dwb---Sybase Data Workbench (DWB) application
- To alter your terminal environment variable, refer to "Invoking Sybase DWB from the Command Line" in Chapter 4.
- logpurg---Log Purge program
- nmadd [-v][-h][-n device][-d domain_name] [-r commstring][ -w rw_commstring]---Add to database application
- nmadmin---Security Manager application
- nmconfig [-v][-h][-d device][-U user][-P password][-O option][-D group][-m maillist][-l logdir][-c commandfile][-s community string][-g group][-dom domain]--- Configuration Management Batch Program
- nmconfman---Configuration Management application
- nmcontacts---Contacts application
- nmdevman
[-v]---Device Management application
- nmdevmon---Device Monitor application (Sun Net Manager only)
- nmdevmond
[-v][-d][ -l
logfile][-L
redundant_logfile]---Device Monitor daemon (SunNet Manager only)
- nmdevswman---Device Software Manager application
- nmdomain [-v][-h ][-G domain]---Domain Manager application
- nmenv
[-v]
device community string---Environmental Monitor application (needs envmonitor 2.0 or later)
- nmgcmd [-v][-h][-G domain]---Global Command Manager application
- nmgraphs
[-v]
device community string---Real-Time Graphs application (must have NMS platform running)
- nmhealth [-v]
device community string---Health Monitor application
- nminventory---Software Device Inventory application
- nmlogin---Login application
- nmlogman---Log Manager application
- nmlogout---Logout application
- nmpccmd [-v]---Configuration Snap-In Manager application
- nmpath
[-v] [-D] [source] [destination]---Path Tool application
- nmpoll---Device Polling application
- nmproc---Process Manager application
- nmsanms---Default Account program
- nmscheduler [-U cw_user_name][-N my_global_cmd]---Global Commands Scheduler
- nmshow
[
-v
]
device community_string
[option]---Show Commands application
- nmsummary---Polling Summary application
- nmswman---Software Library Manager application
- nmsync
[-v][-l][-D domain_name][-h host_name]---Sync w/Sybase application
- nmtacacs---TACACS Manager application
- nmversion---Version Command
For example, to start the Contacts application, enter the following:
% nmcontacts
The Contacts window will appear.
Note If you experience difficulty with a CiscoWorks application, contact a technical support representative.
Error Message Levels
CiscoWorks has six levels of error messages as described in Table B-1.
Table B-1 : CiscoWorks Error Messages Levels
| debug
|
Level 5 (lowest priority)
|
Disabling device poll: <string> (id=<string>).
|
| information
|
Level 4
|
CiscoWorks Version 1.0.
Copyright (c) 1990, 1991, 1992 by Cisco Systems Inc. All rights reserved.
|
| warning1
|
Level 3
|
File <string> is read-only.
|
| error
|
Level 2
|
Unknown host xxxxx. Could not connect to Sybase server.
|
| fatal
|
Level 1
|
Prints error and exits application. Unknown catastrophic error.
|
| bug
|
Level 0 (highest priority)
|
Cannot find device poll group - <string> (id=<string>) - to remove it.
|
1 By default, only messages level 3 or higher are actually logged to the Log Manager during the normal running of the application.
Note The applications, commands, and error messages in this appendix are CiscoWorks application error messages. Do not confuse these messages with router error messages.
Common Error Messages
This section describes the error messages for the CiscoWorks applications, including the installation and configuration scripts. They are organized alphabetically and include an explanation and recommended action for each error message.
Note For installation error messages, refer to the CiscoWorks Administrator and Installation Guide. For information on any errors relating to maps, graphing, snapshots, and so on, refer to the documentation for your specific network management platform.
In the error messages, the expressions <string> and <number> represent the characters or digits each CiscoWorks application replaces as part of the error message. For example, the error message "Device: <string> (id=<string>) changes status to <string>" might be viewed by the user as "Device: drogg@cisco.com (id=drogg@cisco.com) changes status to up." If you cannot locate an error message alphabetically, return to the beginning of the error messages and check under the error messages that begin with string.
Error Message
<string> is an unknown device.
Explanation The name of the device cannot be resolved to an IP address.
Recommended Action Check DNS, NIS, /etc/hosts file, or name resolution method.
Error Message
<string>, log closed - <string>
Explanation The logger has experienced some sort of error from which it could not recover (There will probably be an error message previous to this one indicating the unrecoverable error.) The logger is now aborting.
Recommended Action Check for other logger error messages to determine the cause.
Error Message
<string>(<string>) returned a null data type
Explanation The SNMP agent at <string> returned a null value for attribute <string>.
Recommended Action Check your SNMP agent.
Error Message
<string>(<string>) returned an unspecified data type
Explanation The SNMP agent at <string> returned an unspecified value for attribute <string>.
Recommended Action Check your SNMP agent.
Error Message
<device> -config files in /tftpboot must have RW permission.
Explanation The /tftpboot directory must have read/write permission for the user.
Recommended Action Change the file permission to read/write.
Error Message
Already at first record.
Explanation You have attempted to use the Previous command, but are at the beginning of the list of rows.
Recommended Action None.
Error Message
Attr <string> (id=<number>), using datatype from mib: <string>
Explanation The specified data type (retrieved from the MIB) will be assumed for attr <string> rather than the data type specified by the database.
Recommended Action Compare MIB files to schema files to ensure that data types match.
Error Message
Authorization check failed: <string>
Explanation You might not be authorized to use the Device Monitor application.
Recommended Action Check the Security Manager application to ensure that you have privileges to use the Device Monitor application.
Error Message
Bad poll rate: <string>, for poll group <string> (id=<number>)
Explanation The poll rate is invalid.
Recommended Action Ensure that the poll rate for this poll group is an unsigned number between 0 and 2684354 seconds (maximum valid poll rate). Use the Device Polling application to check the poll rate.
Error Message
Can't ARP for <string>
Explanation Application is trying to create an ARP cache entry for <string>.
Recommended Action Check the ARP cache on the local system via the arp command. Check the routing table on the local system via the restat -r command.
Error Message
Cannot create configuration boot file <string>. Cannot complete uploading
process.
Explanation The upload is not complete because the Configuration Management application cannot open a temporary file. The system could be out of disk space. This is a UNIX system error message.
Recommended Action Try to verify the system problem from an xterm window or a cmdtool window. Consult the UNIX system administrator.
Error Message
Cannot create temporary configuration file <string>. System error
<<string>>.<<string>> Cannot Complete Uploading Process.
Explanation The upload is not complete because Configuration Management cannot open the temporary file. The system could be out of disk space. This is a UNIX system error message.
Recommended Action Try to verify the system problem from an xterm window or a cmdtool window. Consult the UNIX system administrator.
Error Message
Cannot delete configuration file for : Device (<string>) Version(<string>).
It has already been opened for editing.
Explanation This file is already open for editing. It cannot be deleted.
Recommended Action To delete the file, first close the editor window for the selected configuration file.
Error Message
Cannot determine IP address for the device.
Explanation Indicates an attempt to add a device into the database via Initialize.
Recommended Action Check the /etc/hosts file, the Domain Name System (DNS) server, or the NIS server (whichever is applicable) to find out if the IP address is listed for the device.
Error Message
Cannot find an IP address for the specified device.
Explanation The IP address for the device that you are trying to find is unavailable.
Recommended Action Check the /etc/hosts file, the Domain Name System (DNS) server, or the NIS server (whichever is applicable) to find out if the IP address is listed for the device.
Error Message
Cannot find data repository table <tablename>
Explanation The specified table does not exist in the Sybase directory.
Recommended Action Use Device Polling to recreate the poll group.
Error Message
Cannot fork the program.
Explanation Indicates an attempt to run a database form program without enough memory/swap space.
Recommended Action Run the command dmesg | grep mem to find out how much memory is available. You must have at least 1.5 MB of memory to run the database form program.
Run the command /etc/pstat -s to find out how much swap space is left.
If there is not enough memory, close some applications, then start the db form program again.
Error Message
Cannot get the version string from the device.\"sysDescr\" variable is not
defined in MIB database.
Explanation The toolkit cannot find the MIB object variable, or you have an invalid MIB object variable.
Recommended Action Verify the MIB database. Refer to the showmib command described in Appendix A, "MIB Files and Objects."
Error Message
Cannot get the version string from the device.\"sysDescr\" variable is not
supported by the device.
Explanation This variable is not supported by the device. The device may be a non-Cisco device, because Cisco supports this MIB variable.
Recommended Action Contact the vendor who supplied the device.
Error Message
Cannot make a temporary file.
Explanation CiscoWorks is unable to create a temporary file for printing.
Recommended Action Check the UNIX system. Verify the /tmp directory. Make sure it has space and it is read/write enabled to the user.
Error Message
Cannot map SNM variable name: <string> (attr id=<number>) to an object id
Explanation Cannot look up the object ID for the variable.
Recommended Action Check your SNM schema and oid files.
Error Message
Cannot open lock file: path/snm+lock: permission denied.
Explanation This message appears if you try to launch SunNet Manager (SNM) when you are logged in as a user, and the directory with the snm+lock file and other files are owned by the superuser.
Recommended Action To transfer the ownership of the directory and the files that belong to the superuser to a user, enter the following command:
# chown -R username directory name
To remove the snm+lock file, enter the following command:
# rm snm+lock
The snm+lock file is created when you launch SNM.
Error Message
Cannot open syslog ConFile <string>, errno = <number>
Explanation nmlogd is trying to open the syslog file that is defined in /etc/syslog.conf and was not able to open the file.
Recommended Action Refer to the error number (<
number
> ) for debugging.
Recommended Action Logpurg is trying to open the logfile that is defined in /etc/syslog.conf and is unable to do so.
Recommended Action Refer to the error number for more details.
Error Message
Cannot open temporary configuration file <string>. Cannot complete
uploading process.
Explanation The upload is not complete because the Configuration Management application cannot open a temporary file. The system could be out of disk space. This is a UNIX system error message.
Recommended Action Try to verify the system problem from an xterm window or a cmdtool window. Consult the UNIX system administrator.
Error Message
Cannot poll this variable - do not know what it is.
Explanation The specified variable could not be identified.
Recommended Action For SNM, ensure that an entry for this variable exists in a .oid file in the $SNMHOME/agents directory. For HP OpenView, add the necessary MIB to the CiscoWorks MIB database using makemib script.
Error Message
Cannot read Snm oid directory: <string>
Explanation Cannot read the file.
Recommended Action Check file permissions.
Error Message
Cannot start Snm oid file: <string>
Explanation Cannot find or read the directory.
Recommended Action Check permissions.
Error Message
Cannot write to <directory path>!
Explanation The permissions for the specified directory are read-only.
Recommended Action Using the chmod command, change the permissions for the specified directory to RW (read/write) or specify a different directory.
Error Message
Configuration comments file for :Device (<string>) Version (<string>) has
already been opened for editing.
Explanation When a file is open for editing, you cannot open another editor for it.
Recommended Action Locate the editing window and complete your edits.
Error Message
Could not allocate memory space: <string>
Explanation Your system may need more swap space.
Recommended Action Try deselecting some device you are currently monitoring and retry your request. Stop the CiscoWorks processes and configure more swap space or shut down some existing processes.
Error Message
Could not connect to Sybase server.
Explanation Indicates an attempt to access the database.
Recommended Action Make sure $SYBASE is set properly and that the database server is alive by observing the output of the ps -ax | grep dataserver command at the Sun server machine. If you are using an HP-UX machine, use the ps -ef | grep dataserver command.
Error Message
Could not discover desired path via SNMP or any other means
Explanation The Path Tool could not locate your device via SNMP or any other means.
Recommended Action Check SNMP and IP on the last device the PATH tool tried to access.
Error Message
Could not execute program
Explanation This error depends on many factors, but may indicate there is no memory.
Recommended Action Check your Sybase database. Refer to the section "Verifying Available Database Space" in Chapter 8.
Error Message
Could not lookup object id for attr id: <number>, so using stored id:
<number>
Explanation Could not look up the object ID for the attribute using the previously stored object ID.
Recommended Action For SNM, check the SNM oid and schema files for the existence of this attribute. For HP OpenView, add the necessary MIB to the CiscoWorks MIB database using makemib script.
Error Message
Could not run snm_cmd
Explanation Cannot locate the snm_cmd file in /usr/snm/bin directory. You might have customized your directory names, and CiscoWorks cannot locate this file.
Recommended Action Check your SNM directory structure, or set the environment variable SNMHOME properly.
Error Message
Could not send Data Report to SunNet Manager Console.
Explanation The Real-Time Graphs application could not send a Data Report on the SNM Console.
Recommended Action Make sure the SNM Console is running. Also, check the shell where the SNM Console was started for additional Sun error messages.
Error Message
Could not write to Sybase, check transaction log.
Explanation The Sybase transaction log may be full and cannot accept additional data.
Recommended Action Check the transaction log to determine if it is full. Refer to Chapter 8, "Database Administration," for information on enlarging the transaction log space.
Error Message
Couldn't start xterm for editor. System error <2> <No such file or
directory>.
Explanation The xterm variable must be included in your PATH.
Recommended Action If you are using Open Windows, xterm is in $OPEN WINHOME/demo. Include it in your PATH or set a symbolic link to it. If you are using the X11 distributed by Cisco Systems, xterm is in the /usr/bin/X11/xterm directory. Include it in your PATH or set a symbolic link to it.
Error Message
Data type mismatch for <string> (id=<number>) : database claims <string>
while mib claims <string>
Explanation The CiscoWorks MIB database (mib.bin) claims one data type, while the your NMS platform claims another. The data type claimed by the NMS will be assumed to be the correct one.
Recommended Action Correct the CiscoWorks MIB database or the NMS database, whichever is in error.
Error Message
Database is full - cannot store any more records.
Explanation The system might have inadequate disk space for storing database records.
Recommended Action Use the $NMSROOT/etc/enlarge_nms script to enlarge your database. For instructions, refer to Chapter 7, "Database Administration."
Error Message
Database server has disappeared.