Upgrade Palette on Kubernetes

danger

The below content is from the former Palette Upgrade page. Convert to partials and refactor where necessary.

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

tip

If you are using Palette VerteX, refer to the VerteX 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 upgrade.

Upgrade Notes

Refer to the following known issues before upgrading:

• 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.

Supported Upgrade Paths

Refer to the following tables for the supported upgrade paths for self-hosted Palette environments installed on a Kubernetes cluster.

danger

Before upgrading Palette 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.

VMware

4.8

info

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

Source Version	Target Version	Support
4.8.25	4.8.33	✅
4.8.22	4.8.33	✅
4.8.16	4.8.33	✅
4.8.16	4.8.25	✅
4.8.16	4.8.21	✅
4.8.12	4.8.33	✅
4.8.12	4.8.25	✅
4.8.12	4.8.21	✅
4.8.12	4.8.16	✅
4.8.9	4.8.33	✅
4.8.9	4.8.25	✅
4.8.9	4.8.21	✅
4.8.9	4.8.16	✅
4.8.9	4.8.12	✅
4.8.8	4.8.33	✅
4.8.8	4.8.25	✅
4.8.8	4.8.21	✅
4.8.8	4.8.16	✅
4.8.8	4.8.12	✅
4.8.8	4.8.9	✅
4.7.31	4.8.33	✅
4.7.29	4.8.25	✅
4.7.29	4.8.21	✅
4.7.29	4.8.16	✅
4.7.29	4.8.12	✅
4.7.29	4.8.9	✅
4.7.29	4.8.8	✅
4.7.27	4.8.21	✅
4.7.27	4.8.16	✅
4.7.27	4.8.12	✅
4.7.27	4.8.9	✅
4.7.27	4.8.8	✅

4.7.x

Source Version	Target Version	Support
4.7.21	4.7.27	✅
4.7.20	4.7.27	✅
4.7.16	4.7.27	✅
4.7.16	4.7.20	✅
4.7.15	4.7.27	✅
4.7.15	4.7.20	✅
4.7.3	4.7.27	✅
4.7.3	4.7.20	✅
4.7.3	4.7.15	✅
4.6.41	4.7.27	✅
4.6.41	4.7.20	✅
4.6.41	4.7.15	✅
4.6.41	4.7.3	✅
4.6.6	4.7.15	✅

4.6.x

Source Version	Target Version	Support
4.6.41	4.6.43	✅
4.6.36	4.6.43	✅
4.6.36	4.6.41	✅
4.6.32	4.6.43	✅
4.6.32	4.6.41	✅
4.6.32	4.6.34	✅
4.6.28	4.6.43	✅
4.6.28	4.6.41	✅
4.6.28	4.6.34	✅
4.6.28	4.6.32	✅
4.6.26	4.6.43	✅
4.6.26	4.6.41	✅
4.6.26	4.6.34	✅
4.6.26	4.6.32	✅
4.6.25	4.6.43	✅
4.6.25	4.6.41	✅
4.6.25	4.6.34	✅
4.6.25	4.6.32	✅
4.6.24	4.6.43	✅
4.6.24	4.6.41	✅
4.6.24	4.6.34	✅
4.6.24	4.6.32	✅
4.6.23	4.6.43	✅
4.6.23	4.6.41	✅
4.6.23	4.6.34	✅
4.6.23	4.6.32	✅
4.6.23	4.6.28	✅
4.6.23	4.6.24	✅
4.6.18	4.6.43	✅
4.6.18	4.6.41	✅
4.6.18	4.6.34	✅
4.6.18	4.6.32	✅
4.6.18	4.6.28	✅
4.6.18	4.6.24	✅
4.6.18	4.6.23	✅
4.6.13	4.6.43	✅
4.6.13	4.6.41	✅
4.6.13	4.6.34	✅
4.6.13	4.6.32	✅
4.6.13	4.6.28	✅
4.6.13	4.6.24	✅
4.6.13	4.6.23	✅
4.6.13	4.6.18	✅
4.6.12	4.6.43	✅
4.6.12	4.6.41	✅
4.6.12	4.6.34	✅
4.6.12	4.6.32	✅
4.6.12	4.6.28	✅
4.6.12	4.6.24	✅
4.6.12	4.6.23	✅
4.6.12	4.6.18	✅
4.6.12	4.6.13	✅
4.6.9	4.6.43	✅
4.6.9	4.6.41	✅
4.6.9	4.6.34	✅
4.6.9	4.6.32	✅
4.6.9	4.6.28	✅
4.6.9	4.6.24	✅
4.6.9	4.6.23	✅
4.6.9	4.6.18	✅
4.6.9	4.6.13	✅
4.6.9	4.6.12	✅
4.6.8	4.6.43	✅
4.6.8	4.6.41	✅
4.6.8	4.6.34	✅
4.6.8	4.6.32	✅
4.6.8	4.6.28	✅
4.6.8	4.6.24	✅
4.6.8	4.6.23	✅
4.6.8	4.6.18	✅
4.6.8	4.6.13	✅
4.6.8	4.6.12	✅
4.6.8	4.6.9	✅
4.6.7	4.6.43	✅
4.6.7	4.6.41	✅
4.6.7	4.6.34	✅
4.6.7	4.6.32	✅
4.6.7	4.6.28	✅
4.6.7	4.6.24	✅
4.6.7	4.6.23	✅
4.6.7	4.6.18	✅
4.6.7	4.6.13	✅
4.6.7	4.6.12	✅
4.6.7	4.6.9	✅
4.6.7	4.6.8	✅
4.6.6	4.6.43	✅
4.6.6	4.6.41	✅
4.6.6	4.6.34	✅
4.6.6	4.6.32	✅
4.6.6	4.6.28	✅
4.6.6	4.6.24	✅
4.6.6	4.6.23	✅
4.6.6	4.6.18	✅
4.6.6	4.6.13	✅
4.6.6	4.6.12	✅
4.6.6	4.6.9	✅
4.6.6	4.6.8	✅
4.6.6	4.6.7	✅
4.5.23	4.6.43	✅
4.5.23	4.6.41	✅
4.5.23	4.6.34	✅
4.5.23	4.6.32	✅
4.5.23	4.6.28	✅
4.5.23	4.6.24	✅
4.5.23	4.6.23	✅
4.5.23	4.6.18	✅
4.5.21	4.6.43	✅
4.5.21	4.6.41	✅
4.5.21	4.6.34	✅
4.5.21	4.6.32	✅
4.5.21	4.6.28	✅
4.5.21	4.6.24	✅
4.5.21	4.6.23	✅
4.5.21	4.6.18	✅
4.5.21	4.6.13	✅
4.5.21	4.6.12	✅
4.5.21	4.6.9	✅
4.5.21	4.6.8	✅
4.5.21	4.6.7	✅
4.5.21	4.6.6	✅
4.5.20	4.6.43	✅
4.5.20	4.6.41	✅
4.5.20	4.6.34	✅
4.5.20	4.6.32	✅
4.5.20	4.6.28	✅
4.5.20	4.6.24	✅
4.5.20	4.6.23	✅
4.5.20	4.6.18	✅
4.5.20	4.6.13	✅
4.5.20	4.6.12	✅
4.5.20	4.6.9	✅
4.5.20	4.6.8	✅
4.5.20	4.6.7	✅
4.5.20	4.6.6	✅
4.4.24	4.6.43	✅
4.4.24	4.6.41	✅
4.4.24	4.6.34	✅
4.4.24	4.6.32	✅
4.4.24	4.6.28	✅
4.4.24	4.6.24	✅
4.4.24	4.6.23	✅

4.5.x

Source Version	Target Version	Support
4.5.21	4.5.23	✅
4.5.20	4.5.23	✅
4.5.20	4.5.21	✅
4.5.15	4.5.23	✅
4.5.15	4.5.21	✅
4.5.15	4.5.20	✅
4.5.11	4.5.23	✅
4.5.11	4.5.21	✅
4.5.11	4.5.20	✅
4.5.11	4.5.15	✅
4.5.8	4.5.23	✅
4.5.8	4.5.21	✅
4.5.8	4.5.20	✅
4.5.8	4.5.15	✅
4.5.8	4.5.11	✅
4.5.4	4.5.23	✅
4.5.4	4.5.21	✅
4.5.4	4.5.20	✅
4.5.4	4.5.15	✅
4.5.4	4.5.11	✅
4.5.4	4.5.8	✅
4.4.24	4.5.23	✅
4.4.20	4.5.23	✅
4.4.20	4.5.21	✅
4.4.20	4.5.20	✅
4.4.20	4.5.15	✅
4.4.20	4.5.11	✅
4.4.20	4.5.8	✅
4.4.20	4.5.4	✅

4.4.x

Source Version	Target Version	Support
4.4.20	4.4.23	✅
4.4.18	4.4.23	✅
4.4.18	4.4.20	✅
4.4.14	4.4.23	✅
4.4.14	4.4.20	✅
4.4.14	4.4.18	✅
4.4.11	4.4.23	✅
4.4.11	4.4.20	✅
4.4.11	4.4.18	✅
4.4.11	4.4.14	✅
4.4.6	4.4.23	✅
4.4.6	4.4.20	✅
4.4.6	4.4.18	✅
4.4.6	4.4.14	✅
4.4.6	4.4.11	✅
4.3.6	4.4.23	✅
4.3.6	4.4.20	✅
4.3.6	4.4.18	✅
4.3.6	4.4.14	✅
4.3.6	4.4.11	✅
4.3.6	4.4.6	✅

4.3.x and Prior

Source Version	Target Version	Support
4.2.13	4.3.6	✅
4.2.7	4.2.13	✅
4.1.x	4.3.6	❌
4.1.12	4.2.7	✅
4.1.12	4.1.13	✅
4.1.7	4.2.7	✅

Kubernetes

4.8

Source Version	Target Version	Support
4.8.25	4.8.33	✅
4.8.22	4.8.33	✅
4.8.16	4.8.33	✅
4.8.16	4.8.21	✅
4.8.12	4.8.33	✅
4.8.12	4.8.21	✅
4.8.12	4.8.16	✅
4.8.9	4.8.33	✅
4.8.9	4.8.21	✅
4.8.9	4.8.16	✅
4.8.9	4.8.12	✅
4.8.8	4.8.33	✅
4.8.8	4.8.21	✅
4.8.8	4.8.16	✅
4.8.8	4.8.12	✅
4.8.8	4.8.9	✅
4.7.31	4.8.33	✅
4.7.29	4.8.33	✅
4.7.29	4.8.21	✅
4.7.29	4.8.16	✅
4.7.29	4.8.12	✅
4.7.29	4.8.9	✅
4.7.29	4.8.8	✅
4.7.27	4.8.33	✅
4.7.27	4.8.21	✅
4.7.27	4.8.16	✅
4.7.27	4.8.12	✅
4.7.27	4.8.9	✅
4.7.27	4.8.8	✅

4.7.x

Source Version	Target Version	Support
4.7.16	4.7.20	✅
4.7.15	4.7.20	✅
4.7.3	4.7.20	✅
4.7.3	4.7.15	✅
4.6.41	4.7.20	✅
4.6.41	4.7.15	✅
4.6.41	4.7.3	✅

4.6.x

Source Version	Target Version	Support
4.6.41	4.6.43	✅
4.6.36	4.6.43	✅
4.6.36	4.6.41	✅
4.6.32	4.6.43	✅
4.6.32	4.6.41	✅
4.6.32	4.6.34	✅
4.6.28	4.6.43	✅
4.6.28	4.6.41	✅
4.6.28	4.6.34	✅
4.6.28	4.6.32	✅
4.6.26	4.6.43	✅
4.6.26	4.6.41	✅
4.6.26	4.6.34	✅
4.6.26	4.6.32	✅
4.6.25	4.6.43	✅
4.6.25	4.6.41	✅
4.6.25	4.6.34	✅
4.6.25	4.6.32	✅
4.6.24	4.6.43	✅
4.6.24	4.6.41	✅
4.6.24	4.6.34	✅
4.6.24	4.6.32	✅
4.6.23	4.6.43	✅
4.6.23	4.6.41	✅
4.6.23	4.6.34	✅
4.6.23	4.6.32	✅
4.6.23	4.6.28	✅
4.6.23	4.6.24	✅
4.6.18	4.6.43	✅
4.6.18	4.6.41	✅
4.6.18	4.6.34	✅
4.6.18	4.6.32	✅
4.6.18	4.6.28	✅
4.6.18	4.6.24	✅
4.6.18	4.6.23	✅
4.6.13	4.6.43	✅
4.6.13	4.6.41	✅
4.6.13	4.6.34	✅
4.6.13	4.6.32	✅
4.6.13	4.6.28	✅
4.6.13	4.6.24	✅
4.6.13	4.6.23	✅
4.6.13	4.6.18	✅
4.6.12	4.6.43	✅
4.6.12	4.6.41	✅
4.6.12	4.6.34	✅
4.6.12	4.6.32	✅
4.6.12	4.6.28	✅
4.6.12	4.6.24	✅
4.6.12	4.6.23	✅
4.6.12	4.6.18	✅
4.6.12	4.6.13	✅
4.6.9	4.6.43	✅
4.6.9	4.6.41	✅
4.6.9	4.6.34	✅
4.6.9	4.6.32	✅
4.6.9	4.6.28	✅
4.6.9	4.6.24	✅
4.6.9	4.6.23	✅
4.6.9	4.6.18	✅
4.6.9	4.6.13	✅
4.6.9	4.6.12	✅
4.6.8	4.6.43	✅
4.6.8	4.6.41	✅
4.6.8	4.6.34	✅
4.6.8	4.6.32	✅
4.6.8	4.6.28	✅
4.6.8	4.6.24	✅
4.6.8	4.6.23	✅
4.6.8	4.6.18	✅
4.6.8	4.6.13	✅
4.6.8	4.6.12	✅
4.6.8	4.6.9	✅
4.6.7	4.6.43	✅
4.6.7	4.6.41	✅
4.6.7	4.6.34	✅
4.6.7	4.6.32	✅
4.6.7	4.6.28	✅
4.6.7	4.6.24	✅
4.6.7	4.6.23	✅
4.6.7	4.6.18	✅
4.6.7	4.6.13	✅
4.6.7	4.6.12	✅
4.6.7	4.6.9	✅
4.6.7	4.6.8	✅
4.6.6	4.6.43	✅
4.6.6	4.6.41	✅
4.6.6	4.6.34	✅
4.6.6	4.6.32	✅
4.6.6	4.6.28	✅
4.6.6	4.6.24	✅
4.6.6	4.6.23	✅
4.6.6	4.6.18	✅
4.6.6	4.6.13	✅
4.6.6	4.6.12	✅
4.6.6	4.6.9	✅
4.6.6	4.6.8	✅
4.6.6	4.6.7	✅
4.5.23	4.6.43	✅
4.5.23	4.6.41	✅
4.5.23	4.6.34	✅
4.5.23	4.6.32	✅
4.5.23	4.6.28	✅
4.5.23	4.6.24	✅
4.5.23	4.6.23	✅
4.5.23	4.6.18	✅
4.5.21	4.6.43	✅
4.5.21	4.6.41	✅
4.5.21	4.6.34	✅
4.5.21	4.6.32	✅
4.5.21	4.6.28	✅
4.5.21	4.6.24	✅
4.5.21	4.6.23	✅
4.5.21	4.6.18	✅
4.5.21	4.6.13	✅
4.5.21	4.6.12	✅
4.5.21	4.6.9	✅
4.5.21	4.6.8	✅
4.5.21	4.6.7	✅
4.5.21	4.6.6	✅
4.5.20	4.6.43	✅
4.5.20	4.6.41	✅
4.5.20	4.6.34	✅
4.5.20	4.6.32	✅
4.5.20	4.6.28	✅
4.5.20	4.6.24	✅
4.5.20	4.6.23	✅
4.5.20	4.6.18	✅
4.5.20	4.6.13	✅
4.5.20	4.6.12	✅
4.5.20	4.6.9	✅
4.5.20	4.6.8	✅
4.5.20	4.6.7	✅
4.5.20	4.6.6	✅
4.4.24	4.6.43	✅
4.4.24	4.6.41	✅
4.4.24	4.6.34	✅
4.4.24	4.6.32	✅
4.4.24	4.6.28	✅
4.4.24	4.6.24	✅
4.4.24	4.6.23	✅

4.5.x

Source Version	Target Version	Support
4.5.21	4.5.23	✅
4.5.20	4.5.23	✅
4.5.20	4.5.21	✅
4.5.15	4.5.23	✅
4.5.15	4.5.21	✅
4.5.15	4.5.20	✅
4.5.11	4.5.23	✅
4.5.11	4.5.21	✅
4.5.11	4.5.20	✅
4.5.11	4.5.15	✅
4.5.8	4.5.23	✅
4.5.8	4.5.21	✅
4.5.8	4.5.20	✅
4.5.8	4.5.15	✅
4.5.4	4.5.23	✅
4.5.4	4.5.21	✅
4.5.4	4.5.20	✅
4.5.4	4.5.15	✅
4.4.20	4.5.23	✅
4.4.20	4.5.21	✅
4.4.20	4.5.20	✅
4.4.20	4.5.15	✅

4.4.x

Source Version	Target Version	Support
4.4.18	4.4.20	✅
4.4.14	4.4.20	✅
4.4.11	4.4.20	✅
4.4.6	4.4.20	✅
4.3.6	4.4.20	✅
4.4.14	4.4.18	✅
4.4.11	4.4.18	✅
4.4.6	4.4.18	✅
4.3.6	4.4.18	✅
4.4.11	4.4.14	✅
4.4.6	4.4.14	✅
4.3.6	4.4.14	✅
4.4.6	4.4.11	✅
4.3.6	4.4.11	✅
4.3.6	4.4.6	✅

4.3.x and Prior

Source Version	Target Version	Support
4.2.13	4.3.6	✅
4.2.7	4.2.13	✅
4.1.x	4.3.6	❌
4.1.12	4.2.7	✅
4.1.7	4.2.7	✅

Palette Management Appliance

tech preview

This is a Tech Preview feature and is subject to change. Do not use this feature in production workloads.

4.8

Source Version	Target Version	Support
4.8.12	4.8.25	✅
4.8.12	4.8.22	✅
4.8.10	4.8.22	✅
4.8.10	4.8.12	✅
4.7.29	4.8.22	✅
4.7.29	4.8.12	✅
4.7.29	4.8.10	✅
4.7.27	4.8.22	✅
4.7.27	4.8.12	✅
4.7.27	4.8.10	✅

4.7

Source Version	Target Version	Support
4.7.15	4.7.27	✅
4.7.3	4.7.27	❌
4.7.3	4.7.15	❌