Upgrade Volt MX Go server components in development or test only environment
Upgrade Domino REST API
-
Download Domino REST API Helm chart
-
Run the following command to make sure that the chart information for the repositories is up-to-date.
helm repo update
See Volt MX Go and Helm chart version compatibility to know the latest Helm chart version.
-
Run the following command to download the chart:
The filehelm pull hclcr/drapi
drapi-1.n.n.tgz
is downloaded, wherein1.n.n
represents the version number such as1.0.7
. -
Run the following commands to unpack the chart and make the DRAPI directory your current directory:
tar -xzvf drapi-1.n.n.tgz cd drapi
Note
The Domino REST API chart name has a version string in the filename. The helm pull command will pull down the latest version of the charts. Ensure your tar command uses the correct matching file names.
-
-
Update the
values.yaml
file of the target upgrade version with custom settings you want to apply from thevalues.yaml
file of your current installation. -
Within the directory containing the new Domino REST API charts, run the following command:
helm upgrade domino . -f values.yaml
This upgrades the program executables and reuses the existing databases and all the configuration stored on
/local/notesdata
within the Domino container. -
Run the following command to wait for the Domino pod to be running and in the ready state:
kubectl get pods -o wide -w
Note
The
-w
flag tells the kubectl command to wait, and updates the output over time with any changes.
Upgrade Volt MX Go Foundry
-
Download Foundry charts.
-
Run the following command to make sure that the chart information for the repositories is up-to-date.
helm repo update
See Volt MX Go and Helm chart version compatibility to know the latest Helm chart version.
-
Run the following commands to download the Foundry charts, unpack the files, and move the
values.yaml
file to the current directory:mkdir foundry cd foundry helm pull hclcr/voltmx-dbupdate helm pull hclcr/voltmx-foundry tar -xzf voltmx-foundry-1.n.n.tgz tar -xzf voltmx-dbupdate-1.n.n.tgz mv voltmx-foundry/values.yaml ./ mv voltmx-foundry/init-guids.sh ./ chmod +x init-guids.sh
Note
The foundry and dbupdate chart names have a version string in the filename. The
helm pull
command will pull down the latest version of the charts. Ensure your tar command uses the correct matching file names.
-
-
Obtain the
upgrade.properties
file from your prior deployment and copy it into the same directory as yourvalues.yaml
. -
Invoke the init-guids script specifying the file path of the prior deployment's
upgrade.properties
by running the following command:./init-guids.sh --upgrade ./
-
Update the
values.yaml
file of the target upgrade version with custom settings you want to apply from thevalues.yaml
file of your current installation. -
Remove the dbupdate deployment by running the following command:
helm uninstall dbupdate -n mxgo
-
Scale down existing Foundry deployments to zero by running the following commands:
kubectl scale deployment --replicas=0 voltmx-foundry-console kubectl scale deployment --replicas=0 voltmx-foundry-apiportal kubectl scale deployment --replicas=0 voltmx-foundry-integration kubectl scale deployment --replicas=0 voltmx-foundry-identity
-
Confirm that the ready count has dropped to zero by running the following command:
kubectl get deployment
You should get an output similar to the following where the ready count has dropped to zero:
NAME READY UP-TO-DATE AVAILABLE AGE drapi 1/1 1 1 5h40m voltmx-foundry-console 0/0 0 0 51m voltmx-foundry-identity 0/0 0 0 51m voltmx-foundry-integration 0/0 0 0 51m voltmx-foundry-apiportal 0/0 0 0 51m
-
Confirm the removal of the pods by running the following command:
kubectl get pods
You should get an output similar to the following where the Foundry pods have been removed:
NAME READY STATUS RESTARTS AGE drapi-6949c45b8-wghbz 3/3 Running 0 5h40m mysql-0 1/1 Running 0 5h36m
-
Within the directory containing the new Foundry charts, upgrade the databases by running the following command:
helm install dbupdate voltmx-dbupdate -f values.yaml
-
After a successful database upgrade, upgrade the Foundry applications by running the following command:
helm upgrade foundry voltmx-foundry -f values.yaml
This updates the deployment configuration and spins up new pods to run the latest version of the applications.
Additional information
After completing the upgrade installation of Domino REST API and Volt MX Go Foundry, proceed to Install and upgrade Volt MX Go Iris.