From c5927d262edb1a4d6fb32b03f9baf3f6e85b0b8e Mon Sep 17 00:00:00 2001 From: Sol Jerome Date: Fri, 15 Jan 2010 15:49:42 +0000 Subject: doc: Add ssh agent and architecture pages Signed-off-by: Sol Jerome git-svn-id: https://svn.mcs.anl.gov/repos/bcfg/trunk/bcfg2@5683 ce84e21b-d406-0410-9b95-82705330c041 --- doc/client/index.txt | 15 ++++++++++++++- 1 file changed, 14 insertions(+), 1 deletion(-) (limited to 'doc/client/index.txt') diff --git a/doc/client/index.txt b/doc/client/index.txt index 7762b677c..0e67a7014 100644 --- a/doc/client/index.txt +++ b/doc/client/index.txt @@ -1,10 +1,23 @@ -.. client-index: +.. -*- mode: rst -*- + +.. _client-index: The Bcfg2 Client ================ +The Bcfg2 client is responsible for determining what reconfiguration +operations must be undertaken on the client, but does not perform any +processing of the target configuration description. We chose this +architecture, as opposed to one with a smarter client, for a few reasons: + +* Client failure forces administrators to perform an O(n) reconfiguration operation. Simpler code is easier to debug and maintain. +* Minimize the bootstrap size; a complicated client can require more aspects of the system to function in order for reconfiguration to work. +* Isolate configuration generation functionality on the server, where it can be readily observed. This is the most complicated task that Bcfg2 performs. +* The results of the configuration process fit a fairly simple model. We wanted to validate it. The result is that Bcfg2 has a programmable deployment engine that can be driven by anything that writes a compatible configuration description. + .. toctree:: :maxdepth: 2 :glob: + * tools/* -- cgit v1.2.3-1-g7c22