IBM(R) Financial Transaction Manager for Multiplatform Version 2.1.0.1 Readme Readme file for IBM(R) Financial Transaction Manager for Multiplatform Version 2.1.0.1 Product/Component Release: 2.1 Update Name:Fix Pack 1 Fix ID: 2.1.0-FTM-MP-fp0001 Publication Date: 29 January 2014 Last modified date: Online version of the readme file: www.ibm.com/software/industry/financial-transaction-manager/support/ Important: The most current version of the readme file can always be found online. ====================================================================== Contents: Download location Prerequisites and co-requisites Known Issues Installation information Prior to installation Installing Performing the necessary tasks after installation Uninstalling if necessary List of fixes Copyright and trademark information Document change history ====================================================================== Download location ====================================================================== Download IBM(R) Financial Transaction Manager for Multiplatform Version 2.1.0.1 from Fix Central at the following location: http://www.ibm.com/eserver/support/fixes/ Search for the Fix ID: 2.1.0-FTM-MP-fp0001 ====================================================================== Prerequisites and co-requisites ====================================================================== Before downloading FTM v2.1.0.1, perform the following steps: - Ensure that your system meets all of the system requirements: http://www.ibm.com/software/industry/financial-transaction-manager/requirements This action prevents technical problems that might occur after the installation and configuration of the fix pack. - Review the Flashes and open Authorized Problem Analysis Reports (APARs) on the Financial Transaction Manager product support Web site: http://www.ibm.com/software/industry/financial-transaction-manager/support Open APARs describe defects that are not yet addressed in a fix pack, and they might contain workarounds that will impact your use of FTM v2.1.0.1. - Read the "Known issues" section of this readme. - You need to have a file system with 200MB of free space to contain the uncompressed installation image. Ensure that you have the free space required to install the fix pack. - If you already have an FTM product installed and have obtained special fixes, contact IBM(R) support to determine whether you need an updated version of the fixes before you install FTM v2.1.0.1. This helps to ensure that your system is in a consistent state and that no special fixes are lost. ====================================================================== Known issues ====================================================================== No known issues at this time. ====================================================================== Installation information ====================================================================== Before proceeding with the installation process, view the online version of this readme file to check if information has changed since the readme file was downloaded: http://www.ibm.com/software/industry/financial-transaction-manager/support ==================================================================== Prior to installation ==================================================================== Before installing FTM v2.1.0.1, perform the following steps: - Download the fix pack tar file to an appropriate location. - Uncompress the tar file. ====================================================================== Installing ====================================================================== ==================================================================== Installing FTM v2.1.0.1 to create a new installation ==================================================================== - Start IBM Installation Manager. Add the location of the repository containing the FTM installation package: - Select File->Preferences. - Click Add Repository. - Browse to the directory containing the repository and select the file repository.config (if you are using a directory) or diskTag.inf (if you are using the installation CD) - Click Test Connections and click OK. - Click OK. - Transfer the FTM installation files to your installation directory: - On the main pane, click Install. - Select IBM Financial Transaction Manager for Multiplatforms and click Next. - Review the license agreements and click Next if appropriate. - On the first Install Packages pane, specify the shared resources directory of the Installation Manager and click Next. - On the second Install Packages pane, specify the installation directory (you must have write access to the directory) and click Next. - On the third Install Packages pane, do not change the selected features and click Next. - On the Install package summary information pane, click Install. - After installation is complete, click Finish. Follow the instructions in the "Installing" section of the "FTM for Multiplatforms V2.1 Information Center" available on the FTM Product website at http://www.ibm.com/software/industry/financial-transaction-manager/ ==================================================================== Installing FTM v2.1.0.1 to update an existing installation ==================================================================== - Start IBM Installation Manager. Add the location of the repository containing the FTM installation package: - Select File->Preferences. - Click Add Repository. - Browse to the directory containing the repository and select the file repository.config (if you are using a directory) or diskTag.inf (if you are using the installation CD) - Click Test Connections and click OK. - Click OK. - Transfer the FTM installation files to your installation directory: - On the main pane, click Update. - Select IBM Financial Transaction Manager for Multiplatforms and click Next. - Review the license agreements and click Next if appropriate. - On the first Install Packages pane, specify the shared resources directory of the Installation Manager and click Next. - On the second Install Packages pane, specify the installation directory (you must have write access to the directory) and click Next. - On the third Install Packages pane, do not change the selected features and click Next. - On the Install package summary information pane, click Install. - After installation is complete, click Finish. - Database Migration: The following database changes will be made using the procedures below: - Existing index USGCNT_IX1 on the USAGE_COUNT table has been altered - USAGE_INSTANCE_ID column added. - Existing tables USAGE_COUNT and DEPLOY_INFO set to volatile - Existing index BAT_TMS_IDX onm the BATCH_BASE table has been altered - SEQUENCE column added. - New index BAT_PAR_IDX created on BATCH_BASE with columns : PARENT_BATCH_ID and SEQUENCE. Migration procedures: - Backup the database so that it may be rolled back should there be a problem during or after the migration process - On AIX/Linux for DB2 run the /admin/scripts/db2/migration/2.1.0.1_from_2.1.0.0/Migrate-2_1-Unix.sh script. - On AIX/Linux for Oracle run the /admin/scripts/oracle/migration/2.1.0.1_from_2.1.0.0/Migrate-2_1-Unix.sh script. - On Windows for DB2 run the \multiplatform\FXH_Core_Database_DB2_LUW.zip\database\DB2\LUW\migrate\2.1.0.1_from_2.1.0.0\Migrate-Win.cmd script. - On Windows for Oracle run the \multiplatform\FXH_Core_Database_ORA_LUW.zip\database\Oracle\migrate\2.1.0.1_from_2.1.0.0\Migrate-Unix.sh script. - Application Migration: The following steps must be followed to migrate FTM applications and their runtime environment. - Ensure that the broker is correctly configured to use the JPLUGIN and CLASSES resources in \run - Make a backup of your current WebSphere Message Broker Toolkit workspace. - FTM applications in WebSphere Message Broker Toolkit workspaces must be migrated as follows: - Re-import the following resources, then rebuild and redeploy the applications bar file(s). •Re-import the Core FTM projects (found in the /multiplatform/FXH_Core_Projects_WMB.zip file) into the workspace. •Re-import the FTM Generic Model Actions(found in /multiplatform/FXH_Sample.zip/FXH/samples/Sample App/FXH_Sample_PI.zip file) into the workspace. - OAC Migration: The OAC ear file must be re-deployed to the Websphere Application Server from \multiplatform\FXH_Console.zip - RSA Model Tooling Migration: The following steps must be followed to migrate the FTM Model Tooling and existing FTM Models: •Follow the Installing > Installing the FTM Model Tools package > Installation instructions section in the FTM Infocenter to install the new Model Tooling from /multiplatform/FXH_FSM_Model_Tools.zip •To migrate an existing FTM FSM Model, open the model in RSA. If any migration issues are encountered, a report file in HTML format will be created in the RSA workspace. - Tools Migration: The Usage Reporting Tool, which can be found at /tools/, has been updated. ====================================================================== Uninstalling if necessary ====================================================================== To rollback to the previous version of FTM: - Start Installation manager - Click Roll Back. - Select the Package Group name where FTM is installed. Database: Restore the backup taken during the Database migration step. Application Migration: Revert to the WebSphere Message Broker Toolkit workspace taken during the installation steps. Re-deploy the application bar files. OAC Migration: Re-deploy the OAC ear from the previous version. RSA Model Tooling: Use Installation manager to re-install the previous version of the 'FTM Model Tools'. ====================================================================== List of fixes ====================================================================== Fixes included in FTM for Multiplatform v2.1.0.1 http://www-01.ibm.com/support/docview.wss?uid=swg21661806 ====================================================================== Copyright and trademark information ====================================================================== http://www.ibm.com/legal/copytrade.shtml Notices INTERNATIONAL BUSINESS MACHINES CORPORATION PROVIDES THIS PUBLICATION "AS IS" WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESS OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF NON-INFRINGEMENT, MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE. Some jurisdictions do not allow disclaimer of express or implied warranties in certain transactions, therefore, this statement may not apply to you. This information could include technical inaccuracies or typographical errors. Changes are periodically made to the information herein; these changes will be incorporated in new editions of the publication. IBM may make improvements and/or changes in the product(s) and/or the program(s) described in this publication at any time without notice. Microsoft, Windows, and Windows Server are trademarks of Microsoft Corporation in the United States, other countries, or both. Intel, Intel logo, Intel Inside, Intel Inside logo, Intel Centrino, Intel Centrino logo, Celeron, Intel Xeon, Intel SpeedStep, Itanium, and Pentium are trademarks or registered trademarks of Intel Corporation or its subsidiaries in the United States and other countries. Other company, product, or service names may be trademarks or service marks of others. THIRD-PARTY LICENSE TERMS AND CONDITIONS, NOTICES AND INFORMATION The license agreement for this product refers you to this file for details concerning terms and conditions applicable to third party software code included in this product, and for certain notices and other information IBM must provide to you under its license to certain software code. The relevant terms and conditions, notices and other information are provided or referenced below. Please note that any non-English version of the licenses below is unofficial and is provided to you for your convenience only. The English version of the licenses below, provided as part of the English version of this file, is the official version. Notwithstanding the terms and conditions of any other agreement you may have with IBM or any of its related or affiliated entities (collectively "IBM"), the third party software code identified below are "Excluded Components" and are subject to the following terms and conditions: - the Excluded Components are provided on an "AS IS" basis - IBM DISCLAIMS ANY AND ALL EXPRESS AND IMPLIED WARRANTIES AND CONDITIONS WITH RESPECT TO THE EXCLUDED COMPONENTS, INCLUDING, BUT NOT LIMITED TO, THE WARRANTY OF NON-INFRINGEMENT OR INTERFERENCE AND THE IMPLIED WARRANTIES AND CONDITIONS OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE - IBM will not be liable to you or indemnify you for any claims related to the Excluded Components - IBM will not be liable for any direct, indirect, incidental, special, exemplary, punitive or consequential damages with respect to the Excluded Components. ====================================================================== Document change history ====================================================================== +--------------------+------------------------------------------------+ | Date | Description of change | +--------------------+------------------------------------------------+ | 29 January 2014 | Original publication date | +--------------------+------------------------------------------------+