In this article we are going to install IBM Cloud Pak For Integration 2020.1.1 on the prepared on the previous steps OpenShift 4.3 cluster. All commands will be executed from a Helpernode machine. As a reminder, the installation includes 10 machines ran in VmWare: 3 Masters based on RHCOS; 5 Workers based on RHEL7.6; 1 Bootstrap; 1 Helpernode for cluster management.
This article describes my own experience. The official documentation is available by the link: https://www.ibm.com/support/knowledgecenter/SSGT7J_20.1/install/install_red_hat.html
Install and configure Docker
Install and run Docker
yum install docker -y
systemctl restart docker && systemctl enable docker
[OPTIONAL] Change docker data directory from /var/lib/docker to /root/storage/docker-data
systemctl stop docker
vi /etc/docker/daemon.json
{
"graph": "/root/storage/docker-data"
}
rsync -aP /var/lib/docker/ /root/storage/docker-data/
mv /var/lib/docker /var/lib/docker.old
systemctl start docker
Docker info will show a new directory in the "Docker Root Dir" field
docker info
rm -rf /var/lib/docker.old
systemctl status docker
Installing IBM Cloud Pak for Integration 2020.1.1
Download ibm-cp-int-2020.1.1-offline.tgz. This manual suggests you have access and rights to download and use required software.
Extract the contents of the archive
tar xvf ibm-cp-int-2020.1.1-offline.tgz
Load the images into Docker. Extracting the images might take a few minutes
tar xf installer_files/cluster/images/common-services-boeblingen-2002-x86_64.tar.gz -O|docker load
Configure: installer_files/cluster/config.yaml
cluster_nodes:
master:
- worker2.ocp01.marukhno.com
proxy:
- worker2.ocp01.marukhno.com
management:
- worker3.ocp01.marukhno.com
<......>
storage_class: ibm-spectrum-scale-csi-lt
<......>
password_rules:
- '(.*)'
default_admin_user: admin
default_admin_password: passw0rd
cluster_nodes section describes which nodes to use for IBM Cloud Pak common services. You can add more nodes there and get more replicas for the common services.
Set password rules and an admin login/password for the IBM Cloud Pak.
Login to OCP using kubeadmin user and a password under ocp4/auth/kubeadmin-password
oc login -u kubeadmin
Change to the installerfiles/cluster/ directory and generate kubeconfig file there:
cd installer_files/cluster/
oc config view --minify=true --flatten=true > kubeconfig
Login to docker
docker login $(oc registry info) -u kubeadmin -p $(oc whoami -t)
Exposing the registry can be required before the command above:
oc patch configs.imageregistry.operator.openshift.io/cluster --patch '{"spec":{"defaultRoute":true}}' --type=merge
Run this command to install IBM Cloud Pak for Integration and redirect output to an install.log file:
docker run -t --net=host -e LICENSE=accept -v $(pwd):/installer/cluster:z -v /var/run:/var/run:z -v /etc/docker:/etc/docker:z --security-opt label:disable ibmcom/icp-inception-amd64:3.2.4 addon -vvv | tee install.log
The installation can take about 3 - 3.5 hours , so grab some coffee and check the output for errors from time to time.
In case of something go wrong try to find out the reason and run the installer again. If nothing helps try to uninstall and install again. In order to uninstall run this command:
docker run -t --net=host -e LICENSE=accept -v $(pwd):/installer/cluster:z -v /var/run:/var/run:z -v /etc/docker:/etc/docker:z --security-opt label:disable ibmcom/icp-inception-amd64:3.2.4 uninstall-with-openshift | tee uninstall.log
After the installation finishes switch to the integration project:
oc project integration
Run this command to find out the URL of IBM Cloud Pak for Integration console:
oc get routes
Open the URL in a browser and login using the credentials you installed in the config.yaml earlier
