==============================================================================
IBM® WebSphere® Business Integration (WBI) Monitor™ 4.2.4 - Installation Guidelines
==============================================================================

This document contains the IBM WBI Monitor 4.2.4 installation, un-installation and migration information. You should also obtain the detailed steps for  installing the WBI Monitor and all of its components on your machine and deploy the Monitor Server from the WBI Monitor Deployment Guide that is located on the root of the product CD or from the location where you have extracted the contents of the zip file that you downloaded from the Internet. You can also access the product documentation from the "Docs" folder under the destination folder you selected for installation.

1 Installing IBM WBI Monitor 4.2.4

The contents of this section describe how to run the IBM WBI Monitor Installation Wizard in order to install the WBI Monitor v4.2.4 onto your machine.

For z/OS installation, use the WBI Monitor Installation Wizard to install the WBI Monitor on a Windows platform using the Manual Deployment option, and use the Deployment Guide for instructions on how to deploy onto z/OS.

The WBI Monitor Installation Wizard starts by running the jar file named WBIMonitor424.jar from the product CD or from the location where you have extracted the contents of the zip file that you downloaded from the Internet.

Before starting the WBI Monitor Installation Wizard, you have to make sure that an environment variable named WAS_HOME is defined and contains the actual path of the IBM WebSphere Application Server installation directory. If this variable is not defined, then you must define it as the following:

1. On Windows platform:

• Open a command line window.

• Type the following:  

WAS_HOME = <WebSphere>

Set WAS_HOME

• Run the WBIMonitor424.jar from this command line window.

2. On AIX® and Solaris platforms:

• Open a Terminal Console using root.

• Type the following in the command line:

WAS_HOME= <WebSphere>

export WAS_HOME

• Run the WBIMonitor424.jar from this terminal console.

If you are using IBM DB2 as the database server on AIX and Solaris platforms only, make sure that you run the Installation wizard with a user who is in the DB2 Administrators group. You should also run at least once the <DB2>/db2profile file from the same terminal console from which you will start the wizard. In order to run the db2profile command:

• Open a terminal console.

• Change the directory to <DB2>.

• Type the following in the command line and then press Enter:  

../db2profile

• Run the WBIMonitor424.jar file from the same terminal console.

You have to make sure also 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.

To start the WBI Monitor Installation Wizard, run the WBIMonitor424.jar file by doing the following:

1. On Windows platform:

• Start a command prompt window.

• Type the following in the command prompt and then press Enter:

java.exe -jar G:\WBIMonitor424.jar

Where G: is your CD drive name. Replace this name with the actual name of your CD drive or with the location where the WBIMonitor424.jar file exists.

If the java.exe is not included in the Path environment variable path then type the full path of java.exe (e.g.  C:\WebSphere\AppServer\java\bin\java.exe)

2. On AIX and Solaris platforms:

• Start a terminal console as root.

• Type the following in the command prompt and then press Enter:

java -jar /tmp/WBIMonitor424.jar

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

If the java is not included in the PATH environment variable then type the full path of java (e.g. "/usr/WebSphere/AppServer/java/bin/java" in AIX platform or "/opt/WebSphere/AppServer/java/bin/java" in Solaris platform)

###############################################################################

2 Un-Installing IBM WBI Monitor 4.2.4

This section describes how to completely uninstall the WBI Monitor from your machine using the WBI Monitor Un-installation  Wizard in order to remove all folders and files that was installed by the WBI Monitor installation wizard. The WBI Monitor Un-installation  Wizard starts by running the jar file named uninstall.jar that is located in the <Monitor>\_uninst folder.

Before starting the WBI Monitor Un-installation  Wizard, make sure that the IBM jdk 1.3.0 is installed on your machine. Alternatively, you can use the IBM JDK shipped with IBM WebSphere Application Server.

To start the WBI Monitor Un-installation  Wizard:

1. Run the uninstall.jar file by doing the following:

• On Windows platform:

• Start a command prompt window.

• Type the following in the command prompt and then press Enter:

java.exe -jar <Monitor>\_uninst\uninstall.jar

If the java.exe is not your environment variable path then type the full path of java.exe (e.g.  C:\WebSphere\AppServer\java\bin\java.exe)

• On AIX and Solaris platforms:

• Start a terminal console using root.

• Type the following in the command prompt and then press Enter:

java -jar <Monitor>/_uninst/uninstall.jar

If the java.exe is not your environment variable path then type the full path of java.exe (e.g. "/usr/WebSphere/AppServer/java/bin/java" in AIX platform or "/opt/WebSphere/AppServer/java/bin/java" in Solaris platform

2. Once you start the Un-installation  wizard, a Welcome dialog box appears. Click Next to continue through the wizard or click Cancel to exit the wizard.

3. The next screen contains the Home Directory on which the WBI Monitor was installed and the installed components. Click Next to start removing these installed components and remove the files and folders from your hard drive, Back to return to the previous step, or Cancel to exit the wizard.

4. After all files and folders are removed from your hard drive, the next screen will tell you that the Un-installation  Wizard has finished uninstalling the WBI Monitor from your system. Click Finish to exit the wizard.

Where <Monitor> is the WBI Monitor installation directory. (For example: C:\WBIMonitor424)

###############################################################################

3- Upgrading your Existing Version of WBI Monitor to the Recent Version

This section contains the required information about upgrading your existing version of WBI Monitor to the recent version. This includes upgrading the deployed version of WBI Monitor application on WebSphere Application Server, as well as upgrading the existing Monitor database that already contains data stored in its tables to adhere to the latest modification in the current version of WBI Monitor 4.2.4 database, and migrate the stored data to the upgraded database.

It is strongly recommended that you backup your existing database before you perform the migration steps.

The WBI Monitor upgrade must be performed in the following sequence:

1. Un-deploy the existing version of WBI Monitor Server completely from the WebSphere Application Server. You can perform the un-deployment either automatically or manually. Please refer to the WBI Monitor Deployment Guide for the detailed steps of automatic and manual un-deployment of WBI Monitor Server.

2. Perform the Database Migration and Upgrade after completely un-deploying the existing deployed version of the Monitor Server. Please refer to the section entitled Upgrading your Existing Version of WBI Monitor to the Recent Version in the WBI Monitor Deployment Guide for details about the Database Migration.
   .

3. Deploy the WBI Monitor Server that belongs to the new version of WBI Monitor after completing the upgrade and migration of the database. Please refer to the WBI Monitor Deployment Guide for the detailed steps of automatic and manual deployment of WBI Monitor Server.