Install IBM Cloud Pak for Integration

Find out how to set up IBM Cloud Pak for Integration on Red Hat Openshift Container Platform 4.12 (OpenShift).

Add the catalog source to OpenShift Cluster

To add the IBM Cloud Pak for Integration operator under the OperatorHub, you need to add the Catalog Source to your OpenShift cluster.

In the OpenShift cluster, create a dedicated project for the IBM Cloud Pak for Integration installation in the OpenShift cluster. For this use-case, the project name is cloudpack4integration.
Make sure you have cluster administrator role to perform the setup.

Copy the Catalog Source to a file called catalog.yaml on your bastion server:

apiVersion: operators.coreos.com/v1alpha1
kind: CatalogSource
metadata:
name: ibm-operator-catalog
namespace: openshift-marketplace
annotations:
   olm.catalogImageTemplate: "icr.io/cpopen/ibm-operator-catalog:v{kube_major_version}.{kube_minor_version}"
spec:
displayName: IBM Operator Catalog
publisher: IBM
sourceType: grpc
image: icr.io/cpopen/ibm-operator-catalog:latest
updateStrategy:
   registryPoll:
      interval: 45m

Run this command:

oc apply -f catalog.yaml

Output:

catalogsource.operators.coreos.com/ibm-operator-catalog created

Note: To check the status of the ibm-operator-catalog pods, run this command and make sure ibm-operator-catalog-xxxx is running.

oc get pods -n openshift-marketplace

Output:

NAME                                                              READY   STATUS      RESTARTS   AGE
ibm-operator-catalog-xxxx                                         1/1     Running     0          61s

Note: For more information about adding Catalog Source, refer to Adding catalog sources to a cluster

Install the Cloud Pak for Integration Operator

After the Catalog source has been successfully added, proceed with the following steps in the OpenShift web console.

Under OperatorHub, search for CP4I to find IBM Cloud Pak for Integration.
Select installation mode > A specific namespace on the cluster. Under Installed Namespace, select cloudpack4integration, then proceed with the installation.
Verify the installation. cloudpack4integration has a status of success and is listed under the Installed Operators.

Add the entitlement key

The IBM entitlement key allows operators to pull software images automatically that are related to IBM Cloud Pak for Integration.

Follow this link to set up the entitlement key: Finding and applying your entitlement key by using the UI (online installation).

Install the platform UI

Note: As a prerequisite, make sure that the entitlement key is added to the namespace cloudpack4integration.

Note: From the drop-down menu, make sure you have switched into the project cloudpack4integration.

Select Operators > Installed Operators > IBM Cloud Pak for Integration > Platform UI.
Select Create PlatformNavigator. There are two methods to create the platform UI. One method uses Form view and the other method uses Yaml view. This setup uses Form view.

Form view

In the Name: field, enter the name integration-quickstart.
Click the arrow to expand the Licence. Check the licence checkbox. Select the default licence ID. For more information, refer to Licensing.
Select the Version or leave the default.
Expand Storage and select the storage class that supports ReadWriteMany(RWX). For more information, refer to Storage considerations.
Click Create.

Verify the setup

Make sure the status of the Platform UI is in Ready state.
Select the Cloud Pak for Integration UI and login.
Home Screen view: