Saving Custom Options

Every time Apache is rebuilt, its current configuration is stored as Previously Saved Config, in both the command line and WHM EasyApache interfaces. However, you may still want to store your custom configuration for later use.

To store custom options, you should save the configuration with a file name, display name, and description. You can accomplish this under step 6 in EasyApache, by filling in the required information and clicking Save and build or Save only (Do NOT build). Using the Save only (Do NOT build) button can be useful if you would like to create a profile for a different server.

The Save selections as custom profile box on step 6 of the EasyApache interface.

The custom profile is saved to the /var/cpanel/easy/apache/profile/custom/ directory on your server, and automatically given the filename extension .yaml.

• Once a profile is saved, you can access it in the first step of the EasyApache interface.
• You can delete a custom profile from the WHM interface using the Delete link on the first page of the EasyApache interface. (Profiles installed by cPanel and WHM cannot be deleted.)
  • Deleting a profile is irreversible. You must click Yes to confirm that you want to delete the profile.
  • The command line EasyApache interface does not have a means of deleting profiles; however, you can simply delete the file directly.

Preloading a profile

After you have saved your custom profile, you can easily preload it from the command line interface. To preload your profile, use the following command in a terminal session:

• /scripts/easyapache --profile=$profilename
• https://www.example.com:2087/cgi/easyapache.pl?profile=$profilename == /scripts/easyapache --profile=$profilename

Building from a profile outside of the EasyApache interface

To build Apache from a custom profile without using the interface, use the following command in a terminal session:

• /scripts/easyapache --profile=$profilename --build
• https://www.example.com:2087/cgi/easyapache.pl?profile=$profilename == /scripts/easyapache --profile=$profilename --build

Accessing Information Outside of the EasyApache Interface

You can access information about EasyApache by executing the following script in a terminal session:

• /scripts/easyapache --help
• https://www.example.com:2087/cgi/easyapache.pl?profile=$profilename == /scripts/easyapache --help

Remember: $profilename should be replaced by the name of the profile you wish to use when running the /scripts/easyapache script. It can be formatted as:

• The absolute path to the file to you wish to use as a profile.
• The filename relative to /var/cpanel/easy/apache/profile/custom/ with or without the .yaml extension.
  
  An example of an acceptable entry:
• --profile=/var/cpanel/easy/apache/profile/custom/cpanel_no_php.yaml