summaryrefslogtreecommitdiffstats
path: root/doc/install.xml
diff options
context:
space:
mode:
authorNarayan Desai <desai@mcs.anl.gov>2005-09-27 20:10:03 +0000
committerNarayan Desai <desai@mcs.anl.gov>2005-09-27 20:10:03 +0000
commit1ccdc403fd808c6e1bd7401c513ecf5478ec9abd (patch)
tree8076d10bc79746731cb59601ddef43c62bca1ff1 /doc/install.xml
parent3bd03498bfebbf45d0d8afcb2e4cea3758111e5a (diff)
downloadbcfg2-1ccdc403fd808c6e1bd7401c513ecf5478ec9abd.tar.gz
bcfg2-1ccdc403fd808c6e1bd7401c513ecf5478ec9abd.tar.bz2
bcfg2-1ccdc403fd808c6e1bd7401c513ecf5478ec9abd.zip
add a section for the xml-rpc stuff
(Logical change 1.322) git-svn-id: https://svn.mcs.anl.gov/repos/bcfg/trunk/bcfg2@1313 ce84e21b-d406-0410-9b95-82705330c041
Diffstat (limited to 'doc/install.xml')
-rw-r--r--doc/install.xml51
1 files changed, 51 insertions, 0 deletions
diff --git a/doc/install.xml b/doc/install.xml
index ff7fd8156..48498a735 100644
--- a/doc/install.xml
+++ b/doc/install.xml
@@ -109,4 +109,55 @@ $ python setup.py install
machine bcfgserver, port 8052, with the wire protocol "challenge".
</para>
</sect1>
+ <sect1>
+ <title>New-Style XML-RPC Deployments</title>
+
+ <para>
+ A new version of the Bcfg2 software is in testing that will
+ provide simplified and standards compliant communications
+ facilities. Instead of the use of SSSlib for communication, the
+ server and clients can use HTTPS XML-RPC instead. This has
+ required reimplementing the server and providing XML-RPC support
+ for the client, but provides drastically simplified setup for
+ new installs.
+ </para>
+
+ <para>
+ The prerequisite list now includes ElementTree, M2Crypto (for
+ SSL functions) and Python 2.2 or newer. ElementTree and M2Crypto
+ are both python modules that can be easily installed and are
+ already packaged for many Linux distributions.
+ </para>
+
+ <sect2>
+ <title>SSL Certificate Generation</title>
+
+ <para>SSL is used for channel-level data encryption. The
+ requisite SSL certificates must be generated on the server
+ side. I need to figure out how to do this.
+ </para>
+
+ </sect2>
+
+ <sect2>
+ <title>Communication Bootstrapping</title>
+
+ <para>
+ The Bcfg2 client must be able to find the server's
+ location. This is accomplished through the use of the
+ communication settings in <filename>/etc/bcfg2.conf</filename>
+ Two settings for the this section are required: protocol and
+ server url.
+ </para>
+
+ <example>
+ <title>Bcfg2 XML-RPC Communication Settings</title>
+ <programlisting>
+ [communication]
+ protocol = xmlrpc/ssl
+ url = https://localhost:9443
+ </programlisting>
+ </example>
+ </sect2>
+ </sect1>
</chapter> \ No newline at end of file