Installing Cloud Pak for Integration using Operators

• Prerequisites
• OLM Catalog Sources
• Install Platform Navigator
• Installing Capabilities and Runtimes
• Post installation steps

Prerequisites

• OpenShift cluster 4.4.9 or higher
• Administrator access to Openshift console
• IBM Entitlement Registry Key
• Minimum 3 worker nodes with 16 cores and 32gb memory, block and file storage access
• oc command line tool

OLM Catalog Sources

![](images/tutorial_html_2e43fe0eb354ddda.png)

The login command using a token looks like below (your token and cluster
address will be different)
Copy to clipboardCopied!

oc login --token=19P1E8JTTT307A4DpncdR-WNYTCCeTF0OiPFx5UJirw
--server=https://c104-e.us-east.containers.cloud.ibm.com:30339
Copy to clipboardCopied!

2. Add the IBM Common Services operators to the list of installable operators by running the following command:

oc apply -f - << EOF
apiVersion: operators.coreos.com/v1alpha1
kind: CatalogSource
metadata:
  name: opencloud-operators
  namespace: openshift-marketplace
spec:
  displayName: IBMCS Operators
  publisher: IBM        
Copy to clipboardCopied!
Show more

3. Add the IBM operators to the list of installable operators by running the following command:

oc apply -f - << EOF
apiVersion: operators.coreos.com/v1alpha1
kind: CatalogSource
metadata:
  name: ibm-operator-catalog
  namespace: openshift-marketplace
spec:
  displayName: ibm-operator-catalog 
  publisher: IBM Content
Copy to clipboardCopied!
Show more

Install Platform Navigator

1. Get your entitlement key from the Container Library

2. Create a namespace for Platform Navigator

oc new-project cp4i
Copy to clipboardCopied!

3. Create an entitlement secret using the entitlement key from step-1.

oc create secret docker-registry ibm-entitlement-key \
    --docker-username=cp \
    --docker-password=<entitlement-key> \
    --docker-server=cp.icr.io \
    --namespace=<target namespace>
Copy to clipboardCopied!

4. Deply Platform Navigator using the Red Hat OpenShift web console. Go to OperarorHub and look for Platform Navigator

   

5. Select Install to install Platform Navigator.

   

6. Add Operator Subscription. The new subscription can be added for a specific namespace or all namespaces. Select cp4i for namesace.

   

7. When you add Platform Navigator, Deployment Lifecycle Manager and Common Services Operators are also installed. Select Platform Navigator to create an instance.

   

8. Click on Create Platform Navigator to create an instance.

   

9. Accept license and select Create.

   

10. When platform navigator and dependent services are successfully installed. You can obtain admin password by running the following command.

oc get secrets -n ibm-common-services platform-auth-idp-credentials -ojsonpath='{.data.admin_password}' | base64 --decode && echo "" 
Copy to clipboardCopied!

oc get route -n cp4i -ojsonpath='{.items[0].spec.host}'
Copy to clipboardCopied!

11. Open the URI in a browser and login using admin and \<password> using Default authentication option.

    

Installing Capabilities and Runtimes

1. Initially when Platform Navigator is installed the Capabilities and Runtimes will be blank. You can add Cloud Pak capabilities and Runtimes using Plaform Navigator or Openshift web console..

   

   Make sure you subscribe to the capabilities from Operator Hub prior to creating instances, otherwise you will see a message similar to below.

   

2. Add Operations Dashboard capability

   

3. Add Asset Repository capability

   

4. Add App Connect Dashboard capability

   

5. Add AppConnect Designer capability

   

6. Add API Connect capability

   

7. Select Runtimes tab and add EventStreams runtime by selecting Kafka cluster

   

8. Add an MQ Queue Manager runtime. Select Availability type, Tracing, Persistence as needed. Choose default values for quick installation.

   

9. Add highspeed file transfer capability

   

10. When all the capabilities and runtimes are installed, the Cloud Pak web console menu displays the instances (the name of you instances may be different from what is shown here).

    

Post installation steps

1. If you enabled Tracing capabilities for API Connect and MQ, capabilities must be registered from Operations Dashbard Setting tab. Follow the instructions from here.

2. Setup notification, create provider organization, add catalogs and portal server as API admin.

• Manage authentication and security by creating user registries to control access to API Connect

• Setup notifications by adding an SMTP server

• Create provider organizations to manage teams that develop and manage APIs and related assets