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>
