Upgrading the WEM Software


Upgrading the WEM Software
 
 
 
The information and instructions in this chapter should be used to upgrade a WEM installation. These instructions assume that you have already obtained the upgrade file(s) and have stored them on the server running the WEM application.
Two upgrade types are currently supported:
Automated: Once executed, the WEM installation file detects previously installed versions of the application. If an older version is present, you are prompted as to whether or not you would like to perform an upgrade.
Because this process preserves all application database information from the currently installed version, it is only supported for n-2 releases, where n is the new version being installed. For example, the automated process can be used to upgrade either the 4.5.x or 5.0.x releases to version 5.1.x.
Manual: This type involves uninstalling any existing instances of the application and installing the new version.
This type must be used if the current instance is more than two releases older than the new version being installed. For example, the manual upgrade type must be used if 3.5.x is currently installed and you would like to upgrade to 5.1.x.
Caution: Please contact your local support representative to ensure compatibility prior to upgrading.
Important: The WEM application does not provide an automated mechanism for performing software “downgrades” (reverting to an older software version from a newer one). However, the instructions provided in the Performing a Manual Upgrade section of this chapter can be used since that procedure requires you to uninstall the existing version and install the alternate. Information is also provided for migrating database information.
This chapter includes the following topics:
 
Unpacking the Installation Files
 
WEM installation files are distributed as a single compressed file with a “.tar.gz” extension.
Once the installation file has been copied to the server, use the following procedure to unpack the file.
Step 1
Step 2
 
gunzip file_name.tar.gz
file_name is the name of the WEM application installation file.
Step 3
 
tar -xvf file_name.tar
Decompressing the installation file results in the following files:
setup.bin: The installation binary file.
inst: The executable file used to initiate the installation. This file is used for both the console- and the GUI-based methods.
uninst: Once the WEM application has been installed, this file must be copied to the /ems/_uninst/ directory. It is the executable file for uninstalling the application for both the console- and GUI-based methods.
file_name.tar: A compressed file containing all of the application files required for both the script- and GUI-based installation methods.
README: A text file containing information pertaining to the release.
Step 4
 
Performing an Automated Upgrade
 
This section provides information and instructions for performing an automated upgrade as described previously in this chapter.
 
Determining the Best Upgrade Method
The WEM, and its ancillary components such as the Apache web server and PostgreSQL database engine, may be installed using one of following methods.
 
GUI-based method: This method is the most often used installation 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 upgrade 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 perform the upgrade.
Depending on the desired installation method, proceed to either the Upgrading the WEM Software using the Console-Based Installation Method or Upgrading the WEM Software using the GUI-Based Installation Wizard section of this chapter.
 
Upgrading the WEM Software using the GUI-Based Installation Wizard
Follow the instructions below to upgrade the WEM using the GUI-based wizard.
Step 1
Step 2
 
./inst
The following WEM Installer dialog appears:
Step 3
Step 4
Step 5
Follow the on-screen prompts to progress through the various installation dialogs and configure the parameters as required. Refer to the WEM Installation Parameter Descriptions table for descriptions of the configurable parameters on each of the installation dialogs.
Once you have completed the upgrade and all processes have started, the following dialog appears reporting that the installation was successful.
Step 6
Click the Finish button to exit the GUI-based installation wizard.
Step 7
 
Starting EMS Server...EMS Server started.PID: 1370Logfile generated as:./log/SERVER_LOG_20051220_142931/SERVER_LOGPlease check file /<ems_dir>/server/log/.server.log for additional debug messagesStarting Script Server...Script Server started.PID: 1389Logfile generated as:./log/SCRIPT_LOG_20051220_142937/SCRIPT_LOG
The following table lists the processes that are started at installation:
Important: The NorthBound Server and Notification Service processes are customer-specific and are not operational without the appropriate license. Please contact your local sales representative for additional information.
All log files are stored in the /<ems_dir>/server/log directory by default. Refer to log files for additional information in the event that one or more of the processes did not start properly.
Step 8
 
cp uninst /<ems_dir>/_uninst/
Step 9
 
cp migrate.tar.gz /<ems_dir>/server/scripts/migrate.tar.gzcp README_MIGRATE /<ems_dir>/server/scripts/README_MIGRATE
 
Upgrading the WEM Software using the Console-Based Installation Method
Follow the instructions below to upgrade the WEM using the console-based installation script.
Step 1
Step 2
 
./inst -console
A message appears welcoming you to the WEM installation.
Step 3
Enter “1” to proceed to the EMS Upgrade Check configuration prompts. The system automatically checks for installed version of the application. If a version is installed, a message appears asking if you would like to upgrade the current installation.
Step 4
Step 5
Follow the on-screen prompts to proceed through the upgrade and configure the various parameters as required. Refer to the WEM Installation Parameter Descriptions table for descriptions of the configurable parameters within each of the sections of the script.
Once you have completed the upgrade and all processes have started, you receive a message indicating that the WEM was successfully installed.
Step 6
Step 7
 
Starting EMS Server...EMS Server started.PID: 1370Logfile generated as:./log/SERVER_LOG_20051220_142931/SERVER_LOGPlease check file /<ems_dir>/server/log/.server.log for additional debug messagesStarting Script Server...Script Server started.PID: 1389Logfile generated as:./log/SCRIPT_LOG_20051220_142937/SCRIPT_LOG
The following table lists the processes that are started at installation:
Important: The NorthBound Server and Notification Service processes are customer-specific and are not operational without the appropriate license. Please contact your local sales representative for additional information.
All log files are stored in the /users/ems/server/log directory by default. Refer to log files for additional information in the event that one or more of the processes did not start properly.
Step 8
Copy the un-installation script to the _uninst directory created during the installation process (/<ems_dir>/_uninst by default) by entering the following command:
 
cp uninst /<ems_dir>/_uninst/
Step 9
 
cp migrate.tar.gz /<ems_dir>/server/scripts/migrate.tar.gzcp README_MIGRATE /<ems_dir>/server/scripts/README_MIGRATE
 
Performing a Manual Upgrade
 
Follow the instructions in this section to perform a manual upgrade as described previously in this chapter. These instructions assume that a version of the application is currently installed and that it was installed in the default directory, /users/ems.
Important: The instructions in this section can also be used to perform a software downgrade of the WEM if required.
Step 1
Step 2
Optional. If you wish to preserve database information for the currently installed version, follow the instructions in the Performing a Database Back-Up using the backup Script section of this chapter and then proceed to Step - i1682807 of this procedure.
Step 3
Uninstall the WEM using the instructions provided in Uninstalling The WEM chapter of this guide and proceed to Step - i1682815 of this procedure.
Step 4
Install the desired version of the WEM using the instructions provided in Installing the WEM Software chapter of this guide and proceed to Step - i1682826 of this procedure.
Step 5
Optional. If database information was backed-up per Step - i1682799 of this procedure, restore the data using the instructions in the Performing a Database Restoration using the backup Script section of this chapter and proceed to <X-Refs (online)>step <$paranum> 6 of this procedure.
Step 6
Start WEM Server processes using the instructions in the Step 3: Start WEM Server Application section of WEM Server Files and Operation chapter of this guide.
 
 
Reconfiguration of Bulkstat Schemas
Once the WEM software upgrade is completed successfully, you are required to configure the schemas. This process involves two steps:
 
Deletion of Already Configured Schema
For deleting the already configured schemas, follow the instructions below:
Step 1
Step 2
In the main menu, go to Accounting > Bulk Statistics Configuration. Bulk Statistics dialog box opens.
Step 3
Click the Configure button to invoke the Bulk Statistics Configuration dialog box.
Step 4
Step 5
After selecting all the configured schemas, click the Delete icon. Warning message display.
Step 6
Click Yes to delete the selected schemas and click the Apply button. Another warning message displays.
Step 7
Click No to ignore the warning. Finally successful configuration message displays.
Step 8
 
Reconfiguration of Schemas
For reconfiguration of schemas, follow the instruction below:
Step 1
Step 2
In the main menu, go to Accounting > Bulk Statistics Configuration. Bulk Statistics dialog box opens.
Step 3
Click the Configure button to invoke the Bulk Statistics Configuration dialog box.
Step 4
Select the schemas to be configured under the Schema tab and click the Add icon.
Step 5
Click the Apply button to configure the selected schemas. You may get a warning message “You have selected some obsolete and/or WEM unsupported counters. Unsupported counters will not be parsed by WEM. Do you want to continue?”
Step 6
Click Yes to converge the warning. Successful configuration message displays.
Step 7
Click OK to finish configuring schemas.
 
Preserving Database Information
Database preservation is done using the backup.sh script located in the /<ems_dir>/server/scripts directory by default. This script is used to perform both database back-ups and restorations.
 
Information and instructions for using this script are provided in this section.
 
Performing a Database Back-Up using the backup Script
Follow the instructions in this section to back-up database information prior to upgrading or downgrading WEM software.
Important: The instructions provided in this section are intended for use with those located in the Performing a Manual Upgrade section of this chapter.
Step 1
 
cd /<ems_dir>/server/scripts
Step 2
 
./backup.sh
This script automatically stops all WEM processes and takes the backup of the WEM database using command.
You are notified once the back-up is complete.
Step 3
Return to Step - i1682807 of the procedure in the section of this chapter.
 
Performing a Database Restoration using the backup Script
Follow the instructions in this section to restore database information after performing a WEM software upgrade or downgrade.
Important: The instructions provided in this section are intended for use with those located in the Performing a Manual Upgrade section of this chapter.
Step 1
 
cd /<ems_dir>/server/scripts
Step 2
 
./backup.sh restore
This script automatically stops all WEM processes and performs the database restoration.
You are notified once the database restoration is complete.
Step 3
Return to Step - i1682826 of the procedure in the Performing a Manual Upgrade section of this chapter.
 

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