Pre-Upgrade Preparation
Supported upgrade paths: 3.18 → 4.1, 4.0 → 4.1.
Before upgrading, ensure that your current platform version is within this supported range.
TOC
Important Notes
-
When upgrading the cluster's Kubernetes version to 1.31 or higher, all running Pods will be restarted. This behavior is due to changes in the PodSpec fields introduced in Kubernetes 1.31 and cannot be avoided. For more details, refer to the Kubernetes issue report: #129385.
-
Starting from 4.0, the upgrading procedure of the DR (Disaster Recovery Environment) has changed. Please refer to global DR procedure for the new procedure.
Prerequisites
| Condition | Requirement | If Not Met |
|---|---|---|
| Kubernetes | All clusters running 1.30 or later | Upgrade Kubernetes BEFORE proceeding |
| Service mesh (Istio) | All clusters running 1.22 or later | Upgrade Istio and its instances BEFORE proceeding |
| Elasticsearch logging | Must comply with the fix described in How to Correct the Issue of Node Role Settings in Big Cluster Elasticsearch (see Custom Portal > Knowledge) | Apply the fix before upgrade |
Disk space on /cpaas/minio (global cluster control plane) | At least 120 GB free | Expand storage |
| Disk space for upgrade package extraction | At least 250 GB free if package and extraction path are on the same disk | Free or expand storage |
| Condition | Requirement | If Not Met |
|---|---|---|
| CostManager / Kubecost plugins | Must not be installed (deprecated since 4.0) | Uninstall the plugins |
Download the Packages
From the Custom Portal, download the ACP 4.1 Core Package and the Extensions package.
When downloading Extensions, select the scenario: For upgrading ACP from 3.18.x to 4.1.x.
The Extensions package contains Operators and Cluster Plugins that may require upgrades during the process.
Run the Checklist
Contact technical support to obtain the checklist script and run it against the target platform to verify readiness.
Upgrade from ACP 4.0
Documentation for upgrading from ACP 4.0 will be provided in an upcoming release.