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
An installation script is provided with the Cisco EMF platform to install and deinstall Element Managers. Refer to cemf install Command for more information. Cisco EMF should already be installed and running on the system, before installing or deinstalling Element Managers.
This chapter contains the following information:
•
Installing an Element Manager
•Deinstalling an Element Manager
•Problems During Element Manager Installation or Deinstallation
Note 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 before installing an Element Manager. Refer to "Cisco EMF Database Backup and Restore".
Tip You must ensure that a backup of the system is taken after an Element Manager (EM) is deinstalled and before Cisco EMF is stopped. If a backup is restored which contains databases from an EM which has been deinstalled, you will not be able to install an element manager of that type again, as Cisco EMF assumes that the EM is present along with its related databases.
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, enter:
cd /cdrom/cdrom0
Step 4 Run the install script, enter:
./cemfinstall
Note Some Element Managers use a different install script, check your Element Manager Installation Guide.
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 exit 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 Element Manager databases as the cemf remove command removes dynamically created files (for example, log files and databases). Refer to "Cisco EMF Database Backup and Restore".
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, enter:
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, enter:
./cemf show
Step 4 Run the deinstall script, use ./cemf remove or ./cemf install -r. From the displayed list, select the Element Manager package you want deinstalled, then press Enter.
To exit the deinstallation process, type q, then press Enter.
Note If Cisco EMF is not running, the ERROR: CEMF is not running is displayed. Start Cisco EMF, then run the deinstall script again.
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, enter:
more <LOGSDIR>/avload.log
and
more /var/adm/Atlantech/avinstall/<MENU OPTION>/logfile
Note <LOGSDIR> is the directory chosen at install time. During installation you can choose to place the log files into a non-standard location, the default location is <CEMF_ROOT>/logs.
Step 2 If deinstallation failed due to the Element Manager not running, and the EM cannot be started, enter:
./cemf remove skipportcheck
Note This will not remove objects managed by the EM.
Step 3 If this fails, the Element Manager must be removed by force, enter:
./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. Enter
./cemf reset
