This guide outlines the process for upgrading from CentOS 7 to AlmaLinux 8 or CloudLinux 7 to CloudLinux 8 using the cPanel ELevate tool.
Important notes before upgrading:
- Review known blockers:
Before proceeding, consult the list of Known cPanel ELevate Blockers to ensure the upgrade won’t conflict with critical software. - Backup Data:
Upgrading the operating system can result in data loss or system failures. Create full backups of your accounts and store them off-server.
Upgrade Procedure:
- Prepare the Server:
- Ensure you have reliable backups of all data.
- Log in to the server as the root user via SSH or use the Terminal in WHM.
- Run the following command to update all out-of-date packages:
yum update
- Update cPanel to the latest version by running:
/scripts/upcp
- Reboot the system to apply changes:
shutdown -r now
- Once the server restarts, log back in as the root user.
- Start the ELevate Process:
- Download the cPanel ELevate Script:
Run the following commands to download and prepare the script:wget -O /scripts/elevate-cpanel https://raw.githubusercontent.com/cpanel/elevate/release/elevate-cpanel; chmod 700 /scripts/elevate-cpanel
- Check for Blockers:
- Identify any potential blockers by running:
/scripts/elevate-cpanel –check
- Resolve Blockers:
Address each issue listed in the output. Repeat the blocker check until no blockers remain:/scripts/elevate-cpanel –check
You should see the message:
“There is no known blockers to start the elevation process.”
- Identify any potential blockers by running:
- Perform the Upgrade:
- Begin the Upgrade Process:
Start the elevation process by running:/scripts/elevate-cpanel –start
- The process may take up to 90 minutes to complete.
- Multiple reboots will occur, and some may take longer than usual.
- Avoid interrupting the upgrade process.
- Monitor Upgrade Status:
Check the progress of the upgrade at any time using:/scripts/elevate-cpanel --status
- Begin the Upgrade Process:
- Download the cPanel ELevate Script:
Post-Upgrade Notes:
- After the upgrade is completed, verify the system is functioning as expected.
- Re-enable or configure any features or customizations previously in use.
Following this guide will help guarantee a smooth transition from CentOS 7 to AlmaLinux 8 or CloudLinux 7 to CloudLinux 8 with minimal disruption.
Looking to install CloudLinux OS on your CentOS server? Learn How to use cPanel to install CloudLinux OS on a CentOS server