9. 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. For information about how to downgrade after a standard upgrade, see 7. Standard Downgrade Procedure.

Note!

You must rollback to Java 1.7 before you downgrade to an earlier version than  7.0. If that is the case, follow the procedure provided in Appendix C - Java Version Change before you execute the downgrade procedure below.

To revert to a previously installed version, execute the following procedure:

  1. Ensure that the environment variables are set correctly:


    VariableDescription
    MZ_HOME

    This environment variable specifies where the  software is installed.

    JAVA_HOMEThis environment variable specifies where the JDK is installed.
    PATHThis environment variable specifies the search path and 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/jdk1.8.0_121
    $ export PATH=$JAVA_HOME/bin:$MZ_HOME/bin:$PATH
  2. 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.

  3. Stop all workflows.
     
  4. Shut down all connected Desktops.
     
  5. 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 EC/ECSAs.

  6. Shut down the Platform and all EC/ECSAs.

    $ mzsh shutdown Platform <ec name> ecsa name> ... 
  7. Remove MZ_HOME.

    $ rm -rf $MZ_HOME 
  8. Restore the backup of MZ_HOME.

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

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

    Example - Setting Environment Variables

    $ export MZ_HOME=/opt/mz  
    $ export JAVA_HOME=/opt/jdk/jdk1.7.0_07 
    $ export PATH=$JAVA_HOME/bin:$MZ_HOME/bin:$PATH
  2. Start the Platform and all EC/ECSAs.

    $ mzsh startup Platform <ec names> <ecsa names> ...
  3. Import the configurations that were exported in the old version prior to the upgrade.      

    $ mzsh mzadmin/<password> systemimport <backup directory>/<filename>
  4. Start the real-time workflows.
     
  5. Enable the Workflow Groups.