Table Of Contents
Troubleshooting the Installation
Checking Processes After Installation
Viewing and Changing Process Status
Calling the Technical Assistance Center (TAC)
Understanding Installation Messages
Failure to Delete a Package During Uninstallation
To Clean Up a Broken Install
Setting Up the Browser
Troubleshooting the Installation
This appendix provides troubleshooting information for CD One installation. It contains:
•
Checking Processes After Installation
•Viewing and Changing Process Status
•Calling the Technical Assistance Center (TAC)
•Understanding Installation Messages
•Failure to Delete a Package During Uninstallation
Checking Processes After Installation
You can run a self test or view process failures from the CiscoWorks2000 Server.
To run a self test, select Server Configuration > Diagnostics > Self Test from the navigation tree.
To view process failures, select Server Configuration > Diagnostics > Process Failures from the navigation tree.
Viewing and Changing Process Status
Any CiscoWorks2000 user can view the status of any process by selecting Server Configuration > Administration > Process Management >
Process Status from the CiscoWorks2000 navigation tree.
Note From the browser, only users with administrator privileges can start and stop processes.
From the server, only users with local administrator privileges can start and stop processes.
To stop processes from the browser:
Step 1 Select Server Configuration > Administration > Process Management > Stop Process
Step 2 From the dialog box, select System, to stop all processes, or select specific process to stop only those processes.
Note If you select specific processes, the process dependencies will also be stopped. If you select System, all processes except WebServer and JRunProxy Server will be stopped.
To start processes from the browser:
Step 1 Select Server Configuration > Administration > Process Management > Start Process
Step 2 From the dialog box, select System, to start all processes, or select specific process to start only those processes.
Note If you select specific processes, the process dependencies will not be started automatically.
To start processes from the server, enter:
To stop processes from the server, enter:
Calling the Technical Assistance Center (TAC)
If you had problems while installing CD One, before calling TAC:
•Make sure the system hardware and software requirements are met.
•Make sure the disk space is not full (/ (root), /opt, and /var partitions).
•Make sure the CD-ROM drive is not defective: mount the CD-ROM remotely on a different machine and retry installation.
If the above conditions are met, and you are still having problems installing CD One, contact your Technical Assistance Center.
Tips Create a report and email the generated report to TAC.
From the CiscoWorks2000 Server navigation tree, select Server Configuration > Diagnostics > Collect Server Information.
TAC representatives may ask you to send them the installation log file, /var/tmp/ciscoinstall.log
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 the file owner in the directory you specified as product root.
|
Check permissions on the specified directory.
|
Cannot change ownership of library. Exiting.
|
Installation program could not write to the product root directory.
|
Check permissions on the specified directory.
|
Cannot create <directory>.
|
Installation program could not write to the directory you specified.
|
Check permissions on the specified directory.
|
Cannot create symlink: ln -s <root> /opt/CSCOpx.
|
Installation program cannot create link from /opt/CSCOpx to the 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 permissions to create the product director.
|
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 the 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/bin/ps -auxw | 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.
|
Java.lang.error:miscalculated data length appears as a message in the status bar, and the login panel is missing.
|
You used UNIX local authentication instead of the default CiscoWorks2000 authentication during upgrade from CD One, 2nd Edition to
CD One, 4th Edition.
|
Enter /etc/init.d/dmgtd stop to stop the Daemon Manager. Remove the file /opt/CSCOpx/www/classpath/com/cisco/nm/cmf/security/jaas/JaasConfig. Enter /etc/init.d/dmgtd start to start the Daemon Manager.
|
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 the specified root.
|
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.
|
OS version not supported.
|
Operating system is not a supported version of AIX.
|
Make sure you are running AIX 4.3.3.
|
Package verification failed: <pkg> aborting.
|
While our packages were being loaded, one loaded incorrectly.
|
Contact your technical support representative.
|
Required JRE patches are unavailable on the system <patch>. Product will fail without these patches.
|
Installation program could not find required JRE patches.
|
Continue installation and install patches after CD One product is installed. Or stop product installation and install required patches before installing CD One.
|
Some files cannot get backed up, datafile missing.
|
During product upgrade, key files were not found and cannot be restored.
|
Check other directories for the missing files.
|
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.
|
There is no table of contents file.
|
Installation disk is corrupted.
|
Contact your technical support representative.
|
You must be logged in as root to install or uninstall this product.
|
You must be root to install.
|
Log in as root and enter correct password.
|
Current administration requires that a unique instance of the <CSCOpkg> package be created. However, the maximum number of instances of the package that may be supported at one time on the same system has already been met.
|
Upgrading from previous CD One editions.
|
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.
|
Wrong OS.
|
Operating system is not a supported version of AIX.
|
Make sure you are running AIX 4.3.3.
|
Failure to Delete a Package During Uninstallation
If you try to remove CD One but the uninstallation program fails to delete a package, try running the uninstall program again. Several circumstances can cause a package to remain after uninstallation. Usually, running the uninstall program again, removes the package.
There may be times when the installation process is interrupted or aborted. The uninstallation program may not work in such cases.
To Clean Up a Broken Install
A broken install results if you have interrupted the installation process by pressing Ctrl-C, or if the process was abandoned before the installation was completed. If the uninstallation program fails to delete a package, you can use the fpkgdel.sh script to remove all packages.
Step 1 As root, mount the CD One CD-ROM. You can either:
•Mount the CD-ROM on the CiscoWorks2000 Server system.
or
•Mount the CD-ROM on a remote AIX system, then access the CD-ROM from the CiscoWorks2000 Server system.
See "Mounting and Unmounting on AIX"for detailed mounting instructions.
Step 2 Start the delete packages program.
•For a local installation, enter:
•For a remote installation, enter:
where remotedir is the remote location where the CD-ROM is mounted.
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.
