IBM® WebSphere® Business Services Fabric 6.2.0.2 Fix Pack, Release Notes
4.0 Prerequisites for Fix Pack installation
5.0 Installing the Foundation Pack fix
5.1 Updating the Foundation Pack on multiplatforms. 1
5.2 Updating the Foundation Pack for z/OS
6.0 Installing the Tool Pack fix
7.0 Known limitations, problems, and workarounds. 4
Contacting IBM Software Support
The WebSphere Business Services Fabric 6.2.0.2, Fix Pack supplies updates that improve product quality and stability.
The WebSphere Business Services Fabric 6.2.0.2, Fix Pack contains the executable files that will update the Fabric to version 6.2.0.2.
For the most current WebSphere Business Services Fabric
documentation, visit the
˙ Before installing this Fix Pack, you must have WebSphere Business Services Fabric 6.2.0 installed.
˙ Before installing Foundation Pack Fix Pack 6.2.0.2, you must first install the WebSphere Process Server Fix Pack 6.2.0.2.
˙ Before installing Tool Pack Fix Pack 6.2.0.2, update WebSphere Integration Developer to 6.2.0.2 along with the WebSphere Process Server Unit Test Environment to 6.2.0.2.
The Foundation Pack Fix Pack can be installed on multiplatforms and on z/OS platforms. The instructions for each platform installation follows.
To applying the Foundation Pack Fix Pack to an existing Fabric multiplatform installation:
1) After downloading the Fix Pack, expand the Fix Pack installer for the Foundation Pack.
2) Run the interactive Fix Pack installer. This will update the existing Fabric installation with the required files.
3) All existing Fabric Stand-Alone profiles need to be updated with the new Fabric Enterprise applications using the steps below.
NOTE: In a clustered deployment, you will need to manually uninstall all five enterprise applications using the WebSphere Process Server Administration console or using the wsadmin command. The new Fabric Applications are available at <WPS_HOME>/profileTemplates/dmgr.wbsfabric/actions/scripts/installation/runtime
a) Switch to the <WPS_HOME>/bin folder.
b) Stop the Fabric server, if it is running.
c) Run the following command.
<WPS_HOME>\bin>wsadmin.bat -user <SERVER_USER_ID> -password <SERVER_PASSWORD> -profileName <PROFILE_NAME> -connType NONE -f "<FIXPACK_INSTALL_LOCATION>/script/installFix.py"
4) Enter a user id with admin access when prompted for a userid.
5) Enter the path to the WBSFabric profile template when prompted. The default path is <WPS_HOME>/profileTemplates/WBSFabric. The Fabric Profile is successfully updated to 6.2.0.2 on completion of the script.
To apply the Foundation Pack Fix Pack to an existing Fabric z/OS installation:
1) Download and install the z/OS Foundation Pack PTF (Program Temporary Fix).
2) Replace all the three profile template folders in WPS_HOME/profileTemplates, as follows.
a) <WPS_HOME>/dmgr.wbsfabric with the one from <FP_PTF_HFS>/dmgr.wbsfabric
b) <WPS_HOME>/WBSFabric with the one from <FP_PTF_HFS>/WBSFabric
c) <WPS_HOME>/managed.wbsfabric with the one from <FP_PTF_HFS>/managed.wbsfabric
Where <FP_PTF_HFS> is the location of the z/OS Foundation Pack PTF installation.
3) If you have augmented an existing profile using a WebSphere Business Services Fabric profiles, then reinstall the existing Fabric enterprise applications from the WebSphere Process Sever administrative console by performing the following actions:
a)
Stop the five Fabric applications from Applications >
b) Uninstall all five Fabric applications
c) Reinstall all five new Fabric application ear files from <FP_PFT_HFS>/profileTemplates/WBSFabric/actions/scripts/installation/runtime
4) Stop the server and/or all clusters/nodes/dmgr if they are running.
5) Replace the Fabric plugin com.ibm.ws.fabric.catalog_6.2.0.jar, from <WPS_HOME>/plugins with the one from <FP_PTF_HFS>/WBSFabric/actions/scripts/installation/runtime
6) Replace the five Fabric jars in <WPS_HOME>/lib/ext with the jar files from <FP_PTF_HFS>/WBSFabric/actions/scripts/installation/runtime.
7) Replace the WBSF.product in <WPS_HOME>/properties/version with the jar file from <FP_PTF_HFS>/WBSFabric/actions/scripts/configuration
8) Clean the OSGI cache (Empty the contents of the WPS_PROFILE_HOME/Configuration folder)
9) Start the server and/or all clusters/nodes/dmgr.
NOTE: For clusters, Steps 5 to 8 should be executed in the appropriate HFS for each deployment manager and nodes.
The Fabric Tool Pack 6.2.0.0 can be updated to 6.2.0.2 by using either of two methods.
NOTE: Skip Steps 1 and 4 if method A is the chosen update method.
1) Download and expand the Fix Pack zip file for the Tool Pack to a directory (for example, c:/TPFixpack) from Fix Central.
2) Start Installation Manager. The latest release of IBM Installation Manager will be required, if an older version exists, it will prompt to update Installation Manager.
4) Point the repository preferences to your local update site. (File>Preferences>Repositories> Add Repository> c:/TPFixpack/updatesite/repository.config).
5) Click on the Update button on the Installation Manager screen.
NOTE: If using method A, ensure that “File>Preferences>Repositories>Search Service Repositories during installation and updates” is checked and an active internet connection is available for Installation Manager to connect to the remote update site.
6) In the Update Packages wizard, select the location of the package group where the WebSphere Business Services Fabric Tool Pack product package you want to update is installed or select the Update All and then click Next. The Installation Manager searches for updates in its repositories and the predefined update sites for WebSphere Business Services Fabric Tool Pack.
7) In the Update Packages, select Version 6.2.0.2 of IBM WebSphere Business Services Fabric Tool Pack 6.2.0.0.
8) On the Licenses page, read the license agreements for the selected updates.
a. If you agree to the terms of the entire license agreements, click I accept the terms of the license agreements.
b. Click Next to continue.
9) IBM WebSphere Business Services Fabric Tool Pack 6.2.0.2 is displayed as selected in the Features list on the Update Packages Features page.
10) The feature list will display three options to choose from:
a. “Files Only” copies the relevant files to the WID_HOME/wbsftp directory; it also updates the WebSphere Process Server base install with the required Fabric configuration.
b. “Install Composition Studio” updates the WebSphere Integration Developer Composition Studio installed by Tool Pack 6.2.0.0.
c. “Unit Test Environment” only updates the unit test environment created by the Tool Pack 6.2.0.0 Installer. If there is no such profile, choosing this option will create a new profile and update it to 6.2.0.2. For updating a Profile not created by the Tool Pack 6.2.0.0 Installer install the Fix Pack after unselecting this option. Finish the installation and then follow the steps in the following note.
NOTE: To update an UTE profile not created by the Tool Pack 6.2.0.0 installer, for instance a WDPE Client Install profile, you need to run the installFix script to update the WDPE Profile with the latest Fabric applications, The installFix interactive script is located at WID_HOME/wbsftp/update6201 and can be run by using the following command:
< WID_HOME >/runtimes/bi_v62/bin>wsadmin.bat -user <SERVER_USER_ID> -password <SERVER_PASSWORD> -profileName <ProfileName> -connType NONE -f "< WID_HOME >/wbsftp/update6201/installFix.py"
a) Enter a user id with admin access when prompted for a userid.
b)
Enter the path to the WBSFabric profile template when prompted.
This path will be <
WID_HOME >/runtimes/bi_v62/profileTemplates/WBSFabric
c) When the script completes, your profile will be updated with the Fix Pack.
11) On the Summary page, click Update to download and install the updates.
12) Optional: When the update completes, a message confirms the success of the updates. Click View log file to open the log file for the current session in a new window. You must close the Installation Log window to continue.
13) Click Finish to close the wizard.
NOTE: The Tool Pack Fix Pack does not support rollback of the Fabric Unit Test Environment feature.
Consult the Technical Notes section of the Fabric Support site for all known limitations and resolutions.
If you encounter a problem with this product, first try the following actions:
If you cannot resolve your problem by any of the preceding methods, contact IBM Technical Support.
Purchase of IBM WebSphere Application Server entitles you to one year of telephone support under the Passport Advantage® program. For details about Passport Advantage, visit the Passport Advantage® page.
The number for Passport Advantage members to call for WebSphere Application Server support is 1-800-426-7378. Have the following information available when you call: