Table of Contents

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
  
  
• Installing Resource Manager
  
  
• Removing Resource Manager
  
  

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
  
  
• Client Requirements
  
  

Server Requirements

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

Hardware and Software Requirements

The requirements for the Resource Manager server are

• Sun SPARCstation 20, Ultra1, or Ultra2 and a color monitor. A SPARCstation 20 is adequate if you have fewer than 50 devices. For acceptable user interface response time when you have more than 50 devices, an Ultra is recommended.
  
  
• 64 MB of RAM (minimum installation requirement); 128 MB recommended.
  
  
• 250 MB of available disk space (minimum installation requirement); 2 GB recommended. The majority of disk space beyond 250 MB is required to store data collected by or essential to the Resource Manager packages.
  
  

  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/public/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

• PC—Windows NT 4.0 or Windows 95
  
  
• Sun SPARCstation—Solaris 2.5.1 or 2.6
  
  
• Any of the web browsers listed in Table 1-1
  
  

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.

• Add /opt/CSCOpx/bin (or the path to the directory in which Resource Manager was installed) to the PATH variable in the .cshrc or .profile files of Resource Manager users that have administrator privileges.
  
  
• Add /opt/CSCOpx/man to the MANPATH variable.
  
  

  or

• Source the /opt/CSCOpx/etc/install.cshrc file for csh-users, or the /opt/CSCOpx/etc/install.profile file for Bourne or Korn shell users.
  
  

Web Browsers Supported

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

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

• For Netscape Navigator 3.03, select Options > Network Preferences > Cache. Set both the Memory Performance Cache and the Disk Cache to at least 4096 KB.
  
  
• For Netscape Navigator 4.03, select Edit > Preferences > Advanced > Cache. Set both the Memory Performance Cache and the Disk Cache to at least 4096 KB.
  
  
• For Microsoft Internet Explorer, select View > Options > Advanced. Set the cache size to at least 4 MB. Compute the percentage value in terms of your total disk space and set the Amount of disk space to use to that value.
  
  

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.

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:

• 42340/tcp (default port for the Resource Manager Daemon Manager, the tool that manages server processes)
  
  
• 80/tcp (the default port for the Resource Manager HTTP server)
  
  

  or

• 1741/tcp (the alternative port used for the Resource Manager HTTP server, as follows)
  
  

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:

• /etc/services
  
  
• /etc/inetd.conf
  
  
• /etc/syslog.conf
  
  
• /usr/lib/cron/at.deny
  
  
• /var/sadm/install/admin/default
  
  

Installing Resource Manager

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

• If you do not have Resource Manager installed on your system, see the following section, "New Installation."
  
  
• If you have a previous version of Resource Manager installed on your system, skip to the "Upgrade Installation" section.
  
  

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.

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,

• For a local CD installation, enter the following commands:
  
  

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

• For a remote CD installation, enter the following commands:
  
  

  # 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. It is recommended that you enter Y when asked if you want the express installation. This option installs Resource Manager in the default directory with the default settings without requiring you to answer any additional questions.
  
  
• Custom installation. You should install Resource Manager this way if you want to change the location of the installation or change the TCP port used by the Daemon Manager.
  
  

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:

• TCP port 80 (or port 1741 if port 80 is in use) is used for the HTTP server
  
  
• TCP port 42340 is used for the Daemon Manager
  
  

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:

Software Install Tool Completed.

 

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:

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

# mkdir /opt/crm_backup
 

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

# chown bin /opt/crm_backup
 

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,

• For a local CD installation, enter the following commands:
  
  

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

• For a remote CD installation, enter the following commands:
  
  

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

You get the following message:

Software Install Tool Completed.

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.

Software Install Tool Started.

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

You now have two options for upgrading your system:

• Specify Express Installation to install Resource Manager in the default directory with the default settings without requiring you to answer any additional questions.
  
  
• Specify Custom Installation to change the location of the installation or the TCP port for the Daemon Manager.
  
  

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:

• TCP port 80 (or port 1741 if port 80 is in use) is used for the HTTP server
  
  
• TCP port 42340 is used for the Daemon Manager
  
  

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:

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

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:

Software Install Tool Completed.

 

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/public/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:

Software Install Tool Completed.

Software Install Tool Completed. CSCOmd
INFO:List of packages installed on this system:CSCOswim
CSCOavail
CSCOdb
CSCOhlp
CSCOinv


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.