Skip to end of metadata
Go to start of metadata

Overview

WHM's EasyApache 3 interface (Home >> Software >> EasyApache 3) provides a five stage process to select the options that you wish EasyApache to build. The interface includes EasyApache configuration options and access to additional information about the process.

Important:

We strongly recommend that you update your cPanel & WHM version before you run EasyApache. The content available in EasyApache depends on your version of cPanel & WHM. 

  • We do not support EasyApache functionality on versions of cPanel & WHM that have reached End of Life (EOL). If your version of cPanel & WHM does not support a new feature in EasyApache, your server will not have access to that feature.
  • If you experience issues with EasyApache on an EOL version of cPanel & WHM, use WHM's Upgrade to Latest Version interface (Home >> cPanel >> Upgrade to Latest Version) to update your server to a newer version.
  • For more information on our EOL policy, read our cPanel & WHM Long-Term Support documentation.

Warning:

Currently, EasyApache 3 is no longer in development and only receives security updates. EasyApache 3 is tentatively scheduled for deprecation at some point in 2018. You will receive at least three months notification prior to official deprecation. After that time, EasyApache 3 will no longer receive any updates. For more information, read our cPanel Long-Term Support documentation.

We strongly recommend that you upgrade to EasyApache 4. For more information, read our EasyApache 4 documentation. 

Featured documentation

  EasyApache 3

IntroductionFAQ

Change Log Release Notes  

ProfilesCustomization

Tomcat

Migrate from Tomcat 5.5 to 7

How to Deploy Java Applications

Important:

EasyApache 3 does not support Tomcat for new installations. EasyApache 4 does not support Tomcat and we do not plan to provide support in the future. 

The Profile stage

When you open the EasyApache 3 interface, EasyApache checks for available updates and displays the Profile stage.

In the Profile stage, select the profile that you wish use as a template to build your EasyApache profile. You can choose a pre-existing profile, or you can build a custom profile from a pre-existing profile.

  • To initiate the EasyApache build process directly from the Profile stage, select the profile that you wish to use and click Build Profile.

  • If you experience issues with your EasyApache build, select the Basic profile. For more information, click the Show Info link under the Basic profile.

Note:

To remove the CloudLinuxpromotions, select the Remove the Upgrade to CloudLinux banner from the EasyApache interface checkbox in the Preferences section of the Exhaustive Options List stage.

For more information about the Profile stage, read our EasyApache Profile Stage documentation.

For more information about the help options available in the Profile stage, read our EasyApache Help documentation.

The configuration stages

The following table describes the configuration stages of WHM's EasyApache 3 interface. The EasyApache command line interface script (/scripts/easyapache) follows the same stages.

StageDescription
Apache Version

Select the version of Apache that you wish to use. 

Note:

For more information about the changes between Apache version 2.2 and Apache version 2.4, read our Critical Changes In Apache 2.4 documentation.

PHP Version

Select the version of PHP that you wish to use.

Note:

For more information about PHP, read our PHP documentation.

Short Options List and Exhaustive Options List

These two stages of the the EasyApache 3 interface allow you to select the modules that you wish to use.

  • Only the options compatible with your current Apache, PHP, and cPanel & WHM versions will display in the Short Options List and the Exhaustive Options List stages.
  • You can initiate the EasyApache build process, or save the profile for later use.

Warnings:

  • Only select the features that you wish to use.
  • Be sure to read the descriptions and documentation on each feature that you wish to use in your EasyApache profile.

Note:

For more information on the options in these stages, read our module documentation:

The build process

After you initiate the build process, EasyApache requires two confirmations to ensure that you are ready to begin the build process.

  1. Click OK to continue the build.
    • If you click Cancel, EasyApache will not build and install the profile that you created.
  2. To acknowledge that the termination of the build process results in the loss of data, click I Understand.
    • The build process requires several minutes to complete.
    • At any point in the build process, you can use the following four links at the top of the interface:
      • Profile details — Open a small window that displays the profile's active Apache and PHP versions. To view the Apache documentation for any of the listed features, click More Info next to your selection. 
      • Raw profile — Open a small window that displays the profile in plain text.
      • Download profile — Download a copy of the EasyApache profile in plain text. Use this option if you wish to install the same EasyApache profiles across a number of servers without the need to configure each one individually.
      • About Profiles — Open a small window that contains general information about EasyApache profiles, which includes where the profiles reside and the information they contain.
  3. WHM displays information about the EasyApache process while EasyApache builds your new configuration.
    • Click Show More Build Details to enlarge the build process window.
    • Click Disable Auto Scroll to prevent the text box's ability to automatically scroll along with the build information.

      Note:

      You cannot reenable autoscroll after you disable it.

  4. After the build completes, you must configure suEXEC and PHP. For details about these options, read our Configure PHP and suEXEC documentation.
  5. Click Save New Configuration.
    • WHM displays your new PHP and suEXEC configuration. You can close the Configure Suexec and PHP window.
    • To edit the PHP and suEXEC configuration at any point, access the PHP and SuExec Configuration option from WHM’s Apache Configuration interface (Home >> Service Configuration >> Apache Configuration).
  6. The server automatically saves your custom profile.

Note:

After the build is complete, the Download Log link downloads a detailed, plain text log of the build process.