2011-09-12 08:58:10 +00:00
|
|
|
cdist(1)
|
|
|
|
|
========
|
|
|
|
|
Nico Schottelius <nico-cdist--@--schottelius.org>
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
NAME
|
|
|
|
|
----
|
|
|
|
|
cdist - Configuration management
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
SYNOPSIS
|
|
|
|
|
--------
|
2011-09-13 20:48:14 +00:00
|
|
|
cdist [-h] [-V]
|
|
|
|
|
|
2011-09-13 19:35:57 +00:00
|
|
|
cdist banner
|
2011-09-13 20:48:14 +00:00
|
|
|
|
2012-11-30 12:48:34 +00:00
|
|
|
cdist config [-h] [-d] [-V] [-c CONF_DIR] [-i MANIFEST] [-p] [-s] host [host ...]
|
2011-09-13 19:35:57 +00:00
|
|
|
|
2011-09-12 08:58:10 +00:00
|
|
|
|
|
|
|
|
|
|
|
|
|
DESCRIPTION
|
|
|
|
|
-----------
|
|
|
|
|
cdist is the frontend executable to the cdist configuration management.
|
2011-09-13 19:35:57 +00:00
|
|
|
cdist supports different as explained below. The options to the main
|
|
|
|
|
program are:
|
|
|
|
|
|
2011-09-13 20:48:14 +00:00
|
|
|
-h, --help::
|
|
|
|
|
Show the help screen
|
|
|
|
|
|
2011-09-13 19:35:57 +00:00
|
|
|
-V, --version::
|
|
|
|
|
Show version and exit
|
2011-09-12 08:58:10 +00:00
|
|
|
|
|
|
|
|
|
2011-09-13 19:35:57 +00:00
|
|
|
BANNER
|
2011-09-12 08:58:10 +00:00
|
|
|
-------
|
2011-09-13 19:35:57 +00:00
|
|
|
Displays the cdist banner.
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
CONFIG
|
|
|
|
|
------
|
|
|
|
|
Configure a system
|
|
|
|
|
|
2011-09-12 08:58:10 +00:00
|
|
|
-h, --help::
|
2012-05-22 13:06:04 +00:00
|
|
|
Show the help screen
|
2011-09-12 08:58:10 +00:00
|
|
|
|
2012-11-30 12:48:34 +00:00
|
|
|
-c CONF_DIR, --conf-dir CONF_DIR::
|
|
|
|
|
Add a configuration directory. Can be specified multiple times.
|
|
|
|
|
If configuration directories contain conflicting types, explorers or
|
|
|
|
|
manifests, then the last one found is used. Additionally this can also
|
|
|
|
|
be configured by setting the CDIST_PATH environment variable to a colon
|
|
|
|
|
delimited list of config directories. Directories given with the
|
|
|
|
|
--conf-dir argument have higher precedence over those set through the
|
|
|
|
|
environment variable.
|
2011-09-12 09:18:18 +00:00
|
|
|
|
2011-09-12 08:58:10 +00:00
|
|
|
-d, --debug::
|
2012-05-22 13:06:04 +00:00
|
|
|
Enable debug output
|
2011-09-12 08:58:10 +00:00
|
|
|
|
2011-09-12 09:18:18 +00:00
|
|
|
-i MANIFEST, --initial-manifest MANIFEST::
|
2012-05-22 13:06:04 +00:00
|
|
|
Path to a cdist manifest or - to read from stdin
|
2011-09-12 09:18:18 +00:00
|
|
|
|
2011-09-12 08:58:10 +00:00
|
|
|
-p, --parallel::
|
2012-05-22 13:06:04 +00:00
|
|
|
Operate on multiple hosts in parallel
|
2011-09-12 09:18:18 +00:00
|
|
|
|
|
|
|
|
-s, --sequential::
|
2012-05-22 13:06:04 +00:00
|
|
|
Operate on multiple hosts sequentially
|
|
|
|
|
|
|
|
|
|
--remote-copy REMOTE_COPY:
|
|
|
|
|
Command to use for remote copy (should behave like scp)
|
|
|
|
|
|
|
|
|
|
--remote-exec REMOTE_EXEC:
|
|
|
|
|
Command to use for remote execution (should behave like ssh)
|
2011-09-12 08:58:10 +00:00
|
|
|
|
|
|
|
|
|
|
|
|
|
EXAMPLES
|
|
|
|
|
--------
|
|
|
|
|
|
|
|
|
|
--------------------------------------------------------------------------------
|
|
|
|
|
# Configure ikq05.ethz.ch with debug enabled
|
2011-09-13 19:35:57 +00:00
|
|
|
cdist config -d ikq05.ethz.ch
|
2011-09-12 08:58:10 +00:00
|
|
|
|
2011-09-12 09:18:18 +00:00
|
|
|
# Configure hosts in parallel and use a different home directory
|
2011-09-13 19:35:57 +00:00
|
|
|
cdist config -c ~/p/cdist-nutzung \
|
2012-05-22 13:06:04 +00:00
|
|
|
-p ikq02.ethz.ch ikq03.ethz.ch ikq04.ethz.ch
|
|
|
|
|
|
|
|
|
|
# Use custom remote exec / copy commands
|
|
|
|
|
cdist config --remote-exec /path/to/my/remote/exec \
|
|
|
|
|
--remote-copy /path/to/my/remote/copy \
|
|
|
|
|
-p ikq02.ethz.ch ikq03.ethz.ch ikq04.ethz.ch
|
2011-09-13 19:35:57 +00:00
|
|
|
|
|
|
|
|
# Display banner
|
|
|
|
|
cdist banner
|
2011-09-12 08:58:10 +00:00
|
|
|
|
2011-09-13 19:35:57 +00:00
|
|
|
# Show help
|
2011-09-12 09:18:18 +00:00
|
|
|
cdist --help
|
2011-09-13 19:35:57 +00:00
|
|
|
|
|
|
|
|
# Show Version
|
2011-09-12 09:18:18 +00:00
|
|
|
cdist --version
|
|
|
|
|
--------------------------------------------------------------------------------
|
2011-09-12 08:58:10 +00:00
|
|
|
|
|
|
|
|
|
2011-09-18 19:04:23 +00:00
|
|
|
ENVIRONMENT
|
|
|
|
|
-----------
|
2011-09-19 06:31:14 +00:00
|
|
|
TMPDIR, TEMP, TMP::
|
2011-09-18 19:04:23 +00:00
|
|
|
Setup the base directory for the temporary directory.
|
|
|
|
|
See http://docs.python.org/py3k/library/tempfile.html for
|
|
|
|
|
more information. This is rather useful, if the standard
|
|
|
|
|
directory used does not allow executables.
|
|
|
|
|
|
2012-03-12 19:20:18 +00:00
|
|
|
|
|
|
|
|
EXIT STATUS
|
|
|
|
|
-----------
|
|
|
|
|
The following exit values shall be returned:
|
|
|
|
|
|
|
|
|
|
0::
|
|
|
|
|
Successful completion
|
|
|
|
|
1::
|
2012-05-22 13:06:04 +00:00
|
|
|
One or more host configurations failed
|
2012-03-12 19:20:18 +00:00
|
|
|
|
|
|
|
|
|
2011-09-12 08:58:10 +00:00
|
|
|
SEE ALSO
|
|
|
|
|
--------
|
|
|
|
|
- cdist(7)
|
2011-09-13 20:49:42 +00:00
|
|
|
- cdist-reference(7)
|
2011-09-12 08:58:10 +00:00
|
|
|
|
|
|
|
|
|
|
|
|
|
COPYING
|
|
|
|
|
-------
|
2012-01-17 22:53:58 +00:00
|
|
|
Copyright \(C) 2011-2012 Nico Schottelius. Free use of this software is
|
2011-09-12 08:58:10 +00:00
|
|
|
granted under the terms of the GNU General Public License version 3 (GPLv3).
|
