[an error occurred while processing this directive]

Support

Installing Essentials

Hierarchical Navigation

 Feedback

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 Netsys Versions

Supported Devices

Installing Essentials

Performing a New Installation

Running the Installation Program for a New Installation

Upgrading from a Previous Version

Backing Up Your Previous Database

Running the Installation Program for an Upgrade

Backing Up the Converted Database

Reinstalling or Upgrading from the Evaluation Version

Backing Up the Database

Running the Installation Program to Reinstall

Importing Data Manually after Installation

Removing Essentials


Installing Essentials


This chapter describes preparing to install and installing Resource Manager Essentials 3.1 on a Windows NT system. It consists of:

Product Overview

Installation Overview

Preparing to Install Essentials

Installing Essentials

Importing Data Manually after Installation

Removing Essentials

Product Overview

Resource Manager Essentials (Essentials), one of the major components of CiscoWorks2000, enables the deployment, configuration, and monitoring 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.1 CD-ROM contains two installable packages: Essentials and Incremental Device Support (IDS). IDS enables you to download device support from CCO 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 Task Overview 

Task
Steps
References

1. Prepare to install Essentials.

Verify that server requirements are met.

"Server Requirements and Recommendations" section on page 1-3

2. Install Essentials.

Run the installation program.

"Performing a New Installation" section
or
"Upgrading from a Previous Version" section
or
"Reinstalling or Upgrading from the Evaluation Version" section

3. Verify and troubleshoot installation.

Analyze installation error messages.

Appendix A, "Troubleshooting the Installation"

4. Perform post-
installation
tasks.

Configure the system and set up Essentials applications.

Chapter 2, "Preparing to Use Essentials Applications"


Preparing to Install Essentials

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

Essentials Upgrade Paths

You can upgrade to Essentials 3.1 from Essentials 2.0, 2.1, 2.2. or 3.0. Upgrading directly to Essentials 3.1 from Cisco Resource Manager 1.0 or 1.1 is not supported.

The previous version of Essentials is removed when you install CiscoWorks2000 CD One (CD One), but its database is preserved. When you install Essentials 3.1, the preserved database is converted to Essentials 3.1 format.

Server Requirements and Recommendations

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

Minimum Server Requirements

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

Table 1-2 Server System Minimum Requirements

Requirement Type
Minimum Requirements

System hardware

IBM PC-compatible with 450 MHz Pentium III.

Memory (RAM)

256 MB minimum.

Available drive space1

4 GB.

Enough space for downloaded Software Management files2 .

Paging space equal to double the amount of memory (RAM). For example, if your system has 256 MB of RAM, you need 512 MB of paging space.

Additional software

CiscoWorks2000 CD One must be installed before installing Essentials. Refer to Installing and Setting Up CD One on Windows NT.

1 Disk space requirements are up to 10 times higher if you install CiscoWorks2000 CD One and Essentials on a FAT file system.

2 For information about space needed for these files, see "Setting Up Software Management" section on page 2-18.


Server Recommendations

Three major considerations can help you select or configure a system that best meets your needs:

The number of managed devices to be polled by Availability

The number of managed devices expected in Inventory and Configuration Management

The number of syslog messages expected daily

Availability is the primary consideration, after which 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, you must configure the system. For more  information about client system requirements and configuring clients, refer to Installing and Setting Up CD One on Windows NT.

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 95, or Windows 98.

Solaris SPARCstation or Sun Ultra 10 running Solaris 2.5.1 or 2.6.

IBM RS/ 6000 workstation running AIX 4.3.3.

HP-UX workstation running HP-UX 10.20 or 11.0.

Color monitor with video card set to 256 colors.

Memory (RAM)

128 MB

Browser

One of the following browsers:

Microsoft Internet Explorer 5.0 or 5.01.
Java Virtual Machine (JVM) versions 5.0.0.3.182 or current shipping version.
(Windows NT, Windows 95/98)
To verify the JVM version, select View > Java Console.

Netscape Navigator 4.6.1 or 4.7.
(Windows NT, Windows 95/98, Solaris 2.5.1, Solaris 2.6)


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 software Essentials supports for importing devices from local and remote systems. You can import devices remotely from a UNIX system only. Essentials does not support remote device imports from Windows NT systems. For more information, see the "Adding or Importing Inventory Data" section or refer to the online help.

Table 1-4 Supported NMS Software for Local Device Import 

Software
Version

Campus Manager

3.0 (ANI)

HP OpenView Network Node Manager

5.02 or 6.0

NetView

5.1


Table 1-5 Supported NMS Software for Remote Device Import 1

Software
Version

Campus Manager

3.0 (ANI)

CiscoWorks

4.0

CiscoWorks for Switched Internetworks (CWSI)

2.2, 2.3, 2.4

HP OpenView Network Node Manager

5.01 or 6.0

NetView

5.1 on AIX

1 You can remotely import devices from UNIX systems only.


Supported Netsys Versions

You can integrate the Configuration Management application with the following versions of Netsys:

Version 4.2 for UNIX operating systems

Version 4.0.1 for Windows NT


Caution If you plan to upgrade NetSys Integration, before proceeding with an upgrade installation, see the second procedure in the "Upgrading Netsys Integration" section on page 2-23.

For more information, see the "Setting Up Netsys Integration" section on page 2-22 or refer to the online help.

Supported Devices

Essentials 3.1 supports all devices supported in previous versions plus additional devices. Device adapter packages for all supported devices are installed when you install Essentials. Information about devices installed with Essentials can be found at http://www.cisco.com/univercd/cc/td/doc/product/rtrmgmt/cw2000/
cw2000e/index.htm.

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

To find out which device packages are installed on your CiscoWorks2000 Server, select CiscoWorks2000 Server > About CiscoWorks2000 > Applications and Versions. Click on the Inventory Manager link to see specific device information.

Installing Essentials

This section describes how to perform:

A new installation (no previous version of Essentials installed)

An upgrade on a system with a previous version of Essentials installed

A reinstallation of Essentials 3.1 or upgrade from an evaluation version


Note You must install CiscoWorks2000 CD One before you can install Essentials. Refer to Installing and Setting Up CD One on
Windows NT
.


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.1 or upgrading from an evaluation version of Essentials 3.1, 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, perform the new installation by following the procedure in this section. After installing Essentials, import the data by following the procedure in the "Importing Data Manually after Installation" section.


Running the Installation Program for a New Installation

The Essentials installation takes approximately 30 minutes.

You can cancel the installation at any time by clicking Cancel at the bottom of any installation screen.

The installation program installs Essentials in the same location as CD One (C:\Program Files\ CSCOpx by default) and starts CiscoWorks2000.


Step 1 Log in as the local administrator on the system on which you installed CD One.

Step 2 Insert the Essentials CD-ROM into a CD-ROM drive. The Installer window appears, displaying, "Do you want to install CiscoWorks2000 Resource Manager Essentials?"

Step 3 Click Yes to begin installing. The Unpacking CiscoWorks2000 Resource Manager Essentials screen appears, and the InstallShield Wizard is prepared. The Welcome screen appears.

Step 4 Click Next to continue. The Setup Type dialog box appears.

Step 5 Select Typical to install both Essentials and Incremental Device Support (IDS).


Note You must install both Essentials and IDS. If you try to install Essentials only, the installation will fail.


Step 6 Click Next to continue. The Start Copying Files dialog box appears.

Step 7 Click Next. The installation program checks dependencies and system requirements.

Step 8 The Requirements Verification dialog box displays the results of the requirements checking and tells whether the installation can continue. One of the following occurs:

If minimum requirements are met, click OK. The Setup screen appears, displaying installation progress while files are copied and applications are configured. Then the Setup Complete dialog box appears. Go to Step 9.

If recommended requirements are not met, an error message appears. To continue the installation, click OK.

Step 9 Click Finish. You have completed the Essentials installation.

Step 10 Remove the CD-ROM from the drive.

Step 11 If you did not restart the computer after installing CiscoWorks2000 CD One, restart it now.


If you had any errors during installation, check the installation log in the root directory on the drive where the operating system is installed. Each installation creates a new log file. For example, the CiscoWorks2000 CD One installation creates C:\cw2000_in001.log. The Essentials installation creates C:\cw2000_in002.log. The Technical Assistance Center (TAC) might ask you to send them the installation log.

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

Upgrading from a Previous Version

This section describes how to install Essentials if you had Essentials 2.0, 2.1, 2.2 or 3.0 installed on the server and you want to upgrade to Essentials 3.1.

When you install CiscoWorks2000 CD One on a server that has a previous version of Essentials, the installation program removes the previous version and saves its database. The default location for the saved database is c:\CW2000\OldData. When you install Essentials 3.1, the installation program converts the saved database to 3.1 format. The original database remains on the system until you remove it.


Note If you chose not to remove the previous version of Essentials when you installed CiscoWorks2000 CD One and installed CD One on a clean system, follow the procedure in the "Performing a New Installation" section. Then import your existing data to Essentials 3.1, following the procedure in the "Importing Data Manually after Installation" section.


Upgrading your CiscoWorks2000 Server to Essentials 3.1 involves the following major steps:

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

2. Run the Essentials installation program to install the new version and convert your previous database to Essentials 3.1 format.

3. Back up the converted database to create a backup compatible with Essentials 3.1.


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 previous database before upgrading to Essentials 3.1:


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 CiscoWorks2000 Server > 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, C:\rme\backups.

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


For more information, see the online help.

Running the Installation Program for an Upgrade

The Essentials installation takes approximately 30 minutes.

You can cancel the installation at any time by clicking Cancel at the bottom of any installation screen.

The installation program installs Essentials in the same location as CD One (C:\Program Files\ CSCOpx by default) and starts CiscoWorks2000.


Step 1 Log in as the local administrator on the system on which you installed CD One.

Step 2 Insert the Essentials 3.1 CD-ROM into a CD-ROM drive. The Installer window appears.

Step 3 Click Install. The Welcome screen appears.

Step 4 Click Next to continue. The Setup Type dialog box appears.

Step 5 Select Typical to install both Resource Manager Essentials and Incremental Device Support (IDS).


Note You must install both Essentials and IDS. If you try to install Essentials only, the installation will fail.


Step 6 Click Next to continue. The Start Copying Files dialog box appears.

Step 7 Click Next. The installation program checks dependencies and system requirements.

Step 8 The Requirements Verification dialog box displays the results of the requirements check and tells whether the installation can continue. Do one of the following:

If minimum requirements are met, click OK. The Setup screen appears, displaying installation progress while files are copied and applications are configured. Then the Setup Complete dialog box appears. Go to Step 9.

If requirements are not met, click OK. The installation stops. Reconfigure the server and run the installation program again or install on a different server.

Step 9 Click Finish. You have completed the Essentials installation.

Step 10 Remove the CD-ROM from the drive.

Step 11 If you did not restart the computer after installing CiscoWorks2000 CD One, restart it now.


If you had any errors during installation, check the installation log in the root directory on the drive where the operating system is installed. Each installation creates a new log file. For example, the CiscoWorks2000 CD One installation creates C:\cw2000_in001.log. The Essentials installation creates C:\cw2000_in002.log. The Technical Assistance Center (TAC) might ask you to send them the installation log.

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

Backing Up the Converted Database

If Essentials was installed successfully, back up your newly converted database. This creates a backup compatible with Essentials 3.1 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. 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 CiscoWorks2000 Server > 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 one where Essentials is located, for example, C:\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.

Reinstalling or Upgrading from the Evaluation Version

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


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


The installation program detects that you have already installed Essentials 3.1. 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 configuration is also preserved.

Reinstalling Essentials 3.1 involves the following major steps:

1. Back up the database, following the procedure in the following section.

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

Backing Up the 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 CiscoWorks2000 Server > 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, C:\rme\backups.

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


For more information, see the online help.

Running the Installation Program to Reinstall

The Essentials installation takes approximately 30 minutes.

You can cancel the installation at any time by clicking Cancel at the bottom of any installation screen.

The installation program installs Essentials in the same location as CD One (C:\Program Files\ CSCOpx by default) and starts CiscoWorks2000.


Step 1 Log out of CiscoWorks2000 and close the browser.

Step 2 Insert the Essentials CD-ROM into a CD-ROM drive. The Installer window appears.

Step 3 Click Install. The Welcome screen appears.

Step 4 Click Next to continue. The Setup Type dialog box appears.

Step 5 Select one of the following:

Select Typical to reinstall both Essentials and Incremental Device Support (IDS). Click Next.

Select Custom to select a component to install. The Select Components dialog appears.

Select the component you want to install and deselect the other.


Note The installation program fails if you try to overwrite IDS with an older version.


Step 6 Click Next to continue. The Start Copying Files dialog box appears.

Step 7 Click Next. The installation program checks dependencies and system requirements.

Step 8 The Requirements Verification dialog box displays the results of the requirements check and tells whether the installation can continue. Do one of the following:

If minimum requirements are met, click OK. The Setup screen appears, displaying installation progress while files are copied and applications are configured. Then the Setup Complete dialog box appears. Go to Step 9.

If requirements are not met, click OK. The installation stops. Reconfigure the server and run the installation program again or install on a different server.

Step 9 Click Finish. You have completed the Essentials installation.

Step 10 Remove the CD-ROM from the CD-ROM drive.

Step 11 If you did not restart the computer after installing CiscoWorks2000 CD One, restart now.


If you had any errors during installation, check the installation log in the root directory on the drive where the operating system is installed. Each installation creates a new log file. For example, the CiscoWorks2000 CD One installation creates C:\cw2000_in001.log. The Essentials installation creates C:\cw2000_in002.log. The Technical Assistance Center (TAC) might ask you to send them the installation log.

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

Importing Data Manually after Installation

This section describes how to import data manually from Essentials 2.2 or earlier. If you are upgrading from Essentials 3.0 to version 3.1, you do not need to change the format of your data or import data manually. You might need to import manually if:

You performed a new installation of Essentials 3.1 but have older data from Essentials 2.2 or earlier that is installed on a different system.

You performed an upgrade from Essentials 2.2 or earlier to version 3.1 but there was not enough disk space to convert and import the saved older version's data in the default location.


Step 1 Install CiscoWorks2000 CD One and Essentials.

Step 2 Log in as the administrator on the CiscoWorks2000 Server on which you performed the installation.

Step 3 To give the CiscoWorks2000 database access to your older Essentials data, do one of the following:

Map the drive containing the older Essentials data.

Copy the saved older Essentials data to the CiscoWorks2000 Server.

Step 4 Open a command prompt window.

Step 5 Enter:

c:\>cd \Program Files\CSCOpx\conf\bg2rigel\scripts
c:\>\Program Files\CSCOpx\bin\perl bg2rigel.pl -I path rme

where path is the pathname of the directory that contains the older Essentials data to be imported.


Note If you did not install CiscoWorks2000 in the default directory, substitute the installation directory for Program Files\CSCOpx.



Removing 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 remove any applications that depend on Essentials. These are the applications for which installing Essentials is a prerequisite.

Uninstalling Essentials takes about 30 minutes.


Caution You must use the CiscoWorks2000 uninstallation program to remove the product. If you try to remove Essentials or its components manually, you can damage your system. Uninstalling the Essentials software removes the database as well.


Step 1 Select Start > Programs > CiscoWorks2000 > Uninstall CiscoWorks2000.

The Uninstallation dialog box appears, displaying all of the installed components.


Note You cannot uninstall CD One without uninstalling Essentials.


Step 2 Deselect the components you want to keep or click Uninstall All.

Step 3 Click Next to begin uninstalling the selected components.

A dialog box listing the components selected for uninstallation appears.

Step 4 Click Next.

Messages showing the progress of the uninstallation appear. Then the uninstallation finishes.


Note The Software Management application stores images that are not removed by the uninstallation program. To permanently remove Essentials, you must remove these files manually from C:\Program Files\CSCOpx\files\sw_images.



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


[an error occurred while processing this directive]