|
|
This chapter describes how to install and uninstall Essentials, including upgrades and reinstallation. You must install CiscoWorks2000 CD One before you can install Resource Manager Essentials. Refer to Installing and Setting Up CiscoWorks2000 CD One on AIX.
This chapter consists of:
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.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.
Table 1-1 is an overview of Essentials installation. It contains references to more detailed information about each task.
| Task | Steps | References |
|---|---|---|
1. Prepare to install Essentials. | Verify that server requirements are met. | |
2. Install Essentials. |
a. Mount the Essentials CD-ROM. b. Run the installation program. | The "Performing a New Installation" section or The "Upgrading from a Previous Version" section or "Reinstalling or Upgrading from the Evaluation Version" section |
3. Troubleshoot the installation. | Analyze installation error messages. | |
4. Perform post-installation tasks. | Configure the system for Essentials applications and set up Essentials applications. |
You can upgrade to Essentials 3.1 from Essentials 2.0, 2.1, or 2.2.
The previous version of Essentials is removed when you install CiscoWorks2000 CD One but the database is preserved. When you upgrade your server to Essentials 3.1, the preserved database is converted to Essentials 3.1 format.
This section describes the server requirements and recommendations for CiscoWorks2000 CD One plus Essentials.
The minimum system requirements for a CiscoWorks2000 Server running the CD One and Essentials software are shown in Table 1-1.
| Requirement Type | Minimum Requirements |
|---|---|
System hardware |
|
Memory (RAM) | 256 MB |
Available drive space1 | |
Additional software | CiscoWorks2000 CD One must be installed before you install Essentials. Refer to Installing and Setting Up CiscoWorks2000 CD One on AIX. |
| 1To verify available disk space, see the instructions in this section. 2Essentials is installed in the same directory as CiscoWorks2000 CD One. 3For 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
where directory is the partition or absolute pathname of the directory for which you want to check the available disk space.
Three major considerations can help you select or configure a server system that best meets your needs:
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-2 shows the recommendations for a server running CiscoWorks2000 CD One and Essentials. These recommendations produce optimal response time when running user reports.
| Minimum System Configuration | Availability1 | Syslog2 | Configuration Management1 | Inventory1 |
|---|---|---|---|---|
RS6000 Power PC Model 604e 233 MHz running AIX 4.3.3 | 0-100 | 0-50,000 | 0-500 | 0-500 |
RS6000 Power PC Model 604e 233 MHz running AIX 4.3.3 | 100-500 | 50,000-150,000 | 500-2,500 | 500-2,500 |
RS6000 Power PC Model 150 375 MHz running AIX 4.3.3 | 500-1,000 | 150,000 | 2,500-5,000 | 2,500-5,000 |
| 1Number of managed devices. The number of managed devices in Availability is the main deciding factor. 2Number of messages per day. |
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, refer to Installing and Setting Up CiscoWorks2000 CD One on AIX.
| Requirement Type | Minimum Requirement |
|---|---|
System Software and Hardware |
|
Memory (RAM) | 128 MB |
Browser | One of the following browsers: |
The Essentials Inventory application can import device information from both local and remote network management systems (NMS).
Table 1-5 and Table 1-6 show the NMSs supported for importing device information into the Essentials inventory. You can import devices remotely from a UNIX system only.
| Software | Version |
|---|---|
Campus Manager | 3.0 (ANI) |
NetView | 5.1 |
| Software | Version |
|---|---|
Campus Manager | 3.0 (ANI) |
CiscoWorks | 4.0 |
CWSI (CiscoWorks for Switched Internetworks) | 2.2, 2.3, 2.4 |
HP OpenView Network Node Manager | 5.01 or 6.0 |
NetView | 5.1 on AIX |
| 1You 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.
You can integrate the Configuration Management application with the following versions of Cisco Netsys:
![]() |
Note If you plan to upgrade NetSys Integration, before proceeding with an upgrade installation, see the second procedure in the "Upgrading Netsys Integration" section or refer to the online help. |
For more information, see the "Setting Up Netsys Integration" section or refer to the online help.
Essentials 3.1 supports most of the devices supported in previous versions of Essentials plus additional new devices. Device adapter packages for all supported devices are installed when you install Essentials. Information about these devices 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 and find information about new device support from CCO at www.cisco.com.
To see a list of the device packages currently installed on your server, select CiscoWorks2000 Server > About CiscoWorks2000 > Applications and Versions. Click on the Inventory Manager link to see specific device information.
This section describes how to perform the following:
![]() |
Note You must install CiscoWorks2000 CD One before you can install Essentials. Refer to Installing and Setting Up CiscoWorks2000 CD One on AIX. |
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. |
The Essentials installation takes approximately 1 hour.
The installation program installs Essentials in the same location as CD One (/usr/CSCOpx by default) and starts CiscoWorks2000.
See ""Mounting and Unmounting the CD-ROM" for detailed mounting instructions.
Step 2 Start the installation program.
# cd /cdrom # ./setup.sh
# cd remotedir # ./setup.sh
The installation program performs several preinstallation checks on your machine, such as TCP/IP address resolution, TCP/IP port use, disk space, and RAM. These preinstallation checks cause some text to appear on the screen.
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 a new installation. 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.
The installation finishes without displaying more questions, and the system prompt appears.
Step 4 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."
When you install CiscoWorks2000 CD One on a system 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 /usr/CSCOpx/OldData. When you install Essentials 3.1, the installation program converts the saved database to Essentials 3.1 format. The original database also 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 installation procedure in the "Performing a New Installation" section. Then import your existing data into Essentials 3.1 following the procedure in the "Importing Data Manually after Installation" section. |
![]() |
Caution When performing an upgrade, it is important to install both the new IDS and Essentials. Installing Essentials 3.1 without the new IDS might yield unpredictable results. |
Upgrading your CiscoWorks2000 Server to Essentials 3.1 involves the following major steps:
1. Save your data to a backup file before you perform the upgrade; if your installation fails, you can retrieve this saved data.
2. Run the Essentials installation program to install the new version and convert the database to Essentials 3.1 format.
3. Back up the converted database to create a backup compatible with Essentials 3.1.
To back up your database:
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, /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.
The Essentials installation takes approximately 1 hour.
The installation program installs Essentials in the same location as CD One (/usr/CSCOpx by default) and starts CiscoWorks2000.
Step 2 As root, mount the Essentials CD-ROM using either of the following methods:
See "Mounting and Unmounting the CD-ROM" for instructions.
Step 3 Start the installation program.
# cd /cdrom # ./setup.sh
# cd remotedir # ./setup.sh
The installation program performs several preinstallation checks on your machine, such as TCP/IP address resolution, TCP/IP port use, disk space, and RAM. These preinstallation checks cause some text to appear on the screen.
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]
![]() |
Caution Option 3 is the most common choice for a new installation. If you try to install only one of the components without the other already on your machine, the install fails. You would use Option 2, IDS alone, only if at a later time you receive a new version of IDS. |
Step 4 Enter 3 and press Return. The installation program checks dependencies and system requirements.
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."
If the Essentials installation was successful, 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.
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, /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.
This section explains how to reinstall Essentials 3.1 or upgrade from an evaluation version of Essentials 3.1.
![]() |
Note If you have installed a version of Incremental Device Support (IDS) that is newer than the version on the 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 loss of data. Your CiscoWorks2000 Server system configuration is also preserved.
Reinstalling Essentials 3.1 involves the following major steps:
1. Backing up the database, following the procedure in the following section.
2. Running the installation program, following the procedure in the "Running the Installation Program to Reinstall" section.
To back up your database:
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, /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.
The Essentials installation takes approximately 1 hour.
The installation program installs Essentials in the same location as CD One (/usr/CSCOpx by default) and starts CiscoWorks2000.
See "Mounting and Unmounting the CD-ROM" for detailed mounting instructions.
Step 2 Start the installation program.
# cd /cdrom # ./setup.sh
# cd remotedir # ./setup.sh
The installation program performs several preinstallation checks on your machine, such as TCP/IP address resolution, TCP/IP port use, disk space, and RAM. These preinstallation checks cause some text to appear on the screen.
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]
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.1 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:
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."
![]() |
Note The following procedure does not remove the original database. |
Step 2 Log in as root on the CiscoWorks2000 Server system on which you installed Essentials 3.1.
Step 3 Mount the directory containing the previous data or copy the data to the CiscoWorks2000 Server.
Step 4 Enter:
# cd /usr/CSCOpx/conf/bg2rigel/scripts # ./bg2rigel.pl -I path rme
where path is the pathname of the directory in which the older Essentials data resides.
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. These are those applications for which installing Essentials is a prerequisite.
Uninstallations take 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 /usr/CSCOpx/files/sw_images. |
# cd / # /usr/CSCOpx/bin/uninstall.sh
where /usr/CSCOpx is the default installation directory. If you specified a different directory when you installed CD One, substitute the name of that directory.
The following prompt appears:
1) CD One (including Integration Utility) 2) Resource Manager Essentials 3) 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 2 or 3 and press Return. The following prompt appears:
Are you sure you want to uninstall CiscoWorks2000 (y/n)? [n]
Step 3 Press Return to remove your selections.
Ignore all messages that ask if you want to remove packages. The uninstallation program does not accept input to these questions.
When the uninstallation program finishes, the following 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.
![]()
![]()
![]()
![]()
![]()
![]()
![]()
Posted: Wed May 17 00:39:13 PDT 2000
Copyright 1989 - 2000©Cisco Systems Inc.