Chapter 3. Adding the Red Hat Integration - AMQ Interconnect Operator

Procedure

1. In your web browser, navigate to the Software Downloads page for AMQ Interconnect releases.
2. Ensure that the value of the Version drop-down list is set to 1.10.7 and the Releases tab is selected.

3. Next to AMQ Interconnect 1.10.7 Operator Installation and Example Files, click Download.

   Download of the amq-interconnect-operator-1.10.7-ocp-install-examples.zip compressed archive automatically begins.

4. When the download has completed, move the archive to your chosen installation directory. The following example moves the archive to a directory called ~/router/operator.

   $ mkdir ~/router
   $ mv amq-interconnect-operator-1.10.7-ocp-install-examples.zip ~/router

5. In your chosen installation directory, extract the contents of the archive. For example:

   $ cd ~/router
   $ unzip amq-interconnect-operator-1.10.7-ocp-install-examples.zip

6. Switch to the directory that was created when you extracted the archive. For example:

   $ cd operator

7. Log in to OpenShift Container Platform as a cluster administrator. For example:

   $ oc login -u system:admin

8. Specify the project in which you want to install the Operator. You can create a new project or switch to an existing one.

   1. Create a new project:

      $ oc new-project <project-name>

   2. Or, switch to an existing project:

      $ oc project <project-name>

9. Create a service account to use with the Operator.

   $ oc create -f deploy/service_account.yaml

10. Create a role for the Operator.

    $ oc create -f deploy/role.yaml

11. Create a role binding for the Operator. The role binding binds the previously-created service account to the Operator role, based on the names you specified.

    $ oc create -f deploy/role_binding.yaml

Procedure

1. In the OpenShift command-line interface (CLI), log in to OpenShift Container Platform as a cluster administrator. For example:

   $ oc login -u system:admin

2. Switch to the project that you previously prepared for the Operator deployment. For example:

   $ oc project <project-name>

3. Switch to the directory that was created when you previously extracted the Operator installation archive. For example:

   $ cd ~/router/operator/qdr-operator-1.10-ocp-install-examples

4. Deploy the CRD that is included with the Operator. You must install the CRD in your OpenShift cluster before deploying and starting the Operator.

   $ oc create -f deploy/crds/interconnectedcloud_v1alpha1_interconnect_crd.yaml

5. Link the pull secret associated with the account used for authentication in the Red Hat Ecosystem Catalog with the default, deployer, and builder service accounts for your OpenShift project.

   $ oc secrets link --for=pull default <secret-name>
   $ oc secrets link --for=pull deployer <secret-name>
   $ oc secrets link --for=pull builder <secret-name>

   Note

   In OpenShift Container Platform 4.1 or later, you can also use the web console to associate a pull secret with a project in which you want to deploy container images such as the AMQ Interconnect Operator. To do this, click Administration → Service Accounts. Specify the pull secret associated with the account that you use for authentication in the Red Hat Container Registry.

6. Deploy the Operator.

   $ oc create -f deploy/operator.yaml

7. Verify that the Operator is running:

   $ oc get pods -l name=qdr-operator

   If the output does not report the pod is running, use the following command to determine the issue that prevented it from running:

   $ oc describe pod -l name=qdr-operator

8. Verify that the CRD is registered in the cluster and review the CRD details:

   $ oc get crd
   $ oc describe crd interconnects.interconnectedcloud.github.io