Upgrade Platform Container

Owned by Kevin Wu
Last updated: Jul 12, 2024 by Yeok Hong Ng
2 min read

Important!

It is essential to review and potentially adjust your Java memory settings, especially prior to an upgrade process as it demands additional resources for memory heap, pico timeout and metaspace size. See Java Configuration and Managing Picos with Topo for more information.

Important!

When upgrading to this release, the  install.admin.password must be set according to your current admin password before proceeding with the ./setup.sh upgrade step.

Important!

If the existing installation has additional JVM arguments configured which are obsolete in Java 17, remove them and update to use supported options.

Please refer to Java 17 docs for details on ‘Obsolete’ and ‘Removed’ Java options since Java 8.

See for JVM Arguments configuration.

 

  1. Enter the release content directory that was created when you extracted the delivered *.tgz file during the Upgrade Preparations, and execute the upgrade.

    $ ./setup.sh upgrade

     

  2. When using the ./setup.sh upgrade command, setup log file will be generated in the $MZ_HOME/log directory.

     

  3. Startup the platform.

    $ mzsh startup platform

  4. If you are upgrading from 8.3, you have to start the pico for the User Interface.

    $ mzsh topo set -l pico:ui template:mz.standard-ui $ mzsh startup ui

    If you wish to change the port number, execute the following command: