Page tree

Versions Compared

Key

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

Table of Contents
stylenone

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 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).
  • This section of the interface only exists in cPanel & WHM version 60 or later. In cPanel & WHM version 70 and later, you cannot revert with the interface.
  • 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.

Requirements

Operating systems

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:

Apache and PHP

EasyApache 4 only supports Apache version 2.4.

Include Page
LIB:_AvailableVersionsPHP
LIB:_AvailableVersionsPHP

Warning
titleImportant:
  • Each time that you perform a migration from EasyApache 3 to EasyApache 4, the system moves the /usr/local/apache/ directory to the /usr/local/apache.ea3/ directory.
    • If the  /usr/local/apache.ea3 directory exists, the system moves the /usr/local/apache/ directory to the /usr/local/apache.ea3.1/directory.
    • If the /usr/local/apache.ea3.1 directory exists when you run a migration, the migration will fail in order to prevent loss of data.
  • The chance of errors dramatically increases if you migrate your system multiple times. If you revert several times, you must manually delete the previous /usr/local/apache.ea3.1/ backup directory to continue. The system automatically preserves the /usr/local/apache/ directory.

Migrate from EasyApache 3 to EasyApache 4

Servers that run cPanel & WHM version 60 or later

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

  1. Navigate to the EasyApache 4 interface (WHM >> Home >> Software >> EasyApache 4).
  2. Click Migrate. A confirmation message will appear.
  3. To confirm that you wish to migrate, 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.
  4. Click Done. You can also download the progress log for your records.
Note
titleNote:

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. 

Servers that run cPanel & WHM versions 52 to 58

Servers that run cPanel & WHM versions 52 to 58 must use the EasyApache 4 migration script

Revert to EasyApache 3 from EasyApache 4

Note
titleNotes:
  • You can only uninstall EasyApache 4 if you migrated your system from EasyApache 3.
  • 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.  

Systems that run cPanel & WHM versions 60 through 68

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

  1. Navigate to the EasyApache 3 interface (WHM >> Home >> Software >> 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.

Systems that run cPanel & WHM versions 52 to 58, or version 70 or later

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

Use the /usr/local/cpanel/scripts/migrate_ea3_to_ea4 script to install or uninstall EasyApache 4 on the command line.

Migrate to EasyApache 4

  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.
    • 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.


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

Revert to EasyApache 3

Tip
titleRemember:

You can only uninstall EasyApache 4 if you migrated your system from EasyApache 3.

  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 --revert --run


  3. Follow the system's instructions.

Arguments

The migrate_ea3_to_ea4 script accepts the following arguments:

ArgumentDescription
--run

Run the script.

Warning
titleImportant:

You must include the --run option.


--helpDisplay the help information.
--revertRevert the system to the previous version and configuration.
--skip_convertDo not convert and install the EasyApache 3 profile. This flag installs the EasyApache 4 cPanel Default Profile unless you use the --install_profile flag.
--install_profile

Do not convert the EasyApache 3 profile. Instead, install the specified profile.

Code Block
languagebash
 /scripts/migrate_ea3_to_ea4 --run --install_profile /path/to/profile


--convert_fail

When you convert an EasyApache 3 profile to an EasyApache 4 profile, this flag prevents execution of the script's error-correction code.

Warning
titleWarning:

This may cause a failure when you provision your system. However, you may wish to use this flag for tests.


-y | --y | -yes | --yes

Answer yes to all of the script's yes-or-no questions.
--force

When you add the --force argument to the --run or --revert arguments, the system ignores the protection checks.

Warning
titleWarning:

 This may cause a failure when you provision your system.


--reinstallYum attempts to install the required EasyApache 4 RPMs and attempts to reinstall any currently-installed EasyApache 4 packages.


Additional documentation

Localtab Group


Localtab
activetrue
titleSuggested documentation

Content by Label
showLabelsfalse
max5
showSpacefalse
cqllabel in ("ea4","ea3") and label = "whm" and space = currentSpace()


Localtab
titleFor cPanel users

Content by Label
showLabelsfalse
max5
showSpacefalse
cqllabel in ("ea4","ea3") and label = "cpanel" and space = "DOC"


Localtab
titleFor WHM users

Content by Label
showLabelsfalse
max5
showSpacefalse
cqllabel in ("ea4","ea3","howto") and label = "whm" and space in ("DOC","CKB")


Localtab
titleFor developers

Content by Label
showLabelsfalse
max5
showSpacefalse
cqllabel in ("ea4","ea3") and space = "DD"