Page tree

Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Table of Contents
stylenone

Warning
titleImportant:

This document only applies to cPanel & WHM version 76 or earlier. You must migrate to EasyApache 4 before you can upgrade to cPanel & WHM version 78.

Overview

The EasyApache 4 Migration Tool allows you to migrate to EasyApache 4. You can access the EasyApache 4 Migration Tool feature from the EasyApache 3 interface (WHM >> Home >> Software >> EasyApache 3). You can also use the EasyApache 4 migration script from the command line. 

For more information about the migration process, read our The EasyApache 3 to EasyApache 4 Migration Process documentation.

Warning
titleImportant:
  • We plan to will deprecate EasyApache 3 on December 31, 2018. To migrate to EasyApache 4, click the EasyApache 4 Migration Tool link at the top of the EasyApache 3 interface (WHM >> Home >> Software >> EasyApache 3). If you do  not  upgrade to EasyApache 4, you  cannot  upgrade to cPanel & WHM version 78.
  • You can not migrate to or revert from EasyApache 4 on a system that runs cPanel & WHM version 78 or later.
  • You can only migrate a system that runs Tomcat in cPanel & WHM version 76 or above. For more information, read our Tomcat documentation.
  • This section of the interface only exists in cPanel & WHM version 60 or later. In cPanel & WHM version 70 and laterthrough 76, you cannot revert with the interface must use the EasyApache 4 migration script if you wish to revert.
  • In cPanel & WHM versions 60 through 66, this section of the interface will not appear unless you select either the EDGE or CURRENT tier in WHM's Update Preferences interface (WHM >> Home >> Server Configuration >> Update Preferences). If you wish to migrate from EasyApache 3 to EasyApache 4 and you select either the RELEASE or STABLE tiers, you must use the  /usr/local/cpanel/scripts/migrate_ea3_to_ea4 script.

...

In cPanel & WHM version 56 and later, EasyApache 4 supports all of cPanel & WHM's supported operating systems.

Settings

You must activate the RPMUP setting if you install EasyApache 4 on your system. The system enables this setting by default. To do this, perform one of the following steps:

...

Migrate from EasyApache 3 to EasyApache 4

...

Localtab Group


Localtab
activetrue
titlecPanel & WHM

...

versions 60 through 76


Warning
titleWarning:

EasyApache 3 blocks cPanel & WHM version 78 and higher. You must migrate to EasyApache 4 in cPanel & WHM version 76 or earlier.


To migrate your server from EasyApache 3 to EasyApache 4, perform the following steps:

  1. Navigate to

...

  1. the EasyApache 4

...

  1.  interface (WHM

...

  1.  >> Home

...

  1.  >> Software

...

  1.  >> EasyApache 4).
  2. Click Migrate. A confirmation message will appear.
  3. To confirm that you wish to migrate,

...

  1. click Yes, run EasyApache 4 Migration. The system will start the EasyApache 4 migration and display the progress log. For more information about the migration process, read our The EasyApache 3 to EasyApache 4 Migration Process documentation.
  2. Click Done. You can also download the progress log for your records.
Note
titleNotes:
  • If your system runs CloudLinux™ and you experience difficulty with the conversion, you may need to run the CloudLinux conversion script to migrate your system.
 
  • If your system runs Tomcat, you must use cPanel & WHM version 76
or higher
  • to migrate to EasyApache 4.

...

  • If your system uses the FCGId Apache module, you must use cPanel & WHM version 76 to migrate to EasyApache 4.
  • If your system uses the FCGId Apache module and your system runs CloudLinux, you must disable the FastCGI option in EasyApache 3 before you start the migration.
  • On systems that do not run CloudLinux, if you receive a message that you must install the Experimental Repository, you must install the repository with the yum install ea4-experimental command, then attempt to migrate the server again.



Localtab
titlecPanel & WHM versions 52

...

through 58

Servers that run cPanel & WHM versions 52 to

...

58 must

...

 use the EasyApache 4 migration script


Revert to EasyApache 3 from EasyApache 4

Notewarning
titleNotesImportant:
  • You can only uninstall EasyApache 4 if you migrated your system from EasyApache 3.
  • You cannot revert to EasyApache 3 if your system runs cPanel & WHM version 78 or later.
  • This action reverts the system to your previous EasyApache 3 installation and configuration.
  • This action attempts to move the Apache files to a new location and revert the server to the previous state.  

...


Localtab Group


Localtab
activetrue
titlecPanel & WHM versions 70 through 76

To revert your system to EasyApache 3 from EasyApache 4, you must use the EasyApache 4 migration script


Localtab
titlecPanel & WHM versions 60 through 68

To revert your system to EasyApache 4 from EasyApache 4, perform the following steps:

  1. Navigate to

...

  1. the EasyApache 3 interface (WHM

...

  1.  >> Home

...

  1.  >> Software

...

  1.  >> EasyApache 3).
  2. Click Revert. A confirmation message will appear.
  3. To confirm that you wish to revert, click Yes, run EasyApache 4 Revert. The system will start the EA4 reversion and display the progress log.
  4. Click Done. You can also download the progress log for your records.

...


Localtab
titlecPanel & WHM versions 52

...

through 58

To revert your system to EasyApache 3 from EasyApache 4,

...

you must

...

 use the EasyApache 4 migration script



Anchor
ea4script
ea4script
Migrate your system on the command line

...

  1. Log in to your server via SSH.
  2. Run the following command as the root user:

    Code Block
    languagebash
    /usr/local/cpanel/scripts/migrate_ea3_to_ea4 --run


    Note
    titleNotes:
    • If your system runs CloudLinux™, the migrate_ea3_to_ea4 script downloads and runs CloudLinux's EasyApache 4 migration script.
    • If your system runs CloudLinux, you cannot use options (for example, the --install_profile option) with the EasyApache 4 migration script.
    • If your system runs CloudLinux, you must disable the FastCGI option in EasyApache 3 before you run the migration script.
    • As the migration script runs, the /scripts/migrate_ea3_to_ea4 script copies the /usr/local/lib/php.ini file to the /opt/cpanel/ea-php??/root/etc/php.d/php.ini file and to all installed ea-php versions on your server. To prevent complications, the system comments out lines that resemble the following lines:
      • extension=
      • extension_dir=
      • zend_extension-
    • The system does not adjust any other lines.
    • On systems that do not run CloudLinux, if you receive a message that you must install the Experimental Repository, you must install the repository with the yum install ea4-experimental command, then attempt to migrate the server again.


  3. The system displays the changes that will occur. To continue, follow the system's instructions. 

...