Skip to content

For Volt MX Go v2.1

Guides you in upgrading Volt MX Go server components.

Upgrade Domino REST API

Before you begin

Important

Make sure to check version compatibility between Volt MX Go and Domino REST API.

Procedure

  1. Download the required version of the Domino REST API installer. For more information, see Download the Domino REST API link image in the HCL Domino REST API documentation.

  2. Follow the relevant steps in the upgrade procedure link image in the HCL Domino REST API documentation link image based on your installation platform.

Upgrade Volt MX Go Foundry

The following procedures guide you in upgrading Volt MX Go Foundry to the latest version. As Volt MX Go Foundry supports various installation mechanisms, refer to the relevant upgrade procedure.

For using an installer

Important

The upgrade process works by upgrading the existing database to the latest version, and installing fresh application server artifacts, such as data sources and WARs. For installation details such as hostname, database port, prefix, suffix, you must refer to the installation logs of your previous setup.

The installer does not support automatic backups of database and other artifacts. You must clean up the existing application server artifacts and take a backup of the custom artifacts. The installer also does not support rollback in case of a failure during the upgrade. To roll back, restore the database and server artifacts you backed up before upgrading.

Upgrades Volt MX Go Foundry from Volt MX Go v2.0.4 to Volt MX Go v2.1.

Before you begin

  • Back up your databases and server artifacts.

  • You have downloaded the Volt Foundry installer based on your installation platform. The minimum supported version is v9.5.18.0. For more information, see Download HCL Volt MX Go installers.

  • You have installed the Volt MX Go Plugin Installer. For more information, see Install Volt MX Go Plugin Installer.

  • Ensure that the Volt Foundry installer has execute permission.

  • Ensure that you have the path of your previous installation directory.
  • Ensure that you stop the application server of your existing Volt MX Go Foundry instance, which you want to upgrade.

Install Volt Foundry

  • Follow the link to the upgrade procedure based on your used installation platform. In this step, upgrade your Volt MX Go Foundry v2.0.4 with the minimum supported version of Volt Foundry.

    Important

    • For Volt MX Go v2.1, only Volt Foundry using a Tomcat non-clustered application server is supported.
    • Volt Foundry must be licensed with a Volt MX Go entitlement for the plugins to be enabled and for the Volt MX Go features to work.
    • The upgrade procedure indicates installation files and installation file download locations. You must use the installer you downloaded in Before you begin.
    • Check all the details and complete all the applicable steps indicated in the upgrade procedure.

    • Make sure to point to the same database you used for your Volt MX Go Foundry v2.0.4 installation to access all the projects you worked on.

    • After completing the upgrade installation, activate the Volt MX Go license on Volt Foundry and then shut it down before proceeding to the installation of the Volt MX Go plugins. For more information, see license activation link image on the Volt MX documentation.

Install Volt MX Go plugins

The procedure enables the installation of Volt MX Go plugins to Volt Foundry to enable Volt MX Go features.

Important

  • For Volt MX Go v2.1, you can only install Volt MX Go plugins to Volt Foundry that uses a Tomcat non-clustered application server.
  • Volt Foundry must be licensed with a Volt MX Go entitlement for the plugins to be enabled and for the Volt MX Go features to work.
  1. Open Terminal.
  2. Go to the directory where you installed the Volt MX Go Plugin Installer.

  3. Run the Volt MX Go Plugin Installer by entering the following command and press Enter

    ./VoltMXGoPluginInstaller

    The installation tool opens on the Terminal showing the available options.

    Installation options

  4. Enter 1 to install Volt MX Go plugins and press Enter.

  5. Specify the Tomcat WebApps directory by entering the number corresponding to your installation or enter the full path to your Tomcat WebApps directory, and then press Enter.

    You get a confirmation statement that the plugins have been installed.

  6. Enter 7 and press Enter to exit the installation tool.

  1. Select Start, scroll through the alphabetical list, and select Volt MX Go Plugin Installer. Depending on your OS, you might need to select All apps, scroll through the alphabetical list, and click Volt MX Go Plugin Installer.

    OR

    Double-click the Volt MX Go Plugin Installer shortcut on your desktop if available.

    A Command Prompt window opens showing the available options.

    Installation options

  2. Enter 1 to install Volt MX Go plugins and press Enter.

  3. Specify the Tomcat WebApps directory by entering the number corresponding to your installation, or enter the full path to your Tomcat WebApps directory, then press Enter.

    You get a confirmation statement that the plugins have been installed.

  4. Press Enter to close the Command Prompt window.

Note

After installing the Volt MX Go plugins, open Volt Foundry to verify you see the Volt MX GO/First Touch banner.

Important consideration

There are regular updates for Volt Foundry. These updates are major release versions, service packs, and fix packs.

You must reinstall the Volt MX Go plugins every time you update Volt Foundry.

For using Helm charts on a supported Kubernetes platform

Before you begin

You have downloaded the Volt Foundry Helm charts. For more information, see Download HCL Volt MX Go installers.

Procedure

  1. Click the link to the upgrade guide based on your requirement and follow the steps.

    Important

    Make sure to check all the details and complete all the applicable steps indicated in the installation guide.

  2. After completing all applicable steps in the installation guide, update the values.yaml file.

    1. Locate the values.yaml file in the Volt Foundry directory.
    2. Open the values.yaml file with your preferred editor and locate the line containing the imageRegistry: key.
    3. Change the value of the imageRegistry: key to hclcr.io/voltmxgo.
    4. Save your changes and close the file.

  3. Execute the helm upgrade foundry command to upgrade the running images to use Volt MX Go.

Next step

After completing the upgrade installation of Domino REST API and Volt MX Go Foundry, proceed to Install and upgrade Volt MX Go Iris.