<!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>Distribution-specific notes — Bcfg2 1.3.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: '1.3.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>
<script type="text/javascript" src="../_static/sidebar.js"></script>
<link rel="shortcut icon" href="../_static/favicon.ico"/>
<link rel="top" title="Bcfg2 1.3.0 documentation" href="../index.html" />
<link rel="up" title="Installation" href="index.html" />
<link rel="next" title="Getting started" href="../getting_started/index.html" />
<link rel="prev" title="Building RPM packages from source" href="packages.html" />
<link rel="stylesheet" href="../_static/bcfg2.css" type=""/>
</head>
<body>
<div style="text-align: left; padding: 10px 10px 15px 15px">
<a href="../index.html"><img src="../_static/bcfg2_logo.png" border="0" alt="sampledoc"/></a>
</div>
<div class="related">
<h3>Navigation</h3>
<ul>
<li class="right" style="margin-right: 10px">
<a href="../genindex.html" title="General Index"
accesskey="I">index</a></li>
<li class="right" >
<a href="../py-modindex.html" title="Python Module Index"
>modules</a> |</li>
<li class="right" >
<a href="../getting_started/index.html" title="Getting started"
accesskey="N">next</a> |</li>
<li class="right" >
<a href="packages.html" title="Building RPM packages from source"
accesskey="P">previous</a> |</li>
<li><a href="../index.html">home</a> | </li>
<!--<li><a href="../search.html">search</a> | </li>-->
<li><a href="../help/index.html">help</a> | </li>
<li><a href="../contents.html">documentation </a> »</li>
<li><a href="../contents.html" >Bcfg2 documentation 1.3.0</a> »</li>
<li><a href="index.html" accesskey="U">Installation</a> »</li>
</ul>
</div>
<div class="document">
<div class="documentwrapper">
<div class="bodywrapper">
<div class="body">
<div class="section" id="distribution-specific-notes">
<span id="distributions"></span><h1>Distribution-specific notes<a class="headerlink" href="#distribution-specific-notes" title="Permalink to this headline">¶</a></h1>
<p>The installation of Bcfg2 on a specific distribution depends on the
package management tool and the availability of the package in the
distribution’s repository.</p>
<div class="section" id="alpine-linux">
<h2>Alpine Linux<a class="headerlink" href="#alpine-linux" title="Permalink to this headline">¶</a></h2>
<p>Packages for <a class="reference external" href="http://www.alpinelinux.org/">Alpine Linux</a> are available in the <a class="reference external" href="http://git.alpinelinux.org/cgit/aports/tree/testing/bcfg2">testing</a> repository.
Just use <cite>apk</cite> to perform the installation</p>
<div class="highlight-python"><pre>apk add bcfg2 bcfg2-server -U -X http://dl-3.alpinelinux.org/alpine/edge/testing/ --allow-untrusted</pre>
</div>
</div>
<div class="section" id="archlinux">
<h2>ArchLinux<a class="headerlink" href="#archlinux" title="Permalink to this headline">¶</a></h2>
<p>Packages for <a class="reference external" href="http://www.archlinux.org/">Arch Linux</a> are available in the Arch User Repository (<a class="reference external" href="http://aur.archlinux.org/packages.php?ID=20979">AUR</a>).
Just use <cite>pacman</cite> to perform the installation</p>
<div class="highlight-python"><pre>pacman -S bcfg2 bcfg2-server</pre>
</div>
</div>
<div class="section" id="debian">
<h2>Debian<a class="headerlink" href="#debian" title="Permalink to this headline">¶</a></h2>
<p>Packages of Bcfg2 are available for Debian Lenny, Debian Squeeze, and
Debian Sid. The fastest way to get Bcfg2 onto your Debian system
is to use <tt class="docutils literal"><span class="pre">apt-get</span></tt> or <tt class="docutils literal"><span class="pre">aptitude</span></tt>.</p>
<div class="highlight-python"><pre>sudo aptitude install bcfg2 bcfg2-server</pre>
</div>
<p>If you want to use unofficial packages from Bcfg2 see the instructions
at <a class="reference external" href="http://trac.mcs.anl.gov/projects/bcfg2/wiki/PrecompiledPackages#UnofficialDebianRepository">CustomDebianRepository</a>.</p>
</div>
<div class="section" id="fedora">
<h2>Fedora<a class="headerlink" href="#fedora" title="Permalink to this headline">¶</a></h2>
<p>The fastest way to get Bcfg2 packages onto your <a class="reference internal" href="#fedora">Fedora</a> system is to
use <cite>yum</cite> or PackageKit. Yum will pull in all dependencies of Bcfg2
automatically.</p>
<div class="highlight-python"><pre>su -c 'yum install bcfg2-server bcfg2'</pre>
</div>
<p>Be aware that the latest release of Bcfg2 may only be available for the
Development release of Fedora (Rawhide). With the activation of the
Rawhide repository of Fedora you will be able to install it.</p>
<div class="highlight-python"><pre>su -c 'yum install --enablerepo=rawhide bcfg2-server bcfg2'</pre>
</div>
<p>This way is not recommended on production systems. Only for testing.</p>
</div>
<div class="section" id="gentoo">
<h2>Gentoo<a class="headerlink" href="#gentoo" title="Permalink to this headline">¶</a></h2>
<p>Early in July 2008, Bcfg2 was added to the Gentoo portage tree. So far
it’s still keyworded for all architectures, but we are actively working
to get it marked as stable.</p>
<p>If you don’t use portage to install Bcfg2, you’ll want to make sure you
have all the prerequisites installed first. For a server, you’ll need:</p>
<ul class="simple">
<li><tt class="docutils literal"><span class="pre">app-admin/gamin</span></tt> or <tt class="docutils literal"><span class="pre">app-admin/fam</span></tt></li>
<li><tt class="docutils literal"><span class="pre">dev-python/lxml</span></tt></li>
</ul>
<p>Clients will need at least:</p>
<ul class="simple">
<li><tt class="docutils literal"><span class="pre">app-portage/gentoolkit</span></tt></li>
</ul>
</div>
<div class="section" id="os-x">
<h2>OS X<a class="headerlink" href="#os-x" title="Permalink to this headline">¶</a></h2>
<p>Bcfg2 can be installed either via MacPorts or by creating a native OS X
package.</p>
<div class="section" id="macports">
<h3>MacPorts<a class="headerlink" href="#macports" title="Permalink to this headline">¶</a></h3>
<p>Once macports is installed:</p>
<div class="highlight-python"><pre>port install bcfg2</pre>
</div>
</div>
<div class="section" id="using-native-os-x-python">
<h3>Using native OS X python<a class="headerlink" href="#using-native-os-x-python" title="Permalink to this headline">¶</a></h3>
<p>First, make sure you have Xcode installed as you need <tt class="docutils literal"><span class="pre">packagemaker</span></tt> which
comes bundled in the Developer tools.</p>
<p>Clone the git source:</p>
<div class="highlight-python"><pre>git clone git://git.mcs.anl.gov/bcfg2.git</pre>
</div>
<p>Change to the osx directory and type make. Your new package should be
located at <tt class="docutils literal"><span class="pre">bcfg2-$VERSION.pkg</span></tt> (where <tt class="docutils literal"><span class="pre">$VERSION</span></tt> is that which is
specified in <tt class="docutils literal"><span class="pre">setup.py</span></tt>).</p>
</div>
</div>
<div class="section" id="rhel-centos-scientific-linux">
<h2>RHEL / Centos / Scientific Linux<a class="headerlink" href="#rhel-centos-scientific-linux" title="Permalink to this headline">¶</a></h2>
<p>While you can go about building all these things from source, this
section will try and meet the dependencies using packages from <a class="reference external" href="http://fedoraproject.org/wiki/EPEL">EPEL</a>
<a class="footnote-reference" href="#f1" id="id2">[1]</a>. The <em>el5</em> and the <em>el6</em> package should be compatible
with <a class="reference external" href="http://www.centos.org/">CentOS</a> 5.x/6.x and <a class="reference external" href="http://www.scientificlinux.org/">Scientific Linux</a>.</p>
<dl class="docutils">
<dt><a class="reference external" href="http://fedoraproject.org/wiki/EPEL">EPEL</a> for 5.x ::</dt>
<dd>[<a class="reference external" href="mailto:root%40centos">root<span>@</span>centos</a> ~]# rpm -Uvh <a class="reference external" href="http://download.fedora.redhat.com/pub/epel/5/i386/epel-release-5-4.noarch.rpm">http://download.fedora.redhat.com/pub/epel/5/i386/epel-release-5-4.noarch.rpm</a></dd>
<dt><a class="reference external" href="http://fedoraproject.org/wiki/EPEL">EPEL</a> for 6.x ::</dt>
<dd>[<a class="reference external" href="mailto:root%40centos">root<span>@</span>centos</a> ~]# rpm -Uvh <a class="reference external" href="http://download.fedoraproject.org/pub/epel/6/i386/epel-release-6-5.noarch.rpm">http://download.fedoraproject.org/pub/epel/6/i386/epel-release-6-5.noarch.rpm</a></dd>
</dl>
<p>Install the bcfg2-server and bcfg2 RPMs:</p>
<div class="highlight-python"><pre>[root@centos ~]# yum install bcfg2-server bcfg2</pre>
</div>
<div class="admonition note">
<p class="first admonition-title">Note</p>
<p class="last">The latest package for <em>el5</em> is only available in the testing repository.</p>
</div>
<table class="docutils footnote" frame="void" id="f1" rules="none">
<colgroup><col class="label" /><col /></colgroup>
<tbody valign="top">
<tr><td class="label"><a class="fn-backref" href="#id2">[1]</a></td><td>For more details check the <a class="reference external" href="http://fedoraproject.org/wiki/EPEL">EPEL</a> <a class="reference external" href="http://fedoraproject.org/wiki/EPEL/FAQ#howtouse">instructions</a></td></tr>
</tbody>
</table>
</div>
<div class="section" id="ubuntu">
<h2>Ubuntu<a class="headerlink" href="#ubuntu" title="Permalink to this headline">¶</a></h2>
<p>We highly recommend following the instructions at <a class="reference external" href="http://trac.mcs.anl.gov/projects/bcfg2/wiki/PrecompiledPackages#UbuntuLaunchpadBcfg2PPA">ubuntu-installation</a>
in order to install a recent version of Bcfg2 on your system. However,
if you would like to install the older package, you can use the following
command:</p>
<div class="highlight-python"><pre>sudo aptitude install bcfg2 bcfg2-server</pre>
</div>
</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="#">Distribution-specific notes</a><ul>
<li><a class="reference internal" href="#alpine-linux">Alpine Linux</a></li>
<li><a class="reference internal" href="#archlinux">ArchLinux</a></li>
<li><a class="reference internal" href="#debian">Debian</a></li>
<li><a class="reference internal" href="#fedora">Fedora</a></li>
<li><a class="reference internal" href="#gentoo">Gentoo</a></li>
<li><a class="reference internal" href="#os-x">OS X</a><ul>
<li><a class="reference internal" href="#macports">MacPorts</a></li>
<li><a class="reference internal" href="#using-native-os-x-python">Using native OS X python</a></li>
</ul>
</li>
<li><a class="reference internal" href="#rhel-centos-scientific-linux">RHEL / Centos / Scientific Linux</a></li>
<li><a class="reference internal" href="#ubuntu">Ubuntu</a></li>
</ul>
</li>
</ul>
<h4>Previous topic</h4>
<p class="topless"><a href="packages.html"
title="previous chapter">Building RPM packages from source</a></p>
<h4>Next topic</h4>
<p class="topless"><a href="../getting_started/index.html"
title="next chapter">Getting started</a></p>
<h3>This Page</h3>
<ul class="this-page-menu">
<li><a href="../_sources/installation/distributions.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="../genindex.html" title="General Index"
>index</a></li>
<li class="right" >
<a href="../py-modindex.html" title="Python Module Index"
>modules</a> |</li>
<li class="right" >
<a href="../getting_started/index.html" title="Getting started"
>next</a> |</li>
<li class="right" >
<a href="packages.html" title="Building RPM packages from source"
>previous</a> |</li>
<li><a href="../index.html">home</a> | </li>
<!--<li><a href="../search.html">search</a> | </li>-->
<li><a href="../help/index.html">help</a> | </li>
<li><a href="../contents.html">documentation </a> »</li>
<li><a href="../contents.html" >Bcfg2 documentation 1.3.0</a> »</li>
<li><a href="index.html" >Installation</a> »</li>
</ul>
</div>
<div class="footer">
© Copyright 2009-2013, Narayan Desai.
Last updated on Mar 20, 2013.
Created using <a href="http://sphinx.pocoo.org/">Sphinx</a> 1.1.3.
</div>
</body>
</html>
distrib
>
Fedora
>
17
>
i386
>
media
>
updates
>
by-pkgid
>
b50d8ee6d7871fcc13c0677a9364ed59
>
files
>
385
