Chapter 3. Adding the Red Hat Integration - AMQ Interconnect Operator The Red Hat Integration - 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. The options for installing the Operator are: Section 3.1, "Installing the Operator using the CLI" Section 3.2, "Installing the Operator using the Operator Lifecycle Manager" Note Installing an Operator requires administrator-level privileges for your OpenShift cluster. 3.1. Installing the Operator using the CLI The procedures in this section show how to use the OpenShift command-line interface (CLI) to install and deploy the latest version of the Red Hat Integration - AMQ Interconnect Operator in a given OpenShift project. 3.1.1. Getting the Operator code This procedure shows how to access and prepare the code you need to install the latest version of the Operator for AMQ Interconnect 1.10. Procedure In your web browser, navigate to the Software Downloads page for AMQ Interconnect releases . Ensure that the value of the Version drop-down list is set to 1.10.7 and the Releases tab is selected. 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. 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 . USD mkdir ~/router USD mv amq-interconnect-operator-1.10.7-ocp-install-examples.zip ~/router In your chosen installation directory, extract the contents of the archive. For example: USD cd ~/router USD unzip amq-interconnect-operator-1.10.7-ocp-install-examples.zip Switch to the directory that was created when you extracted the archive. For example: USD cd operator Log in to OpenShift Container Platform as a cluster administrator. For example: USD oc login -u system:admin Specify the project in which you want to install the Operator. You can create a new project or switch to an existing one. Create a new project: USD oc new-project <project-name> Or, switch to an existing project: USD oc project <project-name> Create a service account to use with the Operator. USD oc create -f deploy/service_account.yaml Create a role for the Operator. USD oc create -f deploy/role.yaml 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. USD oc create -f deploy/role_binding.yaml In the procedure that follows, you deploy the Operator in your project. 3.1.2. Deploying the Operator using the CLI The procedure in this section shows how to use the OpenShift command-line interface (CLI) to deploy the latest version of the Operator for AMQ Interconnect 1.10 in your OpenShift project. Prerequisites You must have already prepared your OpenShift project for the Operator deployment. See Section 3.1.1, "Getting the Operator code" . Before you can follow the procedure in this section, you must first complete the steps described in Red Hat Container Registry Authentication . Procedure In the OpenShift command-line interface (CLI), log in to OpenShift Container Platform as a cluster administrator. For example: USD oc login -u system:admin Switch to the project that you previously prepared for the Operator deployment. For example: USD oc project <project-name> Switch to the directory that was created when you previously extracted the Operator installation archive. For example: USD cd ~/router/operator/qdr-operator-1.10-ocp-install-examples Deploy the CRD that is included with the Operator. You must install the CRD in your OpenShift cluster before deploying and starting the Operator. USD oc create -f deploy/crds/interconnectedcloud_v1alpha1_interconnect_crd.yaml 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. USD oc secrets link --for=pull default <secret-name> USD oc secrets link --for=pull deployer <secret-name> USD 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. Deploy the Operator. USD oc create -f deploy/operator.yaml Verify that the Operator is running: USD 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: Verify that the CRD is registered in the cluster and review the CRD details: USD oc get crd USD oc describe crd interconnects.interconnectedcloud.github.io Note It is recommended that you deploy only a single instance of the AMQ Interconnect Operator in a given OpenShift project. Setting the replicas element of your Operator deployment to a value greater than 1 , or deploying the Operator more than once in the same project is not recommended. Additional resources For an alternative method of installing the AMQ Interconnect Operator that uses the OperatorHub graphical interface, see Section 3.2, "Installing the Operator using the Operator Lifecycle Manager" . 3.2. Installing the Operator using the Operator Lifecycle Manager The procedures in this section show how to use the OperatorHub to install and deploy the latest version of the Red Hat Integration - AMQ Interconnect Operator in a given OpenShift project. In OpenShift Container Platform 4.1 and later, the Operator Lifecycle Manager (OLM) helps users install, update, and generally manage the lifecycle of all Operators and their associated services running across their clusters. It is part of the Operator Framework, an open source toolkit designed to manage Kubernetes native applications (Operators) in an effective, automated, and scalable way. Prerequisites Access to an OpenShift Container Platform 4.6, 4.7, 4.8, 4.9 or 4.10 cluster using a cluster-admin account. Red Hat Integration - AMQ Certificate Manager Operator is installed in the OpenShift Container Platform cluster if required. Procedure In the OpenShift Container Platform web console, navigate to Operators OperatorHub . Choose Red Hat Integration - AMQ Interconnect Operator from the list of available Operators, and then click Install . On the Operator Installation page, select the namespace into which you want to install the Operator, and then click Install . The Installed Operators page appears displaying the status of the Operator installation. Verify that the AMQ Interconnect Operator is displayed and wait until the Status changes to Succeeded . If the installation is not successful, troubleshoot the error: Click Red Hat Integration - AMQ Interconnect Operator on the Installed Operators page. Select the Subscription tab and view any failures or errors.

Commands:
mkdir ~/router mv amq-interconnect-operator-1.10.7-ocp-install-examples.zip ~/router
cd ~/router unzip amq-interconnect-operator-1.10.7-ocp-install-examples.zip
cd operator
oc login -u system:admin
oc new-project <project-name>
oc project <project-name>
oc create -f deploy/service_account.yaml
oc create -f deploy/role.yaml
oc create -f deploy/role_binding.yaml
oc login -u system:admin
oc project <project-name>
cd ~/router/operator/qdr-operator-1.10-ocp-install-examples
oc create -f deploy/crds/interconnectedcloud_v1alpha1_interconnect_crd.yaml
oc secrets link --for=pull default <secret-name> oc secrets link --for=pull deployer <secret-name> oc secrets link --for=pull builder <secret-name>
oc create -f deploy/operator.yaml
oc get pods -l name=qdr-operator
oc describe pod -l name=qdr-operator
oc get crd oc describe crd interconnects.interconnectedcloud.github.io