Installation and Setup Guide for CiscoWorks Common Services 3.0 (Includes CiscoView) on Windows
Troubleshooting the Installation

Table Of Contents

Troubleshooting the Installation

Checking Processes After Installation

Viewing and Changing Process Status

Contacting Technical Assistance Center (TAC)

Understanding Installation Error Messages


Troubleshooting the Installation


This appendix provides troubleshooting information for Common Services installation.

This appendix contains:

Checking Processes After Installation

Viewing and Changing Process Status

Contacting Technical Assistance Center (TAC)

Understanding Installation Error Messages

Checking Processes After Installation

You can run a self test or view process failures from the CiscoWorks Server.

To run a self test, in the CiscoWorks Homepage select
Common Services > Server  >  Admin  >  Selftest.

To view process failures, in the CiscoWorks Homepage select
Common Services > Server  >  Reports >  Process Status.

Processes that are not running will be displayed in red color.

Viewing and Changing Process Status

You can view the status of any process by selecting
Common Services > Server  > Admin  > Processes from the CiscoWorks Homepage.

From the browser, only users with administrative privileges can start and stop processes.

From the CiscoWorks server, only users with local administrative privileges can start and stop processes.


Step 1 From the CiscoWorks Homepage, select
Common Services >Server  > Admin > Processes

The Process Management page appears.

Step 2 In the Process Management page, select the processes that you want to stop.

Step 3 Click Stop.

If you select specific processes, the dependent processes will also stop.


To start processes from the browser:


Step 1 From the CiscoWorks Homepage, select
Common Services >Server  > Admin  > Processes

The Process Management page appears.

Step 2 In the Process Management page, select the processes that you want to stop.

Step 3 Click Start.

Only the selected processes will be started. The dependent processes will remain stopped.


To stop all processes from the server, enter:

net stop crmdmgtd

To all start processes from the server, enter:

net start crmdmgtd


Caution Do not start the daemon manager immediately after you stop it. The ports used by daemon manager will be in use for some more time even after the daemon manager is stopped. Wait for a few minutes before you start the daemon manager.

Contacting Technical Assistance Center (TAC)

You can contact the Technical Assistance Center (TAC) if you had problems while installing Common Services.

Before contacting TAC, we recommend that you make that:

The system hardware and software requirements are met.

The disk space is not full.

The CD ROM drive is not defective.

If the above conditions are met, and you still have problems, contact the Technical Assistance Center.

TAC representatives may ask you to send them the installation log file,
system drive:\Ciscoworks_setup001.log file (or the log file with the highest number, for example, Ciscoworks_setup003.log).

Generate a report and email the generated report to TAC.

To generate the report:

In the CiscoWorks Homepage, select
Common Services >Server >Admin >CollectServerInformation.

Understanding Installation Error Messages

Table A-1 shows error messages that might occur during installation and describes the reasons for the errors.

Table A-1 Installation Error Messages 

Message
Reason for Message
User Action

CiscoWorks Common Services installation cannot proceed because you are not logged in as an administrator.

You are not logged in to Windows with administrator privileges.

Log in to Windows with local administrator privileges and try installing again.

Decompression failed on file. The error was for error code per CompressGet.

When you downloaded CiscoWorks Common Services, a transmission error occurred or the installation medium is damaged.

Retry the download. If you still have errors, contact your technical support representative.

General file transmission error. Please check your target location and try again. Error number: error code.

When you downloaded CiscoWorks Common Services, a transmission error might have occurred.

Retry the download. If you still have errors, contact your technical support representative.

Severe: Cannot run the dependency handler.

When you downloaded CiscoWorks Common Services, a transmission error might have occurred.

The directory structure of installation is not maintained. This can happen if you download the zip file and extract the contents to install from it.

Retry the download.

Unable to write infoFile or Unable to create infoFile.

A file-write operation failed.

Run the file system checking utility, then repeat the installation.

1. Verify that you have write permission to the destination directory and windows TEMP directory.

2. Repeat the installation.

The environment variable %TEMP% provides the location on TEMP directory.

Cannot stop service servicename.

The installation (or reinstallation) tried to stop the service servicename unsuccessfully.

1. Select Control Panel > Services and stop service servicename manually.

2. Proceed with (un)installing.

UseDLL failed for dll.

dll should be available at any time for any process, but Windows failed to load it.

Check permissions on the system32 directory under %WINDIR%. If the dll is secure.dll or r_inst.dll, check product installation media for errors.

Or

Reinstall Windows.

function failed: DLL function not found.

dll should be available at any time for any process, but Windows failed to load it.

Check permissions on system32 directory under %WINDIR%. If dll is secure.dll or r_inst.dll, check product installation media for errors.

Or

Reinstall Windows.

OpenFile failed: pathname.

A file open operation failed.

1. Run the file system checking utility, then repeat the installation.

2. Verify whether you have the read permission on pathname, then repeat the installation.

ProtectFile failed: file: error. WWW admin security may be incomplete.

Setting file permissions failed because you may not be allowed to change them.

Log in as administrator.

If you are installing on a FAT file system, CiscoWorks Common Services cannot provide file security.

Launch of isql script failed.

The existing database file is broken, or the previous version of CiscoWorks Common Services is destroyed. (The problem may occur during reinstallation.)

Contact your technical support representative.

The product should not be installed in a root directory.

You tried to install the product in a directory of a drive (for example, c:\ or d:\) that is not supported.

Choose a directory other than the root directory to install the product.

The product should not be installed in a remote directory.

You tried to install the product in a directory of a drive that is remotely mounted or using the UNC pathname.

Choose a directory on a local hard-drive.

The selected directory is not empty. Mixing new and existing files can cause severe problems during installation.

You tried to install in a directory that contains some files.

Remove all files from directory or choose another directory to install the product.

The installer requires temporary workspace. You have less than 8 MB of free space on drive. Free up some space and try again.

There is not enough drive space for temporary installation files.

Make more drive space available (%TEMP%), then rerun installation.

You are attempting to install CiscoWorks Common Services 3.0 with CiscoView 6.1 and Integration Utility 1.6 on a Server which is configured as a Primary Domain Controller or a Backup Domain Controller (PDC/BDC).

CiscoWorks Common Services 3.0 with CiscoView 6.1 and Integration Utility 1.6 is supported only on Windows 2000 Professional, Windows 2000 Server,Windows 2000 Advanced Server with Service Pack 3 or 4 and has not been certified as compatible with the Terminal Services Application mode.It is also supported on Windows 2003 Server Standard Edition, Windows 2003 Server Enterprise Edition and has not been certified as compatible with the Terminal Services.

You are installing the application on a Server which is configured as a Primary Domain Controller or a Backup Domain Controller (PDC/BDC).

Install CiscoWorks Common Services 3.0 with CiscoView 6.1 and Integration Utility 1.6 on another server not configured as PDC / BDC.

You are attempting to install CiscoWorks Common Services 3.0 with CiscoView 6.1 and Integration Utility 1.6 on an unsupported operating system. CiscoWorks Common Services 3.0 with CiscoView 6.1 and Integration Utility 1.6 is supported only on Windows2000 Professional, Windows Server 2003 or Window2000 Server with Service Pack 3 or higher.

The installation application will exit when you close this message box.

You are installing the application on an operating system that does not match System Requirements for the product.

Upgrade the Operating System on the Server to a supported version

Or

Install CiscoWorks Common Services 3.0 with CiscoView 6.1 and Integration Utility 1.6 on another server running a supported Operating System.

You are attempting to install CiscoWorks Common Services 3.0 with CiscoView 6.1 and Integration Utility 1.6 on operating system and service pack.

CiscoWorks Common Services 3.0 with CiscoView 6.1 and Integration Utility 1.6 is supported only on Windows 2000 Professional, Windows 2000 Server,Windows 2000 Advanced Server with Service Pack 3 or 4.

No other Service Packs have been certified as compatible. No other service packs have been certified as compatible. The Setup program will exit when you close this message box. Please run installation again on a supported platform. Do you want to proceed?

You are installing the application on an operating system that does not match System Requirements for the product

Run installation again on a supported platform.

We recommend that you run the installation from a local CD or a local hard drive to avoid errors that may result from the network being slow or busy.

Do you want to proceed?

Click Yes to proceed with this installation.

Click No to exit installation.

You are installing the product from a copy of the CD or from the CD drive of another system in the network through Network Neighborhood.

1. Map the drive locally using the net use command or Tools > Map Network Drive in Explorer.

2. Run the installation from the local mapping.

The installation image is being accessed as \\servername\sharename. Installation can run only from a local or mapped drive.

We recommend that you run the installation from a local CD or a local hard drive to avoid errors that may result from the network being slow or busy.

Click OK to exit installation.

You are installing the product from another system in the network through Network Neighborhood.

1. Copy the installable to a local drive or use local CD drive.

Or

Map the drive locally using the net use command or Tools > Map Network Drive in Explorer.

2. Run the installation from the local mapping.

The default (or selected) drive drive has a(n) file-system-type file system.

This file system does not support file security. The cluster size is cluster size bytes, therefore disk space requirements can be high.

Choose another directory to install CiscoWorks Common Services

Use default or selected directory to install CiscoWorks Common Services

You are trying to install onto a drive with a non-NTFS (FAT or FAT32) file system. The file system may not support security. The cluster size may be bigger than 4096 bytes.

Click on the directory on which you want to install CiscoWorks.

Setup has detected that unInstallShield is in use. Close unInstallShield and restart setup. Error 432.

You do not have permission to write to the %WINDIR% directory.

Verify that you have appropriate permissions to write to %WINDIR%. Installation or Uninstallation has to be done by a member of local Administrators group.

The product can be installed only in a folder that does not have spaces or can be converted into 8.3 form. Choose another destination folder.

The destination directory contains spaces in the directory name and the directory name cannot be converted to a MS-DOS format.

1. Install the product in a directory whose fully qualified pathname does not contain any spaces or has MS-DOS name aliases.

2. Check the presence of MS-DOS aliases, using dir /x command in a command-line window.

Cannot determine the local Administrators group.

The installation program cannot find one of the built-in Windows user groups. This prohibits CiscoWorks Common Services security setup.

1. Check the Operating System.

2. Reinstall Windows if necessary,

3. Rerun CiscoWorks Common Services installation.

Cannot determine the local Everyone group.

The installation program cannot find one of the built-in Windows user groups. This prohibits the setup of CiscoWorks Common Services security.

1. Check Operating system.

2. Reinstall Windows if necessary,

3. Rerun CiscoWorks Common Services installation.

Installation cannot create the default directory, directory name. You may not have permissions on the default directory or you have specified a read-only device.

You may not have permissions on the directory.

Choose another destination directory.

Failed to set file permissions.

The installation program is unable to set file permissions. Most likely causes are:

The account you used to log in to the system has insufficient permissions.

The drive on which you are installing product has a FAT file system.

1. Correct the problem.

2. Rerun installation program.

task_name is already running! Wait for it to complete and click OK.

One installation subtask is still running.

1. Wait for installation subtask to finish running

2. Click OK to proceed.

Unable to create/open log file.

The installation program was unable to create or open installation log file ciscoworks_setupxxx.log. xxx is a sequential number starting from 001 (in root directory on system drive).

1. Determine why the file could not be created or opened.

2. Correct the problem, then rerun installation. Common causes are lack of disk space or write protection on file

3. Rerun installation.

Error creating / modifying casuser - name.

Click Yes if you want to try again, Click No if you want the Install to abort.

This error may happen if:

The passwords that you entered do not match the policies set by System Administrators

Or

User running the installation does not have permission to create new user on the system.

If you are not authorized to create users on the system, contact your System Administrator.

If you are authorized to create users on the system and are still seeing this error, click Yes

This will take you to a screen where you can reenter the passwords.

Take corrective action to the problem as given in the error message.

Cannot find script to upgrade database.

Problem with database upgrade.

Contact your technical support representative.

Database upgrade failed.

Problem with database upgrade.

Contact your technical support representative.

Database upgrade result unknown.

Problem with database upgrade.

Contact your technical support representative.

The installer has discovered HP OpenView services running. The installation might take significantly longer to complete with these services running.

HP OpenView services are running.

Stop all HP OpenView services before installing CiscoWorks.

You do not have to restart the system after stopping HP OpenView.

ODBC Driver Manager 3.510 or later is required by CiscoWorks Common Services. Install ODBC 3.510 first.

CiscoWorks Common Services software requires ODBC Driver Manager version 3.510 or later.

Install Microsoft Data Access Component (MDAC) 2.1 or higher.

Make sure that all ODBC Core Components have the same version number.

See the Microsoft web site for installation instructions.

ODBC is not available from Microsoft as a stand-alone installation but is packaged along with MDAC.

Name lookup failed for hostName. Please configure the hostname and and then try installation.

Your hostname is not configured properly.

Configure the hostname and continue installation.

These files are currently being used by another running process. You must stop all processes listed below to proceed successfully with this installation.

Click Next to proceed with the installation.

Click Cancel to exit.

Some of the executables and DLLs installed by CiscoWorks are locked.

1. Stop all applications.

2. Stop IPM if it is running.

3. Close Browsers and make sure CiscoWorks CLIs are not used at the moment.

After stopping all the applications, proceed with the installation.

Do you want to verify that CiscoWorks files are no longer being used by running processes?

Click Yes to verify that files are no longer in use and that the installation may proceed.

Click No to proceed without verification.

Some of the executables and DLLs installed by CiscoWorks are in use.

Verify that files are no longer in use.

If some files are in use, stop all processes. To do this:

1. Cancel installation.

2. Stop the CiscoWorks and change the startup type from Automatic to Manual.

3. Restart the system.

4. Try to run command net start from MSDOS window.

The output should not show any CiscoWorks or CiscoWorks Common Services daemon manager running.

5. Run the installation again.

The instruction at location referenced memory at location. The memory cannot be read.

Click OK to terminate the program.

Click Cancel to debug the program.

This message appears when you install CiscoWorks Common Services on a Pentium IV machine.

Click OK, and ignore the message. The installation will continue normally.

java.exe has generated errors and will be closed by Windows. You will need to restart the program. An error log is being created.

This message appears when you install CiscoWorks Common Services on a Pentium IV machine.

Click OK, and ignore the message. The installation will continue normally.

CreateService - service name - The specified service is marked for deletion.

The registry entries related to the service are not deleted during the uninstallation.

1. Restart the machine

2. Reinstall CiscoWorks Common Services.

If the problem still exists:

1. Uninstall CiscoWorks Common Services

2. Restart the machine,

3. Start a fresh installation.

IIS is detected in this system and is in enabled state. Please disable or uninstall IIS for CiscoWorks to install and function properly.

The Internet Information Services (IIS) is enabled

Disable or uninstall IIS.

IIS is detected in this system and is in disabled state. It has to be uninstalled for CiscoWorks to install and function properly.

The Internet Information Services (IIS) is disabled.

Uninstall IIS.

One instance of CiscoWorks Installation is already running. If you are sure that no other instances are running, remove the file C\:CMFLOCK.TXT. The Installation will now abort.

CiscoWorks installation is already running.

Remove the file C:\CMFLOCK.TXT and retry the installation.

Backup operation failed.

Please look at backup directory\backup.log for the reason for failure.

Click Retry to take backup again. Click Exit to exit the installation.

The backup process failed.

Retry backing up again.