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:
Ensure that the environment variables are set correctly:
Error rendering macro 'excerpt-include' : User 'null' does not have permission to view the page 'Temp:Downgrade Preparations'.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
Disable all workflow groups, either from the Execution Manager in Desktop, or by entering an mzsh command, for example:
$ mzsh mzadmin/<password> wfgropudisable \*
Note!
If you use the
wfgroupdisable
command, make sure that you enable all system tasks again when you are done.- Stop all workflows.
 - Shut down all connected Desktops.
 If you want to see which Desktops that are connected, you can use the following command:
$ mzsh mzadmin/<password> pico -view
Note!
This command will also display other pico instances, such as ECs.
Shut down the Platform and all ECs.
$ mzsh shutdown Platform <ec name> ...
Remove MZ_HOME.
$ rm -rf $MZ_HOME
Restore the backup of MZ_HOME.
$ cp -r <backup directory> $MZ_HOME
If you are downgrading a system using Oracle, 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. Refer to Downgrade on the Release Documentation for the steps.
Resume Workflow Execution
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
Start the Platform and all ECs.
$ mzsh startup Platform <ec names> ...
Import the configurations that were exported in the old version prior to the upgrade. Â Â Â Â
$ mzsh mzadmin/<password> systemimport <backup directory>/<filename>
- Start the real-time workflows.
 - Enable the Workflow Groups.