Versions Compared

Key

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

...

  1. Make a backup of all your configurations with System Export. This can be done either in Desktop, which is described in System Exporter or by using the mzsh systemexport command:

    Code Block
    $ mzsh mzadmin/<password> systemexport <backup directory>/<filename>
    Info
    titleUse of System Export File

    The exported configurations might be needed in order to be able to perform a downgrade.

  2. Make an online backup of the database(s). For further information regarding how to perform an online backup, see Preventive Maintenance Procedures.
    Note! If you are upgrading from 8.3.x, you can find the database backup instructions in the documentation for 8.3 as the procedure may differ from that of 9.x.

  3. If you are upgrading from 8.x, it is important to make a backup of MZ_HOME for rollback purposes.

    To make a backup of your MZ_HOME, you can use the following command:

    Note
    titleNote!

    Ensure that you have shutdown your platform and all executions prior to the backup.

    Code Block
    $ cd $MZ_HOME/../
    $ tar -zcvf mzhome_backup.tgz <MZ_HOME directory>
    $ mv mzhome_backup.tgz <backup directory>
    Info
    titleUse of MZ_HOME backup

    The MZ_HOME backup might be needed in order to be able to perform a rollback in case upgrade failure.

  4. If you are performing an upgrade of a system with large configurations, you may need to increase the maximum number of file descriptors.

    Info
    titleExample - Changing the maximum number of file descriptors on Linux


    Code Block
    languagetext
    themeEclipse
    $ cat /proc/sys/fs/file-max
    5000 
    $ su - root 
    Password: 
    $sysctl -w fs.file-max=100000 


  5. Create a directory to use when unpacking this release and future releases. For the purpose of these instructions, this designated directory is referred to as the staging directory.

    Note
    titleNote!

    The staging directory should not be the same directory as the one you created and set up as the MZ_HOME directory.

  6. Place the *.tgz file from your release delivery into the staging directory.

  7. Use a command line tool, go to the staging directory, and unpack the *.tgz file by running the following command:

    Code Block
    $ tar xvzf <filename>.tgz

    A directory is then created in the staging directory, containing the software to be installed. For the purpose of these instructions, this directory is referred to as the release content directory.

  8. Now copy the MZ license file into the release content directory.

Info

If you are upgrading from 8.3.x, you need a new license file. Contact DigitalRoute Support on getting the MZ license file.

Code Block
$ cp mz.license <release content directory>

  1. Enter the release content directory and prepare the install.xml file by running the following command:

    Code Block
    $ cd <release content directory>
    $ ./setup.sh prepare

    The *.mzp packages have now been extracted, and the install.xml has been extracted into the release content directory. The install.xml file will automatically be populated with information from your existing installation.

Note

Refer Platform Properties to know more about these properties and their default values.

...