Cisco 12000 Manager Release 2.2
Installation

Table Of Contents

Installation

Installation Workflow

System Requirements

License Requirements

Small Deployment Manager Requirements

Large Deployment Manager Requirements

Client Requirements

CEMF Requirements

Manager and Client Installations

Manager Installation

Client Installation

Installing C12kM from a Remote CD-ROM Drive

Installing C12kM from a Local CD-ROM Drive

Uninstalling C12kM

Upgrading to CEMF 3.2 and C12kM 2.2


Installation


This chapter describes pre-installation tasks and the Cisco 12000 Manager (C12kM) installation procedure in the following sections:

Installation Workflow

System Requirements

Manager and Client Installations

Installing C12kM from a Remote CD-ROM Drive

Installing C12kM from a Local CD-ROM Drive

Uninstalling C12kM

Upgrading to CEMF 3.2 and C12kM 2.2

Installation Workflow


Note A fully licensed version of the Cisco Element Management Framework (Cisco EMF) version 3.2 must be installed and started (that is, the Cisco EMF should be running in the background) before you attempt to install the Cisco 12000 Manager (C12kM) application. Refer to the Cisco Element Management Framework Installation and Administration Guide Release 3.2 (78-12536-01) for details on installing and starting Cisco EMF.


The process of installing C12kM involves the following steps:

1. System requirements—Review the "System Requirements" section to confirm correct pre-installation procedures.

2. Cisco EMF—Verify that you have Cisco EMF version 3.2 installed and started before proceeding. Refer "CEMF Requirements" section for further details on the CEMF requirements.

3. Installation—Install the C12kM application, as follows:

a. Refer to the "Manager and Client Installations" section to determine the type of deployment.

b. Perform the procedure in one of the following sections:

"Installing C12kM from a Remote CD-ROM Drive" section

or

"Installing C12kM from a Local CD-ROM Drive" section.

4. C12kM Set Up—

a. Perform configuration tasks on the Cisco 12000 series router. For details, refer to the "Router Configuration" section.

b. Enable trap notifications on the Cisco 12000 series internet router. For details, refer to the "Enabling Traps" section.

c. Configure a workstation to allow backup/restore capability. For details, refer to the "Setting Up a Workstation as a TFTP Server" section.

5. C12kM Session—To begin working in C12kM, refer to the "Starting a User Session" section.

System Requirements

C12kM can be deployed in a number of different configurations, from a single hardware system to a multisite distributed management system.

All Cisco EMF-based solutions run on Sun Solaris/SPARC hardware running the Solaris operating environment, release 2.6.

Use C12kM version 2.2 with Cisco 12000 series internet routers using one of the following Cisco IOS releases: 12.0(10)S, 12.0(11)ST, 12.0(12)ST, 12.0(13)ST, 12.0(14)ST, 12.0(15)S, 12.0(16)S, 12.0.(11)ST, 12.0(18)S, 12.0(18)ST1, 12.0(19)S, 12.0(21)S1 and 12.0(21)ST1.

System requirements are presented in the following sections:

License Requirements

Small Deployment Manager Requirements

Large Deployment Manager Requirements

Client Requirements

CEMF Requirements

Manager Installation

Client Installation

The manager installation includes all files that run a C12kM user session on the manager system. The C12kM system can therefore be installed on a single system with manager and client functionality, and can be enhanced by adding separate client machines later as necessary.

License Requirements

C12kM uses the Cisco EMF framework, which requires a license key to operate. For information about how to obtain a license key, refer to the Cisco Element Management Framework Installation and Administration Guide Release 3.2 (78-12536-01), or contact Cisco TAC for assistance.

Small Deployment Manager Requirements

Use Sun Ultra 60, configured as follows:

17-inch color monitor

2 x 9 GB internal disks

1 x 9 GB 10,000 rpm external disk

2 GB memory (minimum) this might need to increase to 3 GB depending on performance benchmarking

2 x 440 MHz processors

2 GB swap

Large Deployment Manager Requirements

Use Sun Enterprise 450, configured as follows:

17-inch color monitor

6 x 9 GB 10,000-rpm disks on 3 Ultra SCSI controllers

4 GB memory

4 x 440 MHz processors

2 GB swap


Note For large scale deployments, fault tolerant options are available (for example, Sun Netra FT1800).



Note If a number of graphically intensive applications are run on a workstation, it is helpful to use a 24-bit Sun color card. A typical manager installation requires 500 MB of free disk space in a file system. An appropriate amount of free disk space for database files is also required.


Client Requirements

Use Sun Ultra 5, configured as follows:

17-inch color monitor

9 GB internal disks

256-MB memory (minimum)

333 MHz processors

2 GB swap

CEMF Requirements

The C12kM Release 2.2 runs on CEMF 3.2 Build 136. The following patches must be installed before installing C12kM.


Note Ensure that the patches are installed in the same order as they are listed below.


The required patches are:

CEMF_3.2_PATCH_170001-19
(On CCO, the filename corresponding to this patch is CEMF3.2P1.tar.Z)

CEMF_3.2_PATCH_190101-10
(On CCO, the filename corresponding to this patch is CEMF3.2P1.1.tar.Z)

CEMF_3.2_PATCH_190105-09
(On CCO, the filename corresponding to this patch is CEMF3.2P1.5.tar.Z)

Manager and Client Installations

C12kM can be deployed in a distributed manner to utilize the power of multiple machines. Two types of deployment are available: manager and client. Note that both manager and client installations cannot be run on the same machine. You can either install a manager or client on one machine, but not both.

Manager Installation

Every C12kM deployment must have a manager installed. Processes on the manager keep track of the current state of the network model, user access, and events.

Client Installation

A C12kM deployment can have client installations on separate workstations. These client installations run C12kM applications that access objects on the manager. A client installation contains only those parts of C12kM that are necessary to run a C12kM user session. This user session communicates with the manager when required to retrieve management information. In this case, all window updates are processed locally on the client machine, freeing more resources on the manager to process network information.

The client installation copies the client application onto the local machine; therefore, there is no need to mount files across the network. The only network traffic occurs when the client requires more data from the manager.


Note The manager installation includes all files that run a C12kM user session on the manager system. The C12kM system can therefore be installed on a single system with manager and client functionality, and can be enhanced by adding separate client machines later as necessary.


Manager and client installations are presented in the following sections:

Installing C12kM from a Remote CD-ROM Drive

Installing C12kM from a Local CD-ROM Drive

Installing C12kM from a Remote CD-ROM Drive

To install the C12kM application onto a system that does not have its own CD-ROM drive, proceed as follows:


Caution Cisco EMF (version 3.2) must be running before you can install the C12kM application.


Step 1 Insert the C12kM CD-ROM into the CD-ROM drive on the remote host.

Step 2 Log in as a user with superuser rights on the remote host.

Step 3 Check to see if the Volume Manager is running by entering the following:

/usr/bin/ps -ef | grep vold

Step 4 If the Volume Manager is running, a message similar to this one is displayed:

root 591 1 0 Feb 26 ? 0 :01 /usr/sbin/vold

or

If the Volume Manager is not running, start the Volume Manager by entering the following:

/etc/rc2.d/S92volmgt start

Step 5 Export the CD-ROM device onto the remote host:

a. If the NFS related daemons are not already running, start them by entering the following:

/usr/lib/nfs/nfsd 8

/usr/lib/nfs/mountd

b. Share the mount point from the remote host by entering the following:

share -F nfs -o ro /cdrom/cdrom0

c. Verify that this host has made the CD-ROM drive accessible by entering the following:

share

The listing displayed includes the /cdrom mount point.

Step 6 Mount the remote CD-ROM on the local host (from where the installation is to take place):

a. Create a mount point if none exists already by entering the following:

mkdir /mnt/cdfiles

b. Mount the remote directory, by entering the following:

mount -r remote-host:/cdrom/cdrom0 /mnt/cdfiles


Note Replace remote-host with the host name of the remote device.


The contents of the CD-ROM should now be visible under the /mnt/cdfiles mount point.

Step 7 To continue installation, proceed to step 2 in the "Installing C12kM from a Local CD-ROM Drive" section.


Installing C12kM from a Local CD-ROM Drive


Note This section assumes that you are installing C12kM release 2.2 for the first time on a clean system. Refer to the "Upgrading to CEMF 3.2 and C12kM 2.2" section if you are upgrading from C12kM release 2.1 or 2.1.1.


After you install the Cisco EMF manager, acquire a valid license and start up Cisco EMF. You can install C12kM using cemfinstall as follows:


Step 1 Log in as a user with superuser rights.


Caution Cisco EMF (version 3.2) must be running before you can install the C12kM application.

Step 2 Insert the C12kM CD-ROM. Change the working directory into the CD-ROM area by entering the following:

cd /cdrom/cdrom0


Note A File Manager application window may appear to allow you to install the C12kM application. You may wish to use this interface installation instead of the command line.


Step 3 Change to the C12kM directory area by entering the following:

cd c12km_2.2

Step 4 Run the install script by entering the following:

./cemfinstall

A terminal window appears listing the various C12kM installation options.

Step 5 Type the number of the installation you require and press the return key.


Note If you installed the Cisco EMF Manager, select the C12kM Manager installation option. If you installed the Cisco EMF client, select the C12kM Client installation option or you can install Acrobat Reader if necessary to view the PDF documentation files. The default is q for quit. If you enter no value, you will quit the process. If you enter a question mark (?), the available installation options appear.


C12kM automatically detects what kind of Cisco EMF installation exists, manager or client, and directs you towards the correct C12kM install with the onscreen message, "incompatible type c|m." If the Cisco EMF manager is installed, the C12kM client install will be incompatible, and vice-versa.

The utility performs the appropriate installation. As each part of the installation takes place, messages are displayed on screen.

Step 6 When the installation is complete, exit the CD-ROM area by entering the following:

cd /

Step 7 Remove the CD-ROM by entering the following:

eject cdrom

Step 8 Check that all of the Cisco EMF and C12kM packages have installed correctly. Type:

CEMF_ROOT/bin/cemfinstall -show

For example, if you have installed C12kM as a Manager installation you will see the following package name: C12kM_Manager. Within the C12kM_Manager package you will see the following component package names: COMTechm, COMPlatm, COMModm, COMIntm, COMAOSOm, COMAODS3m, COMATMCnm, COMIOSm, COMEtherm, COMPOSm, DPTCOMm, COMIPm, COMVLANm, COMCEm, and C12kMPkm.

Step 9 Proceed to "C12kM Set Up," for details on setup, configuration and starting procedures.


Uninstalling C12kM

To uninstall C12kM, proceed as follows:


Step 1 Log on to the machine where C12kM is installed as a user with superuser rights.

Step 2 Make sure that Cisco EMF is running by entering the following:

CEMF_ROOT/bin/cemf query


Note Replace CEMF_ROOT with the directory where Cisco EMF is installed.


A message indicates whether or not Cisco EMF is running. If Cisco EMF is not running, start it now before proceeding.

Step 3 Uninstall C12kM. Type:

CEMF_ROOT/bin/cemf install -remove

A list of C12kM uninstallation options appear.


Note All C12kM processes are automatically stopped and uninstalled when the cemfinstall script is run with the -remove option.


Step 4 Enter the option you require. The default option is indicated (Def : 3), as well as the option to enter ? for help or q for quit.


Note Dependant applications (C12kM, in this case) must be removed before primary applications (Cisco EMF, in this case) can be removed, for example, the Cisco EMF cannot be removed until the C12kM is removed.


A message indicates that the uninstall is about to take place. If you proceed with the uninstall, the window scrolls through the application as it is removed. The following message appears:

Removal of <package> was successful.

The option to remove <C12kM> was completed successfully.


Upgrading to CEMF 3.2 and C12kM 2.2

This section describes the upgrade procedure from CEMF 3.1 to CEMF 3.2 and C12kM release 2.1/2.1.1 to release 2.2.

This procedure applies when:

Upgrading from C12kM 2.1

C12kM 2.1 runs with Cisco EMF 3.1 and patch 4

Upgrading from C12kM 2.1.1

C12kM 2.1.1 runs with Cisco EMF 3.1 and patch 5


Caution When upgrading C12kM, ensure that all the chassis are moved into the decommissioned state. This ensures that when the chassis objects are commissioned in the new system, the newly added agent poller tasks will be activated in their respective states.


Note After upgrading C12kM, by default all cleared alarms (which are one day old) are deleted from the system by a process called alarmDeleter. AlarmDeleter is a CEMF process, refer to Cisco EMF Installation and Administration Guide (78-12539-01) for details. To save all alarms it is recommended to export them to a flat file using Print option in Event browser. Please refer to Cisco Element Management Framework User Guide (78-12536-01) for more details.


To upgrade the C12kM 2.1/2.1.1 to C12kM 2.2, proceed as follows:


Step 1 Login to the machine where C12kM is installed as the superuser (su).

Step 2 Change directory to the Cisco EMF bin directory, enter:

cd <CEMF_ROOT>/bin

Step 3 To display a list of all Cisco EMF packages, enter:

./cemf install -show

This will list the version of C12kM.

Step 4 Copy the pkginfo file to the specified location. Proceed as follows:

1. To find the target directory,

a. Find the package installed by issuing the following command,

./cemf install -s | grep C12kM_Manager | grep -v "Package"

Some examples of the output: C12kM_Manager, C12kM_Manager_-_Upgrade etc.

b. The target directory will be /var/adm/Atlantech/avinstall/<Package retrieved using the previous command>

2. To find the name of the pkginfo file,

a. Change current directory to target directory by using cd command.

b. Find the existing pkginfo file by listing the directory using command ls -al.

The packageinfo file could be one of .5.pkginfo or .15.pkginfo.

3. Overwrite the existing package info file with the new file available in the cd using command cp.

a. cp /cdrom/cdrom0/upgrade /<pkginfo filename retrieved in the sub-step (2) of Step 4> /var/adm/Atlantech/avinstall/<target directory>/

Step 5 As a precautionary measure in case there are problems with the subsequent upgrade, backup all databases, and copy these to a non-default location, using the cp command. If the upgrade is successful, this backup will not be required.

./cemf backup

mv /opt/backup /opt/original_backup where original_backup is a user-defined directory for backup


Note It is necessary to have sufficient disk space for the backups.


For backup instructions for the version of Cisco EMF you are upgrading from, refer to the "Cisco EMF Database Backup and Restore" chapter in the Cisco EMF v3.x Installation and Administration Guide.

Step 6 Remove the g.histCriteria file, enter:

rm <CEMF_ROOT>/config/selfManagement/actions/g.histCriteria

Step 7 Uninstall C12kM for upgrade, enter:

./cemf install -remove -o -upgrade

then choose C12kM Manager

Step 8 Backup the databases, enter:

./cemf backup


Caution These are the backups that will be restored later.

For backup instructions for the version of Cisco EMF you are upgrading from, refer to the "Cisco EMF Database Backup and Restore" chapter in the Cisco EMF v3.x Installation and Administration Guide.

Step 9 Copy the upgradePackages files to a temporary location so that they can be restored on to the upgraded system before startup. Enter:

cp -r <CEMF_ROOT>/config/selfManagement/upgradePackages/* /opt/upgradePackages/ where upgradePackages is a user-defined directory.


Caution These files can be copied to any temporary location except /tmp/ (/opt/ is used in the example). Do not use /tmp as the reboot (Step 11) will remove any files in this area.

Step 10 Stop Cisco EMF, enter:

./cemf stop

Step 11 Remove the current Cisco EMF installation and Cisco EMF patches, enter:

./cemf install -remove

then choose the option you require from the menu.


Caution The order in which components are removed is important. Refer to "CEMF Requirements" section for details on the order in which the patches must be removed. It is mandatory that the patches are removed in the reverse order. You must remove the patches first, then Cisco EMF itself.

Step 12 Cisco EMF v3.x and C12kM are now removed, and you must reboot your system.


Note A reboot is necessary to ensure there are no processes remaining which may interfere with successful operation of Cisco EMF v3.2.


Step 13 Cisco EMF v3.2 can now be installed. Insert the C12kM product CD into the CD-ROM device.

Step 14 Change directory into the cdrom area. At the command line prompt, enter:

cd /cdrom/cdrom0

Step 15 Install Cisco EMF v3.2, enter:

./cemfinstall

from the Cisco EMF v3.2 CD-ROM.

Step 16 Install the Cisco EMF patches in the same order as mentioned in "CEMF Requirements" section.

Step 17 Change directory to the Cisco EMF bin directory, enter:

cd <CEMF_ROOT>/bin

Step 18 Start Cisco EMF, enter:

./cemf start

Cisco EMF processes start and Cisco EMF is initialized.

Step 19 Stop Cisco EMF, enter:

./cemf stop

Step 20 Restore the databases backed up in Step8, enter:

./cemf restore -t <date of backup> -u

Refer to Chapter 10, "Cisco EMF Database Backup and Restore" for complete details. The <date of backup> value is the date the backups were created. The date must always be specified in US format, that is mm-dd-yyyy.


Note The -u flag implements the correct required behavior by preventing the configuration files from the backup being copied across to the new installation.



Note You may see the message Backup system catalog file is missing. You can ignore the message and choose y.


Step 21 Remove the following databases, enter:

rm <CEMF_ROOT>/db/attributeHistoryCollector.db

rm <CEMF_ROOT>/db/attributeHistoryServer.db

rm <CEMF_ROOT>/db/partitioning.db


Note This is necessary as it is not possible to guarantee the integrity of any existing performance data.


Step 22 Restore the files copied in Step 9, enter:

cp /opt/upgradePackages/* <CEMF_ROOT>/config/selfManagement/upgradePackages/

Step 23 Start Cisco EMF v3.2, enter:

./cemf startupgrade

Step 24 To install the C12kM version 2.2 from the CDROM, enter:

./cemfinstall

Step 25 Choose the option C12kM Manager - Upgrade from 2.1.x

Step 26 The backups created at Step 8 should only be removed after the upgraded Cisco EMF and Element Manager installation has been fully tested and verified.


Note After the upgrade is completed, a message is displayed confirming that the C12kM installation is complete. It is recommended to do a cemf start and stop after the C12kM software is installed.