From 0fba2216c8ebe88bd3b74fd79edf27982d33ae69 Mon Sep 17 00:00:00 2001 From: Fabian Affolter Date: Tue, 9 Nov 2010 00:29:52 +0100 Subject: Intro added --- doc/contents.txt | 38 +++++--------- doc/index.txt | 80 +++--------------------------- doc/introduction/architecture-overview.txt | 34 +++++++++++++ doc/introduction/index.txt | 41 +++++++++++++++ doc/introduction/os-support.txt | 46 +++++++++++++++++ 5 files changed, 141 insertions(+), 98 deletions(-) create mode 100644 doc/introduction/architecture-overview.txt create mode 100644 doc/introduction/index.txt create mode 100644 doc/introduction/os-support.txt (limited to 'doc') diff --git a/doc/contents.txt b/doc/contents.txt index 40128175e..df5c5350c 100644 --- a/doc/contents.txt +++ b/doc/contents.txt @@ -2,30 +2,29 @@ .. _contents: -================================= -Welcome to Bcfg2's documentation! -================================= +========================================== +Welcome to Bcfg2's |version| documentation +========================================== .. toctree:: :maxdepth: 2 + :numbered: - index - quickstart/index - help/index - faq/index - authentication + introduction/index + installation/index getting_started/index + architecture/index server/index client/index - troubleshooting - help/index - bcfg2.conf-options - architecture + reports/index development/index - + getting_help/index + glossary + appendix/index + unsorted/index + obsolete/index - glossary Indices, glossary and tables ============================ @@ -34,14 +33,3 @@ Indices, glossary and tables * :ref:`modindex` * :ref:`glossary` * :ref:`search` - -Deprecated/obsolete documentation -================================= - -The following documentation covers features that have been deprecated or that -have been replaced in newer versions of Bcfg2. - -.. toctree:: - :maxdepth: 2 - - obsolete/index diff --git a/doc/index.txt b/doc/index.txt index 0479fea2d..583ea38e3 100644 --- a/doc/index.txt +++ b/doc/index.txt @@ -2,9 +2,9 @@ .. _index: -====================== -Bcfg2 Manual |release| -====================== +========================================== +Welcome to Bcfg2's |version| documentation +========================================== What is Bcfg2? ============== @@ -37,74 +37,8 @@ systems are constantly changing; if required in your environment, Bcfg2 can enable the construction of complex change management and deployment strategies. -Architecture ------------- - -Bcfg2 provides a declarative interface to system configuration. Its -configuration specifications describe a literal configuration goal -state for clients. In this architecture, the Bcfg2 client tool is -responsible for determining what, if any, configuration operations must -occur and then performing those operations. The client also uploads -statistics and client configuration state information. The design -and implementation of the reporting system is described on a separate -:ref:`page `. - -A comprehensive description of the Bcfg2 Architecture (and the choices -behind the design) can be found at :ref:`architecture`. - -Server -^^^^^^ - -The role of the Bcfg2 server is rendering a client-specific target -configuration description from a global specification. The specification -consists of a directory structure containing data for a variety of server -plugins. The Bcfg2 server has a plugin interface that can be used to -interpret the configuration specification. - -Client -^^^^^^ - -The Bcfg2 client is responsible for determining what operations are -necessary in order to reach the desired configuration state. Read on -for more information about :ref:`client-index`. - -What Operating Systems Does Bcfg2 Support? -========================================== - -Bcfg2 is fairly portable. It has been successfully run on: - -* `AIX`_, `FreeBSD`_, `OpenBSD`_, `Mac OS X`_, `OpenSolaris`_, - `Solaris`_. - -.. _AIX: http://www.ibm.com/aix -.. _FreeBSD: http://www.freebsd.org/ -.. _OpenBSD: http://www.openbsd.org/ -.. _Mac OS X: http://www.apple.com/macosx/ -.. _OpenSolaris: http://opensolaris.org/ -.. _Solaris: http://www.sun.com/software/solaris/ - -* Many `GNU/Linux`_ distributions, including `Blag`_, `CentOS`_, - `Debian`_, `Fedora`_, `Gentoo`_, `gNewSense`_, `Mandriva`_, - `OpenSUSE`_, `Redhat/RHEL`_, `SuSE/SLES`_, `Trisquel`_ and - `Ubuntu`_. - -.. _GNU/Linux: http://www.gnu.org/gnu/Linux-and-gnu.html -.. _Blag: http://www.blagblagblag.org/ -.. _CentOS: http://www.centos.org/ -.. _Debian: http://www.debian.org/ -.. _Fedora: http://www.fedoraproject.org/ -.. _Gentoo: http://www.gentoo.org/ -.. _gNewSense: http://www.gnewsense.org/ -.. _Mandriva: http://www.mandriva.com/ -.. _OpenSUSE: http://opensuse.org/ -.. _Redhat/RHEL: http://www.redhat.com/rhel/ -.. _SuSE/SLES: http://www.novell.com/linux/ -.. _Trisquel: http://trisquel.info/ -.. _Ubuntu: http://www.ubuntu.com/ +.. toctree:: + :numbered: + :maxdepth: 2 -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` -(new client tools are pretty easy to add). Check the :ref:`FAQ -` for a more exact list of platforms on which Bcfg2 -works. + contents diff --git a/doc/introduction/architecture-overview.txt b/doc/introduction/architecture-overview.txt new file mode 100644 index 000000000..55bf4e557 --- /dev/null +++ b/doc/introduction/architecture-overview.txt @@ -0,0 +1,34 @@ +.. -*- mode: rst -*- + +.. _architecture-overview: + +Architecture Overview +===================== + +Bcfg2 provides a declarative interface to system configuration. Its +configuration specifications describe a literal configuration goal +state for clients. In this architecture, the Bcfg2 client tool is +responsible for determining what, if any, configuration operations must +occur and then performing those operations. The client also uploads +statistics and client configuration state information. The design +and implementation of the reporting system is described on a separate +:ref:`page `. + +A comprehensive description of the Bcfg2 Architecture (and the choices +behind the design) can be found at :ref:`architecture-index`. + +Server +------ + +The role of the Bcfg2 server is rendering a client-specific target +configuration description from a global specification. The specification +consists of a directory structure containing data for a variety of server +plugins. The Bcfg2 server has a plugin interface that can be used to +interpret the configuration specification. + +Client +------ + +The Bcfg2 client is responsible for determining what operations are +necessary in order to reach the desired configuration state. Read on +for more information about :ref:`client-index`. diff --git a/doc/introduction/index.txt b/doc/introduction/index.txt new file mode 100644 index 000000000..5f4d41ff4 --- /dev/null +++ b/doc/introduction/index.txt @@ -0,0 +1,41 @@ +.. -*- mode: rst -*- + +.. _introduction-index: + +Introduction +============ + +Bcfg2 helps system administrators produce a consistent, reproducible, +and verifiable description of their environment, and offers +visualization and reporting tools to aid in day-to-day administrative +tasks. It is the fifth generation of configuration management tools +developed in the `Mathematics and Computer Science Division`_ of +`Argonne National Laboratory`_. + +.. _Mathematics and Computer Science Division: http://www.mcs.anl.gov/ +.. _Argonne National Laboratory: http://www.anl.gov/ + +It is based on an operational model in which the specification can be +used to validate and optionally change the state of clients, but in a +feature unique to Bcfg2 the client's response to the specification can +also be used to assess the completeness of the specification. Using +this feature, Bcfg2 provides an objective measure of how good a job an +administrator has done in specifying the configuration of client +systems. Bcfg2 is therefore built to help administrators construct an +accurate, comprehensive specification. + +Bcfg2 has been designed from the ground up to support gentle +reconciliation between the specification and current client states. It +is designed to gracefully cope with manual system modifications. + +Finally, due to the rapid pace of updates on modern networks, client +systems are constantly changing; if required in your environment, +Bcfg2 can enable the construction of complex change management and +deployment strategies. + + +.. toctree:: + :maxdepth: 2 + + architecture-overview + os-support diff --git a/doc/introduction/os-support.txt b/doc/introduction/os-support.txt new file mode 100644 index 000000000..efbc307cb --- /dev/null +++ b/doc/introduction/os-support.txt @@ -0,0 +1,46 @@ +.. -*- mode: rst -*- + +.. _os-support: + +What Operating Systems Does Bcfg2 Support? +------------------------------------------ + +Bcfg2 is fairly portable. It has been successfully run on: + +* `AIX`_, `FreeBSD`_, `OpenBSD`_, `Mac OS X`_, `OpenSolaris`_, + `Solaris`_. + +.. _AIX: http://www.ibm.com/aix +.. _FreeBSD: http://www.freebsd.org/ +.. _OpenBSD: http://www.openbsd.org/ +.. _Mac OS X: http://www.apple.com/macosx/ +.. _OpenSolaris: http://opensolaris.org/ +.. _Solaris: http://www.sun.com/software/solaris/ + +* Many `GNU/Linux`_ distributions, including `Archlinux`_, `Blag`_, `CentOS`_, + `Debian`_, `Fedora`_, `Gentoo`_, `gNewSense`_, `Mandriva`_, + `OpenSUSE`_, `Red Hat/RHEL`_, `Scientific Linux`_, `SuSE/SLES`_, `Trisquel`_, + and `Ubuntu`_. + +.. _GNU/Linux: http://www.gnu.org/gnu/Linux-and-gnu.html +.. _Archlinux: http://www.archlinux.org +.. _Blag: http://www.blagblagblag.org/ +.. _CentOS: http://www.centos.org/ +.. _Debian: http://www.debian.org/ +.. _Fedora: http://www.fedoraproject.org/ +.. _Gentoo: http://www.gentoo.org/ +.. _gNewSense: http://www.gnewsense.org/ +.. _Mandriva: http://www.mandriva.com/ +.. _OpenSUSE: http://opensuse.org/ +.. _Red Hat/RHEL: http://www.redhat.com/rhel/ +.. _Scientific Linux: http://www.scientificlinux.org/ +.. _SuSE/SLES: http://www.novell.com/linux/ +.. _Trisquel: http://trisquel.info/ +.. _Ubuntu: http://www.ubuntu.com/ + +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` +(new client tools are pretty easy to add). Check the :ref:`FAQ +` for a more exact list of platforms on which Bcfg2 +works`. -- cgit v1.2.3-1-g7c22