IBM Support

Upgrade of embedded WebSphere Application Server fix pack installation procedure for IBM Tivoli Storage Productivity Center for Replication V4.2.2.4 and above

Question & Answer


Question

How do we install a fix pack for the embedded WebSphere Application Server provided by IBM Tivoli Storage Productivity Center for Replication V4.2.2.4 and above?

Cause

IBM Tivoli Storage Productivity Center for Replication (TPC-R) runs on embedded WebSphere Application Server (eWAS). For maintenance purposes or security vulnerabilities, it may be necessary to install a fix pack for eWAS.

You can use this procedure to install fix packs for a given eWAS minor version, but not to upgrade to a new full eWAS version. For example, you can use it to install eWAS 6.1.0.45 on top of eWAS 6.1.0.29, but you cannot use it to install eWAS version 7.0 on top of eWAS version 6.1.

The following table shows the different levels of eWAS that are provided by TPC-R 4.2.2.x:

TPC-R version
eWAS version
4.2.2.1 through 4.2.2.3
6.1.0.29
4.2.2.4 and up
6.1.0.47

This technote applies specifically to eWAS, not the full version of WebSphere. Further, this technote applies only to upgrades to V4.2.2.4 of TPC-R. New installations of V4.2.2.4 will automatically apply eWAS 6.1.0.45.

Answer

Follow these steps to install a new eWAS fix pack into your TPC-R environment:

Step 1. Back up your TPC-R environment

    • Back up your TPC-R database using the mkbackup CLI command
      A user can also zip up all the subdirectories and files where the Derby database resides and restore it later:
      • Stop TPC-R server so all data is flushed to the DB tables
      • Zip up all sub-directories and files under ..\IBM\replication\eWAS\profiles\CSM\database\csmdb
    • Export all session copysets
Step 2. Identify the eWAS install location. (eWAS_install_location)
Here is the default install location of eWAS if TPC-R, provided InstallShield GUI was used during product installation.

AIX: /opt/IBM/replication/eWAS
Linux: /opt/IBM/replication/eWAS
Windows: C:\Program files\IBM\replication\eWAS

Step 3. Find the eWAS version that is in use and determine the need for fix pack installation:


For AIX and Linux, open a login shell:
    cd <eWAS_install_location>/bin
    ./versionInfo.sh

For Windows, open a command prompt:
    cd <eWAS_install_location>\bin
    versionInfo.bat


Step 4. Download the eWAS fix pack files

    Step 4a: Find your TPC-R platform name in this table to determine the corresponding eWAS platform name:
      DescriptioneWAS PlatformeWAS Description
      AIX R5.3 (32 bit)
      AIX R6.1 (32 bit)      		AixPPC32AIX/PowerPC-32
      AIX R5.3 (64 bit)
      AIX R6.1 (64 bit)      		AixPPC64AIX/PowerPC-64
      Linux Intel R2.6 (32 bit)LinuxX32Linux/Intel-32
      WindowsWinX32Windows/Intel-32

      Note: For some 64 bit platforms, TPC-R uses the 32 bit version of eWAS.

    Step 4b: Create a temporary directory to hold the fix packs.
    • Unix: Create a directory in /tmp or equivalent.
    • Windows: Create a directory in C:\TEMP or equivalent.

    Step 4c: Download the eWAS fix pack files to the temporary directory you created in Step 4b. Each eWAS fix pack is comprised of two files:
      • 6.1.0-WS-WASEmbeded-platform-FP00000nn.pak contains eWAS itself.
      • 6.1.0-WS-WASSDK-platform-FP00000nn.pak contains the Java SDK that is used by eWAS. This Java SDK is separate and distinct from the one used directly by TPC-R.
    For both files, platform is the eWAS platform name and nn is the eWAS fix pack level. You must download both files for your platform. Refer the following page to download the eWAS fix pack files:
Step 5. Download and Install the IBM Update Installer for WebSphere
    The IBM Update Installer for WebSphere software is required for applying eWAS update packages. Download and install it from the above link.
    Choose your platform tab from the list and follow the instructions provided to install the IBM Update Installer for WebSphere in your environment. You must install the most current version of the update installer.

    Installation Instructions:
  • Ensure that you have stopped eWAS and related processes. The product to be updated must not be running while you apply maintenance.
  • Download the most recent Update Installer package that matches your platform from the Download package section of this page.
  • Extract the downloaded Update Installer package (zip or tar file) to a temporary directory.
  • Navigate to the "UpdateInstaller" subdirectory created from previous step.
  • Use the installation wizard to install the Update Installer by running the install or install.exe executable.
  • On Windows systems, run the command install.exe by double-clicking on the icon, or running it directly from a command prompt.
  • On UNIX-based systems, run the command ./install to launch the Wizard interface.


Step 6. Stop the TPC-R Server

    Use your local procedures to stop TPC-R.


Step 7. Apply the eWAS and Java SDK fix packs Step 8. Start the TPC-R Server

Use your local procedures to start TPC-R.

Step 9. Cleanup


    Step 9a: Remove the temporary directory and fix pack files that you downloaded in step 4.

    Step 9b: If you want to remove the IBM Update Installer for WebSphere refer to its uninstall documentation:


    After running the uninstall process, remove the directory where you installed the IBM Update Installer for WebSphere.


Known Issues / Workarounds

None

[{"Product":{"code":"SSMN28","label":"Tivoli Storage Productivity Center for Replication"},"Business Unit":{"code":"BU054","label":"Systems w\/TPS"},"Component":"TPC for Replication","Platform":[{"code":"PF002","label":"AIX"},{"code":"PF016","label":"Linux"},{"code":"PF033","label":"Windows"}],"Version":"4.2.2","Edition":"All Editions","Line of Business":{"code":"LOB26","label":"Storage"}}]

Document Information

Modified date:
17 June 2018

UID

swg21642237

Page Feedback