Product SiteDocumentation Site

11.2. Migrating Apache HTTP Server Configuration Files

11.2.1. Migrating Apache HTTP Server 2.0 Configuration Files

This section outlines migration from version 2.0 to 2.2. If you are migrating from version 1.3, please refer to Section 11.2.2, “Migrating Apache HTTP Server 1.3 Configuration Files to 2.0”.
  • Configuration files and startup scripts from version 2.0 need minor adjustments particularly in module names which may have changed. Third party modules which worked in version 2.0 can also work in version 2.2 but need to be recompiled before you load them. Key modules that need to be noted are authentication and authorization modules. For each of the modules which has been renamed the LoadModule line will need to be updated.
  • The mod_userdir module will only act on requests if you provide a UserDir directive indicating a directory name. If you wish to maintain the procedures used in version 2.0, add the directive UserDir public_html in your configuration file.
  • To enable SSL, edit the httpd.conf file adding the necessary mod_ssl directives. Use apachectl start as apachectl startssl is unavailable in version 2.2. You can view an example of SSL configuration for httpd in conf/extra/httpd-ssl.conf.
  • To test your configuration it is advisable to use service httpd configtest which will detect configuration errors.
More information on upgrading from version 2.0 to 2.2 can be found on