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.
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-adminaccount.
Procedure
-
In the OpenShift Container Platform web console, navigate to
. -
Choose
AMQ Certificate Manager Operatorfrom the list of available Operators, and then click . On the Create Operator Subscription page, accept all of the defaults, and then click .
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.
Switch to the
page, and then switch to the openshift-operatorsproject.The
AMQ Certificate Manager Operatorshould be displayed with a status of InstallSucceeded.If the installation is not successful, troubleshoot the error:
-
Switch to the
page and inspect the Operator Subscriptions and Install Plans tabs for any failures or errors in Status. -
Switch to the
page and check the logs in any Pods that are reporting issues.
-
Switch to the
Additional resources
-
For more information about
cert-manager, see the cert-manager documentation.
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-adminaccount. - AMQ Certificate Manager Operator is installed in the OpenShift Container Platform cluster.
Procedure
-
In the OpenShift Container Platform web console, navigate to
. -
Choose
AMQ Interconnect Operatorfrom the list of available Operators, and then click . On the Create Operator Subscription page, select the namespace into which you want to install the Operator, and then click .
The Subscription Overview page appears displaying the status of the Operator installation.
-
Switch to the
page, and verify that the AMQ Interconnect Operator is displayed and its Status is InstallSucceeded. If the installation is not successful, troubleshoot the error:
-
Switch to the
page and inspect the Operator Subscriptions and Install Plans tabs for any failures or errors in Status. -
Switch to the
page and check the logs in any Pods that are reporting issues.
-
Switch to the
