Versions Compared

Old Version 3

changes.mady.by.user Kevin Wu

Saved on

compared with

New Version Current

changes.mady.by.user Manuel Pereira

Saved on

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

This procedure can be used after a simplified upgrade. 

Note

Note!

You must rollback to Java 1.8 before you downgrade to an earlier version than Image Removed 8.0. 

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

  1. Ensure that the environment variables are set correctly:

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

Info
title

Example - Extracting the Upgrade Software


Code Block
languagetext
themeEclipse
$ 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 an mzsh command, for examplethe following command:

    Code Block
    $ mzsh mzadmin/<password> wfgropudisablewfgroupdisable \*
    Note
    titleNote!

    If you use the wfgroupdisable command, make sure that you enable all system tasks again when you are done.

  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:

    Code Block
    $ mzsh mzadmin/<password> pico -view
    Note
    titleNote!

    This command will also display other pico instances, such as ECs.

  5. Shut down the Platform and all ECs.

    Code Block
    $ mzsh shutdown Platformplatform <ec name>  ...

  6. Remove MZ_HOME.

    Code Block
    $ rm -rf $MZ_HOME

  7. Restore the backup of MZ_HOME.

    Code Block
    $ cp -r <backup directory> $MZ_HOME

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

Note

...

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

Note!

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

Info

...

Example - Setting Environment Variables


Code Block
languagetext
themeEclipse
$ 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.

    Code Block
    $ mzsh startup

...

  1. platform <ec names>  ...

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

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

  3. Start the real-time workflows.
     

  4. Enable the Workflow Groups.

    Code Block
    $ mzsh mzadmin/<password> wfgroupenable \*
Scroll pagebreak