Skip to content

Upgrade Volt MX Go server components in development or test only environment

Upgrade Domino REST API

  1. Download Domino REST API Helm chart

    1. 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.

    2. Run the following command to download the chart:

      helm pull hclcr/drapi
      
      The file drapi-1.n.n.tgz is downloaded, wherein 1.n.n represents the version number such as 1.0.7.

    3. 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.

  2. Update the values.yaml file of the target upgrade version with custom settings you want to apply from the values.yaml file of your current installation.

  3. 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.

  4. 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

  1. Download Foundry charts.

    1. 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.

    2. 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.

  2. Obtain the upgrade.properties file from your prior deployment and copy it into the same directory as your values.yaml.

  3. 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 ./
    
  4. Update the values.yaml file of the target upgrade version with custom settings you want to apply from the values.yaml file of your current installation.

  5. Remove the dbupdate deployment by running the following command:

    helm uninstall dbupdate -n mxgo
    
  6. 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
    
  7. 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
    
  8. 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
    
  9. Within the directory containing the new Foundry charts, upgrade the databases by running the following command:

    helm install dbupdate voltmx-dbupdate -f values.yaml
    
  10. 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.