Single-Namespace Upgrade Considerations

When upgrading more than one MATRIXX component installed in a single namespace, where installed components include MATRIXX Engines and site-level Traffic Routing Agents (TRAs), use versionOverride properties to keep engines and TRAs at pre-upgrade versions until you are ready to upgrade those components.

Note: If upgrading from a release earlier than version 5250 to a release version 5250 or later, setting the tra.images.tra.pre5250 property to true is also required.

For example, to ensure that engines and TRAs are not also upgraded from version 5242 when first upgrading MATRIXX gateways and web apps to 5250 or later, make the following settings in your Helm values file:

engine:
  images:
    controller:
      versionOverride: "5242"
    engine:
      versionOverride: "5242"
    manager:
      versionOverride: "5242"
    tralb:
      versionOverride: "5242"
tra:
  images:
    tra:
      versionOverride: "5242"
      pre5250: true

To deploy the upgraded version of the engines, remove the values of those properties:

engine:
  images:
    controller:
      versionOverride: ""
    engine:
      versionOverride: ""
    manager:
      versionOverride: ""
    tralb:
      versionOverride: ""
tra:
  images:
    tra:
      versionOverride: "5242"
      pre5250: true

Do the same for the TRA versionOverride properties (and set the pre5250 property to false) to deploy the upgraded versions of the site-level TRAs:

engine:
  images:
    controller:
      versionOverride: ""
    engine:
      versionOverride: ""
    manager:
      versionOverride: ""
    tralb:
      versionOverride: ""
tra:
  images:
    tra:
      versionOverride: ""
      pre5250: false