[deployment-guide/comm-rel: 608/727] Updated the Apache HTTP Server 2.2 section.
Jaromir Hradilek
jhradile at fedoraproject.org
Tue Oct 19 13:16:44 UTC 2010
commit c98fc1f1df64370058d7f78b9610c116e4b2fe5d
Author: Jaromir Hradilek <jhradile at redhat.com>
Date: Tue Sep 7 13:49:23 2010 +0200
Updated the Apache HTTP Server 2.2 section.
en-US/The_Apache_HTTP_Server.xml | 52 +++++++++++++++++++------------------
1 files changed, 27 insertions(+), 25 deletions(-)
---
diff --git a/en-US/The_Apache_HTTP_Server.xml b/en-US/The_Apache_HTTP_Server.xml
index b96368c..627914c 100644
--- a/en-US/The_Apache_HTTP_Server.xml
+++ b/en-US/The_Apache_HTTP_Server.xml
@@ -17,12 +17,12 @@
<para>
This chapter focuses on the <application>Apache HTTP Server 2.2</application>, a robust, full-featured open source web server developed by the <ulink url="http://www.apache.org/">Apache Software Foundation</ulink>, that is included in &MAJOROSVER;. It describes the basic configuration of the <systemitem class="service">httpd</systemitem> service, and covers advanced topics such as adding server modules, setting up virtual hosts, or configuring the secure HTTP server.
</para>
- <section id="s1-httpd-v2">
+ <section id="s1-apache-version2">
<title>The Apache HTTP Server 2.2</title>
<para>
- There are important differences between the Apache HTTP Server 2.2 and version 2.0, and if you are upgrading from a previous release of &MAJOROS;, you will need to update the <systemitem class="service">httpd</systemitem> configuration accordingly. This section reviews some of the newly added features, and outlines important changes.
+ There are important differences between the Apache HTTP Server 2.2 and version 2.0, and if you are upgrading from a previous release of &MAJOROS;, you will need to update the <systemitem class="service">httpd</systemitem> service configuration accordingly. This section reviews some of the newly added features, outlines important changes, and guides you through the update of older configuration files.
</para>
- <section id="s2-httpd-v2-features">
+ <section id="s2-apache-version2-features">
<title>New Features</title>
<para>
The Apache HTTP Server version 2.2 introduces the following enhancements:
@@ -50,7 +50,7 @@
</listitem>
</itemizedlist>
</section>
- <section id="s2-httpd-v2-changes">
+ <section id="s2-apache-version2-changes">
<title>Notable Changes</title>
<para>
Since version 2.0, few changes have been made to the default <systemitem class="service">httpd</systemitem> service configuration:
@@ -68,38 +68,40 @@
</listitem>
</itemizedlist>
</section>
- </section>
- <section id="s1-httpd-mig">
- <title>Migrating Apache HTTP Server Configuration Files</title>
- <section id="s1-httpd-v22-mig">
- <title>Migrating Apache HTTP Server 2.0 Configuration Files</title>
+ <section id="s1-apache-version2-migrating">
+ <title>Updating the Configuration</title>
<para>
- This section outlines migration from version 2.0 to 2.2. <!-- If you are migrating from version 1.3, please refer to <xref linkend="s3-httpd-v2-mig" />. -->
+ To update the configuration files from the Apache HTTP Server version 2.0, take the following steps:
</para>
- <itemizedlist>
- <listitem>
+ <procedure>
+ <step>
<para>
- 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 <ulink url="http://httpd.apache.org/docs/2.2/mod/mod_so.html#loadmodule"><command>LoadModule</command></ulink> line will need to be updated.
+ Make sure all module names are correct, since they may have changed. Adjust the <option>LoadModule</option> directive for each module that has been renamed.
</para>
- </listitem>
- <listitem>
+ </step>
+ <step>
<para>
- The <command>mod_userdir</command> module will only act on requests if you provide a <command>UserDir</command> directive indicating a directory name. If you wish to maintain the procedures used in version 2.0, add the directive <command>UserDir public_html</command> in your configuration file.
+ Recompile all third party modules before attempting to load them. This typically means authentication and authorization modules.
</para>
- </listitem>
- <listitem>
+ </step>
+ <step>
<para>
- To enable SSL, edit the <filename>httpd.conf</filename> file adding the necessary <command>mod_ssl</command> directives. Use <command>apachectl start</command> as <command>apachectl startssl</command> is unavailable in version 2.2. You can view an example of SSL configuration for httpd in <filename>conf/extra/httpd-ssl.conf</filename>.
+ To use the <systemitem class="resource">mod_userdir</systemitem> module, make sure the <option>UserDir</option> directive indicating a directory name (typically <literal>public_html</literal>) is provided.
</para>
- </listitem>
- <listitem>
+ </step>
+ <step>
<para>
- To test your configuration it is advisable to use <command>service httpd configtest</command> which will detect configuration errors.
+ To enable the use of Secure Sockets Layer (SSL) protocol, edit the <filename>/etc/httpd/conf.d/ssl.conf</filename>.
</para>
- </listitem>
- </itemizedlist>
+ </step>
+ </procedure>
+ <para>
+ Note that you can check the configuration for possible errors by using the following command:
+ </para>
+ <screen>~]# <command>service httpd configtest</command>
+Syntax OK</screen>
<para>
- More information on upgrading from version 2.0 to 2.2 can be found on <ulink url="http://httpd.apache.org/docs/2.2/upgrading.html">http://httpd.apache.org/docs/2.2/upgrading.html</ulink>.
+ For more information on upgrading the Apache HTTP Server configuration from version 2.0 to 2.2, refer to <ulink url="http://httpd.apache.org/docs/2.2/upgrading.html" />.
</para>
</section>
</section>
More information about the docs-commits
mailing list