Installation procedure

To install the Digital Payments reference application, do the following steps:
  1. Create the FTM queue manager if it was not created already.
  2. Create the IBM® MQ queues used by the Digital Payments reference application:
    1. Locate the IBM MQ script for the appropriate operating system in the list of installation files in Digital Payments reference application installation files.
    2. Run the following command: 
      runmqsc your_QManager_name < achQueues-CreateReference.txt
      where your_QManager_name is the name of the FTM queue manager.
      Note: The runmqsc command needs to be run from the IBM MQ bin subdirectory.
  3. Create the FTM core database if it was not created already.
    Note: The name of the database and the database schema are needed to proceed with the installation.
  4. Add the FTM runtime Java™ classes and resources to the CLASSPATH environment variable if they were not added already. For more information, see Setting up FTM IBM MQ and IBM App Connect Enterprise resources.
  5. Install the FTM Operations and Administration Console and configure it to use your database. For more information, see Installing the FTM Operations and Administration Console.
    • When you create the JMS queue definition, use the values that are shown in the following table to issue commands to the reference application.
      Table 1. Digital Payments reference application command JMS queue definition
      Field Value
      Provider IBM MQ messaging provider
      Name ftmQACH
      JNDI name jms/ftmq/FTM ACH Reference Application
      Description FTM ACH Reference console queue
      Queue Name FXH.CHO.COMMAND
  6. Create the definitions for the finite state machine and static configuration values in the database.
    1. Locate the database script installation instructions for the appropriate platform (refer to Table 1 in Digital Payments reference application installation files).
    2. Connect to the FTM database and follow the instructions.
  7. To run the Digital Payments reference application flows, deploy the IBM App Connect Enterprise archive file to its own execution group. Use the IBM App Connect Toolkit or IBM MQ Explorer.