Installation and Setup Guide for Resource Manager Essentials 4.0.3 on Windows (With LMS 2.5.1) - Chapter 2: Installing RME [CiscoWorks Resource Manager Essentials]

Table Of Contents

Installing RME

Installation Overview

Performing New RME Installation

Installation Notes

Installation Modes

Performing New Installation—Typical

Performing New Installation—Custom

Verifying RME Installation

Post Installation Checklist

Reinstalling RME

Reinstalling RME—Typical

Reinstalling RME—Custom

Uninstalling RME

Installing RME

This chapter describes installing Resource Manager Essentials 4.0.3 on a Windows system. It consists of:

•Installation Overview

•Performing New RME Installation

•Post Installation Checklist

•Reinstalling RME

•Uninstalling RME

Installation Overview

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

Table 2-1 Installing RME Task Overview

Task

Steps

References

1. Prepare to install RME.

Verify that server requirements are met.

"Prerequisites"

2. Install RME.

Run the installation program.

"Performing New RME Installation" section

or

"Reinstalling RME" section

3. Troubleshoot the installation.

Analyze installation error messages.

"Troubleshooting the Installation"

4. Perform post
installation
tasks.

Configure the system and set up RME applications.

"Preparing to Use RME Applications"

Performing New RME Installation

This section describes how to perform a new installation:

•Installation Notes

•Installation Modes

•Performing New Installation—Typical

•Performing New Installation—Custom

•Verifying RME Installation

Installation Notes

Before you begin your installation, note the following:

•You must install Common Services 3.0.3 before you can install RME 4.0.3.

For more information, see Installation and Setup Guide for Common Services 3.0.3 (Includes Ciscoview) on Windows.

•The installation program install RME 4.0.3 in the same location as Common Services directory (By default, SystemDrive:\Program Files\CSCOpx). This location is referred to as NMSROOT in this document.

Where, SystemDrive is the Windows operating system installed directory.

•Restart the system after installing CiscoWorks Common Services and before installing RME 4.0.3. The RME installation might fail if you do not restart your system.

•Run the installation from a local CD or a local hard drive to avoid errors due to network inconsistencies.

•Close all applications before running installation. Do not run any other programs while installation is in progress.

•If you are running virus scanner or mail client while installing RME, the installation might take longer to complete.

•You can press click Cancel at any time to end the installation. However, any changes to your system will not be undone.

For example, if any new files were installed or if they were any changes to the system files, you need to manually cleanup the installation directories.

Note We recommend that you do not terminate the installation while it is running.

•The RME installation takes approximately 30 minutes.

If you running the installation from a remote CD drive or a remote hard drive, the installation time will vary based on your network connection.

Caution Do not change the system time after installing RME. Such changes may affect the working of some time-dependent features. For more information, see "Troubleshooting the Installation".

Installation Modes

You can install RME 4.0.3 either using Typical or Custom mode:

•If you choose the Typical installation mode, the RME database password is randomly generated for you. You can view the password at the end of installation.

See Performing New Installation—Typical

•If you choose the Custom installation mode, you will be prompted to enter the RME database password.

Use a minimum of five characters and a maximum of 15 characters. Do not start the password with a number and do not insert spaces between characters.

This password is also used while restoring or troubleshooting the RME database.

See Performing New Installation—Custom

Performing New Installation—Typical

To install RME using the Typical mode:

Step 1 Log in as the local administrator on the system on which you installed Common Services.

Step 2 Insert the RME 4.0.3 CD-ROM into a CD-ROM drive.

The Installer window appears.

If the Installer window does not appear:

a. Select Start > Run.

The Run dialog box opens.

b. In the Open field, enter drive:\RME\autorun.exe

where drive is the CD-ROM drive letter.

Step 3 Click Install.

The Welcome window appears.

Step 4 Click Next to continue.

The Software License Agreement window appears.

Step 5 Click Yes to accept the license agreement and proceed with the installation.

The Licensing Information dialog box appears.

Step 6 Do either of the following:

•If you have a license file for CiscoWorks, select the Licence File Location radio button, and browse to the file location.

•If you do not have a license, enter the serial number and the Product Identification Number (PIN) from the product package.

•For an evaluation copy of Resource Manager Essentials 4.0.3, licensing details are not required. Select the Evaluation only radio button to get an evaluation copy of RME 4.0.3.

Note A message appears at the end of the installation prompting you to obtain a valid license key from Cisco.com within 90 days.

Step 7 Click Next to continue.

The Setup Type dialog box appears displaying two installation modes, Typical installation and Custom installation.

Step 8 Select Typical from the Setup dialog box and click Next.

The following message appears only if you have configured Common Services in ACS mode (Common Services > Server > Security > AAA Mode Setup):
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.
Step 9 Do one of the following:

•If you click Yes, RME 4.0.3 gets register with ACS server.

•If you click No, RME 4.0.3 does not register with ACS server.

After the installation, you can register RME 4.0.3 with ACS server, using the script, AcsRegCli.pl:

NMSROOT\bin\perl NMSROOT\bin\AcsRegCli.pl -register rme

For example:

C:\Program Files\CSCOpx\bin\perl C:\Program Files\CSCOpx\bin\AcsRegCli.pl -register rme

•If you click Cancel, RME 4.0.3 installation is aborted.

The installation program checks dependencies and system requirements.

The System Requirements window appears.

Step 10 Click Next.

The Daemons Restart Option window appears.

•If you plan to install another LMS application after installing RME, enter No.

•If you plan not to install another LMS application after installing RME, enter Yes.

Step 11 Click either Yes to restart CiscoWorks daemons or No not to restart CiscoWorks daemons.

The Summary window appears.

Step 12 Click Show Details, to view all settings including those selected automatically.

A Security Alert dialog box appears.

Step 13 Click Yes to view details.

The summary details view displays the randomly generated Essentials database password in clear text. The Summary window displays installation details.

Note Memorize your password displayed on the console. We recommend you do not write it down.

Step 14 Click Next.

The Setup screen appears, displaying installation progress while files are copied and applications are configured.

The following message appears:
To ensure that you retain the latest device support, please install 
the latest Device Packages from CCO 
@http://www.cisco.com/pcgi-bin/tablebuild.pl/cw2000-rme
Please refer to the Installation and Setup Guide for details.
For more information about Service Packs, see "Troubleshooting the Installation".

Step 15 Click OK.

The following message appears:
If you are migrating from RME 3.x versions, you must install or 
upgrade all the required applications in LAN Management Solution 
(LMS), and then run the migration scripts to restore the data.
For more information about restoring the LMS data, see the Data Migration Guide for LAN Management Solution 2.5.1 on Cisco.com. See Related Documentation.

Step 16 Click OK.

The Setup Complete dialog box appears.

If you have chosen not to restart the CiscoWorks daemons in Step 11, this dialog box lists the CiscoWorks daemons and also provides the command to restart these daemons.

Step 17 Click Finish.

You have completed the RME installation.

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 Common Services installation creates SystemDrive:\CiscoWorks_setupxxx.log, where xxx is the log file for the last CiscoWorks application installed. If you request for assistance, the Technical Assistance Center (TAC) might ask you to send them the installation log.

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

To verify the RME 4.0.3 installation, see "Verifying RME Installation" section

Performing New Installation—Custom

To install RME using the Custom mode:

Step 1 Log in as the local administrator on the system on which you installed Common Services.

Step 2 Insert the RME 4.0.3 CD-ROM into a CD-ROM drive.

The Installer window appears.

If the Installer window does not appear:

a. Select Start > Run.

The Run dialog box opens.

b. In the Open field, enter drive:\RME\autorun.exe

where drive is the CD-ROM drive letter.

Step 3 Click Install.

The Welcome window appears.

Step 4 Click Next to continue.

The Software License Agreement window appears.

Step 5 Click Accept to accept the license agreement and proceed with the installation.

The Licensing Information dialog box appears.

Step 6 Do either of the following:

•If you have a license file for CiscoWorks, select the Licence File Location radio button, and browse to the file location.

•If you do not have a license, enter the serial number and the Product Identification Number (PIN) from the product package.

•For an evaluation copy of Resource Manager Essentials 4.0.3, licensing details are not required. Select the Evaluation only radio button to get an evaluation copy of RME 4.0.3.

Note A message appears at the end of the installation prompting you to obtain a valid license key from Cisco.com within 90 days.

Step 7 Click Next to continue.

The Setup Type dialog box appears displaying two installation modes, Typical installation and Custom installation.

Step 8 Select Custom from the Setup dialog box and click Next.

The following message appears only if you have configured Common Services in ACS mode (Common Services > Server > Security > AAA Mode Setup):
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.
Step 9 Do one of the following:

•If you click Yes, RME 4.0.3 gets register with ACS server.

•If you click No, RME 4.0.3 does not register with ACS server.

After the installation, you can register RME 4.0.3 with ACS server, using the script, AcsRegCli.pl:

NMSROOT\bin\perl NMSROOT\bin\AcsRegCli.pl -register rme

For example:

C:\Program Files\CSCOpx\bin\perl C:\Program Files\CSCOpx\bin\AcsRegCli.pl -register rme

•If you click Cancel, RME 4.0.3 installation is aborted.

The Change Essentials Database Password window appears.

Use a minimum of five characters and a maximum of 15 characters. Do not start the password with a number and do not insert spaces between characters:

Step 10 Do either of the following:

•To create a new password:

–Enter a password of minimum five characters in the Password field.

–Re-enter the password in the Confirm Password field.

•To let RME generate a random password for you, leave the Password field and the Confirm Password field blank.

Note If you enter a password with less than five characters, RME automatically generates a random password.

You can view your password in clear text in the Security dialog box (Step 14).

Step 11 Click Next.

The installation program checks dependencies and system requirements.

The System Requirements window appears.

Step 12 Click Next.

The Daemons Restart Option window appears.

•If you plan to install another LMS application after installing RME, enter No.

•If you plan not to install another LMS application after installing RME, enter Yes.

Step 13 Click either Yes to restart CiscoWorks daemons or No not to restart CiscoWorks daemons.

The Summary window appears.

Step 14 Click Show Details to view all settings including those selected automatically.

A Security Alert dialog appears.

Step 15 Click Yes to view details.

The Summary Details view displays the password in clear text. The Summary window displays installation details.

Step 16 Click Next.

The Setup screen appears, displaying installation progress while files are copied and applications are configured.

The following message appears:
To ensure that you retain the latest device support, please install 
the latest Device Packages from CCO 
@http://www.cisco.com/pcgi-bin/tablebuild.pl/cw2000-rme
Please refer to the Installation and Setup Guide for details.
For more information about Service Packs, see "Troubleshooting the Installation".

Step 17 Click OK.

The following message appears:
If you are migrating from RME 3.x versions, you must install or 
upgrade all the required applications in LAN Management Solution 
(LMS), and then run the migration scripts to restore the data.
For more information about restoring the LMS data, see the Data Migration Guide for LAN Management Solution 2.5.1 on Cisco.com. See Related Documentation.

Step 18 Click OK.

The Setup Complete dialog box appears.

If you have chosen not to restart the CiscoWorks daemons in Step 13, this dialog box lists the CiscoWorks daemons and also provides the command to restart these daemons.

Step 19 Click Finish.

You have completed the RME installation.

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 Common Services installation creates SystemDrive:\CiscoWorks_setupxxx.log, where xxx is the log file for the last CiscoWorks application installed. If you request for assistance, the Technical Assistance Center (TAC) might ask you to send them the installation log.

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

Verifying RME Installation

You can verify RME installation by following these steps:

Step 1 Access the CiscoWorks Homepage.

Step 2 Select Common Services > Homepage > Application Registration.

The Application Registration Status dialog box appears.

Step 3 Check the Registered Applications table.

Resource Manager Essentials should be listed.

You can also verify the RME installation by entering the command pdshow from NMSROOT/bin. Where NMSROOT is the CiscoWorks installed directory.

The following processes must be displayed.

•RMEDbEngine

•RMEDbMonitor

•RMECSTMServer

•ConfigMgmtServer

•NCTemplateMgr

•NetShowMgr

•RMEOGSServer

•SyslogCollector

•EssentialsDM

•CTMJrmServer

•ChangeAudit

•ICServer

•SyslogAnalyzer

For information on these processes, See the User Guide for Resource Manager Essentials 4.0.3 on Cisco.com:

http://www.cisco.com/univercd/cc/td/doc/product/rtrmgmt/cw2000/cw2000e/
e_4_x/4_0_3/index.htm.

Post Installation Checklist

Table 2-2 lists the common post-installation that are required to be configured after installing RME. For details, see "Preparing to Use RME Applications".

Table 2-2 Post Installation Checklist

Task

How to get there...

Verifying System Settings

RME > Administration > System Preferences

Or

Common Services > Server > Admin > System Preferences

Job Approval

Creating approver list

RME > Administration > Approval > Create/Edit

Enabling job approval

RME > Administration > Approval > Approval Policies

Device Management/ Inventory

Add Devices

Common Services > Device and Credentials > Device Management

and

RME > Devices > Device Management > RME Devices

Checking Add / Import Summary

RME > Devices > Device Management.

Checking device credentials

RME >Devices > Device Management> Device Credential Verification > Select Devices > View Credential Verification Report

Changing device credentials

RME >Devices > Device Management > Device Credential Verification > Select Devices > Edit Device Credentials

Deleting unwanted devices

RME > Devices > RME Devices > Select Devices > Delete

Scheduling collection

RME >Devices > Inventory > Inventory Jobs > Create

Manually updating inventory

RME >Devices > Inventory > Inventory Jobs > Create> Choose Immediate Job

Configuration Management

Performing general setup tasks

RME > Admin > Config Mgmt

Config Editor Administration

RME > Admin > Config Mgmt > Config Editor

Or

RME > Admin > Config Mgmt > Config Job Policies > ConfigEditor

NetConfig Administration

RME > Admin > Config Mgmt > Config Job Policies > NetConfig

Network Show Commands

Creating Command Sets

RME > Tools > NetShow > Command Sets

Assigning Users to Command Sets

RME > Tools > NetShow > Assigning Command Sets

Defining Network show Batch Commands

RME > Tools > NetShow > NetShow Jobs.

Associating Devices and Command Sets can be done in the Job flow.

Software Management

Defining Software Management Preferences

RME > Administration > Software Management > View/Edit Preferences

Importing Baseline of Software Images

RME > Software Management > Software Repository

Scheduling Synchronization Job

RME > Software Management > Software Repository > Software Repository Synchronization

Change Audit

Defining Exception Periods

RME > Tools > Change Audit > Exception Periods

Forwarding Traps

RME > Tools > Change Audit > Automated Actions

Syslog Analyzer

Verifying Storage Options

RME > Admin > Syslog > Set Backup Policy

Defining Message Filters

RME > Tools > Syslog > Message Filter

Defining Automated Actions

RME > Tools > Syslog > Automated Action

Creating Custom Syslog Reports

RME > Reports > Custom Templates

Reinstalling RME

This section explains how to reinstall RME 4.0.3.

Note The installation program is able to detect whether you have already installed RME 4.0.3. 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 CiscoWorks Server configuration is also preserved.

You can reinstall RME 4.0.3 either using Typical or Custom mode:

•If you choose Typical installation mode, the password assigned to the previous installation of RME database is retained.

See Reinstalling RME—Typical.

•If you choose Custom installation mode, you are prompted to enter a password for the RME database, else the password assigned to the previous installation of RME database is retained.

Use a minimum of five characters and a maximum of 15 characters. Do not start the password with a number and do not insert spaces between characters.

This password is also used while restoring or troubleshooting the RME database.

See Reinstalling RME—Custom.

Reinstalling RME—Typical

To reinstall RME using the Typical mode:

Step 1 Log in as the local administrator on the system on which you installed Common Services.

Step 2 Insert the RME 4.0.3 CD-ROM into a CD-ROM drive.

The Installer window appears.

If the Installer window does not appear:

a. Select Start > Run.

The Run dialog box opens.

b. In the Open field, enter drive:\RME\autorun.exe

where drive is the CD-ROM drive letter.

Step 3 Click Install.

The Welcome window appears.

Step 4 Click Next to continue.

The Software License Agreement window appears.

Step 5 Click Yes to accept the license agreement and proceed with the installation.

The Setup Type dialog box appears displaying two installation modes, Typical installation and Custom installation.

Step 6 Select Typical from the Setup dialog box.

Step 7 Click Next.

The installation program checks dependencies and system requirements.

The System Requirements window appears.

Step 8 Click Next.

The Daemons Restart Option window appears.

•If you plan to install another LMS application after installing RME, enter No.

•If you plan not to install another LMS application after installing RME, enter Yes.

Step 9 Click either Yes to restart CiscoWorks daemons or No not to restart CiscoWorks daemons.

The Summary window appears.

Step 10 Click Show Details, to view all settings including those selected automatically.

A Security Alert dialog box appears.

Step 11 Click Yes to view details.

The summary details view displays the randomly generated Essentials database password in clear text. The Summary window displays installation details.

Note Memorize your password displayed on the console. We recommend you do not write it down.

Step 12 Click Next.

The Setup screen appears, displaying installation progress while files are copied and applications are configured.

The following message appears:
To ensure that you retain the latest device support, please install 
the latest Device Packages from CCO 
@http://www.cisco.com/pcgi-bin/tablebuild.pl/cw2000-rme
Please refer to the Installation and Setup Guide for details.
For more information about Service Packs, see "Troubleshooting the Installation".

Step 13 Click OK.

The following message appears:
If you are migrating from RME 3.x versions, you must install or 
upgrade all the required applications in LAN Management Solution 
(LMS), and then run the migration scripts to restore the data.
For more information about restoring the LMS data, see the Data Migration Guide for LAN Management Solution 2.5.1 on Cisco.com. See Related Documentation.

Step 14 Click OK.

The Setup Complete dialog box appears.

If you have chosen not to restart the CiscoWorks daemons in Step 9, this dialog box lists the CiscoWorks daemons and also provides the command to restart these daemons.

Step 15 Click Finish.

You have completed the RME installation.

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 Common Services installation creates SystemDrive:\CiscoWorks_setupxxx.log, where xxx is the log file for the last CiscoWorks application installed. If you request for assistance, the Technical Assistance Center (TAC) might ask you to send them the installation log.

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

Reinstalling RME—Custom

To reinstall RME using the Custom mode:

Step 1 Log in as the local administrator on the system on which you installed Common Services.

Step 2 Insert the RME 4.0.3 CD-ROM into a CD-ROM drive.

The Installer window appears.

If the Installer window does not appear:

a. Select Start > Run.

The Run dialog box opens.

b. In the Open field, enter drive:\RME\autorun.exe

where drive is the CD-ROM drive letter.

Step 3 Click Install.

The Welcome window appears.

Step 4 Click Next to continue.

The Software License Agreement window appears.

Step 5 Click Accept to accept the license agreement and proceed with the installation.

The Setup Type dialog box appears displaying two installation modes, Typical installation and Custom installation.

Step 6 Select Custom from the Setup dialog box.

Step 7 Click Next to continue.

The Change Essentials Database Password window appears.

Use a minimum of five characters and a maximum of 15 characters. Do not start the password with a number and do not insert spaces between characters:

Step 8 Do either of the following:

•To create a new password:

–Enter a password of minimum five characters in the Password field.

–Re-enter the password in the Confirm Password field.

•To let RME generate a random password for you, leave the Password field and the Confirm Password field blank.

Note If you enter a password with less than five characters, RME automatically generates a random password.

You can view your password in clear text in the Security dialog box (Step 13).

Step 9 Click Next.

The installation program checks dependencies and system requirements.

The System Requirements window appears.

Step 10 Click Next.

The Daemons Restart Option window appears.

•If you plan to install another LMS application after installing RME, enter No.

•If you plan not to install another LMS application after installing RME, enter Yes.

Step 11 Click either Yes to restart CiscoWorks daemons or No not to restart CiscoWorks daemons.

The Summary window appears.

Step 12 Click Show Details to view all settings including those selected automatically.

A Security Alert dialog appears.

Step 13 Click Yes to view details.

The Summary Details view displays the password in clear text. The Summary window displays installation details.

Step 14 Click Next.

The Setup screen appears, displaying installation progress while files are copied and applications are configured.

The following message appears:
To ensure that you retain the latest device support, please install 
the latest Device Packages from CCO 
@http://www.cisco.com/pcgi-bin/tablebuild.pl/cw2000-rme
Please refer to the Installation and Setup Guide for details.
For more information about Service Packs, see "Troubleshooting the Installation".

Step 15 Click OK.

The following message appears:
If you are migrating from RME 3.x versions, you must install or 
upgrade all the required applications in LAN Management Solution 
(LMS), and then run the migration scripts to restore the data.
For more information about restoring the LMS data, See the Data Migration Guide for LAN Management Solution 2.5.1 on Cisco.com. See Related Documentation.

Step 16 Click OK.

The Setup Complete dialog box appears.

If you have chosen not to restart the CiscoWorks daemons in Step 11, this dialog box lists the CiscoWorks daemons and also provides the command to restart these daemons.

Step 17 Click Finish.

You have completed the RME installation.

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 Common Services installation creates SystemDrive:\Ciscoworks_setupxx.log, where xx is the log file for the last CiscoWorks application installed. If you request for assistance, the Technical Assistance Center (TAC) might ask you to send them the installation log.

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

Uninstalling RME

The uninstallation program removes files and settings. Uninstallation allows you to remove the product alone or remove Common Services as well. To remove Common Services, you must first remove RME.

Before removing the RME, you must remove any applications that depend on the product. That is, the applications for which installing RME is a prerequisite.

Uninstalling RME takes about 30 minutes.

Caution You must use the uninstall program to remove the product. If you try to remove RME or its components manually, CiscoWorks may stop functioning. Uninstalling the product removes the database as well.

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

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

Note You cannot uninstall Common Services without uninstalling RME.

Step 2 Deselect the components you want to keep or click Select 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.

The following message appears:
Uninstallation is complete. Click Ok to finish.
Step 5 Click OK.

To install RME once again, follow the instructions in the "Performing New RME Installation" section.