IBM(R) Financial Transaction Manager for Check Services Version 2.1.1.8 Readme Readme file for IBM(R) Financial Transaction Manager for Check Services Version 2.1.1.8 Product/Component Release: 2.1 Update Name:FTM Check Fix Pack 8 Fix ID: 2.1.1-FTM-Check-fp0008 Publication Date: 07 October 2014 Last modified date: 29 September 2014 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 Reference Check deployment script templates Copyright and trademark information Document change history ====================================================================== Download location ====================================================================== Download IBM(R) Financial Transaction Manager for Check Services Version 2.1.1.8 from Fix Central at the following location: http://www.ibm.com/eserver/support/fixes/ Search for the Fix ID: 2.1.1-FTM-Check-fp0008 ====================================================================== Prerequisites and co-requisites ====================================================================== Before downloading FTM Check Fix Pack 8, 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 Check Fix Pack 3. - 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 Check Fix Pack 3. This helps to ensure that your system is in a consistent state and that no special fixes are lost. ====================================================================== New Features for this fix pack ====================================================================== Regional Calendaring Support FTM for Check z/OS Database Support ====================================================================== Known issues ====================================================================== Note: There is one fix that will be delivered in the next fixpack to correct the following issues: Running Holdover and then EOD when using a z/OS database creates an error ====================================================================== 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 Check Fix Pack 8, perform the following steps: - Download the fix pack tar file to an appropriate location. - Uncompress the tar file. - If you have encrypted your configuration files then before installing this fix level that includes a JRE upgrade you will need to first decrypt your configuration files. After installing the fix level you can then encrypt the configuration files again. ====================================================================== Installing ====================================================================== ==================================================================== Installing FTM v2.1.1.8 to create a new installation ==================================================================== - Start IBM Installation Manager. Add the location of the repository containing the FTM for Check Services 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 for Check Services installation files to your installation directory: - On the main pane, click Install. - Select IBM Financial Transaction Manager for Check Services 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. ==================================================================== Installing FTM Check Fix Pack 8 to update an existing installation ==================================================================== - Start IBM Installation Manager. Add the location of the repository containing the FTM for Check Services 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 for Check Services installation files to your installation directory: - On the main pane, click Update. - Select IBM Financial Transaction Manager for Check Services 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: This fix level does require a database migration - If you have a prior version of FTM Check installed please see the various PFTmigration documents under the various component db2/doc folders for instructions of how to migrate forward your FTM for Check tables that reside in the FTM database to this most recent level. These docs will be located in appropriate operating system sub-folders under these component folders (if applicable) Base\db2 BillServices\db2 BusinessRules\db2 Distribution\engine\db2 Distribution\console\db2 Gateway\db2 Gateway\console\db2 ITS\db2 ITS\console\db2 PaymentRepair\engine\db2 PaymentRepair\console\db2 Settlement\engine\db2 Settlement\console\db2 TCR\emgine\db2 TCR\console\db2 Check\db2 - Application Migration: - Install will overlay the J2SE applications so no special migration instructions are needed. Restarting those applications will update them with the fixes. - Follow the WAS update procedure called out in the various components affected by this fix level. See the list of fixes to see which components were affected. Under each affected component directory structure you'll find a folder ..\doc\updates that contains documents that instruct user how to perform this migration. ==================================================================== Performing the necessary tasks after installation ==================================================================== Verify the correct build information. The build information for 2.1.1.8 is Bld2014mmdd-xxxx ====================================================================== Uninstalling if necessary ====================================================================== To rollback to the previous version of FTM for Check Services: - Start Installation manager - Click Roll Back. - Select the Package Group name where FTM for Check Services is installed. Database: N/A for this fix level ====================================================================== List of fixes ====================================================================== Fixes included in FTM for Check v2.1.1.8 http://www.ibm.com/support/docview.wss?uid=swg21685728 ====================================================================== Reference Check deployment script templates ====================================================================== Reference deployment script templates have been added to this release. These are example scripts that can be used as templates for building customized IBM Financial Transaction Manager for Check (FTM) deployment session scripts used by the FTM Deployment Utility. The scripts are supplied in both Windows batch and Unix shell formats. The scripts are located in the {product install root}/DeploymentUtility/utilities directory Windows: Reference_Check_DB2_deployment_script.bat Windows: Reference_Check_WAS_deployment_script.bat Unix: Reference_Check_WAS_deployment_script.sh Edit the scripts to work with your specific installation and environment. Remove any script calls that may not be relevant for your configuration. The following parameter values are passed into the scripts from the command line and are needed for your custom environment: FTM_HOME_PATH - The FTM for Payments home installation directory (full path) Use quotes if there are spaces in the path. Example: "C:\Program Files (x86)\IBM\ftmPaymentsv211" FTM_TOKENS_FILE_PATH - The custom parameter token file previously created (full path) Use quotes if there are spaces in the path. Example: "C:\Program Files (x86)\IBM\ftmPaymentsv211\DeploymentUtility\deploymentTokens.txt" Examples: Reference_Check_WAS_deployment_script.sh {value for FTM_HOME_PATH} {value for FTM_TOKENS_FILE_PATH} Reference_Check_WAS_deployment_script.bat {value for FTM_HOME_PATH} {value for FTM_TOKENS_FILE_PATH} Reference_Check_DB2_deployment_script.bat {value for FTM_HOME_PATH} {value for FTM_TOKENS_FILE_PATH} Important Note for Windows deployment: After deploying the Check databases, you must run the DSU import tool: {value for FTM_HOME_PATH}\Base\importexport\cmd\DSU.bat before deploying the Check WAS applications. ====================================================================== 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 | +--------------------+------------------------------------------------+ | 07 October 2014 | Original publication date | +--------------------+------------------------------------------------+