How to Revert an EasyApache Migration

EasyApache 4 is the most current version available with cPanel. If you ran the EasyApache 3 (EA3) to EasyApache 4 (EA4) migration and it caused issues with your site, you can revert the EasyApache conversion. Below, are the steps for how to revert an EasyApache migration after you have completed a conversion from EA3 to EA4.

Revert EasyApache Migration

  1. Connect to your server as root via an SSH connection.
  2. Run the following command:

    /scripts/migrate_ea3_to_ea4 –revert –run

  3. Review the warning that appears. Type ‘y‘ (for yes) and then press Enter to continue.
    root@localhost ~ $ /scripts/migrate_ea3_to_ea4 --revert --run 
    checkyum version 22.3 
    This action will revert your existing EasyApache4 install back to EasyApache3. 
    - While the system runs the migration script, some of cPanel & WHM’s features may not operate completely. 
    - Please wait for the system to complete the script before you attempt anything else on your server. 
    - We apologize for the inconvenience. 
     
    - Do you wish to continue? [y/n]
  4. The revert process will generally take longer than the migration process. However, once completed a message is displayed:

    "info [migrate_ea3_to_ea4] EasyApache 4 has successfully been reverted. A record of this process may be found at : /usr/local/cpanel/logs/packman/migrate_ea3_to_ea4.Wed_Oct_25_16:44:12_2017.log" 
    root@localhost ~ $ 

Now that you are familiar with reverting an EasyApache migration, you can continue to use EA3 on your server. However, you should consider updating EasyApache, as you will not be able to further update cPanel, as it is no longer supported and scheduled for deprecation in January 2018. If you upgrade to EasyApache 4 and continue to have issues be sure to check out our guide on installing PHP Extensions/Modules. It’s possible that the migration may not have included all the previously installed Apache and PHP Modules. Therefore, reviewing the migration output (to identify missing modules) and installing them may help correct any persisting issues. Additionally, you can check out our “How to Update EasyApache 3 to EasyApache 4” guide’s Advanced Troubleshooting section for more help.

Leave a Reply