diff options
| -rw-r--r-- | docs/sgml/installation.sgml | 33 | ||||
| -rw-r--r-- | docs/xml/installation.xml | 33 |
2 files changed, 64 insertions, 2 deletions
diff --git a/docs/sgml/installation.sgml b/docs/sgml/installation.sgml index 37d339e93..6c2aeb39e 100644 --- a/docs/sgml/installation.sgml +++ b/docs/sgml/installation.sgml @@ -1,4 +1,4 @@ -<!-- <!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook V4.1//EN"> --> +<!-- <!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.1.2//EN"> --> <chapter id="installation" xreflabel="Bugzilla Installation"> <title>Installation</title> @@ -1203,6 +1203,37 @@ bash# ./checksetup.pl </note> </para> + + <para> + The default .htaccess file may not provide adequate access + restrictions, depending on your web server configuration. + Be sure to check the <Directory> entries for your + Bugzilla directory so that the <filename>.htaccess</filename> + file is allowed to override web server defaults. For instance, + let's assume your installation of Bugzilla is installed to + <filename>/usr/local/bugzilla</filename>. You should have + this <Directory> entry in your <filename>httpd.conf</filename> + file: + </para> + + <para> + <programlisting> +<![CDATA[ +<Directory /usr/local/bugzilla/> + Options +FollowSymLinks +Indexes +Includes +ExecCGI + AllowOverride All +</Directory> +]]> + </programlisting> + </para> + + <para> + The important part above is <quote>AllowOverride All</quote>. + Without that, the <filename>.htaccess</filename> file created by + <filename>checksetup.pl</filename> will not have sufficient + permissions to protect your Bugzilla installation. + </para> + <para> If you are using Internet Information Server or other web server which does not observe <filename>.htaccess</filename> diff --git a/docs/xml/installation.xml b/docs/xml/installation.xml index 37d339e93..6c2aeb39e 100644 --- a/docs/xml/installation.xml +++ b/docs/xml/installation.xml @@ -1,4 +1,4 @@ -<!-- <!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook V4.1//EN"> --> +<!-- <!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.1.2//EN"> --> <chapter id="installation" xreflabel="Bugzilla Installation"> <title>Installation</title> @@ -1203,6 +1203,37 @@ bash# ./checksetup.pl </note> </para> + + <para> + The default .htaccess file may not provide adequate access + restrictions, depending on your web server configuration. + Be sure to check the <Directory> entries for your + Bugzilla directory so that the <filename>.htaccess</filename> + file is allowed to override web server defaults. For instance, + let's assume your installation of Bugzilla is installed to + <filename>/usr/local/bugzilla</filename>. You should have + this <Directory> entry in your <filename>httpd.conf</filename> + file: + </para> + + <para> + <programlisting> +<![CDATA[ +<Directory /usr/local/bugzilla/> + Options +FollowSymLinks +Indexes +Includes +ExecCGI + AllowOverride All +</Directory> +]]> + </programlisting> + </para> + + <para> + The important part above is <quote>AllowOverride All</quote>. + Without that, the <filename>.htaccess</filename> file created by + <filename>checksetup.pl</filename> will not have sufficient + permissions to protect your Bugzilla installation. + </para> + <para> If you are using Internet Information Server or other web server which does not observe <filename>.htaccess</filename> |