Skip to main content
Skip table of contents

Upgrade

ZigiOps Upgrade Path

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

For example, suppose you're currently using ZigiOps 2021.01.x and want to upgrade to ZigiOps 2023.08.x. In that case, you can upgrade to the desired release directly, but 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.

  • Install the new ZigiOps release in the existing ZigiOps installation folder.


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

ZigiOps 2023.08.2.18
  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. Remove the ZigiOps service.

    • Windows:

      • Execute the \service\uninstall_service.bat file to uninstall the ZigiOps service.

      • Delete all files from the \service\ folder.

    • Linux:

      • Delete the /etc/systemd/system/zigiwave.service file.

      • Delete the /zigiops_start.sh file.

  4. Install the new ZigiOps release in the existing ZigiOps installation folder.

    • Select the OS Service option during the installation.

ZigiOps 2023.01.191
  1. Delete the contents of the \conf\settings\queries folder.

ZigiOps 2021.10.145
  1. Remove the following lines from the \conf\config.properties file and save the changes afterward:

    • key-password

    • key-manager-pass

ZigiOps 2021.07.648
  1. Delete the following folders:

    • \conf\settings\accounts

    • \conf\settings\credentials

    • \conf\settings\users


  • Unselect the OS Service option during the installation. (applicable only if no release-specific instructions were followed)

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