Installation and Setup Guide for CiscoWorks Common Services 3.0.3 (Includes CiscoView) on Solaris - Installing CiscoWorks Common Services [CiscoWorks Common Services Software]

Table Of Contents

Installing CiscoWorks Common Services

Installation Overview

Preparing to Install Common Services

Installation Notes

Using Server IP Address

TCP and UDP Ports Information

System Files Modified During Installation

Performing New Installation

Running Installation Program—New Installation

New Installation—Typical

New Installation—Custom

Installing Common Services From Mounted Directory

Performing Upgrade Installation

Notes on Upgrade Installation

Co-existence With Other CiscoWorks Applications During Upgrade

CiscoWorks-ACS Task Registration During Upgrade and Re-installation

Running Installation Program—Upgrade Installation

Upgrade Installation—Typical

Upgrade Installation—Custom

Re-installing Common Services

Running Re-installation Program

Re-installation—Typical

Re-installation—Custom

Checking for Installation Errors

Verifying Installation

Uninstalling CiscoWorks Common Services

Installing CiscoWorks Common Services

This chapter describes the tasks you have to perform for installing, upgrading, and uninstalling Common Services on a Solaris system.

This chapter contains:

•Installation Overview

•Preparing to Install Common Services

•Performing New Installation

•Performing Upgrade Installation

•Re-installing Common Services

•Verifying Installation

•Checking for Installation Errors

•Uninstalling CiscoWorks Common Services

Installation Overview

This section provides an overview of the CiscoWorks Common Services installation tasks. Table 2-1 contains references to more detailed information about each task.
Table 2-1 Installing CD One Task Overview
Task

Steps

References

Prepare to install Common Services.

1. Verify server requirements are met.

"Server Requirements" section

2. Verify client requirements are met.

"Client Requirements" section
3. Verify TCP ports that CiscoWorks uses and check for conflicts with existing applications.

To find whether a TCP port is in use, enter:
netstat -a -n -f inet -P 
tcp | grep port number
If the port is in use, it will be displayed that the port is in LISTEN state.
"TCP and UDP Ports Information" section
Install Common Services.

Run the installation program.

"Performing New Installation" section

"Performing Upgrade Installation" section

"Re-installing Common Services" section

Verify and troubleshoot installation.

Analyze installation error messages.

"Understanding Installation Error Messages" section
Preparing to Install Common Services

This section details the important notes and preparations before you start installing Common Services.

This section contains:

•Installation Notes

•Using Server IP Address

•TCP and UDP Ports Information

•System Files Modified During Installation

Installation Notes

•Before you install CD One, make sure your server and client environments meet the hardware and software requirements described in "Prerequisites."

•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.

If you want to install from a local hard drive, you must copy the contents in a CD to a local hard drive. Ensure that you copy the entire contents from the CD to the hard drive.

If you are installing on a Solaris 9 system, you must preserve the timestamp when you copy the contents from the CD to the hard drive.

To preserve all the attributes including timestamp:

a. Change the present working directory to the directory to which the CD is mounted using the command:
cd /cdrom/cdrom0
where cdrom/cdrom0 is the directory to which the CD is mounted.

b. Create a directory where you want to copy the contents of the disk by entering:
mkdir /opt/copydisk
Make sure that this directory has enough space to hold the entire contents of the disk.

c. Enter:
tar cpf - . | (cd /opt/copydisk && tar -xpf -)
This command preserves all attributes including the timestamp.

•When there is a prompt during the installation, the values in square bracket are default values. If you press Enter when the installation program prompts you to enter a value, the program takes the default value.

•You must have root privileges to install Common Services.

•Do not install CiscoWorks and CiscoSecure Access Control Server (ACS) on the same machine. This is because ACS mandates CiscoWorks to be configured as an AAA client in it for CiscoWorks to avail AAA service.

At the same time, you cannot configure ACS as an AAA client as required when ACS and CiscoWorks coexist. Hence the configuration required for ACS integration will fail.

•Do not run any other program when installation is in progress.

•Do not install Common Services on a system that does not have Name Lookup.

•If you are running HP OpenView Network Node Manager (HPOVNNM) or NetView, the installation might take significantly longer to complete. Stop all HP OpenView Network Node Manager (HPOVNNM) or NetView services before installing Common Services.

•If your system does not have enough disk space, you might see an error message that the installation system is running out of disk space. You can choose to free up disk space on the system and continue the installation, or stop and exit the installation.

Using Server IP Address

CiscoWorks uses the IP address of the server when it interacts with web browsers. By using the server IP address, CiscoWorks eliminates name lookup failures between the server and the client systems that run web browsers.

TCP and UDP Ports Information

Table 2-2 gives information on the TCP and UDP ports used by CD One.

Table 2-2 TCP and UDP Ports Used by Common Services

Port Number

Protocol

Service Name

Traffic Direction

514

UDP

Syslog

Incoming

1741

TCP

CiscoWorks HTTP

Incoming

43441

TCP

Database

Incoming

443

TCP

CiscoWorks HTTP server in SSL mode

Incoming

9007

TCP

Tomcat shutdown

Incoming

9009

TCP

Ajp13 connector used by Tomcat

Incoming

40050 to 40070

TCP

Ports used by DCR and OGS

Incoming

40401

TCP

License Server

Incoming

22

TCP

Secure Shell (SSH)

Outgoing

23

TCP

Telnet

Outgoing

80

TCP

Hyper Text Transfer Protocol (HTTP)

Outgoing

161

UDP

Standard port for SNMP polling

Outgoing

162

UDP

Standard port for SNMP traps

Outgoing

42340

TCP

CiscoWorks Daemon Manager

Incoming and Outgoing

42342

UDP

Osagent

Incoming and Outgoing

69

UDP

Trivial File Transfer Protocol (TFTP)

Incoming and Outgoing

1683

TCP

Internet Inter-ORB Protocol (IIOP) port for CiscoWorks gatekeeper

Incoming and Outgoing

1684

TCP

IIOP port for CiscoWorks gatekeeper

Incoming and Outgoing

8088

TCP

HIPO port for CiscoWorks gatekeeper

Incoming and Outgoing

514

TCP

Remote Copy Protocol

Incoming and Outgoing

42350 (default),
44350 (alternate)

UDP

Event Services Software Service

Incoming and Outgoing

42351 (default),
44351 (alternate)

TCP

Event Services Software Listening

Incoming and Outgoing

42352 (default),
44352 (alternate)

TCP

Event Services Software HTTP

Incoming and Outgoing

42353 (default),
44353 (alternate)

TCP

Event Services Software Routing

Incoming and Outgoing

System Files Modified During Installation

The following are the system files that are modified during CD One installation:

•/etc/services

•/etc/inetd.conf

•/etc/syslog.conf

•/etc/passwd

•/etc/group

•/var/sadm/install/admin/default

•/var/sadm/install/contents

•/etc/shadow

Performing New Installation

The CD One installation program takes around 25 minutes to complete on a Solaris system with the minimum required hardware. This may extend to one hour if you perform network management integration while installing
Common Services.

For information on setting up multi-homed systems, see the Release Notes for CiscoWorks Common Services 3.0.3 (Includes CiscoView 6.1.2) on Solaris.

Running Installation Program—New Installation

To run the installation program:

Step 1 Install the required patches as described in the "Solaris Patches" section.

Step 2 Mount the CD-ROM.

As root, mount the CD-ROM using either of the following methods:

•Mount the CD-ROM on the system.

or

•Mount the CD-ROM on a remote Solaris system and access the CD-ROM from the system on which you want to install Common Services.

Caution Network inconsistencies may cause installation errors while installing from a remote mount point.

See "Mounting and Unmounting CD-ROM," for detailed mounting instructions.

Step 3 Run the installation program.

•For a local installation, enter:
# cd /cdrom/cdrom0/
# ./setup.sh 
•For a remote installation, enter:
# cd remotedir
# ./setup.sh
remotedir is the remote location where the CD-ROM is mounted.

A message appears:
Press ENTER to read/browse the following License Agreement:
Step 4 Press Enter to read the license agreement.

The following message appears at the end of the license agreement:
You must accept this License Agreement to proceed with the 
installation.
If you enter N/n, the installation will exit.
Do you accept all the terms of the License Agreement? (y/n) [n]:
Step 5 Enter y and press Enter to accept the license and proceed with the installation.

Or

Enter n or press Enter to deny and stop the installation.

If you are installing the image from a network drive, the following message appears:
The installation image is being accessed from a network 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.
Do you want to proceed? (y/n) [y]: 
Error messages or warning messages appear if you do not have the required or recommended Server and Client patches.

We recommend you download and install the latest required and recommended patches from www.sunsolve.sun.com, before you run Common Services. For more information on Solaris patches, see "Solaris Patches" section.

If any of the required Server patches is missing, the following message appears:
Installation can proceed without the required Server patches.However, 
you must install the required patches listed above before running 
CiscoWorks.
Do you want to continue the installation? (y/n) [y]:
If you enter y and proceed with the installation, the following message appears:
Choose the type of Setup you prefer.
1) Typical installation.
Installs the product in the default location /opt/CSCOpx.
Allows you to select the components to be installed.
Prompts for CiscoWorks admin password and System Identity Account 
password.
Randomly generates CiscoWorks guest database passwords if they do not 
exist.
Recommended for most users.
2) Custom installation.
Allows you to select the product location.
Allows you to select components to be installed.
Prompts for CiscoWorks admin, guest, System Identity Account and 
database passwords if they do not exist.
Recommended for advanced users.
Select one of the installation modes using its number or (q) to quit 
[1]:
Step 6 Select one of the installation modes by entering the number corresponding to the mode.

The installation program performs several pre-installation and dependency checks on your system such as TCP/IP address resolution, TCP/IP port use, disk space, and RAM.

•If you have selected Typical, see the "New Installation—Typical" section to proceed with the installation.

•If you have selected Custom, see the "New Installation—Custom" section to proceed with the installation.

New Installation—Typical

Common Services will be installed in the default location /opt/CSCOpx if you choose to install in Typical mode.

To perform a new installation using the Typical option:

Step 1 Press Enter to proceed with the installation after you select the Typical mode as given in Performing New Installation.

Or

Enter q to quit the installation.

If you press Enter to proceed with the installation, the installation program performs the prerequisites checks and the following message appears:
Select the components you want to install.
1) Common Services 3.0.3
2) CiscoView 6.1.2
3) Integration Utility 1.6
4) All of the above
Select one or more items using its number separated by comma or enter 
q to quit:
Option (4) is recommended for most systems.

Step 2 Enter the number corresponding to the option you have chosen or q to quit.

You can select more than one component using the corresponding numbers separated by a comma. For example, enter 1, 3 to select Common Services and Integration Utility.

The installation program calculates the minimum disk space required for installing the product.

If the disk space is sufficient, the following message appears:
Sufficient disk space.
If the disk does not have enough space, an error message appears and the installation exits.

Step 3 Enter the CiscoWorks admin password and confirm it.

For more information on passwords see "Password Information."

The installation program generates a random password for guest user.

Step 4 Enter the System Identity Account password and confirm it.

In a multi-server environment, you must configure all systems part of your multi-server setup with the same System Identity Account password.

For more information on passwords see "Password Information."

The installation program checks dependencies and system requirements and copies the files to the run time and the installation proceeds.

A message appears:
Do you want to see the passwords that were entered/randomly generated? 
(y/n) [y]:
Step 5 Enter y or press Enter to display randomly generated and manually entered passwords.

A message appears:
Exiting installation beyond this point might result in system 
instability.
Do you want to continue the installation? (y/n) [y]
Step 6 Enter y to continue the installation.

If you stop the installation after this point, the installation may become unstable and problems may occur when you try to install again.

The installation program takes a while to complete the installation.

If you are installing from a network drive, the installation might take longer to complete. This happens especially for CiscoView device packages.

After installation is complete, the following message appears:

The following messages appear at the end of the installation:
Software Installation Tool Completed
Possible Warnings/Errors Encountered 
Any warning and error messages appear after these messages.

Step 7 Unmount the CD-ROM.

See "Mounting and Unmounting CD-ROM," for details.

See "Checking for Installation Errors" section for details on installation errors.

New Installation—Custom

To perform a new installation using the Custom option:

Step 1 Press Enter to proceed with the installation after you select the Custom mode as given in Performing New Installation.

Or

Enter q to quit the installation.

If you press Enter to proceed with the installation, the following message appears:
Enter the location where the product will be installed. The default 
location is /opt/CSCOpx. If you choose another location, installation 
will create a symbolic link /opt/CSCOpx to that location.
Enter location or q to quit [/opt/CSCOpx]:
Caution Do not remove the link after installation. Common Services will not work without this link.

Step 2 Press Enter to accept the default directory for product installation, or enter a different directory.

The following message appears:
Select the components you want to install.
1) Common Services 3.0.3
2) CiscoView 6.1.2
3) Integration Utility 1.6
4) All of the above
Select one or more items using its number separated by comma or enter 
q to quit: 
Option (4) is recommended for most systems.

Step 3 Enter the number corresponding to the option you have chosen or q to quit.

You can select more than one component using the corresponding numbers separated by comma. For example, enter 1, 3 to select Common Services and Integration Utility.

The installation program calculates the minimum disk space required for installing the product.

If the disk space is sufficient, the following message appears:
Sufficient disk space.
If the drive does not have enough space, an error message appears and the installation exits.

Step 4 Enter the CiscoWorks admin password and confirm it.

For more information on passwords see "Password Information."

Step 5 Enter guest password and confirm it.

For more information on passwords, see "Password Information."

Step 6 Enter the System Identity Account password and confirm it.

In a multi-server environment, you must configure all systems part of your multi-server setup with the same System Identity Account password.

For more information on passwords, see "Password Information."

Step 7 Enter the CiscoWorks Common Services database password and confirm it.

For more information on passwords, see "Password Information."

Step 8 Enter SMTP server.

Step 9 Enter the following information to generate a Self-signed certificate

and key files for HTTPS:

•Host name

•Administrator's e-mail address

•Country

•State

•City

•Company

•Organization

Only the Host name is mandatory. Other fields are optional. Press Enter to skip other fields.

•If you have not selected Integration Utility, go to Step 11

•If you have selected Integration Utility, the following message appears:
The integration utility will be installed now. The integration 
utility integrates Cisco device packages and Cisco applications 
into third-party SNMP management platforms. You can choose to 
integrate with a third-party SNMP management platform during this 
installation or later.
Do you want to integrate with a third-party product now (y/n) [n]
Step 10 Enter either of the following:

•n to integrate with a third-party NMS after installation. This completes the installation faster and avoids installation failure caused by errors in the third party integration.

•y to integrate with a third-party NMS during installation.

If you select y (integrate during installation):

a. Select the adapter from the list of available adapters, or select other to choose an adapter that is not listed (you are prompted to enter the path name of the adapter), or select none to integrate after the installation is complete.

If you select none, go to Step 11.

Many third-party products allow you to launch CiscoWorks applications from within the third-party product. The CiscoWorks applications are launched in a web browser.

b. Enter the full pathname for the web browser.

A message appears prompting you to enable download updates to NMIDB (Network Management Integration Data Bundle) directly from Cisco.com.

c. Select either of the following:

–n to disable future updates from Cisco.com.

–y to enable future updates from Cisco.com.

If you select n, go to Step 11.

d. Enter your Cisco.com user ID and password.

You must have Cisco.com login privileges. If you do not have a user account and password on Cisco.com, contact your channel partner or enter a request on the standard Cisco.com web site.

The installation program checks dependencies and system requirements and copies the files to the run time and the installation proceeds.

A message appears:
Do you want to see the passwords that were entered/randomly generated? 
(y/n) [y]
Step 11 Enter y or press Enter to display randomly generated and manually entered passwords.

A message appears:
Exiting installation beyond this point might result in system 
instability.
Do you want to continue the installation? (y/n) [y]
Step 12 Enter y to continue the installation.

If you stop the installation after this point, the installation may become unstable and problems may occur when you try to install again.

It takes a while to complete the installation.

If you are installing from a network drive, the installation might take longer to complete. This happens especially for CiscoView device packages.

After installation is complete, the following message appears:

The following messages appear at the end of the installation:
Software Installation Tool Completed
Possible Warnings/Errors Encountered
Any warning and error messages appear after these messages.

Step 13 Unmount the CD-ROM.

See "Mounting and Unmounting CD-ROM," for details on unmounting the CD-ROM.

See "Checking for Installation Errors" section for details on installation errors.

Installing Common Services From Mounted Directory

To install Common Services from a mounted directory:

Step 1 Log in to the remote system.

Step 2 Enter:
cd /etc/dfs/dfstab 
Step 3 Enter:
share -F nfs -o root=r /directory containing installable image
Step 4 Stop and start the NFS server using the following commands:
/etc/init.d/nfs.server stop
/etc/init.d/nfs.server start
Step 5 Log in to the local system.

Step 6 Enter:
mount remote system:/directory containing installable image/ local directory to 
mount remote system
Step 7 Enter:
cd /local directory where you mounted the remote system
Step 8 Enter:
./setup.sh
See "Mounting and Unmounting CD-ROM," for detailed mounting instructions.

Performing Upgrade Installation

Common Services 3.0.3 supports upgrade from:

•CiscoWorks Common Services 3.0 Service Pack 2

•CiscoWorks Common Services 3.0 Service Pack 1

•CiscoWorks Common Services 3.0

•CiscoWorks Common Services 2.2

•CD One, 5th edition

For a description of the different upgrade paths and their results, see "Upgrade Paths" section.

Notes on Upgrade Installation

Following are the important notes for you before you start upgrading to Common Services 3.0.3.

•You can upgrade to Common Services 3.0.3 by installing the new version on the system that is currently running a previous version.

•Upgrade installation preserves the settings from the product installed earlier.

•We recommend that you save your data to a backup file before you perform the local upgrade. If your installation fails, you can retrieve this saved data.

•Upgrade overrides the previous versions. The old version will not be available after you upgrade to Common Services 3.0.3.

•During upgrade installation:

–If you do not provide a value during a prompt and press Enter, CiscoWorks uses the values from the previous installation.

–If you have not entered a password for CiscoWorks admin and System Identity Account during the previous installation, you must enter a new password for the installation to proceed.

–If you select Custom option during upgrade installation, all the user prompts display the default values or the settings from the previous installation. You can either accept these values or modify them.

–The installation attempts to use existing passwords. If the installation does not generate random passwords, you may provide the passwords manually.

–The installation does not use the randomly generated password if the password does not comply with the policies set by the local administrator.

–You can preserve the existing Apache certificate. Press Enter or enter y when you are prompted to preserve the existing Apache certificate.

Co-existence With Other CiscoWorks Applications During Upgrade

Following are the important notes regarding co-existence of Common Services with other CiscoWorks applications.

•Earlier versions of other CiscoWorks applications are not fully compatible with Common Services 3.0.3. The system might be unstable if you run the previous versions of applications along with Common Services 3.0.3

–If you are upgrading from CiscoWorks Common Services 2.2 or CDOne, 5th Edition, the corresponding versions of other applications are disabled. After installation completes, data from the earlier versions is carried over to the new version and the active state of the products is restored.

–You must upgrade all LMS 2.5 applications to LMS 2.5.1, if you are upgrading from any of the following:

CiscoWorks Common Services 3.0 Service Pack 2

CiscoWorks Common Services 3.0 Service Pack 1

CiscoWorks Common Services 3.0

A warning message appears during the upgrade installation if you have the previous versions of the applications.

For example, if you have installed RME 4.0.0, CM 4.0.0, and DFM 2.0.0, and you are upgrading to Common Services 3.0.3, the following warning message appears:
This server has the following applications(s) installed:
RME 4.0.0 CM 4.0.0 DFM 2.0.0
The system might be unstable if you run the above versions of 
the application(s), along with CS 3.0.3.
Ensure that you upgrade the application(s) to:
RME 4.0.3 CM 4.0.3 DFM 2.0.3
We recommend that you upgrade all the applications on your server to the corresponding LMS 2.5.1 versions.

•If you have installed Device Fault Manager (DFM) on your system, and
HP OpenView Network Node Manager (HPOVNNM) or NetView is running on the same machine, you must stop HPOVNNM/NetView and proceed with the upgrade.

•Common Services 3.0.3 cannot co-exist with Qos Policy Manager (QPM). If you are upgrading from CiscoWorks Common Services 2.2 and if QPM is detected, the following error message appears:
Qos Policy Manager (QPM) is detected on this server. Common 
Services 3.0.3 cannot co-exit with QPM. We recommend that you 
either:
Install Common Services 3.0.3 on a separate server
Or
Restore the current setup with QPM on a separate server, uninstall 
QPM on this server, and then install Common Services 3.0.3.
You must either install Common Services 3.0.3 on a separate server or uninstall QPM and proceed with the upgrade on the same server.

CiscoWorks-ACS Task Registration During Upgrade and Re-installation

Common Services supports integration with CiscoSecure Access Control Server (ACS).

ACS provides authentication, authorization, and accounting services to network devices that function as AAA clients. ACS supports Common Services client applications by providing command authorization for network users who use the management application to configure managed network devices.

You can register all installed applications with the ACS server either through Common Services > Server > Security > AAA Mode Setup or through the AcsRegCli.pl command line script.

See User Guide for Ciscoworks Common Services 3.0.3 for more details on registering applications with ACS.

When an application having new tasks to be registered with ACS is installed, you are provided with an option to register that specific application with ACS during installation.

During the upgrade installation and re-installation of Common Services (with CiscoView), the installation framework might prompt you to confirm the application registration with ACS. This occurs if you have not already registered either Common Services or CiscoView or both with ACS.

This is applicable only when the server is already configured to be in ACS mode.

In this scenario, the following warning message appears:
The application that you are installing requires new tasks to be 
registered with ACS. If you have already registered this application 
with ACS from another server, you do not need to register it again. 
However if you re-register the application, you will lose any custom 
roles that you had created earlier for this application in ACS.
Enter (Y)es to Register, (N)o to continue without registering, (Q)uit: 
[N]
Enter N and continue the installation if you have registered the applications with ACS already from another server.

If you enter Y and continue the installation, the application will be registered with ACS. If the application is already registered with ACS, from a different server, you will lose any custom roles that you have created for the application in ACS

Enter Q to stop the installation

Even if you choose not to register the application with ACS during installation, you can do it later from the GUI or CLI, as mentioned above.

Running Installation Program—Upgrade Installation

To run the installation program:

Step 1 Install the required patches as described in the "Solaris Patches" section.

Step 2 As root, mount the CD-ROM using either:

•On the CiscoWorks server.

or

•On a remote Solaris system, and access the CD-ROM from the CiscoWorks server.

Caution Network inconsistencies may cause installation errors while installing from a remote mount point.

See "Mounting and Unmounting CD-ROM," for detailed mounting instructions.

Step 3 Run the installation program.

•For a local installation, enter:
# cd /cdrom/cdrom0/
# ./setup.sh 
•For a remote installation, enter:
# cd remotedir
# ./setup.sh
where remotedir is the remote location where the CD-ROM is mounted.

A message appears:
Press ENTER to read/browse the following License Agreement:
Step 4 Press Enter to read the license agreement.

The following message appears at the end of the license agreement:
You must accept this License Agreement to proceed with the 
installation.
If you enter N/n, the installation will exit.
Do you accept all the terms of the License Agreement? (y/n) [n]:
Step 5 Enter y to accept the license and proceed with the installation.

Or

Enter n or press Enter to deny and stop the installation.

During upgrade, if the installation program detects VPN monitor, or ACLM, or both, warning messages appear asking whether you want to continue upgrading on the same server, or install Common Services 3.0.3 on a separate server.

If you continue with the upgrade, the system uninstalls the software as part of RME 4.0 upgrade.

If you accept the license agreement and proceed with the installation, the following message appears:
The installation image is being accessed from a network 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.
Do you want to proceed? (y/n) [y]: 
This message appears only if you are installing the image from a network drive.

Step 6 Enter y.

The following message appears:
It is strongly recommended that you perform a backup before 
proceeding. Backing up will help you to preserve important data if you 
have to restore the previous version or install CiscoWorks on a new 
system.
Enter the backup directory:
Step 7 Enter the backup directory to proceed with the installation.

The installation program performs the backup.

•If backup fails, the following message appears:
Backup operation failed. Please look at Backup directory/backuplog 
for the reason for failure.
–Enter the backup directory again and try another backup.

Or

–Enter Exit to exit the installation.

If the backup fails during upgrade, check the backup log files and correct the backup errors specified in the backup log files.

If you still have the errors, contact the Technical Assistance Center (TAC). TAC will guide you how to proceed upgrading without taking a backup.

•If backup is completed, the following message appears:
Backup completed successfully
Error or warning messages appear if you do not have the required or recommended Server and Client patches.

We recommend you download and install the latest required and recommended patches from www.sunsolve.sun.com, before you run Common Services. For more information on Solaris patches, see "Solaris Patches" section.

•If any of the required Server patches is missing, the following message appears:
Installation can proceed without the required Server 
patches.However, you must install the required patches listed 
above before running CiscoWorks.
Do you want to continue the installation? (y/n) [y]:
•If you enter y and proceed with the installation, the following message appears:
Choose the type of Setup you prefer.
1) Typical installation.
Installs the product in the default location /opt/CSCOpx.
Allows you to select the components to be installed.
Prompts for CiscoWorks admin password and System Identity Account 
password.
Randomly generates CiscoWorks guest database passwords if they do 
not exist.
Recommended for most users.
2) Custom installation.
Allows you to select the product location.
Allows you to select components to be installed.
Prompts for CiscoWorks admin, guest, System Identity Account and 
database passwords if they do not exist.
Recommended for advanced users.
Select one of the installation modes using its number or (q) to 
quit [1]:
Step 8 Select one of the installation modes by entering the number corresponding to the mode.

The installation program performs several pre-installation and dependency checks on your system such as TCP/IP address resolution, TCP/IP port use, disk space, and RAM.

•If you have selected Typical, see the "Upgrade Installation—Typical" section to proceed with the installation.

•If you have selected Custom, see the "Upgrade Installation—Custom" section to proceed with the installation.

Upgrade Installation—Typical

To perform an upgrade installation using the Typical option:

Step 1 Press Enter to proceed with the installation after you select the Typical mode as given in Performing Upgrade Installation.

If you have a different set of components in the previous version, a message with the list of components will appear. The list of components varies based on the previous installation.

Select the components you want to install and continue with the installation.

The installation program calculates the minimum disk space required for installing the product.

•If the disk space is sufficient, a message appears:
Sufficient disk space.
•If the disk does not have enough space, an error message appears and the installation of Common Services exits.

Step 2 Enter the System Identity Account password and confirm it.

Note This step is applicable only if you are upgrading from CiscoWorks Common Services 2.2 or CD One, 5th Edition.

In a multi-server environment, you must configure all systems part of your multi-server setup with the same System Identity Account password.

For more information on passwords see "Password Information."

The installation program checks dependencies and system requirements and copies the files to the run time and the installation proceeds.

A message appears:
Exiting installation beyond this point might result in system 
instability.
Do you want to continue? (y/n) [y]
Step 3 Enter y to continue with the installation.

If you stop the installation after this point, the installation may become unstable and problems may occur when you try to install again.

The installation program:

•Installs Common Services in the directory where the earlier version is installed.

•Takes a while to complete the installation.

If you are installing from a network drive, the installation might take longer to complete. This happens especially for CiscoView device packages.

The following messages appear at the end of the installation:
Software Installation Tool Completed
Possible Warnings/Errors Encountered 
Any warning and error messages appear after these messages.

Step 4 Unmount the CD-ROM.

Step 5 See "Mounting and Unmounting CD-ROM," for details on unmounting the CD-ROM.

See "Checking for Installation Errors" section for details on installation errors

Upgrade Installation—Custom

To perform an upgrade installation using the Custom option:

Step 1 Press Enter to proceed with the installation after you select the Custom mode as given in Performing Upgrade Installation.

If you have a different set of components in the previous version, a message with the list of components will appear.The list of components varies based on the previous installation.

Select the components you want to install and continue with the installation.

The installation program calculates the minimum disk space required for installing the product.

•If the disk space is sufficient, the following message appears:
Sufficient disk space.
•If the disk does not have enough space, an error message appears and the installation of Common Services exits.

Step 2 Enter the CiscoWorks admin password and confirm it.

To preserve your earlier password, press Enter.

See "Password Information," for more information on the usage of passwords.

Step 3 Enter the CiscoWorks guest password and confirm it.

To preserve your earlier password, press Enter.

Step 4 Enter the System Identity Account password and confirm it.

If you are upgrading from CiscoWorks Common Services 3.0 Service Pack 2 or CiscoWorks Common Services 3.0 Service Pack 1 or CiscoWorks Common Services 3.0, you can either change the System Identity account password, or retain the existing password.

In a multi-server environment, you must configure all systems part of your multi-server setup with the same System Identity Account password.

For more information on passwords see "Password Information."

Step 5 Enter the Common Services Database password and confirm it.

To preserve your earlier password, press Enter.

See "Password Information," for detailed instructions on the usage of passwords.

The following message appears:
Do you want to preserve the existing SMTP Server Name? (y/n) [y]
Step 6 Press Enter or enter y to preserve the existing SMTP Server Name and proceed with the installation.

or

Enter n to get a new a new SMTP Server Name.

The following message appears:
Do you want to preserve the existing Apache Certificate? (y/n) [y]
Step 7 Press Enter or enter y to preserve the existing Apache Certificate and proceed with the installation.

or

Enter n to get a new a new Apache Certificate.

If you enter n, enter the following Apache certificate information:

–Host name

–Administrator's e-mail address

–Country

–State

–City

–Company

–Organization

Only the Host name is mandatory. Data for the other fields are optional. Press Enter to skip other fields.

•If you have not selected Integration Utility, go to Step 9.

•If you have selected Integration Utility, the following message appears:
The integration utility will be installed now. The integration 
utility integrates Cisco device packages and Cisco applications 
into third-party SNMP management platforms. You can choose to 
integrate with a third-party SNMP management platform during this 
installation or later.
Do you want to integrate with a third-party product now (y/n) [n]
Step 8 Select one of the following:

•n to integrate with a third-party NMS after installation. This completes the installation faster and avoids installation failure caused by errors in the third party integration.

•y to integrate with a third-party NMS during installation.

If you select y (integrate during installation):

a. Select the adapter from the list of available adapters, or select other to choose an adapter that is not listed (you will be prompted to enter the path name of the adapter), or select none to integrate after the installation is complete.

If you select none, go to Step 9.

Many third-party products allow you to launch CiscoWorks applications from within the third-party product. The CiscoWorks applications are launched in a web browser.

b. Enter the full pathname for the web browser.

A message appears prompting you to enable download future updates to NMIDB (Network Management Integration Data Bundle) directly from Cisco.com.

c. Select one of the following:

–n to disable future updates from Cisco.com.

–y to enable future updates from Cisco.com.

If you select n, go to Step 9.

d. Enter your Cisco.com user ID and password.

You must have Cisco.com login privileges. If you do not have a user account and password on Cisco.com, contact your channel partner or enter a request on the standard Cisco.com web site.

The installation program checks dependencies and system requirements and copies the files to the run time and the installation proceeds.

A message appears:
Do you want to see the passwords that were entered/randomly generated? 
(y/n) [y]
Step 9 Enter y to display randomly generated and manually entered passwords.

A message appears:
Exiting installation beyond this point might result in system 
instability.
Do you want to continue? (y/n) [y].
Step 10 Enter y to continue the installation

If you stop the installation after this point, the installation may become unstable and problems may occur when you try to install again.

The installation program:

•Installs Common Services in the directory where the earlier version is installed.

•Takes a while to complete the installation. No prompts for user inputs will be displayed during this time.

If you are installing from a network drive, the installation might take longer to complete. This happens especially for the installation of CiscoView device packages.

After installation is complete, the following messages appear:
Software Installation Tool Completed
Possible Warnings/Errors Encountered
Any warning and error messages appear after these messages.

Step 11 Unmount the CD-ROM.

See "Mounting and Unmounting CD-ROM," for details on unmounting the CD-ROM.

See "Checking for Installation Errors" section for details on installation errors.

Re-installing Common Services

You can re-install Common Services 3.0.3 by running the installation program on the system currently running the product.

Re-installation preserves the settings from the previous installation.

Re-installation overrides the previous installation. You can change the installation mode during re-installation.

Common Services 3.0.3 will automatically be installed in the same location, where the previous version was installed.

For information about application registration if the server is in ACS mode, see "Co-existence With Other CiscoWorks Applications During Upgrade" section.

Running Re-installation Program

To run the re-installation program:

Step 1 Install the required patches as described in the "Solaris Patches" section.

Step 2 As root, mount the CD-ROM using either:

•On the CiscoWorks server.

or

•On a remote Solaris system, and access the CD-ROM from the CiscoWorks server.

Caution Network inconsistencies may cause installation errors while installing from a remote mount point.

See "Mounting and Unmounting CD-ROM," for detailed mounting instructions.

Step 3 Run the installation program.

•For a local installation, enter:
# cd /cdrom/cdrom0/
# ./setup.sh 
•For a remote installation, enter:
# cd remotedir
# ./setup.sh
where remotedir is the remote location where the CD-ROM is mounted.

A message appears:
Press ENTER to read/browse the following License Agreement:
Step 4 Press Enter to read the license agreement.

The following message appears at the end of the license agreement:
You must accept this License Agreement to proceed with the 
installation.
If you enter N/n, the installation will exit.
Do you accept all the terms of the License Agreement? (y/n) [n]:
Step 5 Enter y to accept the license and proceed with the installation.

Or

Enter n or press Enter to deny and stop the installation.

If you enter y and proceed with the installation, the following message appears. This message appears only if you are installing the image from a network drive.

If you are installing the image from a network drive, the following message appears:
The installation image is being accessed from a network 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.
Do you want to proceed? (y/n) [y]: 
Step 6 Enter y.

The following message appears:
It is strongly recommended that you perform a backup before 
proceeding.Backing up will help you to preserve important data if you 
have to restore the previous version or install CiscoWorks on a new 
system.
Enter the backup directory:
Step 7 Enter the backup directory to proceed with the installation.

The installation program performs the backup.

•If backup fails, the following message appears:
Backup operation failed. Please look at Backup directory/backuplog 
for the reason for failure.
–Enter the backup directory again and try another backup.

Or

–Enter Exit to exit the installation.

•If backup has completed, the following message appears:
Backup completed successfully
Error or warning messages appear if you do not have the required or recommended Server and client patches.

We recommend you download and install the latest required and recommended patches from www.sunsolve.sun.com, before you run Common Services. For more information on Solaris patches, see "Solaris Patches" section.

•If any of the required Server patches are missing, the following message appears:
Installation can proceed without the required Server 
patches.However, you must install the required patches listed 
above before running CiscoWorks.
Do you want to continue the installation? (y/n) [y]:
•If you enter y and proceed with the installation, the following message appears:
Choose the type of Setup you prefer.
1) Typical installation.
Installs the product in the default location /opt/CSCOpx.
Allows you to select the components to be installed.
Prompts for CiscoWorks admin password and System Identity Account 
password.
Randomly generates CiscoWorks guest database passwords if they do 
not exist.
Recommended for most users.
2) Custom installation.
Allows you to select the product location.
Allows you to select components to be installed.
Prompts for CiscoWorks admin, guest, System Identity Account and 
database passwords if they do not exist.
Recommended for advanced users.
Select one of the installation modes using its number or (q) to 
quit [1]:
Step 8 Select one of the installation modes by entering the number corresponding to the mode.

The installation program performs several pre-installation and dependency checks on your system such as TCP/IP address resolution, TCP/IP port use, disk space, and RAM.

•If you have selected Typical, see the "Re-installation—Typical" section to proceed with the installation.

•If you have selected Custom, see the "Re-installation—Custom" section to proceed with the installation.

Re-installation—Typical

To perform a re-installation using the Typical option:

Step 1 Press Enter to proceed with the re-installation after you select the Typical mode as given in given in Re-installing Common Services.

A message appears:
Select the components you want to install.
1) Common Services 3.0.3
2) CiscoView 6.1.2
3) Integration Utility 1.6
4) All of the above
Select one or more items using its number separated by comma or enter 
q to quit:
Option (4) is recommended for most systems.

Step 2 Enter the number corresponding to the option you have chosen or q to quit.

You can select more than one component using the corresponding numbers separated by comma. For example, enter 1, 3 to select Common Services and Integration Utility.

The installation program calculates the minimum disk space required for installing the product.

•If the disk does not have enough space, an error message appears and the installation of Common Services exits.

•If the disk space is sufficient, the following message appears:
Sufficient disk space.
•If Common Services 3.0.3, CiscoView 6.1.2, and Integration Utility 1.6 have already been installed, the following message appears:
Common Services 3.0.3, CiscoView 6.1.2, Integration Utility 1.6 
has been detected on your system, are you sure you want to 
reinstall? (y/n) [n]:
Step 3 Enter y or press Enter to continue re-installation.

The installation program checks dependencies and system requirements and copies the files to the run time and the installation proceeds.

A message appears:
Do you want to see the passwords that were entered/randomly generated? 
(y/n) [y]
Step 4 Enter y to display randomly generated and manually entered passwords.

A message appears:
Exiting installation beyond this point might result in system 
instability.
Do you want to continue? (y/n) [y].
Step 5 Enter y to continue the installation

If you stop the installation after this point, the installation may become unstable and problems may occur when you try to install again.

The installation program takes a while to complete the installation.

If you are installing from a network drive, the installation might take longer to complete. This happens especially for CiscoView device packages.

The following messages appear at the end of the installation:
Software Installation Tool Completed
Possible Warnings/Errors Encountered
Any warning and error messages appear after these messages.

Step 6 Unmount the CD-ROM.

See "Mounting and Unmounting CD-ROM," for details on unmounting the CD-ROM.

See "Checking for Installation Errors" section for details on installation errors.

Re-installation—Custom

To perform a re-installation using the Custom option:

Step 1 Press Enter to proceed with the re-installation after you select the Custom mode as given in Re-installing Common Services.

A message appears:
Select the components you want to install.
1) Common Services 3.0.3
2) CiscoView 6.1.2
3) Integration Utility 1.6
4) All of the above
Select one or more items using its number separated by comma or enter 
q to quit:
Option (4) is recommended for most systems.

Step 2 Enter the number corresponding to the option you have chosen or q to quit.

You can select more than one component using the corresponding numbers separated by comma. For example, enter 1, 3 to select Common Services and Integration Utility.

The installation program calculates the minimum disk space required for installing the product.

•If the disk does not have enough space, an error message appears and the installation of Common Services exits.

•If the disk space is sufficient, the following messages appear:
Sufficient disk space.
Common Services 3.0.3, CiscoView 6.1.2, Integration Utility 1.6 
has been detected on your system, are you sure you want to 
reinstall? (y/n) [n]:
Step 3 Enter y or press Enter to continue re-installation.

Step 4 Enter the CiscoWorks admin password and confirm it.

To preserve your earlier password, press Enter.

For more information on passwords see "Password Information."

Step 5 Enter the guest password and confirm it.

To preserve your earlier password, press Enter.

For more information on passwords see "Password Information."

Step 6 Enter the System Identity Account password and confirm it.

You can either change the System Identity account password, or retain the existing password.

In a multi-server environment, you must configure all systems part of your multi-server setup with the same System Identity Account password.

For more information on passwords see "Password Information."

Step 7 Enter the Common Services Database password and confirm it.

To preserve your earlier password, press Enter.

For more information on passwords see "Password Information."

The following message appears:
Do you want to preserve the existing SMTP Server Name? (y/n) [y]
Step 8 Press Enter or enter y to preserve the existing SMTP Server Name and proceed with the installation.

or

Enter n to get a new a new SMTP Server Name.

The following message appears:
Do you want to preserve the existing Apache Certificate? (y/n) [y]
Step 9 Press Enter or enter y to preserve the existing Apache Certificate and proceed with the installation.

or

Enter n to get a new a new Apache Certificate.

If you enter n, enter the following Apache certificate information:

–Host name

–Administrator's e-mail address

–Country

–State

–City

–Company

–Organization

Only the Host name is mandatory. Data for the other fields are optional. Press Enter to skip other fields.

•If you have not selected integration Utility, go to Step 11

•If you have selected Integration Utility, the following message appears:
The integration utility will be installed now. The integration 
utility integrates Cisco device packages and Cisco applications 
into third-party SNMP management platforms. You can choose to 
integrate with a third-party SNMP management platform during this 
installation or later.
Do you want to integrate with a third-party product now (y/n) [n]
Step 10 Select one of the following:

•n to integrate with a third-party NMS after installation. This completes the installation faster and avoids installation failure caused by errors in the third party integration.

•y to integrate with a third-party NMS during installation.

If you select y (integrate during installation):

a. Select the adapter from the list of available adapters, or select other to choose an adapter that is not listed (you will be prompted to enter the path name of the adapter), or select none to integrate after the installation is complete.

If you select none, go to Step 11.

Many third-party products allow you to launch CiscoWorks applications from within the third-party product. The CiscoWorks applications are launched in a web browser.

b. Enter the full pathname for the web browser.

A message appears asking if you want to enable download updates to NMIDB (Network Management Integration Data Bundle) directly from Cisco.com.

c. Select one of the following:

–n to disable future updates from Cisco.com.

–y to enable future updates from Cisco.com.

If you select n, go to Step 11.

d. Enter your Cisco.com user ID and password.

You must have Cisco.com login privileges. If you do not have a user account and password on Cisco.com, contact your channel partner or enter a request on the standard Cisco.com web site.

The installation program checks dependencies and system requirements and copies the files to the run time and the installation proceeds.

A message appears:
Do you want to see the passwords that were entered/randomly generated? 
(y/n) [y]
Step 11 Enter y to display randomly generated and manually entered passwords.

A message appears:
Exiting installation beyond this point might result in system 
instability.
Do you want to continue? (y/n) [y].
Step 12 Enter y to continue the installation

If you stop the installation after this point, the installation may become unstable and problems may occur when you try to install again.

The installation program takes a while to complete the installation.

If you are installing from a network drive, the installation might take longer to complete. This happens especially for CiscoView device packages.

The following messages appear at the end of the installation:
Software Installation Tool Completed
Possible Warnings/Errors Encountered
Any warning and error messages appear after these messages.

Step 13 Unmount the CD-ROM.

See "Mounting and Unmounting CD-ROM," for details on unmounting the CD-ROM.

See "Checking for Installation Errors" section for details on installation errors.

Checking for Installation Errors

If errors occur during installation, check the installation log file /var/tmp/ciscoinstall.log. Each installation log appends to this file.

For troubleshooting information, see "Troubleshooting the Installation."

To prepare the client system for use, see "Preparing to Use CiscoWorks Common Services."

Verifying Installation

You can verify product installation by entering the command pdshow from /opt/CSCOpx/bin. The following services must be displayed.

•Apache

•CMFOGSServer

•CSRegistryServer

•CmfDbEngine

•CmfDbMonitor

•DCRServer

•EDS

•EDS-GCF

•EDS-TR

•ESS

•EssMonitor

•FDRewinder

•LicenseServer

•RmeGatekeeper

•RmeOrb

•Tomcat

•TomcatMonitor

•diskWatcher

•jrm

Uninstalling CiscoWorks Common Services

Use the Uninstall script to remove CD One files and settings.

Uninstall all applications dependent on Common Services before uninstalling Common Services. The uninstallation process will take approximately 10 minutes to complete.

Caution You must use the Uninstall script to remove the product. If you try to remove CD One or its components manually, you may damage your system.

To uninstall Common Services:

Step 1 As root, enter the following commands to start the uninstall script:
# cd /
# /opt/CSCOpx/bin/uninstall.sh
where /opt/CSCOpx is the default installation directory.

If you have installed applications dependent on Common Services, a list of applications appear.

Enter the number corresponding to the option you have chosen or q to quit. You can select more than one component. Enter the number corresponding to the components separated by comma.

When you remove CD One, the uninstall script removes changes made to the /etc/services file. The /etc directory still contains all system file changes. The uninstall messages gets appended to the /var/tmp/ciscouninstall.log file.

Step 2 Enter y to confirm uninstallation of the selected components.

The uninstallation proceeds.

After the uninstall is complete, the following messages appear:
All files were deleted successfully.
Possible Warnings/Errors Encountered
The installation program lists the warning and error messages.

Step 3 Check the following files:

•/etc/syslog.conf

For syslog changes.

•/etc/services

To ensure that port assignments for the CiscoWorks applications have been removed.

•/etc/inetd.conf

To ensure that CiscoWorks tftp entry is removed.