Upgrading to Jade 2022 from Jade 2020

In Jade 2022 SP3, the minimum Visual C++ Redistributables have been updated and you will need to install them. For details, see "Visual C++ Redistributables Updated", later in this document.

If you want to develop your own upgrade process, refer to the Jade install and upgrade steps documented in the ReadmeInstallSteps.pdf document in the documentation directory.

Example files are not part of the installation. They must be downloaded from the appropriate link (for example, JADE-Erewhon or JADE-ATCG) at https://github.com/jadesoftwarenz.

The Jade Setup program enables you to upgrade your binary and database files to Jade 2022 from Jade 2020, by performing the following actions.

  1. On the Jade 2020 system, carry out the following certify operations. Proceed to the next certify operation only when any and all errors reported in the current operation are resolved.

    1. A physical certify using the Jade Database utility (jdbutil.exe or jdbutilb.exe), to ensure that the system is structurally correct. (For details, see Chapter 1 of the Database Administration Guide.)

    2. A meta logical certify, to ensure that the meta model is clean. (For details, see "Running a Non-GUI Jade Logical Certifier", in Chapter 5 of the Object Manager Guide.)

    3. A logical certify, to ensure that the user data is referentially correct. (For details, see "Running the Diagnostic Tool", in Chapter 5 of the Object Manager Guide.)

      If you are unsure how to interpret the information output by the certify process, first refer to "Logical Certifier Errors and Repairs", in Chapter 5 of the Object Manager Guide, and if you are still unsure, contact Jade Support (jadesupport@jadeplatform.tech) for advice.

  2. Use the Jade Database utility to take a full backup of your existing Jade 2020 database.

    If the upgrade should fail, you will need to restore this backup and then retry the upgrade process when all of the conditions that caused the failure have been addressed.

  3. If you defined your own String primitive type endsWith__, replace__, replaceFrom__, or startsWith__ methods in Jade 2016.0.02 or later, you must rename them before you upgrade to Jade 2018 or higher, as Jade's new endsWith__, replace__, replaceFrom__, and startsWith__methods will conflict with any existing String method named endsWith__, replace__, replaceFrom__, or startsWith__.

  4. Installing the Jade ODBC drivers and the Microsoft Visual C++ redistributable packages requires administrator rights, so ensure that you have the appropriate privileges.

  5. Run the Jade 2022 installer, available from https://www.jadeplatform.tech/developer-centre/downloads.

    The Custom type applies only to a Fresh Copy installation type, and is not relevant when upgrading. The SDS/RPS Database Server option applies only to 64‑bit Feature Upgrade installation type.

  6. A warning message may be displayed if the upgrade validation process has not completed. If so, check the jadeupgrade.log file for information about what needs to be modified in your user schemas to pass the validation and enable application execution. If the validation needs to be run again, see the ReadmeInstallSteps.pdf file in the documentation directory for instructions.

  7. When the upgrade is complete, the Jade Setup program informs you that the Jade Setup was successfully completed and that you can now view the ReadMe.txt file. The ReadMe.txt file contains late‑breaking important information not possible to publish in this document.

  8. Use the Jade Database utility to take a full backup of your Jade 2022 database.