Versions Compared

Key

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

...

  1. Verify that you are running version 9.0.0.0 or later. You can check the current version by opening the About window in the Desktop, where the current version is listed in the Pico Version section. If the system is running an earlier version, you need to upgrade it to an 9.x version first. See the documentation space for the version you are currently running for more information.
      

  2. Install either Oracle JDK 17 or OpenJDK 17 the server(s) where the Platform Container and Execution Containers are running.

  3. Verify that the System Requirements are met. If the operating system, or database need to be upgraded, this should be done prior to the upgrade. This has to be done for all machines that are hosting the system.

  4. Ensure that the environment variables are set correctly:

...

Excerpt
nameimportant
Warning

Important!

If your existing MZ_HOME platform database is configured to use other database type than the default Derby, you need to check and update the respective database related properties from the install.xml file to match your current setup.

Oracle

See Properties for Oracle for details.

The following properties require manual update:

<property name="install.ora.owner" value="mzowner"/>
<property name="install.ora.password" value="mz"/>

PostgreSQL

See Properties for PostgreSQL for details.

The following properties require manual update:

<property name="install.pg.owner" value="mzowner"/>
<property name="install.pg.password" value="mz"/>

SAP HANA

See Properties for SAP HANA for details.

Note

Important Note on Database 3pp Before Upgrading!

If you are upgrading from 9.0.0.0, 9.0.1.0 or 9.1.0.0, check to see if the database 3pp jar is in the $MZ_HOME/3pp folder.

If it does not exist in the $MZ_HOME/3pp folder, then you need to manually copy the database 3pp jar to the $MZ_HOME/3pp folder prior to the upgrade.

This step is NOT required if your current running version is 9.0.2.0 or 9.1.2.0 onwards.

Note

Note on Oracle ojdbc.jars!

If you are upgrading from 8.x and using Oracle as the system database, you need to use Oracle 19c (19.20.0.0) JDBC drivers (ojdbc8.jar/ojdbc10.jar).

Replace the jar files in $MZ_HOME/3pp and $MZ_HOME/lib folders

The jar file can be downloaded from https://www.oracle.com/database/technologies/appdev/jdbc-downloads.html.

...