Bug#775944: Please, document changes between Apache 2.2 and 2.4
On 2015-01-23 14:35, David Prévot wrote:
> Hi,
>
> Le 22/01/2015 12:35, Niels Thykier a écrit :
>> On 2015-01-21 20:21, David Prévot wrote:
>
>
>> I have made the following draft for documenting this issue.
>
> Thanks Niels!
>
>> If there are any things on the packaging side (i.e. Debian-specific
>> changes since 2.2) that users should be aware of, please do let me know
>> as I am currently not aware of issues there.
>
> From /usr/share/doc/apache2/NEWS.Debian.gz:
>
>> Moreover, the configuration mechanism in Debian has changed. All
>> configurations in sites-enabled and conf-enabled need a ".conf" suffix now.
> […]
>> Note this means all existing sites are ignored until they get a ".conf"
>> suffix and are re-enabled by the use of a2ensite.
>
> There are other Debian-specific bits in NEWS.Debian, but at least this
> one may deserve a mention in the release notes since it’s likely to bite
> a lot of administrators (and when the NEWS changes shows up, it’s too
> late since Apache 2.4 is already there, it will probably be long anyway).
>
> Regards
>
> David
>
Thanks for the review. :)
I have attached an updated patch and also briefly touches on the
".conf"-suffix issue and adds a reference to the NEWS file. A second
review is appreciated. :)
Thanks,
~Niels
diff --git a/en/issues.dbk b/en/issues.dbk
index bef2995..97741f0 100644
--- a/en/issues.dbk
+++ b/en/issues.dbk
@@ -209,6 +209,50 @@ $ echo 'openssh-server openssh-server/permit-root-login boolean true' | debconf-
</para>
</section>
+<section id="apache-httpd-incomat">
+ <!-- Wheezy to Jessie -->
+ <title>Incompatible changes in Apache HTTPD 2.4</title>
+ <note>
+ <para>
+ This section only applies to systems, which have installed an
+ Apache HTTPD server and configured it manually.
+ </para>
+ </note>
+ <para>
+ There has been a number of changes to the configuration of the
+ Apache HTTPD server in version 2.4. On the upstream side, the
+ syntax has changed. Notably, the access control directives have
+ changed considerably and will need manual migration to the
+ directives.
+ </para>
+ <para>
+ The managing of configuration files have also been changed in the
+ Debian packaging. In particular, all configuration files and
+ sites must now end with ".conf" to be parsed. This change also
+ replaces the existing use of
+ <filename>/etc/apache2/conf.d/</filename>.
+ </para>
+ <para>
+ For more information and the full list of changes, please refer to:
+ </para>
+ <itemizedlist>
+ <listitem>
+ <para><ulink
+ url="http://httpd.apache.org/docs/2.4/upgrading.html";>Upgrading
+ to 2.4 from 2.2</ulink> document provided by Apache for the upstream
+ side.
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ The <filename>/usr/share/doc/apache2/NEWS.Debian.gz</filename>
+ file provided by the <systemitem
+ role="package">apache2</systemitem> package.
+ </para>
+ </listitem>
+ </itemizedlist>
+</section>
+
<section id="systemd-upgrade-default-init-system">
<!-- Wheezy to Jessie -->
<title>Upgrading installs the new default init system for Jessie</title>
Reply to: