Chapter 2. Installing the AMQ Interconnect Operator

You use OperatorHub to add the following Operators to your OpenShift Container Platform cluster:

AMQ Certificate Manager Operator
A Kubernetes add-on that generates the TLS certificates used by the AMQ Interconnect Operator. This Operator must be installed once for the OpenShift Container Platform cluster. When installed, it is available to all users and projects in the cluster.
AMQ Interconnect Operator
The Operator for deploying AMQ Interconnect router networks. This Operator must be installed separately for each project that uses it.
Note

Installing an Operator requires administrator-level privileges for your OpenShift cluster.

2.1. Adding the AMQ Certificate Manager Operator

The AMQ Certificate Manager Operator (cert-manager) is a Kubernetes add-on that issues and manages TLS certificates. The AMQ Interconnect Operator uses it to automatically create the TLS certificates needed to secure the router network.

The AMQ Certificate Manager Operator must be installed once for the OpenShift Container Platform cluster. When installed, it is available to all users and projects in the cluster.

Prerequisites

  • Access to an OpenShift Container Platform 4.1 cluster using a cluster-admin account.

Procedure

  1. In the OpenShift Container Platform web console, navigate to CatalogOperatorHub.
  2. Choose AMQ Certificate Manager Operator from the list of available Operators, and then click Install.
  3. On the Create Operator Subscription page, accept all of the defaults, and then click Subscribe.

    This makes the Operator available to all users and projects that use this OpenShift cluster. The Subscription Overview page appears displaying the status of the Operator installation.

  4. Switch to the CatalogInstalled Operators page, and then switch to the openshift-operators project.

    The AMQ Certificate Manager Operator should be displayed with a status of InstallSucceeded.

  5. If the installation is not successful, troubleshoot the error:

    1. Switch to the CatalogOperator Management page and inspect the Operator Subscriptions and Install Plans tabs for any failures or errors in Status.
    2. Switch to the WorkloadsPods page and check the logs in any Pods that are reporting issues.

Additional resources

2.2. Adding the AMQ Interconnect Operator

The AMQ Interconnect Operator creates and manages AMQ Interconnect router networks in OpenShift Container Platform. This Operator must be installed separately for each project that uses it.

Prerequisites

  • Access to an OpenShift Container Platform 4.1 cluster using a cluster-admin account.
  • AMQ Certificate Manager Operator is installed in the OpenShift Container Platform cluster.

Procedure

  1. In the OpenShift Container Platform web console, navigate to CatalogOperatorHub.
  2. Choose AMQ Interconnect Operator from the list of available Operators, and then click Install.
  3. On the Create Operator Subscription page, select the namespace into which you want to install the Operator, and then click Subscribe.

    The Subscription Overview page appears displaying the status of the Operator installation.

  4. Switch to the CatalogInstalled Operators page, and verify that the AMQ Interconnect Operator is displayed and its Status is InstallSucceeded.
  5. If the installation is not successful, troubleshoot the error:

    1. Switch to the CatalogOperator Management page and inspect the Operator Subscriptions and Install Plans tabs for any failures or errors in Status.
    2. Switch to the WorkloadsPods page and check the logs in any Pods that are reporting issues.