cdist(1)

Nico Schottelius

<nico-cdist--@--schottelius.org>

Table of Contents

1. NAME
2. SYNOPSIS
3. DESCRIPTION
4. BANNER
5. CONFIG
6. EXAMPLES
7. ENVIRONMENT
8. EXIT STATUS
9. SEE ALSO
10. COPYING

1. NAME

cdist - Configuration management

2. SYNOPSIS

cdist [-h] [-V]

cdist banner

cdist config [-h] [-d] [-V] [-c CDIST_HOME] [-i MANIFEST] [-p] [-s] host [host …]

3. DESCRIPTION

cdist is the frontend executable to the cdist configuration management. cdist supports different as explained below. The options to the main program are:

-h, --help: Show the help screen
-V, --version: Show version and exit

4. BANNER

Displays the cdist banner.

5. CONFIG

Configure a system

-h, --help: Show the help screen
-c CDIST_HOME, --cdist-home CDIST_HOME: Instead of using the parent of the bin directory as cdist home, use the specified directory
-d, --debug: Enable debug output
-i MANIFEST, --initial-manifest MANIFEST: Path to a cdist manifest or - to read from stdin
-p, --parallel: Operate on multiple hosts in parallel
-s, --sequential: 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)

6. EXAMPLES

# Configure ikq05.ethz.ch with debug enabled
cdist config -d ikq05.ethz.ch

# Configure hosts in parallel and use a different home directory
cdist config -c ~/p/cdist-nutzung \
    -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

# Display banner
cdist banner

# Show help
cdist --help

# Show Version
cdist --version

7. ENVIRONMENT

TMPDIR, TEMP, TMP: 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.

8. EXIT STATUS

The following exit values shall be returned:

0: Successful completion
1: One or more host configurations failed

9. SEE ALSO

cdist(7)
cdist-reference(7)