<!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.10. Moving Bugzilla Between Machines — 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.11. Upgrading" href="upgrading.html" />
<link rel="prev" title="3.9. Migrating From Other Bug-Tracking Systems" href="migrating.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="upgrading.html" title="3.11. Upgrading"
accesskey="N">next</a></li>
<li class="right" >
<a href="migrating.html" title="3.9. Migrating From Other Bug-Tracking Systems"
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="moving-bugzilla-between-machines">
<span id="moving"></span><h1>3.10. Moving Bugzilla Between Machines<a class="headerlink" href="#moving-bugzilla-between-machines" title="Permalink to this headline">ΒΆ</a></h1>
<p>Sometimes it's necessary to take a working installation of Bugzilla and move
it to new hardware. This page explains how to do that, assuming that you
have Bugzilla's webserver and database on the same machine, and you are moving
both of them.</p>
<p>You are advised to install the same version of Bugzilla on the new
machine as the old machine - any <a class="reference internal" href="upgrading.html#upgrading"><span class="std std-ref">upgrade</span></a> you also need to
do can then be done as a separate step. But if you do install a newer version,
things should still work.</p>
<ol class="arabic">
<li><p class="first">Shut down your Bugzilla by loading the front page, going to
<span class="guilabel">Administration</span> | <span class="guilabel">Parameters</span> | <span class="guilabel">General</span>
and putting some explanatory text into the <span class="param">shutdownhtml</span> parameter.</p>
</li>
<li><p class="first">Make a <a class="reference internal" href="backups.html#backups"><span class="std std-ref">backup</span></a> of the bugs database.</p>
</li>
<li><p class="first">On your new machine, install Bugzilla using the instructions at
<a class="reference internal" href="index.html#installing"><span class="std std-ref">Installation and Maintenance Guide</span></a>. Look at the old machine if you need to know what values
you used for configuring e.g. MySQL.</p>
</li>
<li><p class="first">Copy the <code class="file docutils literal"><span class="pre">data</span></code> directory and the <code class="file docutils literal"><span class="pre">localconfig</span></code> file from the
old Bugzilla installation to the new one.</p>
</li>
<li><p class="first">If anything about your database configuration changed (location of the
server, username, password, etc.) as part of the move, update the
appropriate variables in <code class="file docutils literal"><span class="pre">localconfig</span></code>.</p>
</li>
<li><p class="first">If the new URL to your new Bugzilla installation is different from the old
one, update the <span class="param">urlbase</span> parameter in <code class="file docutils literal"><span class="pre">data/params.json</span></code>
using a text editor.</p>
</li>
<li><p class="first">Copy the database backup file from your old server to the new one.</p>
</li>
<li><p class="first">Create an empty <code class="docutils literal"><span class="pre">bugs</span></code> database on the new server. For MySQL, that would
look like this:</p>
<p><strong class="command">mysql -u root -p -e "CREATE DATABASE bugs DEFAULT CHARACTER SET utf8;"</strong></p>
</li>
<li><p class="first">Import your backup file into your new <code class="docutils literal"><span class="pre">bugs</span></code> database. Again, for MySQL:</p>
<p><strong class="command">mysql -u root -p bugs < $BACKUP_FILE_NAME</strong></p>
<p>If you get an error about "packet too large" or "MySQL server has gone
away", you need to adjust the <code class="docutils literal"><span class="pre">max_allowed_packet</span></code> setting in
your <code class="file docutils literal"><span class="pre">my.cnf</span></code> file (usually <code class="file docutils literal"><span class="pre">/etc/my.cnf</span></code>) file to match or
exceed the value configured in the same file in your old version of MySQL.</p>
<p>If there are <em>any</em> errors during this step, you have to work out what
went wrong, and then drop the database, create it again using the step
above, and run the import again.</p>
</li>
<li><p class="first">Run <code class="file docutils literal"><span class="pre">checksetup.pl</span></code> to make sure all is OK.
(Unless you are using a newer version of Bugzilla on your new server, this
should not make any changes.)</p>
<p><strong class="command">./checksetup.pl</strong></p>
</li>
<li><p class="first">Activate your new Bugzilla by loading the front page on the new server,
going to <span class="guilabel">Administration</span> | <span class="guilabel">Parameters</span> |
<span class="guilabel">General</span> and removing the text from the <span class="param">shutdownhtml</span>
parameter.</p>
</li>
</ol>
<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="migrating.html"
title="previous chapter">3.9. Migrating From Other Bug-Tracking Systems</a></p>
<h4>Next topic</h4>
<p class="topless"><a href="upgrading.html"
title="next chapter">3.11. Upgrading</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="upgrading.html" title="3.11. Upgrading"
>next</a></li>
<li class="right" >
<a href="migrating.html" title="3.9. Migrating From Other Bug-Tracking Systems"
>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>
