Deploy to IBM App Connect Enterprise

Perform the following steps to deploy the application for the given scheme to IBM® App Connect Enterprise.

FTM for Immediate Payments (FTM IP) is deployed as a set of BAR files to one or more Integration Servers belonging to one or more Integration Nodes. The application can be deployed to one Integration Server for test and development. More complex deployments are appropriate to address high transaction rates and high availability production environments.

A new Integration Server for your Immediate Payments deployment can be created by issuing the command
mqsicreateexecutiongroup Integration Node -e Integration Server
The BAR files that need to be deployed fall into the following categories:
  1. FTM Base and Immediate Payments libraries BAR files
  2. Payment Scheme proprietary message schemas
  3. FTM for Immediate Payments application and simulator BAR files
  4. For TCH scheme and connectivity to TCH Real Time Payment System: FTM for Immediate Payments connector BAR file
BAR files can be deployed using either the IBM App Connect Enterprise toolkit or the IBM App Connect Enterprise command line interface as follows:
mqsideploy Integration Node -a barfile -e Integration Server

FTM Base and Immediate Payments libraries BAR files

The FTM Base and Immediate Payments products ships pre-compiled BAR files that contain libraries that are required by the FTM IP IBM App Connect Enterprise message flows. The BAR files require no site specific customizations and can be deployed as is. are provided in the installation folder <ftm_base_installation>/ftm/v3213/run/bar. The following BAR files should be deployed in the given order:

  • For TCH scheme:
    1. <ftm_base_installation>/ftm/v3213/run/bar/FTMCoreLibs.bar
    2. <ftm_base_installation>/ftm/v3213/run/bar/FTMGenericModelLib.bar
    3. <ftm_ip_installation>/ip/v3213/run/bar/FtmIpTchLib.bar
  • For SCT Inst scheme:
    1. <ftm_base_installation>/ftm/v3213/run/bar/FTMCoreLibs.bar
    2. <ftm_base_installation>/ftm/v3213/run/bar/FTMGenericModelLib.bar
    3. <ftm_ip_installation>/ip/v3213/run/bar/FtmIpSctInstLib.bar

Payment Scheme proprietary message schemas

The FtmIpSchemeMsgs.bar file that was created in Create a BAR file for the message library.

FTM for Immediate Payments application and simulator BAR files

  1. Navigate to the FTM IP installation directory and extract
    • FTM IP Scheme Bars from file /ip/v3213/multiplatform/Scheme/FTM_IP_Scheme_WMB_PI.zip
    • FTM IP Scheme Simulator Bars from file /ip/v3213/multiplatform/Scheme/FTM_IP_Scheme_Simulators.zip
    into a new temporary directory, where
    Scheme
    is the scheme used (TCH or SCTInst)
    The BAR files, together with corresponding properties files are found in the following directories:
    • Application BAR files: FTM IP Scheme Bars
    • Simulator BAR files: FTM IP Scheme Simulator Bars
    They are configured with default values for data source (property: dataSource, default value: FTMDB), database schema (property: DB_SCHEMA, default value: FTM) and IBM MQ queue prefixes (properties: *QueueName,*QName_Prefix,..., default values: FXR.IP.*), which can be reviewed in the corresponding properties files.
  2. If the FTM database or IBM MQ queues have been created with different values, the BAR files properties need to be changed. To do this,
    1. Open the extracted properties files with a text editor, change the affected properties so they match the actual datasource, schema and queue prefix values, and save the properties files.
    2. Open an IBM App Connect Enterprise Console window and navigate to the directory where the BAR files have been extracted. For each of the modified properties files filename.properties enter the following command:
      mqsiapplybaroverride -b filename.bar -p filename.properties
  3. Deploy the following application BAR files to the new Integration Server:
    • FtmIpPTW.bar
    • FtmIpMisc.bar
    • FtmIpEPW.bar
  4. If the provided CSM simulator is being used, deploy the following simulator BAR file:
    • FtmIpSimulator.bar

FTM for Immediate Payments TCH connector BAR file

If - instead of the FTM IP TCH simulator - a real connection to the TCH RTPS network is used, deploy <ftm_ip_installation>/ip/v3213/run/bar/FtmIpTchLib.bar as described in chapter TCH Connectivity, section Installation and configuration.