IBM Support

Upgrade Information Server 11.7.1.0 Microservices tier to version 11.7.1.4

How To


Summary

This document contains guidance on upgrading Information Server installations with Microservices tier at version 11.7.1.0 to version 11.7.1.4.

Steps

Follow technote 6613951 for general 11.7.1.4 upgrade instructions. The steps described below are additional actions required to be taken that are specific to the scenario of upgrading from version 11.7.1.0 and are NOT required for releases 11.7.1.1 and higher.

Pre-upgrade steps
  1. Upgrade to version 11.7.1.3. This step is required to properly migrate data schemas of certain components.
  2. Check if the file /etc/kubernetes/admin.conf exists on the Microservices tier machine (control plane machine in the case of multi-node setup). If it is missing, run the following command as root user to recreate it: 
    # kubeadm init phase kubeconfig admin
  3. Check if the file /etc/kubernetes/encryption_config.conf exists on the Microservices tier machine (control plane machine in the case of multi-node setup). If it is missing, copy it over as root user using the following command: 
    # cp /etc/kubernetes/pki/encryption_config.conf /etc/kubernetes/
Post-upgrade steps
  1. On the IIS Services tier host, execute the below command to check the iisAdmin property values for keys "com.ibm.iis.events.kafka.truststoreLocation", "com.ibm.iis.events.kafka.truststorePassword" and "com.ibm.iis.events.kafka.ca.pem": 
    # ${isInstallHome}/ASBServer/bin/iisAdmin.sh -d -key com.ibm.iis.events.kafka.truststoreLocation
# ${isInstallHome}/ASBServer/bin/iisAdmin.sh -d -key com.ibm.iis.events.kafka.truststorePassword
# ${isInstallHome}/ASBServer/bin/iisAdmin.sh -d -key com.ibm.iis.events.kafka.ca.pem
    In case any of the above commands returns an empty value, run the below sequence of commands: 
    # cd ${isInstallHome}/jdk
# rm -f ${isInstallHome}/ugHostCert.cer
# rm -f ${isInstallHome}/ug-host-truststore.jks
# kafkacakeystorepassword=pass$(openssl rand -hex 3)
# ./bin/keytool -import -alias ugHostCert -file ${isInstallHome}/kafka_ca.pem -keystore ${isInstallHome}/ug-host-truststore.jks -storepass ${kafkacakeystorepassword} -noprompt
# mkdir -p ${isInstallHome}/Kafka
# chmod 755 ${isInstallHome}/Kafka
# cp ${isInstallHome}/ug-host-truststore.jks ${isInstallHome}/Kafka
# chmod 755 ${isInstallHome}/Kafka/ug-host-truststore.jks
# cd ${isInstallHome}/ASBServer/bin
# ./iisAdmin.sh -set -key com.ibm.iis.events.kafka.truststoreLocation -value ${isInstallHome}/Kafka/ug-host-truststore.jks
# ./iisAdmin.sh -set -key com.ibm.iis.events.kafka.truststorePassword -value $(./encrypt.sh ${kafkacakeystorepassword})
# ./iisAdmin.sh -set -key com.ibm.iis.events.kafka.ca.pem -value $(cat /tmp/kafka_ca.pem | sed '1d' | sed '$d' | tr -d '\n')

Document Location

Worldwide

[{"Type":"MASTER","Line of Business":{"code":"LOB10","label":"Data and AI"},"Business Unit":{"code":"BU059","label":"IBM Software w\/o TPS"},"Product":{"code":"SSZJPZ","label":"IBM InfoSphere Information Server"},"ARM Category":[{"code":"a8m0z0000001i9oAAA","label":"Microservices Tier and Kubernetes Issues"}],"ARM Case Number":"","Platform":[{"code":"PF025","label":"Platform Independent"}],"Version":"11.7.1"}]

Document Information

Modified date:
14 October 2022

UID

ibm16828335

Page Feedback