Simplified Downgrade Procedure

Owned by Kevin Wu
Last updated: Jan 03, 2024
2 min read

A system downgrade is a user controlled downgrade to an older version of .               

This procedure can be used after a simplified upgrade. 
To revert to a previously installed version, execute the following procedure:

  1. Ensure that the environment variables are set correctly:

Variable

Description

Variable

Description

MZ_HOME

This environment variable specifies where the software is installed.

JAVA_HOME

This environment variable specifies where the JDK is installed.

PATH

This environment variable specifies where the search path must contain the following directories:

$JAVA_HOME/bin:$MZ_HOME/bin

Example - Extracting the Upgrade Software



$ export MZ_HOME=/opt/mz  $ export JAVA_HOME=/opt/jdk/jdk-17.0.2 $ export PATH=$JAVA_HOME/bin:$MZ_HOME/bin:$PATH



 

  1. Disable all workflow groups, either from the Execution Manager in Desktop, or by entering the following command:

    $ mzsh mzadmin/<password> wfgroupdisable \*

     

  2. Stop all workflows.
     

  3. Shut down all connected Desktops.
     

  4. If you want to see which Desktops that are connected, you can use the following command:

    $ mzsh mzadmin/<password> pico -view

     

  5. Shut down the Platform and all ECs.

     

  6. Remove MZ_HOME.

     

  7. Restore the backup of MZ_HOME.

     

  8. If you are downgrading a system not using Derby, restore the database backup.

Note!

If you are using SAP HANA as the Platform database, you will need to disable TLS/SSL on the SAP HANA database before you downgrade your Platform.

Resume Workflow Execution

  1. Set the environment variables JAVA_HOME and PATH according to the system requirements of the restored version.

Note!

You must rollback to Java 8 before you downgrade to 8.3 or earlier. 

 

  1. Start the Platform and all ECs.

     

  2. Import the configurations that were exported in the old version prior to the upgrade.      

     

  3. Start the real-time workflows.
     

  4. Enable the Workflow Groups.