Sophie

Sophie

distrib > Mageia > 7 > i586 > by-pkgid > 4e237fd705495e1e21ef20696443e053 > files > 1001

bugzilla-5.0.4-3.mga7.noarch.rpm


<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
  "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">

<html xmlns="http://www.w3.org/1999/xhtml">
  <head>
    <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
    <title>3.3. Windows &#8212; Bugzilla 5.0.4 documentation</title>
    <link rel="stylesheet" href="../_static/bugzilla.css" type="text/css" />
    <link rel="stylesheet" href="../_static/pygments.css" type="text/css" />
    <script type="text/javascript">
      var DOCUMENTATION_OPTIONS = {
        URL_ROOT:    '../',
        VERSION:     '5.0.4',
        COLLAPSE_INDEX: false,
        FILE_SUFFIX: '.html',
        HAS_SOURCE:  true,
        SOURCELINK_SUFFIX: '.txt'
      };
    </script>
    <script type="text/javascript" src="../_static/jquery.js"></script>
    <script type="text/javascript" src="../_static/underscore.js"></script>
    <script type="text/javascript" src="../_static/doctools.js"></script>
    <link rel="shortcut icon" href="../_static/favicon.ico"/>
    <link rel="search" title="Search" href="../search.html" />
    <link rel="next" title="3.4. Mac OS X" href="mac-os-x.html" />
    <link rel="prev" title="3.2. Linux" href="linux.html" /> 
  </head>
  <body>
    <div class="related" role="navigation" aria-label="related navigation">
      <h3>Navigation</h3>
      <ul>
        <li class="right" style="margin-right: 10px">
          <a href="mac-os-x.html" title="3.4. Mac OS X"
             accesskey="N">next</a></li>
        <li class="right" >
          <a href="linux.html" title="3.2. Linux"
             accesskey="P">previous</a> |</li>
        <li class="nav-item nav-item-0"><a href="../index.html">Bugzilla 5.0.4 documentation</a> &#187;</li>
          <li class="nav-item nav-item-1"><a href="index.html" accesskey="U">3. Installation and Maintenance Guide</a> &#187;</li> 
      </ul>
    </div>  

    <div class="document">
      <div class="documentwrapper">
        <div class="bodywrapper">
          <div class="body" role="main">
            
  <div class="section" id="windows">
<span id="id1"></span><h1>3.3. Windows<a class="headerlink" href="#windows" title="Permalink to this headline">¶</a></h1>
<p>Making Bugzilla work on Windows is not more difficult than making it work on
Linux. However, fewer developers use Windows to test Bugzilla and so we would
still recommend using Linux for large sites to get better support.</p>
<div class="section" id="perl">
<h2>3.3.1. Perl<a class="headerlink" href="#perl" title="Permalink to this headline">¶</a></h2>
<p>You have two main choices to install Perl on Windows: ActivePerl and Strawberry
Perl.</p>
<p>The ActivePerl Windows Installer can be downloaded from the
<a class="reference external" href="http://www.activestate.com/activeperl/downloads">ActiveState website</a>.
Perl will be installed by default into <code class="file docutils literal"><span class="pre">C:\Perl</span></code>. It is not
recommended to install Perl into a directory containing a space, such as
<code class="file docutils literal"><span class="pre">C:\Program</span> <span class="pre">Files</span></code>. Once the install has completed, log out and log in
again to pick up the changes to the <code class="docutils literal"><span class="pre">PATH</span></code> environment variable.</p>
<p>The Strawberry Perl Windows Installer can be downloaded from the
<a class="reference external" href="http://strawberryperl.com">Strawberry Perl website</a>. Perl will be installed
by default into <code class="file docutils literal"><span class="pre">C:\Strawberry</span></code>.</p>
<p>One big advantage of Strawberry Perl over ActivePerl is that with Strawberry
Perl, you can use the usual tools available on other OSes to install missing
Perl modules directly from CPAN, whereas ActivePerl requires you to use its own
<code class="file docutils literal"><span class="pre">ppm</span></code> tool to download pre-compiled Perl modules from ActiveState.
The modules in the ActivePerl repository may be a bit older than those on CPAN.</p>
</div>
<div class="section" id="bugzilla">
<span id="windows-install-bzfiles"></span><h2>3.3.2. Bugzilla<a class="headerlink" href="#bugzilla" title="Permalink to this headline">¶</a></h2>
<p>The best way to get Bugzilla is to check it out from git. Download and install
git from the <a class="reference external" href="http://git-scm.com/download">git website</a>, and then run:</p>
<p><strong class="command">git clone --branch release-X.X-stable https://github.com/bugzilla/bugzilla C:\bugzilla</strong></p>
<p>where &quot;X.X&quot; is the 2-digit version number of the stable release of Bugzilla
that you want (e.g. 5.0).</p>
<p>The rest of this documentation assumes you have installed Bugzilla into
<code class="file docutils literal"><span class="pre">C:\bugzilla</span></code>. Adjust paths appropriately if not.</p>
<p>If it's not possible to use git (e.g. because your Bugzilla machine has no
internet access), you can
<a class="reference external" href="http://www.bugzilla.org/download/">download a tarball of Bugzilla</a> and
copy it across. Bugzilla comes as a 'tarball' (<code class="file docutils literal"><span class="pre">.tar.gz</span></code> extension),
which any competent Windows archiving tool should be able to open.</p>
</div>
<div class="section" id="perl-modules">
<h2>3.3.3. Perl Modules<a class="headerlink" href="#perl-modules" title="Permalink to this headline">¶</a></h2>
<p>Bugzilla requires a number of Perl modules to be installed. Some of them are
mandatory, and some others, which enable additional features, are optional.</p>
<p>If you are using ActivePerl, these modules are available in the ActiveState
repository, and are installed with the <code class="file docutils literal"><span class="pre">ppm</span></code> tool. You can either use it
on the command line as below, or just type <strong class="command">ppm</strong>, and you will get a GUI.
If you use a proxy server or a firewall you may have trouble running PPM.
This is covered in the
<a class="reference external" href="http://aspn.activestate.com/ASPN/docs/ActivePerl/faq/ActivePerl-faq2.html#ppm_and_proxies">ActivePerl FAQ</a>.</p>
<p>Install the following mandatory modules with:</p>
<p><strong class="command">ppm install &lt;modulename&gt;</strong></p>
<ul class="simple">
<li>CGI.pm</li>
<li>Digest-SHA</li>
<li>TimeDate</li>
<li>DateTime</li>
<li>DateTime-TimeZone</li>
<li>DBI</li>
<li>Template-Toolkit</li>
<li>Email-Sender</li>
<li>Email-MIME</li>
<li>URI</li>
<li>List-MoreUtils</li>
<li>Math-Random-ISAAC</li>
<li>JSON-XS</li>
<li>Win32</li>
<li>Win32-API</li>
<li>DateTime-TimeZone-Local-Win32</li>
</ul>
<p>The following modules enable various optional Bugzilla features; try and
install them, but don't worry too much to begin with if you can't get them
installed:</p>
<ul class="simple">
<li>GD</li>
<li>Chart</li>
<li>Template-GD</li>
<li>GDTextUtil</li>
<li>GDGraph</li>
<li>MIME-tools</li>
<li>libwww-perl</li>
<li>XML-Twig</li>
<li>PatchReader</li>
<li>perl-ldap</li>
<li>Authen-SASL</li>
<li>Net-SMTP-SSL</li>
<li>RadiusPerl</li>
<li>SOAP-Lite</li>
<li>XMLRPC-Lite</li>
<li>JSON-RPC</li>
<li>Test-Taint</li>
<li>HTML-Parser</li>
<li>HTML-Scrubber</li>
<li>Encode</li>
<li>Encode-Detect</li>
<li>Email-Reply</li>
<li>HTML-FormatText-WithLinks</li>
<li>TheSchwartz</li>
<li>Daemon-Generic</li>
<li>mod_perl</li>
<li>Apache-SizeLimit</li>
<li>File-MimeInfo</li>
<li>IO-stringy</li>
<li>Cache-Memcached</li>
<li>File-Copy-Recursive</li>
</ul>
<p>If you are using Strawberry Perl, you should use the <code class="file docutils literal"><span class="pre">install-module.pl</span></code>
script to install modules, which is the same script used for Linux. Some of
the required modules are already installed by default. The remaining ones can
be installed using the command:</p>
<p><strong class="command">perl install-module.pl &lt;modulename&gt;</strong></p>
<p>The list of modules to install will be displayed by <code class="file docutils literal"><span class="pre">checksetup.pl</span></code>; see
below.</p>
</div>
<div class="section" id="web-server">
<span id="windows-config-webserver"></span><h2>3.3.4. Web Server<a class="headerlink" href="#web-server" title="Permalink to this headline">¶</a></h2>
<p>Any web server that is capable of running CGI scripts can be made to work.
We have specific instructions for the following:</p>
<ul class="simple">
<li><a class="reference internal" href="apache-windows.html#apache-windows"><span class="std std-ref">Apache on Windows</span></a></li>
<li><a class="reference internal" href="iis.html#iis"><span class="std std-ref">Microsoft IIS</span></a></li>
</ul>
</div>
<div class="section" id="database-engine">
<h2>3.3.5. Database Engine<a class="headerlink" href="#database-engine" title="Permalink to this headline">¶</a></h2>
<p>Bugzilla supports MySQL, PostgreSQL, Oracle and SQLite as database servers.
You only require one of these systems to make use of Bugzilla. MySQL is
most commonly used, and is the only one for which Windows instructions have
been tested. SQLite is good for trial installations as it requires no
setup. Configure your server according to the instructions below:</p>
<ul class="simple">
<li><a class="reference internal" href="mysql.html#mysql"><span class="std std-ref">MySQL</span></a></li>
<li><a class="reference internal" href="postgresql.html#postgresql"><span class="std std-ref">PostgreSQL</span></a></li>
<li><a class="reference internal" href="oracle.html#oracle"><span class="std std-ref">Oracle</span></a></li>
<li><a class="reference internal" href="sqlite.html#sqlite"><span class="std std-ref">SQLite</span></a></li>
</ul>
</div>
<div class="section" id="localconfig">
<h2>3.3.6. localconfig<a class="headerlink" href="#localconfig" title="Permalink to this headline">¶</a></h2>
<p>You should now change into the Bugzilla directory and run
<code class="file docutils literal"><span class="pre">checksetup.pl</span></code>, without any parameters:</p>
<p><strong class="command">checksetup.pl</strong></p>
<p><code class="file docutils literal"><span class="pre">checksetup.pl</span></code> will write out a file called <code class="file docutils literal"><span class="pre">localconfig</span></code>.
This file contains the default settings for a number of
Bugzilla parameters, the most important of which are the group your web
server runs as, and information on how to connect to your database.</p>
<p>Load this file in your editor. You will need to check/change <code class="docutils literal"><span class="pre">$db_driver</span></code>
and <code class="docutils literal"><span class="pre">$db_pass</span></code>, which are respectively the type of the database you are
using and the password for the <code class="docutils literal"><span class="pre">bugs</span></code> database user you have created.
<code class="docutils literal"><span class="pre">$db_driver</span></code> can be either <code class="docutils literal"><span class="pre">mysql</span></code>, <code class="docutils literal"><span class="pre">Pg</span></code> (PostgreSQL), <code class="docutils literal"><span class="pre">Oracle</span></code> or
<code class="docutils literal"><span class="pre">Sqlite</span></code>. All values are case sensitive.</p>
<p>Set the value of <code class="docutils literal"><span class="pre">$webservergroup</span></code> to the group your web server runs as.</p>
<ul class="simple">
<li>Fedora/Red Hat: <code class="docutils literal"><span class="pre">apache</span></code></li>
<li>Debian/Ubuntu: <code class="docutils literal"><span class="pre">www-data</span></code></li>
<li>Mac OS X: <code class="docutils literal"><span class="pre">_www</span></code></li>
<li>Windows: ignore this setting; it does nothing</li>
</ul>
<p>The other options in the <code class="file docutils literal"><span class="pre">localconfig</span></code> file are documented by their
accompanying comments. If you have a non-standard database setup, you may
need to change one or more of the other <code class="docutils literal"><span class="pre">$db_*</span></code> parameters.</p>
<div class="admonition note">
<p class="first admonition-title">Note</p>
<p class="last">If you are using Oracle, <code class="docutils literal"><span class="pre">$db_name</span></code> should be set to
the SID name of your database (e.g. <code class="docutils literal"><span class="pre">XE</span></code> if you are using Oracle XE).</p>
</div>
</div>
<div class="section" id="checksetup-pl">
<h2>3.3.7. checksetup.pl<a class="headerlink" href="#checksetup-pl" title="Permalink to this headline">¶</a></h2>
<p>Next, run <code class="file docutils literal"><span class="pre">checksetup.pl</span></code> an additional time:</p>
<p><strong class="command">checksetup.pl</strong></p>
<p>It reconfirms that all the modules are present, and notices the altered
localconfig file, which it assumes you have edited to your
satisfaction. It compiles the UI templates,
connects to the database using the <code class="docutils literal"><span class="pre">bugs</span></code>
user you created and the password you defined, and creates the
<code class="docutils literal"><span class="pre">bugs</span></code> database and the tables therein.</p>
<p>After that, it asks for details of an administrator account. Bugzilla
can have multiple administrators - you can create more later - but
it needs one to start off with.
Enter the email address of an administrator, his or her full name,
and a suitable Bugzilla password.</p>
<p><code class="file docutils literal"><span class="pre">checksetup.pl</span></code> will then finish. You may rerun
<code class="file docutils literal"><span class="pre">checksetup.pl</span></code> at any time if you wish.</p>
</div>
<div class="section" id="success">
<h2>3.3.8. Success<a class="headerlink" href="#success" title="Permalink to this headline">¶</a></h2>
<p>Your Bugzilla should now be working. Check by running:</p>
<p><strong class="command">testserver.pl http://&lt;your-bugzilla-server&gt;/</strong></p>
<p>If that passes, access <code class="docutils literal"><span class="pre">http://&lt;your-bugzilla-server&gt;/</span></code> in your browser -
you should see the Bugzilla front page. Of course, if you installed Bugzilla
in a subdirectory, make sure that's in the URL.</p>
<p>If you don't see the main Bugzilla page, but instead see &quot;It works!!!&quot;,
then somehow your Apache has not picked up your modifications to
<code class="file docutils literal"><span class="pre">httpd.conf</span></code>. If you are on Windows 7 or later, this could be due to a
new feature called &quot;VirtualStore&quot;. <a class="reference external" href="http://blog.netscraps.com/bugs/apache-httpd-conf-changes-ignored-in-windows-7.html">This blog post</a>
may help to solve the problem.</p>
<p>If you get an &quot;Internal Error...&quot; message, it could be that
<code class="docutils literal"><span class="pre">ScriptInterpreterSource</span> <span class="pre">Registry-Strict</span></code> is not set in your
<a class="reference internal" href="apache-windows.html#apache-windows"><span class="std std-ref">Apache configuration</span></a>. Check again if it is set
properly.</p>
<p>Next, do the <a class="reference internal" href="essential-post-install-config.html#essential-post-install-config"><span class="std std-ref">Essential Post-Installation Configuration</span></a>.</p>
<hr class="docutils" />
<p>This documentation undoubtedly has bugs; if you find some, please file
them <a class="reference external" href="https://bugzilla.mozilla.org/enter_bug.cgi?product=Bugzilla&amp;component=Documentation">here</a>.</p>
</div>
</div>


          </div>
        </div>
      </div>
      <div class="sphinxsidebar" role="navigation" aria-label="main navigation">
        <div class="sphinxsidebarwrapper">
            <p class="logo"><a href="../index.html">
              <img class="logo" src="../_static/bugzilla.png" alt="Logo"/>
            </a></p>
  <h3><a href="../index.html">Table Of Contents</a></h3>
  <ul>
<li><a class="reference internal" href="#">3.3. Windows</a><ul>
<li><a class="reference internal" href="#perl">3.3.1. Perl</a></li>
<li><a class="reference internal" href="#bugzilla">3.3.2. Bugzilla</a></li>
<li><a class="reference internal" href="#perl-modules">3.3.3. Perl Modules</a></li>
<li><a class="reference internal" href="#web-server">3.3.4. Web Server</a></li>
<li><a class="reference internal" href="#database-engine">3.3.5. Database Engine</a></li>
<li><a class="reference internal" href="#localconfig">3.3.6. localconfig</a></li>
<li><a class="reference internal" href="#checksetup-pl">3.3.7. checksetup.pl</a></li>
<li><a class="reference internal" href="#success">3.3.8. Success</a></li>
</ul>
</li>
</ul>

  <h4>Previous topic</h4>
  <p class="topless"><a href="linux.html"
                        title="previous chapter">3.2. Linux</a></p>
  <h4>Next topic</h4>
  <p class="topless"><a href="mac-os-x.html"
                        title="next chapter">3.4. Mac OS X</a></p>
<div id="searchbox" style="display: none" role="search">
  <h3>Quick search</h3>
    <form class="search" action="../search.html" method="get">
      <div><input type="text" name="q" /></div>
      <div><input type="submit" value="Go" /></div>
      <input type="hidden" name="check_keywords" value="yes" />
      <input type="hidden" name="area" value="default" />
    </form>
</div>
<script type="text/javascript">$('#searchbox').show(0);</script>
        </div>
      </div>
      <div class="clearer"></div>
    </div>
    <div class="related" role="navigation" aria-label="related navigation">
      <h3>Navigation</h3>
      <ul>
        <li class="right" style="margin-right: 10px">
          <a href="mac-os-x.html" title="3.4. Mac OS X"
             >next</a></li>
        <li class="right" >
          <a href="linux.html" title="3.2. Linux"
             >previous</a> |</li>
        <li class="nav-item nav-item-0"><a href="../index.html">Bugzilla 5.0.4 documentation</a> &#187;</li>
          <li class="nav-item nav-item-1"><a href="index.html" >3. Installation and Maintenance Guide</a> &#187;</li> 
      </ul>
    </div>
    <div class="footer" role="contentinfo">
      Created using <a href="http://sphinx-doc.org/">Sphinx</a> 1.6.6.
    </div>
  </body>
</html>