Installation and Setup Guide for Resource Manager Essentials 3.4 on Solaris
Installing Essentials
Downloads: This chapterpdf (PDF - 278.0KB) | Feedback

Installing Essentials

Table Of Contents

Installing Essentials

Product Overview

Installation Overview

Preparing to Install Essentials

Essentials Upgrade Paths

Server Requirements and Recommendations

Minimum Server Requirements

Server Recommendations

Client Requirements

Supported NMS Environments for Device Import

Supported Devices

Installing Essentials

Performing a New Installation

Running the Installation Program for a New Installation

Upgrading Essentials Data from a Remote Machine

Upgrading from a Previous Version

Backing Up Your Previous Database

Changing Your Database Password

Running the Installation Program for an Upgrade

Backing Up the Converted Database

Reinstalling or Upgrading from the Evaluation Version

Backing Up Your Previous Database

Running the Installation Program to Reinstall

Uninstalling Essentials


Installing Essentials


This chapter describes installing Resource Manager Essentials 3.4 on a Solaris system. It consists of:

Product Overview

Installation Overview

Preparing to Install Essentials

Installing Essentials

Uninstalling Essentials

Product Overview

Resource Manager Essentials (Essentials), one of the major components of CiscoWorks2000, enables the deployment, monitoring, and configuration of devices across your network. Essentials is a suite of web-based network management tools integrated into a network desktop that includes a web-server component, web-based tools, and web-browser capability. This product is based on a client/server network architecture that connects multiple web-based clients to a network server.

The Essentials 3.4 CD-ROM contains two installable packages: Essentials and Incremental Device Support (IDS). IDS enables you to download device support from Cisco.com for newly supported devices.

Installation Overview

Table 1-1 is an overview of the Essentials installation. It contains references to more detailed information about each task.

Table 1-1 Installing Essentials Overview 

Task
Steps
References

1. Prepare to install Essentials.

Verify that requirements are met.

"Preparing to Install Essentials" section

2. Install Essentials.

a. Mount the CD-ROM.

"Performing a New Installation" section
or

"Upgrading from a Previous Version" section
or

"Reinstalling or Upgrading from the Evaluation Version" section

b. Run the installation program.

3. Troubleshoot the installation.

Analyze installation error messages.

"Troubleshooting the Installation"

4. Perform post-installation tasks.

Configure the system and set up Essentials applications.

"Preparing to Use Essentials Applications"


Before you begin your installation, note the following:

You must install CD One, 5th Edition. Resource Manager Essentials 3.4 can be installed only after you have installed CD One, Fifth Edition. See Installation and Set Up Guide for CDOne, 5th Edition on Solaris for more information.

The install script will find the CD One directory and install Essentials at the same location.

You must install both RME and IDS packages.

Preparing to Install Essentials

This section describes prerequisites and other factors you should consider before installing Essentials. This consists of:

Essentials Upgrade Paths

Server Requirements and Recommendations

Client Requirements

Supported NMS Environments for Device Import

Supported Devices


Caution Do not change the system time after installing Essentials. Such changes may affect the working of some time-dependent features.

Essentials Upgrade Paths

You can upgrade directly to Essentials 3.4 from Essentials 3.3 and only.

Server Requirements and Recommendations

This section describes the server requirements and recommendations for CiscoWorks2000 CD One plus Essentials.

Minimum Server Requirements


Note You have to install CD One, 5th Edition, before you install Essentials 3.4.


The minimum system requirements for a CiscoWorks2000 Server running the CD One and Essentials software are shown in Table 1-2.

Table 1-2 Server System Minimum Requirements  

Requirement Type
Minimum Requirements

System hardware

Sun Ultra 10, Ultra 60 or UltraSparc III based machines like Sun-Fire-280R, Netra-T4 or Sun Blade 1000 running Solaris versions 2.7 or 2.8. Essentials supports US-English and Japanese versions of Solaris. Set default locale to US-English.

Memory (RAM)

256 MB

Available drive space1

4 GB on the partition on which you install the product (the default is /opt)2

Enough space for downloaded Software Management files3

Swap space must be double the amount of memory (RAM). For example, if your system has 256 MB of RAM, you need 512 MB of swap space.

Additional required software

CiscoWorks2000 CD One must be installed before you install Essentials. Refer to Installation and Setup Guide for CD One, 5th Edition on Solaris.

1 To verify available disk space, see the instructions in this section.

2 Essentials is installed in the same directory as CiscoWorks2000 CD One.

3 For information about downloaded files, see the "Setting Up Software Management" section.


To verify the amount of available disk space in each of the specified partitions and directories, enter:

# df -k directory

Server Recommendations

To select or configure a server system that best meets your needs, consider:

The number of managed devices to be polled by the Availability application

The number of Syslog messages expected daily

The number of managed devices expected in the Inventory and Configuration Management applications

Availability is the primary consideration. After that, you can consider syslog messages and managed device expectations, and determine your needs accordingly. These factors affect server performance and user report response time

Table 1-3 shows the recommendations for a server running CiscoWorks2000 CD One and Essentials. These recommendations produce optimal response time when running user reports.

Client Requirements

The minimum client system requirements for CiscoWorks2000 CD One and Essentials are shown in Table 1-3.

Before you can access Essentials from a client system, the system must be properly configured. For more information about client system requirements and configuring clients, see Installation and Setup Guide for CD One, 5th Edition on Solaris.

Table 1-3 Client System Requirements Summary 

Requirement Type
Minimum Requirement

System Software and Hardware

Client system:

IBM PC-compatible computer with 300 MHz Pentium processor running Windows NT 4.0 Workstation or server, Windows 98 or Windows 2000 Professional or Server or Windows XP. Essentials supports only US-English and Japanese versions of Windows 2000. Set the default locale to US-English.

Sun Ultra 10 running Solaris versions 2.6, 2.7 and 2.8.

IBM RS/ 6000 workstation running AIX 4.3.3.

HP-UX workstation running HP-UX 11.0.

Color monitor with video card set to 256 colors.

Memory (RAM)

128 MB.

Browser

One of these browsers:

Microsoft Internet Explorer 5.5 (with Service Pack 2) and 6.0.
Java Virtual Machine (JVM) versions 5.0.0.3182 or current shipping version.
(Windows NT, Windows 98, Windows 2000, or Windows XP)
To verify the JVM version, select View > Java Console.

Netscape Navigator 4.76 (Solaris version 2.6)

Netscape Navigator 4.77, 4.78, 4.79.
(Windows NT, Windows 98, or Windows 2000, or Windows XP
HP-UX 11.0, AIX 4.3.3)


Supported NMS Environments for Device Import

The Essentials Inventory application can import device information from both local and remote network management systems (NMS).

Table 1-4 and Table 1-5 show the NMSs supported for importing device information into the Essentials inventory. You can import devices remotely from a UNIX system only.

Table 1-4 Supported NMS Software for Local Device Import 

Software
Version

Campus Manager

3.2

Cisco WAN Manager

10.4 and 10.5

HP OpenView Network Node Manager

5.0, 6.0, 6.1, 6.2

NetView

6.0 and 6.0.1


Table 1-5 Supported NMS Software for Remote Device Import1  

Software
Version

Campus Manager

3.1 or 3.2(ANI)

Cisco WAN Manager

9.1, 9.2, 10.4 and 10.5

CWSI (CiscoWorks for Switched Internetworks)

2.4

HP OpenView Network Node Manager

5.01, 6.0, 6.1, 6.2

NetView

5.1, 6.0 and 6.0.1

5.1, 6.0 on AIX

1 You can remotely import device information from UNIX systems only.


For more information, see the "Adding or Importing Inventory Data" section or refer to the online help.

Supported Devices

Essentials 3.4 supports most of the devices supported in previous versions of Essentials as well as new devices. Device adapter packages for all supported devices are installed when you install Essentials. Information about these devices is at:
http://www.cisco.com/univercd/cc/td/doc/product/rtrmgmt/cw2000/
cw2000e/index.htm.

You can download device packages for new devices and find information about new device support from CCO at www.cisco.com.

To see a list of the device packages installed on your server, select Server Configuration > About the Server > Applications and Versions. Click on the Inventory Manager link to see specific device information.

Installing Essentials

This section describes the following tasks:

Performing a New Installation

Upgrading from a Previous Version

Reinstalling or Upgrading from the Evaluation Version


Note You must install CiscoWorks2000 CD One before you can install Essentials. Refer to Installation and Setup Guide for CD One, 5th Edition on Solaris.


Performing a New Installation

This section describes how to perform a new installation. If you are upgrading on a system that had a previous version of Essentials installed, see the "Upgrading from a Previous Version" section. If you are reinstalling Essentials 3.4 or upgrading from an evaluation version of Essentials 3.4, see the "Reinstalling or Upgrading from the Evaluation Version" section.


Note If you want to import data from a previous version of Essentials that resides on a different server, follow the procedure in this section to perform a new installation. After installing Essentials, follow the procedure in the "Uninstalling Essentials" section to import the data.


Running the Installation Program for a New Installation

The Essentials installation takes approximately 30 minutes.

You can press Ctrl-C at any time to end the installation. However, any changes to your system (for example, installation of new files or changes to system files) will not be undone.

The installation program installs Essentials in the same location as CD One (/opt/CSCOpx by default) and starts CiscoWorks2000.


Step 1 As root, mount the Essentials CD-ROM. You can either:

Mount the CD-ROM on the CiscoWorks2000 Server system.

or

Mount the CD-ROM on a remote Solaris system, then access the CD-ROM from the CiscoWorks2000 Server system.

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

Step 2 Start 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.

The installation program checks for required patches and other dependencies and displays:

1) Resource Manager Essentials
2) Resource Manager Essentials Incremental Device Support
3) All of the above
Select one of the items using its number or enter q to quit [q]


Note Option 3 is the most likely choice for new installations of Essentials 3.4. If you try to install only one of the components without the other already on your machine, the installation fails.


Step 3 Enter 3 and press Return. The installation program checks dependencies and system requirements.

If there is not enough disk space to install Essentials and IDS, the installation program displays an error message and stops.

If the minimum requirements are not met, the installation program displays an error message and continues with the installation.

Step 4 The Installation program displays, "For security reasons Cisco recommends that you change the default password for RME database. Do you want to change the RME Database Password?"

Step 5 Do one of the following:

Enter "y" to change password.

Enter the new password.

Re-enter the password against the Confirm Password prompt.

Enter "n" to retain the old password.

The installation completes without displaying more questions, and the system prompt appears.

Step 6 Unmount and eject the CD-ROM. For details, see "Mounting and Unmounting the CD-ROM"


If you had any errors, check the installation log file /var/tmp/ciscoinstall.log. For other troubleshooting information, see "Troubleshooting the Installation".

Upgrading Essentials Data from a Remote Machine

If you have installed Essentials 3.4, and you also have Essentials 3.3 on another server, you will have to upgrade the existing data to Essentials 3.4.


Note You must upgrade CD One data before you can upgrade Essentials data.


Upgrading data from a remote machine consists of:

Exporting RME data from the server that has Essentials 3.3

Importing this data into the server that has Essentials 3.4

To export Essentials data:


Step 1 Access the server that has Essentials 3.3.

Step 2 Shut down the daemon manager. Enter:

# /etc/init.d/dmgtd stop

Step 3 Mount the Essentials 3.4 CD-ROM.
Enter:

# cd cdrom

Step 4 Enter:

# cd disk1
# ./export_rme.pl

The message "Do you want to export RME jobs(Y/N)?" appears.

Step 5 Enter `Y' to export jobs or enter `N' if you do not wish to export jobs.

The NetConfig, Config Editor, and Netshow jobs, if any, will be exported.

The system copies the required files to install_dir/rigel/manifest/rme and install_dir/rigel/rme directories, where install_dir is the directory in which CiscoWorks2000 is installed (/opt/CSCOpx by default).

Step 6 Change to the directory, install_dir/rigel.

Step 7 Copy the contents of this directory to a backup location.

Step 8 Start the daemon manager. Enter:

# /etc/init.d/dmgtd start



Note You must import CD One data before you can import Essentials data.


To import Essentials data:


Step 1 Access the server that has Essentials 3.4.

Step 2 Copy the exported Essentials data from your backup location into install_dir/rigel, where install_dir is the directory in which CiscoWorks2000 is installed (/opt/CSCOpx by default)

Step 3 Shut down the daemon manager. Enter:

# /etc/init.d/dmgtd stop

Step 4 Change to the directory, install_dir/rigel/scripts.

Step 5 Enter:

# ./import_rme.pl

The message, "Existing RME 3.4 data will be lost and replaced with the imported RME 3.3 data. Are you sure you want to import (Y/N)?" appears.

Step 6 Enter `Y'.

Step 7 Start the daemon manager. Enter:

# /etc/init.d/dmgtd start


Upgrading from a Previous Version

This section describes how to upgrade to Essentials 3.4, if you have Essentials version 3.3 installed on the server.

When you install CiscoWorks2000 CD One on a system that has Essentials 3.3, the installation program disables the previous version but preserves its database. When you install Essentials 3.4, the installation program converts the preserved database to Essentials 3.4 format.

If you installed CD One on a clean system, follow the installation procedure in the "Performing a New Installation" section. Then import your existing data into Essentials 3.4, following the procedure in the "Uninstalling Essentials" section.

Upgrading your CiscoWorks2000 Server to Essentials 3.4 involves:

1. Saving your data to a backup file before you perform the upgrade; if your installation fails, you can retrieve this saved data.

2. Running the Essentials installation program to install the new version and convert the database to Essentials 3.4 format.

3. Backing up the converted database to create a backup compatible with Essentials 3.4.


Caution The database backup and restore options for one version of Essentials are not supported by other versions. When upgrading your server, follow the installation procedures in this section to convert and import your database.

Backing Up Your Previous Database

To back up your database:


Step 1 Access the CiscoWorks2000 desktop and log in. For information, see the "Accessing the Server" section and the "Logging In" section.

Step 2 Select Server Configuration > Administration > Database Management > Back Up Data Now.

The Back Up Data Now dialog box appears.

Step 3 Enter the pathname of the target directory. It is recommended that you use a different directory from the directory where Essentials is located, for example, /rme/backups.

Step 4 To begin the backup, click Finish. This process could take some time to complete.


For more information, see the online help.

Changing Your Database Password

To change the database password:


Step 1 On the CiscoWorks2000 server, at the command prompt, enter:

# /etc/init.d/dmgtd stop

This stops the daemon manager.

Step 2 Enter:

# cd /opt/CSCOpx/bin
# ./dbpasswd.pl dsn=rme

Step 3 Enter the new password.

Step 4 Enter the password again for verification.

Step 5 Start the daemon manager. Enter:

# /etc/init.d/dmgtd start


Running the Installation Program for an Upgrade

The Essentials installation takes approximately 30 minutes.

You can press Ctrl-C at any time to end the installation. However, any changes to your system (for example, installation of new files or changes to system files) will not be undone.

The installation program installs Essentials in the same location as CD One (/opt/CSCOpx by default) and starts CiscoWorks2000.


Step 1 Run a backup database of your old data in case the installation fails.

Step 2 As root, mount the Essentials CD-ROM. You can either:

Mount the CD-ROM on the CiscoWorks2000 Server system.

or

Mount the CD-ROM on a remote Solaris system, then access the CD-ROM from the CiscoWorks2000 Server system.

See "Mounting and Unmounting the CD-ROM"for instructions.

Step 3 Start 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.

The installation program checks for required patches and other dependencies and displays:

1) Resource Manager Essentials
2) Resource Manager Essentials Incremental Device Support
3) All of the above
Select one of the items using its number or enter q to quit [q]


Note Option 3 is the most likely choice for an upgrade. If you try to install only one of the components when the others are not on your machine, the installation fails.


Step 4 Enter an option number and press Return.

The installation program checks dependencies and system requirements.

If there is not enough disk space to install Essentials and IDS, the installation program displays an error message and stops.

If the minimum recommended requirements are not met, the installation program displays an error message and continues installing.

The installation proceeds without displaying more questions and the system prompt appears.

Step 5 Unmount and eject the CD-ROM. For instructions, see "Mounting and Unmounting the CD-ROM.".


If you had any errors, check the installation log file /var/tmp/ciscoinstall.log. For other troubleshooting information, see"Troubleshooting the Installation" ."

Backing Up the Converted Database

If the Essentials installation was successful, back up your newly converted database. This creates a backup compatible with Essentials 3.4 in case you have a problem and need to restore your database. This also prevents overwriting your database by restoring a database backup from the previous version of Essentials.


Step 1 Access the CiscoWorks2000 desktop and log in. For information, see the "Accessing the Server" section and the "Logging In" section.

Step 2 Select Server Configuration > Administration > Database Management > Back Up Data Now.

The Back Up Data Now dialog box appears.

Step 3 Enter the pathname of the target directory. It is recommended that you use a different directory from the directory where Essentials is located, for example, /rme/backups.

Step 4 To begin the backup, click Finish. This process could take some time to complete.


Reinstalling or Upgrading from the Evaluation Version

This section explains how to reinstall Essentials 3.4 or upgrade from an evaluation version of Essentials 3.4.


Note If you have installed a version of Incremental Device Support (IDS) that is newer than the version on the Essentials 3.4 CD-ROM, the installation program will not overwrite the newer version.


The installation program detects that you have already installed Essentials 3.4. Your existing database is not affected by the reinstallation; however, you should back up the database before installing to prevent any possible loss of data. Your CiscoWorks2000 Server system configuration is also preserved.

Reinstalling Essentials 3.4 involves:

1. Backing up the database, following the procedure in the next section.

2. Running the installation program, following the procedure in the "Running the Installation Program to Reinstall" section.

Backing Up Your Previous Database

To back up your database:


Step 1 Access the CiscoWorks2000 desktop and log in. For information, see the "Accessing the Server" section and the "Logging In" section.

Step 2 Select Server Configuration > Administration > Database Management > Back Up Data Now.

The Back Up Data Now dialog box appears.

Step 3 Enter the pathname of the target directory. It is recommended that you use a different directory from the directory where Essentials is located, for example, /rme/backups.

Step 4 To begin the backup, click Finish. This process could take some time to complete.


Running the Installation Program to Reinstall

The Essentials installation takes approximately 30 minutes.

You can press Ctrl-C at any time to end the installation. However, any changes to your system (for example, installation of new files or changes to system files) will not be undone.

The installation program installs Essentials in the same location as CD One (/opt/CSCOpx by default) and starts CiscoWorks2000.


Step 1 As root, mount the Essentials CD-ROM. You can either:

Mount the CD-ROM on the CiscoWorks2000 Server system.

or

Mount the CD-ROM on a remote Solaris system, then access the CD-ROM from the CiscoWorks2000 Server system.

See Mounting a Local CD-ROM Drive for detailed mounting instructions.

Step 2 Start 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.

The installation program displays:

1) Resource Manager Essentials
2) Resource Manager Essentials Incremental Device Support
3) All of the above
Select one of the items using its number or enter q to quit [q]

Step 3 Enter 3 to reinstall all components, and press Return.


Note If you have installed a newer version of IDS since installing Essentials 3.3 the first time, enter 1 instead. The installation program fails if you attempt to overwrite a newer version of IDS with an older version.


The installation program checks dependencies and system requirements and displays:

CiscoWorks2000 has been detected on your system, are you sure you want 
to reinstall (y/n) [n]

Step 4 Enter y to continue.

The installation program checks dependencies and system requirements.

If there is not enough disk space to install Essentials plus IDS, the installation program displays an error message and stops.

If the minimum recommended requirements are not met, the installation program displays an error message.

The installation proceeds without displaying more questions, and the system prompt appears.

Step 5 Unmount and eject the CD-ROM.

For instructions, see "Mounting and Unmounting the CD-ROM"


If you had any errors, check the installation log file /var/tmp/ciscoinstall.log. For other troubleshooting information, see "Troubleshooting the Installation""

Uninstalling Essentials

The uninstallation program removes files and settings. Uninstallation allows you to remove only Essentials or remove CiscoWorks2000 CD One as well. To remove CD One, you must remove Essentials as well.

Before removing Essentials, you must first remove any applications that depend on Essentials.


Caution You must use the Essentials uninstall program to remove the product. If you try to remove Essentials manually, you can damage your system. Uninstalling the Essentials software removes IDS and the database as well.

Uninstallation takes about 30 minutes.


Note The Software Management application stores images that are not removed by the Essentials uninstallation procedure. If you want to permanently remove Essentials, you must manually remove these files from /opt/CSCOpx/files/sw_images.



Step 1 Enter these commands as root to start the uninstall program:

# cd /
# /opt/CSCOpx/bin/uninstall.sh

where /opt/CSCOpx is the default installation directory. If you specified a different directory when you installed CD One, use the name of that directory.

The following appears at command prompt:

1) CD One Fourth Edition
2) CMF Web Desktop
3) Resource Manager Essentials
4) All of the above
Select one of the items using its number or enter q to quit [q]


Note You cannot uninstall CD One without uninstalling Essentials.


Step 2 Enter 3 and press Return. The following prompt appears:

Are you sure you want to uninstall Resource Manager Essentials (y/n)? 
[n]

Step 3 Enter `y' and press Return to remove your selections.

Step 4 The installation program checks for CiscoWorks2000 packages on the system.

The following prompt appears:

Delete the CiscoWorks 2000 packages? (y/n) [n]

Step 5 Enter `y' and press Return to remove packages.

Ignore all messages that ask if you want to remove packages. The installation program does not accept input to these questions.

When the uninstallation program completes, this message appears:

All files were deleted successfully.

When you remove CD One or Essentials, the uninstallation program removes changes made to the /etc/services file. The /etc directory still contains all system file changes. The uninstallation messages are written to the /var/tmp/ciscouninstall.log file.


To reinstall Essentials, follow the instructions in the "Reinstalling or Upgrading from the Evaluation Version" section.