Versions Compared

Key

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

...

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

Note

Note!

For users who have custom agents created in Development Toolkit and upgrading from 8.3:

If you have custom agents created using Development Toolkit, these agents cannot be included in the upgrade. For information on how to remove them before proceeding with the upgrade procedure, see Upgrade and Downgrade in Installation and Setup

Note

Note!

For systems using Configuration Spaces:

Configuration Spaces is replaced with the new Workflow Packages functionality. Prior to upgrading make sure to export the configuration from inactive configuration spaces that you want to keep, as only the active space is carried across during the upgrade process.

For further information regarding Configuration Spaces, and how to use them, please refer to Configuration Spaces in the  version 8.3 documentation.

...

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

Use of MZ_HOME backup

The MZ_HOME backup is needed in case the upgrade fails.

...

Excerpt
nameimportant
Panel
panelIconIdatlassian-warning
panelIcon:warning:
bgColor#FFEBE6

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.

PostgreSQL

See Properties for PostgreSQL for details.

SAP HANA

See Properties for SAP HANA for details.

Panel
panelIconIdatlassian-warning
panelIcon:warning:
bgColor#FFEBE6

Important!

If you are upgrading from 9.0.0.0 or 9.0.1.0 and using other database type than the default Derby, then you need to manually copy the database 3pp jar to the $MZ_HOME/3pp folder prior the upgrade.

However, this is not required if your current running version is 9.0.2.0 onwards.

Note

Note!

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

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

...