ITRS Analytics Upgrade Notes

This document provides important upgrade considerations for ITRS Analytics. Please read the applicable sections thoroughly prior to initiating the upgrade to ensure successful upgrade process and minimize disruption.

For detailed procedures on upgrading in BYO and Embedded Cluster environments, refer to the following sections:

General upgrade instructions (all versions) Copied

Regardless of the version, upgrading ITRS Analytics from a lower version may reset some configurations. It is strongly recommended that you follow these steps during the upgrade process.

Verify and adjust hostnames Copied

If you configured a custom hostname in your existing installation, make sure to manually verify and update the hostname setting after the upgrade. It may not persist automatically.

Reinstall optional apps Copied

Optional apps are not retained automatically through the upgrade. Re-select and reinstall any apps you had previously chosen to ensure feature parity post-upgrade.

Downgrading to earlier versions Copied

Downgrading to an earlier version is not supported. Please ensure you back up all configurations and data before upgrading.

Version-specific considerations Copied

Upgrading to version 2.11.0+12 Copied

A new option, Include Disk I/O Test for Support Bundle, has been introduced. The Disk I/O performance check is enabled by default for both preflight checks and support bundle. You can manage these settings independently through the KOTS Admin Console under Advanced Settings > Preflight and Support Bundle Settings.

The Support Bundle is managed independently using the Include Disk I/O Test for Support Bundle option. It operates independently of the Preflight check configuration and remains enabled by default unless explicitly disabled.

For more information, see Preflight checks for Disk I/O performance.

Upgrading to version 2.10.1+6 Copied

The Disk I/O performance check is enabled by default as part of the preflight checks. You can manage this setting independently through the KOTS Admin Console under Advanced Settings > Preflight Settings.

The Preflight check can be disabled via the Run Disk I/O Performance Test option. During reconfiguration, the test is skipped unless it has been explicitly enabled.

For more information, see Preflight checks for Disk I/O performance.

Upgrading to version 2.9.0 Copied

Direct upgrades from ITRS Analytics 2.8.1 or earlier to 2.9.0 are not supported. However, an upgrade path is available to version 2.9.1.

Upgrading to version 2.8.0+5 Copied

If you are running version 2.8.0+4 or an earlier release, the Storage Class name field is read-only and cannot be modified. This setting becomes configurable only during a fresh installation starting with version 2.8.0+5.

Once the cluster has been installed, these values can no longer be modified. This limitation applies even if you update the configuration using the KOTS Admin Console, attempt to make changes through the advanced configuration settings, or upgrade to newer IAX versions.

Note

Any storage class configured in versions earlier than 2.8.0+5 will be retained and carried over when upgrading to version 2.8.0+5 or later.

If you need to change the Storage Class name after installation, this must be done manually, outside of the KOTS Admin Console. Make sure the correct Storage Class names are set before starting the initial install.

Upgrading to or installing version 2.8.0+6 or later Copied

Upon the initial installation or upgrade to ITRS Analytics version 2.8.0+6 or later, you must select whether to install:

This selection is permanent and cannot be changed in future upgrades. Please carefully consider your requirements before making this choice.

Required releases and upgrade paths Copied

Certain releases of ITRS Analytics are designated as required or mandatory. You must upgrade to these versions to maintain support, security, and compatibility.

Warning

Failure to apply these releases may lead to unsupported configurations or compatibility issues with subsequent ITRS Analytics versions.

Required releases typically include:

Required releases Copied

The following releases are mandatory for all users:

For a complete overview of all releases, see the latest ITRS Analytics Release Notes.

Supported upgrade paths Copied

Upgrade scenario Recommended path Notes
Users on the version immediately preceding a required release Upgrade directly to the required release Example: 2.15.x > 2.15.5
Users on older versions that skip one or more required releases Upgrade sequentially through each required release Example: 2.10.1+2 > 2.12.0+1 (Required) > 2.15.x
Users skipping required releases entirely Unsupported May result in database, compatibility, or security issues
Planning upgrades Always review release notes and test in staging Check for pre-upgrade actions, dependencies, or configuration changes
["ITRS Analytics"] ["User Guide", "Technical Reference"]

Was this topic helpful?