Fix Pack Notes for
WebSphere Business Integration Server Express and Server Express Plus version 4.3.1.1

The patch notes contain the following sections: 
 

COMPLETED CHANGE REQUESTS

UPGRADE INSTRUCTIONS

ADDITIONAL DISCUSSION

UNINSTALL INSTRUCTIONS

INSTALLING THE ADAPTER FOR HEALTHCARE DATA PROTOCOLS

COMPLETED CHANGE REQUESTS

This patch contains fixes for the following CRs based on customer reported and internally discovered issues.
 

CR Number

As of Version

Problem

26017

4.3.1.1

Adapter Development Kit:

Connector agent can't become active after AppResponseTimeOut and restart.

32096

4.3.1.1

Interchange Server:

Server stress test runs out of memory on AIX.

34598

4.3.1.1

Interchange Server:

Interchange Server takes 45 minutes to recognize agent connection request.

34696

4.3.1.1

Interchange Server:

It is very slow for Flow Manager connecting with Interchange Server.

35225

4.3.1.1

Connector Configurator:

Connector Configurator crashes when it opens a connector with large number of supported Business Object.

35933

4.3.1.1

Interchange Server:

Collaboration component memory leaks when connect with CSM.

37385

4.3.1.1

System Manager/Deployment:

Repos_copy does not call ICS Server Disconnect and causes memory leak problem.

44342

4.3.1.1

Interchange Server:
Enable ITLM product signature.

44344

4.3.1.1

System Manager (Java side Tools):

Memory leaks have been found in System Manager tools.

44346

4.3.1.1

Tools (C++ side Tools):

Memory leaks have been found in WBI Tools C++ side.

44435

4.3.1.1

Interchange Server:
Disable license limitation.

44503

4.3.1.1

Interchange Server:

Can't start adapter using the WBI express Iseries GM package.

44555

4.3.1.1

Business Object Designer:

The Business Object Designer will exit abnormally while creating Business Object with ODA.

44565

4.3.1.1

Map Designer:

Map Designer fails to open a map file.

44570

4.3.1.1

Connector Configurator:

If user selects “Save All to Project” action to save all connectors into one of System Manager Project and then user closes Connector Configurator. Connector Configurator will crash in the situation.

44573

4.3.1.1

Failed Event Manager:

“Select All” checkbox does not work when Failed Event Manager is running on Netscape.

44575

4.3.1.1

Failed Event Manager:

Failed Event Manager can not search for failed events in a designated period when Failed Event Manager is running on Netscape.

44582

4.3.1.1

Dashboard:

The Result of View CBOST is not correct.

44583

4.3.1.1

Dashboard:

The Dial of Event Rate can not increase when Dashboard is running on Netscape.

44585

4.3.1.1

Integrated Testing Environment:

Cannot start the naming server in Integrated Test Environment.

60097

4.3.1.1

Visual Test Connector:

Loading business object, Visual Test Connector will fail if the previously saved business object contains blank space.

60260

4.3.1.1

JText Adapter:

Cannot start JText adapter (SUSE) due to uncommented line in CWShared.Env.

60315

4.3.1.1

System Manager:

Deployment of large jar causes IllegalArgumentException.

N/A

4.3.1.1

Missing “Implementing Server Access Interface” functionality.

UPGRADE INSTRUCTIONS 

Before applying this patch, backup the following files:

  1. For Windows platform, you need to backup the %CROSSWORLDS%/bin, %CROSSWORLDS%/lib, %CROSSWORLDS%/WBSM and %WSWB_PATH%/plugins folders (e.g.  C:\IBM\WebSphereICS\Tools\WSWB203\plugins). 
  2. For Linux platform, you need to backup the ${CROSSWORLDS}/bin, ${CROSSWORLDS}/lib, ${CROSSWORLDS}/WBSM (if exists), ${CROSSWORLDS}/WBFEM (if exists), ${CROSSWORLDS}/messages folders (e.g.  /home/smbadmin/IBM/WebSphereServer/bin).

In the case you want to restore your original configuration after uninstalling the patch, replace those folders with the backups.

To perform an upgrade to this version of the WebSphere Business Integration Server Express or Server Express Plus, please follow instructions in the correct order as follows:

1.      Ensure that WebSphere Business Integration Server Express, Server Express Plus, and/or Adapter Capacity Pack are installed, in their final installation configuration, and all running processes are stopped.   In addition, if your product is installed on the Windows platform, ensure that the host machine has been rebooted after product installation.

2.      If WebSphere Application Server - Express 5.1 was installed by the WebSphere Business Integration Server Express/Server Express Plus Launchpad, please update to WebSphere Application Server - Express 5.1.1. Customers can obtain a copy of WebSphere Application Server 5.1.1 by downloading the WebSphere Business Integration Server Express or Server Express Plus 4.3.1 product from Passport Advantage. The product download has been updated to include a copy of WebSphere Application Server – Express 5.1.1.

3.      WebSphere Application Server - Express 5.1.1: On Windows platforms the logon user must be a member of the administrator group with the rights of Act as part of the operating system and Log on as a service.  Please visit the link http://publib.boulder.ibm.com/infocenter/ws51help/index.jsp and then click on the left panel “WebSphere Application Server (Express), Version 5.1.x -> Installing -> Security -> Implementing security considerations -> Securing  your environment before installation” for details.

4.      For Windows platform, unzip the “4311_Windows.zip” file into a temporary directory and then run the “4311_Server_Express_ExpressPlus_Patch.exe” file, accept the license agreement in the License Agreement panel and continue to the end. The installer will do all installing work for you. 

5.      For Linux platform, first ensure current user has installed the WebSphere Business Integration Server Express/Server Express Plus 4.3.1 before; second untar the “4311_Linux.tar” file into a temporary directory, go to that directory and execute the “4311_Server_Express_Patch.bin” file; and then accept the license agreement in the License Agreement panel and continue until the end. The installer will install and update the WebSphere Business Integration Server Express/Server Express Plus 4.3.1.1 patch for you.

Below are lists of files that were updated/replaced in this patch:
 

For Server Express/
Server Express Plus Version

Platform

Add / Replace / Remove

File (Starting from ~/IBM/WebSphereICS )

4.3.1.1

Windows 2000/XP

Replace

/bin/ActivityEditor.dll

4.3.1.1

Windows 2000/XP

Replace

/bin/BusObjDesigner.exe

4.3.1.1

Windows 2000/XP

Replace

/bin/ConnDesigner.exe

4.3.1.1

Windows 2000/XP

Replace

/bin/CxCommon2.dll

4.3.1.1

Windows 2000/XP

Replace

/bin/ServerConnection.dll

4.3.1.1

Windows 2000/XP

Replace

/bin/HFXComm.exe

4.3.1.1

Windows 2000/XP

Replace

/bin/SMInterface.dll

4.3.1.1

Windows 2000/XP

Replace

/bin/MapDesigner.exe

4.3.1.1

Windows 2000/XP

Replace

/bin/ProcessDesigner.exe

4.3.1.1

Windows 2000/XP

Replace

/bin/RelationshipDesigner.exe

4.3.1.1

Windows 2000/XP

Replace

/lib/flowmanager.jar

4.3.1.1

Windows 2000/XP

Replace

/lib/relmgr.jar

4.3.1.1

Windows 2000/XP

Replace

/Tools\WSWB203/plugins/com.ibm.btools.csm/csm.jar

4.3.1.1

Windows 2000/XP

Replace

/Tools\WSWB203/plugins/com.ibm.btools.itools.datamanager/datamanager.jar

4.3.1.1

Windows 2000/XP

Replace

/Tools\WSWB203/plugins/com.ibm.btools.itools.codeGen/lib/Crossworlds.jar

4.3.1.1

Windows 2000/XP

Replace

/Tools\WSWB203/plugins/com.ibm.btools.itools.common/lib/Crossworlds.jar

4.3.1.1

Windows 2000/XP

Replace

/Tools\WSWB203/plugins/com.ibm.btools.itools.testingenv/testingenv.jar

4.3.1.1

Windows 2000/XP

Replace

/bin/start_server.bat

4.3.1.1

Windows 2000/XP

Replace

/bin/start_server_service.bat

4.3.1.1

Windows 2000/XP/Linux/OS 400

Replace

/lib/Crossworlds.jar

4.3.1.1

Windows 2000/XP/Linux

Replace

/lib/datamanager.jar

4.3.1.1

Windows 2000/XP/Linux/OS 400

Replace

/messages/InterchangeSystem.txt

4.3.1.1

Windows 2000/XP/Linux/OS 400

Add

/lib/ITLM/ITLMToolkit.jar

4.3.1.1

Windows 2000/XP/Linux/OS 400

Add

/lib/ITLM/jlog.jar

4.3.1.1 (for Server Express)

Windows 2000/XP/Linux

Add

/bin/CC002869J040301.sys

4.3.1.1 (for Server Express Plus)

Windows 2000/XP/Linux

Add

/bin/CC002870J040301.sys

4.3.1.1 (for Server Express)

Windows 2000/XP/Linux/OS 400

Add

/bin/ITLM.lic

4.3.1.1 (for Server Express Plus)

Windows 2000/XP/Linux/OS 400

Add

/bin/ITLM.lic

4.3.1.1

Windows 2000/XP/Linux/OS 400

Replace

/WBFEM/WAS/FailedEvents.war

4.3.1.1

Windows 2000/XP/Linux/OS 400

Replace

/WBFEM/Tomcat/FailedEvents.war

4.3.1.1

Windows 2000/XP/Linux/OS 400

Replace

/WBSM/CWDashboard.war

4.3.1.1

Linux

Replace

/bin/CWSharedEnv.sh

4.3.1.1

Linux/OS 400

Add

/HealthcareAdapter.tar

4.3.1.1

OS 400

Replace

/bin/CWConnEnv.sh

4.3.1.1

OS 400

Replace

/bin/CWODAEnv.sh

4.3.1.1

OS 400

Replace

/lib/ServerInstance.jar

4.3.1.1

OS 400

Replace

/bin/start_server.sh

4.3.1.1

Windows 2000/XP/Linux/OS 400

Add

/DevelopmentKits/edk/ServerAccessInterfaces/AccessInterfaces.idl

4.3.1.1

Windows 2000/XP/Linux/OS 400

Add

/DevelopmentKits/edk/ServerAccessInterfaces/AccessSample/ATPServlet.java

4.3.1.1

Windows 2000/XP/Linux/OS 400

Add

/DevelopmentKits/edk/ServerAccessInterfaces/AccessSample/collaborations/classes/UserCollaborations/SampleAtpTemplate.class

4.3.1.1

Windows 2000/XP/Linux/OS 400

Add

/DevelopmentKits/edk/ServerAccessInterfaces/AccessSample/DLMs/classes/NativeMaps/IncomingItemtoItem.class

4.3.1.1

Windows 2000/XP/Linux/OS 400

Add

/DevelopmentKits/edk/ServerAccessInterfaces/AccessSample/DLMs/classes/NativeMaps/IncomingQuotetoSalesQuote.class

4.3.1.1

Windows 2000/XP/Linux/OS 400

Add

/DevelopmentKits/edk/ServerAccessInterfaces/AccessSample/DLMs/classes/NativeMaps/ItemtoIncomingItem.class

4.3.1.1

Windows 2000/XP/Linux/OS 400

Add

/DevelopmentKits/edk/ServerAccessInterfaces/AccessSample/DLMs/classes/NativeMaps/ItemtoSapMaterial.class

4.3.1.1

Windows 2000/XP/Linux/OS 400

Add

/DevelopmentKits/edk/ServerAccessInterfaces/AccessSample/DLMs/classes/NativeMaps/SalesQuotetoIncoingQuote.class

4.3.1.1

Windows 2000/XP/Linux/OS 400

Add

/DevelopmentKits/edk/ServerAccessInterfaces/AccessSample/DLMs/classes/NativeMaps/SalesQuotetoSampleSapQuote.class

 

4.3.1.1

Windows 2000/XP/Linux/OS 400

Add

/DevelopmentKits/edk/ServerAccessInterfaces/AccessSample/DLMs/classes/NativeMaps/SampleSapQuotetoSalesQuote.class

4.3.1.1

Windows 2000/XP/Linux/OS 400

Add

/DevelopmentKits/edk/ServerAccessInterfaces/AccessSample/DLMs/classes/NativeMaps/SapMaterialtoItem.class

 

4.3.1.1

Windows 2000/XP/Linux/OS 400

Add

/DevelopmentKits/edk/ServerAccessInterfaces/AccessSample/Example2.html

 

4.3.1.1

Windows 2000/XP/Linux/OS 400

Add

/DevelopmentKits/edk/ServerAccessInterfaces/AccessSample/HtmlDataHandler.java

 

4.3.1.1

Windows 2000/XP/Linux/OS 400

Add

/DevelopmentKits/edk/ServerAccessInterfaces/AccessSample/SampleRepos.jar

 

ADDITIONAL DISCUSSION

  1. This patch supports both Server Express and Server Express Plus. The version installed will be determined at install time.
  2. The installer will install patch files only for the components found on the system (i.e If you have InterChange Server Express and Toolset Express installed on separate machines, the installer will install the appropriate set of files when run on either machine)
  3. If both an Adapter and InterChange Server Express are set to start up as Windows Services (i.e. the set to start as auto-start services) and the host machine is rebooted, the Adapter may not connect to InterChange Server Express if the Server takes a longer time to startup with this Fixpack. In those cases setting a higher retry-count for the Adapter would give more time for the Adapter to connect to InterChange Server Express.
  4. The HealthCare adapter is packaged with InterChange Server Express. If InterChange Server Express is installed the installer will install a .zip or .tar file containing the files related to the HealthCare adapter in the following location : <install location> \HealthCareAdapter.zip (HealthCareAdapter.tar). See Installing the Adapter for HealthCare Data Protocols in this file.

UNINSTALL INSTRUCTIONS

In part UPGRADE INSTRUCTIONS, you are recommended to backup the %CROSSWORLDS%/bin, %CROSSWORLDS%/lib, %CROSSWORLDS%/WBSM and %WSWB_PATH%/plugins folders for the purpose of uninstalling the patch.
If you have done the backup process, make sure the current user is the user who has installed the patch, and uninstall the patch by launching the uninstaller via the commandline as follows:
1. Move to the <install location>\_uninst directory.
2. Type the following command at the prompt: > java -cp uninstall.jar run.

INSTALLING THE ADAPTER FOR HEALTHCARE DATA PROTOCOLS

Note

The Adapter for Healthcare Data Protocols makes use of files that exist on your system only if you have already installed another WebSphere Business Integration Server Express adapter. If you have not already installed another adapter on your system, install the Adapter for JText before you install the Adapter for HealthCare Data Protocols.

 

On OS/400

 

To install the adapter, perform the following steps after you have loaded and applied PTF SI15851 on your OS/400 system.

  1. Map a network drive to your OS/400 system from a Windows client.

  2.  Navigate on the mapped network drive to this directory:

     /QIBM/ProdData/WBIServer43/

  3. Extract HealthcareAdapter.zip to:
     
    /QIBM/ProdData/WBIServer43/product

  4. When you extract HealthcareAdapter.zip, files are extracted to the following subfolders:

    \bin\Data\App
    \connectors

    An adapter template file is necessary for configuring the adapter. To obtain the template file, copy all the files from the \bin\Data\App folder to the corresponding folder in your WebSphere Business Integration Server Express or Express Plus 4.3.1.1 installation directory on the Windows client(s) you use for Toolset Express. This makes the template file available to Connector Configurator. If you have used the default  installation folders, copy the files to this location:

    IBM\WebSphereServer\bin\Data\App

  5. To use the Healthcare adapter in a server instance, in QShell on the OS/400, enter the following script:

    /QIBM/ProdData/WBIServer43/bin/update_instance.sh  -all QWBIDFT

 

  1. After you have performed these steps, see the Adapter for Healthcare Data Protocols User Guide for information about completing configuration for the connector.

 

On Windows

To install the adapter on Windows systems, perform the following steps after you have run the installer (4311_Server_Express_ExpressPlus_Patch.exe).

 

  1. In your WebSphere Business Integration Server Express or Express Plus 4.3.1.1 installation directory, locate this file:

    HealthCareAdapter.zip

    Your 4.3.1.1 installation directory is the same as the installation directory that was created when you installed WebSphere Business Integration Server Express or Express Plus, version 4.3.1.  By default, that location is:

    IBM\WebSphereServer

 

  1. Extract the file. By default, the file extraction places all the extracted files in the following new folder:

    \WebSphereBI

 

  1. The \WebSphereBI folder contains the following subfolders:

    \bin
    \connectors

    Copy all the files from each of these folders to the corresponding folders in
    your WebSphere Business Integration Server Express or Express Plus 4.3.1.1 installation directory. If you have used the default locations, copy the files to the locations shown below:

    IBM\WebSphereServer\bin\Data\App
    IBM\WebSphereServer\connectors

 

  1. After you have copied the files, modify the connector startup file to point to the connector and to the InterChange Server Express instance with which the connector will communicate.

    To do so, open the file start_Healthcare.bat in a text editor, and make the changes described below. The new values are shown in bold. To specify the InterChange Server Express instance, make this change:

    set SERVER=WebSphereICS

    WebSphereICS is the default name for the InterChange Server Express instance  that was established when you ran the Installer program for WebSphere Business Integration Server Express or Express Plus 4.3.1. Unless you modified the name of your installed  InterChange Server Express instance to be different from the default, set the server value in the connector startup file to WebSphereICS.

    To specify the connector, make this change, which identifies the subdirectory that contains the files for this connector:

    setCONNAME=Healthcare

  2. Optionally, on Windows systems, you can create a shortcut for the adapter. See your Windows documentation for instructions on creating a shortcut to point to start_Healthcare.bat.

 

  1. After you have performed these steps, see the Adapter for Healthcare Data Protocols User Guide for information  about completing configuration for the connector.

 

On Linux

To install the adapter on Linux systems, perform the following steps after you have run the installer (4311_Server_Express_Patch.bin).

  1. In your WebSphere Business Integration Server Express or Express Plus 4.3.1.1 installation directory, locate this file:

    HealthcareAdapter.tar

    Your 4.3.1.1 installation directory is the same as the installation directory that was created when you installed WebSphere Business Integration Server Express or Express Plus, version 4.3.1.  By default, that location is:

    $/home/${username}/IBM/WebSphereServer/

 

  1. Extract the file. By default, the file extraction places all the extracted files in the following new folder:

    /WebSphereBI

 

  1. The /WebSphereBI folder contains the following subfolders:

    /bin
    /connectors

    Copy all the files from each of these folders to the corresponding folders in your WebSphere Business Integration Server Express or Express Plus 4.3.1.1 installation directory. If you have used the default locations, you will copy the files to the locations shown below:

    $/home/${username}/IBM/WebSphereServer/bin/Data/App
    /home/${username}/WebSphereServer/connectors

 

  1. If you plan to use connector_manager to start and stop the connector, you do not need to make any start-up file modification, unless you have changed the name of your InterChange Server Express instance.  By default, the connector_manager file specifies the InterChange Server Express instance as follows:

    SERVERNAME=WebSphereICS

    For more information about starting and stopping the connector, see the System Administration Guide and the Adapter for Healthcare Data Protocols User Guide.

 

  1. The BO Extractor Tool is delivered  with Healthcare Adapter. To start it, you must modify the following file:

    /connectors/Healthcare/start_BOExtractor.sh

    To do so, find the following line in “start_BOExtractor.sh

    CROSSWORLDS=VAR_HOME

    Replace the value of VAR_HOME with the directory path into which the /connector subdirectory has been installed.  By default, you would make this change:

    CROSSWORLDS=$/home/${username}/IBM/WebSphereServer

 

© 2004 IBM Corporation.  Proprietary and Confidential.  All Rights Reserved.