Pre-Upgrade Preparation
Supported upgrade paths:
- From
4.0→4.2 - From
4.1→4.2
Before starting, ensure your current platform version is within the supported upgrade range.
TOC
Important Notes
- Ensure the directory
/cpaas/minioon the control plane nodes of global cluster has at least 120 GB of free disk space. - Make sure that ALL clusters are running Kubernetes versions within the supported range. See details below.
Kubernetes prerequisites
- ALL clusters MUST be running a Kubernetes version newer than 1.32.
Run the Checklist
Contact technical support to obtain the checklist script and run it against the target platform to verify upgrade readiness.
Download the Packages
From the Customer Portal, download the Core Package.
If you want to upgrade cluster Extensions during the upgrade, follow these steps:
- Navigate to the following path: [Marketplace - Batch Download - Upgrade - Post-ACP v4.0 Upgrades]
- Download the
ac-get-app.sh. - Upload the script to the control node of Global cluster in your environment.
- Run the script with
bash ac-get-app.sh. - After it finishes, import the generated
apps.yamlback into the Customer Portal to align the extensions list.
In addition, navigate to the CLI Tools section in the Customer Portal and download the violet tool. This tool is required for uploading Extensions. For more information about violet, see Upload Packages.
If any cluster installed the Build of TopoLVM, upload that plugin before you proceed with the upgrade. Run the following command:
Starting with v4.2, we introduced a new plugin named Alauda Container Platform Log Essentials. If you previously installed the log storage plugin, you also have to upload that plugin before starting the upgrade.
Before upgrading, please verify whether the nodes in the global cluster have enabled global Cluster Platform Node Isolation , You need to contact technical support to get the corresponding solution.