Table of Contents

Overview of the Upgrade Process

Backing Up the Cisco UGM 2.0 Database
Running the Cisco UGM Upgrade Script
Upgrading the Cisco EMF Patch
Starting Cisco EMF

Overview of Cisco UGM Installation

Cisco UGM Installation Scenarios
Installing the Java Plugin for CiscoView Operation with Cisco UGM 2.1
Installing the CiscoView Security Plugin Software
Installing the Cisco UGM Software Image

Checking the Installation

Checking the Cisco UGM 2.1 Map Viewer
(Optional) Restoring Your Database Manually

Example: Restoring Your Database Manually

(Optional) Restoring Your Database Interactively
Troubleshooting Uninstalling Cisco UGM

Example: Upgrading from Cisco UGM 2.0 to Cisco UGM 2.1

Upgrading Cisco UGM

• If you are running Cisco UGM 2.0 and wish to upgrade to Cisco UGM 2.1, follow the procedures described in this chapter.
  
  
• If you are running Cisco UGM 1.0 and wish to upgrade to Cisco UGM 2.1:
  
  
• First upgrade to Cisco UGM 2.0 as described in the Cisco Universal Gateway Manager Installation, Upgrade, and Troubleshooting Guide, Version 2.0 located at: http://www.cisco.com/univercd/cc/td/doc/product/rtrmgt/ugm/ugm2
  
  
• Then upgrade to Cisco UGM 2.1 by following the procedures described in this chapter.
  
  

Sections in this chapter are:

• Overview of the Upgrade Process
  
  
• Backing Up the Cisco UGM 2.0 Database
  
  
• Running the Cisco UGM Upgrade Script
  
  
• Upgrading the Cisco EMF Patch
  
  
• Starting Cisco EMF
  
  
• Overview of Cisco UGM Installation
  
  
• Cisco UGM Installation Scenarios
  
  
• Installing the Java Plugin for CiscoView Operation with Cisco UGM 2.1
  
  
• Installing the Cisco UGM Software Image
  
  
• Checking the Cisco UGM 2.1 Map Viewer
  
  
• (Optional) Restoring Your Database Manually
  
  
• (Optional) Restoring Your Database Interactively
  
  
• Troubleshooting Uninstalling Cisco UGM
  
  

Overview of the Upgrade Process

Tip Before you upgrade Cisco UGM, locate these documents: - Cisco Universal Gateway Manager Installation, Upgrade, and Troubleshooting Guide, Version 2.1 (this document) - Cisco Element Management Framework Installation and Administration Guide, Version 3.2

During the upgrade process:

• Cisco EMF must be running
  
  
• Cisco UGM cannot perform system management functions
  
  
• Open user sessions are terminated
  
  

---

Note   You must be a root user to perform these upgrade tasks.

---

Backing Up the Cisco UGM 2.0 Database

Step 1   Log in as a root user.

Step 2   Change to the bin directory of Cisco EMF.

Example:

cd /opt/cemf/bin

Step 3   Run the backup script:

./cemf backup

This command backs up the databases currently in /opt/Backup/MM-DD-YYYY.

Running the Cisco UGM Upgrade Script

Note   You must run the upgrade script from the directory where the script is located.

Step 1   Verify that you have exited from all Cisco EMF sessions.

Step 2   Insert the Cisco Universal Gateway Manager CD-ROM.

Step 3   Change to the directory where Cisco UGM 2.0 is installed, and enter:

./uninstallCSCOugm -u

This script removes Cisco UGM Version 2.0 while retaining Cisco UGM 2.0 data.

For more information, see the "Example: Upgrading from Cisco UGM 2.0 to Cisco UGM 2.1" section.

Tip If the uninstallation fails, check the log file lluninstall.log in the /tmp directory to identify the problem.

Upgrading the Cisco EMF Patch

Step 1   Download the Deployment Release Notes for the software patch that you want to deinstall.

The document is located at:

http://www.cisco.com/cgi-bin/tablebuild.pl/cemf-dev32?sort=filename

Step 2   Locate the directory where the patch is stored.

Step 3   Follow the uninstallation instructions in the Cisco EMF Patch Deployment Release Notes.

Step 4   Identify the Cisco EMF patches necessary for your installation by referring to one of the following:

• Cisco Universal Gateway Manager Release Note, Version 2.1
  
  
• Release Note for coresidence of Cisco MNM and Cisco UGM Network Management Systems
  
  

Step 5   Download the patch software and its deployment release notes, located at :

http://www.cisco.com/cgi-bin/tablebuild.pl/cemf-dev32?sort=filename

Step 6   Follow the installation instructions in the Cisco EMF Patch Deployment Release Notes.

Note   If you have a Cisco EMF Server installation, install the Server patch only. If you have a Cisco EMF Client installation, install the Client patch only. Install the Server or Client patch on each machine where the Cisco EMF 3.2 Server or Client image was installed.

The installation process starts. Cisco EMF processes stop automatically before the patch installation starts.

Step 7   Sart Cisco EMF as described in the "Starting Cisco EMF" section.

Starting Cisco EMF

Cisco EMF operations are fully described in the Cisco Element Management Framework Installation And Administration Guide.

Cisco EMF software on a server or client is automatically started during system bootup. To start this software at other times:

Step 1   Log in as the root user on the system where you want to install Cisco UGM.

Step 2   From the command line, enter:

<CEMF_ROOT>/bin/cemf start

where <CEMF_ROOT> is the directory where Cisco EMF is installed.

The Cisco EMF processes start, and a message informs you when the startup is complete.

Note   Cisco EMF processes will not start if the host IP address cannot be reached. The Host IP address <IP address> is unreachable -- aborting.... message appears. Cisco EMF processes stop.

Do not start a user session at this point because the Cisco UGM installation will end any running Cisco EMF GUI-based sessions.

Overview of Cisco UGM Installation

After Cisco UGM 2.0 is removed from your systems, install Cisco UGM 2.1 on your server and client.

The Cisco EMF run level is lowered (placed offline) at the start of the Cisco UGM installation process and is reset at completion to its former level (placed online).

If Cisco EMF detects any traces of Cisco UGM from a previous installation, this installation ends. Enter ./uninstallCSCOcugm to remove traces of the previous installation.

If the installation script does not find the swap space disk partition, enter the location of the swap space; if the swap space disk partition is less than 2GB, the installation ends.

For help in setting up the swap space disk partition, refer to the Cisco Element Management Framework Installation and Administration Guide.

Cisco UGM Installation Scenarios

Note   The scenarios in this table specify supported software versions for Cisco UGM only. When CiscoView is installed on a different server, refer to the CiscoView documentation for the versions of software that it supports.

Installing the Java Plugin for CiscoView Operation with Cisco UGM 2.1

In order to operate CiscoView version 5.3 or 5.4 with Cisco UGM 2.1, you must download the Java plugin from the Sun software download website.

Note   Refer to the CiscoView 5.3 and 5.4 documentation for the exact version of the Java plugin required.

Download the plugin software to the same server where Netscape and
Cisco UGM 2.1 will be installed. Note the location of the plugin software as you will be prompted for its path during the installation.

Installing the CiscoView Security Plugin Software

Step 1   Log in to the CiscoView server as the root user.

Step 2   Enter the following command:

$UGMsoftware/CVSecurityPlugin/pkg/cvsecurityinstall

Installing the Cisco UGM Software Image

Step 1   Check that CiscoView 5.4 is installed and running on either the local or remote machine. For information about installing CiscoView, refer to the CiscoView product documentation located in the documentation directory of the CiscoView CD ROM.

Step 2   Log in to the Cisco EMF server as the root user.

Step 3   If Cisco EMF is not already running, start Cisco EMF by entering:

<CEMFROOT>/bin/cemf start

Step 4   Insert the Cisco Universal Gateway Manager 2.1 CD-ROM.

Step 5   Change to this CD-ROM drive and directory:

cd /cdrom/ugm_2.1

Step 6   If you are installing Cisco UGM on the server, enter:

./installCSCOcugm

Or

If you are installing Cisco UGM on the client, enter:

./installCSCOcugm -c

The installation script checks that Cisco EMF version 3.2 is installed. If it detects an older version of Cisco EMF, the installation ends.

Step 7   Specify if this is an upgrade or a new installation:

Step 8   Specify if you will use CiscoView with this Cisco UGM installation:

• If you answer y (yes), go to Step 10.
  
  
• If you answer n (no), the installation is started.
  
  

Step 9   Select the version of CiscoView that you will use:

Depending on your response, one of these messages is displayed:

Step 10   Enter the following information for CiscoView:

WARNING: No checks will be performed on IP address!

Please enter IP address of the CiscoView server: 172.22.41.86

IP Address is 172.22.41.86

WARNING: No checks will be performed on port number!

Please enter port number used by CiscoView server: [1741]

To accept the default, press Enter.

Port number is 1741

Jdk, Jre, or Java plugin version 1.3.1 is required. Please enter the path where Jdk, Jre, or Java plugin is installed. For example: /opt/j2se (where /opt/j2se/bin/java is the executable). Please enter the path: /j2re1_3_1 Java version is "1.3.1"

Step 11   Enter the location of Netscape on the server:

Use netscape found at /opt/cemf/netscape4.76/netscape? Press enter to accept or enter new location:

The Cisco UGM installation takes approximately one hour to complete.

If the installation fails, check the avLoad.log file (located in the /opt/cemf/logs directory) and see "Troubleshooting Cisco UGM."

Checking the Installation

When you have completed the Cisco UGM installation procedure, verify that the Cisco UGM controllers are running.

Enter:

/opt/cemf/bin/cemf query

In the resulting display, make sure that the ASMainCtrl, IOSConfigCtrl, ASFaultStandAlone, and ASPerformInv controllers are listed.

Checking the Cisco UGM 2.1 Map Viewer

Step 1   Open the Map Viewer in Cisco UGM 2.1.

Step 2   Check if the folders contain the information transferred from Cisco UGM 2.0.

Step 3   Check the dialog settings in ASEMSConfig > Performance Polling and ASEMSConfig > File Export.

if the Map Viewer does not contain information from Cisco UGM 2.0, restore your database as described in either of these sections:

• (Optional) Restoring Your Database Manually
  
  
• (Optional) Restoring Your Database Interactively
  
  

(Optional) Restoring Your Database Manually

With Cisco EMF, you can back up and restore databases (which are typically located in <CEMFROOT>/AVBackup) by using the Cisco EMF script (cemf), typically located in /opt/cemf/bin.

Caution   Although Cisco EMF allows for selective restoration of its database, Cisco UGM does not support this feature. When restoring Cisco UGM data, you must restore all Cisco EMF databases.

Step 1   Log in as the root user.

Step 2   Change to the following directory:

cd /opt/cemf/bin

Step 3   Enter the following command to stop Cisco EMF:

./cemf stop

Step 4   Enter the following command:

./cemf restore

Step 5   Enter the date that the backup was created:

mm-dd-yyyy

• mm is the month when the back up was made.
  
  
• dd is the day when the back up was made.
  
  
• yyyy is the year (containing the month and day) when the backup was made.
  
  

Example: Restoring Your Database Manually

If you backed up your database on 5/29/2000, the backup file directory and configuration are saved in a directory named 05/29/2000, which reflects the date when the backup was performed.

In order to restore the database as of 5/29/2000, enter this command:

Refer to the Cisco Element Management Framework Installation Guide for further details.

(Optional) Restoring Your Database Interactively

With Cisco EMF, you can back up and restore databases (which are typically located in <CEMFROOT>/AVBackup) by using the Cisco EMF script (cemf), typically located in /opt/cemf/bin.

Caution   Although Cisco EMF allows for selective restoration of its database, Cisco UGM does not support this feature. When restoring Cisco UGM data, you must restore all Cisco EMF databases.

Step 1   Log in as the root user.

Step 2   Change to the following directory:

cd /opt/cemf/bin

Step 3   Enter the following command to stop Cisco EMF:

./cemf stop

Step 4   Enter the following command:

./cemf restoreDataset

A list of stored backups (by weekly date) appears.

Step 5   Select the relevant week.

Step 6   Select the relevant backup.

Refer to the Cisco Element Management Framework Installation Guide for further details.

Troubleshooting Uninstalling Cisco UGM

You may have difficulty uninstalling Cisco UGM for these reasons:

• Your temporary license ended and you cannot start Cisco EMF.
  
  
• Cisco UGM stopped operating.
  
  

If either of these conditions exists, uninstall each individual element package.

The names of the server packages are:

• ASMainEMm
  
  
• IOSCfgm
  
  

The names of the client packages are:

• ASMainEMc
  
  
• IOSCfgc
  
  

Follow this procedure to uninstall individual element packages:

Step 1   Remove the element package registration from Cisco EMF by entering:

<CEMF_ROOT>/bin/cemf load -removelock -skipportcheck -remove <Pkg Name>

Step 2   Remove Cisco EMF by entering:

<CEMF_ROOT>/bin/cemfinstall -remove

Example: Upgrading from Cisco UGM 2.0 to Cisco UGM 2.1

Posted: Wed Dec 4 14:32:58 PST 2002
All contents are Copyright © 1992--2002 Cisco Systems, Inc. All rights reserved.
Important Notices and Privacy Statement.