<!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>Introduction — Bazaar 2.6.0 documentation</title>
<link rel="stylesheet" href="../_static/default.css" type="text/css" />
<link rel="stylesheet" href="../_static/pygments.css" type="text/css" />
<script type="text/javascript">
var DOCUMENTATION_OPTIONS = {
URL_ROOT: '../',
VERSION: '2.6.0',
COLLAPSE_INDEX: false,
FILE_SUFFIX: '.html',
HAS_SOURCE: true
};
</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/bzr.ico"/>
<link rel="top" title="Bazaar 2.6.0 documentation" href="../index.html" />
<link rel="up" title="Bazaar System Administrator’s Guide" href="index.html" />
<link rel="next" title="Simple Setups" href="simple-setups.html" />
<link rel="prev" title="Bazaar System Administrator’s Guide" href="index.html" />
</head>
<body>
<div class="related">
<h3>Navigation</h3>
<ul>
<li class="right" style="margin-right: 10px">
<a href="simple-setups.html" title="Simple Setups"
accesskey="N">next</a></li>
<li class="right" >
<a href="index.html" title="Bazaar System Administrator’s Guide"
accesskey="P">previous</a> |</li>
<li><a href="http://bazaar.canonical.com/">
<img src="../_static/bzr icon 16.png" /> Home</a> | </li>
<a href="http://doc.bazaar.canonical.com/en/">Documentation</a> | </li>
<li><a href="../index.html">Table of Contents (2.6.0)</a> »</li>
<li><a href="index.html" accesskey="U">Bazaar System Administrator’s Guide</a> »</li>
</ul>
</div>
<div class="document">
<div class="documentwrapper">
<div class="bodywrapper">
<div class="body">
<div class="section" id="introduction">
<h1>Introduction<a class="headerlink" href="#introduction" title="Permalink to this headline">¶</a></h1>
<p>Welcome to the Bazaar Version Control System’s guide for system
administrators. Bazaar is a flexible system that provides many possible
options for serving projects in ways that will hopefully meet your needs. If
you have requirements that are not met by the current state of the Bazaar
ecosystem, please let us know at <a class="reference external" href="mailto:bazaar%40lists.canonical.com">bazaar<span>@</span>lists<span>.</span>canonical<span>.</span>com</a> or on Launchpad at
<a class="reference external" href="https://launchpad.net/bzr">https://launchpad.net/bzr</a>.</p>
<div class="section" id="scope-of-this-guide">
<h2>Scope of this guide<a class="headerlink" href="#scope-of-this-guide" title="Permalink to this headline">¶</a></h2>
<p>In this guide, we will discuss various techniques for making Bazaar projects
available, migrating from other Version Control Systems, browsing code over
the Web and combining Bazaar with other tools. In many of these categories,
multiple options exist and we will try to explains the costs and benefits of
the various options.</p>
<p>The intended audience for this guide is the individuals who administer the
computers that will do the serving. Much of the configuration that we will
discuss requires administrator privileges and we will not necessarily indicate
every point that those privileges are needed. That said, reading this guide
can also be very helpful for those who are interested in communicating to the
system administrators about the requirements for making full use of Bazaar.</p>
</div>
<div class="section" id="what-you-need-to-run-a-bazaar-server">
<h2>What you need to run a Bazaar server<a class="headerlink" href="#what-you-need-to-run-a-bazaar-server" title="Permalink to this headline">¶</a></h2>
<p>Where possible, we will discuss both Unix (including GNU/Linux) and Windows server
environments. For the purposes of this document, we will consider Mac OS X as
a type of Unix.</p>
<p>In general, Bazaar requires only <a class="reference external" href="http://www.python.org/">Python</a> 2.6 or greater to run.
If you would <em>optionally</em>
like to be able to access branches using SFTP, you need <a class="reference external" href="http://www.lag.net/paramiko/">paramiko and
pycrypto</a>.</p>
<p>For maximum performance, Bazaar can make use of compiled versions of some
critical components of the code. Pure Python alternatives exist for all of
these components, but they may be considerably slower. To compile these
extensions, you need a C compiler and the relevant header files from the
Python package. On GNU/Linux, these may be in a separate package. Other
operating systems should have the required headers installed by default.</p>
<p>If you are installing a development version of Bazaar, rather than a released
version, you will need <a class="reference external" href="http://www.cosc.canterbury.ac.nz/greg.ewing/python/Pyrex/">Pyrex</a> to create the C extensions. The release
tarballs already have the Pyrex-created C files.</p>
</div>
</div>
</div>
</div>
</div>
<div class="sphinxsidebar">
<div class="sphinxsidebarwrapper">
<h3><a href="../index.html">Table Of Contents</a></h3>
<ul>
<li><a class="reference internal" href="#">Introduction</a><ul>
<li><a class="reference internal" href="#scope-of-this-guide">Scope of this guide</a></li>
<li><a class="reference internal" href="#what-you-need-to-run-a-bazaar-server">What you need to run a Bazaar server</a></li>
</ul>
</li>
</ul>
<h4>Previous topic</h4>
<p class="topless"><a href="index.html"
title="previous chapter">Bazaar System Administrator’s Guide</a></p>
<h4>Next topic</h4>
<p class="topless"><a href="simple-setups.html"
title="next chapter">Simple Setups</a></p>
<h3>This Page</h3>
<ul class="this-page-menu">
<li><a href="../_sources/admin-guide/introduction.txt"
rel="nofollow">Show Source</a></li>
</ul>
<div id="searchbox" style="display: none">
<h3>Quick search</h3>
<form class="search" action="../search.html" method="get">
<input type="text" name="q" />
<input type="submit" value="Go" />
<input type="hidden" name="check_keywords" value="yes" />
<input type="hidden" name="area" value="default" />
</form>
<p class="searchtip" style="font-size: 90%">
Enter search terms or a module, class or function name.
</p>
</div>
<script type="text/javascript">$('#searchbox').show(0);</script>
</div>
</div>
<div class="clearer"></div>
</div>
<div class="related">
<h3>Navigation</h3>
<ul>
<li class="right" style="margin-right: 10px">
<a href="simple-setups.html" title="Simple Setups"
>next</a></li>
<li class="right" >
<a href="index.html" title="Bazaar System Administrator’s Guide"
>previous</a> |</li>
<li><a href="http://bazaar.canonical.com/">
<img src="../_static/bzr icon 16.png" /> Home</a> | </li>
<a href="http://doc.bazaar.canonical.com/en/">Documentation</a> | </li>
<li><a href="../index.html">Table of Contents (2.6.0)</a> »</li>
<li><a href="index.html" >Bazaar System Administrator’s Guide</a> »</li>
</ul>
</div>
<div class="footer">
© Copyright 2009-2011 Canonical Ltd.
Created using <a href="http://sphinx-doc.org/">Sphinx</a> 1.2.3.
</div>
</body>
</html>
