Preparations for Simplified Upgrade

Owned by Kevin Wu
Last updated: Jul 30, 2024 by Yeok Hong Ng
1 min read

The preparation steps will not affect the running system and can be done in advance.

  1. Ensure that the environment variables are set correctly:

    VariableDescription
    MZ_HOME
    This environment variable specifies where the software is installed.

    Note!

    Note!

    You should use an absolute path instead of a symlink for the MZ_HOME directory to avoid any issue during installation or upgrade.

    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 - Setting Environment Variables

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

  2. Make a system export of all your configurations with System Export.

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

    Note!

    These configurations must be imported after the upgrade.

  3. For safety, make an online backup of the database(s). For information about how to perform an online backup, see Backup and Disaster Recovery Procedures.