=============================================================================== = 5742D-9620 IBM WebSphere Business Integration for Financial Networks = = for Multiplatforms Base = = PTF for APAR PK48928 = =============================================================================== Table of contents ----------------- A. How to use this document B. Changes to your current system C. Post-installation D. Steps on a customization system E. Steps on a run-time system F. APARs addressed by this PTF A. How to use this document ---------------------------- You should apply this PTF immediately after installing WebSphere BI for FN and before customizing or migrating your instance. This PTF is required to install the PTF UK26588 for WebSphere BI for FN Extending Features. This document assumes the following: The installation directory of Websphere BI for FN is: /opt/IBM The names of users, groups, files, and directories are the same as those used in the "Planning, Installation and Customization" manual. If you use different values, use those values instead of the values shown here. B. Changes to your current system ---------------------------------- The following files have been changed: /dni_02_02/admin/bin/dniccclt.jar /dni_02_02/admin/bin/dnicdp /dni_02_02/admin/bin/dnicdpm /dni_02_02/admin/bin/dniclcs.sh /dni_02_02/admin/data/* /dni_02_02/admin/win/com.ibm.dni.AccessControl.zip /dni_02_02/admin/win/com.ibm.dni.ElementValidator.zip /dni_02_02/admin/win/com.ibm.dni.MessageAudit.zip /dni_02_02/admin/win/dninigen.cmd /dni_02_02/admin/win/dnininst.jar /dni_02_02/admin/win/dninirf.vbs /dni_02_02/admin/win/dniniws.vbs /dni_02_02/admin/win/dniupdbd.cmd /dni_02_02/admin/win/dniupdbd.jar /dni_02_02/admin/win/dninibak.cmd /dni_02_02/run/bin/dnicli /dni_02_02/run/lib/libdnibip.a /dni_02_02/run/lib/libdnicpshm.a /dni_02_02/run/lib/libdnidata.a /dni_02_02/run/lil/dnievn.lil /dni_02_02/run/lil/dnimfp.lil /dni_02_02/run/lil/dnicnp.lil /dni_02_02/run/msg/* /dni_02_02/run/res/* Before you install the PTF, you should backup the runtime database and changed file. C. Post-installation --------------------- After you have installed the PTF : 1. Share the files with your customization system. 2. Ensure that the group ownership of the /opt/IBM/dni_02_02/admin directory and all subdirectories and files therein is set to group dniadmin. To do this, enter the following commands in a AIX shell: chgrp -R dniadmin /opt/IBM/dni_02_02/admin chgrp -R dnilpp /opt/IBM/dni_02_02/run D. Steps on a customization system ----------------------------------- Restart any Customization Definition Program (CDP) sessions that are active. E. Steps on a run-time system ------------------------------ E1. Transferring the WebSphere BI for FN resources to the WebSphere MB Toolkit workstation - - - - - - - - - - - - - - - - - - - - - - - - - - - - - To prepare the WebSphere BI for FN resources located on the WebSphere MB Toolkit workstation in the following steps, you must have the authority of the WebSphere MB domain administrator (uwbimbd1). The access rights of this user are described in the "Planning, Installation, and Customization" manual in Chapter 1. Planning, in the section "Roles, users, and user groups". To transfer the WebSphere BI for FN resources to a WebSphere MB Toolkit workstation: 1. Log on to the Toolkit workstation. 2. Create a temporary directory to store the files to be transferred from the installation system. 3. Open a Command Prompt window and change to this directory. 4. Transfer, in binary mode, from the installation system to this temporary directory following files: /dni_02_02/admin/win/com.ibm.dni.MessageAudit.zip /dni_02_02/admin/win/com.ibm.dni.AccessControl.zip /dni_02_02/admin/win/com.ibm.dni.ElementValidator.zip /dni_02_02/admin/win/dni* For example, you can use the following File Transfer Program (FTP) commands to transfer the files: ftp bin prompt cd /dni_02_02/admin/win get com.ibm.dni.MessageAudit.zip get com.ibm.dni.AccessControl.zip get com.ibm.dni.ElementValidator.zip cd /dni_02_02/admin/win mget dni* bye E2. Setting the Toolkit version and directories - - - - - - - - - - - - - - - - - - - - - - - - To set the correct environment for the tools used in the subsequent steps follow the instructions in the "Planning, Installation, and Customization" manual in "Chapter 3. Preparing to create an instance", "Preparing the WebSphere MB Toolkit workstation", -> "Setting the Toolkit version and directories" E3. Backing up all WebSphere BI for FN resources installed in a WebSphere MB Toolkit workstation - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - To save the current level of all WebSphere BI for FN resources installed on a WebSphere MB Toolkit: 1. Open a Command Prompt window and change to the temporary directory you used in step E1. 2. Enter the command: dninibak This stores following data into a compressed backup file: - links: all files "com.ibm.dn*.link" from \eclipse\links - WebSphere BI for FN eclipse plugins: all subdirectories of directories "com.ibm.dn*" within - WebSphere BI for FN project directories: all directories of the form "DNI_" within \eclipse\workspace 3. If you do not have Enhanded support for SWIFTNET FileAct feature installed , the following warning might occur after backup command is issued. However,the backup is not affected. DniInfo: No link found for WBI-FN plugins of product feature dnfo in directory . E4. Installing the changed WebSphere BI for FN plug-ins - - - - - - - - - - - - - - - - - - - - - - - - - - - - To install the changed WebSphere BI for FN plug-ins: In the Command Prompt window and from the temporary directory you used in step E1., enter dnininst If the dnininst program issues an error message, check the log file for more information about the reason for the error. To refresh the meta data in the Message Brokers Toolkit: a. Start the Toolkit with the -clean parameter. b. In the Message Brokers Toolkit, open the 'Broker Application Development Perspective'. c. Select all projects with names like "DNI_*", right-click and select 'Refresh', then right-click and select 'Rebuild Project' E5. Preparing BAR files with the updated WebSphere BI for FN flows - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - To activate the changes within the WebSphere BI for FN eclipse plugins all affected message flows need to be deployed to all execution groups on all brokers where they are running. To prepare the broker archive files: a. Ensure the Message Brokers Toolkit is not running. b. In the Command Prompt window and from the temporary directory you used in step E1., enter dniupdbd -prepare -d . -q [-p ] [-h ] where The name of the queue manager to which the WebSphere MB configuration manager (CM) is connected. The port required to connect to the queue manager. The default is 1414. The host address of the machine running the CM. The default is 127.0.0.1 (localhost). This step creates broker archive files containing all WebSphere BI for FN message flows affected by the changes contained in this PTF. c. Check the log file dniupdbd.log to ensure that the files were successfully prepared. E6. Stop and restart all WebSphere BI for FN message brokers - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - Stop and restart the WebSphere BI for FN message brokers, and thereby update the libraries they use. E7. Deploying all affected WebSphere BI for FN message flows - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - To deploy the broker archive files: a. In the Command Prompt window and from the temporary directory you used in step E1. and E5., enter dniupdbd -deploy -q [-p ] [-h ] [-t ] where The name of the queue manager to which the WebSphere MB configuration manager (CM) is connected. The port required to connect to the queue manager. The default is 1414. The host address of the machine running the CM. The default is 127.0.0.1 (localhost). The wait interval for configuration manager and broker response. The default is 600 seconds (10min). This step deploys the broker archive files prepared in step E5. and contained in the current directory to the broker(s). b. Check the log file dniupdbd.log to ensure that the files were successfully deployed. *------------------------------------------------------------------------* * End of Migration * *------------------------------------------------------------------------* F. APARs addressed by this PTF ------------------------------- PK41025 DEPLOY TOOL GETS CLASSCASTEXCEPTION ON MB TOOLKIT 6.0.2 FOR FILEACT RELATED DEPLOYMENT PREPARATION The PTF installation tool to prepare and deploy WebSphere BI for FN message flows has been updated to comply with MB Toolkit API changes. PK44454 INSUFFICIENT JAVAHEAPSIZE DURING MIGRATION TO WBIFN V2.2.0 JAVA.LANG.OUTOFMEMORY ERROR Formerly, when processing large configurations with for instance more than 30 OU's the Customization Definition Program (CDP) ran out of memory. With this PTF the default of 64MB is increased to 256MB. PK48237 MIGRATION UPDATES THE CURRENCY TABLE WITH VERY OLD DATA. Formerly, when migrating to WebSphere BI for FN 2.2 the currency table DNIvSN.DNI_CURRENCY was reloaded with default content and the user data was overwritten. Now migration will not change the contents of the currency table. PK48928 MESSAGE AUDIT NEEDS TO SUPPORT STORAGE OF FUNCTION FOLDER Formerly, the message audit service was not able to store the function folder of a request message. However, certain extensions of WebSphere BI for FN Base do require this. The message audit was enhanced to support this scenario. PK50389 PROVIDE ELEMENT VALIDATION NODE REQUIRED FOR PTF UK26588 The fix for APAR PK48348 for WebSphere BI for FN Extending Features requires to validate XML elements according to their type definitions. This functionality will be introduced. There is a know issue +++ End +++ End +++ End +++ End +++ End +++ End +++ End +++