From c56206bb1618baffd485929ecc0fb027abe120a6 Mon Sep 17 00:00:00 2001 From: Narayan Desai Date: Thu, 12 Aug 2004 19:21:39 +0000 Subject: (Logical change 1.41) git-svn-id: https://svn.mcs.anl.gov/repos/bcfg/trunk/bcfg2@243 ce84e21b-d406-0410-9b95-82705330c041 --- doc/SETUP | 37 +++++++++++++++++++++++++++++++++++++ doc/constructs.txt | 17 +++++++++++++++++ 2 files changed, 54 insertions(+) (limited to 'doc') diff --git a/doc/SETUP b/doc/SETUP index e69de29bb..d99ddaa27 100644 --- a/doc/SETUP +++ b/doc/SETUP @@ -0,0 +1,37 @@ +$Id: $ + +This document describes how to setup a Bcfg2 repository from scratch. + +1. /etc/bcfg2.conf + +This file tells Bcfg2Server important bootstrapping information about +where its repository is, and which configuration structuring agents +and generators should be used to build client +configurations. The list of structures and generators are comma +delimited and must be importable by python from the +Bcfg2.Server.(Generators|Structures) hierarchy (respectively). All +options currently are in the [server] section. + +repository: top level of configuration file repository +structures: comma delimited list of structuring agents to use. +generators: comma delimited list of generators to use. +metadata: path to the directory where metadata.xml (the client + metadata setup) resides. + +2. metadata/metadata.xml + +This file defines metadata constructs for all known systems. This file +contains two types of declarations: one for clients, including an +attribute for client image, and client nodes for class membership and +attributes. See the example file for more info. This file doesn't +need to be exhaustively written: bcfg2 will soon support defaults (to +support environments where machines are frequently added) and default +profiles. + +3. The repository + +Structuring agents and generators are responsible for contructing +client configurations. All of these currently use FAM to coherently +cache files on disk, with notifications upon file changes. The +repository contains a directory for each of these; which is structured +according to the needs of that generator/structure. \ No newline at end of file diff --git a/doc/constructs.txt b/doc/constructs.txt index e69de29bb..e6cdb4707 100644 --- a/doc/constructs.txt +++ b/doc/constructs.txt @@ -0,0 +1,17 @@ +1. Client Metadata + +Clients are differentiated in terms of several types of +metadata. These types (from least to most specific) are: + +- image : the binary compatibility domain of the machine (like + debian-3.1 or redhat-7.3) +- classes : a host can belong to multiple classes. Classes are used to + derive the set of software to install on a particular client. +- bundles: bundles are a sets of related bits of + configuration. Generally, each bundle provides some piece of + discrete functionality. +- attributes : attributes can be used to further differentiate + bundles, or client configurations and are bundle scoped. A host + may have the webserver.ssl attribute if it is supposed to provide + ssl/https services in addition to normal port 80 http service. +- hostname : this is kind of obvious \ No newline at end of file -- cgit v1.2.3-1-g7c22