Overview

Skill Level: Any Skill Level

The detailed steps to install IBM Cloud Pak for applications v4.0.1 on top of RedHat Openshift Container Platform v4.2 or v4.3 cluster is described here.

Ingredients

RedHat Openshift Container Platform v4.2 or v4.3 cluster up and running.

Step-by-step

  1. References

    The GitHub version of this recipe is available in

    https://github.com/GandhiCloudLab/smart-guide/tree/master/CloudPakForApplication/001-cp4a-installation-v401

     

    Knowledge center version is available in

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

     

    Another version of the installation steps are available in

    https://github.ibm.com/IBMCloudPak4Apps/icpa-install

     

  2. Prerequisite for Transformation Advisor

    Cloud Pak for Apps installer, will also install Transformation Advisor.

    The pre-requisite for the Transformation Advisor is available in the below link. Make sure it is done.

    https://github.com/GandhiCloudLab/smart-guide/blob/master/CloudPakForApplication/001-cp4a-installation-v401/TA-Prerequisite-install.md

     

  3. Get the entitlement key

    Note: there is change in the way we get the entitlement key for IBMers and Partners

     

    IBMers
    IBMers can get the entitlement key of the cloud pak for application from the below URL for the internal consumption.

    https://github.ibm.com/CloudpakOpenContent/cloudpak-entitlement

     

     
    Partners
    Partners after you order IBM Cloud Pak for Applications, an entitlement key for the cloud pak software is associated with your MyIBM account.

    Get the entitlement key that is assigned to your ID

    Log in to MyIBM Container Software Library External link icon with the IBMid and password that are associated with the entitled software.

    https://myibm.ibm.com/products-services/containerlibrary

    In the Entitlement keys section, select Copy key to copy the entitlement key to the clipboard.

  4. Extract the installation configuration from the installer image

    1. Replace the <<entitlement_key>> value and run the below export commands to set the entitled registry information.

    Note: there is change in the registry user for IBMers and Partners

     

    IBMers

    export ENTITLED_REGISTRY=cp.icr.io
    export ENTITLED_REGISTRY_USER=ekey
    export ENTITLED_REGISTRY_KEY=<<entitlement_key>>

     

    Partners

    export ENTITLED_REGISTRY=cp.icr.io
    export ENTITLED_REGISTRY_USER=cp
    export ENTITLED_REGISTRY_KEY=<<entitlement_key>>

     

    2. Docker login
    Do the docker login to access the entitled registry by running the below command

    docker login “$ENTITLED_REGISTRY” -u “$ENTITLED_REGISTRY_USER” -p “$ENTITLED_REGISTRY_KEY”

    3. Create data directory
    Create a “data” directory by running the below command

    mkdir data

    4. Extract the installation configuration
    Extract the installation configuration files by running the below command

    docker run -v $PWD/data:/data:z -u 0 \
    -e LICENSE=accept \
    “$ENTITLED_REGISTRY/cp/icpa/icpa-installer:4.0.1” cp -r data/* /data

  5. Login to OCP cluster

    Login to your OCP cluster using the below command. You need to substitute the value for <your_cluster_hostname>.

    oc login https://<your_cluster_hostname> -u <username> -p <password>

  6. Run the installer

    Run the installer using the below command.

    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:4.0.1” install

    It may take more than 20 minutes time to complete the installation. At the end of the installation you will get the necessary URLs to access Kabanero, TA and Tekton.

  7. Troubleshooting

    Refer the GIT Hub version of this recipe.

    https://github.com/GandhiCloudLab/smart-guide/tree/master/CloudPakForApplication/001-cp4a-installation-v401

     

Join The Discussion