Installation and Setup Guide for CiscoWorks Common Services 3.0.5 (Includes CiscoView) on Solaris
Chapter 2: Installing CiscoWorks Common Services

Table Of Contents

Installing CiscoWorks Common Services

Installation Overview

Preparing to Install Common Services 3.0.5

Installation Notes

Using Server IP Address

TCP and UDP Ports Information

System Files Modified During Installation

Prerequisites for Installing Common Services 3.0.5

Installation Modes

New Installation—Typical

New Installation—Custom

Installing Common Services From Mounted Directory

Performing Upgrade Installation

Notes on Upgrade Installation for Common Services 3.0.5

Co-existence of CS 3.0.5 With Other CiscoWorks Applications During Upgrade

CiscoWorks-ACS Task Registration During Upgrade and Re-installation

Upgrade Installation for Common Services 3.0.5

Upgrade Installation—Typical

Upgrade Installation—Custom

Re-installing Common Services 3.0.5

Checking for Installation Errors for Common Services 3.0.5

Verifying CS 3.0.5 Installation

Uninstalling CiscoWorks Common Services 3.0.5


Installing CiscoWorks Common Services


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

Common Services 3.0.5 is an incremental patch that is bundled alongwith the LMS 2.6 Update CD.


Note You must install Common Services 3.0.3 before installing Common Services 3.0.5.


The installation process is explained in detail in the following sections:

Installation Overview

Preparing to Install Common Services 3.0.5

Prerequisites for Installing Common Services 3.0.5

Installation Modes

Installing Common Services From Mounted Directory

Performing Upgrade Installation

Upgrade Installation for Common Services 3.0.5

Re-installing Common Services 3.0.5

Checking for Installation Errors for Common Services 3.0.5

Verifying CS 3.0.5 Installation

Uninstalling CiscoWorks Common Services 3.0.5

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.


Note You can install CS 3.0.5 only after installing CS 3.0.3.


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 on page 1-3

2. Verify client requirements are met.

"Client Requirements" section on page 1-5

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, a message appears that it is in the LISTEN state.

"TCP and UDP Ports Information" section

Install Common Services.

Run the installation program.

"Prerequisites for Installing Common Services 3.0.5" section

"Performing Upgrade Installation" section

"Re-installing Common Services 3.0.5" section

Verify and troubleshoot installation.

Analyze installation error messages.

"Understanding Installation Error Messages" section on page A-3


Preparing to Install Common Services 3.0.5

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 Chapter 1, "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 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

Prerequisites for Installing Common Services 3.0.5

You need to perform a series of procedures to install Common Services 3.0.5. Before installing Common Services 3.0.5, you must first ensure that CS 3.0.3 is installed. To do this:


Step 1 Install CS 3.0.3

For a fresh installation, you must proceed by first installing CS 3.0.3.


Note Make sure you upgrade all applications to LMS 2.5.1 level and then only proceed to install from the LMS 2.6 Update CD ROM.


Step 2 Install CS 3.0.5

After installing CS 3.0.3, you must proceed with installing CS 3.0.5.

Step 3 Verify the installation

After installing CS 3.0.5, you must verify the installation.

For verifying installation, see Verifying CS 3.0.5 Installation


Installation Modes

You can install CS 3.0.5 either using either the Typical or the Custom mode:

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.

The CD One installation program takes around 45 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.5 (Includes CiscoView 6.1.5) and Release Notes for CiscoWorks Common Services 3.0.5 ( Includes CiscoView 6.1.5) on Solaris.

New Installation—Typical

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

To install CS 3.0.5, you must first install CS 3.0.3 using the Typical mode, from the LMS 2.5.1 CD (install CS 3.0.3 from the CD One 3.0.3 CD ROM), and then proceed with installing CS 3.0.5 from the LMS 2.6 Update CD-ROM. To proceed with the installation:


Step 1 Install the required patches as described in the "Solaris Patches" section on page 1-4.

Step 2 Mount the CS 3.0.3 CD-ROM as root. You can either:

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 Appendix B, "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 either:

Y and press Enter to accept the license and proceed with the installation.

Or

N and 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]:

Step 6 Press Y to continue.

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 on page 1-4.

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 7 Press either:

Enter to proceed with the installation after you select the Typical mode as given in Prerequisites for Installing Common Services 3.0.5.

Or

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:

We recommend Option (4) for most systems.

Step 8 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 9 Enter the CiscoWorks admin password and confirm it.

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

The installation program generates a random password for guest user.

Step 10 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 Appendix C, "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 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.

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 messages appear:

Software Installation Tool Completed

Possible Warnings/Errors Encountered

Any warning and error messages appear after these messages.

Step 13 Unmount the CD-ROM.

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

Your Solaris machine has CS 3.0.3 installed successfully.

Now, from the LMS 2.6 Update CD ROM you need to install CS 3.0.5.

To install Common Services 3.0.5 from the LMS 2.6 Update CD:

Step 14 Install the required patches as described in the "Solaris Patches" section on page 1-4.

Step 15 Mount the LMS 2.6 Update CD-ROM. You can either:

Mount the LMS 2.6 Update CD-ROM on the system.

or

Mount the LMS 2.6 Update 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 Appendix B, "Mounting and Unmounting CD-ROM," for detailed mounting instructions.

Step 16 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 Welcome message appears:

Welcome to CiscoWorks LMS 2.6 Update setup program.

Step 17 Select CiscoWorks Common Services 3.0.5 update to install Common Services 3.0.5.

A message appears:

Press ENTER to read/browse the following License Agreement:

Step 18 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]:


Note Error messages or warning messages appear if you do not have the required or recommended Server and Client patches.


Step 19 Enter Y and press Enter to accept the license and proceed with the installation.

Step 20 While installing from the network drive, the Installing from Network Drive message appears.

Installation from network drive will be slower when compared to installing from the local drive.

Click Y to proceed or N to exit installation.

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 on page 1-4.

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]:

Step 21 If you have not installed all the LMS 2.5.1 applications before installng the LMS 2.6 Update, the installation aborts with the following error message (for example, if Resource Manager Essentials 4.0.3 application was not installed):

ERROR: Install Resource Manager Essentials 4.0.3 before updating to Resource Manager Essentials 4.0.5.

ERROR: See the ReadMe and the Installation Guide for details.

Step 22 Enter Y to continue the installation.

The new updates to be installed will be listed as follows:

New Updates to be installed :

CiscoWorks Common Services 3.0.5 update

CiscoView 6.1.5 update

Resource Manager Essentials 4.0.5 update

Campus Manager 4.0.6 update

Device Fault Manager 2.0.6 update

Do you want to continue the installation:? (y/n) [y]

Press Y to update the applications listed.


Note The other applications you installed during the LMS 2.5.1 installation will also be listed in the above list.


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

WARNING: Exiting installation beyond this point might result in system instability.

Do you want to continue the installation? (y/n) [y]:
Press Y to continue.

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 messages appear:

Software Installation Tool Completed

Possible Warnings/Errors Encountered

Warning and error messages that had appeared during installation will now appear as a list after these messages.

Step 23 Unmount the CD-ROM.

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

Your Solaris machine has CS 3.0.5 installed successfully.


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

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

For troubleshooting information, see Appendix A, "Troubleshooting the Installation."

New Installation—Custom

To install CS 3.0.5, you must first install CS 3.0.3 using the Custom mode, from the LMS 2.5.1 CD (install CS 3.0.3 from the CD One 3.0.3 CD ROM), and then proceed with installing CS 3.0.5 from the LMS 2.6 Update CD-ROM:


Step 1 Install the required patches as described in the "Solaris Patches" section on page 1-4.

Step 2 Mount the CS 3.0.3 CD-ROM as root. You can either:

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 Appendix B, "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 either:

Y and press Enter to accept the license and proceed with the installation.

Or

N and 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]:

Step 6 Press Y to continue.

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 on page 1-4.

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 7 Press either:

Enter to proceed with the installation after you select the Custom mode as given in Prerequisites for Installing Common Services 3.0.5.

Or

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]:


Note The Custom path or location you specify cannot be the sub-directory of /opt/CSCOpx.



Caution Do not remove the link after installation. Common Services will not work without this symbolic link.

Step 8 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:

We recommend Option (4) for most systems.

Step 9 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 10 Enter the CiscoWorks admin password and confirm it.

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

Step 11 Enter the guest password and confirm it.

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

Step 12 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 Appendix C, "Password Information."

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

While entering the CiscoWorks Casuser passwords, use a minimum of eight characters.

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

Step 14 Enter the SMTP server name.

Step 15 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 from the selection list, go to Step 17

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 16 Enter either:

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 any of the following:

The adapter from the list of available adapters,

Other to choose an adapter that is not listed (you are prompted to enter the path name of the adapter),

None to integrate after the installation is complete.

If you select None, go to Step 17.

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:

N to disable future updates from Cisco.com.

Y to enable future updates from Cisco.com.

If you select N, go to Step 17.

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 17 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 18 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.

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 19 Unmount the CD-ROM.

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

Your Solaris machine has CS 3.0.3 installed successfully.

Now, from the LMS 2.6 Update CD ROM you need to install CS 3.0.5.

To install Common Services 3.0.5 from the LMS 2.6 Update CD:

Step 20 Install the required patches as described in the "Solaris Patches" section on page 1-4.

Step 21 Mount the LMS 2.6 Update CD-ROM as root. You can either:

Mount the LMS 2.6 Update CD-ROM on the system.

or

Mount the LMS 2.6 Update 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 Appendix B, "Mounting and Unmounting CD-ROM," for detailed mounting instructions.

Step 22 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 Welcome message appears:

Welcome to CiscoWorks LMS 2.6 Update setup program.

Step 23 Select CiscoWorks Common Services 3.0.5 update to install Common Services 3.0.5.

A message apears:

Press ENTER to read/browse the following License Agreement:

Step 24 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]:


Note Error messages or warning messages appear if you do not have the required or recommended Server and Client patches.


Step 25 Enter Y and press Enter to accept the license and proceed with the installation.

Step 26 While installing from the network drive, the Installing from Network Drive message appears.

Installation from network drive will be slower when compared to installing from the local drive.

Click Y to proceed or N to exit installation.

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 on page 1-4.

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]

Step 27 If you have not installed all the LMS 2.5.1 applications before installng the LMS 2.6 Update, the installation aborts with the following error message (for example, if Resource Manager Essentials 4.0.3 application was not installed):

ERROR: Install Resource Manager Essentials 4.0.3 before updating to Resource Manager Essentials 4.0.5.

ERROR: See the ReadMe and the Installation Guide for details.

Step 28 Enter Y to continue the installation.

The new updates to be installed will be listed as follows:

New Updates to be installed :

CiscoWorks Common Services 3.0.5 update

CiscoView 6.1.5 update

Resource Manager Essentials 4.0.5 update

Campus Manager 4.0.6 update

Device Fault Manager 2.0.6 update

Do you want to continue the installation:? (y/n) [y]:

Press Y to update the applications listed.


Note The other applications you installed during the LMS 2.5.1 installation will also be listed in the above list.


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

WARNING: Exiting installation beyond this point might result in system instability.

Do you want to continue the installation? (y/n) [y]:
Enter Y to continue.

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 messages appear:

Software Installation Tool Completed

Possible Warnings/Errors Encountered

Warning and error messages that had appeared during installation will now appear as a list after these messages.

Step 29 Unmount the CD-ROM.

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

Your Solaris machine has CS 3.0.5 installed successfully.


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

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

For troubleshooting information, see Appendix A, "Troubleshooting the Installation."

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 Appendix B, "Mounting and Unmounting CD-ROM," for detailed mounting instructions.


Performing Upgrade Installation

This section contains:

Notes on Upgrade Installation for Common Services 3.0.5

Co-existence of CS 3.0.5 With Other CiscoWorks Applications During Upgrade

CiscoWorks-ACS Task Registration During Upgrade and Re-installation

Common Services 3.0.5 supports upgrade from:

CiscoWorks Common Services 3.0.4

CiscoWorks Common Services 3.0.3

The data is preserved when you perform an upgrade.

For a description of the different upgrade paths and their results for 3.0.3/3.0.5, see "Table 1-1Upgrade Paths" section on page 1-2.

Notes on Upgrade Installation for Common Services 3.0.5

Note the following before you start upgrading to Common Services 3.0.5:

You can upgrade to Common Services 3.0.5 by installing the new version on the system that is currently running a previous version of either CS 3.0.3 or CS 3.0.4.

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

Note the following before 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 the 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. To do this press Enter or enter Y when you are prompted to preserve this certificate.

Co-existence of CS 3.0.5 With Other CiscoWorks Applications During Upgrade

The following notes give details on the co-existence of Common Services 3.0.5 with other CiscoWorks applications:

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

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

CiscoWorks Common Services 3.0.4

CiscoWorks Common Services 3.0.3

The following notes give details on the co-existence of Common Services 3.0.3 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 or Core 1.0, 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-exist 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).


Note ACS Task Registration During Upgrade and Re-installation is common for both Common Services 3.0.5 as well as Common Services 3.0.3.


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.5 and 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.

Upgrade Installation for Common Services 3.0.5

Upgrade installation to CS 3.0.5 can be performed as follows:

If you have CS 3.0 Service Pack 2 or CS 3.0 Service Pack 1 or CS 3.0 already installed on your machine, you must upgrade to CS 3.0.3 by following the steps below and then upgrade to CS 3.0.5.

You can upgrade install CS 3.0.5 using either the Typical or the Custom mode:

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 upgrade install CS 3.0.5, you must first upgrade to CS 3.0.3 using the Typical mode, from the LMS 2.5.1 CD (install CS 3.0.3 from the CD One 3.0.3 CD ROM), and then proceed with installing CS 3.0.5 from the LMS 2.6 Update CD-ROM. To proceed with the installation:


Step 1 Install the required patches as described in the "Solaris Patches" section on page 1-4.

Step 2 Mount the CS 3.0.3 CD-ROM, as root. You can mount it 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 Appendix B, "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 either:

Y and press Enter to accept the license and proceed with the installation.

Or

N and 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 continue 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 on page 1-4.

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 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 9 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 Appendix C, "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 10 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. It a 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 11 Unmount the CD-ROM.

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

Your Solaris machine has upgraded to CS 3.0.3 successfully.

Now, from the LMS 2.6 Update CD ROM you need to install CS 3.0.5.

To install Common Services 3.0.5 from the LMS 2.6 Update CD:

Step 13 Install the required patches as described in the "Solaris Patches" section on page 1-4.

Step 14 Mount the LMS 2.6 Update CD-ROM as root. You can either:

Mount the LMS 2.6 Update CD-ROM on the system.

or

Mount the LMS 2.6 Update 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 Appendix B, "Mounting and Unmounting CD-ROM," for detailed mounting instructions.

Step 15 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 Welcome message appears:

Welcome to CiscoWorks LMS 2.6 Update setup program.

Step 16 Select CiscoWorks Common Services 3.0.5 update to install Common Services 3.0.5.

A message appears:

Press ENTER to read/browse the following License Agreement:

Step 17 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]:


Note Error messages or warning messages appear if you do not have the required or recommended Server and Client patches.


Step 18 Enter Y and press Enter to accept the license and proceed with the installation.

Step 19 While installing from the network drive, the Installing from Network Drive message appears.

Installation from network drive will be slower when compared to installing from the local drive.

Click Y to proceed or N to exit installation.

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 on page 1-4.

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]:

Step 20 If you have not installed all the LMS 2.5.1 applications before installng the LMS 2.6 Update, the installation aborts with the following error message (for example, if Resource Manager Essentials 4.0.3 application was not installed):

ERROR: Install Resource Manager Essentials 4.0.3 before updating to Resource Manager Essentials 4.0.5.

ERROR: See the ReadMe and the Installation Guide for details.

Step 21 Enter Y to continue the installation.

The new updates to be installed will be listed as follows:

New Updates to be installed :

CiscoWorks Common Services 3.0.5 update

CiscoView 6.1.5 update

Resource Manager Essentials 4.0.5 update

Campus Manager 4.0.6 update

Device Fault Manager 2.0.6 update

Do you want to continue the installation:? (y/n) [y]:

Press Y to update the applications listed.


Note The other applications you installed during the LMS 2.5.1 installation will also be listed in the above list.


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

WARNING: Exiting installation beyond this point might result in system instability.

Do you want to continue the installation? (y/n) [y]:
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 messages appear:

Software Installation Tool Completed

Possible Warnings/Errors Encountered

Warning and error messages that had appeared during installation will now appear as a list after these messages.

Step 22 Unmount the CD-ROM.

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

Your Solaris machine has been upgraded to CS 3.0.5 successfully.


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

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

For troubleshooting information, see Appendix A, "Troubleshooting the Installation."

Upgrade Installation—Custom

To upgrade install CS 3.0.5, you must first upgrade to CS 3.0.3 using the custom mode, from the LMS 2.5.1 CD (install CS 3.0.3 from the CD One 3.0.3 CD ROM), and then proceed with installing CS 3.0.5 from the LMS 2.6 Update CD-ROM:


Step 1 Install the required patches as described in the "Solaris Patches" section on page 1-4.

Step 2 Mount the CS 3.0.3 CD-ROM, as root. You can mount it 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 Appendix B, "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 either :

Y and press Enter to accept the license and proceed with the installation.

Or

N and 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 continue 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 on page 1-4.

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 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 9 Enter the CiscoWorks admin password and confirm it.

To preserve your earlier password, press Enter.

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

Step 10 Enter the CiscoWorks guest password and confirm it.

To preserve your earlier password, press Enter.

Step 11 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 Appendix C, "Password Information."

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

To preserve your earlier password, press Enter.

See Appendix C, "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 13 Press either:

Enter or Y to preserve the existing SMTP Server Name and proceed with the installation.

Or

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 14 Press either:

Enter or Y to preserve the existing Apache Certificate and proceed with the installation.

Or

N to get 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 from the selection list, go to Step 16.

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 15 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 any of the following:

The adapter from the list of available adapters,

Other to choose an adapter that is not listed (you are prompted to enter the path name of the adapter),

None to integrate after the installation is complete.

If you select None, go to Step 17.

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

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 16 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 17 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. It 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 18 Unmount the CD-ROM.

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

Your Solaris machine has upgraded to CS 3.0.3 successfully.

Now, from the LMS 2.6 Update CD ROM you need to install CS 3.0.5.

To install Common Services 3.0.5 from the LMS 2.6 Update CD:

Step 19 Install the required patches as described in the "Solaris Patches" section on page 1-4.

Step 20 Mount the LMS 2.6 Update CD-ROM as root. You can either:

Mount the LMS 2.6 Update CD-ROM on the system.

or

Mount the LMS 2.6 Update 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 Appendix B, "Mounting and Unmounting CD-ROM," for detailed mounting instructions.

Step 21 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 Welcome message appears:

Welcome to CiscoWorks LMS 2.6 Update setup program.

Step 22 Select CiscoWorks Common Services 3.0.5 update to install Common Services 3.0.5.

A message appears:

Press ENTER to read/browse the following License Agreement:

Step 23 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]:


Note Error messages or warning messages appear if you do not have the required or recommended Server and Client patches.


Step 24 Enter Y and press Enter to accept the license and proceed with the installation.

Step 25 While installing from the network drive, the Installing from Network Drive message appears.

Installation from network drive will be slower when compared to installing from the local drive.

Click Y to proceed or N to exit installation.

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 on page 1-4.

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]:

Step 26 If you have not installed all the LMS 2.5.1 applications before installng the LMS 2.6 Update, the installation aborts with the following error message (for example, if Resource Manager Essentials 4.0.3 application was not installed):

ERROR: Install Resource Manager Essentials 4.0.3 before updating to Resource Manager Essentials 4.0.5.

ERROR: See the ReadMe and the Installation Guide for details.

Step 27 Enter Y to continue the installation.

The new updates to be installed will be listed as follows:

New Updates to be installed :

CiscoWorks Common Services 3.0.5 update

CiscoView 6.1.5 update

Resource Manager Essentials 4.0.5 update

Campus Manager 4.0.6 update

Device Fault Manager 2.0.6 update

Do you want to continue the installation:? (y/n) [y]:

Press Y to update the applications listed.


Note The other applications you installed during the LMS 2.5.1 installation will also be listed in the above list.


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

WARNING: Exiting installation beyond this point might result in system instability.

Do you want to continue the installation? (y/n) [y]:
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 messages appear:

Software Installation Tool Completed

Possible Warnings/Errors Encountered

Warning and error messages that had appeared during installation will now appear as a list after these messages.

Step 28 Unmount the CD-ROM.

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

Your Solaris machine has been upgraded to CS 3.0.5 successfully.


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

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

For troubleshooting information, see Appendix A, "Troubleshooting the Installation."

Re-installing Common Services 3.0.5

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

Re-installation preserves the settings from the previous installation.

Common Services 3.0.5 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 "CiscoWorks-ACS Task Registration During Upgrade and Re-installation" section.

To reinstall Common Services 3.0.5 from the LMS 2.6 Update CD:


Step 1 Install the required patches as described in the "Solaris Patches" section on page 1-4.

Step 2 Mount the LMS 2.6 Update CD-ROM as root. You can either:

Mount the LMS 2.6 Update CD-ROM on the system.

or

Mount the LMS 2.6 Update 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 Appendix B, "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 Welcome message appears:

Welcome to CiscoWorks LMS 2.6 Update setup program.

Step 4 Select CiscoWorks Common Services 3.0.5 update to install Common Services 3.0.5.

A message appears:

Press ENTER to read/browse the following License Agreement:

Step 5 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]:


Note Error messages or warning messages appear if you do not have the required or recommended Server and Client patches.


Step 6 Enter Y and press Enter to accept the license and proceed with the installation.

Step 7 While installing from the network drive, the Installing from Network Drive message appears.

Installation from network drive will be slower when compared to installing from the local drive.

Click Y to proceed or N to exit installation.

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 on page 1-4.

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]:

Step 8 If you have not installed all the LMS 2.5.1 applications before installng the LMS 2.6 Update, the installation aborts with the following error message (for example, if Resource Manager Essentials 4.0.3 application was not installed):

ERROR: Install Resource Manager Essentials 4.0.3 before updating to Resource Manager Essentials 4.0.5.

ERROR: See the ReadMe and the Installation Guide for details.

Step 9 Enter Y to continue the installation.

The new updates to be installed will be listed as follows:

Updates already installed :

CiscoWorks Common Services 3.0.5 update

CiscoView 6.1.5 update

Resource Manager Essentials 4.0.5 update

Campus Manager 4.0.6 update

Device Fault Manager 2.0.6 update

Do you want to continue the installation:? (y/n) [y]:

Press Y to update the applications listed.


Note The other applications you installed during the LMS 2.5.1 installation will also be listed in the above list.


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

WARNING: Exiting installation beyond this point might result in system instability.

Do you want to continue the installation? (y/n) [y]:
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 messages appear:

Software Installation Tool Completed

Possible Warnings/Errors Encountered

Warning and error messages that had appeared during installation will now appear as a list after these messages.

Step 10 Unmount the CD-ROM.

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

Your Solaris machine has been reinstalled CS 3.0.5 successfully.


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

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

For troubleshooting information, see Appendix A, "Troubleshooting the Installation."

Checking for Installation Errors for Common Services 3.0.5

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 Appendix A, "Troubleshooting the Installation."

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

Verifying CS 3.0.5 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 3.0.5

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 Enter the following commands as root 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 commas.

When you remove CD One (all the CiscoWorks applications), 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/Ciscoworks_uninstall_20060623_102035.log.

The Uninstallation dialog box appears with the installed components.

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.