bcfg2-info(8) System Manager's Manual bcfg2-info(8)NAME
bcfg2-info - Creates a local version of the bcfg2 server core for state observation
SYNOPSIS
bcfg2-info [-C <config file>] [-E <encoding>] [-Q <repository path>] [-h] [-p] [-x <password>] <mode> <mode args> <mode options>
DESCRIPTION
bcfg2-info Instantiate an instance of the Bcfg2 core for data examination and debugging purposes.
OPTIONS -C <config file>
Specify the location of the configuration file (if it is not in /etc/bcfg2.conf).
-E <encoding>
Specify the encoding of config files.
-Q <repository path>
Specify the server repository path.
-d
Run in debug mode.
-h
Give a bit of help about the command line arguments and options. After this bcfg2-info exits.
-p
Specify a profile.
-x <password>
Set the communication password.
MODES
build <hostname> <filename>
Build config for hostname, writing to filename.
builddir <hostname> <dirname>
Build config for hostname, writing separate files to dirname.
buildall <directory>
Build configs for all clients in directory.
buildbundle <filename> <hostname>
Build bundle for hostname (not written to disk). If filename is a bundle template, it is rendered.
buildfile [--altsrc=<altsrc>] <filename> <hostname>
Build config file for hostname (not written to disk).
bundles
Print out group/bundle information.
clients
Print out client/profile information.
config
Print out the configuration of the Bcfg2 server.
debug
Shell out to native python interpreter.
event_debug
Display filesystem events as they are processed.
groups
List groups
help
Print the list of available commands.
mappings <type*> <name*>
Print generator mappings for optional type and name.
profile <command> <args>
Profile a single bcfg2-info command.
quit
Exit bcfg2-info command line.
showentries <hostname> <type>
Show abstract configuration entries for a given host.
showclient <client1> <client2>
Show metadata for given hosts.
update
Process pending file events.
version
Print version of this tool.
SEE ALSO bcfg2(1), bcfg2-server(8)BUGS
None currently known
bcfg2-info(8)
Check Out this Related Man Page
bcfg2(1) General Commands Manual bcfg2(1)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 configura-
tion, 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)