Skip to main content

VerteX Upgrade

This page offers links and reference information for upgrading self-hosted Palette VerteX instances. If you have questions or concerns, reach out to our support team.

tip

If you are using self-hosted Palette, refer to the Palette Upgrade page for upgrade guidance.

Private Cloud Gateway​

If your setup includes a PCG, make sure to allow the PCG to upgrade automatically before each major or minor Palette VerteX upgrade.

Supported Upgrade Paths​

Refer to the following tables for the supported Palette VerteX upgrade paths for VMware, Kubernetes, and VerteX Management Appliance installations.

In the following tables, ✅ indicates a validated upgrade path and ❌ indicates a path that is not supported. Refer to Kubernetes Version Constraint for why some upgrades from a 4.8.x release are not supported, and for the two-step route to use instead.

danger

Before upgrading Palette VerteX to a new major version, you must first update it to the latest patch version of the latest minor version available.

Use the Find Breaking Changes page to list all the breaking changes between Palette versions. Ensure that you have addressed all changes before upgrading Palette VerteX.

warning

Upgrading self-hosted Palette or Palette VerteX from version 4.6.x to 4.7.x can cause the upgrade to hang if any member of the MongoDB ReplicaSet is not fully synced and in a healthy state prior to the upgrade. For guidance on verifying the health status of MongoDB ReplicaSet members, refer to our Troubleshooting guide.

Kubernetes Version Constraint​

Kubernetes does not support skipping a minor version during a cluster upgrade, so a Palette VerteX upgrade cannot cross more than one Kubernetes minor version in a single hop. An upgrade that would skip a Kubernetes minor version may fail mid-run and leave the management cluster in an unrecoverable state.

This constraint applies to Enterprise Cluster (EC) binary and VerteX Management Appliance installations, which bundle a specific Kubernetes version with each Palette VerteX release. The two installation types do not bundle the same Kubernetes version for a given release, so compare the versions for the installation type you use. The constraint does not apply to Palette VerteX installed with Helm on a customer-managed Kubernetes cluster, where you manage the Kubernetes version independently of Palette VerteX. The paths in the Kubernetes tab are not subject to it.

The following table lists the Kubernetes version bundled with each recent Palette VerteX release.

Palette VerteX ReleaseEC BinaryVerteX Management Appliance
4.7.40, 4.7.431.31.8Not applicable
4.8.52, 4.8.54, 4.8.56, 4.8.58, 4.8.61, 4.8.621.32.91.33.9
4.9.5, 4.9.8, 4.9.141.33.101.34.6
4.9.23 and later1.34.61.34.9
4.10.131.35.6Not applicable
4.10.14, 4.10.16, 4.10.171.35.61.35.6
4.10.25 and later1.35.61.35.8

On EC binary installations, direct upgrades from any 4.8.x release to 4.9.23 or later are not supported. The 4.8.x series ships Kubernetes 1.32.9, and 4.9.23 and later ship Kubernetes 1.34.6, which skips 1.33.x. The upgrade path tables mark these paths with ❌. To reach 4.9.23 or later from 4.8.x, upgrade in two steps.

  1. Upgrade to 4.9.14, which ships Kubernetes 1.33.10.
  2. After the cluster returns to a healthy state, upgrade to the target 4.9.23 or later release.

VerteX Management Appliance installations are not affected, because they ship Kubernetes 1.33.9 on 4.8.x and 1.34.9 on 4.9.24 and later, which crosses a single minor version.

Before you start any Palette VerteX upgrade, compare the Kubernetes version of your current release with that of the target release. If the delta is two or more minor versions, plan an intermediate upgrade through a release on the missing minor.

4.10

Source VersionTarget VersionSupport
4.9.634.10.27✅
4.9.634.10.25✅
4.9.604.10.27✅
4.9.604.10.25✅
4.9.594.10.27✅
4.9.594.10.25✅
4.9.594.10.17✅
4.9.544.10.27✅
4.9.544.10.25✅
4.9.544.10.17✅
4.9.544.10.16✅
4.9.544.10.14✅
4.9.544.10.13✅
4.9.534.10.27✅
4.9.534.10.25✅
4.9.534.10.17✅
4.9.534.10.16✅
4.9.534.10.14✅
4.9.534.10.13✅
4.9.534.10.11✅
4.9.514.10.27✅
4.9.514.10.25✅
4.9.514.10.17✅
4.9.514.10.16✅
4.9.514.10.14✅
4.9.514.10.13✅
4.9.514.10.11✅

4.9

Source VersionTarget VersionSupport
4.9.604.9.63✅
4.9.604.9.62✅
4.9.144.9.63✅
4.9.144.9.62✅
4.9.144.9.60✅
4.9.144.9.51✅
4.9.144.9.46✅
4.9.144.9.44✅
4.9.144.9.38✅
4.9.144.9.24✅
4.8.624.9.63❌
4.8.624.9.62❌
4.8.624.9.60❌
4.8.624.9.51❌
4.8.624.9.46❌
4.8.624.9.44❌
4.8.624.9.38❌
4.8.624.9.24❌
4.8.624.9.14✅
4.8.624.9.5✅
4.8.614.9.63❌
4.8.614.9.62❌
4.8.614.9.60❌
4.8.614.9.51❌
4.8.614.9.46❌
4.8.614.9.44❌
4.8.614.9.38❌
4.8.614.9.24❌
4.8.614.9.14✅
4.8.614.9.5✅
4.8.564.9.63❌
4.8.564.9.62❌
4.8.564.9.60❌
4.8.564.9.51❌
4.8.564.9.46❌
4.8.564.9.44❌
4.8.564.9.38❌
4.8.564.9.24❌
4.8.564.9.14✅
4.8.564.9.5✅
4.8.524.9.63❌
4.8.524.9.62❌
4.8.524.9.60❌
4.8.524.9.51❌
4.8.524.9.46❌
4.8.524.9.44❌
4.8.524.9.38❌
4.8.524.9.24❌
4.8.524.9.14✅
4.8.524.9.5✅
4.8.334.9.5✅
4.8.254.9.5✅
4.8.224.9.5✅
4.8.164.9.5✅
4.8.124.9.5✅
4.8.94.9.5✅
4.8.84.9.5✅
4.7.384.9.5❌
4.7.294.9.5❌
4.7.274.9.5❌

4.8

info

After upgrading to 4.8.8, the Palette VerteX management cluster will appear to be Unhealthy in the Palette VerteX UI due to mongodb-key-manager-manifest errors. The cluster functionality is not affected and will return to Healthy after a few hours.

Source VersionTarget VersionSupport
4.8.354.8.71✅
4.8.354.8.70✅
4.8.354.8.69✅
4.8.354.8.51✅
4.8.354.8.47✅
4.8.354.8.37✅
4.8.334.8.71✅
4.8.334.8.70✅
4.8.334.8.69✅
4.8.334.8.51✅
4.8.334.8.47✅
4.8.334.8.37✅
4.8.334.8.35✅
4.8.254.8.71✅
4.8.254.8.70✅
4.8.254.8.69✅
4.8.254.8.51✅
4.8.254.8.47✅
4.8.254.8.37✅
4.8.254.8.35✅
4.8.254.8.33✅
4.8.224.8.71✅
4.8.224.8.70✅
4.8.224.8.69✅
4.8.224.8.51✅
4.8.224.8.47✅
4.8.224.8.37✅
4.8.224.8.35✅
4.8.224.8.33✅
4.8.224.8.25✅
4.8.164.8.71✅
4.8.164.8.70✅
4.8.164.8.69✅
4.8.164.8.51✅
4.8.164.8.47✅
4.8.164.8.37✅
4.8.164.8.35✅
4.8.164.8.33✅
4.8.164.8.25✅
4.8.164.8.21✅
4.8.124.8.71✅
4.8.124.8.70✅
4.8.124.8.69✅
4.8.124.8.51✅
4.8.124.8.47✅
4.8.124.8.37✅
4.8.124.8.35✅
4.8.124.8.33✅
4.8.124.8.25✅
4.8.124.8.21✅
4.8.124.8.16✅
4.8.94.8.71✅
4.8.94.8.70✅
4.8.94.8.69✅
4.8.94.8.51✅
4.8.94.8.47✅
4.8.94.8.37✅
4.8.94.8.35✅
4.8.94.8.33✅
4.8.94.8.25✅
4.8.94.8.21✅
4.8.94.8.16✅
4.8.94.8.12✅
4.8.84.8.71✅
4.8.84.8.70✅
4.8.84.8.69✅
4.8.84.8.51✅
4.8.84.8.47✅
4.8.84.8.37✅
4.8.84.8.35✅
4.8.84.8.33✅
4.8.84.8.25✅
4.8.84.8.21✅
4.8.84.8.16✅
4.8.84.8.12✅
4.8.84.8.9✅
4.7.484.8.71✅
4.7.484.8.70✅
4.7.384.8.71✅
4.7.384.8.70✅
4.7.384.8.69✅
4.7.384.8.51✅
4.7.384.8.47✅
4.7.384.8.37✅
4.7.384.8.35✅
4.7.384.8.33✅
4.7.294.8.71✅
4.7.294.8.70✅
4.7.294.8.69✅
4.7.294.8.51✅
4.7.294.8.47✅
4.7.294.8.37✅
4.7.294.8.35✅
4.7.294.8.33✅
4.7.294.8.25✅
4.7.294.8.21✅
4.7.294.8.16✅
4.7.294.8.12✅
4.7.294.8.9✅
4.7.294.8.8✅
4.7.274.8.71✅
4.7.274.8.70✅
4.7.274.8.69✅
4.7.274.8.51✅
4.7.274.8.47✅
4.7.274.8.37✅
4.7.274.8.35✅
4.7.274.8.33✅
4.7.274.8.25✅
4.7.274.8.21✅
4.7.274.8.16✅
4.7.274.8.12✅
4.7.274.8.9✅
4.7.274.8.8✅

4.7.x

Source VersionTarget VersionSupport
4.7.214.7.26✅
4.7.204.7.26✅
4.7.204.7.21✅
4.7.164.7.26✅
4.7.164.7.21✅
4.7.164.7.20✅
4.7.154.7.26✅
4.7.154.7.21✅
4.7.154.7.20✅
4.7.34.7.26✅
4.7.34.7.21✅
4.7.34.7.20✅
4.7.34.7.15✅
4.6.414.7.26✅
4.6.414.7.21✅
4.6.414.7.20✅
4.6.414.7.15✅
4.6.414.7.3✅
4.6.64.7.15✅

4.6.x

Source VersionTarget VersionSupport
4.6.414.6.43✅
4.6.364.6.43✅
4.6.364.6.41✅
4.6.324.6.43✅
4.6.324.6.41✅
4.6.324.6.34✅
4.6.324.6.33✅
4.6.284.6.43✅
4.6.284.6.41✅
4.6.284.6.34✅
4.6.284.6.33✅
4.6.284.6.32✅
4.6.264.6.43✅
4.6.264.6.41✅
4.6.264.6.34✅
4.6.264.6.33✅
4.6.264.6.32✅
4.6.254.6.43✅
4.6.254.6.41✅
4.6.254.6.34✅
4.6.254.6.33✅
4.6.254.6.32✅
4.6.244.6.43✅
4.6.244.6.41✅
4.6.244.6.34✅
4.6.244.6.33✅
4.6.244.6.32✅
4.6.244.6.28✅
4.6.244.6.27✅
4.6.244.6.26✅
4.6.244.6.25✅
4.6.234.6.43✅
4.6.234.6.41✅
4.6.234.6.34✅
4.6.234.6.33✅
4.6.234.6.32✅
4.6.234.6.28✅
4.6.234.6.27✅
4.6.234.6.26✅
4.6.234.6.25✅
4.6.234.6.24✅
4.6.184.6.43✅
4.6.184.6.41✅
4.6.184.6.34✅
4.6.184.6.33✅
4.6.184.6.32✅
4.6.184.6.28✅
4.6.184.6.27✅
4.6.184.6.26✅
4.6.184.6.25✅
4.6.184.6.24✅
4.6.184.6.23✅
4.6.134.6.43✅
4.6.134.6.41✅
4.6.134.6.34✅
4.6.134.6.33✅
4.6.134.6.32✅
4.6.134.6.28✅
4.6.134.6.27✅
4.6.134.6.26✅
4.6.134.6.25✅
4.6.134.6.24✅
4.6.134.6.23✅
4.6.134.6.18✅
4.6.124.6.43✅
4.6.124.6.41✅
4.6.124.6.34✅
4.6.124.6.33✅
4.6.124.6.32✅
4.6.124.6.28✅
4.6.124.6.27✅
4.6.124.6.26✅
4.6.124.6.25✅
4.6.124.6.24✅
4.6.124.6.23✅
4.6.124.6.18✅
4.6.124.6.13✅
4.6.94.6.43✅
4.6.94.6.41✅
4.6.94.6.34✅
4.6.94.6.33✅
4.6.94.6.32✅
4.6.94.6.28✅
4.6.94.6.27✅
4.6.94.6.26✅
4.6.94.6.25✅
4.6.94.6.24✅
4.6.94.6.23✅
4.6.94.6.18✅
4.6.94.6.13✅
4.6.94.6.12✅
4.6.84.6.43✅
4.6.84.6.41✅
4.6.84.6.34✅
4.6.84.6.33✅
4.6.84.6.32✅
4.6.84.6.28✅
4.6.84.6.27✅
4.6.84.6.26✅
4.6.84.6.25✅
4.6.84.6.24✅
4.6.84.6.23✅
4.6.84.6.18✅
4.6.84.6.13✅
4.6.84.6.12✅
4.6.84.6.9✅
4.6.74.6.43✅
4.6.74.6.41✅
4.6.74.6.34✅
4.6.74.6.33✅
4.6.74.6.32✅
4.6.74.6.28✅
4.6.74.6.27✅
4.6.74.6.26✅
4.6.74.6.25✅
4.6.74.6.24✅
4.6.74.6.23✅
4.6.74.6.18✅
4.6.74.6.13✅
4.6.74.6.12✅
4.6.74.6.9✅
4.6.74.6.8✅
4.6.64.6.43✅
4.6.64.6.41✅
4.6.64.6.34✅
4.6.64.6.33✅
4.6.64.6.32✅
4.6.64.6.28✅
4.6.64.6.27✅
4.6.64.6.26✅
4.6.64.6.25✅
4.6.64.6.24✅
4.6.64.6.23✅
4.6.64.6.18✅
4.6.64.6.13✅
4.6.64.6.12✅
4.6.64.6.9✅
4.6.64.6.8✅
4.6.64.6.7✅
4.5.234.6.43✅
4.5.234.6.41✅
4.5.234.6.34✅
4.5.234.6.33✅
4.5.234.6.32✅
4.5.234.6.28✅
4.5.234.6.27✅
4.5.234.6.26✅
4.5.234.6.25✅
4.5.234.6.24✅
4.5.234.6.23✅
4.5.234.6.18✅
4.5.214.6.43✅
4.5.214.6.41✅
4.5.214.6.34✅
4.5.214.6.33✅
4.5.214.6.32✅
4.5.214.6.28✅
4.5.214.6.27✅
4.5.214.6.26✅
4.5.214.6.25✅
4.5.214.6.24✅
4.5.214.6.23✅
4.5.214.6.18✅
4.5.214.6.13✅
4.5.214.6.12✅
4.5.214.6.9✅
4.5.214.6.8✅
4.5.214.6.7✅
4.5.214.6.6✅
4.5.204.6.43✅
4.5.204.6.41✅
4.5.204.6.34✅
4.5.204.6.33✅
4.5.204.6.32✅
4.5.204.6.28✅
4.5.204.6.27✅
4.5.204.6.26✅
4.5.204.6.25✅
4.5.204.6.24✅
4.5.204.6.23✅
4.5.204.6.18✅
4.5.204.6.13✅
4.5.204.6.12✅
4.5.204.6.9✅
4.5.204.6.8✅
4.5.204.6.7✅
4.5.204.6.6✅
4.4.244.6.43✅
4.4.244.6.41✅
4.4.244.6.34✅
4.4.244.6.33✅
4.4.244.6.32✅
4.4.244.6.28✅
4.4.244.6.27✅
4.4.244.6.26✅
4.4.244.6.25✅
4.4.244.6.24✅
4.4.244.6.23✅

4.5.x

Source VersionTarget VersionSupport
4.5.214.5.23✅
4.5.204.5.23✅
4.5.204.5.21✅
4.5.154.5.23✅
4.5.154.5.21✅
4.5.154.5.20✅
4.5.114.5.23✅
4.5.114.5.21✅
4.5.114.5.20✅
4.5.114.5.15✅
4.5.84.5.23✅
4.5.84.5.21✅
4.5.84.5.20✅
4.5.84.5.15✅
4.5.84.5.11✅
4.5.44.5.23✅
4.5.44.5.21✅
4.5.44.5.20✅
4.5.44.5.15✅
4.5.44.5.11✅
4.5.44.5.8✅
4.4.244.5.23✅
4.4.204.5.23✅
4.4.204.5.21✅
4.4.204.5.20✅
4.4.204.5.15✅
4.4.204.5.11✅
4.4.204.5.8✅
4.4.204.5.4✅

4.4.x

Source VersionTarget VersionSupport
4.4.204.4.23✅
4.4.184.4.23✅
4.4.184.4.20✅
4.4.144.4.23✅
4.4.144.4.20✅
4.4.144.4.18✅
4.4.114.4.23✅
4.4.114.4.20✅
4.4.114.4.18✅
4.4.114.4.14✅
4.4.64.4.23✅
4.4.64.4.20✅
4.4.64.4.18✅
4.4.64.4.14✅
4.4.64.4.11✅
4.3.64.4.23✅
4.3.64.4.20✅
4.3.64.4.18✅
4.3.64.4.14✅
4.3.64.4.11✅
4.3.64.4.6✅

4.3.x and Prior

Source VersionTarget VersionSupport
4.2.134.3.6✅
4.2.74.2.13✅
4.1.x4.3.6❌
4.1.124.2.7✅
4.1.124.1.13✅
4.1.74.2.7✅

Upgrade Guides​

Refer to the respective guide for guidance on upgrading your self-hosted Palette VerteX instance.