Upgrading Local Edition Cluster from 5.5.0 to 5.5.1 for Kubernetes in Tethered Mode

The following section provides information on upgrading Local Edition cluster from version 5.5.0 to 5.5.1 for Kubernetes in Tethered mode.

Prerequisites

  • Local Edition 5.5.1 images must be built and pushed to the desired registry for deployment.
  • The volumes for tml-nosql, tml-log, and tml-cache are reused, so while doing upgrade the number of these pods must be consistent with the earlier version.
  • The customization done to the JSON properties files at docker-deploy/properties/*.json in earlier version must be ported to 5.5.1.
  • Admin must generate the manifest deployment folder, namely the manifest-single-zone, as per the deployment topology for version 5.5.1 by running the compose command.
Note:
  • The following procedure is applicable for single and multi zone clusters.
  • Some traffic disruptions are expected during upgrade. To minimize disruptions, upgrade theLocal Edition components sequentially, explained as follows.

Procedure

  1. Undeploy and redeploy NoSQL components.
    1. To remove running Local Edition 5.5.0 NoSQL container, run the following command. 
      ./undeploy-nosql-pod.sh
    2. To deploy Local Edition 5.5.1 NoSQL containers, run the following command. 
      ./deploy-nosql-pod.sh
  2. To undeploy and redeploy Log components:
    1. To remove running Local Edition 5.5.0 Log container, run the following command. 
      ./undeploy-log-pod.sh
    2. To deploy Local Edition 5.5.1 Log containers, run the following command. 
      ./deploy-log-pod.sh
  3. To undeploy and redeploy CM components:
    1. To remove running Local Edition 5.5.0 CM container, run the following command. 
      ./undeploy-cm-pod.sh
    2. To deploy Local Edition 5.5.0 CM containers, run the following command. 
      ./deploy-cm-pod.sh
  4. Undeploy and redeploy SQL components.

    The MySQL Certificate/Identity data migration for tethered mode works for the following migration case:

    5.5.0 to 5.5.1

    Complete the Certificate or Identity data migration as soon as the new cluster is deployed, otherwise new certificates or identities created in the new cluster is overwritten by data migration.

    1. To dump MySQL data from the cluster created in the earlier version, login to any tml-sql pod running in the earlier cluster. 
      kubectl exec mysql-set-0-0 -- mysqldump --no-create-info --complete-insert --single-transaction -u root -p'changeme' masherysolar trust_store identity_store > mash_data.sql
      1. To remove the SQL container from the 5.5.0 cluster for single zone deployment, run the following command: 
        ./undeploy-sql-pod.sh
      2. Delete SQL pvc after undeploying the SQL pod: 
        kubectl delete pvc $(kubectl get pvc -o=jsonpath='{.items[?(@.metadata.labels.app=="mysql-svc")].metadata.name}')
      3. To deploy Local Edition 5.5.1 SQL containers for single zone deployment, run the following command. 
        ./deploy-sql-pod.sh
    2. Copy the MySQL data fromLocal Edition 5.5.0 cluster to the Local Edition5.5.1 cluster.
      To copy MySQL data file to any tml-sql pod in Local Edition 5.5.0 cluster 
      kubectl cp mash_data.sql mysql-set-0-0:/tmp
      Note: The mysql-set-0-0 is thetml-sql pod in the new cluster.
    3. Import MySQL data dumped from Local Edition 5.5.0 cluster to Local Edition 5.5.1 cluster. Run the following command in each tml-sql pod in the new cluster. 
      mysql -u root -p'changeme' -e "truncate table masherysolar.trust_store"
mysql -u root -p'changeme' -e "truncate table masherysolar.identity_store"
mysql -u root -p'changeme' masherysolar < /tmp/mash_data.sql
    4. Run the SQL loader in sql pods in the new TML Cluster. Run the following command in eachtml-sql to run the sql loader. 
      /opt/sqlloader/onpremloader --service --mapi --devclass --packager --httpsclientsecurity --env production --verbose
  5. Undeploy and redeploy Cache components.
    Remove running Local Edition 5.5.0 Cache container.
    1. For single zone undeployment: 
      ./undeploy-cache-pod.sh
    2. To redeploy the container, run the following command. 
      ./deploy-cache-pod.sh
  6. Undeploy and redeploy TM components.
    Remove running Local Edition 5.5.0 TM container.
    1. For single zone undeployment: 
      • ./undeploy-tm-pod.sh
    2. Deploy Local Edition 5.5.1 TM container, run the following command. 
      ./deploy-tm-pod.sh
  7. Optional. This step is applicable if reporting pod is deployed. Undeploy and redeploy Reporting components.
    1. Remove running Local Edition 5.5.0 TM container. For single zone undeployment, run the following command: 
      ./undeploy-reporting-pod.sh
    2. To deploy Local Edition 5.5.1 TM container for single-zone deployment, run the following command. 
      source deploy-reporting-pod.sh "<zone-name>"