Page tree
Skip to end of metadata
Go to start of metadata

Overview

Warning:

Modified raw opts can result in a non-functional Apache build. cPanel, Inc. assumes no responsibility for custom changes, nor do we provide any warranty for what you do with this information. Proceed with caution.

Raw opts (or custom configure flags) are lines of data that advanced users can add to a specific file on the server to customize the configuration of the make command, Apache, PHP, or ModSecurity™. EasyApache allows you to specify any configuration options that the make command, Apache, PHP, or ModSecurity supports.

Raw Opts

The following list contains the correct filenames for ModSecurity™, the make command, and for each version of Apache and PHP for which you can configure flags:

Important:

You must manually create the following files in the /var/cpanel/easy/apache/rawopts directory before you add a custom flag.
  • For Apache 2.2 — /var/cpanel/easy/apache/rawopts/Apache2_2
  • For Apache 2.4 — /var/cpanel/easy/apache/rawopts/Apache2_4
  • For all PHP 4 versions — /var/cpanel/easy/apache/rawopts/all_php4
  • For all PHP 5 versions — /var/cpanel/easy/apache/rawopts/all_php5
  • For Mod_suPHP — /var/cpanel/easy/apache/rawopts/all_suphp
  • For a specific PHP Version — /var/cpanel/easy/apache/rawopts/PHP-X.X.X
  • For ModSecurity — /var/cpanel/easy/apache/rawopts/ModSecurity
  • For the  make command —  /var/cpanel/easy/apache/rawopts/make

Warning:

We no longer develop EasyApache 3 and only release security updates. We will deprecate EasyApache 3 on December 31, 2018. After that date, we will no longer update EasyApache 3. In cPanel & WHM version 78, we will remove support for EasyApache 3. 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. 

Add a custom flag

 

To add a custom flag, perform the following steps:

  1. Create the file that corresponds to the version of Apache or PHP that will receive the custom flag.
  2. In the file, enter the flag that you wish to add.
    • EasyApache parses the flag and formats the options properly before it adds them to the data structure.
  3. Save your changes.

Example of Custom Flag with data

Note:

Enter only one item per line.

--with-module
--path-to-module=/usr/bin/module
--my-option=

This data results in the following command-line structure:

--with-module --path-to-module=/usr/bin/module --my-option

Raw opts with Apache 2.4

If you use raw opts to add statically-compiled functionality into the Apache binary, then you must change the --with-module flag to the --with-module=static flag. The module will not compile if =static is not included. 

Raw opts with ModSecurity

If you use raw opts to call the fuzzyHash operator in ModSecurity, you must install ssdeep. You must also add the --with-ssdeep=<path/to/ssdeep> flag to your raw opts file. If you do not include this, the operator will not function. 

Raw opts with the make command

EasyApache passes the -j2 option by default if your system uses more than one core. Set options in this file to compile EasyApache with a different number of cores. 

Note:

If this file does not exist or is empty, EasyApache uses its default behavior.

How to skip your raw opts

If you experience problems with your Apache builds, you can skip your raw opts before build time. This can be useful for troubleshooting purposes.

To skip your raw opts with the command line interface, perform the following steps:

  1. Run the following script before you issue the build command:

    /scripts/easyapache --skip-rawopts

    Rebuild Apache with the /scripts/easyapache script.

To skip your raw opts with the WHM interface, perform the following steps:

  1. Click the Help link.
  2. Select the Do not use raw opts support checkbox.
  3. Click Submit.
  4. Return to the previous screen and build the profile.

If the build completes successfully, you must reconfigure or omit your raw opts.