cc/td/doc/product/rtrmgmt/crm
hometocprevnextglossaryfeedbacksearchhelp
PDF

Table of Contents

Installing Resource Manager

Installing Resource Manager

Cisco Resource Manager is a suite of web-based network management tools integrated into a network desktop. Resource Manager includes a web-server component, web-based tools, and web browser capability. Resource Manager is based on a client/network architecture that connects multiple web-based clients to a network server. Resource Manager enables the deployment, monitoring, and troubleshooting of devices across your network.

This chapter consists of the following sections:

Preparing for Installation

Before you install Resource Manager, make sure your server and client environments meet the hardware and software requirements described in the following sections:

Server Requirements

Make sure your server meets the following hardware and software requirements and software compatibility recommendations.


Note The hardware and software version information is subject to change based on enhancements made to Resource Manager. For the most up-to-date version information, consult the Cisco Resource Manager Release Notes for Solaris found on CCO.

Hardware and Software Requirements

The requirements for the Resource Manager server are

Before installing Resource Manager, verify that you have enough storage capacity on the /opt partition, or the location you specify for the installation, by entering the following command:
# df -k /opt
Approximately 6800 KB are required in the /opt partition.

The software required for the Resource Manager server is Solaris 2.5.1 (with patch 103738-03) or Solaris 2.6. Patch 103738-03 is required for Solaris 2.5.1 only when a significant number of messages are processed by syslogd (the daemon process that reads and forwards system messages to the appropriate log file and users when necessary).

Use the showrev -p command to make sure the 103738-03 patch (for Solaris 2.5.1) is applied.You can find additional information about the Sun patch at the following location:

http://www.cisco.com/kobayashi/sw-center/netmgmt/rm-planner.shtml

Client Requirements

Clients can use a workstation or PC to access the Resource Manager server. The hardware and software requirements for the client workstations or PCs are

If you experience browser problems, increase your disk cache settings. You should never set your disk cache to zero.

Once the web browser is installed on the client machine, there are no additional disk space requirements. However, because the browser uses the local machine's disk to store cached information, make sure you have enough disk space for the amount of cached information you want to store. All Resource Manager information is stored on the Resource Manager server.

Setting Environmental Variables

System administrators should set the following environment variables for those users who need to perform administrator tasks directly on the server. These variables are not required for tasks users perform using the web interface.

or

Web Browsers Supported

Resource Manager is supported on the browsers shown in Table 1-1.


Table  1-1: Supported Browsers
Browser Version
Netscape Navigator 3.031 on Solaris 2.5.1 or 2.6
4.032 on Solaris 2.5.1 or 2.6, Windows NT 4.0, Windows 95, AIX 4.2 and HPUX 10.2
Microsoft Internet Explorer3 3.02 and 4.0 with Windows NT 4.0 and Windows 95

1 With Java and JavaScript enabled under Options > Network Preference > Languages
2 With Java and JavaScript enabled under Edit > Preferences > Advanced
3 With Enable Java Programs and Active-X Scripting enabled under View > Options > Security

Make sure your cache is set correctly by following these steps:

Device Import Supported Software

Table 1-2 lists the Resource Manager supported software for device import. If you plan on importing device information from CiscoWorks or CiscoWorks for Switched Internetworks (CWSI), you must have a supported version of CiscoWorks or CWSI installed on your system or on a system on your network before installing Resource Manager.


Table  1-2: Supported Software for Device Import
Software Version
HP OpenView 4.11, 5.0.1
CiscoWorks1 3.2, 4.0
CiscoWorks for Switched Internetworks (CWSI) 1.3, 2.1

1 You can import devices from a CiscoWorks database that is running on a UNIX workstation only.

Using Server IP Address

To avoid conflicts because of inconsistencies in how domain names are used in networks, Resource Manager uses the IP address of the server on which you installed Resource Manager when it interacts with web browsers. By using the IP address of the server, Resource Manager reduces the likelihood of name lookup failures between the server and the client machines that run web browsers.

Because Resource Manager uses the IP address, if you change the IP address of the Resource Manager server, you need to replace the old IP address with the new address in the web server configuration file (/opt/CSCOpx/objects/web/conf/httpd.conf). You can either manually change all occurrences of the ServerName variable to reflect the new IP address, or enter the following command to update the web server's address:

# /opt/CSCOpx/bin/changeaddress

You then need to restart the Resource Manager server by entering the following commands as root:

# /etc/init.d/dmgtd stop
# /etc/init.d/dmgtd start

TCP Ports Used

Resource Manager uses the following Transmission Control Protocol (TCP) ports. These ports are added to /etc/services when you install Resource Manager:

or

Resource Manager uses the default port 80. If an existing web server is already configured to run on port 80 on the same machine on which Resource Manager is installed, you receive a warning that port 80 is in use, and port 1741 is used for Resource Manager. If Resource Manager uses port 1741, make sure you append :1741 to the end of your server name when accessing the Resource Manager server through your browser, for example:

http://server_name:1741

System Files Modified During Installation

The following system files are modified during the installation of Resource Manager:

Installing Resource Manager

This section describes how to install Resource Manager. You have two options to proceed with the installation:

New Installation

This section explains how to install Resource Manager on your system if you do not have a previous version installed. The installation takes approximately 20 minutes to complete if you use the express installation on a SPARCstation 20. If you do not specify the express installation, the installation takes longer because you have to respond to each prompt issued by the installation tool. See the "Custom Installation" section to see the questions asked.


Note You can press Ctrl-C at any time to terminate the installation.

Follow these steps to install Resource Manager:

Step 1 As root, mount the Resource Manager CD-ROM on a local or remote CD-ROM drive. Refer to the appendix "Mounting and Unmounting on Solaris" for detailed instructions on mounting.

Step 2 To install Resource Manager,

# cd /cdrom/cdrom0/
# ./setup.sh
# cd /cdrom/crm11/
# ./setup.sh

You get the following message:


Software Install Tool Started.


The Resource Manager installation tool performs several checks on your machine, such as TCP/IP address resolution, TCP/IP port usage, and disk space usage, then displays information about express installation.


The express install takes all defaults and places the product into /opt/CSCOpx. No more questions will be asked of you.


Do you want the Express Install (y/n)? [Y]


You now have two options for continuing with the Resource Manager installation:


Express Installation

If you entered Y (yes) when asked if you want the express installation, the Resource Manager installation begins. Resource Manager is installed with the following defaults:

You do not need to answer any additional questions. The Resource Manager installation tool keeps you updated on the status of the installation. Any error or warning messages are displayed on your screen. You see the following message when the installation is complete:

Software Install Tool Completed.


Now that you have installed Resource Manager, you can continue with "Setting Up Resource Manager." If you encountered any errors during the installation, or to verify the directories installed on your system, see the "Troubleshooting" appendix.

Custom Installation

If you entered N (no) when asked if you want the express installation, the installation tool asks a question similar to the following:

Where should the product be installed? [/opt/CSCOpx]

Step 1 To accept the default, which is shown in square brackets, press Return or enter a new path where you want Resource Manager to be installed.

The installation tool prompts you to enter the TCP port for the Daemon Manager to use.


Step 2 To accept the default TCP port shown in square brackets [42340], press Return or enter a new TCP port for the Daemon Manager. The installation tool displays the input validation and asks you if the information is correct.

Step 3 Press Return if the values are correct.

The installation tool installs Resource Manager. Any error or warning messages are displayed on your screen. You see the following message when the installation is complete:


You have now completed the Resource Manager installation. Continue with "Setting Up Resource Manager." If you encountered any errors during the installation, or to verify the directories installed on your system, see the "Troubleshooting" appendix.

Upgrade Installation

This section explains how to install Resource Manager if you have a previous version installed on your machine. Before you install Version 1.1, you should back up your current Resource Manager data files to avoid any potential loss of data.

Backing Up Data Files

To ensure you will be able to use your existing software images in Resource Manager Version 1.1, create a backup copy of your Resource Manager data files by following these steps:


Note If bin is included in the /usr/lib/cron/at.deny file, the procedure for backing up your data files is different than the steps below. In this case, a screen appears with instructions for backing up your data files.

Step 1 As root, create a directory, for example /opt/crm_backup, to store your backup database:

Step 2 Change the ownership of the backup directory to bin by entering the following command:

Step 3 From Resource Manager, click Admin on the button bar, then select
System Admin > Back Up Data
. The Backup dialog box appears.

Step 4 To perform the backup now, click Next.

Step 5 Enter /opt/crm_backup, or the name of the directory you specified in Step 1, in the Backup Directory field.

Step 6 Leave Now as the backup date and time (do not modify the values), then click Next.

Step 7 You are notified that the data files were successfully backed up and the files px.db and px.log were created in the directory you specified. In addition, a new tar file is created, CRM_filebackup.tar, which includes software image files and other files that Resource Manager deems necessary to back up.

Step 8 Log out of Resource Manager by clicking Logout and install Version 1.1 as explained in the following section.

Installing New Version

Now that you have created a backup of your Resource Manager data files, you can upgrade to Cisco Resource Manager Version 1.1 by following these steps:

Step 1 As root, mount the Resource Manager CD-ROM on a local or remote CD-ROM drive. Refer to the appendix "Mounting and Unmounting on Solaris" for detailed instructions on mounting.

Step 2 To install Resource Manager,

# cd /cdrom/cdrom0/
# ./setup.sh

# cd /cdrom/crm11/
# ./setup.sh

You get the following message:


Software Install Tool Started.


The Resource Manager installation tool performs several checks on your machine, such as TCP/IP address resolution, TCP/IP port usage, and disk space usage, and then displays information about express installation.


The express install takes all defaults and places the product into /opt/CSCOpx. No more questions will be asked of you.


Do you want the Express Install (y/n)? [Y]


You now have two options for upgrading your system:


Express Installation

If you enter Y (yes) when asked if you want the express installation, the Resource Manager installation begins. The existing files are overwritten by the updated Version 1.1 files. Resource Manager is installed with the following defaults:

You do not need to answer any additional questions. The Resource Manager installation tool keeps you updated on the status of the installation. Any error or warning messages are displayed on your screen. You see the following message when the installation is complete:

Software Install Tool Completed.


Now that you have installed the updated version of Resource Manager, you can continue with "Setting Up Resource Manager." If you encountered any errors during the installation, or to verify the directories installed on your system, see the "Troubleshooting" appendix.

Custom Installation

If you enter N (no) when asked if you want the express installation, the installation tool displays the following statement:

Enter tcp port for Daemon Mgr to use [42340]

Step 1 To accept the default, which is shown in square brackets [42340], press Return or enter a new tcp port for the Daemon Manager. The installation tool displays the input validation and asks you if the information is correct.

Step 2 Press Return if the values are correct.

The installation tool installs Resource Manager. Any error or warning messages are displayed on your screen. You see the following message when the installation is complete:


You have now completed the Resource Manager installation. Continue with "Setting Up Resource Manager." If you encountered any errors during the installation, or to verify the directories installed on your system, see the "Troubleshooting" appendix.

Installing Added Functionality

If you have CCO access, you can consult the Resource Manager web page at the following URL to download any available software enhancements:

http://www.cisco.com/kobayashi/sw-center/netmgmt/rm-planner.shtml

Consult the readme files and Cisco Resource Manager Release Notes for Solaris for additional information on installing new features and enhancements.

Removing Resource Manager

If you want to remove Resource Manager, follow these steps:

Step 1 Enter the following command as root to start the uninstall script:

# /opt/CSCOpx/bin/uninstall.sh


where /opt is the directory you specified to install Resource Manager if you did not use the default location.


The following message is displayed:


INFO:List of packages installed on this system:


CSCOavail
CSCOdb
CSCOhlp
CSCOinv
CSCOmd
CSCOnetc
CSCOperl
CSCOsa
CSCOswim
CSCOtcl
CSCOweb
CSCOxrts


INFO:Delete all the above listed Cisco Resource Manager pkgs from the system? [yes]


Step 2 To remove all Resource Manager packages, press Return or enter Y. The specified packages are removed and a message appears indicating the removal was successful. To cancel the removal of Resource Manager, enter N.

When you remove Resource Manager, the uninstallation script does not undo the changes made to the /etc directory. /etc still contains all system file changes. The uninstall messages are written to the /var/tmp/ciscouninstall.log file.


Step 3 Check /etc/syslog.conf for syslog changes. Check /etc/services to make sure port assignments for the Daemon Manager and web server have been removed. See the "Troubleshooting" appendix for more information.

To reinstall Resource Manager, follow the instructions in the "Installing Resource Manager" section.


hometocprevnextglossaryfeedbacksearchhelp
Copyright 1989-1997 © Cisco Systems Inc.