Provided by: bcfg2_1.2.2-1ubuntu2_all bug

NAME

       bcfg2 - reconfigure machine based on settings in Bcfg2

SYNOPSIS

       bcfg2  [-d] [-v] [-p] [-c cache file] [-e] [-f config file] [-I] [-q] [-z] [-b bundle] [-r
       removal mode] [--ca-cert=file] [--ssl-cns=list] [--ssl-cert=file] [--ssl-key=file]

DESCRIPTION

       bcfg2  Runs the Bcfg2 configuration process on the current host. This process consists  of
              first  fetching  and executing probes, uploading probe results, fetching the client
              configuration, checking the current client state, attempting to install the desired
              configuration,  and  finally  uploading  statistics  about  the Bcfg2 execution and
              client state.

OPTIONS

       -C <configfile>
              Specify alternate bcfg2.conf location.

       -D <driver1>,<driver2>
              Specify a set of Bcfg2 tool drivers. NOTE: only drivers listed will be loaded. (IE,
              if you don't include POSIX, you will be unable to verify/install ConfigFiles, etc).

       -E <encoding>
              Specify the encoding of Cfg files.

       -I     Run bcfg2 in interactive mode. The user will be prompted before each change.

       -O     Omit lock check.

       -P     Run  bcfg2 in paranoid mode. Diffs will be logged for configuration files marked as
              paranoid by the Bcfg2 server.

       -R <retry count>
              Specify the number  of  times  that  the  client  will  attempt  to  retry  network
              communication.

       -S https://server:port
              Manually specify the server location (as opposed to using the value in bcfg2.conf).

       -b <bundle1>:<bundle2>
              Run bcfg2 against one or multiple bundles in the configuration.

       -c <cachefile>
              Cache a copy of the configuration in cachefile.

       --ca-cert=<ca cert>
              Specifiy the path to the SSL CA certificate.

       -d     Run bcfg2 in debug mode.

       -e     When  in  verbose  mode, display extra entry information (temporary until verbosity
              rework).

       -f <specification path>
              Configure from a file rather than querying the server.

       -h     Print Usage information.

       -k     Run in bulletproof mode.  This  currently  only  affects  behavior  in  the  debian
              toolset; it calls apt-get update and clean and dpkg --configure --pending.

       -l <whitelist|blacklist|none>
              Run  the client in the server decision list mode (unless "none" is specified, which
              can be done in order to override the decision list mode specified  in  bcfg2.conf).
              This  approach  is  needed when particular changes are deemed "high risk". It gives
              the ability to centrally specify these changes, but only install  them  on  clients
              when administrator supervision is available. Because collaborative configuration is
              one of  the  remaining  hard  issues  in  configuration  management,  these  issues
              typically   crop   up   in   environments  with  several  administrators  and  much
              configuration variety. (This setting will be ignored  if  the  -f  option  is  also
              specified.)

       -n     Run bcfg2 in dry-run mode. No changes will be made to the system.

       -o <LogFile Path>
              Writes a log to the specified path.

       -p <profile>
              Assert a profile for the current client.

       -q     Run  bcfg2  in  quick  mode. Package checksum verification won't be performed. This
              mode relaxes the constraints of correctness, and thus should only be used  in  safe
              conditions.

       -Q     Run  bcfg2  in  "bundle quick" mode, where only entries in a bundle are verified or
              installed. This runs much faster than -q, but doesn't  provide  statistics  to  the
              server  at  all.  In  order  for  this  option  to work, the -b option must also be
              provided. This option is incompatible with -r.

       -r <mode>
              Cause bcfg2 to remove extra configuration elements it detects. Mode is one of  all,
              Services,  or  Packages.  All  removes all entries. Likewise, Services and Packages
              remove only the extra configuration elements of the respective type.

       -s <service mode>
              Set bcfg2 interaction level  for  services.  Default  behavior  is  to  modify  all
              services  affected  by  reconfiguration.  build  mode attempts to stop all services
              started. disabled suppresses all attempts to modify services.

       --ssl-cert=<ssl cert>
              Specifiy the path to the SSL certificate.

       --ssl-cns=<CommonName1:CommonName2 ...>
              List of acceptable SSL server Common Names.

       --ssl-key=<ssl key>
              Specifiy the path to the SSL key.

       -u <user>
              Attempt to authenticate as 'user'.

       -x <password>
              Use 'password' for client communication.

       -t <timeout>
              Set the timeout (in seconds) for client communication.  Default is 90 seconds.

       -v     Run bcfg2 in verbose mode.

       -z     Only configure independent entries, ignore bundles.

SEE ALSO

       bcfg2-server(8), bcfg2-info(8)

BUGS

                                                                                         bcfg2(1)