Skip to content

bugzilla
bugzilla
Commit 4e9afa43 authored by mkanat%bugzilla.org's avatar mkanat%bugzilla.org
Browse files
Options

Bug 124405: Remove direct AppConfig dependency.

Patch By Max Kanat-Alexander <mkanat@bugzilla.org> (module owner) r=colin for docs, a=myk
parent 80ac71ce
Show whitespace changes
Inline Side-by-side
Showing with 48 additions and 243 deletions
docs/en/xml/installation.xml
View file @ 4e9afa43
<!-- <!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.1.2//EN"> --> <!-- <!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.1.2//EN"> -->
<!-- $Id: installation.xml,v 1.134 2008/04/04 06:48:04 lpsolit%gmail.com Exp $ --> <!-- $Id: installation.xml,v 1.125 2008/04/04 06:47:55 mkanat%bugzilla.org Exp $ -->
<chapter id="installing-bugzilla"> <chapter id="installing-bugzilla">
<title>Installing Bugzilla</title> <title>Installing Bugzilla</title>
...@@ -287,7 +287,13 @@ ...@@ -287,7 +287,13 @@
<listitem> <listitem>
<para> <para>
CGI &min-cgi-ver; or CGI &min-mp-cgi-ver; if using mod_perl CGI (&min-cgi-ver;)
</para>
</listitem>
<listitem>
<para>
Data::Dumper (&min-data-dumper-ver;)
</para> </para>
</listitem> </listitem>
...@@ -324,6 +330,12 @@ ...@@ -324,6 +330,12 @@
<listitem> <listitem>
<para> <para>
File::Temp (&min-file-temp-ver;)
</para>
</listitem>
<listitem>
<para>
<link linkend="install-modules-template">Template</link> <link linkend="install-modules-template">Template</link>
(&min-template-ver;) (&min-template-ver;)
</para> </para>
...@@ -331,42 +343,41 @@ ...@@ -331,42 +343,41 @@
<listitem> <listitem>
<para> <para>
MIME::Base64 (&min-mime-base64-ver;) Text::Wrap (&min-text-wrap-ver;)
</para> </para>
</listitem> </listitem>
<listitem> <listitem>
<para> <para>
MIME::Parser (&min-mime-parser-ver;) Mail::Mailer (&min-mail-mailer-ver;)
</para> </para>
</listitem> </listitem>
<listitem> <listitem>
<para> <para>
Email::Send (&min-email-send-ver;) MIME::Base64 (&min-mime-base64-ver;)
</para> </para>
</listitem> </listitem>
<listitem> <listitem>
<para> <para>
Email::MIME::Modifier (&min-email-mime-modifier-ver;) MIME::Parser (&min-mime-parser-ver;)
</para> </para>
</listitem> </listitem>
</orderedlist>
Optional Perl modules:
<orderedlist>
<listitem> <listitem>
<para> <para>
<link linkend="install-modules-gd">GD</link> Storable (&min-storable-ver;)
(&min-gd-ver;) for bug charting
</para> </para>
</listitem> </listitem>
</orderedlist>
Optional Perl modules:
<orderedlist>
<listitem> <listitem>
<para> <para>
Template::Plugin::GD::Image <link linkend="install-modules-gd">GD</link>
(&min-gd-ver;) for Graphical Reports (&min-gd-ver;) for bug charting
</para> </para>
</listitem> </listitem>
...@@ -386,8 +397,8 @@ ...@@ -386,8 +397,8 @@
<listitem> <listitem>
<para> <para>
<link linkend="install-modules-gd-text">GD::Text</link> <link linkend="install-modules-gd-text-align">GD::Text::Align</link>
(&min-gd-text-ver;) for bug charting (&min-gd-text-align-ver;) for bug charting
</para> </para>
</listitem> </listitem>
...@@ -400,13 +411,6 @@ ...@@ -400,13 +411,6 @@
<listitem> <listitem>
<para> <para>
LWP::UserAgent
(&min-lwp-useragent-ver;) for Automatic Update Notifications
</para>
</listitem>
<listitem>
<para>
<link linkend="install-modules-patchreader">PatchReader</link> <link linkend="install-modules-patchreader">PatchReader</link>
(&min-patchreader-ver;) for pretty HTML view of patches (&min-patchreader-ver;) for pretty HTML view of patches
</para> </para>
...@@ -417,69 +421,6 @@ ...@@ -417,69 +421,6 @@
Image::Magick (&min-image-magick-ver;) for converting BMP image attachments to PNG Image::Magick (&min-image-magick-ver;) for converting BMP image attachments to PNG
</para> </para>
</listitem> </listitem>
<listitem>
<para>
Net::LDAP
(&min-net-ldap-ver;) for LDAP Authentication
</para>
</listitem>
<listitem>
<para>
<link linkend="install-modules-soap-lite">SOAP::Lite</link>
(&min-soap-lite-ver;) for the web service interface
</para>
</listitem>
<listitem>
<para>
HTML::Parser
(&min-html-parser-ver;) for More HTML in Product/Group Descriptions
</para>
</listitem>
<listitem>
<para>
HTML::Scrubber
(&min-html-scrubber-ver;) for More HTML in Product/Group Descriptions
</para>
</listitem>
<listitem>
<para>
Email::MIME::Attachment::Stripper
(&min-email-mime-attachment-stripper-ver;) for Inbound Email
</para>
</listitem>
<listitem>
<para>
Email::Reply
(&min-email-reply-ver;) for Inbound Email
</para>
</listitem>
<listitem>
<para>
mod_perl2
(&min-mod_perl2-ver;) for mod_perl
</para>
</listitem>
<listitem>
<para>
CGI
(&min-cgi-ver;) for mod_perl
</para>
</listitem>
<listitem>
<para>
Apache::DBI
(&min-apache-dbi-ver;) for mod_perl2
</para>
</listitem>
</orderedlist> </orderedlist>
</para> </para>
...@@ -553,10 +494,10 @@ ...@@ -553,10 +494,10 @@
</para> </para>
</section> </section>
<section id="install-modules-gd-text"> <section id="install-modules-gd-text-align">
<title>GD::Text (&min-gd-text-ver;)</title> <title>GD::Text::Align (&min-gd-text-align-ver;)</title>
<para>The GD::Text module is only required if you want graphical <para>The GD::Text::Align module is only required if you want graphical
reports. reports.
</para> </para>
</section> </section>
...@@ -571,14 +512,6 @@ ...@@ -571,14 +512,6 @@
</para> </para>
</section> </section>
<section id="install-modules-soap-lite">
<title>SOAP::Lite (&min-soap-lite-ver;)</title>
<para>Installing SOAP::Lite enables your Bugzilla installation to be
accessible at a standardized Web Service interface (SOAP/XML-RPC)
by third-party applications via HTTP(S).
</para>
</section>
<section id="install-modules-patchreader"> <section id="install-modules-patchreader">
<title>PatchReader (&min-patchreader-ver;)</title> <title>PatchReader (&min-patchreader-ver;)</title>
...@@ -608,8 +541,8 @@ ...@@ -608,8 +541,8 @@
</para> </para>
<para> <para>
For more information, see the <quote>mail_delivery_method</quote> parameter For more information, see the "maildeliverymethod" parameter in
in <xref linkend="parameters" />. <xref linkend="parameters" />.
</para> </para>
</note> </note>
...@@ -643,23 +576,7 @@ ...@@ -643,23 +576,7 @@
</para> </para>
</section> </section>
<section id="using-mod_perl-with-bugzilla">
<title>Installing Bugzilla on mod_perl</title>
<para>It is now possible to run the Bugzilla software under <literal>mod_perl</literal> on
Apache. <literal>mod_perl</literal> has some additional requirements to that of running
Bugzilla under <literal>mod_cgi</literal> (the standard and previous way).</para>
<para>Bugzilla requires <literal>mod_perl</literal> to be installed, which can be
obtained from <ulink url="http://perl.apache.org"/> - Bugzilla requires
version &min-mod_perl2-ver; (AKA 2.0.0-RC5) to be installed.</para>
<para>Bugzilla also requires a more up-to-date version of the CGI
perl module to be installed, version &min-mp-cgi-ver; as opposed to &min-cgi-ver;
</para>
<para>Finally, Bugzilla also requires <literal>Apache::DBI</literal>
(&min-apache-dbi-ver;) to be installed as well.</para>
</section>
</section> </section>
...@@ -957,30 +874,18 @@ ...@@ -957,30 +874,18 @@
<para> <para>
Configure your web server according to the instructions in the Configure your web server according to the instructions in the
appropriate section. (If it makes a difference in your choice, appropriate section. (If it makes a difference in your choice,
the Bugzilla Team recommends Apache.) To check whether your web server the Bugzilla Team recommends Apache.) Regardless of which webserver
is correctly configured, try to access <filename>testagent.cgi</filename>
from your web server. If "OK" is displayed, then your configuration
is successful. Regardless of which web server
you are using, however, ensure that sensitive information is you are using, however, ensure that sensitive information is
not remotely available by properly applying the access controls in not remotely available by properly applying the access controls in
<xref linkend="security-webserver-access"/>. You can run <xref linkend="security-webserver-access"/>.
<filename>testserver.pl</filename> to check if your web server serves
Bugzilla files as expected.
</para> </para>
<section id="http-apache"> <section id="http-apache">
<title>Bugzilla using Apache</title> <title>Apache <productname>httpd</productname></title>
<para>You have two options for running Bugzilla under Apache -
<link linkend="http-apache-mod_cgi">mod_cgi</link> (the default) and
<link linkend="http-apache-mod_perl">mod_perl</link> (new in Bugzilla
2.23)
</para>
<section id="http-apache-mod_cgi">
<title>Apache <productname>httpd</productname> with mod_cgi</title>
<para> <para>
To configure your Apache web server to work with Bugzilla while using To configure your Apache web server to work with Bugzilla,
mod_cgi, do the following: do the following:
</para> </para>
<procedure> <procedure>
...@@ -1004,12 +909,12 @@ ...@@ -1004,12 +909,12 @@
</para> </para>
<programlisting> <programlisting>
&lt;Directory /var/www/html/bugzilla&gt; &lt;Directory /var/www/html/bugzilla&gt;
AddHandler cgi-script .cgi AddHandler cgi-script .cgi
Options +Indexes +ExecCGI Options +Indexes +ExecCGI
DirectoryIndex index.cgi DirectoryIndex index.cgi
AllowOverride Limit AllowOverride Limit
&lt;/Directory&gt; &lt;/Directory&gt;
</programlisting> </programlisting>
<para> <para>
...@@ -1069,107 +974,6 @@ ...@@ -1069,107 +974,6 @@
</step> </step>
</procedure> </procedure>
</section> </section>
<section id="http-apache-mod_perl">
<title>Apache <productname>httpd</productname> with mod_perl</title>
<para>Some configuration is required to make Bugzilla work with Apache
and mod_perl</para>
<procedure>
<step>
<para>
Load <filename>httpd.conf</filename> in your editor.
In Fedora and Red Hat Linux, this file is found in
<filename class="directory">/etc/httpd/conf</filename>.
</para>
</step>
<step>
<para>Add the following information to your httpd.conf file, substituting
where appropriate with your own local paths.</para>
<note>
<para>This should be used instead of the &lt;Directory&gt; block
shown above. This should also be above any other <literal>mod_perl</literal>
directives within the <filename>httpd.conf</filename> and must be specified
in the order as below.</para>
</note>
<warning>
<para>You should also ensure that you have disabled <literal>KeepAlive</literal>
support in your Apache install when utilizing Bugzilla under mod_perl</para>
</warning>
<programlisting>
PerlSwitches -I/var/www/html/bugzilla -w -T
PerlConfigRequire /var/www/html/bugzilla/mod_perl.pl
</programlisting>
</step>
<step>
<para>
<filename>checksetup.pl</filename> can set tighter permissions
on Bugzilla's files and directories if it knows what group the
webserver runs as. Find the <computeroutput>Group</computeroutput>
line in <filename>httpd.conf</filename>, place the value found
there in the <replaceable>$webservergroup</replaceable> variable
in <filename>localconfig</filename>, then rerun
<filename>checksetup.pl</filename>.
</para>
</step>
</procedure>
<para>On restarting Apache, Bugzilla should now be running within the
mod_perl environment. Please ensure you have run checksetup.pl to set
permissions before you restart Apache.</para>
<note>
<para>Please bear the following points in mind when looking at using
Bugzilla under mod_perl:
<itemizedlist>
<listitem>
<para>
mod_perl support in Bugzilla can take up a HUGE amount of RAM. You could be
lookng at 30MB per httpd child, easily. Basically, you just need a lot of RAM.
The more RAM you can get, the better. mod_perl is basically trading RAM for
speed. At least 2GB total system RAM is recommended for running Bugzilla under
mod_perl.
</para>
</listitem>
<listitem>
<para>
Under mod_perl, you have to restart Apache if you make any manual change to
any Bugzilla file. You can't just reload--you have to actually
<emphasis>restart</emphasis> the server (as in make sure it stops and starts
again). You <emphasis>can</emphasis> change localconfig and the params file
manually, if you want, because those are re-read every time you load a page.
</para>
</listitem>
<listitem>
<para>
You must run in Apache's Prefork MPM (this is the default). The Worker MPM
may not work--we haven't tested Bugzilla's mod_perl support under threads.
(And, in fact, we're fairly sure it <emphasis>won't</emphasis> work.)
</para>
</listitem>
<listitem>
<para>
Bugzilla generally expects to be the only mod_perl application running on
your entire server. It may or may not work if there are other applications also
running under mod_perl. It does try its best to play nice with other mod_perl
applications, but it still may have conflicts.
</para>
</listitem>
<listitem>
<para>
It is recommended that you have one Bugzilla instance running under mod_perl
on your server. Bugzilla has not been tested with more than one instance running.
</para>
</listitem>
</itemizedlist>
</para>
</note>
</section>
</section>
<section id="http-iis"> <section id="http-iis">
<title>Microsoft <productname>Internet Information Services</productname></title> <title>Microsoft <productname>Internet Information Services</productname></title>
......
docs/en/xml/modules.xml
View file @ 4e9afa43
...@@ -50,15 +50,6 @@ ...@@ -50,15 +50,6 @@
</note> </note>
<para> <para>
AppConfig:
<literallayout>
CPAN Download Page: <ulink url="http://search.cpan.org/src/ABW/AppConfig-1.56/lib/AppConfig.pm"/>
PPM Download Link: <ulink url="http://landfill.bugzilla.org/ppm/AppConfig.ppd"/>
Documentation: <ulink url="http://search.cpan.org/~abw/AppConfig-1.56/lib/AppConfig.pm"/>
</literallayout>
</para>
<para>
CGI: CGI:
<literallayout> <literallayout>
CPAN Download Page: <ulink url="http://search.cpan.org/dist/CGI.pm/"/> CPAN Download Page: <ulink url="http://search.cpan.org/dist/CGI.pm/"/>
...@@ -149,6 +140,16 @@ ...@@ -149,6 +140,16 @@
</para> </para>
<para> <para>
Template::Plugin::GD:
<literallayout>
CPAN Download Page: <ulink url="http://search.cpan.org/dist/Template-GD/" />
PPM Download Link: (Just install Template-Toolkit using the instructions below)
Documentation: <ulink url="http://www.template-toolkit.org/docs/aqua/Modules/index.html" />
</literallayout>
</para>
<para>
MIME::Base64: MIME::Base64:
<literallayout> <literallayout>
CPAN Download Page: <ulink url="http://search.cpan.org/dist/MIME-Base64/"/> CPAN Download Page: <ulink url="http://search.cpan.org/dist/MIME-Base64/"/>
......
Markdown is supported
0% or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment