=================================================================
Installing IBM® WebSphere® Business Integration (BI) Monitor™ v4.2.4 Fix Pack3
=================================================================

© Copyright International Business Machines Corporation. 2002, 2004. All rights reserved. 

This file contains the required information about installing the IBM WebSphere BI Monitor v4.2.4 Fix Pack3. This Fix Pack requires a previous installation of IBM BI Monitor v4.2.4.

The BI Monitor v4.2.4 Fix Pack3 installation must be performed in the following sequence:

  1. Make sure that a previous installation of the BI Monitor 4.2.4 already exists, and has not been uninstalled.  Otherwise, the installation of this fix pack will not be performed.  For more information about installing the pre-requisite release of BI Monitor, please refer to the install.html file that is shipped with that release.

  2. It is strongly recommended that you make a copy of the following file, which has values in your previous deployment of BI Monitor v4.2.4, as you may need it:

    • <WorkingDir>/install/InstallParam.tcl

  3. Un-deploy the existing version of BI Monitor Server completely from the WebSphere Application Server. On Windows, AIX® and Solaris platform, you can perform the un-deployment either automatically or manually. On z/OS™ and OS/390® platforms you can only perform the un-deployment manually.

Refer to the section entitled BI Monitor Server Un-Deployment in Part 2 - Chapter 2: BI Monitor Installation of the BI Monitor v4.2.4 (Fix Pack3) Deployment Guide for the detailed steps of automatic un-deployment of BI Monitor Server. Refer also to the section with the same title in Appendix A and Appendix B in Part 2 of the same guide for the detailed steps of the manual un-deployment of BI Monitor Server. Refer to Chapter 5: IBM BI Monitor Deployment on OS/390 and z/OS Platforms in Part 3 of the same guide for the un-deployment steps on OS/390 and z/OS Platforms .
  1. Backup your existing Monitor database.

  1. Perform the Database Migration and Upgrade after completely un-deploying the existing deployed version of the Monitor Server to upgrade the existing database and its data to this version. The existing database must be of the previous version of the BI Monitor (v4.2.4 Fix Pack2). if the existing database belong to an earlier version before the stated version, then the upgrade must be done incrementally step by step from each version to its next version.

    To perform the database upgrade, run the appropriate SQL file that exists in the migration\SQL folder as the following:

    • For IBM DB2® database on Windows, AIX, and Solaris platforms run the file named DB2.sql.
    • For IBM DB2 database on OS/390 and z/OS platforms run the file named DB2OS390.sql
    • For Oracle database on Windows, AIX, and Solaris platforms run the file named ORACLE.sql.

    Before running these files, you should edit them in order to change the variable named $SCHEMA$ with the actual name of the tables schema in each occurrence in the files.

  2. Make sure that the IBM jdk 1.3.0 is installed on your machine. Alternatively, you can use the IBM JDK that is shipped with IBM WebSphere Application Server.

  3. Install the BI Monitor 4.2.4 Fix Pack3 and Deploy the BI Monitor Server that belongs to this fix pack after completing the upgrade and migration of the database. The BI Monitor 4.2.4 Fix Pack3 Installation Wizard starts by running the jar file named WBIMonitor424-FixPack3.jar from the location where you have extracted the contents of the zip file that you downloaded from the Internet. You must install the Fix Pack file WBIMonitor424-FixPack3.jar on the same installation (Home) directory where the previous version has been installed. To start the BI Monitor 4.2.4 Fix Pack3 Installation Wizard, run the WBIMonitor424-FixPack3.jar file by performing the following steps:

        On Windows platform:

  1. Start a command prompt window.

  2. Make sure that the full path of the java.exe is included in the Path environment variable. Otherwise, you should change the directory to the location where the java.exe exists. For example, if you are using the IBM JDK that is shipped with IBM WebSphere Application Server, type the following, and then press Enter:

    CD C:\WebSphere\AppServer\java\bin\

Where C:\WebSphere\AppServer\ is the IBM WebSphere Application Server's installation path.

  1. Type the following in the command prompt, and then press Enter:

        java.exe -jar C:\temp\WBIMonitor424-FixPack3.jar

    Where C:\temp is the location where the WBIMonitor424-FixPack3.jar file exists.

On AIX and Solaris platforms:

  1. Start a terminal console as root.

  2. Make sure that the full path of the java is included in the PATH environment variable. Otherwise, you should change the directory to the location where the java exists. For example, if you are using the IBM JDK that is shipped with IBM WebSphere Application Server, type the following, and then press Enter:

    • On AIX platform, type:

                cd /usr/WebSphere/AppServer/java/bin/

            Where /usr/WebSphere/AppServer/ is the IBM WebSphere Application Server's installation path.

     

    • On Solaris platform, type:

                cd /opt/WebSphere/AppServer/java/bin/

            Where /opt/WebSphere/AppServer/ is the IBM WebSphere Application Server's installation path.

     

  3. Type the following in the command prompt, and then press Enter:

java -jar /tmp/WBIMonitor424-FixPack3.jar

Where /tmp is the location where the WBIMonitor424-FixPack3.jar file exists.

Refer to the section entitled BI Monitor Server Installation and deployment in Part 2 - Chapter 2: BI Monitor Installation of the BI Monitor v4.2.4 (Fix Pack3) Deployment Guide for the detailed steps of automatic deployment of BI Monitor Server. Refer also to Appendix A and Appendix B in Part 2 of the same guide for the detailed steps of the manual deployment of BI Monitor Server. Refer to the section entitled IBM BI Monitor Deployment on OS/390 and z/OS Platforms in Part 3 of the same guide for the deployment steps.