<!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.15. One Installation, Multiple Instances — 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="4. Administration Guide" href="../administering/index.html" />
<link rel="prev" title="3.14. Merging Accounts" href="merging-accounts.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="../administering/index.html" title="4. Administration Guide"
accesskey="N">next</a></li>
<li class="right" >
<a href="merging-accounts.html" title="3.14. Merging Accounts"
accesskey="P">previous</a> |</li>
<li class="nav-item nav-item-0"><a href="../index.html">Bugzilla 5.0.4 documentation</a> »</li>
<li class="nav-item nav-item-1"><a href="index.html" accesskey="U">3. Installation and Maintenance Guide</a> »</li>
</ul>
</div>
<div class="document">
<div class="documentwrapper">
<div class="bodywrapper">
<div class="body" role="main">
<div class="section" id="one-installation-multiple-instances">
<span id="multiple-bz-dbs"></span><h1>3.15. One Installation, Multiple Instances<a class="headerlink" href="#one-installation-multiple-instances" title="Permalink to this headline">ΒΆ</a></h1>
<p>This is a somewhat specialist feature; if you don't know whether you need it,
you don't. It is useful to admins who want to run many separate instances of
Bugzilla from a single installed codebase.</p>
<p>This is possible by using the <code class="docutils literal"><span class="pre">PROJECT</span></code> environment variable. When accessed,
Bugzilla checks for the existence of this variable, and if present, uses
its value to check for an alternative configuration file named
<code class="file docutils literal"><span class="pre">localconfig.<PROJECT></span></code> in the same location as
the default one (<code class="file docutils literal"><span class="pre">localconfig</span></code>). It also checks for
customized templates in a directory named
<code class="file docutils literal"><span class="pre"><PROJECT></span></code> in the same location as the
default one (<code class="file docutils literal"><span class="pre">template/<langcode></span></code>). By default
this is <code class="file docutils literal"><span class="pre">template/en/default</span></code> so <code class="docutils literal"><span class="pre">PROJECT</span></code>'s templates
would be located at <code class="file docutils literal"><span class="pre">template/en/PROJECT</span></code>.</p>
<p>To set up an alternate installation, just export <code class="docutils literal"><span class="pre">PROJECT=foo</span></code> before
running <strong class="command">checksetup.pl</strong> for the first time. It will
result in a file called <code class="file docutils literal"><span class="pre">localconfig.foo</span></code> instead of
<code class="file docutils literal"><span class="pre">localconfig</span></code>. Edit this file as described above, with
reference to a new database, and re-run <strong class="command">checksetup.pl</strong>
to populate it. That's all.</p>
<p>Now you have to configure the web server to pass this environment
variable when accessed via an alternate URL, such as virtual host for
instance. The following is an example of how you could do it in Apache,
other Webservers may differ.</p>
<div class="highlight-apache"><div class="highlight"><pre><span></span><span class="nt"><VirtualHost</span> <span class="s">12.34.56.78:80</span><span class="nt">></span>
<span class="nb">ServerName</span> bugzilla.example.com
<span class="nb">SetEnv</span> PROJECT foo
<span class="nt"></VirtualHost></span>
</pre></div>
</div>
<p>Don't forget to also export this variable before accessing Bugzilla
by other means, such as repeating tasks like those above.</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&component=Documentation">here</a>.</p>
</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>
<h4>Previous topic</h4>
<p class="topless"><a href="merging-accounts.html"
title="previous chapter">3.14. Merging Accounts</a></p>
<h4>Next topic</h4>
<p class="topless"><a href="../administering/index.html"
title="next chapter">4. Administration Guide</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="../administering/index.html" title="4. Administration Guide"
>next</a></li>
<li class="right" >
<a href="merging-accounts.html" title="3.14. Merging Accounts"
>previous</a> |</li>
<li class="nav-item nav-item-0"><a href="../index.html">Bugzilla 5.0.4 documentation</a> »</li>
<li class="nav-item nav-item-1"><a href="index.html" >3. Installation and Maintenance Guide</a> »</li>
</ul>
</div>
<div class="footer" role="contentinfo">
Created using <a href="http://sphinx-doc.org/">Sphinx</a> 1.6.6.
</div>
</body>
</html>
