Sophie

Sophie

distrib > Fedora > 17 > i386 > media > updates > by-pkgid > b50d8ee6d7871fcc13c0677a9364ed59 > files > 382

bcfg2-doc-1.3.0-1.fc17.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>Troubleshooting &mdash; 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="Getting Help with Bcfg2" href="index.html" />
    <link rel="next" title="Glossary" href="../glossary.html" />
    <link rel="prev" title="FAQ: Client" href="faq/client.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="../glossary.html" title="Glossary"
             accesskey="N">next</a> |</li>
        <li class="right" >
          <a href="faq/client.html" title="FAQ: Client"
             accesskey="P">previous</a> |</li>
	<li><a href="../index.html">home</a> |&nbsp;</li>
	<!--<li><a href="../search.html">search</a> |&nbsp;</li>-->
	<li><a href="index.html">help</a> |&nbsp;</li>
	<li><a href="../contents.html">documentation </a> &raquo;</li>

          <li><a href="../contents.html" >Bcfg2 documentation 1.3.0</a> &raquo;</li>
          <li><a href="index.html" accesskey="U">Getting Help with Bcfg2</a> &raquo;</li> 
      </ul>
    </div>
  

    <div class="document">
      <div class="documentwrapper">
        <div class="bodywrapper">
          <div class="body">
            
  <div class="section" id="troubleshooting">
<span id="help-troubleshooting"></span><h1>Troubleshooting<a class="headerlink" href="#troubleshooting" title="Permalink to this headline">¶</a></h1>
<p>From time to time, Bcfg2 produces results that the user finds surprising.
This can happen either due to bugs or user error. This page describes
several techniques to gain visibility into the bcfg2 client and server
and understand what is going on.</p>
<div class="section" id="figure-out-if-error-is-client-or-server-side">
<h2>Figure out if error is client or server side<a class="headerlink" href="#figure-out-if-error-is-client-or-server-side" title="Permalink to this headline">¶</a></h2>
<ul class="simple">
<li>Cache a copy of the client configuration using <tt class="docutils literal"><span class="pre">bcfg2</span> <span class="pre">-qnc</span> <span class="pre">/tmp/config.xml</span></tt></li>
<li>Look in the file and search for the entry of interest</li>
<li>If it looks correct, then there is a client issue</li>
<li>If not, it is time to inspect things on the server</li>
</ul>
<p>This file contains all aspects of client configuration. It is structured
as a series of bundles and base entries.</p>
<div class="admonition note">
<p class="first admonition-title">Note</p>
<p class="last">Most often the entry is not correct and the issue lies in
the specification.</p>
</div>
</div>
<div class="section" id="review-server-log-messages">
<h2>Review server log messages<a class="headerlink" href="#review-server-log-messages" title="Permalink to this headline">¶</a></h2>
<p>The bcfg2-server process logs to syslog facility LOG_DAEMON. The server
produces a series of messages upon a variety of events and errors.</p>
<p>The server also supports two XML-RPC methods that can be used
to turn up the debug level in a live server:</p>
<ul class="simple">
<li><tt class="docutils literal"><span class="pre">toggle_debug</span></tt>: Turn debug on or off, depending on the current
setting.</li>
<li><tt class="docutils literal"><span class="pre">set_debug</span></tt>: Turn debug explicitly on or off.</li>
</ul>
<p>These can be called with <a class="reference internal" href="../server/admin/xcmd.html#server-admin-xcmd"><em>bcfg2-admin xcmd</em></a>,
e.g.:</p>
<div class="highlight-python"><pre>bcfg2-admin xcmd toggle_debug
bcfg2-admin xcmd set_debug true</pre>
</div>
<p>Each plugin also supports these two methods, which can be used to set
the debug level individually on a given plugin, e.g.:</p>
<div class="highlight-python"><pre>bcfg2-admin xcmd Packages.set_debug true
bcfg2-admin xcmd Probes.toggle_debug</pre>
</div>
<p>Finally, the File Activity Monitor has its own analogue to these two
methods, for setting the debug level of the FAM:</p>
<blockquote>
<div>bcfg2-admin xcmd toggle_fam_debug
bcfg2-admin xcmd set_fam_debug false</div></blockquote>
</div>
<div class="section" id="check-if-all-repository-xml-files-conform-to-schemas">
<h2>Check if all repository XML files conform to schemas<a class="headerlink" href="#check-if-all-repository-xml-files-conform-to-schemas" title="Permalink to this headline">¶</a></h2>
<p>Bcfg2 comes with XML schemas describing all of the XML formats used in
the server repository. A validation command <tt class="docutils literal"><span class="pre">bcfg2-lint</span></tt> is
included with the source distribution and all packages.</p>
</div>
<div class="section" id="if-the-bcfg2-server-is-not-reflecting-recent-changes-try-restarting-the-bcfg2-server-process">
<h2>If the bcfg2 server is not reflecting recent changes, try restarting the bcfg2-server process<a class="headerlink" href="#if-the-bcfg2-server-is-not-reflecting-recent-changes-try-restarting-the-bcfg2-server-process" title="Permalink to this headline">¶</a></h2>
<p>If this fixes the problem, it is either a bug in the
underlying file monitoring system (fam or gamin) or a bug in
Bcfg2&#8217;s file monitoring code. In either case, file a <a class="reference external" href="https://trac.mcs.anl.gov/projects/bcfg2/newticket">ticket</a> in the tracking
system. In the ticket, include:</p>
<ul class="simple">
<li>filesystem monitoring system (fam or gamin)</li>
<li>kernel version (if on linux)</li>
<li>if any messages of the form &#8220;Handled N events in M
seconds&#8221; appeared between the modification event and the client
configuration generation request appeared in the server log</li>
<li>which plugin handled the file in the repostiory (Cfg, Rules, Packages,
SSHbase, Metadata, etc.)</li>
<li>if a touch of the file after the modification causes the problem to
go away</li>
</ul>
</div>
<div class="section" id="bcfg2-info">
<h2>bcfg2-info<a class="headerlink" href="#bcfg2-info" title="Permalink to this headline">¶</a></h2>
<p>Bcfg2 server operations can be simulated using the <tt class="docutils literal"><span class="pre">bcfg2-info</span></tt> command.
The command is interactive, and has commands to allow several useful
operations</p>
<ul class="simple">
<li>clients - Current client metadata (profile and group) settings</li>
<li>groups - Current group metadata values</li>
<li>mappings - Configuration entries provided by plugins</li>
<li>buildfile [&#8211;altsrc=&lt;altsrc&gt;] &lt;filename&gt; &lt;hostname&gt; - Build a config
file for a client</li>
<li>buildbundle &lt;bundle&gt; &lt;hostname&gt; - Render a templated bundle for a client</li>
<li>showentries &lt;client&gt; &lt;type&gt; - Build the abstract configuration (list
of entries) for a client</li>
<li>build &lt;hostname&gt; &lt;output-file&gt; - Build the complete configuration
for a client</li>
</ul>
<p>Type <cite>help</cite> in bcfg2-info for more information.</p>
</div>
<div class="section" id="error-messages">
<h2>Error Messages<a class="headerlink" href="#error-messages" title="Permalink to this headline">¶</a></h2>
<p>The tables below describe error messages produced by Bcfg2 and steps that can
be taken to remedy them.</p>
<div class="section" id="client-errors">
<h3>Client Errors<a class="headerlink" href="#client-errors" title="Permalink to this headline">¶</a></h3>
<table border="1" class="docutils">
<colgroup>
<col width="42%" />
<col width="39%" />
<col width="19%" />
</colgroup>
<thead valign="bottom">
<tr class="row-odd"><th class="head">Error</th>
<th class="head">Meaning</th>
<th class="head">Repair</th>
</tr>
</thead>
<tbody valign="top">
<tr class="row-even"><td>Incomplete information for
entry &lt;EntryTag&gt;:&lt;EntryName&gt;
cannot verify</td>
<td>The described entry is not
fully specified by the
server, so no verification
can be performed.</td>
<td><a class="reference internal" href="#c1">[c1]</a></td>
</tr>
<tr class="row-odd"><td>Incomplete information for
entry &lt;EntryTag&gt;:&lt;EntryName&gt;
cannot install</td>
<td>The described entry is not
fully specified by the
server, so no verification
can be performed.</td>
<td><a class="reference internal" href="#c1">[c1]</a></td>
</tr>
<tr class="row-even"><td>The following entries are
not handled by any tool:
&lt;EntryTag&gt;:&lt;EntryName&gt;</td>
<td>The client cannot figure
out how to handle this
entry.</td>
<td><a class="reference internal" href="#c2">[c2]</a></td>
</tr>
<tr class="row-odd"><td>No ca is specified. Cannot
authenticate the server with
SSL.</td>
<td>The client is unable to
verify the server.</td>
<td><a class="reference internal" href="#c3">[c3]</a></td>
</tr>
<tr class="row-even"><td>GID normalization failed for
FILENAME. Does group GROUP
exist?</td>
<td>The client is unable to
convert the group GROUP to
a usable GID.</td>
<td><a class="reference internal" href="#c4">[c4]</a></td>
</tr>
<tr class="row-odd"><td>UID normalization failed for
FILENAME. Does owner OWNER
exist?</td>
<td>The client is unable to
convert the owner OWNER to
a usable UID.</td>
<td><a class="reference internal" href="#c5">[c5]</a></td>
</tr>
<tr class="row-even"><td>SSL CA error</td>
<td>The CA certificate
specified in bcfg2.conf is
incorrect</td>
<td><a class="reference internal" href="#c6">[c6]</a></td>
</tr>
</tbody>
</table>
<table class="docutils citation" frame="void" id="c1" rules="none">
<colgroup><col class="label" /><col /></colgroup>
<tbody valign="top">
<tr><td class="label">[c1]</td><td><em>(<a class="fn-backref" href="#id1">1</a>, <a class="fn-backref" href="#id2">2</a>)</em> This entry is not being bound. Ensure that a version of this
entry applies to this client.</td></tr>
</tbody>
</table>
<table class="docutils citation" frame="void" id="c2" rules="none">
<colgroup><col class="label" /><col /></colgroup>
<tbody valign="top">
<tr><td class="label"><a class="fn-backref" href="#id3">[c2]</a></td><td>It is possible that the type attribute for this generator entry
is undefined. You may need to add the appropriate type attribute
in the literal entry specification.</td></tr>
</tbody>
</table>
<table class="docutils citation" frame="void" id="c3" rules="none">
<colgroup><col class="label" /><col /></colgroup>
<tbody valign="top">
<tr><td class="label"><a class="fn-backref" href="#id4">[c3]</a></td><td>Copy the Bcfg2 server&#8217;s CA certificate to the client and specify it
using the <strong>ca</strong> option in the [communication] section of
<tt class="docutils literal"><span class="pre">bcfg2.conf</span></tt></td></tr>
</tbody>
</table>
<table class="docutils citation" frame="void" id="c4" rules="none">
<colgroup><col class="label" /><col /></colgroup>
<tbody valign="top">
<tr><td class="label"><a class="fn-backref" href="#id5">[c4]</a></td><td>If the group doesn&#8217;t exist, you need to specify the correct one
in an <a class="reference internal" href="../server/info.html#server-info"><em>info.xml</em></a> file or set the default group
appropriately.</td></tr>
</tbody>
</table>
<table class="docutils citation" frame="void" id="c5" rules="none">
<colgroup><col class="label" /><col /></colgroup>
<tbody valign="top">
<tr><td class="label"><a class="fn-backref" href="#id6">[c5]</a></td><td>If the owner doesn&#8217;t exist, you need to specify the correct one
in an <a class="reference internal" href="../server/info.html#server-info"><em>info.xml</em></a> file or set the default owner
appropriately.</td></tr>
</tbody>
</table>
<table class="docutils citation" frame="void" id="c6" rules="none">
<colgroup><col class="label" /><col /></colgroup>
<tbody valign="top">
<tr><td class="label"><a class="fn-backref" href="#id7">[c6]</a></td><td>Check that the CA specified in bcfg2.conf is appropriate for the
server you are attempting to access.</td></tr>
</tbody>
</table>
</div>
<div class="section" id="server-errors">
<h3>Server Errors<a class="headerlink" href="#server-errors" title="Permalink to this headline">¶</a></h3>
<table border="1" class="docutils">
<colgroup>
<col width="46%" />
<col width="32%" />
<col width="22%" />
</colgroup>
<thead valign="bottom">
<tr class="row-odd"><th class="head">Error</th>
<th class="head">Meaning</th>
<th class="head">Repair</th>
</tr>
</thead>
<tbody valign="top">
<tr class="row-even"><td>Failed to bind entry:
&lt;EntryTag&gt; &lt;EntryName&gt;</td>
<td>The server was
unable to find a
suitable version of
entry for client.</td>
<td><a class="reference internal" href="#s1">[s1]</a></td>
</tr>
<tr class="row-odd"><td>Failed to bind to socket</td>
<td>The server was
unable to bind to
the tcp server
socket.</td>
<td><a class="reference internal" href="#s2">[s2]</a></td>
</tr>
<tr class="row-even"><td>Failed to load
ssl key &lt;path&gt;</td>
<td>The server was
unable to read and
process the ssl key.</td>
<td><a class="reference internal" href="#s3">[s3]</a></td>
</tr>
<tr class="row-odd"><td>Failed to read file &lt;path&gt;</td>
<td>The server failed
to read the
specified file</td>
<td><a class="reference internal" href="#s4">[s4]</a></td>
</tr>
<tr class="row-even"><td>Failed to parse file &lt;path&gt;</td>
<td>The server failed
to parse the
specified XML file</td>
<td><a class="reference internal" href="#s5">[s5]</a></td>
</tr>
<tr class="row-odd"><td>Client metadata resolution
error for &lt;IP&gt;</td>
<td>The server cannot
resolve the client
hostname or the
client is
associated with a
non-profile group.</td>
<td><a class="reference internal" href="#s6">[s6]</a></td>
</tr>
<tr class="row-even"><td>Failed to decode &lt;filename&gt;
Please verify you are using
the proper encoding</td>
<td>The encoding being
used is unable to
decode the
character present
in this file.</td>
<td><a class="reference internal" href="#s7">[s7]</a></td>
</tr>
<tr class="row-odd"><td>Got unknown entries
[list of unknown entries]</td>
<td>The Packages plugin
has no knowledge of
the listed entries</td>
<td><a class="reference internal" href="#s8">[s8]</a></td>
</tr>
<tr class="row-even"><td>Failed to import lxml
dependency. Shutting
down server.</td>
<td>The server cannot
import lxml</td>
<td><a class="reference internal" href="#s9">[s9]</a></td>
</tr>
<tr class="row-odd"><td>You need to specify base64
encoding for &lt;path&gt;</td>
<td>The server cannot
send the file as
ascii text</td>
<td><a class="reference internal" href="#s10">[s10]</a></td>
</tr>
<tr class="row-even"><td>ERROR: Error reading file
&#8216;/path/to/schema&#8217;: failed to
load external entity
&#8220;/path/to/schema&#8221;</td>
<td>The server cannot
find the schema
file</td>
<td><a class="reference internal" href="#s11">[s11]</a></td>
</tr>
<tr class="row-odd"><td>Packages: No matching
sources for client
&lt;clientname&gt;; improper group
memberships?</td>
<td>None of the sources
defined in the
Package plugin&#8217;s
<tt class="docutils literal"><span class="pre">sources.xml</span></tt>
apply to the client</td>
<td><a class="reference internal" href="#s12">[s12]</a></td>
</tr>
</tbody>
</table>
<table class="docutils citation" frame="void" id="s1" rules="none">
<colgroup><col class="label" /><col /></colgroup>
<tbody valign="top">
<tr><td class="label"><a class="fn-backref" href="#id8">[s1]</a></td><td>This entry is not being bound. Ensure that a version of this
entry applies to this client.</td></tr>
</tbody>
</table>
<table class="docutils citation" frame="void" id="s2" rules="none">
<colgroup><col class="label" /><col /></colgroup>
<tbody valign="top">
<tr><td class="label"><a class="fn-backref" href="#id9">[s2]</a></td><td>Ensure that another instance of the daemon (or any other process)
is not listening on the same port.</td></tr>
</tbody>
</table>
<table class="docutils citation" frame="void" id="s3" rules="none">
<colgroup><col class="label" /><col /></colgroup>
<tbody valign="top">
<tr><td class="label"><a class="fn-backref" href="#id10">[s3]</a></td><td>Ensure that the key is readable by the user running the daemon
and that it is well-formed.</td></tr>
</tbody>
</table>
<table class="docutils citation" frame="void" id="s4" rules="none">
<colgroup><col class="label" /><col /></colgroup>
<tbody valign="top">
<tr><td class="label"><a class="fn-backref" href="#id11">[s4]</a></td><td>Ensure that this file still exists; a frequent cause is the
deletion of a temp file.</td></tr>
</tbody>
</table>
<table class="docutils citation" frame="void" id="s5" rules="none">
<colgroup><col class="label" /><col /></colgroup>
<tbody valign="top">
<tr><td class="label"><a class="fn-backref" href="#id12">[s5]</a></td><td>Ensure that the file is properly formed XML.</td></tr>
</tbody>
</table>
<table class="docutils citation" frame="void" id="s6" rules="none">
<colgroup><col class="label" /><col /></colgroup>
<tbody valign="top">
<tr><td class="label"><a class="fn-backref" href="#id13">[s6]</a></td><td>Fix hostname resolution for the client or ensure that the profile
group is properly setup.</td></tr>
</tbody>
</table>
<table class="docutils citation" frame="void" id="s7" rules="none">
<colgroup><col class="label" /><col /></colgroup>
<tbody valign="top">
<tr><td class="label"><a class="fn-backref" href="#id14">[s7]</a></td><td>Ensure the correct encoding is specified in the [components]
section of <tt class="docutils literal"><span class="pre">bcfg2.conf</span></tt>.</td></tr>
</tbody>
</table>
<table class="docutils citation" frame="void" id="s8" rules="none">
<colgroup><col class="label" /><col /></colgroup>
<tbody valign="top">
<tr><td class="label"><a class="fn-backref" href="#id15">[s8]</a></td><td>For packages listed other than <strong>gpg-pubkey</strong>, this error means
that the Packages plugin is unable to find the package in any of
the sources listed in <tt class="docutils literal"><span class="pre">Packages/sources.xml</span></tt>. The issue often
arises when the client is not in one of the groups necessary for
the Source listed. In the case of gpg-pubkey, you can safely
ignore the message as the Packages plugin has no knowledge of
these packages (however, note that this package is most often
specified as a BoundPackage entry).</td></tr>
</tbody>
</table>
<table class="docutils citation" frame="void" id="s9" rules="none">
<colgroup><col class="label" /><col /></colgroup>
<tbody valign="top">
<tr><td class="label"><a class="fn-backref" href="#id16">[s9]</a></td><td>Ensure that you have installed all the necessary
<a class="reference internal" href="../installation/prerequisites.html#installation-prerequisites"><em>Prerequisites</em></a>.</td></tr>
</tbody>
</table>
<table class="docutils citation" frame="void" id="s10" rules="none">
<colgroup><col class="label" /><col /></colgroup>
<tbody valign="top">
<tr><td class="label"><a class="fn-backref" href="#id17">[s10]</a></td><td>You likely need to specify a base64 encoding using an
<a class="reference internal" href="../server/info.html#server-info"><em>info.xml</em></a> file for this entry.</td></tr>
</tbody>
</table>
<table class="docutils citation" frame="void" id="s11" rules="none">
<colgroup><col class="label" /><col /></colgroup>
<tbody valign="top">
<tr><td class="label"><a class="fn-backref" href="#id18">[s11]</a></td><td>Verify that you have the proper prefix set in bcfg2.conf.</td></tr>
</tbody>
</table>
<table class="docutils citation" frame="void" id="s12" rules="none">
<colgroup><col class="label" /><col /></colgroup>
<tbody valign="top">
<tr><td class="label"><a class="fn-backref" href="#id19">[s12]</a></td><td>Ensure that the client is a member of all the appropriate
<a class="reference internal" href="../server/plugins/generators/packages.html#server-plugins-generators-packages-magic-groups"><em>&#8220;Magic Groups&#8221;</em></a> as
well as any additional groups you may have defined in your
<a class="reference internal" href="../server/plugins/generators/packages.html#server-plugins-generators-packages"><em>Packages</em></a> configuration.</td></tr>
</tbody>
</table>
</div>
</div>
<div class="section" id="faqs">
<h2>FAQs<a class="headerlink" href="#faqs" title="Permalink to this headline">¶</a></h2>
<div class="section" id="why-won-t-bcfg2-server-start">
<h3>Why won&#8217;t bcfg2-server start?<a class="headerlink" href="#why-won-t-bcfg2-server-start" title="Permalink to this headline">¶</a></h3>
<p>If your server doesn&#8217;t seem to be starting and you see no error
messages in your server logs, try running it in the foreground to see
why.</p>
</div>
<div class="section" id="why-am-i-getting-a-traceback">
<h3>Why am I getting a traceback?<a class="headerlink" href="#why-am-i-getting-a-traceback" title="Permalink to this headline">¶</a></h3>
<p>If you get a traceback, please let us know by reporting it
on <a class="reference external" href="http://bcfg2.org">Trac ticket tracker</a>, via the mailing list, or on IRC. Your best bet
to get a quick response will be to jump on IRC during the daytime (CST).</p>
</div>
<div class="section" id="what-is-the-most-common-cause-of-the-following-entries-are-not-handled-by-any-tool">
<h3>What is the most common cause of &#8220;The following entries are not handled by any tool&#8221;?<a class="headerlink" href="#what-is-the-most-common-cause-of-the-following-entries-are-not-handled-by-any-tool" title="Permalink to this headline">¶</a></h3>
<p>Often it corresponds to entries that aren&#8217;t bound by the server (for which
you&#8217;ll get error messages on the server). You should try inspecting the
logs on the server to see what may be the cause.</p>
</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="#">Troubleshooting</a><ul>
<li><a class="reference internal" href="#figure-out-if-error-is-client-or-server-side">Figure out if error is client or server side</a></li>
<li><a class="reference internal" href="#review-server-log-messages">Review server log messages</a></li>
<li><a class="reference internal" href="#check-if-all-repository-xml-files-conform-to-schemas">Check if all repository XML files conform to schemas</a></li>
<li><a class="reference internal" href="#if-the-bcfg2-server-is-not-reflecting-recent-changes-try-restarting-the-bcfg2-server-process">If the bcfg2 server is not reflecting recent changes, try restarting the bcfg2-server process</a></li>
<li><a class="reference internal" href="#bcfg2-info">bcfg2-info</a></li>
<li><a class="reference internal" href="#error-messages">Error Messages</a><ul>
<li><a class="reference internal" href="#client-errors">Client Errors</a></li>
<li><a class="reference internal" href="#server-errors">Server Errors</a></li>
</ul>
</li>
<li><a class="reference internal" href="#faqs">FAQs</a><ul>
<li><a class="reference internal" href="#why-won-t-bcfg2-server-start">Why won&#8217;t bcfg2-server start?</a></li>
<li><a class="reference internal" href="#why-am-i-getting-a-traceback">Why am I getting a traceback?</a></li>
<li><a class="reference internal" href="#what-is-the-most-common-cause-of-the-following-entries-are-not-handled-by-any-tool">What is the most common cause of &#8220;The following entries are not handled by any tool&#8221;?</a></li>
</ul>
</li>
</ul>
</li>
</ul>

  <h4>Previous topic</h4>
  <p class="topless"><a href="faq/client.html"
                        title="previous chapter">FAQ: Client</a></p>
  <h4>Next topic</h4>
  <p class="topless"><a href="../glossary.html"
                        title="next chapter">Glossary</a></p>
  <h3>This Page</h3>
  <ul class="this-page-menu">
    <li><a href="../_sources/help/troubleshooting.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="../glossary.html" title="Glossary"
             >next</a> |</li>
        <li class="right" >
          <a href="faq/client.html" title="FAQ: Client"
             >previous</a> |</li>
	<li><a href="../index.html">home</a> |&nbsp;</li>
	<!--<li><a href="../search.html">search</a> |&nbsp;</li>-->
	<li><a href="index.html">help</a> |&nbsp;</li>
	<li><a href="../contents.html">documentation </a> &raquo;</li>

          <li><a href="../contents.html" >Bcfg2 documentation 1.3.0</a> &raquo;</li>
          <li><a href="index.html" >Getting Help with Bcfg2</a> &raquo;</li> 
      </ul>
    </div>
    <div class="footer">
        &copy; 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>