Install the Red Hat OpenShift FTM operators

The cluster administrator can use the Red Hat® OpenShift® Container Platform user interface or the Red Hat OpenShift Container Platform command-line interface to install the FTM operators.

FTM has the following operators.
API operator
This operator installs the custom resource definition (CRD) for FTM. It can be installed only once per cluster.
Controller operator
This operator installs the FTM controller. It must be installed in every namespace that FTM is deployed to.
Important: Do not install an earlier version of the FTM API operator after a later version is installed. Reinstalling the API operator overwrites the existing custom resource definition (CRD), which might adversely affect any existing deployments of FTM on the cluster. If you want to use an earlier version of FTM, install only the IBM Financial Transaction Manager Controller operator for that version.

Install the FTM API operator by using the user interface

Use the following instructions to install the FTM API operator:
  1. Use the Red Hat OpenShift Container Platform user interface to log in to the cluster as an administrator.
  2. Go to the OperatorHub and find the FTM operators. You can type FTM in the filter field to show only the FTM operators.
  3. Select the IBM Financial Transaction Manager operator by clicking it in OperatorHub. Then, click Install to install it.
  4. Select the All namespaces on the cluster option for the installation mode of the operator, select the namespace to use, and select manual for the update approval option. Then, click Install. You can also choose to install this operator into a specific namespace.
  5. View the installed operators on the Red Hat OpenShift Container Platform to confirm that the operator deployed successfully.

Install the FTM controller operator by using the user interface

Use the following instructions to install the FTM controller operator:
  1. Use the Red Hat OpenShift Container Platform user interface to log in to the cluster as an administrator.
  2. Go to the OperatorHub and find the FTM operators. You can type FTM in the filter field to show only the FTM operators.
  3. Select the IBM Financial Transaction Manager Controller operator by clicking it in OperatorHub. Then, click Install to install it.
  4. Select the A specific namespace on the cluster option for the installation mode of the operator, select the namespace to use, and select manual for the update approval option. Then, click Install.
  5. View the installed operators on the Red Hat OpenShift Container Platform to confirm that the operator deployed successfully.

Install the FTM operators by using the Red Hat OpenShift Container Platform command-line interface

After you log in to the cluster with the Red Hat OpenShift Container Platform command-line interface, use the following instructions to install the FTM operators on your Red Hat OpenShift Container Platform cluster:
  1. Run the following command to switch to the namespace to use. Replace <namespace> with the appropriate value before you run the command.
    oc project <namespace>
  2. Create an OperatorGroup for the namespace if it does not exist. Replace <namespace> and <operatorgroup_name> with the appropriate values before you run the command.
    oc apply -f - <<EOF
    apiVersion: operators.coreos.com/v1
    kind: OperatorGroup
    metadata:
      name: <operatorgroup_name>
      namespace: <namespace>
    spec:
      targetNamespaces:
      - <namespace>
    EOF
    
  3. Create a subscription object that Red Hat OpenShift Container Platform uses to install the IBM Financial Transaction Manager operator. Replace <ftm-operator-channel-ver> to match the channel for the operator version you want to install. For more information about the channel version to use, see FTM operator versions. Run the following command if you want to create a subscription object to install the operator to your namespace only.
    oc apply -f - <<EOF
    apiVersion: operators.coreos.com/v1alpha1
    kind: Subscription
    metadata:
      name: ibm-ftm-operator-api
    spec:
      channel: <ftm-operator-channel-ver>
      name: ibm-ftm-operator-api
      source: ibm-operator-catalog
      sourceNamespace: openshift-marketplace
      installPlanApproval: Manual
    EOF
    
    Run the following command if you want to create a subscription object to install the operator to all namespaces.
    oc apply -f - <<EOF
    apiVersion: operators.coreos.com/v1alpha1
    kind: Subscription
    metadata:
      name: ibm-ftm-operator-api
      namespace: openshift-operators
    spec:
      channel: <ftm-operator-channel-ver>
      name: ibm-ftm-operator-api
      source: ibm-operator-catalog
      sourceNamespace: openshift-marketplace
      installPlanApproval: Manual
    EOF
    
  4. Create a subscription object that Red Hat OpenShift Container Platform uses to install the IBM Financial Transaction Manager Controller operator. Replace <ftm-operator-channel-ver> to match the channel for the operator version you want to install. For more information about the channel version to use, see FTM operator versions.
    oc apply -f - <<EOF
    apiVersion: operators.coreos.com/v1alpha1
    kind: Subscription
    metadata:
      name: ibm-ftm-operator
    spec:
      channel: <ftm-operator-channel-ver>
      name: ibm-ftm-operator
      source: ibm-operator-catalog
      sourceNamespace: openshift-marketplace
      installPlanApproval: Manual
    EOF
    
  5. Run the following command to verify whether the installation is successful. Replace <ftm-operator-channel-ver> with the appropriate value before you run the command.
    oc get csv/ibm-ftm-operator.<ftm-operator-channel-ver>

FTM operator versions

The following table shows the version information for the FTM operators.
Table 1. Operator deployment information for the versions of FTM
IBM® product version of FTM The deployment information for this version
4.0.6 interim fix 6
  • The channel is v4.4
  • The operand is 4.0.6.0_iFix6
  • The version of the operators is 4.4.6
4.0.6 interim fix 5
  • The channel is v4.4
  • The operand is 4.0.6.0_iFix5
  • The version of the operators is 4.4.5
4.0.6 interim fix 4
  • The channel is v4.4
  • The operand is 4.0.6.0_iFix4
  • The version of the operators is 4.4.4
4.0.6 interim fix 3
  • The channel is v4.4
  • The operand is 4.0.6.0_iFix3
  • The version of the operators is 4.4.3
4.0.6 interim fix 2
  • The channel is v4.4
  • The operand is 4.0.6.0_iFix2
  • The version of the operators is 4.4.2
4.0.6 interim fix 1
  • The channel is v4.4
  • The operand is 4.0.6.0_iFix1
  • The version of the operators is 4.4.1
4.0.6
  • The channel is v4.4
  • The operand is 4.0.6.0
  • The version of the operators is 4.4.0