Merge remote branch 'upstream/master'

3 files changed, 99 insertions, 0 deletions

diff --git a/doc/help/faq/client.txt b/doc/help/faq/client.txt
new file mode 100644
index 000000000..746b0201d
--- /dev/null
+++ b/doc/help/faq/client.txt
@@ -0,0 +1,26 @@
+.. -*- mode: rst -*-
+
+.. _faq-client:
+
+FAQ: Client
+===========
+
+**No ca is specified. Cannot authenticate the server with SSL.**
+
+This means that the client does not have a copy of the CA for the server,
+so it can't verify that it is talking to the right server. To fix this
+issue, copy ``/etc/bcfg2.crt`` from the server to ``/etc/bcfg2.ca``
+on the client. Then add the following on the client.::
+
+    [communication]
+    ca = /etc/bcfg2.ca
+
+**Server failure**
+
+On Fedora 14 and above it can happen that no connection is possible.
+
+    # bcfg2 -vqne
+    Server failure: Protocol Error: 401 Unauthorized
+    Failed to download probes from bcfg2
+    Server Failure
+
diff --git a/doc/help/faq/general.txt b/doc/help/faq/general.txt
new file mode 100644
index 000000000..0534e72d2
--- /dev/null
+++ b/doc/help/faq/general.txt
@@ -0,0 +1,56 @@
+.. -*- mode: rst -*-
+
+.. _faq-general:
+
+FAQ: General
+============
+
+**What does Bcfg2 stand for?**
+
+Initially, Bcfg stood for the bundle configuration system. Bcfg2 is the
+second major revision. At this point, the acronym is meaningless, but
+the name has stuck. Luckily, Bcfg2 googles better than Bcfg does. No,
+seriously. Try it. All I know is that I have no interest in a billion
+cubic feet of gas.
+
+**What architectures does Bcfg2 support?**
+
+Bcfg2 should run on any POSIX compatible operating system, however direct
+support for an operating system's package and service formats are limited
+by the currently available :ref:`client-tools-index` (although new client
+tools are pretty easy to add). The following is an incomplete but more
+exact list of platforms on which Bcfg2 works.
+
+* GNU/Linux deb based distros
+* GNU/Linux rpm based distros
+* Solaris pkg based
+* Gentoo portage based
+* OSX (POSIX/launchd support)
+
+**What pre-requisites are needed to run Bcfg2?**
+
+Please visit the :ref:`prerequisites` section in the manual.
+
+**Why won't bcfg2-server start?**
+
+If your server doesn't seem to be starting and you see no error
+messages in your server logs, try running it in the foreground to
+see why.
+
+**Why am I getting a traceback?**
+
+If you get a traceback, please let us know. You can file a `ticket
+<https://trac.mcs.anl.gov/projects/bcfg2/newticket>`_, send the traceback
+to the :ref:`help-mailinglist`, or hop on the :ref:`help-irc` and let
+us know.
+
+**Where are the server log messages?**
+
+The bcfg2-server process logs to syslog facility LOG_DAEMON. The server produces a series of messages upon a variety of events and errors.
+
+**Is there a way to check if all repository XML files conform to schemas?**
+
+Bcfg2 comes with XML schemas describing all of the XML formats used in
+the server repository. A validation command ``bcfg2-repo-validate`` is
+included with the source distribution and all packages. Run it with
+the ``-v`` flag to see each file and the results if its validation.
diff --git a/doc/help/faq/index.txt b/doc/help/faq/index.txt
new file mode 100644
index 000000000..ee418d84d
--- /dev/null
+++ b/doc/help/faq/index.txt
@@ -0,0 +1,17 @@
+.. -*- mode: rst -*-
+
+.. _faq-index:
+
+===
+FAQ
+===
+
+The Frequently Asked Questions (FAQ) answers the most common questions
+about Bcfg2.  At the moment the FAQ is splitted into a general
+and a client specfic section.
+
+.. toctree::
+   :maxdepth: 2
+
+   general
+   client