Chapter 5. Installing AMQ Streams from the OperatorHub using the web console

Procedure

1. Navigate in the OpenShift web console to the Home > Projects page and create a project (namespace) for the installation.

   We use a project named amq-streams-kafka in this example.

2. Navigate to the Operators > OperatorHub page.

3. Scroll or type a keyword into the Filter by keyword box to find the Red Hat Integration - AMQ Streams operator.

   The operator is located in the Streaming & Messaging category.

4. Click Red Hat Integration - AMQ Streams to display the operator information.
5. Read the information about the operator and click Install.

6. On the Install Operator page, choose from the following installation and update options:

   • Update Channel: Choose the update channel for the operator.

     • The (default) stable channel contains all the latest updates and releases, including major, minor, and micro releases, which are assumed to be well tested and stable.
     • An amq-streams-X.x channel contains the minor and micro release updates for a major release, where X is the major release version number.
     • An amq-streams-X.Y.x channel contains the micro release updates for a minor release, where X is the major release version number and Y is the minor release version number.

   • Installation Mode: Choose the project you created to install the operator on a specific namespace.

     You can install the AMQ Streams operator to all namespaces in the cluster (the default option) or a specific namespace. We recommend that you dedicate a specific namespace to the Kafka cluster and other AMQ Streams components.

   • Update approval: By default, the AMQ Streams operator is automatically upgraded to the latest AMQ Streams version by the Operator Lifecycle Manager (OLM). Optionally, select Manual if you want to manually approve future upgrades. For more information, see the Operators guide in the OpenShift documentation.

7. Click Install to install the operator to your selected namespace.

   The AMQ Streams operator deploys the Cluster Operator, CRDs, and role-based access control (RBAC) resources to the selected namespace.

8. After the operator is ready for use, navigate to Operators > Installed Operators to verify that the operator has installed to the selected namespace.

   The status will show as Succeeded.

   You can now use the AMQ Streams operator to deploy Kafka components, starting with a Kafka cluster.

Procedure

1. Navigate in the web console to the Operators > Installed Operators page and click Red Hat Integration - AMQ Streams to display the operator details.

   From Provided APIs, you can create instances of Kafka components.

2. Click Create instance under Kafka to create a Kafka instance.

   By default, you’ll create a Kafka cluster called my-cluster with three Kafka broker nodes and three ZooKeeper nodes. The cluster uses ephemeral storage.

3. Click Create to start the installation of Kafka.

   Wait until the status changes to Ready.