/
Simplified Downgrade Procedure

Simplified Downgrade Procedure

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.

    $ mzsh shutdown platform <ec name> ...

     

  6. Remove MZ_HOME.

    $ rm -rf $MZ_HOME

     

  7. Restore the backup of MZ_HOME.

    $ cp -r <backup directory> $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. 

Example - Setting Environment Variables



$ export MZ_HOME=/opt/mz $ export JAVA_HOME=/opt/jdk/jdk1.8.0_121   $ export PATH=$JAVA_HOME/bin:$MZ_HOME/bin:$PATH



 

  1. Start the Platform and all ECs.

    $ mzsh startup platform <ec names> ...

     

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

    $ mzsh mzadmin/<password> systemimport <backup directory>/<filename>

     

  3. Start the real-time workflows.
     

  4. Enable the Workflow Groups.

    $ mzsh mzadmin/<password> wfgroupenable \*