summaryrefslogtreecommitdiffstats
path: root/README
diff options
context:
space:
mode:
authorNarayan Desai <desai@mcs.anl.gov>2004-11-08 20:59:47 +0000
committerNarayan Desai <desai@mcs.anl.gov>2004-11-08 20:59:47 +0000
commitbb0b74b629b40df54a9304aac4ac7f1304a8ffce (patch)
treeb95b0b8ccf61d7a1c209676cc20cd64c5ab56633 /README
parent031ad9ffba438e5c9a32a212c15bc9cc88ee0a25 (diff)
downloadbcfg2-bb0b74b629b40df54a9304aac4ac7f1304a8ffce.tar.gz
bcfg2-bb0b74b629b40df54a9304aac4ac7f1304a8ffce.tar.bz2
bcfg2-bb0b74b629b40df54a9304aac4ac7f1304a8ffce.zip
initial update
(Logical change 1.148) git-svn-id: https://svn.mcs.anl.gov/repos/bcfg/trunk/bcfg2@654 ce84e21b-d406-0410-9b95-82705330c041
Diffstat (limited to 'README')
-rw-r--r--README38
1 files changed, 24 insertions, 14 deletions
diff --git a/README b/README
index 4a7e2d4fb..4796d72d5 100644
--- a/README
+++ b/README
@@ -1,23 +1,33 @@
-Release 0.3 - $Id: $
+Release 0.6 - $Id: $
-This is the Bcfg2 repo. It is a configuration management system
-designed to ease the management of networks of heterogenous
-systems. The system has been completely redesigned and reimplemented
-from version 1.
+Bcfg2 is a configuration management tool based on a few simple principles.
+ - All aspects of system configuration can be described by the configuration
+ management system.
+ - All aspects of system configuration are described by the configuration
+ management system. This allows the detection of extra configuration
+ that contributes to system behavior.
+ - Services must be management coherently. This means that the tool must
+ be able to determine how to correctly install all aspects of configuration,
+ and verify that these are active before a host is determined to be clean.
+ This property is implemented using bundles, a construct that is similar
+ to closures [1].
-Currently, bcfg2 is in alpha-ish state. The server infrastructure can
-produce configurations in clients based on the a set of structures and
-generators. Generators can provide clients with probes to execute
-(guiding the configuration generation process) and recieve the data
-these probes generate. Client statistics are not currently generated.
+The state of the code is as follows. The server side is fairly solid,
+and will continue working in the presence of generator faults. The
+client side fully supports debian toolsets, and all of the standard
+posix constructs used for configuration management (configuration
+files, symlinks, directories, etc)
-The bcfg2 client is a lot more rough. The client works, though its
-adherence to bundle semantics is probably not what it should be. It
-successfully one-way validates configurations. Two-way support is not
-yet implemented.
+The code is currently being used in production to manage debian
+systems. There is client support for other architectures, but it
+hasn't been well tested.
The source tree is structured in the following way:
doc/ - documentation
src/ - source code
schemas/ - schemas defining the data format for configuration files
+
+[1] Seeking Closure in an Open World: A Behavioral Agent Approach
+ to Configuration Management, Alva Couch, John Hart,
+ Elizabeth G. Idhaw, and Dominic Kallas, in the proceedings of LISA03