Migrating EasyApache 3 to EasyApache 4


Browse by products and services

  • Applies to: DV
    • Difficulty: Easy
    • Time Needed: 10
    • Tools Required: WHM access, SSH access

Overview

As of December 31st, 2018, EasyApache 3 has been deprecated by its developers, and is longer receiving updates. Due to this fact, if your server still running EasyApache 3, it's recommended to make the migration to EasyApache 4 as soon as possible. Fortunately, this process can be completed usually within a few minutes. The following guide will provide instruction on how you can perform this update.

READ ME FIRST
Please keep in mind that troubleshooting the configuration/functionality of third-party applications is not covered by our statement of support. These resources were provided as a courtesy to assist you to the extent of our abilities. For more information on our statement of support, feel free to click here.

Prerequisites

  • EasyApache 4 requires WHM/cPanel version 58 or higher.
    • The WHM version can be viewed by logging into WHM, and looking in the upper-right hand corner:

      cp-1.png

  • EasyApache 4 requires at least CentOS6 or CentOS7.
    • The CentOS version can be viewed by logging into WHM, and looking in the upper-right hand corner:

      cp-2.png

  • EasyApache 4 only supports PHP 5.4 and above. If you are on an older version of PHP, your site(s) may lose some functionality.
    • The current PHP version can be viewed in WHM >> Software >> EasyApache 3:

      cp-9.png

  • EasyApache 4 requires Apache 2.4 or newer.
    • The current Apache version can be viewed in WHM >> Software >> EasyApache 3:

      cp-10.png

  • EasyApache 4 requires MySQL 5.6 or higher.
    • The current MySQL version can be viewed in phpMyAdmin.

      cp-11.png

  • MPMs may be added/removed.
  • A server level backup is also recommended:

Instructions

WHM

  1. Log into WHM.
  2. In the left-hand menu, look for Software >> EasyApache 4.

    cp-4.5.png

  3. Click EasyApache 4 Migration.

    cp-5.png
  4. WHM will prompt warnings regarindg configuration changes that may occur during the migration. If you do not anticipate issues due to these changes, click Migrate.

    cp-6.png

  5. There will be one last confirmation. To continue, click Yes, run EasyApache 4 Migration.

    cp-7.png

  6. The migration process can take a few minutes. Once completed a confirmation message will prompt.

    cp-8.png

SSH

  1. Connect to your server via SSH as root.
  2. Run the following script:
    /usr/local/cpanel/scripts/migrate_ea3_to_ea4 --run
  3. A message will prompt the following:
    As of cPanel & WHM version 58, EasyApache 4 is stable and ready for production. For more information, read our EasyApache 4 documentation (https://go.cpanel.net/EA4).
    By continuing, you agree that you understand the following information:
    - While the system runs the migration script, some of cPanel & WHM’s features may not operate.
    - Wait for the system to complete the script before you attempt any other actions on your server.
    - If you revert to EasyApache3, the system automatically rebuilds PHP. This may take 15 - 30 minutes or longer to complete.
    - Do you wish to continue? [y/n]
    enter y to continue.

  4. If there are any configuration changes that will occur during the migration, a message will prompt:
     WARNING Adding the missing package, ea-apache24-mod_suexec, to the EasyApache 4 profile.

    WARNING Current profile has the following MPMs: ea-apache24-mod_mpm_prefork

    WARNING “Cpanel::Easy::Apache::Access” ignored since it does not have an RPM.

    WARNING “Cpanel::Easy::Apache::Fileprotect” ignored since it does not have an RPM.

    WARNING “Cpanel::Easy::PHP5::MailHeaders” ignored since it does not have an RPM.

    - Do you wish to continue? [y/n]
    enter y to continue.

  5. Once the migration is complete, a confirmation message will prompt:
    info [migrate_ea3_to_ea4] EasyApache 4 has successfully been installed.

Reverting EasyApache

If it becomes necessary to rever the EasyApache 4 migration, this can be done by running the following script via SSH:

/usr/local/cpanel/scripts/migrate_ea3_to_ea4 --revert --run

Require further assistance?

If you are still unsure about migrating to EasyApache 4, feel free to submit a support request and Media Temple can attempt to perform the migration for you (free of charge). Do keep in mind your server must meet the appropriate prerequistes mentioned above.

In your request, please be specific about which server you wish to have an EasyApache migration performed on.