From c84321c2b78d01846147ca90b74155a986980a09 Mon Sep 17 00:00:00 2001 From: Alex O'Regan Date: Mon, 2 Nov 2026 14:37:42 +0000 Subject: [PATCH 1/3] [DOCS#CORE-13917]: Tell users to upgrade Forklift after upgrading Calico Enterprise Forklift installed from the Calico Enterprise docs is not touched by a Calico Enterprise upgrade, so users kept running the old release. Each Enterprise upgrade page now ends with a step pointing them to the Forklift install page to install the latest version. Co-Authored-By: Claude Opus 5.5 --- .../upgrading-enterprise/kubernetes-upgrade-tsee/helm.mdx | 4 ++++ .../upgrading-enterprise/kubernetes-upgrade-tsee/operator.mdx | 4 ++++ .../upgrading/upgrading-enterprise/openshift-upgrade.mdx | 4 ++++ .../upgrading-enterprise/kubernetes-upgrade-tsee/helm.mdx | 4 ++++ .../upgrading-enterprise/kubernetes-upgrade-tsee/operator.mdx | 4 ++++ .../upgrading/upgrading-enterprise/openshift-upgrade.mdx | 4 ++++ 6 files changed, 24 insertions(+) diff --git a/calico-enterprise/getting-started/upgrading/upgrading-enterprise/kubernetes-upgrade-tsee/helm.mdx b/calico-enterprise/getting-started/upgrading/upgrading-enterprise/kubernetes-upgrade-tsee/helm.mdx index d799bbb1cb..6b4b6eaa8c 100644 --- a/calico-enterprise/getting-started/upgrading/upgrading-enterprise/kubernetes-upgrade-tsee/helm.mdx +++ b/calico-enterprise/getting-started/upgrading/upgrading-enterprise/kubernetes-upgrade-tsee/helm.mdx @@ -255,3 +255,7 @@ Make sure you have the `CNI Type` defined in your `values.yaml` file, especially If there are any problems you can use `kubectl get tigerastatus -o yaml` to get more details. ::: + +## Upgrade Forklift + +If you installed Forklift by following the $[prodname] docs, upgrading $[prodname] does not upgrade Forklift. After the upgrade, install the latest version by following [Install Forklift on Kubernetes](../../../../networking/kubevirt/install-forklift-kubernetes.mdx). diff --git a/calico-enterprise/getting-started/upgrading/upgrading-enterprise/kubernetes-upgrade-tsee/operator.mdx b/calico-enterprise/getting-started/upgrading/upgrading-enterprise/kubernetes-upgrade-tsee/operator.mdx index f2e65fd40d..41da4c3b08 100644 --- a/calico-enterprise/getting-started/upgrading/upgrading-enterprise/kubernetes-upgrade-tsee/operator.mdx +++ b/calico-enterprise/getting-started/upgrading/upgrading-enterprise/kubernetes-upgrade-tsee/operator.mdx @@ -164,3 +164,7 @@ upgraded from Calico. + +## Upgrade Forklift + +If you installed Forklift by following the $[prodname] docs, upgrading $[prodname] does not upgrade Forklift. After the upgrade, install the latest version by following [Install Forklift on Kubernetes](../../../../networking/kubevirt/install-forklift-kubernetes.mdx). diff --git a/calico-enterprise/getting-started/upgrading/upgrading-enterprise/openshift-upgrade.mdx b/calico-enterprise/getting-started/upgrading/upgrading-enterprise/openshift-upgrade.mdx index 858328b339..ce320c3779 100644 --- a/calico-enterprise/getting-started/upgrading/upgrading-enterprise/openshift-upgrade.mdx +++ b/calico-enterprise/getting-started/upgrading/upgrading-enterprise/openshift-upgrade.mdx @@ -231,3 +231,7 @@ The steps differ based on your cluster type. If you are unsure of your cluster t ```bash kubectl delete -f $[filesUrl]/manifests/default-tier-policies.yaml ``` + +## Upgrade Forklift + +If you installed Forklift by following the $[prodname] docs, upgrading $[prodname] does not upgrade Forklift. After the upgrade, install the latest version by following [Install Forklift on OpenShift](../../../networking/kubevirt/install-forklift-openshift.mdx). diff --git a/calico-enterprise_versioned_docs/version-3.24-2/getting-started/upgrading/upgrading-enterprise/kubernetes-upgrade-tsee/helm.mdx b/calico-enterprise_versioned_docs/version-3.24-2/getting-started/upgrading/upgrading-enterprise/kubernetes-upgrade-tsee/helm.mdx index 40f3384191..7ccc92c979 100644 --- a/calico-enterprise_versioned_docs/version-3.24-2/getting-started/upgrading/upgrading-enterprise/kubernetes-upgrade-tsee/helm.mdx +++ b/calico-enterprise_versioned_docs/version-3.24-2/getting-started/upgrading/upgrading-enterprise/kubernetes-upgrade-tsee/helm.mdx @@ -247,3 +247,7 @@ Make sure you have the `CNI Type` defined in your `values.yaml` file, especially If there are any problems you can use `kubectl get tigerastatus -o yaml` to get more details. ::: + +## Upgrade Forklift + +If you installed Forklift by following the $[prodname] docs, upgrading $[prodname] does not upgrade Forklift. After the upgrade, install the latest version by following [Install Forklift on Kubernetes](../../../../networking/kubevirt/install-forklift-kubernetes.mdx). diff --git a/calico-enterprise_versioned_docs/version-3.24-2/getting-started/upgrading/upgrading-enterprise/kubernetes-upgrade-tsee/operator.mdx b/calico-enterprise_versioned_docs/version-3.24-2/getting-started/upgrading/upgrading-enterprise/kubernetes-upgrade-tsee/operator.mdx index 6d596b6503..6a8a54d27e 100644 --- a/calico-enterprise_versioned_docs/version-3.24-2/getting-started/upgrading/upgrading-enterprise/kubernetes-upgrade-tsee/operator.mdx +++ b/calico-enterprise_versioned_docs/version-3.24-2/getting-started/upgrading/upgrading-enterprise/kubernetes-upgrade-tsee/operator.mdx @@ -171,3 +171,7 @@ upgraded from Calico. + +## Upgrade Forklift + +If you installed Forklift by following the $[prodname] docs, upgrading $[prodname] does not upgrade Forklift. After the upgrade, install the latest version by following [Install Forklift on Kubernetes](../../../../networking/kubevirt/install-forklift-kubernetes.mdx). diff --git a/calico-enterprise_versioned_docs/version-3.24-2/getting-started/upgrading/upgrading-enterprise/openshift-upgrade.mdx b/calico-enterprise_versioned_docs/version-3.24-2/getting-started/upgrading/upgrading-enterprise/openshift-upgrade.mdx index 04bb6116c2..dc116a78ce 100644 --- a/calico-enterprise_versioned_docs/version-3.24-2/getting-started/upgrading/upgrading-enterprise/openshift-upgrade.mdx +++ b/calico-enterprise_versioned_docs/version-3.24-2/getting-started/upgrading/upgrading-enterprise/openshift-upgrade.mdx @@ -256,3 +256,7 @@ The steps differ based on your cluster type. If you are unsure of your cluster t ```bash kubectl delete -f $[filesUrl]/manifests/default-tier-policies.yaml ``` + +## Upgrade Forklift + +If you installed Forklift by following the $[prodname] docs, upgrading $[prodname] does not upgrade Forklift. After the upgrade, install the latest version by following [Install Forklift on OpenShift](../../../networking/kubevirt/install-forklift-openshift.mdx). From 74ef12f6d496daf85a1eef565c520fb4d00ec333 Mon Sep 17 00:00:00 2001 From: Alex O'Regan Date: Mon, 2 Nov 2026 16:30:35 +0000 Subject: [PATCH 2/3] [DOCS#CORE-13917]: Frame the upgrade step around optional VM components Co-Authored-By: Claude Opus 5.5 --- .../upgrading-enterprise/kubernetes-upgrade-tsee/helm.mdx | 4 ++-- .../upgrading-enterprise/kubernetes-upgrade-tsee/operator.mdx | 4 ++-- .../upgrading/upgrading-enterprise/openshift-upgrade.mdx | 4 ++-- .../upgrading-enterprise/kubernetes-upgrade-tsee/helm.mdx | 4 ++-- .../upgrading-enterprise/kubernetes-upgrade-tsee/operator.mdx | 4 ++-- .../upgrading/upgrading-enterprise/openshift-upgrade.mdx | 4 ++-- 6 files changed, 12 insertions(+), 12 deletions(-) diff --git a/calico-enterprise/getting-started/upgrading/upgrading-enterprise/kubernetes-upgrade-tsee/helm.mdx b/calico-enterprise/getting-started/upgrading/upgrading-enterprise/kubernetes-upgrade-tsee/helm.mdx index 6b4b6eaa8c..9500e154fa 100644 --- a/calico-enterprise/getting-started/upgrading/upgrading-enterprise/kubernetes-upgrade-tsee/helm.mdx +++ b/calico-enterprise/getting-started/upgrading/upgrading-enterprise/kubernetes-upgrade-tsee/helm.mdx @@ -256,6 +256,6 @@ If there are any problems you can use `kubectl get tigerastatus -o yaml` to get ::: -## Upgrade Forklift +## Upgrade VM and L2-Specific Components -If you installed Forklift by following the $[prodname] docs, upgrading $[prodname] does not upgrade Forklift. After the upgrade, install the latest version by following [Install Forklift on Kubernetes](../../../../networking/kubevirt/install-forklift-kubernetes.mdx). +If you have VM-specific components installed such as the $[prodname] fork of Forklift, upgrading $[prodname] does not upgrade them. After the upgrade, install the latest version of Forklift by following [Install Forklift on Kubernetes](../../../../networking/kubevirt/install-forklift-kubernetes.mdx). diff --git a/calico-enterprise/getting-started/upgrading/upgrading-enterprise/kubernetes-upgrade-tsee/operator.mdx b/calico-enterprise/getting-started/upgrading/upgrading-enterprise/kubernetes-upgrade-tsee/operator.mdx index 41da4c3b08..4abd8df955 100644 --- a/calico-enterprise/getting-started/upgrading/upgrading-enterprise/kubernetes-upgrade-tsee/operator.mdx +++ b/calico-enterprise/getting-started/upgrading/upgrading-enterprise/kubernetes-upgrade-tsee/operator.mdx @@ -165,6 +165,6 @@ upgraded from Calico. -## Upgrade Forklift +## Upgrade VM and L2-Specific Components -If you installed Forklift by following the $[prodname] docs, upgrading $[prodname] does not upgrade Forklift. After the upgrade, install the latest version by following [Install Forklift on Kubernetes](../../../../networking/kubevirt/install-forklift-kubernetes.mdx). +If you have VM-specific components installed such as the $[prodname] fork of Forklift, upgrading $[prodname] does not upgrade them. After the upgrade, install the latest version of Forklift by following [Install Forklift on Kubernetes](../../../../networking/kubevirt/install-forklift-kubernetes.mdx). diff --git a/calico-enterprise/getting-started/upgrading/upgrading-enterprise/openshift-upgrade.mdx b/calico-enterprise/getting-started/upgrading/upgrading-enterprise/openshift-upgrade.mdx index ce320c3779..bce71442a3 100644 --- a/calico-enterprise/getting-started/upgrading/upgrading-enterprise/openshift-upgrade.mdx +++ b/calico-enterprise/getting-started/upgrading/upgrading-enterprise/openshift-upgrade.mdx @@ -232,6 +232,6 @@ The steps differ based on your cluster type. If you are unsure of your cluster t kubectl delete -f $[filesUrl]/manifests/default-tier-policies.yaml ``` -## Upgrade Forklift +## Upgrade VM and L2-Specific Components -If you installed Forklift by following the $[prodname] docs, upgrading $[prodname] does not upgrade Forklift. After the upgrade, install the latest version by following [Install Forklift on OpenShift](../../../networking/kubevirt/install-forklift-openshift.mdx). +If you have VM-specific components installed such as the $[prodname] fork of Forklift, upgrading $[prodname] does not upgrade them. After the upgrade, install the latest version of Forklift by following [Install Forklift on OpenShift](../../../networking/kubevirt/install-forklift-openshift.mdx). diff --git a/calico-enterprise_versioned_docs/version-3.24-2/getting-started/upgrading/upgrading-enterprise/kubernetes-upgrade-tsee/helm.mdx b/calico-enterprise_versioned_docs/version-3.24-2/getting-started/upgrading/upgrading-enterprise/kubernetes-upgrade-tsee/helm.mdx index 7ccc92c979..759ff0dc22 100644 --- a/calico-enterprise_versioned_docs/version-3.24-2/getting-started/upgrading/upgrading-enterprise/kubernetes-upgrade-tsee/helm.mdx +++ b/calico-enterprise_versioned_docs/version-3.24-2/getting-started/upgrading/upgrading-enterprise/kubernetes-upgrade-tsee/helm.mdx @@ -248,6 +248,6 @@ If there are any problems you can use `kubectl get tigerastatus -o yaml` to get ::: -## Upgrade Forklift +## Upgrade VM and L2-Specific Components -If you installed Forklift by following the $[prodname] docs, upgrading $[prodname] does not upgrade Forklift. After the upgrade, install the latest version by following [Install Forklift on Kubernetes](../../../../networking/kubevirt/install-forklift-kubernetes.mdx). +If you have VM-specific components installed such as the $[prodname] fork of Forklift, upgrading $[prodname] does not upgrade them. After the upgrade, install the latest version of Forklift by following [Install Forklift on Kubernetes](../../../../networking/kubevirt/install-forklift-kubernetes.mdx). diff --git a/calico-enterprise_versioned_docs/version-3.24-2/getting-started/upgrading/upgrading-enterprise/kubernetes-upgrade-tsee/operator.mdx b/calico-enterprise_versioned_docs/version-3.24-2/getting-started/upgrading/upgrading-enterprise/kubernetes-upgrade-tsee/operator.mdx index 6a8a54d27e..17920db426 100644 --- a/calico-enterprise_versioned_docs/version-3.24-2/getting-started/upgrading/upgrading-enterprise/kubernetes-upgrade-tsee/operator.mdx +++ b/calico-enterprise_versioned_docs/version-3.24-2/getting-started/upgrading/upgrading-enterprise/kubernetes-upgrade-tsee/operator.mdx @@ -172,6 +172,6 @@ upgraded from Calico. -## Upgrade Forklift +## Upgrade VM and L2-Specific Components -If you installed Forklift by following the $[prodname] docs, upgrading $[prodname] does not upgrade Forklift. After the upgrade, install the latest version by following [Install Forklift on Kubernetes](../../../../networking/kubevirt/install-forklift-kubernetes.mdx). +If you have VM-specific components installed such as the $[prodname] fork of Forklift, upgrading $[prodname] does not upgrade them. After the upgrade, install the latest version of Forklift by following [Install Forklift on Kubernetes](../../../../networking/kubevirt/install-forklift-kubernetes.mdx). diff --git a/calico-enterprise_versioned_docs/version-3.24-2/getting-started/upgrading/upgrading-enterprise/openshift-upgrade.mdx b/calico-enterprise_versioned_docs/version-3.24-2/getting-started/upgrading/upgrading-enterprise/openshift-upgrade.mdx index dc116a78ce..f5aab436bb 100644 --- a/calico-enterprise_versioned_docs/version-3.24-2/getting-started/upgrading/upgrading-enterprise/openshift-upgrade.mdx +++ b/calico-enterprise_versioned_docs/version-3.24-2/getting-started/upgrading/upgrading-enterprise/openshift-upgrade.mdx @@ -257,6 +257,6 @@ The steps differ based on your cluster type. If you are unsure of your cluster t kubectl delete -f $[filesUrl]/manifests/default-tier-policies.yaml ``` -## Upgrade Forklift +## Upgrade VM and L2-Specific Components -If you installed Forklift by following the $[prodname] docs, upgrading $[prodname] does not upgrade Forklift. After the upgrade, install the latest version by following [Install Forklift on OpenShift](../../../networking/kubevirt/install-forklift-openshift.mdx). +If you have VM-specific components installed such as the $[prodname] fork of Forklift, upgrading $[prodname] does not upgrade them. After the upgrade, install the latest version of Forklift by following [Install Forklift on OpenShift](../../../networking/kubevirt/install-forklift-openshift.mdx). From 3e91927e36ae4555d5879505bd92f66936ab0bed Mon Sep 17 00:00:00 2001 From: Alex O'Regan Date: Tue, 3 Nov 2026 09:39:50 +0000 Subject: [PATCH 3/3] Reword and sentence-case the VM-specific upgrade step --- .../upgrading-enterprise/kubernetes-upgrade-tsee/helm.mdx | 2 +- .../upgrading-enterprise/kubernetes-upgrade-tsee/operator.mdx | 2 +- .../upgrading/upgrading-enterprise/openshift-upgrade.mdx | 2 +- .../upgrading-enterprise/kubernetes-upgrade-tsee/helm.mdx | 2 +- .../upgrading-enterprise/kubernetes-upgrade-tsee/operator.mdx | 2 +- .../upgrading/upgrading-enterprise/openshift-upgrade.mdx | 2 +- 6 files changed, 6 insertions(+), 6 deletions(-) diff --git a/calico-enterprise/getting-started/upgrading/upgrading-enterprise/kubernetes-upgrade-tsee/helm.mdx b/calico-enterprise/getting-started/upgrading/upgrading-enterprise/kubernetes-upgrade-tsee/helm.mdx index 9500e154fa..d2b0938810 100644 --- a/calico-enterprise/getting-started/upgrading/upgrading-enterprise/kubernetes-upgrade-tsee/helm.mdx +++ b/calico-enterprise/getting-started/upgrading/upgrading-enterprise/kubernetes-upgrade-tsee/helm.mdx @@ -256,6 +256,6 @@ If there are any problems you can use `kubectl get tigerastatus -o yaml` to get ::: -## Upgrade VM and L2-Specific Components +## Upgrade VM-specific components If you have VM-specific components installed such as the $[prodname] fork of Forklift, upgrading $[prodname] does not upgrade them. After the upgrade, install the latest version of Forklift by following [Install Forklift on Kubernetes](../../../../networking/kubevirt/install-forklift-kubernetes.mdx). diff --git a/calico-enterprise/getting-started/upgrading/upgrading-enterprise/kubernetes-upgrade-tsee/operator.mdx b/calico-enterprise/getting-started/upgrading/upgrading-enterprise/kubernetes-upgrade-tsee/operator.mdx index 4abd8df955..31e77d0104 100644 --- a/calico-enterprise/getting-started/upgrading/upgrading-enterprise/kubernetes-upgrade-tsee/operator.mdx +++ b/calico-enterprise/getting-started/upgrading/upgrading-enterprise/kubernetes-upgrade-tsee/operator.mdx @@ -165,6 +165,6 @@ upgraded from Calico. -## Upgrade VM and L2-Specific Components +## Upgrade VM-specific components If you have VM-specific components installed such as the $[prodname] fork of Forklift, upgrading $[prodname] does not upgrade them. After the upgrade, install the latest version of Forklift by following [Install Forklift on Kubernetes](../../../../networking/kubevirt/install-forklift-kubernetes.mdx). diff --git a/calico-enterprise/getting-started/upgrading/upgrading-enterprise/openshift-upgrade.mdx b/calico-enterprise/getting-started/upgrading/upgrading-enterprise/openshift-upgrade.mdx index bce71442a3..0e2a07271e 100644 --- a/calico-enterprise/getting-started/upgrading/upgrading-enterprise/openshift-upgrade.mdx +++ b/calico-enterprise/getting-started/upgrading/upgrading-enterprise/openshift-upgrade.mdx @@ -232,6 +232,6 @@ The steps differ based on your cluster type. If you are unsure of your cluster t kubectl delete -f $[filesUrl]/manifests/default-tier-policies.yaml ``` -## Upgrade VM and L2-Specific Components +## Upgrade VM-specific components If you have VM-specific components installed such as the $[prodname] fork of Forklift, upgrading $[prodname] does not upgrade them. After the upgrade, install the latest version of Forklift by following [Install Forklift on OpenShift](../../../networking/kubevirt/install-forklift-openshift.mdx). diff --git a/calico-enterprise_versioned_docs/version-3.24-2/getting-started/upgrading/upgrading-enterprise/kubernetes-upgrade-tsee/helm.mdx b/calico-enterprise_versioned_docs/version-3.24-2/getting-started/upgrading/upgrading-enterprise/kubernetes-upgrade-tsee/helm.mdx index 759ff0dc22..061e489a2f 100644 --- a/calico-enterprise_versioned_docs/version-3.24-2/getting-started/upgrading/upgrading-enterprise/kubernetes-upgrade-tsee/helm.mdx +++ b/calico-enterprise_versioned_docs/version-3.24-2/getting-started/upgrading/upgrading-enterprise/kubernetes-upgrade-tsee/helm.mdx @@ -248,6 +248,6 @@ If there are any problems you can use `kubectl get tigerastatus -o yaml` to get ::: -## Upgrade VM and L2-Specific Components +## Upgrade VM-specific components If you have VM-specific components installed such as the $[prodname] fork of Forklift, upgrading $[prodname] does not upgrade them. After the upgrade, install the latest version of Forklift by following [Install Forklift on Kubernetes](../../../../networking/kubevirt/install-forklift-kubernetes.mdx). diff --git a/calico-enterprise_versioned_docs/version-3.24-2/getting-started/upgrading/upgrading-enterprise/kubernetes-upgrade-tsee/operator.mdx b/calico-enterprise_versioned_docs/version-3.24-2/getting-started/upgrading/upgrading-enterprise/kubernetes-upgrade-tsee/operator.mdx index 17920db426..bce2375efe 100644 --- a/calico-enterprise_versioned_docs/version-3.24-2/getting-started/upgrading/upgrading-enterprise/kubernetes-upgrade-tsee/operator.mdx +++ b/calico-enterprise_versioned_docs/version-3.24-2/getting-started/upgrading/upgrading-enterprise/kubernetes-upgrade-tsee/operator.mdx @@ -172,6 +172,6 @@ upgraded from Calico. -## Upgrade VM and L2-Specific Components +## Upgrade VM-specific components If you have VM-specific components installed such as the $[prodname] fork of Forklift, upgrading $[prodname] does not upgrade them. After the upgrade, install the latest version of Forklift by following [Install Forklift on Kubernetes](../../../../networking/kubevirt/install-forklift-kubernetes.mdx). diff --git a/calico-enterprise_versioned_docs/version-3.24-2/getting-started/upgrading/upgrading-enterprise/openshift-upgrade.mdx b/calico-enterprise_versioned_docs/version-3.24-2/getting-started/upgrading/upgrading-enterprise/openshift-upgrade.mdx index f5aab436bb..cc12f454ff 100644 --- a/calico-enterprise_versioned_docs/version-3.24-2/getting-started/upgrading/upgrading-enterprise/openshift-upgrade.mdx +++ b/calico-enterprise_versioned_docs/version-3.24-2/getting-started/upgrading/upgrading-enterprise/openshift-upgrade.mdx @@ -257,6 +257,6 @@ The steps differ based on your cluster type. If you are unsure of your cluster t kubectl delete -f $[filesUrl]/manifests/default-tier-policies.yaml ``` -## Upgrade VM and L2-Specific Components +## Upgrade VM-specific components If you have VM-specific components installed such as the $[prodname] fork of Forklift, upgrading $[prodname] does not upgrade them. After the upgrade, install the latest version of Forklift by following [Install Forklift on OpenShift](../../../networking/kubevirt/install-forklift-openshift.mdx).