Cisco Element Manager System Installation and Configuration Guide, 3.1
Installing and Deinstalling Element Managers

Table Of Contents

Installing and Deinstalling Element Managers

Installing an Element Manager

Deinstalling an Element Manager

Problems During Element Manager Installation or Deinstallation


Installing and Deinstalling Element Managers


The following steps assume Cisco EMF has already been installed and that Cisco EMF is already running.

An installation script is provided with the Cisco EMF platform to install and deinstall Element Managers. Refer to cemf Command for more information.

You can obtain help for Cisco EMF by typing <CEMF_ROOT>/bin/cemf help, where <CEMF_ROOT> is the directory where Cisco EMF is installed.

Installing an Element Manager


Note Ensure that you have backed up all databases prior to installing an Element Manager. Refer to Chapter 11, "Cisco EMF Database Backup and Restore Procedures".



Note If you have Cisco EMF installed and running on a Server and a remote Client, the Element Manager must be installed on the Server before it is installed on the Client.


To install an Element Manager, proceed as follows:


Step 1 As superuser (su), login to the machine where Cisco EMF is installed.

Step 2 Insert the Element Manager product CD.

Step 3 Change directory into the cdrom area. At the command line prompt, type:

cd /cdrom/cdrom0

Step 4 Run the install script ./cemfinstall


Note If you have not logged in as the superuser, the ERROR: You must be root to run this Script error message is displayed. Login as superuser (su), then run the install script again.


Step 5 A menu listing installation options is displayed. Select the Element Manager installation you require, then press Enter.

To quit the installation process, type Q, then press Enter.


Note If other applications are packaged on the Element Manager CD, you are presented with additional options. If a package is already installed, **Already Installed** is displayed beside the option and the option to install that package is removed.



Note If Cisco EMF is not running, the ERROR: CEMF is not running is displayed. Start Cisco EMF, then run the install script again.


Step 6 The script starts installing the Element Manager. You are asked if you are sure you want to install the package. Press Enter to accept and continue to install the Element Manager package.


Note If you made a mistake with the package name, type n, then press Enter. The installation process stops and you can restart it at a later time.


Step 7 Information is displayed detailing the progress of the installation. Once the installation has finished you are informed that the installation was successful.


Deinstalling an Element Manager

This procedure deinstalls an Element Manager completely, if you are deinstalling an Element Manager for upgrade, refer to "Upgrading Cisco EMF".


Note Ensure that you have backed up all databases as the cemf remove command removes dynamically created files (for example, log files and databases). Refer to Chapter 11, "Cisco EMF Database Backup and Restore Procedures".


To start the deinstallation of an Element Manager, proceed as follows:


Step 1 As superuser (su), login to the machine where Cisco EMF is installed.

Step 2 Change the directory to the <CEMF_ROOT>/bin directory. From the command line prompt, type:

cd <CEMF_ROOT>/bin

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

Step 3 Display a list of all of the Cisco EMF packages including the Element Manager packages, type:

./cemf show

Step 4 Run the deinstall script ./cemf remove. From the displayed list, select the Element Manager package you want deinstalled, then press Enter.

To quit the deinstallation process, type Q, then press Enter.


Note Cisco EMF must be running to execute this script.


Step 5 You are asked if you are sure you want to remove the package. Press Enter to confirm and to continue to deinstall the package. The script starts deinstalling the selected Element Manager.


Note If you made a mistake with the package name, type n, then press Enter. The deinstallation process stops and you can restart it at a later time.


Information is displayed detailing the progress of the deinstallation. Once the deinstallation is finished, you are informed that the deinstallation was successful.


Note If you have thresholding regimes specific to the Element Manager which has been deinstalled, it is recommended that you manually delete them.



Problems During Element Manager Installation or Deinstallation

If you encounter problems during installation or deinstallation of an Element Manager, you should check the log files.


Caution These commands should only be used with support from Cisco.


Step 1 To view the log files, type more <CEMF_ROOT>/logs/avload.log and more /var/adm/Atlantech/cemfinstall/<MENU OPTION>/logfile

Step 2 If deinstallation failed due to the controller not running, and the controller cannot be started, type
./cemf remove skipportcheck


Note This will not remove objects managed by the controller.


Step 3 If this fails, the Element Manager must be removed by force, type ./cemf remove skipallchecks


Caution This will leave the system in an unstable state until the Element Manager is removed and re-installed, and Cisco EMF is reset. Type ./cemf reset