Installing the Red Hat Integration Operator on OpenShift

Procedure

1. In the OpenShift Container Platform console, log in using an account with administrator privileges.
2. Navigate to Operators → OperatorHub.
3. Select the Red Hat Integration Operator.
4. Check the Operator details and click Install. The provider type is Red Hat.

5. On the Install Operator page, accept all of the default selections and click Install.

   Note

   The default is to make the Operator available cluster-wide, but you can deploy to a specific namespace, if required.

   The integration-operator details page is displayed, where you can see the Subscription Overview.

6. When the images have downloaded, and the install status is shown as ready to use, click View Operator.

7. Check that status of the ClusterServiceVersion (CSV) details is shown as Succeeded for the namespace or all namespaces.

   The Red Hat Integration Operator is ready for installing Operators for Red Hat Integration components.

Procedure

1. Navigate to Installed Operators and click Red Hat Integration to display the Operator Details page.

2. From Provided APIs, click Create Instance for the Installation resource.

   The full set of Red Hat Integration Operators available for installation is displayed on the Create Installation page.

   All Operators are enabled for installation by default. The default installation mode and namespace where the Operator is installed depends on the Operator. The Operator creates the namespaces. If a namespace is not specified, the openshift-operators namespace is used for cluster-wide installation.

   The configuration for each Operator is encapsulated in the spec property of the Installation custom resource.

   Table 2.1. Default Operator installation modes for Red Hat Integration components

   Operator name	CRD spec property	Default Installation mode	Default namespace
   3scale	3scale-installation	namespace	rhi-3scale
   3scale APIcast	3scale-apicast-installation	namespace	rhi-3scale-apicast
   AMQ Broker	amq-broker-installation	namespace	rhi-amq-broker
   AMQ Interconnect	amq-interconnect-installation	namespace	rhi-amq-interconnect
   AMQ Streams	amq-streams-installation	cluster	openshift-operators
   Camel K	camel-k-installation	cluster	openshift-operators
   (Fuse) API Designer	api-designer-installation	namespace	rhi-api-designer
   Fuse Console	fuse-console-installation	namespace	rhi-fuse-console
   Fuse Online	fuse-online-installation	namespace	rhi-fuse-online
   Service Registry	service-registry-installation	namespace	rhi-service-registry

3. Optional: Configure the installation specification from the form or YAML views before you perform the installation.

   You can:

   • Include or exclude Operators from installation.
   • Change the namespace names specified for the Operators.

   • Switch the camel-k-installation and amq-streams-installation Operators to namespace mode, which then requires a namespace to be specified too.

     Example configuration for the Installation CRD

     # …
     kind: Installation
     spec
       3scale-apicast-installation:
         enabled: false 1
         mode: namespace
         namespace: rhi-3scale-apicast
       amq-streams-installation:
         enabled: true
         mode: namespace 2
         namespace: rhi-streams 3

     1

     Set the enabled property for the Operator to false to exclude the Operator from installation if you do not plan to use the component.

     2

     Set the installation mode to namespace from cluster to specify installation to a specific namespace.

     3

     Add or modify a namespace name to install to.

4. Click Create to start the installation of the enabled Operators.

   Wait until the status changes to Succeeded.

5. Click rhi-installation to check that all enabled Operators have been installed.
6. Navigate to Installed Operators to see the list of installed Operators and the namespaces they were deployed to, as well as their versions.