diff options
author | Sol Jerome <solj@ices.utexas.edu> | 2009-07-31 14:53:02 +0000 |
---|---|---|
committer | Sol Jerome <solj@ices.utexas.edu> | 2009-07-31 14:53:02 +0000 |
commit | e9ba602ea0781d9cdf2683561e61309d6d6b8b12 (patch) | |
tree | 40dea65b061447bd139cb6bf4fdb5c86c7d32bb5 | |
parent | 770daad7cc4db1a2be8de655bd2e4930dbee236d (diff) | |
download | bcfg2-e9ba602ea0781d9cdf2683561e61309d6d6b8b12.tar.gz bcfg2-e9ba602ea0781d9cdf2683561e61309d6d6b8b12.tar.bz2 bcfg2-e9ba602ea0781d9cdf2683561e61309d6d6b8b12.zip |
Documentation: Update man pages to reflect changes in 1.0
* Add Snapshots documentation
* Fix example bcfg2.conf
* Add Plugin descriptions for server plugins
Signed-off-by: Sol Jerome <solj@ices.utexas.edu>
git-svn-id: https://svn.mcs.anl.gov/repos/bcfg/trunk/bcfg2@5397 ce84e21b-d406-0410-9b95-82705330c041
-rw-r--r-- | examples/bcfg2.conf | 5 | ||||
-rw-r--r-- | man/bcfg2-admin.8 | 26 | ||||
-rw-r--r-- | man/bcfg2.conf.5 | 192 |
3 files changed, 167 insertions, 56 deletions
diff --git a/examples/bcfg2.conf b/examples/bcfg2.conf index d163e9e1a..cac424576 100644 --- a/examples/bcfg2.conf +++ b/examples/bcfg2.conf @@ -1,9 +1,8 @@ [communication] protocol = xmlrpc/ssl password = foobat -key = /etc/bcfg2.key -# fingerprint of server (from bcfg2-admin fingerprint) -#fingerprint = [server fingerprint] +# certificate = /etc/bcfg2.key +# key = /etc/bcfg2.key [components] bcfg2 = https://localhost:6789 diff --git a/man/bcfg2-admin.8 b/man/bcfg2-admin.8 index 4af010144..3cfc5998c 100644 --- a/man/bcfg2-admin.8 +++ b/man/bcfg2-admin.8 @@ -45,11 +45,15 @@ Build structure entries based on client statistics extra entries Install configuration information into repo based on client bad entries .RE +.B snapshots [init|dump|query|reports] +.RS +Interact with the Snapshots database +.RE .B tidy .RS Remove unused files from repository .RE -.B viz [-h] [-b] [-k] [-o png-file] [-r] +.B viz [-H] [-b] [-k] [-o png-file] [-r] .RS Create a graphviz diagram of client, group and bundle information .RE @@ -127,9 +131,27 @@ Specify the type of the entry to pull .RS Specify the name of the entry to pull .RE +.SH SNAPSHOTS OPTIONS +.PP +.B init +.RS +Initialize the snapshots database +.RE +.B query +.RS +Query the snapshots database +.RE +.B dump +.RS +Dump some of the contents of the snapshots database +.RE +.B reports [-a] [-b] [-e] [--date=<MM-DD-YYYY>] +.RS +Generate reports for clients in the snapshots database +.RE .SH VIZ OPTIONS .PP -.B \-h +.B \-H .RS Include hosts in diagram .RE diff --git a/man/bcfg2.conf.5 b/man/bcfg2.conf.5 index 0b30c5e3a..59936a60a 100644 --- a/man/bcfg2.conf.5 +++ b/man/bcfg2.conf.5 @@ -8,35 +8,21 @@ bcfg2.conf - configuration parameters for bcfg2 bcfg2.conf includes configuration parameters for the bcfg2 server and client. .SH FILE FORMAT -The file is INI-style and consists of sections and options. A section -begins with the name of the sections in square brackets and continues -until the next section begins. +The file is INI-style and consists of sections and options. A section begins with the name of the sections in square brackets and continues until the next section begins. Options are specified in the form 'name = value'. -The file is line-based each newline-terminated line represents either a -comment, a section name or an option. +The file is line-based each newline-terminated line represents either a comment, a section name or an option. -Any line beginning with a hash (#) is ignored, as are lines containing -only whitespace. +Any line beginning with a hash (#) is ignored, as are lines containing only whitespace. .SH SERVER OPTIONS -These options are only necessary on the Bcfg2 server. They are specified -in the [server] section of the configuration file. +These options are only necessary on the Bcfg2 server. They are specified in the [server] section of the configuration file. .TP .B repository -Specifies the path to the Bcfg2 repository containing all of the -configuration specifications. The repository should be created using the -bcfg2-init command. - -.TP -.B plugins -A comma-delimited list of enabled server plugins. Currently available -plugins are Actions, Base, Bundler, Cfg, DBStats, Deps, Git, Hostbase, -Packages, Pkgmgr, Rules, SGenshi, Snapshots, SSHbase, Svn, TCheetah, and -TGenshi. +Specifies the path to the Bcfg2 repository containing all of the configuration specifications. The repository should be created using the bcfg2-init command. .TP .B bundles @@ -44,8 +30,129 @@ A list of enabled bundles .TP .B filemonitor -The file monitor used to watch for changes in the repository. -Values of 'gamin', 'fam', or 'pseudo' are valid. +The file monitor used to watch for changes in the repository. Values of 'gamin', 'fam', or 'pseudo' are valid. + +.TP +.B plugins +A comma-delimited list of enabled server plugins. Currently available plugins are: + +\(bu +.B Account +The account plugin manages authentication data, including: + + * /etc/passwd + * /etc/group + * /etc/security/limits.conf + * /etc/sudoers + * /root/.ssh/authorized_keys + +\(bu +.B Actions + +Action entries are commands that are executed either before bundle installation, after bundle installation or both. If exit status is observed, a failing pre-action will cause no modification of the enclosing bundle to be performed; all entries included in that bundle will not be modified. Failing actions are reported through Bcfg2's reporting system, so they can be centrally observed. + +\(bu +.B BB + +\(bu +.B Base +A structure plugin that provides the ability to add lists of unrelated entries into client configuration entry inventories. Base works much like Bundler in its file format. This structure plugin is good for the pile of independent configs needed for most actual systems. + +\(bu +.B Bundler +Bundler is used to describe groups of inter-dependent configuration entries, such as the combination of packages, configuration files, and service activations that comprise typical Unix daemons. Bundles are used to add groups of configuration entries to the inventory of client configurations, as opposed to describing particular versions of those +entries. + +\(bu +.B Cfg +The Cfg plugin provides a repository to describe configuration file contents for clients. In its simplest form, the Cfg repository is just a directory tree modeled off of the directory tree on your client machines. + +\(bu +.B DBStats +Direct to database statistics plugin (0.9.6 and later). + +\(bu +.B Decisions +The Decisions plugin has support for a centralized set of per-entry installation decisions. This approach is needed when particular changes are deemed "high risk"; this gives the ability to centrally specify these changes, but only install them on clients when administrator supervision is available. (0.9.6 and later) + +\(bu +.B Deps +The Deps plugin allows you to make a series of assertions like "Package X requires Package Y (and optionally also Package Z etc.) + +\(bu +.B Editor +The Editor plugin allows you to partially manage configuration for a file. Its use is not recommended and not well documented. + +\(bu +.B Git +The Git plugin allows you to track changes to your Bcfg2 repository using a git version control backend. Currently, it enables you to get revision information out of your repository for reporting purposes. + +\(bu +.B GroupPatterns +The GroupPatterns plugin is a connector that can assign clients group membership pased on patterns in client hostnames. + +\(bu +.B Hostbase +The Hostbase plugin is an IP management system built on top of Bcfg2. + +\(bu +.B Metadata +The Metadata plugin is the primary method of specifying Bcfg2 server metadata. + +\(bu +.B NagiosGen +NagiosGen is a Bcfg2 plugin that dynamically generates Nagios configuration files based on Bcfg2 data. + +\(bu +.B Ohai + +\(bu +.B Packages +The Packages plugin is an alternative to Pkgmgr for specifying package entries for clients. Where Pkgmgr explicitly specifies package entry information, Packages delegates control of package version information to the underlying package manager, installing the latest version available from through those channels. + +\(bu +.B Pkgmgr +The Pkgmgr plugin resolves the Abstract Configuration Entity "Package" to a package specification that the client can use to detect, verify and install the specified package. + +\(bu +.B Probes +The Probes plugin gives you the ability to gather information from a client machine before you generate its configuration. This information can be used with the various templating systems to generate configuration based on the results. + +\(bu +.B Properties +The Properties plugin is a connector plugin that adds information from properties files into client metadata instances. (1.0 and later) + +\(bu +.B Rules +The Rules plugin resolves Abstract Configuration Entities to literal configuration entries suitable for the client drivers to consume. + +\(bu +.B SGenshi (Deprecated) +See Bundler. + +\(bu +.B Snapshots +The Snapshots plugin stores various aspects of a client's state when the client checks in to the server. + +\(bu +.B SSHbase +The SSHbase generator plugin manages ssh host keys (both v1 and v2) for hosts. It also manages the ssh_known_hosts file. It can integrate host keys from other management domains and similarly export its keys. + +\(bu +.B Svn +The Svn plugin allows you to track changes to your Bcfg2 repository using a Subversion backend. Currently, it enables you to get revision information out of your repository for reporting purposes. + +\(bu +.B TCheetah +The TCheetah plugin allows you to use the cheetah templating system to create files. It also allows you to include the results of probes executed on the client in the created files. + +\(bu +.B TGenshi +The TGenshi plugin allows you to use the Genshi templating system to create files. It also allows you to include the results of probes executed on the client in the created files. + +\(bu +.B Trigger +Trigger is a plugin that calls external scripts when clients are configured. .SH MDATA OPTIONS @@ -69,29 +176,23 @@ Global paranoid settings for ConfigFiles (defaults to false) .SH CLIENT OPTIONS -These options only affect client functionality, specified in the -[client] section. +These options only affect client functionality, specified in the [client] section. .TP .B drivers -Specify tool driver set to use. This option can be used to explicitly -specify the client tool drivers you want to use when the client is run. +Specify tool driver set to use. This option can be used to explicitly specify the client tool drivers you want to use when the client is run. .SH STATISTICS OPTIONS -Server-only, specified in the [statistics] section. These options -control the statistics collection functionality of the server. +Server-only, specified in the [statistics] section. These options control the statistics collection functionality of the server. .TP .B database_engine -The database engine used by the statistics module. One of -either 'postgresql', 'mysql', 'sqlite3', or 'ado_mssql'. +The database engine used by the statistics module. One of either 'postgresql', 'mysql', 'sqlite3', or 'ado_mssql'. .TP .B database_name -The name of the database to use for statistics data. If 'database_engine' -is set to 'sqlite3' this is a file path to sqlite file and defaults to -$REPOSITORY_DIR/etc/brpt.sqlite +The name of the database to use for statistics data. If 'database_engine' is set to 'sqlite3' this is a file path to sqlite file and defaults to $REPOSITORY_DIR/etc/brpt.sqlite .TP .B database_user @@ -111,19 +212,15 @@ Port for database connections. Not used for sqlite3. .SH COMMUNICATION OPTIONS -Specified in the [communication] section. These options define settings -used for client-server communication. +Specified in the [communication] section. These options define settings used for client-server communication. .TP .B password -Required on both the server and clients. On the server, sets the -password clients need to use to communicate. On a client, sets the -password to use to connect to the server. +Required on both the server and clients. On the server, sets the password clients need to use to communicate. On a client, sets the password to use to connect to the server. .TP .B key -A server-only option. The file system path to the server's SSL key. -Required if using xmlrpc/ssl for communication. +A server-only option. The file system path to the server's SSL key. Required if using xmlrpc/ssl for communication. .TP .B protocol @@ -157,35 +254,28 @@ Specified in the [components] section. .TP .B bcfg2 -URL of the server. On the server this specifies which interface and -port the server listens on. On the client, this specifies where the -client will attempt to contact the server. eg: -bcfg2 = https://10.3.1.6:6789 +URL of the server. On the server this specifies which interface and port the server listens on. On the client, this specifies where the client will attempt to contact the server. eg: bcfg2 = https://10.3.1.6:6789 .TP .B encoding -Text encoding of configuration files. Defaults to the system default -encoding. +Text encoding of configuration files. Defaults to the system default encoding. .SH LOGGING OPTIONS -Specified in the [logging] section. These options control the server -logging functionality. +Specified in the [logging] section. These options control the server logging functionality. .B path Server log file path. .SH SNAPSHOTS OPTIONS -Specified in the [snapshots] section. These options control the server -snapshots functionality. +Specified in the [snapshots] section. These options control the server snapshots functionality. .B driver sqlite .B database -The name of the database to use for statistics data. eg: -$REPOSITORY_DIR/etc/bcfg2.sqlite +The name of the database to use for statistics data. eg: $REPOSITORY_DIR/etc/bcfg2.sqlite .SH SEE ALSO .BR bcfg2(1), |