Readme for

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 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.

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 fixes

45659 WIC InterChange Server 4.2.2.6 to support AIX 5.3 ML1 or later (see Addition Discussion section for known problems and instruction on installing WICS 4.2.2.6 on AIX 5.3 ML1 or later)

33846 more information needed for message 2811 Can not overwrite active components

44794 Adapters which are working on LL AF fail to tstart up without -c parameter.

59832 Map status is incorrect after deployment

59500 EmailNotification: should check for null value on mail type instead of NPExcept

61803 ICS shuts down with : 11056] [Mesg: Server will be shut down ....DTE

45925 Upgrade failed when a special schedule in repositiory

60828 WICS 4.2.2.3 crashes with db specific error 1205

35096 ConcurrentModificationException and ResultSet closed during ICS startup

60887 Stale ORB handle after deleting a connector

71750 Discrepancy in the Associated maps of the connectors

45824 recursive BO brings exception when using LLBP

66683 Has NullPointer Exception in duplicate() in 4225

60059 ICS gets unknown ORACLE error during startup - HY000 ... Reason: 0

61135 JTS UpgradeReposSuite hanging (Internal - not for customer)

36511 Some of the components not getting compiled/started properly (because of email connector)

71217 Maps looses explicit binding in production

60486 releaseRelConnection() method only releases conn. if doCommit is set to true

44720 Collaboration statistics show incorrect value for successful flows.

71470 Collaboration can not paused when critical error happen

71161 Msg 9042/24251 and 11056 - event resubmission failure and duplicate events

61537 Why is msg 15013 fatal in 4.2.2.4 ('Unable to deliver Source Business Object')?

71472 IsServerAlive does not display correct message when "admin" user password is changed \Java\Utilities\IsServerAlive

72020 The IsSnmpAgentAlive function wasnt returning the proper exit code and the startHA will successfully start the SNMP Agent but will output a message at the end indicating the startup wasnt successful.

71919 4.2.2.5 fixpack fails to bring ICS up

61922/62007 ics_manager -start does not prevent second instance to start

28966 Unexpected return for async inbound servicecall

59056/61373 WICS shuts down with MSGID 11056 using 4.2.2.3

44471 OADAgentActivation.java merged 3/17 from 4225 LAIF1

44828/32246 EventSequencing fails if Key is Child BO

61118 ICS 4.2.2.4 LAIF1 intermittently fails async response recieved with null pointer.

62021 Connector error mail recipient ignored (moved from ADK to Server section)

59635 Monitoring script causes memory leak in ICS (New JDK SR9)

59593 LLBP Outbound response fails with Mesg: Cannot find subscription for business object. This happens when the response arrives even before the Async Inbound subscription is sent. (Requires readme config note – see 4225 LAIF1 or later for config note)

For verification use the same test as in 4.2.2.5. The fix is now more robust in 4.2.2.6 but the test remains the same. We cannot provide a more robust test.

61372 ICS 421 Slow recovery

58701 ICS Error Msg: CwMapMessages.txt not found

60339 memory leak in ICS when details of business object viewed in Flow Manager

60807 java out of memory in ICS when load is placed on system for an extended period of time with no pause in the action.

61972,71436,71358 Persistent Monitor memory leak

71805 ICS 4225LAIF3 crashes intermittently with MsgID 11056 - could not delete object

ADK fixes

37590 2.4.0 framework fails converting XML message

43926 Connector and tool require to put CHANNEL and PORT when using local MQ binding

47888 Invalid attributes of BO not being replaced

60685 ADK WBIA Framework 2.4 recognizes "mrm" not "MRM"

60690 4.2.2.4 ICS breaks interfaces that Siebel COM Connector uses

61907 Unexpected exception for CwConnector.dll

61985 connector_manager -stopgraceful SAP does not work as documented

62206 Siebel COM Connector is getting failed once in a while

66569 ICS 4.2.2.5 with adapter framework 2.4.0.2 reports version 2.4.0.1 in the adapter log.

66616 can't restart when there is an RFC_ERROR_SYSTEM_FAILURE error

66664 Flooding IDLControllerProxy fatal error : Corba orb connection error

66754 Meaning of MsgID: 165

70797 Invalid JMS type message needs to be clearer

70841 ADK HTTP Adapter Out of Memory

70895 Message (MsgID:190) needs to be more meaningful

71311 Siebel adapter hangs if it gets siebel specific application error

71399 Connector agent do not stop polling for events even when the current MQ depth exceeds 90 percent of maximum depth.

71515 After pressing 'q' to exit the Siebel adapter getting Fatal error

71559 Duplicate ObjectEventID

71593 Pause MQ Adapter when ICS fails or is stopped

44817 Adapters can not work in the MAIN_SINGLE_THREADED mode

44851 Adapter cannot be restart by RetryRestartCount for JMS Transport

44794 Adapters which are working on LL AF fail to tstart up without -c parameter.

72342 Call Stack Error while starting Siebel adapter

72403 HTTP Adapter fails after getting incomplete message

72719 Improve reliability of the adminmgr utility by adding retry.

Toolset fixes

35232 - Problem with trace/log files when Locale is French.

44774 - Add "no" option to property XMLNameSpaceFormat.

61492 - BO Probes fail during high volume/concurrent events

70818 - 4.2.2.5 Connector Configurator flattens hierarchical configuration files.

59337 - Wrong title for change DB password dialog.

71141 - Wrong translation in activity editor copies empty BO on populated BO.

71926 - Connector Designer 4225 issues with HTTPConnector 1.0.

71545 - ClearCase plugin for system manager not keeping version history

73174 - In progress events are not being displayed for synchronous collab

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.

Upgrade Instructions

Please read: Upgrade procedure is changed significantly from previous releases

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.6 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 or 4.2.2.5-A then you can simply save these files before installing 4.2.2.6 and restore them after installing 4.2.2.6. There are no changes to these files between WICS 4.2.2.5 and WICS 4.2.2.6 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. 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.

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

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

4. Shut down the InterChange Server if it is running

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

6. 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 4.2.2.5-A then you can simply save CWSharedEnv.sh before installing 4.2.2.6 and restore it after installing 4.2.2.6. There are no changes to this files between WICS 4.2.2.5 and WICS 4.2.2.6 fix packs.

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

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

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

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 (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	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:Solaris:AIX:HP_UX	Replace	./jre/lib/ibmorb.jar	Server
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\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

Additional Discussion

45659 WICS InterChange Server 4.2.2.6 to support AIX 5.3 ML1 or later

Known problems:

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"

Then install WICS fix pack 4.2.2.6 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. 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.