What is cloudlinux_ea3_to_ea4 script?

Issue

There are some issues with EasyApache profiles

Environment

• CloudLinux OS 6(h)/7(h)/8
• cPanel

Solution

The cloudlinux_ea3_to_ea4 script is used to migrate cPanel EasyApache 3 systems to EasyApache 4. It is also started during CloudLinux installation on cPanel servers when EasyApache 4 is already running.

The cloudlinux_ea3_to_ea4 script installs cl-ea4* repositories. These repositories are identical to EA4 repositories used on a regular CentOS EA4 cPanel servers but contain patched versions of packages. cl-ea4 repos also provide mod_hostinglimits for EA4, mod_lsapi PRO, and other packages for EA4 available for CloudLinux users.

The script can be called manually with:

cd ~; wget https://repo.cloudlinux.com/cloudlinux/sources/cloudlinux_ea3_to_ea4
sh cloudlinux_ea3_to_ea4 --convert

So, you might need to run the cloudlinux_ea3_to_ea4 conversion manually on CloudLinux if you want to migrate to EasyApache 4 from EasyApache 3

The main difference between EasyApache 3 and EasyApache 4 for CloudLinux is the repositories used for Apache RPM packages. For this reason, we need to use packages from the cl-ea4 repository or cl-ea4-testing beta for EasyApache 4. Running this script we update all native ea-* packages from CloudLinux repository. In this case, non-native packages for Apache include mod_lsapi and alt-mod-passenger (CloudLinux feature). So, if mod_lsapi or alt-mod-passenger (or both) were installed on EasyApache 3, the script should be run with the additional options as described here. Our script starts cPanel EasyApache 3 migration to EasyApache 4 Process. Read more about Profile changes, Apache changes, PHP changes.

CloudLinux OS conversion script should migrate EasyApache 4 CentOS to EasyApache 4 CloudLinux repositories when it converts your cPanel server, but if the CentOS > CloudLinux conversion was interrupted, you might need to complete the conversion manually with the same command.

When cPanel is installed with EasyApache 4 on a clean CloudLinux, the installation of the ea-* packages comes from the EA4 cPanel repository. Most packages from the EA4 cPanel repository are not compatible with CloudLinux packages and this can lead to various errors. For this reason, we need to run this script to update the ea-* packages from the CloudLinux repository.

This script also has a couple of other parameters:

If there was a need to return to EasyApache 4 packages from the EA4 cPanel repository, execute:

cd ~; wget https://repo.cloudlinux.com/cloudlinux/sources/cloudlinux_ea3_to_ea4
sh cloudlinux_ea3_to_ea4 --restore-cpanel-ea4-repo

If EasyApache3 was installed on this server and migration to EasyApache4 went wrong, you can try to migrate back with:

cd ~; wget https://repo.cloudlinux.com/cloudlinux/sources/cloudlinux_ea3_to_ea4
sh cloudlinux_ea3_to_ea4 --revert