Readme for
WebSphere® Interchange Server and Toolset Fix Pack Version 4.2.2.7

 

The patch notes contain the following sections:

Known Problems

New Features

Completed Change Requests

Prerequisites

Upgrade Instructions

Server files Installed

Toolset Files Installed

Additional Discussion

Uninstall Instructions

 

Known Problems

 

83913:  Wics 4.2.2.7 on Solaris will not install correctly if the WICS JRE has been upgraded

There is a problem with WICS 4.2.2.7 on Solaris for environments where the JRE has been upgraded by copying a later version JRE to the WICS directory.  For WICS 4.2.2.7 to work properly you must first restore your backup copy of the WICS 4.2.2 JRE then install the WICS 4.2.2.7 fix pack.  If you do not have a backup copy, one is provided with this fix pack as part of the Solaris download package.

See Additional Discussion section for details

 

45046:  WICS 4.2.2.7 InterChange Server running on a system with Japanese locale cannot connect to an Oracle database.  This problem will be corrected in a future fix pack.

 

67318  To Installing WICS 4.2.2 on AIX 5.3 ML1 or later you must start the installer with the parameter: 

            -W invalidPlatform.active="false"

See Additional Discussion section for details

 

67599  The PROBE View in System Monitor is unavailable when configured with DB2 and the Application Server is running on UNIX®.

See Additional Discussion section for workaround

New Features

Combined installer for InterChange Server and Toolset fix pack – New in Fix Pack 4.2.2.6

There is no longer a separate fix pack for the InterChange Server and Toolset. The Windows®  version of this fix pack installer will install both InterChange Server and Toolset fixes. The UNIX versions of the installer will install the InterChange Server and web-based System Monitor.  Note if using the System Monitor on UNIX you must re-deploy WBSM/CWDashboard.war and WBSM/WBSMMigrate.jar . See the WebSphere InterChange Server Installation Guide version 4.2.2 under “Installing System Monitor”.

 

IsNameServerAlive script – New in Fix Pack 4.2.2.6

Checks if transient name server process is running on host and port specified in CWSharedEnv. Usage: IsNameServerAlive

Recommended to be used by HA scripts inplace of CosNameServerDump as it is lightweight in nature.

Note: For UNIX installations you must edit this script replacing “VAR_CWHOME” with the install directory of the WebSphere Interchange Server. 

 

Fix Pack Installer – New in fix pack 4.2.2.5

The WICS fix pack is now installed with an install program rather than unpacking the .tar or .zip file.

Please see the Upgrade Instructions for details.

ITLM enablement feature – New in fix pack 4.2.2.4

IBM Tivoli License Manager (ITLM) enablement - A new inventory and license management tool is bundled as part of the WebSphere InterChange Server. Version 2.1 of the IBM Tivoli« License Management (ITLM) product provides a framework for this asset management. The same ITLM product is also provided with IBM WebSphere Business Integration Toolset 4.2.2.4. In the current release of both WebSphere InterChange Server and WebSphere Business Integration Toolset the ITLM product is enabled only for inventory support..

 

Completed Change Requests

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

Server and ADK fixes (Includes WICS Interim Fixes thru 4.2.2.6 LAIF 12)

 APAR or Problem Number                 Problem Description

  74207            Certify WICS 4.2.2.7 with AIX 5.3 ML3 (See Addition Discussion and Known Problems for instructions on installing WICS 4.2.2.x on AIX 5.3 ML1 or later)

  67278            Certify WICS 4.2.2.7 with DB2 V8.9

  67826            Certify WICS 4.2.2.7 with IBM SDK, Java TM Technology Edition v1.3.1 SR9 (included with this fix pack for AIX®, Windows®, and Solaris®)

  82853            forward port cr31428 to 4.2.2.7: error in ics_manager.sh

  83451            (Port 32595) Server Access Call fails on Japanese characters in the BO. 

  83452            (Port 34080) Display of Connector Dynamic Properties may cause failed events

  83453            (Port 36298) LogInfo(), LogError(), LogWarning()  displays incorrect SS: with Collab groups

  83450            (Port 58551) Statistics for Server Access Interface (SAI) call Mean service time=0

  58755            ICS Scheduler throws error when starting collab 

  83454            (Port 59657) repos_copy -i makes quotes (') two quotes ('') in the repository

  58944            -wi option for repos copy not working

  JR20607        (60474) "Failed to save event state change" - extra/misleading error message in ICS log

  JR23403        (60946) CXWORKFLOWCONTEXT table keeps growing 

  JR23419        (67534) error 9047 generated when shutdown adapter from Dashboard 

  67656            Runtime error will occur when set frequency from "NONE" to other value 

  JR23421        (67697) MQ Adapter 2.5.1 synchronous mode issue 

  JR23406        (72435) RequestResponse datahandler throws null pointer exception using MQ 2.6.x adapter

  JR22645        (73729) Tools intermittent hang state 

  JR22671        (73990) IllegalStateException: Timer already cancelled when starting a paused collaboration

  74087            LLBP Collaboration not picking up events – Resubmitting failed event causes FlowControl error: WIPQ full

  74305            MAP Deployment Error: [MsgID: 21] [Mesg: InterChange Serverfailed to boot

  JR23418        (74123) Changed error message for Flow Monitoring Service Configuration to message type=info.

  83143            Problem with certificates and starting ICS with system date after 5/17/2006

  JR21869        (71873) WebServices connector start fails with NAMESPACE_ERR

 

Toolset fixes

 JR23422         (72719) Improve the work quality of adminmgr.bat/sh by adding retry mechanism

 67042             WICS4225a: Launch BOD from CSM ,BOD can not create BO

 JR23420         (83234) WSDL generation now supports Business Objects containing arrays.

 

 

Prerequisites

 

1.      You must have version 4.2.2 of WebSphere InterChange Server and/or Toolset installed in order to install this fix pack.

2.      You must install this Fix Pack on both the WebSphere InterChange Server and Toolset installations.

 

Other Supported Software Versions

WBIA 2.4.0.2

Java  Runtime Environment:

Windows          IBM 32-bit Runtime Environment for Windows, v1.3.1 SR9 (included with this fix pack)

AIX                 IBM 32-bit Runtime Environment for AIX, v1.3.1 SR9 (included with this fix pack)

Solaris              Sun Java 2 Runtime Environment v1.3.1.17 (included with in this fix pack).

HP-UX            HP-UX Runtime Environment for the Java platform V1.3.1.17 (Must be downloaded separately from HP)

 

For a detailed list of WICS Software compatibility information see: http://www-1.ibm.com/support/docview.wss?uid=swg21175711

 

 

Upgrade Instructions 

Please read: Upgrade procedure is changed significantly from previous releases

 

Caution: Be sure when downloading the files that setup.jar is downloaded with the .jar extension. Some download environments may append the .zip extension which will cause setup to fail.  If this happens then just rename the file to setup.jar. Do not try to unzip the file.

 

 

To apply this Fix Pack on a Windows system:

1.       The Fix Pack Installer for Windows is a combined installer for both InterChange Server and Toolset Fix Pack 4.2.2.7. The installer will apply the fix pack for the InterChange Server or Toolset or both depending on what you have installed.

2.       If both server and Toolset are installed on the same system they must have been installed to the same directory.

3.       Shut down the InterChange Server if it is installed and running on the same system.

4.       Back up the files listed in the table below for the InterChange Server or Toolset or both depending on what you have installed.  This enables the fix pack to be uninstalled.

5.       If you have modified CW_MEM_HEAP in start_server.bat or start_server_service.bat you will need to make the change again to the new copy of these files installed with this fix pack. Make a note of the values currently specified before installing this fix pack. Note: if you have already installed 4.2.2.5, 4.2.2.5-A or 4.2.2.6 then you can simply save these files before installing 4.2.2.7 and restore them after installing 4.2.2.7. There are no changes to these files between WICS 4.2.2.5 and WICS 4.2.2.6 and 4.2.2.7 fix packs.

6.       Download and run the fix pack Installer

7.       If needed, change the start_server.bat and start_server_service.bat files as determined in step 5.

 

To apply this Fix Pack on AIX, HP_UX, or Solaris systems:

 

1.      Known Problem: 83913 Wics 4.2.2.7 on Solaris will not install correctly if the WICS JRE has been upgraded See Known Problems for details.

2.      Restriction: To install this fix pack on AIX, HP_UX, or Solaris you must install from the same user that was used to install the base WebSphere InterChange Server 4.2.2 product

3.      Restriction: To install this fix pack on Solaris you must not install from the root user.

4.      The Fix Pack Installers for AIX, HP_UX, and Solaris are for InterChange Server only since the Toolset is not supported on these systems.

5.      Shut down the InterChange Server if it is running

6.      Back up the files listed in the table below for the InterChange Server. This enables the fix pack to be uninstalled.

7.      If  you modified CWSharedEnv.sh such as changing CW_MEMORY_MAX you will need to make the changes again to the new file installed with this fix pack. Make a note of the value currently specified before installing this fix pack. Note: if you have already installed 4.2.2.5 or later then you can simply save CWSharedEnv.sh before installing 4.2.2.7 and restore it after installing 4.2.2.7. There are no changes to this file since WICS 4.2.2.5.

8.      For Solaris Platforms only: If you are using DB2 you must edit CWSharedEnv.sh. Save the file before installing this fix pack. After installing, replace the line DB2_HOME=VAR_DB2_HOME with the corresponding line from the saved file. Note: if you have already installed 4.2.2.5 or later then you can simply save CWSharedEnv.sh before installing 4.2.2.7 and restore it after installing 4.2.2.7. There are no changes to this file since WICS 4.2.2.5.

9.      Download and run the Fix pack Installer corresponding to the Operating System on which the InterChange Server is installed.

10.  If needed, change the CWSharedEnv.sh file as determined in step 6..

11.  If using the web-bases System Monitor on UNIX then you must re-deploy WBSM/CWDashboard.war and WBSM/WBSMMigrate.jar.

12.  For HP-UX Systems:  Download the HP-UX redistributable Runtime Environment for the Java platform V1.3.1.17 from the HP website: http://www.hp.com/products1/unix/java/java2/sdkrte1_3/downloads/license_rte_1-3-1-17_pa-risc.html and extract it to the WebSphere InterChange Server and Toolset installation directory to upgrade the JRE to the required level.

13.  Edit the script IsNameServerAlive in the WICS bin directory, replacing “VAR_CWHOME with the install directory of the WebSphere InterChange Server.

 

Server Files installed by this fix pack

*Note that each .sys file is installed or not depending on which ICS features were installed.

Platform [Win32;Solaris;AIX;HP_UX]

Add / Replace / Remove

File (Starting from WICS installation directory)

Associated Feature and notes

(File is installed only if the associated feature was installed)

Win32:Solaris:AIX:HP_UX

Add

bin/CC001616J040202.sys

Server

Win32:Solaris:AIX:HP_UX

Add

bin/CC000976J040202.sys

ICSAccess for EJB

Win32:Solaris:AIX:HP_UX

Add

bin/CC001133J040202.sys

ICSAccess

Win32:Solaris:AIX:HP_UX

Add

bin/CC001351J040202.sys

ICSAccess for Connectors

Win32:Solaris:AIX:HP_UX

Replace

jre/*

JRE, IBM ORB, and IBM JCE (note on HP this fix pack only installs the IBM ORB and IBM JCE. You must download the required JRE and install it separately. See the Installation instructions above.)

Win32

Replace

bin/start_server.bat

Server

Win32

Replace

bin/start_server_service.bat

Server

Win32

Replace

bin/PersistentNameServer.bat

Server

Win32

Replace

bin/IsNameServerAlive.bat

Server

Solaris:AIX:HP_UX

Replace

bin/CWSharedEnv.sh

Server

Solaris:AIX:HP_UX

Replace

bin/IsNameServerAlive.sh

Server

Solaris:AIX:HP_UX

Replace

bin/PersistentNameServer.sh

Server

Win32:Solaris:AIX:HP_UX

Replace

lib/CrossWorlds.jar

Server

Win32:Solaris:AIX:HP_UX

Replace

lib/datamanager.jar

Server

Win32:Solaris:AIX:HP_UX

Replace

lib/cwsnmpagent.jar

Server

Win32:Solaris:AIX:HP_UX

Replace

lib/ConfigWizard.jar

Server

Win32:Solaris:AIX:HP_UX

Replace

lib/xwbase.jar

Server

Win32:Solaris:AIX:HP_UX

Replace

lib/xworacle.jar

Server

Win32:Solaris:AIX:HP_UX

Replace

lib/xwsqlserver.jar

Server

Win32:Solaris:AIX:HP_UX

Replace

lib/xwutil.jar

Server

Win32:Solaris:AIX:HP_UX

Add

lib/ITLMToolkit.jar

Server

Win32:Solaris:AIX:HP_UX

Add

lib/jlog.jar

Server

Win32:Solaris:AIX:HP_UX

Replace

lib/jmsmgr.jar

Server - ADK

Win32:Solaris:AIX:HP_UX

Replace

messages/InterchangeSystem.txt

Server

Win32:Solaris:AIX:HP_UX

Replace

DevelopmentKits/J2EE/EJB/cwsession_ejb-jar.jar

ICSAccess for EJB

Win32

Replace

./DevelopmentKits/cdk/lib/Debug/CwConnector.dll

Server - CDK

Win32

Replace

./DevelopmentKits/cdk/lib/Debug/CwConnector.lib

Server - CDK

Win32

Replace

./DevelopmentKits/cdk/lib/Release/CwConnector.dll

Server - CDK

Win32

Replace

./DevelopmentKits/cdk/lib/Release/CwConnector.lib

Server - CDK

 

 

 Toolset Files installed by this fix pack  

Platform [Windows]

Add / Replace / Remove

File (Starting from ~/IBM/WebSphereICS/

Windows 2000/XP

Replace

bin/BusObjDesigner.exe

Windows 2000/XP

Replace

bin/Castor.exe

Windows 2000/XP

Replace

bin/ConnDesigner.exe

Windows 2000/XP

Replace

bin/HFXComm.exe

Windows 2000/XP

Replace

bin/LogViewer.exe

Windows 2000/XP

Replace

bin/ProcessDesigner.exe

Windows 2000/XP

Replace

bin/MapDesigner.exe

Windows 2000/XP

Replace

bin/RelationshipDesigner.exe

Windows 2000/XP

Replace

bin/Data/Std/StdConnProps.xml

Windows 2000/XP

Replace

bin/Data/Std/StdConnProps_chs_chn.xml

Windows 2000/XP

Replace

bin/Data/Std/StdConnProps_cht_twn.xml

Windows 2000/XP

Replace

bin/Data/Std/StdConnProps_deu_deu.xml

Windows 2000/XP

Replace

bin/Data/Std/StdConnProps_esn_esp.xml

Windows 2000/XP

Replace

bin/Data/Std/StdConnProps_fra_fra.xml

Windows 2000/XP

Replace

bin/Data/Std/StdConnProps_ita_ita.xml

Windows 2000/XP

Replace

bin/Data/Std/StdConnProps_jpn_jpn.xml

Windows 2000/XP

Replace

bin/Data/Std/StdConnProps_kor_kor.xml

Windows 2000/XP

Replace

bin/Data/Std/StdConnProps_ptb_bra.xml

Windows 2000/XP

Replace

bin/ActivityEditor.dll

Windows 2000/XP

Replace

bin/CxCommon2.dll

Windows 2000/XP

Replace

bin/ServerConnection.dll

Windows 2000/XP

Replace

bin/SMInterface.dll

Windows 2000/XP

Replace

bin/Utils.dll

Windows 2000/XP

Replace

bin/XRmi.dll

Windows 2000/XP

Add

bin/CC001224W040202.sys

Windows 2000/XP

Replace

lib/datamanager.jar

Windows 2000/XP

Replace

lib/flowmanager.jar

Windows 2000/XP

Replace

lib/ConfigWizard.jar

Windows 2000/XP

Replace

lib/cwsnmpagent.jar

Windows 2000/XP

Replace

lib/vtc.jar

Windows 2000/XP

Replace

lib/relmgr.jar

Windows 2000/XP

Replace

lib/CrossWorlds.jar

Windows 2000/XP/Windows 2003:Solaris:AIX:HP_UX

Replace

WBSM/CWDashboard.war

Windows 2000/XP/Windows 2003:Solaris:AIX:HP_UX

Replace

WBSM/WBSMMigrate.jar

Windows 2000/XP

Replace

plugins/com.ibm.btools.csm

Windows 2000/XP

Replace

plugins/com.ibm.btools.itools.codeGen

Windows 2000/XP

Replace

plugins/com.ibm.btools.itools.datamanager

Windows 2000/XP

Replace

plugins/com.ibm.btools.itools.testingenv

Windows 2000/XP

Replace

plugins/com.ibm.btools.itools.collaboration.debugger

Windows 2000/XP

Replace

plugins/com.ibm.btools.itools.flowtrace

Windows 2000/XP

Replace

plugins/com.ibm.btools.itools.wsdlgen

Windows 2000/XP

Replace

\bin\chs_chn\ConnDesignerRes.dll

Windows 2000/XP

Replace

\bin\cht_twn\ConnDesignerRes.dll

Windows 2000/XP

Replace

\bin\kor_kor\ConnDesignerRes.dll

Windows 2000/XP

Replace

\bin\enu_usa\ConnDesignerRes.dll

Windows 2000/XP

Replace

\bin\esn_esp\ConnDesignerRes.dll

Windows 2000/XP

Replace

\bin\fra_fra\ConnDesignerRes.dll

Windows 2000/XP

Replace

\bin\ptb_bra\ConnDesignerRes.dll

Windows 2000/XP

Replace

\bin\deu_deu\ConnDesignerRes.dll

Windows 2000/XP

Replace

\bin\jpn_jpn\ConnDesignerRes.dll

Windows 2000/XP

Replace

\bin\ita_ita\ConnDesignerRes.dll

Windows 2000/XP

Replace

\bin\cht_twn\CxCommonRes.dll

Windows 2000/XP

Replace

\bin\chs_chn\ProcessDesignerRes.dll

Windows 2000/XP

Replace

\bin\cht_twn\ProcessDesignerRes.dll

Windows 2000/XP

Replace

\bin\kor_kor\ProcessDesignerRes.dll

Windows 2000/XP

Replace

\bin\enu_usa\ProcessDesignerRes.dll

Windows 2000/XP

Replace

\bin\esn_esp\ProcessDesignerRes.dll

Windows 2000/XP

Replace

\bin\fra_fra\ProcessDesignerRes.dll

Windows 2000/XP

Replace

\bin\ptb_bra\ProcessDesignerRes.dll

Windows 2000/XP

Replace

\bin\deu_deu\ProcessDesignerRes.dll

Windows 2000/XP

Replace

\bin\jpn_jpn\ProcessDesignerRes.dll

Windows 2000/XP

Replace

\bin\ita_ita\ProcessDesignerRes.dll

Windows 2000/XP

Replace

_uninstZip\com.ibm.btools.csm.zip.log

Windows 2000/XP

Replace

_uninstZip\com.ibm.btools.itools.codeGen.zip.log

Windows 2000/XP

Replace

_uninstZip\com.ibm.btools.itools.collaboration.debugger.zip.log

Windows 2000/XP

Replace

_uninstZip\com.ibm.btools.itools.datamanager.zip.log

Windows 2000/XP

Replace

_uninstZip\com.ibm.btools.itools.flowtrace.zip.log

Windows 2000/XP

Replace

_uninstZip\com.ibm.btools.itools.testingenv.zip.log

Windows 2000/XP

Replace

_uninstZip\com.ibm.btools.itools.wsdlgen.zip.log

 

Additional Discussion

Known problems:

83913:  To install WICS 4.2.2.7 on Solaris where the InterChange Server JRE has been upgraded you must first restore the WICS 4.2.2 JRE as follows:

             

            1. Delete your existing jre directory from the WICS install directory. Example: 

rm –rf  /opt/IBM/WebSphereICS/jre

            2. . Download the wics422sol_jre.tar provided with this fix pack to your WICS installation directory and unpack it in the WICS installation directory.

. Example:

                        cd /opt/IBM/WebSphereICS

                        tar –xf wics422sol_jre.tar

            or if you already have a backup copy of your WICS 4.2.2 JRE you can copy to it your WICS jre directory. Example:

                        cp –r /opt/IBM/WebSphereICS /jre_bak /opt/IBM/WebSphereICS /jre

            3. Proceed with the WICS 4.2.2.7 installation according to the installation instructions.

 

67318  To Installing WICS 4.2.2 on AIX 5.3 ML1 or later you must start the installer with the parameter: 

            -W invalidPlatform.active="false"

 Example:

            ./setupAIX.bin -W invalidPlatform.active="false"

 

When using this option the installer will list both WICS Server and Toolset as installable components. The Toolset is not supported on UNIX systems and should not be selected.

 

Then install WICS fix pack 4.2.2.7 with the same parameter when starting the fix pack installer.

 

67599  The PROBE View in System Monitor is unavailable when configured with DB2 and the Application Server is running on UNIX.

Workaround for WebSphere Application Server configuration:

 

Workaround Summary:

Edit "Classpath" for "Java Virtual Machine" under "Process Definition" of System Monitor and replace 'Enter' and 'Newline' between "/home/db2inst1/sqllib/java/db2java.zip" and "/usr/WebSphere/AppServer/installedApps/aix68/ICSMonitorApp.ear/CWDashboard.war/WEB-INF/lib/xerces.jar" with 'Space'(These two classpath files should appear in the same line).

 

Step by step workaround instructions for WebSphere Application Server configuration:

 Note: These steps are for W.A.S. Version 5.1. Steps may vary for other versions of W.A.S.

 

1.       Run script ${CrossWorlds}/bin/CWDashboard.sh with parameters described in the script.

2.       Run script ${WAS}/bin/startServer.sh Server1 to start Application Server "Server1".

3.       Start Admin Console from Browser.(URL is http://HostName:9090/admin )

4.       Enter a User id such as "admin", then click OK.

5.       Expand the Servers menu in the left navigation frame.

6.       Click on the Application Servers link for ICSMonitor.

7.       Under Additional Properties, click on the Process Definition link.

8.       Click on the Java Virtual Machine link.

9.       In the Classpath field, replace Enter and Newline between "/home/db2inst1/sqllib/java/db2java.zip" and "/usr/WebSphere/AppServer/installedApps/aix68/ICSMonitorApp.ear/CWDashboard.war/WEB-INF/lib/xerces.jar" with Space.

10.   In the Boot Classpath field, copy all the content from Classpath field to Boot Classpath field.

11.   In the Generic JVM arguments field, add parameter
 "- Xbootclasspath/p:/usr/WebSphere/AppServer/installedApps/aix68/ICSMonitorApp.ear/CWDashboard.war/WEB-INF/lib/xerces.jar"
in front of other default parameters.

12.  Click Save.

13.   Run script ${DB2_HOME}/db2profile

14.  Copy db2java.zip to $(WAS)/AppServer/lib

15.  Run script ${WAS}/bin/startServer.sh ICSMonitor.

 

 

 

Uninstall Instructions

1.      When installing the fix pack, you should first back up all the old files that are being replaced. To uninstall this fix pack, replace the new files with the backed-up files.

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