Installation of Cloud Pak for Applications (Kabanero) for OpenShift 3.11

Winton Huang
3 min readMar 23, 2020

--

This is the blog based on my experience installing Cloud Pak for Application’s Kabanero v3 on OKD v3.11

We need to have the registry key in order to be able to use the entitled registry. Obtain a key from here: https://myibm.ibm.com/products-services/containerlibrary (choose Cloud Pak for Application)

We have to make sure the OKD cluster meets the minimum system requirements to install Cloud Pak for Application.

Step 1 — Prepare your Boot Node

Boot node is any workstation of VM. I use CentOS in this case

1–1 Install Docker

1–2 Install OC cli

Download from https://mirror.openshift.com/pub/openshift-v4/clients/oc/latest/

Step 2 — Extract the installation configuration from the installer image on the entitled registry.

At a command line, run the following commands:

  1. Set the entitled registry information. Run export commands that set ENTITLED_REGISTRY to cp.icr.io, set ENTITLED_REGISTRY_USER to cp, and set ENTITLED_REGISTRY_KEY to the entitlement key that you got from the previous step.
export ENTITLED_REGISTRY=cp.icr.io 
export ENTITLED_REGISTRY_USER=cp
export ENTITLED_REGISTRY_KEY=<apikey>

2. Log in to the entitled registry with the following docker login command:

docker login "$ENTITLED_REGISTRY" -u "$ENTITLED_REGISTRY_USER" -p "$ENTITLED_REGISTRY_KEY"

3. Extract the installation configuration. Run the following commands to create the data directory and extract the configuration files to it.

mkdir data 
docker run -v $PWD/data:/data:z -u 0 -e LICENSE=accept "$ENTITLED_REGISTRY/cp/icpa/icpa-installer:3.0.1.0" cp -r "data/*" /data

4. Review the config files and change if needed

5. Prepare 2 Persistent Volumes

apiVersion: v1
kind: PersistentVolume
metadata:
name: pv0001
spec:
capacity:
storage: 5Gi
accessModes:
- ReadWriteOnce
nfs:
path: /nfs/share
server: 999.999.999.999
persistentVolumeReclaimPolicy: Recycle
storageClassName: managed-nfs-storage

Create the pv

# oc create -f pvnfs.yaml

6. Login to Openshift

oc login -u admin -p admin-password https://openshift-cluster

7. Run the command to check the config

docker run -v ~/.kube:/root/.kube:z -u 0 -t -v $PWD/data:/installer/data:z -e LICENSE=accept -e ENTITLED_REGISTRY -e ENTITLED_REGISTRY_USER -e ENTITLED_REGISTRY_KEY "$ENTITLED_REGISTRY/cp/icpa/icpa-installer:3.0.1.0" check

8. Run the command to install

docker run -v ~/.kube:/root/.kube:z -u 0 -t \
-v $PWD/data:/installer/data:z \
-e LICENSE=accept \
-e ENTITLED_REGISTRY -e ENTITLED_REGISTRY_USER -e ENTITLED_REGISTRY_KEY \
"$ENTITLED_REGISTRY/cp/icpa/icpa-installer:3.0.1.0" install

7. Validate the installation

You will get URLs to access the Cloud Pak Application installed applications. Access the pages to check the applications

Please see https://ibm-cp-applications.okd.999.999.999.999.nip.io to get started and learn more about IBM Cloud Pak for Applications.

The Tekton Dashboard is available at: https://tekton-dashboard-kabanero.okd.999.999.999.999.nip.io.

The IBM Transformation Advisor UI is available at: https://ta.apps.okd.999.999.999.999.nip.io.

The IBM Application Navigator UI is available at: https://kappnav-ui-service-kappnav.okd.999.999.999.999.nip.io.

To check the URLs you may run the following command:

oc get route -n kabanero

References

https://www.ibm.com/support/knowledgecenter/SSCSJL_3.x/install-icpa-cli.html

--

--