Table Of Contents
Troubleshooting the Installation
Checking Files and Directories After Installation
Viewing and Changing Process Status
Understanding Installation Messages
Setting Up the Browser
Troubleshooting the Installation
This appendix provides troubleshooting information for CD One installation. It contains:
•
Checking Files and Directories After Installation
•Viewing and Changing Process Status
•Understanding Installation Messages
•Setting Up the Browser
Checking Files and Directories After Installation
If you had problems while installing CD One, make sure the following directories are installed in the /opt/CSCOpx/ directory (or the directory you specified):
•backup
•bin
•cam-repository
•cgi-bin
•collect
•conf (configuration files)
•databases
•dbupdate
•etc
•htdocs (web server files)
•lib
•man
•nmim
•objects (CD One subsystems)
–ani
–data
–dmgt
–eds
–jrm
–jrun
–util
–cmf (CiscoWorks2000 Server)
–db (CD One database)
–mngconnection (Management Connection)
–perl5 (CD One perl interpreter and libraries)
–proxy (proxy server information)
–share (shared program files)
–web (web server process and utilities)
•selftest
•setup (setup information)
•users
•www
Viewing and Changing Process Status
Any CiscoWorks2000 user can view the status of any process by selecting CiscoWorks2000 Server > Administration > Process Management >
Process Status from the CiscoWorks2000 navigation tree.
Note Selecting DbServer stops all processes except WebServer and JRunProxy. However, you cannot start all processes again by starting just the DbServer process. Other processes must be started individually.
From the browser, only users with administrator privileges can start and stop processes. Refer to Getting Started with the CiscoWorks2000 Server and the online help for details.
From the server, only users with root privileges can start and stop processes.
To start processes, enter:
/etc/init.d/dmgtd start
To stop processes, enter:
/etc/init.d/dmgtd stop
Understanding Installation Messages
After verifying that the correct files are installed, view the /var/tmp/ciscoinstall.log. You might find:
•Information messages, which provide important details
•Warning messages, which mean that something might be wrong with a particular process, but the process will be completed
•Error messages, which mean that a particular process could not be completed
Table A-1 shows messages that might occur during installation and describes the reasons.
Table A-1 Installation Messages
Message
|
Reason for Message
|
User Action
|
Access problem with <directory>.
|
Installation program cannot access product <directory> that you specified.
|
Check permissions on directory <directory>.
|
Bad installation root dir.
|
You are trying to install product in an unusable directory.
|
Install product on a different directory.
|
Base package did not install. Exiting.
|
Installation program cannot install a required package.
|
Contact your technical support representative.
|
Cannot backup /etc/services, no change will be made.
|
Installation program could not copy /etc/services before modifying it.
|
Make sure there is enough space in /tmp.
|
Cannot become owner of file in directory <directory>.
|
You cannot become file owner in directory you specified as product root.
|
Check permissions on specified directory.
|
Cannot change ownership of library. Exiting.
|
Installation program could not write to product root directory.
|
Check permissions on specified directory.
|
Cannot create <directory>.
|
Installation program could not write to directory you specified.
|
Check permissions on specified directory.
|
Cannot create symlink: ln -s <root> /opt/CSCOpx.
|
Installation program cannot create link from /opt/CSCOpx to product root directory you specified.
|
Contact your technical support representative.
|
Cannot determine the CD One version.
|
Installation disk is corrupted.
|
Contact your technical support representative.
|
Cannot determine the version of <product>.
|
Installation program was unable to determine product version.
|
Contact your technical support representative.
|
Cannot make list of packages for installation.
|
Installation suffered a major failure.
|
Contact your technical support representative.
|
Cannot make root dir.
|
You do not have permission to make product directory you gave the program.
|
Check the permissions on the root.
|
Cannot upgrade.
|
Upgrade failed.
|
Contact your technical support representative.
|
Copy <setupdir> to <nmsroot> failed.
|
Installation program could not write to product root directory.
|
Check permissions on root.
|
Daemon Manager could not start. The port is in use.
|
The operating system has not reallocated the port.
|
Make sure all CiscoWorks2000 processes are terminated (/usr/ucb/ps -auxww | grep CSCO). Wait five to ten minutes, then try to restart the daemon manager.
|
Installation in progress.
|
You are already running an installation on this machine.
|
Run only one installation program at a time.
|
Missing file <file>.
|
Installation program could not find <file> file.
|
Contact your technical support representative.
|
mkdir -p <root> failed. Exiting.
|
Installation program was not able to create root specified.
|
Check permissions on root.
|
No syslog facility is available.
|
No available syslog facilities for CD One.
|
Make one of the facilities available.
|
Not enough disk space: <root>.
|
You picked a product root in a file system with insufficient space to load our product.
|
Make at least 2 GB of disk space available on partition on which you install product.
|
Package verification failed: <pkg> aborting.
|
While our packages were being loaded, one loaded incorrectly.
|
Contact your technical support representative.
|
Syslog is not running.
|
Installation program was unable to start syslogd on this machine.
|
Restart syslogd.
|
The components have dependency errors.
|
Installation suffered a major failure.
|
Contact your technical support representative.
|
User must be root.
|
You must be root to install.
|
Log in as root and enter correct password.
|
Wrong OS.
|
Operating system is not Solaris or not a supported version of Solaris.
|
Make sure you are running Solaris 2.6.
|
Current administration requires that a unique instance of the <CSCOpkg> package be created. However, the maximum number of instances of the package which may be supported at one time on the same system has already been met.
|
Upgrading from CD One 1st Edition to CD One 2nd Edition.
|
If this happens, change the property pair to instance=overwrite in the following file:
/var/sadm/install/admin/
default.
|
The installer has discovered a problem with the DNS resolution. The DNS must resolve within 10 seconds for the CiscoWorks2000 product to work properly.
|
The DNS is not being resolved or is not resolving properly.
|
Continue the installation as usual, then correct the DNS resolution problem.
|
Setting Up the Browser
If you have problems using the desktop, make sure the browser is configured correctly:
1. If the desktop buttons do not work, Java and JavaScript are not enabled. Make sure to enable Java and JavaScript as described in the "Preparing to Use CD One" chapter, "Configuring Client Systems" section.
2. Make sure your cache is not set to zero. If you have browser problems, increase your cache settings as explained in the "Preparing to Use CD One" chapter, "Configuring Client Systems" section.
3. Do not resize the browser window while the desktop or main page is still loading. This can cause a Java error.
Feedback
