Using Custom Configure Flags

ALERT! Warning: Modifying configure flags can result in a non-functional Apache build. cPanel takes no responsibility for custom changes, nor do we provide any warranty for what you do with this information. Proceed with caution.

Custom Configure Flags

Custom configure flags (also known as “raw opts”) are lines of data that advanced users can add to a specific file on the server in order to customize the configuration of Apache or PHP builds.

To add custom configure flags, you must know the version of Apache and PHP to which you need to add the flag. EasyApache allows you to specify any configure option supported by Apache and/or PHP. Simply place the option in the appropriate file; the files are as follows:

  • For Apache 1.3.x /var/cpanel/easy/apache/rawopts/Apache1
  • For Apache 2.0.x/var/cpanel/easy/apache/rawopts/Apache2
  • For Apache 2.2.x /var/cpanel/easy/apache/rawopts/Apache2_2
  • For all PHP 4.x versions — /var/cpanel/easy/apache/rawopts/all_php4
  • For all PHP 5.x 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

To add a custom flag:

  1. Create the file that corresponds to the version of Apache or PHP for which you would like to add a custom configure flag.
  2. In the file, enter the flag you wish to add.
    • The file will be parsed, and the options properly formatted before EasyApache adds them to the data structure.
    • See the example below for more information about formatting your custom flags.
  3. Save the changes you have made to the file.

Example

PICK Remember: Enter only one item per line.
--with-flag

--path-to-flag=/usr/bin/flag

--my-option=

This will result in the following being added to the configuration file:

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

Skipping Your Custom Configure Flags

If need be, you are able to skip your custom configure flags before build time. This can be useful for troubleshooting purposes.

To skip your custom configure flags:

  1. Type the following command before build time:
    • /scripts/easyapache --skip-rawopts
  2. Rebuild Apache using the /scripts/easyapache script.

If you would prefer to use the WHM interface to skip these custom flags:

  1. Click the Help link on the first EasyApache (Apache Update) screen.
  2. Check 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, the raw opts need to be reconfigured or omitted.

Topic revision: r7 - 08 Oct 2010 - 17:15:44 - Main.MelanieSeibert
EasyApache3.CustomConfigureFlags moved from Sandbox.CustomConfigureFlags on 08 Jun 2009 - 14:47 by Main.JustinSchaefer - put it back