Uninstalling The WEM


Uninstalling The WEM
 
 
 
This chapter provides the step-by-step procedure of uninstalling WEM application using the GUI-based installation wizard and the console-based installation. Additionally it provides instuctions for backing up all the critical files before starting the WEM uninstallation.
This chapter includes the following topics:
 
Understanding the Uninstall Process
Upgrading the Web Element software on the server requires that the currently installed version be uninstalled from the server before the newer version can be installed.
 
Failure to do so will prevent your ability to install the new WEM version. Following is an overview of this process.
 
<X-Refs (online)>step <$paranum> 1 - Make Backup Copies of All Critical Files
This step requires that you archive, at a minimum, the following files.
 
All data files, typically located in the /<ems_dir>/server/data directory and all subdirectories residing there (i.e. /bulkstats, etc.).
PostgreSQL data files, located in the ~postgres/data or users/postgresx.x.x/data directory. Refer to the Backing-up WEM Databases section of the WEM Database Maintenance chapter in this guide for more information.
Important: Downgrading the WEM application to an earlier version is not supported at this time. You must uninstall the current version and install the older version using the instructions located in Installing the WEM Software chapter of this guide. Please contact your local sales representative for information on preserving data stored by the current WEM instance prior to uninstalling.
 
<X-Refs (online)>step <$paranum> 2 - Uninstall WEM Application
The process used to perform this uninstall is dependent upon the method used to install the version currently running. See the section below for information on how to determine which installation method was used previously.
Whichever uninstall method is used, it is always preferable to install the new version of the application using the GUI-based installation method.
 
Determining the Best Uninstallation Method
The WEM, and its ancillary components such as the Apache web server and PostgreSQL database engine, may be uninstalled using one of two methods.
 
GUI-based method: This method is the most often used uninstallation procedure. Requirements for using this method include:
Console-based method: This method is available to users who do not have an X-Windows client available for remote network connectivity to the WEM server via Telnet or SSH.
It is important to note that the uninstallation method is independent of the method used for installation. For example, if the console-based method was used for installation, either the GUI- or console-based method can be used to uninstall the program.
 
Using the GUI-based Uninstall Method
 
This section provides instructions for uninstalling the WEM application using the GUI-method.
Important: The GUI-based uninstall script is designed to protect all the historical data files that are currently in use. However, it is still recommended that you manually perform a backup of these files before proceeding with this procedure.
Step 1
Step 2
 
cd /<ems_dir>
Step 3
 
cd _uninst
Step 4
 
./uninst
A dialog box appears welcoming you to the WEM uninstallation wizard.
Step 5
Step 6
Step 7
The uninstall script leaves the /ems directory in place with several sub-directories.
Step 8
Optional: If all critical and historical data files have been properly backed up, delete the /ems directory using the following commands:
 
cd ..
cd ..
rm -R ems
Important: If it is decided to keep the /ems directory, it is highly recommended that at the very least you delete the _uninst directory. Failure to remove this directory before installing a new version of the WEM application using the GUI-based installation method will result in a different _uninst directory being created each time you perform a software upgrade. This results in the creation of multiple uninstall directories (i.e. named /_uninst2, /_uninst3, etc.). The uninst file needed for the next uninstall would have to be located there.
 
Using the Console-based Uninstall Method
 
This section provides instructions for uninstalling the WEM application using the console-based method.
Important: The console-based uninstall script is designed to protect all the historical data files that are currently in use. However, it is still recommended that you manually perform a backup of these files before proceeding with this procedure.
Step 1
Step 2
 
cd /<ems_dir>
Step 3
Go to the /_uninst sub-directory by entering the following command:
 
cd _uninst
Step 4
 
./uninst -console
A message appears welcoming you to the WEM uninstallation wizard.
Step 5
Step 6
Step 7
Upon completion, the uninstall script indicates that certain sub-directories were not deleted within the /ems directory.
Step 8
Optional: If all critical and historical data files have been properly backed up, delete the /ems directory using the following commands:
 
cd ..
cd ..
rm -R ems
Important: If it is decided to keep the /ems directory, it is highly recommended that at the very least you delete the _uninst directory. Failure to remove this directory before installing a new version of the WEM application using the GUI-based installation method will result in a different _uninst directory being created each time you perform a software upgrade. This results in the creation of multiple uninstall directories (i.e. named /_uninst2, /_uninst3, etc.). The uninst file needed for the next uninstall would have to be located there.
 

Cisco Systems Inc.
Tel: 408-526-4000
Fax: 408-527-0883