Skip to main content
Skip table of contents

Upgrade

ZigiOps Upgrade Path

The platform supports upgrades from a previous version by retaining the existing configuration. First, you must determine your current ZigiOps release and follow the standard or release-specific instructions to upgrade to the desired release.

image-20240520-051004.png

For example, suppose you're currently using ZigiOps 2021.01.x and want to upgrade to ZigiOps 2024.04.x. In that case, you must follow the release-specific instructions for all releases between your current and desired release.

Upgrade Instructions

  • Stop the ZigiOps service or process.

  • Back up the existing ZigiOps installation folder to another location.

  • Initiate the installation of the new ZigiOps release in the existing ZigiOps installation folder.

You must follow the corresponding release-specific instructions for all releases between your current and desired release. Otherwise, skip the release-specific instructions and continue further.

ZigiOps 2021.07.648 (release-specific)
  1. Delete the following folders:

    • \conf\settings\accounts

    • \conf\settings\credentials

    • \conf\settings\users

ZigiOps 2021.10.145 (release-specific)
  1. Remove the following lines from the \conf\config.properties file and save the changes afterward:

    • key-password

    • key-manager-pass

ZigiOps 2023.01.191 (release-specific)
  1. Delete the contents of the \conf\settings\queries folder.

ZigiOps 2023.08.2.18 (release-specific)
  1. Uninstall the old Java 8 (64-bit) from the ZigiOps host and restart it.

  2. Install Oracle Java 17 (64-bit) or Open Java 17 (64-bit).

    • Ensure the JAVA_HOME variable is set to the Java 17 deployment.

  3. The ZigiOps service must be redeployed for the platform to pick up the new Java 17 delpoyment required by this release.

    • Select the OS Service option during the installation.

ZigiOps 2024.05.1.303 (release-specific)
  1. The ZigiOps service must be redeployed as there are new start up parameters introduced with this release.

    • Select the OS Service option during the installation.

  • Wait for the installation to complete and start the ZigiOps service or process.

  • Go to the Connected Systems page and confirm if the test connection is successful.

  • Go to the Configurator page and select and enable the desired integration template.

  • Confirm if the integration is working as expected.

Backout Plan

  1. Stop the application's service or process.

  2. Restore a backup of the previous version to the application's installation folder by replacing all files.

  3. Start the application's service or process.

JavaScript errors detected

Please note, these errors can depend on your browser setup.

If this problem persists, please contact our support.