Minor-Version Update Notes

Notes and additional information about upgrading from a major version to a minor version, or updating from a minor version to another minor version; for example, 8.4.1 to 8.4.22 or 2018.0.1 to 2018.0.3.

Using Admin Console Upgrading 8.4x to 2018.0.x Upgrading 8.2 to 8.4x

Table of Contents

  1. Overview
  2. Checking for version-specific steps
  3. Common upgrade errors
  4. Summary of version-specific steps for version 8.4x


If you're updating from a major or micro version to a later micro update—for example, version 8.4.1 to 8.4.22—it's important to follow through the entire upgrade procedure. Even though it's a micro-release, it's important that you don't miss any steps. Be sure to:

Checking for version-specific steps

In some cases, upgrading to a specific micro-version might require an additional step that isn't part of the core upgrade process, such as a specific configuration task.

In defining the upgrade process you're going to follow, check for information in these two places:

  1. The main upgrade instructions for the main version you're upgrading to:
  2. Release notes for the micro version you're upgrading to: Check for any additional upgrade steps that might be covered in the release notes for the specific micro version. Release notes are available with the product ZIP files on the Rogue Wave Support Center (https://library.roguewave.com). You can also find this information in Summary of version-specific steps for version 8.4x below.

back to top

Common upgrade errors

Here are some reminders for specific tasks that are part of the standard upgrade process but are sometimes forgotten, either in a major or minor upgrade, causing problems with the installation. The instructions below are for upgrade to version 8.4x:

back to top

Summary of version-specific steps for version 8.4.x

Version 8.4 includes the following version-specific steps shown below. If you're upgrading from a version before to a version after any of the below items, be sure to include that step in your upgrade process.

This version... Included the following specific upgrade step...

Version 8.4.6 includes an optional JRE update required for the platform's support of a specific HSM device.

The version of the Java Runtime Environment (JRE) that the platform uses was upgraded to version 1.8.0_144. This was needed for the platform’s support of the Thales HSM NCipher security provider.
If you're not using an HSM, upgrading is not necessary. However, because the JRE is bundled with the Akana Platform installation, if you want the JRE upgrade you'll need to get the full ZIP file that includes it. Follow the basic instructions for downloading and installing files from the Akana Support Site (see http://docs.akana.com/sp/upgrade/upgrading_akana_api_platform_82_84.htm#s01_03), but:

  • For the Akana Platform on Linux, get this file: akana-platform-linux-jre-8.4.6.zip
  • For the Akana Platform on Windows, get this file: akana-platform-win-jre-8.4.6.zip

Two additional steps:

  • Run the Manage Schemas upgrade task, which is included in the automated upgrade process.
  • After the upgrade process is complete, run the Provisioning upgrade task (Admin Console > Configuration > Configuration Actions > Provisioning).

back to top