IBM Financial Transaction Manager for SWIFT Services 3.2.4 2021/11/12 Interim Fix (iFix)-001 for FixPack 4 README INFORMATION ================== 1) Corrections for reported problems: APAR PH41830 - MER MX field length limitation APAR PH41780 - Message Validation for MT760 field 49/58 not detecting rule C20 APAR PH41597 - Message Validation for MT057/field 334 incorrect APAR PH40921 - MER does not offer all message types of finplus2021 when creating a message NOTE: This iFix updates the software integrity checksums for the modules changed so that the Software Integrity Checker (SIC) will not report inconsistencies. INSTALL INSTRUCTIONS ==================== 1) Transfer the ZIP file of the interim fix in binary mode to the FTM SWIFT Services installation system. 2) Stop the IBM Integration Bus (IIB). 3) Install the interim fix on top of FixPack 4 (FP4) using IBM Installation Manager. IBM Installation Manager offers different operations for installation and update of products/packages. For more information, refer to the IBM Installation Manager documentation. The following two sections are examples using Wizard Mode (Graphical User Interface/Web) or command line driven installations. 3.1) Using Installation Manager in wizard mode a. Start Installation Manager. b. Add the interim fix zip file to the repository: Go to File > Preferences > Repository > Add repository and enter the path of the interim fix zip file c. Click "Update". d. Select the package group to update with the fix. e. Click "Next". f. Select the fixes to install, and click "Next". g. Review the summary information and click "Update". h. Click Finish. i. Click File > Exit (Web: File > Stop server) to close the Installation manager. 3.2) Working from the command line a. Go to the /eclipse/tools directory. b. Check what is currently installed and get the installation directory. Run the command: ./imcl listInstalledPackages -long |grep com.ibm.ftmswift The leftmost part of the result shows the . c. Run the command: ./imcl install com.ibm.ftmswift.mp.v324.iFix001 -installationDirectory -repositories where: is the installation directory obtained in step 3.2b. is the interim fix zip file, for example: /var/ftmsws_driver/FTM-SWS-MP-V3R2M4_FP4_iFix001.zip If you receive the CRIMA1137W warning when installing, the warning message can safely be ignored. 4) Update file permissions, file ownership and associated group for files that are provided with the interim fix by executing the following commands on the command line: chgrp -R dniadmin /admin chgrp -R dnilpp /run chmod 755 chmod 750 /admin chmod 750 /run chmod -R 755 /iFix where: is the installation directory obtained in step 3.2b. 5) Share the files in the /run, /admin and /iFix directory with your runtime system if the installation system is different from the runtime system. 6) Update Enterprise Applications a. Stop all FTM SWIFT application servers. b. Back up the FTM SWIFT IBM WebSphere Application Server (WAS) profiles. c. Start all FTM SWIFT application servers. d. Update the EAR files for Administration and Operation Facility (AO) and Message Entry and Repair (MER). For example: 1. Start the wsadmin tool, .e.g.: /profiles//bin/wsadmin.sh -user -password -lang jython where: is the WAS installation directory, e.g. /usr/IBM/WebSphere/AppServer is the name of the WAS profile where FTM SWIFT is installed. is the user id of a WAS administrator. is the password of the WAS administrator. 2. Update the enterprise applications, e.g.: AdminApp.update('_FTM_for_SWIFT_AO', 'app', ['-operation', 'update', '-contents', '/admin/appsrv/res/dnp.ado.web.ear', '-update.ignore.new']) AdminApp.update('_FTM_for_SWIFT_MER', 'app', ['-operation', 'update', '-contents', '/admin/appsrv/res/dnq.app.main.ear', '-update.ignore.new']) where: is the name of the FTM SWIFT instance. is the installation directory obtained in step 3.2b. 3. Save the configuration changes: AdminConfig.save() 4. Close wsadmin tool: quit 7) Start the IBM Integration Bus (IIB). FALLBACK INSTRUCTIONS ===================== 1) Stop the IBM Integration Bus (IIB). 2) Uninstall the interim fix using the IBM Installation Manager. The following two sections are examples using Wizard Mode (Graphical User Interface/Web) or command line driven uninstall operation. 2.1) Using Installation Manager in wizard mode a. Start Installation Manager. b. Click "Uninstall". c. Select the interim fix to uninstall. d. Click "Next". e. Review the summary information and click "Uninstall". f. Click Finish. g. Click File > Exit (Web: File > Stop server) to close the Installation manager. 2.2) Working from the command line a. Go to the /eclipse/tools directory. b. Check what is currently installed. Run the command: ./imcl listInstalledPackages -long |grep com.ibm.ftmswift The output includes a line for the installed fix pack and additional lines for installed iFixes. All lines have the format: inst_dir : package_id : name : version Locate the line for the iFix you are going to uninstall and note and . c. Run the command: ./imcl uninstall -installationDirectory where: is the package name of the interim fix, obtained in the previous step. is the installation directory, obtained in the previous step. 3) Update file permissions, file ownership and associated group for files that existed before the interim fix by executing the following commands on the command line: chgrp -R dniadmin /admin chgrp -R dnilpp /run chmod 755 chmod 750 /admin chmod 750 /run chmod -R 755 /iFix 4) Share the files in the /run, /admin and /iFix directory with your runtime system if the installation system is different from the runtime system. 5) Restore Enterprise Applications a. Stop all FTM SWIFT application servers. b. Restore the IBM WebSphere Application Server profile backups. c. Start all FTM SWIFT application servers. 6) Start the IBM Integration Bus (IIB). ------------------------------------------------------------------------------ (C) IBM Corporation 2021