Installing the z/OS Cloud Broker Operator

Before you begin

• Ensure that you meet all of the z/OS Cloud Broker prerequisites.
• Ensure that you have completed the preparation steps:
  • If you're installing z/OS Cloud Broker in an online environment, see Preparing to install online.
  • If you're installing z/OS Cloud Broker in an offline (air gap) environment, see Preparing to install z/OS Cloud Broker offline.
• You also need to log in to OpenShift Container Platform with your cluster-admin user role. If you are another role, you need to ask a cluster-admin role user to grant you the access or add you to an existing group that has cluster-admin privileges. Only a cluster-admin role user can grant other users the cluster-admin access. For more information about how to add role-based access control (RBAC) to a user, see Granting role-based access control (RBAC) authorization.

Procedure

1. Log in to the Red Hat OpenShift Container Platform web console for your cluster using your cluster-admin credentials. (See Logging in to Red Hat OpenShift Container Platform.)

2. In the navigation pane, select Operators > OperatorHub.

   

3. From the Projects drop-down list, select the project/namespace you created during completion of the IBM Z & Cloud Modernization Stack preparing to install steps.

   
   Or, if you did not create a project/namespace, create one and then select it by completing the following steps:

   1. Within the Projects drop-down list, select Create Project.

   2. In the Create Project window, enter a name for your project/namespace in the Name field. The name must consist of lowercase alphanumeric characters or '-' and must start and end with an alphanumeric character (e.g. 'my-name' or '123-abc').
      
      

   3. Select Create.

   4. If not auto-selected, select the newly created project/namespace from the Projects drop-down list.

4. On the OperatorHub page, in the All Items field, search for Cloud Broker and then select the IBM® z/OS® Cloud Broker tile.
   
   

5. Select Install.
   
   

6. On the Install Operator page, complete the fields as follows:
   
   

   • Update Channel: Select an update channel. When an update is available for the channel that you select, the z/OS Cloud Broker Operator automatically receives the updates when your cluster is connected to the internet. The update that is received is then processed according to the selection that you make for the Update approval option. Channels are tied to a minor version of z/OS Cloud Broker to ensure that an explicit decision is made to upgrade to the next minor version of z/OS Cloud Broker. For example, the z/OS Cloud Broker 2.1.x channel will never include an upgrade to z/OS Cloud Broker 2.2.x.
   • Version: Select a version for the z/OS Cloud Broker Operator.
   • Installation Mode: For the z/OS Cloud Broker Operator, the All namespaces on the cluster option is disabled and the A specific namespace on the cluster option is selected by default.
   • Installed Namespace: Select or create a namespace in which the operator is installed.
   • Update approval: Select Automatic (the default) so that the running instance of your operator will be automatically updated whenever new updates are made available to the channel and when our cluster is connected to the internet. Note that the z/OS Cloud Broker Operator and any installed suboperators only support the automatic update strategy in Red Hat® OpenShift® Container Platform.

7. Select Install.

Note: Once installation of the z/OS Cloud Broker Operator is initiated, a number of automated actions related to the integration and setup of IBM License Service for license usage data gathering and tracking take place. For more information, see Tracking z/OS Cloud Broker license usage - Setup.

Procedure results

After the z/OS Cloud Broker Operator is installed, an installation success message is displayed, and it is visible on the "Installed Operators" page with a status of Succeeded.

Next step

Create a z/OS Cloud Broker instance by creating an instance of the ZosCloudBroker custom resource (CR). For more information, see Creating a z/OS Cloud Broker instance.