From fbb237354ba9db7643d7885b5ae961ecb4d37ea0 Mon Sep 17 00:00:00 2001 From: Nico Schottelius Date: Thu, 15 Nov 2012 14:26:48 +0100 Subject: [PATCH] cdist update --- software/cdist.mdwn | 29 +- software/cdist/documentation.mdwn | 7 + software/cdist/install.mdwn | 176 ++++++++++ .../man/2.1.0pre7-48-gc51edff/man1/cdist.html | 79 +++++ .../man1/docbook-xsl.css | 314 ++++++++++++++++++ .../man7/cdist-best-practice.html | 126 +++++++ .../man7/cdist-bootstrap.html | 77 +++++ .../man7/cdist-explorer.html | 28 ++ .../man7/cdist-hacker.html | 43 +++ .../man7/cdist-manifest.html | 72 ++++ .../man7/cdist-quickstart.html | 51 +++ .../man7/cdist-reference.html | 249 ++++++++++++++ .../man7/cdist-remote-exec-copy.html | 15 + .../man7/cdist-stages.html | 29 ++ .../man7/cdist-tutorial.html | 54 +++ .../man7/cdist-type.html | 129 +++++++ .../man7/cdist-type__apt_ppa.html | 14 + .../man7/cdist-type__apt_update_index.html | 6 + .../man7/cdist-type__autofs_map.html | 29 ++ .../man7/cdist-type__autofs_master.html | 16 + .../man7/cdist-type__cdistmarker.html | 23 ++ .../man7/cdist-type__cron.html | 57 ++++ .../cdist-type__debconf_set_selections.html | 15 + .../man7/cdist-type__directory.html | 51 +++ .../man7/cdist-type__file.html | 56 ++++ .../man7/cdist-type__group.html | 21 ++ .../man7/cdist-type__issue.html | 13 + .../man7/cdist-type__jail.html | 81 +++++ .../man7/cdist-type__key_value.html | 40 +++ .../man7/cdist-type__line.html | 38 +++ .../man7/cdist-type__link.html | 31 ++ .../man7/cdist-type__mkfs.html | 30 ++ .../man7/cdist-type__motd.html | 15 + .../man7/cdist-type__mysql_database.html | 19 ++ .../man7/cdist-type__package.html | 35 ++ .../man7/cdist-type__package_apt.html | 24 ++ .../man7/cdist-type__package_luarocks.html | 20 ++ .../man7/cdist-type__package_opkg.html | 20 ++ .../man7/cdist-type__package_pacman.html | 24 ++ .../man7/cdist-type__package_pip.html | 25 ++ .../man7/cdist-type__package_pkg_freebsd.html | 38 +++ .../man7/cdist-type__package_pkg_openbsd.html | 30 ++ .../man7/cdist-type__package_rubygem.html | 20 ++ .../man7/cdist-type__package_yum.html | 26 ++ .../man7/cdist-type__package_zypper.html | 23 ++ .../man7/cdist-type__partition_msdos.html | 36 ++ .../cdist-type__partition_msdos_apply.html | 8 + .../man7/cdist-type__pf_apply.html | 18 + .../man7/cdist-type__pf_ruleset.html | 22 ++ .../man7/cdist-type__postgres_database.html | 16 + .../man7/cdist-type__postgres_role.html | 34 ++ .../man7/cdist-type__process.html | 44 +++ .../man7/cdist-type__qemu_img.html | 21 ++ .../man7/cdist-type__rvm.html | 20 ++ .../man7/cdist-type__rvm_gem.html | 36 ++ .../man7/cdist-type__rvm_gemset.html | 31 ++ .../man7/cdist-type__rvm_ruby.html | 28 ++ .../man7/cdist-type__ssh_authorized_key.html | 17 + .../man7/cdist-type__start_on_boot.html | 19 ++ .../man7/cdist-type__timezone.html | 11 + .../man7/cdist-type__user.html | 41 +++ .../man7/docbook-xsl.css | 314 ++++++++++++++++++ software/cdist/os.mdwn | 17 + software/cdist/update.mdwn | 88 +++++ 64 files changed, 3118 insertions(+), 21 deletions(-) create mode 100644 software/cdist/documentation.mdwn create mode 100644 software/cdist/install.mdwn create mode 100644 software/cdist/man/2.1.0pre7-48-gc51edff/man1/cdist.html create mode 100644 software/cdist/man/2.1.0pre7-48-gc51edff/man1/docbook-xsl.css create mode 100644 software/cdist/man/2.1.0pre7-48-gc51edff/man7/cdist-best-practice.html create mode 100644 software/cdist/man/2.1.0pre7-48-gc51edff/man7/cdist-bootstrap.html create mode 100644 software/cdist/man/2.1.0pre7-48-gc51edff/man7/cdist-explorer.html create mode 100644 software/cdist/man/2.1.0pre7-48-gc51edff/man7/cdist-hacker.html create mode 100644 software/cdist/man/2.1.0pre7-48-gc51edff/man7/cdist-manifest.html create mode 100644 software/cdist/man/2.1.0pre7-48-gc51edff/man7/cdist-quickstart.html create mode 100644 software/cdist/man/2.1.0pre7-48-gc51edff/man7/cdist-reference.html create mode 100644 software/cdist/man/2.1.0pre7-48-gc51edff/man7/cdist-remote-exec-copy.html create mode 100644 software/cdist/man/2.1.0pre7-48-gc51edff/man7/cdist-stages.html create mode 100644 software/cdist/man/2.1.0pre7-48-gc51edff/man7/cdist-tutorial.html create mode 100644 software/cdist/man/2.1.0pre7-48-gc51edff/man7/cdist-type.html create mode 100644 software/cdist/man/2.1.0pre7-48-gc51edff/man7/cdist-type__apt_ppa.html create mode 100644 software/cdist/man/2.1.0pre7-48-gc51edff/man7/cdist-type__apt_update_index.html create mode 100644 software/cdist/man/2.1.0pre7-48-gc51edff/man7/cdist-type__autofs_map.html create mode 100644 software/cdist/man/2.1.0pre7-48-gc51edff/man7/cdist-type__autofs_master.html create mode 100644 software/cdist/man/2.1.0pre7-48-gc51edff/man7/cdist-type__cdistmarker.html create mode 100644 software/cdist/man/2.1.0pre7-48-gc51edff/man7/cdist-type__cron.html create mode 100644 software/cdist/man/2.1.0pre7-48-gc51edff/man7/cdist-type__debconf_set_selections.html create mode 100644 software/cdist/man/2.1.0pre7-48-gc51edff/man7/cdist-type__directory.html create mode 100644 software/cdist/man/2.1.0pre7-48-gc51edff/man7/cdist-type__file.html create mode 100644 software/cdist/man/2.1.0pre7-48-gc51edff/man7/cdist-type__group.html create mode 100644 software/cdist/man/2.1.0pre7-48-gc51edff/man7/cdist-type__issue.html create mode 100644 software/cdist/man/2.1.0pre7-48-gc51edff/man7/cdist-type__jail.html create mode 100644 software/cdist/man/2.1.0pre7-48-gc51edff/man7/cdist-type__key_value.html create mode 100644 software/cdist/man/2.1.0pre7-48-gc51edff/man7/cdist-type__line.html create mode 100644 software/cdist/man/2.1.0pre7-48-gc51edff/man7/cdist-type__link.html create mode 100644 software/cdist/man/2.1.0pre7-48-gc51edff/man7/cdist-type__mkfs.html create mode 100644 software/cdist/man/2.1.0pre7-48-gc51edff/man7/cdist-type__motd.html create mode 100644 software/cdist/man/2.1.0pre7-48-gc51edff/man7/cdist-type__mysql_database.html create mode 100644 software/cdist/man/2.1.0pre7-48-gc51edff/man7/cdist-type__package.html create mode 100644 software/cdist/man/2.1.0pre7-48-gc51edff/man7/cdist-type__package_apt.html create mode 100644 software/cdist/man/2.1.0pre7-48-gc51edff/man7/cdist-type__package_luarocks.html create mode 100644 software/cdist/man/2.1.0pre7-48-gc51edff/man7/cdist-type__package_opkg.html create mode 100644 software/cdist/man/2.1.0pre7-48-gc51edff/man7/cdist-type__package_pacman.html create mode 100644 software/cdist/man/2.1.0pre7-48-gc51edff/man7/cdist-type__package_pip.html create mode 100644 software/cdist/man/2.1.0pre7-48-gc51edff/man7/cdist-type__package_pkg_freebsd.html create mode 100644 software/cdist/man/2.1.0pre7-48-gc51edff/man7/cdist-type__package_pkg_openbsd.html create mode 100644 software/cdist/man/2.1.0pre7-48-gc51edff/man7/cdist-type__package_rubygem.html create mode 100644 software/cdist/man/2.1.0pre7-48-gc51edff/man7/cdist-type__package_yum.html create mode 100644 software/cdist/man/2.1.0pre7-48-gc51edff/man7/cdist-type__package_zypper.html create mode 100644 software/cdist/man/2.1.0pre7-48-gc51edff/man7/cdist-type__partition_msdos.html create mode 100644 software/cdist/man/2.1.0pre7-48-gc51edff/man7/cdist-type__partition_msdos_apply.html create mode 100644 software/cdist/man/2.1.0pre7-48-gc51edff/man7/cdist-type__pf_apply.html create mode 100644 software/cdist/man/2.1.0pre7-48-gc51edff/man7/cdist-type__pf_ruleset.html create mode 100644 software/cdist/man/2.1.0pre7-48-gc51edff/man7/cdist-type__postgres_database.html create mode 100644 software/cdist/man/2.1.0pre7-48-gc51edff/man7/cdist-type__postgres_role.html create mode 100644 software/cdist/man/2.1.0pre7-48-gc51edff/man7/cdist-type__process.html create mode 100644 software/cdist/man/2.1.0pre7-48-gc51edff/man7/cdist-type__qemu_img.html create mode 100644 software/cdist/man/2.1.0pre7-48-gc51edff/man7/cdist-type__rvm.html create mode 100644 software/cdist/man/2.1.0pre7-48-gc51edff/man7/cdist-type__rvm_gem.html create mode 100644 software/cdist/man/2.1.0pre7-48-gc51edff/man7/cdist-type__rvm_gemset.html create mode 100644 software/cdist/man/2.1.0pre7-48-gc51edff/man7/cdist-type__rvm_ruby.html create mode 100644 software/cdist/man/2.1.0pre7-48-gc51edff/man7/cdist-type__ssh_authorized_key.html create mode 100644 software/cdist/man/2.1.0pre7-48-gc51edff/man7/cdist-type__start_on_boot.html create mode 100644 software/cdist/man/2.1.0pre7-48-gc51edff/man7/cdist-type__timezone.html create mode 100644 software/cdist/man/2.1.0pre7-48-gc51edff/man7/cdist-type__user.html create mode 100644 software/cdist/man/2.1.0pre7-48-gc51edff/man7/docbook-xsl.css create mode 100644 software/cdist/os.mdwn create mode 100644 software/cdist/update.mdwn diff --git a/software/cdist.mdwn b/software/cdist.mdwn index ab501f56..cd2a7567 100644 --- a/software/cdist.mdwn +++ b/software/cdist.mdwn @@ -2,32 +2,19 @@ ![cdist-logo](cdist-logo.png "cdist logo") -the KISS principle and is being used in small up to enterprise grade -environments. +cdist is a usable configuration management system. +It adheres to the KISS principle and +is being used in small up to enterprise grade environments. cdist is an alternative to other configuration management systems like -[cfengine](http://www.cfengine.org/), [bcfg2](http://trac.mcs.anl.gov/projects/bcfg2), [chef](http://wiki.opscode.com/display/chef/) +[cfengine](http://www.cfengine.org/), and [puppet](http://www.puppetlabs.com/). - * Browse the **documentation** for the [latest version](man/latest) or [all versions (>= 2.0.4)](man) - * Read how to [[install or update cdist|install-update]] + * [[Documentation|documentation]] + * [[Supported Operating Systems|os]] + * [[Installation|install]] + * [[Update|update]] * [[Support|support]] -### OS support - -cdist was tested or is know to run on at least - - * [Archlinux](http://www.archlinux.org/) - * [Debian](http://www.debian.org/) - * [CentOS](http://www.centos.org/) - * [Fedora](http://fedoraproject.org/) - * [FreeBSD](http://www.freebsd.org) - * [Gentoo](http://www.gentoo.org/) - * [Mac OS X](http://www.apple.com/macosx/) - * [OpenBSD](http://www.openbsd.org) - * [Redhat](http://www.redhat.com/) - * [Ubuntu](http://www.ubuntu.com/) - * [XenServer](http://www.citrix.com/xenserver/) - [[!tag cdist unix]] diff --git a/software/cdist/documentation.mdwn b/software/cdist/documentation.mdwn new file mode 100644 index 00000000..ba829101 --- /dev/null +++ b/software/cdist/documentation.mdwn @@ -0,0 +1,7 @@ +[[!meta title="Documentation"]] + +You can browse the latest +[latest version of the manpages](man/latest) or +have a look at [all versions](man). + +[[!tag cdist unix]] diff --git a/software/cdist/install.mdwn b/software/cdist/install.mdwn new file mode 100644 index 00000000..79d8705d --- /dev/null +++ b/software/cdist/install.mdwn @@ -0,0 +1,176 @@ +[[!meta title="How to install cdist"]] +[[!toc levels=3]] + +## Requirements + +### Source Host + +This is the machine you use to configure the target hosts. + + * /bin/sh: A posix like shell (for instance bash, dash, zsh) + * Python >= 3.2 + * SSH client + * Asciidoc (for building the manpages) + +### Target Hosts + + * /bin/sh: A posix like shell (for instance bash, dash, zsh) + * SSH server + +## Requirement Installation: Python >= 3.2 + +Ensure you have at least Python 3.2 or newer installed on +the **source host**. +You can check this by running **python -V**: + + % python -V + Python 3.3.0 + +### Archlinux + +Archlinux includes a recent python in the extra repository. +You can install it using + + pacman -S python + +### CentOS + +See the "From source" section + +### Debian + +For Debian **wheezy** or newer: + + aptitude install python3 + +On **squeeze** you can add following line in **/etc/apt/sources.list** + + deb http://ftp.debian.org/debian wheezy main + +And add pinning entry in **/etc/apt/preferences.d/wheezy**: + + Package: * + Pin: release n=wheezy + Pin-Priority: 1 + +Please be aware that both **openssh-server** and **openssh-client** might be +removed on **python3.2** installation. You surely want to reinstall them: + + apt-get install -t wheezy openssh-server openssh-client + +For older Debian versions, installing python 3.2 from source is required. + +### Fedora + +Fedora 15 and newer includes a recent python. +You can install it using + + yum install python3 + +### FreeBSD + +For the port: + + cd /usr/ports/lang/python32/ && make install clean + +For the package: + + pkg_add -r python32 + +You can also use any newer version, but at least python 3.2 is required. + +### Gentoo + +Gentoo only provides python 3.2 in testing packages (http://www.gentoo.org/doc/en/handbook/handbook-x86.xml?part=3&chap=3). +If you want to ensure nothing breaks you must set back the python version to what was default before. + + emerge -av =python-3.2.2 --autounmask-write + emerge -av =python-3.2.2 + eselect python list + eselect python list set python3.2 + +### Max OS X + +You can choose between Homebrew and Macports, either way works: + +[Homebrew](http://mxcl.github.com/homebrew/) variant: + + brew install python3 + +[Macports](http://www.macports.org/install.php) variant: + + port install python32 + ln -s /opt/local/bin/python3.2 /opt/local/bin/python3 + +### Redhat + +See the "From source" section + +### From Source + +For those operating systems not yet supporting Python 3.2: + + pyversion=3.2.3 + wget http://www.python.org/ftp/python/$pyversion/Python-${pyversion}.tar.bz2 + tar xvfj Python-${pyversion}.tar.bz2 + cd Python-${pyversion} + ./configure + make + sudo make install + +This installs python 3.2 to /usr/local/bin. +Ensure this directory is in your PATH environment variable. + +## Install cdist + +You can install cdist either from git or as a python package. + +### From git + +Cloning cdist from git gives you the advantage of having +a version control in place for development of your own stuff +immediately. + +To install cdist, execute the following commands: + + git clone git://git.schottelius.org/cdist + cd cdist + export PATH=$PATH:$(pwd -P)/bin + +If you want to build and use the manpages, run: + + ./build man + export MANPATH=$MANPATH:$(pwd -P)/doc/man + +#### Available versions in git + + * The active development takes place in the **master** branch + * The current stable version can be found in the **2.0** branch + * The upcoming stable version can be found in the **2.1** branch + +Other branches may be available for features or bugfixes, but they +may vanish at any point. To select a specific branch use + + # Generic code + git checkout -b origin/ + +So for instance if you want to use and stay with version 2.0, you can use + + git checkout -b 2.0 origin/2.0 + +#### Git Mirrors + +If the main site is down, you can acquire cdist from one of the following sites: + + * git://github.com/telmich/cdist.git ([github](https://github.com/telmich/cdist)) + * git://git.code.sf.net/p/cdist/code ([sourceforge](https://sourceforge.net/p/cdist/code)) + +### Python Package + +Cdist is available as a python package at +[PyPi](http://pypi.python.org/pypi/cdist/). You can install it using + + pip install cdist + + +[[!tag cdist unix]] diff --git a/software/cdist/man/2.1.0pre7-48-gc51edff/man1/cdist.html b/software/cdist/man/2.1.0pre7-48-gc51edff/man1/cdist.html new file mode 100644 index 00000000..0978f8f2 --- /dev/null +++ b/software/cdist/man/2.1.0pre7-48-gc51edff/man1/cdist.html @@ -0,0 +1,79 @@ + + +cdist(1)

cdist(1)

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) +

10. COPYING

Copyright (C) 2011-2012 Nico Schottelius. Free use of this software is +granted under the terms of the GNU General Public License version 3 (GPLv3).

diff --git a/software/cdist/man/2.1.0pre7-48-gc51edff/man1/docbook-xsl.css b/software/cdist/man/2.1.0pre7-48-gc51edff/man1/docbook-xsl.css new file mode 100644 index 00000000..28412259 --- /dev/null +++ b/software/cdist/man/2.1.0pre7-48-gc51edff/man1/docbook-xsl.css @@ -0,0 +1,314 @@ +/* + CSS stylesheet for XHTML produced by DocBook XSL stylesheets. + Tested with XSL stylesheets 1.61.2, 1.67.2 +*/ + +span.strong { + font-weight: bold; +} + +body blockquote { + margin-top: .75em; + line-height: 1.5; + margin-bottom: .75em; +} + +html body { + margin: 1em 5% 1em 5%; + line-height: 1.2; +} + +body div { + margin: 0; +} + +h1, h2, h3, h4, h5, h6 +{ + color: #527bbd; + font-family: tahoma, verdana, sans-serif; +} + +div.toc p:first-child, +div.list-of-figures p:first-child, +div.list-of-tables p:first-child, +div.list-of-examples p:first-child, +div.example p.title, +div.sidebar p.title +{ + font-weight: bold; + color: #527bbd; + font-family: tahoma, verdana, sans-serif; + margin-bottom: 0.2em; +} + +body h1 { + margin: .0em 0 0 -4%; + line-height: 1.3; + border-bottom: 2px solid silver; +} + +body h2 { + margin: 0.5em 0 0 -4%; + line-height: 1.3; + border-bottom: 2px solid silver; +} + +body h3 { + margin: .8em 0 0 -3%; + line-height: 1.3; +} + +body h4 { + margin: .8em 0 0 -3%; + line-height: 1.3; +} + +body h5 { + margin: .8em 0 0 -2%; + line-height: 1.3; +} + +body h6 { + margin: .8em 0 0 -1%; + line-height: 1.3; +} + +body hr { + border: none; /* Broken on IE6 */ +} +div.footnotes hr { + border: 1px solid silver; +} + +div.navheader th, div.navheader td, div.navfooter td { + font-family: sans-serif; + font-size: 0.9em; + font-weight: bold; + color: #527bbd; +} +div.navheader img, div.navfooter img { + border-style: none; +} +div.navheader a, div.navfooter a { + font-weight: normal; +} +div.navfooter hr { + border: 1px solid silver; +} + +body td { + line-height: 1.2 +} + +body th { + line-height: 1.2; +} + +ol { + line-height: 1.2; +} + +ul, body dir, body menu { + line-height: 1.2; +} + +html { + margin: 0; + padding: 0; +} + +body h1, body h2, body h3, body h4, body h5, body h6 { + margin-left: 0 +} + +body pre { + margin: 0.5em 10% 0.5em 1em; + line-height: 1.0; + color: navy; +} + +tt.literal, code.literal { + color: navy; +} + +.programlisting, .screen { + border: 1px solid silver; + background: #f4f4f4; + margin: 0.5em 10% 0.5em 0; + padding: 0.5em 1em; +} + +div.sidebar { + background: #ffffee; + margin: 1.0em 10% 0.5em 0; + padding: 0.5em 1em; + border: 1px solid silver; +} +div.sidebar * { padding: 0; } +div.sidebar div { margin: 0; } +div.sidebar p.title { + margin-top: 0.5em; + margin-bottom: 0.2em; +} + +div.bibliomixed { + margin: 0.5em 5% 0.5em 1em; +} + +div.glossary dt { + font-weight: bold; +} +div.glossary dd p { + margin-top: 0.2em; +} + +dl { + margin: .8em 0; + line-height: 1.2; +} + +dt { + margin-top: 0.5em; +} + +dt span.term { + font-style: normal; + color: navy; +} + +div.variablelist dd p { + margin-top: 0; +} + +div.itemizedlist li, div.orderedlist li { + margin-left: -0.8em; + margin-top: 0.5em; +} + +ul, ol { + list-style-position: outside; +} + +div.sidebar ul, div.sidebar ol { + margin-left: 2.8em; +} + +div.itemizedlist p.title, +div.orderedlist p.title, +div.variablelist p.title +{ + margin-bottom: -0.8em; +} + +div.revhistory table { + border-collapse: collapse; + border: none; +} +div.revhistory th { + border: none; + color: #527bbd; + font-family: tahoma, verdana, sans-serif; +} +div.revhistory td { + border: 1px solid silver; +} + +/* Keep TOC and index lines close together. */ +div.toc dl, div.toc dt, +div.list-of-figures dl, div.list-of-figures dt, +div.list-of-tables dl, div.list-of-tables dt, +div.indexdiv dl, div.indexdiv dt +{ + line-height: normal; + margin-top: 0; + margin-bottom: 0; +} + +/* + Table styling does not work because of overriding attributes in + generated HTML. +*/ +div.table table, +div.informaltable table +{ + margin-left: 0; + margin-right: 5%; + margin-bottom: 0.8em; +} +div.informaltable table +{ + margin-top: 0.4em +} +div.table thead, +div.table tfoot, +div.table tbody, +div.informaltable thead, +div.informaltable tfoot, +div.informaltable tbody +{ + /* No effect in IE6. */ + border-top: 3px solid #527bbd; + border-bottom: 3px solid #527bbd; +} +div.table thead, div.table tfoot, +div.informaltable thead, div.informaltable tfoot +{ + font-weight: bold; +} + +div.mediaobject img { + margin-bottom: 0.8em; +} +div.figure p.title, +div.table p.title +{ + margin-top: 1em; + margin-bottom: 0.4em; +} + +div.calloutlist p +{ + margin-top: 0em; + margin-bottom: 0.4em; +} + +@media print { + div.navheader, div.navfooter { display: none; } +} + +span.aqua { color: aqua; } +span.black { color: black; } +span.blue { color: blue; } +span.fuchsia { color: fuchsia; } +span.gray { color: gray; } +span.green { color: green; } +span.lime { color: lime; } +span.maroon { color: maroon; } +span.navy { color: navy; } +span.olive { color: olive; } +span.purple { color: purple; } +span.red { color: red; } +span.silver { color: silver; } +span.teal { color: teal; } +span.white { color: white; } +span.yellow { color: yellow; } + +span.aqua-background { background: aqua; } +span.black-background { background: black; } +span.blue-background { background: blue; } +span.fuchsia-background { background: fuchsia; } +span.gray-background { background: gray; } +span.green-background { background: green; } +span.lime-background { background: lime; } +span.maroon-background { background: maroon; } +span.navy-background { background: navy; } +span.olive-background { background: olive; } +span.purple-background { background: purple; } +span.red-background { background: red; } +span.silver-background { background: silver; } +span.teal-background { background: teal; } +span.white-background { background: white; } +span.yellow-background { background: yellow; } + +span.big { font-size: 2em; } +span.small { font-size: 0.6em; } diff --git a/software/cdist/man/2.1.0pre7-48-gc51edff/man7/cdist-best-practice.html b/software/cdist/man/2.1.0pre7-48-gc51edff/man7/cdist-best-practice.html new file mode 100644 index 00000000..a86670d7 --- /dev/null +++ b/software/cdist/man/2.1.0pre7-48-gc51edff/man7/cdist-best-practice.html @@ -0,0 +1,126 @@ + + +cdist-best-practice(7)

cdist-best-practice(7)

Table of Contents

1. NAME
2. PASSWORDLESS CONNECTIONS
3. SPEEDING UP SSH CONNECTIONS
4. MULTI MASTER OR ENVIRONMENT SETUPS
5. SEPERATING WORK BY GROUPS
6. MAINTAINING MULTIPLE CONFIGURATIONS
7. MULTIPLE DEVELOPERS WITH DIFFERENT TRUST
8. TEMPLATING
9. SEE ALSO
10. COPYING

1. NAME

cdist-best-practice - Practices used in real environments

2. PASSWORDLESS CONNECTIONS

It is recommended to run cdist with public key authentication. +This requires a private/public key pair and the entry +"PermitRootLogin without-password" in the sshd server. +See sshd_config(5) and ssh-keygen(1).

3. SPEEDING UP SSH CONNECTIONS

When connecting to a new host, the initial delay with ssh connections +is pretty big. You can work around this by +"sharing of multiple sessions over a single network connection" +(quote from ssh_config(5)). The following code is suitable for +inclusion into your ~/.ssh/config:

Host *
+  ControlPath ~/.ssh/master-%l-%r@%h:%p
+  ControlMaster auto
+  ControlPersist 10

4. MULTI MASTER OR ENVIRONMENT SETUPS

If you plan to distribute cdist among servers or use different +environments, you can do so easily with the included version +control git. For instance if you plan to use the typical three +environments production, integration and development, you can +realise this with git branches:

# Go to cdist checkout
+cd /path/to/cdist
+
+# Create branches
+git branch development
+git branch integration
+git branch production
+
+# Make use of a branch, for instance production
+git checkout production

Similar if you want to have cdist checked out at multiple machines, +you can clone it multiple times:

machine-a % git clone git://your-git-server/cdist
+machine-b % git clone git://your-git-server/cdist

5. SEPERATING WORK BY GROUPS

If you are working with different groups on one cdist-configuration, +you can delegate to other manifests and have the groups edit only +their manifests. You can use the following snippet in +conf/manifests/init:

# Include other groups
+sh -e "$__manifest/systems"
+
+sh -e "$__manifest/cbrg"

6. MAINTAINING MULTIPLE CONFIGURATIONS

When you need to manage multiple sites with cdist, like company_a, company_b +and private for instance, you can easily use git for this purpose. +Including a possible common base that is reused accross the different sites:

# create branches
+git branch company_a company_b common private
+
+# make stuff for company a
+git checkout company_a
+# work, commit, etc.
+
+# make stuff for company b
+git checkout company_b
+# work, commit, etc.
+
+# make stuff relevant for all sites
+git checkout common
+# work, commit, etc.
+
+# change to private and include latest common stuff
+git checkout private
+git merge common

The following .git/config is taken from a a real world scenario:

# Track upstream, merge from time to time
+[remote "upstream"]
+   url = git://git.schottelius.org/cdist
+   fetch = +refs/heads/*:refs/remotes/upstream/*
+
+# Same as upstream, but works when being offline
+[remote "local"]
+   fetch = +refs/heads/*:refs/remotes/local/*
+   url = /home/users/nico/p/cdist
+
+# Remote containing various ETH internal branches
+[remote "eth"]
+   url = sans.ethz.ch:/home/services/sans/git/cdist-eth
+   fetch = +refs/heads/*:refs/remotes/eth/*
+
+# Public remote that contains my private changes to cdist upstream
+[remote "nico"]
+   url = git.schottelius.org:/home/services/git/cdist-nico
+   fetch = +refs/heads/*:refs/remotes/nico/*
+
+# The "nico" branch will be synced with the remote nico, branch master
+[branch "nico"]
+   remote = nico
+   merge = refs/heads/master
+
+# ETH stable contains rock solid configurations used in various places
+[branch "eth-stable"]
+   remote = eth
+   merge = refs/heads/stable

Have a look at git-remote(1) to adjust the remote configuration, which allows

7. MULTIPLE DEVELOPERS WITH DIFFERENT TRUST

If you are working in an environment that requires different people to +work on the same configuration, but having different privileges, you can +implement this scenario with a gateway host and sudo:

  • +Create a dedicated user (for instance cdist) +
  • +Setup the ssh-pubkey for this user that has the right to configure all hosts +
  • +Create a wrapper to update the cdist configuration in ~cdist/cdist +
  • +Allow every developer to execute this script via sudo as the user cdist +
  • +Allow run of cdist as user cdist on specific hosts on a per user/group base +
  • +f.i. nico ALL=(ALL) NOPASSWD: /home/cdist/bin/cdist config hostabc +

For more details consult sudoers(5)

8. TEMPLATING

  • +create directory templates/ in your type (convention) +
  • +create the template as an executable file like templates/basic.conf.sh, it will output text using shell variables for the values +
#!/bin/sh
+# in the template, use cat << eof (here document) to output the text
+# and use standard shell variables in the template
+# output everything in the template script to stdout
+cat << EOF
+server {
+  listen                          80;
+  server_name                     $SERVERNAME;
+  root                            $ROOT;
+
+  access_log /var/log/nginx/$SERVERNAME_access.log
+  error_log /var/log/nginx/$SERVERNAME_error.log
+}
+EOF
  • +in the manifest, export the relevant variables and add the following lines in your manifest: +
# export variables needed for the template
+  export SERVERNAME='test"
+  export ROOT='/var/www/test'
+# render the template
+  mkdir -p "$__object/files"
+  "$__type/templates/basic.conf.sh" > "$__object/files/basic.conf"
+# send the rendered template
+  __file /etc/nginx/sites-available/test.conf  --state present   --source "$__object/files/basic.conf"

9. SEE ALSO

  • +cdist(1) +
  • +cdist-tutorial(7) +

10. COPYING

Copyright (C) 2011-2012 Nico Schottelius. Free use of this software is +granted under the terms of the GNU General Public License version 3 (GPLv3).

diff --git a/software/cdist/man/2.1.0pre7-48-gc51edff/man7/cdist-bootstrap.html b/software/cdist/man/2.1.0pre7-48-gc51edff/man7/cdist-bootstrap.html new file mode 100644 index 00000000..6f2431c7 --- /dev/null +++ b/software/cdist/man/2.1.0pre7-48-gc51edff/man7/cdist-bootstrap.html @@ -0,0 +1,77 @@ + + +cdist-bootstrap(7)

cdist-bootstrap(7)

Table of Contents

1. NAME
2. INTRODUCTION
3. LOCATION
4. SETUP WORKING DIRECTORY AND BRANCH
5. PUBLISHING THE CONFIGURATION
6. UPDATING FROM ORIGIN
7. SEE ALSO
8. COPYING

1. NAME

cdist-bootstrap - setup cdist environment

2. INTRODUCTION

This document describes the usual steps recommended for a new +cdist setup. It is recommended that you have read and understood +cdist-quickstart(7) before digging into this.

3. LOCATION

First of all, you should think about where to store your configuration +database and who will be accessing or changing it. Secondly you have to +think about where to configure your hosts from, which may be a different +location.

For starters, having cdist (which includes the configuration database) on +your notebook should be fine. +Additionally an external copy of the git repository the configuration +relies in is recommended, for use as backup as well to allow easy collaboration +with others.

For more sophisticated setups developing cdist configurations with multiple +people, have a look at cdist-best-practice(7).

4. SETUP WORKING DIRECTORY AND BRANCH

I assume you have a fresh copy of the cdist tree in ~/cdist, cloned from +one of the official urls (see cdist-quickstart(7) if you don’t). +Entering the command "git branch" should show you "* master", which indicates +you are on the master branch.

The master branch reflects the latest development of cdist. As this is the +development branch, it may or may not work. There are also version branches +available, which are kept in a stable state. Let’s use git branch -r +to list all branches:

cdist% git branch -r
+  origin/1.0
+  origin/1.1
+  origin/1.2
+  origin/1.3
+  origin/1.4
+  origin/1.5
+  origin/1.6
+  origin/1.7
+  origin/2.0
+  origin/HEAD -> origin/master
+  origin/archive_shell_function_approach
+  origin/master

So 2.0 is the latest version branch in this example. +All versions (2.0.x) within one version branch (2.0) are compatible to each +other and won’t break your configuration when updating.

It’s up to you decide on which branch you want to base your own work: +master contains more recent changes, newer types, but may also break. +The versions branches are stable, but thus may miss the latest features. +Your decision can be changed later on, but may result in merge conflicts, +which you’d have to solve.

Let’s assume you want latest stuff and select the master branch as base for +your own work. Now it’s time to create your branch, which contains your +local changes. I usually name it by the company/area I am working for: +ethz-systems, localch, customerX, … But this is pretty much up to you.

In this tutorial I use the branch mycompany:

cdist% git checkout -b mycompany origin/master
+Branch mycompany set up to track remote branch master from origin.
+Switched to a new branch 'mycompany'
+cdist-user% git branch
+  master
+* mycompany

From now on, you can use git as usual to commit your changes in your own branch.

5. PUBLISHING THE CONFIGURATION

Usually a development machine like a notebook should be considered +temporary only. For this reason and to enable shareability, the configuration +should be published to another device as early as possible. The following +example shows how to publish the configuration to another host that is +reachable via ssh and has git installed:

# Create bare git repository on the host named "loch"
+cdist% ssh loch "GIT_DIR=/home/nutzer/cdist git init"
+Initialized empty Git repository in /home/nutzer/cdist/
+
+# Add remote git repo to git config
+cdist% git remote add loch loch:/home/nutzer/cdist
+
+# Configure the mycompany branch to push to loch
+cdist% git config branch.mycompany.remote loch
+
+# Configure mycompany branch to push into remote master branch
+cdist% git config branch.mycompany.merge refs/heads/master
+
+# Push mycompany branch to remote branch master initially
+cdist% git push loch mycompany:refs/heads/master

Now you have setup the git repository to synchronise the mycompany +branch with the master branch on the host loch. Thus you can commit +as usual in your branch and push out changes by entering git push.

6. UPDATING FROM ORIGIN

Whenever you want to update your cdist installation, you can use git to do so:

# Update git repository with latest changes from origin
+cdist% git fetch origin
+
+# Update current branch with master branch from origin
+cdist% git merge origin/master
+
+# Alternative: Update current branch with 2.0 branch from origin
+cdist% git merge origin/2.0

7. SEE ALSO

  • +cdist(1) +
  • +cdist-tutorial(7) +

8. COPYING

Copyright (C) 2012 Nico Schottelius. Free use of this software is +granted under the terms of the GNU General Public License version 3 (GPLv3).

diff --git a/software/cdist/man/2.1.0pre7-48-gc51edff/man7/cdist-explorer.html b/software/cdist/man/2.1.0pre7-48-gc51edff/man7/cdist-explorer.html new file mode 100644 index 00000000..40f04da1 --- /dev/null +++ b/software/cdist/man/2.1.0pre7-48-gc51edff/man7/cdist-explorer.html @@ -0,0 +1,28 @@ + + +cdist-explorer(7)

cdist-explorer(7)

Table of Contents

1. NAME
2. DESCRIPTION
3. EXAMPLES
4. SEE ALSO
5. COPYING

1. NAME

cdist-explorer - Explore the target systems

2. DESCRIPTION

Explorer are small shell scripts, which will be executed on the target +host. The aim of the explorer is to give hints to types on how to act on the +target system. An explorer outputs the result to stdout, which is usually +a one liner, but may be empty or multi line especially in the case of +type explorers.

There are general explorers, which are run in an early stage, and +type explorers. Both work almost exactly the same way, with the difference +that the values of the general explorers are stored in a general location and +the type specific below the object.

Explorers can reuse other explorers on the target system by calling +$explorer/<explorer_name> (general and type explorer) or +$type_explorer/<explorer name> (type explorer).

In case of significant errors, the explorer may exit non-zero and return an +error message on stderr, which will cause cdist to abort.

You can also use stderr for debugging purposes while developing a new +explorer.

3. EXAMPLES

A very simple explorer may look like this:

hostname

Which is in practise the hostname explorer.

A type explorer, which could check for the status of a package may look like this:

if [ -f "$__object/parameter/name" ]; then
+   name="$(cat "$__object/parameter/name")"
+else
+   name="$__object_id"
+fi
+
+# Except dpkg failing, if package is not known / installed
+dpkg -s "$name" 2>/dev/null || exit 0

4. SEE ALSO

  • +cdist(1) +
  • +cdist-reference(7) +
  • +cdist-stages(7) +

5. COPYING

Copyright (C) 2010-2012 Nico Schottelius. Free use of this software is +granted under the terms of the GNU General Public License version 3 (GPLv3).

diff --git a/software/cdist/man/2.1.0pre7-48-gc51edff/man7/cdist-hacker.html b/software/cdist/man/2.1.0pre7-48-gc51edff/man7/cdist-hacker.html new file mode 100644 index 00000000..d1cd3a8b --- /dev/null +++ b/software/cdist/man/2.1.0pre7-48-gc51edff/man7/cdist-hacker.html @@ -0,0 +1,43 @@ + + +cdist-hacker(7)

cdist-hacker(7)

Table of Contents

1. NAME
2. WELCOME
3. REPORTING BUGS
4. CODING CONVENTIONS (EVERYWHERE)
5. HOW TO SUBMIT STUFF FOR INCLUSION INTO UPSTREAM CDIST
6. HOW TO SUBMIT A NEW TYPE
7. SEE ALSO
8. COPYING

1. NAME

cdist-hacker - How to get (stuff) into cdist

2. WELCOME

Welcome dear hacker! I invite you to a tour of pointers to +get into the usable configuration mangament system, cdist.

The first thing to know is probably that cdist is brought to +you by people who care about how code looks like and who think +twice before merging or implementing a feature: Less features +with good usability are far better than the opposite.

3. REPORTING BUGS

If you believe you’ve found a bug and verified that it is +in the latest version, drop a mail to the cdist mailing list, +subject prefixed with "[BUG] " or create an issue on github.

4. CODING CONVENTIONS (EVERYWHERE)

If something should be better done or needs to fixed, add the word FIXME +nearby, so grepping for FIXME gives all positions that need to be fixed.

Indention is 4 spaces (welcome to the python world).

5. HOW TO SUBMIT STUFF FOR INCLUSION INTO UPSTREAM CDIST

If you did some cool changes to cdist, which you value as a benefit for +everybody using cdist, you’re welcome to propose inclusion into upstream.

There are though some requirements to ensure your changes don’t break others +work nor kill the authors brain:

  • +All files should contain the usual header (Author, Copying, etc.) +
  • +Code submission must be done via git +
  • +Do not add conf/manifest/init - This file should only be touched in your + private branch! +
  • +Code to be included should be branched of the upstream "master" branch +
  • +Exception: Bugfixes to a version branch +
  • +On a merge request, always name the branch I should pull from +
  • +Always ensure all manpages build. Use ./build man to test. +
  • +If you developed more than one feature, consider submitting them in + seperate branches. This way one feature can already be included, even if + the other needs to be improved. +

As soon as your work meets these requirements, write a mail +for inclusion to the mailinglist cdist at cdist — at — l.schottelius.org +or open a pull request at http://github.com/telmich/cdist.

6. HOW TO SUBMIT A NEW TYPE

For detailled information about types, see cdist-type(7).

Submitting a type works as described above, with the additional requirement +that a corresponding manpage named man.text in asciidoc format with +the manpage-name "cdist-type__NAME" is included in the type directory +AND asciidoc is able to compile it (i.e. do NOT have to many "=" in the second +line).

Warning: Submitting "exec" or "run" types that simply echo their parameter in +gencode* will not be accepted, because they are of no use. Every type can output +code and thus such a type introduces redundant functionality that is given by +core cdist already.

7. SEE ALSO

  • +cdist(7) +

8. COPYING

Copyright (C) 2011-2012 Nico Schottelius. Free use of this software is +granted under the terms of the GNU General Public License version 3 (GPLv3).

diff --git a/software/cdist/man/2.1.0pre7-48-gc51edff/man7/cdist-manifest.html b/software/cdist/man/2.1.0pre7-48-gc51edff/man7/cdist-manifest.html new file mode 100644 index 00000000..22eca26d --- /dev/null +++ b/software/cdist/man/2.1.0pre7-48-gc51edff/man7/cdist-manifest.html @@ -0,0 +1,72 @@ + + +cdist-manifest(7)

cdist-manifest(7)

Table of Contents

1. NAME
2. DESCRIPTION
3. INITIAL AND TYPE MANIFESTS
4. DEFINE STATE IN THE INITIAL MANIFEST
5. SPLITTING UP THE INITIAL MANIFEST
6. DEPENDENCIES
7. EXAMPLES
8. SEE ALSO
9. COPYING

1. NAME

cdist-manifest - (Re-)Use types

2. DESCRIPTION

Manifests are used to define which objects to create. +Objects are instances of types, like in object orientated programming languages. +An object is represented by the combination of +type + slash + object name: file/etc/cdist-configured is an +object of the type file with the name etc/cdist-configured.

All available types can be found in the conf/type/ directory, +use ls conf/type to get the list of available types. If you have +setup the MANPATH correctly, you can use man cdist-reference to access +the reference with pointers to the manpages.

Types in manifests are used like normal command line tools. Let’s have a look +at an example:

# Create object of type __package with the parameter state = removed
+__package apache2 --state removed
+
+# Same with the __directory type
+ __directory /tmp/cdist --state present

These two lines create objects, which will later be used to realise the +configuration on the target host.

Manifests are executed locally as a shell script using /bin/sh -e. +The resulting objects are stored in an internal database.

The same object can be redefined in multiple different manifests as long as +the parameters are exactly the same.

In general, manifests are used to define which types are used depending +on given conditions.

3. INITIAL AND TYPE MANIFESTS

Cdist knows about two types of manifests: The initial manifest and type +manifests. The initial manifest is used to define, which configurations +to apply to which hosts. The type manifests are used to create objects +from types. More about manifests in types can be found in cdist-type(7).

4. DEFINE STATE IN THE INITIAL MANIFEST

The initial manifest is the entry point for cdist to find out, which +objects to configure on the selected host. +Cdist searches for the initial manifest at conf/manifest/init.

Within this initial manifest, you define, which objects should be +created on which host. To distinguish between hosts, you can use the +environment variable __target_host. Let’s have a look at a simple +example:

__cdistmarker
+
+case "$__target_host" in
+   localhost)
+        __directory /home/services/kvm-vm --parents yes
+   ;;
+esac

This manifest says: Independent of the host, always use the type +__cdistmarker, which creates the file /etc/cdist-configured, +with the timestamp as content. +The directory /home/services/kvm-vm, including all parent directories, +is only created on the host localhost.

As you can see, there is no magic involved, the manifest is simple shell code that +utilises cdist types. Every available type can be executed like a normal +command.

5. SPLITTING UP THE INITIAL MANIFEST

If you want to split up your initial manifest, you can create other shell +scripts in conf/manifest/ and include them in conf/manifest/init. +Cdist provides the environment variable __manifest to reference to +the directory containing the initial manifest (see cdist-reference(7)).

The following example would include every file with a .sh suffix:

# Include *.sh
+for manifest in $__manifest/*.sh; do
+    # And source scripts into our shell environment
+    . "$manifest"
+done

6. DEPENDENCIES

If you want to describe that something requires something else, just +setup the variable "require" to contain the requirements. Multiple +requirements can be added white space seperated.

# No dependency
+__file /etc/cdist-configured
+
+# Require above object
+require="__file/etc/cdist-configured" __link /tmp/cdist-testfile \
+   --source /etc/cdist-configured  --type symbolic
+
+# Require two objects
+require="__file/etc/cdist-configured __link/tmp/cdist-testfile" \
+   __file /tmp/cdist-another-testfile

All objects that are created in a type manifest are automatically required +from the type that is calling them. This is called "autorequirement" in +cdist jargon.

7. EXAMPLES

The initial manifest may for instance contain the following code:

# Always create this file, so other sysadmins know cdist is used.
+__file /etc/cdist-configured --type file
+
+case "$__target_host" in
+   my.server.name)
+      __file /root/bin/ --type directory
+      __file /etc/issue.net --type file --source "$__manifest/issue.net
+   ;;
+esac

The manifest of the type "nologin" may look like this:

__file /etc/nologin --type file --source "$__type/files/default.nologin"

8. SEE ALSO

  • +cdist-tutorial(7) +
  • +cdist-type(7) +

9. COPYING

Copyright (C) 2010-2012 Nico Schottelius. Free use of this software is +granted under the terms of the GNU General Public License version 3 (GPLv3).

diff --git a/software/cdist/man/2.1.0pre7-48-gc51edff/man7/cdist-quickstart.html b/software/cdist/man/2.1.0pre7-48-gc51edff/man7/cdist-quickstart.html new file mode 100644 index 00000000..9e437c61 --- /dev/null +++ b/software/cdist/man/2.1.0pre7-48-gc51edff/man7/cdist-quickstart.html @@ -0,0 +1,51 @@ + + +cdist-quickstart(7)

cdist-quickstart(7)

Table of Contents

1. NAME
2. INTRODUCTION
3. QUICK START - GET YOUR HANDS DIRTY NOW
4. SEE ALSO
5. COPYING

1. NAME

cdist-quickstart - jump in and enjoy cdist

2. INTRODUCTION

This tutorial is aimed at people learning cdist and shows +typical approaches as well as gives an easy start into +the world of configuration management.

This tutorial assumes you are configuring localhost, because +it is always available. Just replace localhost with your target +host for real life usage.

3. QUICK START - GET YOUR HANDS DIRTY NOW

For those who just want to configure a system with the +cdist configuration management and do not need (or want) +to understand everything.

Cdist uses ssh for communication and transportation +and usually logs into the target host as the +root user. So you need to configure the ssh server +of the target host to allow root logins: Edit +the file /etc/ssh/sshd_config and add one of the following +lines:

# Allow login only via public key
+PermitRootLogin without-password
+
+# Allow login via password and public key
+PermitRootLogin yes

As cdist uses ssh intensively, it is recommended to setup authentication +with public keys:

# Generate pubkey pair as a normal user
+ssh-keygen
+
+# Copy pubkey over to target host
+ssh-copy-id root@localhost

Have a look at ssh-agent(1) and ssh-add(1) on how to cache the password for +your public key. Usually it looks like this:

# Start agent and export variables
+eval `ssh-agent`
+
+# Add keys (requires password for every identity file)
+ssh-add

At this point you should be able to ssh root@localhost without +re-entering the password. If something failed until here, ensure that +all steps went successfully and you have read and understood the +documentation.

As soon as you are able to login without password to localhost, +we can use cdist to configure it. You can copy and paste the following +code into your shell to get started and configure localhost:

# Get cdist
+git clone git://git.schottelius.org/cdist
+
+# Create manifest (maps configuration to host(s)
+cd cdist
+echo '__file /etc/cdist-configured' > conf/manifest/init
+
+# Configure localhost in verbose mode
+./bin/cdist config -v localhost
+
+# Find out that cdist created /etc/cdist-configured
+ls -l /etc/cdist-configured

That’s it, you’ve successfully used cdist to configure your first host! +Continue reading the next sections, to understand what you did and how +to create a more sophisticated configuration.

4. SEE ALSO

  • +cdist(1) +
  • +cdist-tutorial(7) +

5. COPYING

Copyright (C) 2011-2012 Nico Schottelius. Free use of this software is +granted under the terms of the GNU General Public License version 3 (GPLv3).

diff --git a/software/cdist/man/2.1.0pre7-48-gc51edff/man7/cdist-reference.html b/software/cdist/man/2.1.0pre7-48-gc51edff/man7/cdist-reference.html new file mode 100644 index 00000000..34e6a9f6 --- /dev/null +++ b/software/cdist/man/2.1.0pre7-48-gc51edff/man7/cdist-reference.html @@ -0,0 +1,249 @@ + + +cdist-reference(7)

cdist-reference(7)

Table of Contents

1. NAME
2. EXPLORERS
3. PATHS
4. TYPES
5. OBJECTS
6. ENVIRONMENT VARIABLES
7. SEE ALSO
8. COPYING

1. NAME

cdist-reference - Variable, path and type reference for cdist

2. EXPLORERS

The following global explorers are available:

  • +hostname +
  • +interfaces +
  • +lsb_codename +
  • +lsb_description +
  • +lsb_id +
  • +lsb_release +
  • +machine +
  • +os +
  • +os_version +
  • +runlevel +

3. PATHS

If not specified otherwise, all paths are relative to the checkout directory.

+conf/ +
+ Contains the (static) configuration like manifests, types and explorers. +
+conf/manifest/init +
+ This is the central entry point. + It is an executable (+x bit set) shell script that can use + values from the explorers to decide which configuration to create + for the specified target host. + Its intent is to used to define mapping from configurations to hosts. +
+conf/manifest/* +
+ All other files in this directory are not directly used by cdist, but you + can seperate configuration mappings, if you have a lot of code in the + conf/manifest/init file. This may also be helpful to have different admins + maintain different groups of hosts. +
+conf/explorer/<name> +
+ Contains explorers to be run on the target hosts, see cdist-explorer(7). +
+conf/type/ +
+ Contains all available types, which are used to provide + some kind of functionality. See cdist-type(7). +
+conf/type/<name>/ +

+ Home of the type <name>. +

This directory is referenced by the variable __type (see below).
+conf/type/<name>/man.text +
+ Manpage in Asciidoc format (required for inclusion into upstream) +
+conf/type/<name>/manifest +
+ Used to generate additional objects from a type. +
+conf/type/<name>/gencode-local +
+ Used to generate code to be executed on the source host +
+conf/type/<name>/gencode-remote +
+ Used to generate code to be executed on the target host +
+conf/type/<name>/parameter/required +
+ Parameters required by type, \n seperated list. +
+conf/type/<name>/parameter/optional +
+ Parameters optionally accepted by type, \n seperated list. +
+conf/type/<name>/parameter/boolean +
+ Boolean parameters accepted by type, \n seperated list. +
+conf/type/<name>/explorer +
+ Location of the type specific explorers. + This directory is referenced by the variable __type_explorer (see below). + See cdist-explorer(7). +
+out/ +
+ This directory contains output of cdist and is usually located + in a temporary directory and thus will be removed after the run. + This directory is referenced by the variable __global (see below). +
+out/explorer +
+ Output of general explorers. +
+out/object +
+ Objects created for the host. +
+out/object/<object> +
+ Contains all object specific information. + This directory is referenced by the variable __object (see below). +
+out/object/<object>/explorers +
+ Output of type specific explorers, per object. +

4. TYPES

The following types are available:

  • +__apt_ppa (cdist-type__apt_ppa(7)) +
  • +__apt_update_index (cdist-type__apt_update_index(7)) +
  • +__autofs_map (cdist-type__autofs_map(7)) +
  • +__autofs_master (cdist-type__autofs_master(7)) +
  • +__cdistmarker (cdist-type__cdistmarker(7)) +
  • +__cron (cdist-type__cron(7)) +
  • +__debconf_set_selections (cdist-type__debconf_set_selections(7)) +
  • +__directory (cdist-type__directory(7)) +
  • +__file (cdist-type__file(7)) +
  • +__group (cdist-type__group(7)) +
  • +__issue (cdist-type__issue(7)) +
  • +__jail (cdist-type__jail(7)) +
  • +__key_value (cdist-type__key_value(7)) +
  • +__line (cdist-type__line(7)) +
  • +__link (cdist-type__link(7)) +
  • +__mkfs (cdist-type__mkfs(7)) +
  • +__motd (cdist-type__motd(7)) +
  • +__mysql_database (cdist-type__mysql_database(7)) +
  • +__package_apt (cdist-type__package_apt(7)) +
  • +__package_luarocks (cdist-type__package_luarocks(7)) +
  • +__package_opkg (cdist-type__package_opkg(7)) +
  • +__package_pacman (cdist-type__package_pacman(7)) +
  • +__package_pip (cdist-type__package_pip(7)) +
  • +__package_pkg_freebsd (cdist-type__package_pkg_freebsd(7)) +
  • +__package_pkg_openbsd (cdist-type__package_pkg_openbsd(7)) +
  • +__package_rubygem (cdist-type__package_rubygem(7)) +
  • +__package (cdist-type__package(7)) +
  • +__package_yum (cdist-type__package_yum(7)) +
  • +__package_zypper (cdist-type__package_zypper(7)) +
  • +__partition_msdos_apply (cdist-type__partition_msdos_apply(7)) +
  • +__partition_msdos (cdist-type__partition_msdos(7)) +
  • +__pf_apply (cdist-type__pf_apply(7)) +
  • +__pf_ruleset (cdist-type__pf_ruleset(7)) +
  • +__postgres_database (cdist-type__postgres_database(7)) +
  • +__postgres_role (cdist-type__postgres_role(7)) +
  • +__process (cdist-type__process(7)) +
  • +__qemu_img (cdist-type__qemu_img(7)) +
  • +__rvm_gemset (cdist-type__rvm_gemset(7)) +
  • +__rvm_gem (cdist-type__rvm_gem(7)) +
  • +__rvm_ruby (cdist-type__rvm_ruby(7)) +
  • +__rvm (cdist-type__rvm(7)) +
  • +__ssh_authorized_key (cdist-type__ssh_authorized_key(7)) +
  • +__start_on_boot (cdist-type__start_on_boot(7)) +
  • +__timezone (cdist-type__timezone(7)) +
  • +__user (cdist-type__user(7)) +

5. OBJECTS

For object to object communication and tests, the following paths are +usable within a object directory:

+changed +
+ This empty file exists in an object directory, if the object has + code to be excuted (either remote or local) +

6. ENVIRONMENT VARIABLES

+__explorer +
+ Directory that contains all global explorers. + Available for: explorer, type explorer +
+__manifest +
+ Directory that contains the initial manifest. + Available for: initial manifest, type manifest +
+__global +
+ Directory that contains generic output like explorer. + Available for: initial manifest, type manifest, type gencode +
+__object +
+ Directory that contains the current object. + Available for: type manifest, type explorer, type gencode +
+__object_id +

+ The type unique object id. + Available for: type manifest, type explorer, type gencode +

Note: The leading and the trailing "/" will always be stripped (caused by
+the filesystem database and ensured by the core).
    Note: Double slashes ("//") will not be fixed and result in an error.
+__object_name::
+    The full qualified name of the current object.
+    Available for: type manifest, type explorer, type gencode
+__target_host::
+    The host we are deploying to.
+    Available for: explorer, initial manifest, type explorer, type manifest, type gencode
+__type::
+    Path to the current type.
+    Available for: type manifest, type gencode
+__type_explorer::
+    Directory that contains the type explorers.
+    Available for: type explorer

7. SEE ALSO

  • +cdist(1) +

8. COPYING

Copyright (C) 2011-2012 Nico Schottelius. Free use of this software is +granted under the terms of the GNU General Public License version 3 (GPLv3).

diff --git a/software/cdist/man/2.1.0pre7-48-gc51edff/man7/cdist-remote-exec-copy.html b/software/cdist/man/2.1.0pre7-48-gc51edff/man7/cdist-remote-exec-copy.html new file mode 100644 index 00000000..13a1b704 --- /dev/null +++ b/software/cdist/man/2.1.0pre7-48-gc51edff/man7/cdist-remote-exec-copy.html @@ -0,0 +1,15 @@ + + +cdist-remote-exec-copy(7)

cdist-remote-exec-copy(7)

Table of Contents

1. NAME
2. INTRO
3. EXAMPLES
4. SEE ALSO
5. COPYING

1. NAME

cdist-remote-exec-copy - How to use remote exec and copy

2. INTRO

Cdist interacts with the target host in two ways: +- it executes code (remote_exec) +- and it copies files (remote_copy)

By default this is accomplished with ssh and scp respectively. +The default implementations used by cdist are: +remote_exec: ssh -o User=root -q +remote_copy: scp -o User=root -q

The user can override these defaults by providing custom implementations and +passing them to cdist with the --remote-exec and/or --remote-copy arguments.

For remote_exec, the custom implementation must behave as if it where ssh. +For remote_copy, it must behave like scp.

With this simple interface the user can take total control of how cdist +interacts with the target when required, while the default implementation +remains as simple as possible.

3. EXAMPLES

See cdist/other/examples/remote/ for some example implementations.

4. SEE ALSO

  • +cdist(7) +

5. COPYING

Copyright (C) 2011-2012 Nico Schottelius. Free use of this software is +granted under the terms of the GNU General Public License version 3 (GPLv3).

diff --git a/software/cdist/man/2.1.0pre7-48-gc51edff/man7/cdist-stages.html b/software/cdist/man/2.1.0pre7-48-gc51edff/man7/cdist-stages.html new file mode 100644 index 00000000..d4337f7b --- /dev/null +++ b/software/cdist/man/2.1.0pre7-48-gc51edff/man7/cdist-stages.html @@ -0,0 +1,29 @@ + + +cdist-stages(7)

cdist-stages(7)

Table of Contents

1. NAME
2. DESCRIPTION
3. STAGE 1: TARGET INFORMATION RETRIEVAL
4. STAGE 2: RUN THE INITIAL MANIFEST
5. STAGE 3: OBJECT INFORMATION RETRIEVAL
6. STAGE 4: RUN THE OBJECT MANIFEST
7. STAGE 5: CODE GENERATION
8. STAGE 6: CODE EXECUTION
9. STAGE 7: CACHE
10. SUMMARY
11. SEE ALSO
12. COPYING

1. NAME

cdist-stages - Stages used during configuration deployment

2. DESCRIPTION

Starting the execution of deployment with cdist, cdist passes +through different stages.

3. STAGE 1: TARGET INFORMATION RETRIEVAL

In this stage information is collected about the target host using so called +explorers. Every existing explorer is run on the target and the output of all +explorers are copied back into the local cache. The results can be used by +manifests and types.

4. STAGE 2: RUN THE INITIAL MANIFEST

The initial manifest, which should be used for mappings of hosts to types, +is executed. This stage creates objects in a cconfig database that contains +the objects as defined in the manifest for the specific host. In this stage, +no conflicts may occur, i.e. no object of the same type with the same id may +be created, if it has different parameters.

5. STAGE 3: OBJECT INFORMATION RETRIEVAL

Every object is checked whether its type has explorers and if so, these are +executed on the target host. The results are transfered back +and can be used in the following stages to decide what changes need to be made +on the target to implement the desired state.

6. STAGE 4: RUN THE OBJECT MANIFEST

Every object is checked whether its type has a executable manifest. The +manifest script may generate and change the created objects. In other words, +one type can reuse other types.

For instance the object apache/www.example.org is of type apache, which may +contain a manifest script, which creates new objects of type __file.

The newly created objects are merged back into the existing tree. No conflicts +may occur during the merge. A conflict would mean that two different objects +try to create the same object, which indicates a broken configuration.

7. STAGE 5: CODE GENERATION

In this stage for every created object its type is checked for executable +gencode scripts. The gencode scripts generate the code to be executed on the +target on stdout. If the gencode executables fail, they must print diagnostic +messages on stderr and exit non-zero.

8. STAGE 6: CODE EXECUTION

For every object the resulting code from the previous stage is transferred to +the target host and executed there to apply the configuration changes.

9. STAGE 7: CACHE

The cache stores the information from the current run for later use.

10. SUMMARY

If, and only if, all the stages complete without an errors, the configuration +will be applied to the target.

11. SEE ALSO

  • +cdist(1) +
  • +cdist-reference(7) +

12. COPYING

Copyright (C) 2010-2012 Nico Schottelius, Steven Armstrong. Free use of this software is +granted under the terms of the GNU General Public License version 3 (GPLv3).

diff --git a/software/cdist/man/2.1.0pre7-48-gc51edff/man7/cdist-tutorial.html b/software/cdist/man/2.1.0pre7-48-gc51edff/man7/cdist-tutorial.html new file mode 100644 index 00000000..a6fd3330 --- /dev/null +++ b/software/cdist/man/2.1.0pre7-48-gc51edff/man7/cdist-tutorial.html @@ -0,0 +1,54 @@ + + +cdist-tutorial(7)

cdist-tutorial(7)

Table of Contents

1. NAME
2. INTRODUCTION
3. SEE ALSO
4. COPYING

1. NAME

cdist-tutorial - a guided introduction into cdist

2. INTRODUCTION

This document gives you a pointer on what to read in +which order and is thus a "guide to the right locations". +So in case you are just starting, just "begin at the beginning" +(Brave New World). You can see the target audience in [] brackets +after the description.

+cdist-quickstart +
+ New to cdist? Want to get your hands dirty? Read this. [beginner] +
+cdist-bootstrap +
+ The comprehensive guide to your first cdist installation [beginner] +
+cdist-manifest +
+ Learn how to define which hosts get which configurations [beginner] +
+cdist-type +
+ Understand how types are working and created [intermediate] +
+cdist-best-practice +
+ Hints from real life experience to help you to organise cdist [intermediate] +
+cdist-reference +
+ The type, explorers and environment variables reference [intermediate] +
+cdist-explorer +
+ Interested in getting more information about the target system? [intermediate] +
+cdist-stages +
+ Understand the internal workflow of cdist. [advanced] +
+cdist-hacker +
+ README, if you want to extend or modify cdist. [hacker] +

3. SEE ALSO

  • +cdist(1) +
  • +cdist-type(7) +
  • +cdist-best-practice(7) +
  • +cdist-stages(7) +
  • +Brave New World by Aldous Huxley +

4. COPYING

Copyright (C) 2011-2012 Nico Schottelius. Free use of this software is +granted under the terms of the GNU General Public License version 3 (GPLv3).

diff --git a/software/cdist/man/2.1.0pre7-48-gc51edff/man7/cdist-type.html b/software/cdist/man/2.1.0pre7-48-gc51edff/man7/cdist-type.html new file mode 100644 index 00000000..f9984652 --- /dev/null +++ b/software/cdist/man/2.1.0pre7-48-gc51edff/man7/cdist-type.html @@ -0,0 +1,129 @@ + + +cdist-type(7)

cdist-type(7)

Table of Contents

1. NAME
2. SYNOPSIS
3. DESCRIPTION
4. HOW TO USE A TYPE
5. SINGLETON TYPES
6. HOW TO WRITE A NEW TYPE
7. DEFINING PARAMETERS
8. USING PARAMETERS
9. INPUT FROM STDIN
10. In the __file type, stdin is used as source for the file, if - is used for source:
11. SINGLETON - ONE INSTANCE ONLY
12. THE TYPE EXPLORERS
13. WRITING THE GENCODE SCRIPT
14. HINTS FOR TYPEWRITERS
15. HOW TO INCLUDE A TYPE INTO UPSTREAM CDIST
16. SEE ALSO
17. COPYING

1. NAME

cdist-type - Functionality bundled

2. SYNOPSIS

__TYPE ID --parameter value [--parameter value …]

__TYPE --parameter value [--parameter value …] (for singletons)

3. DESCRIPTION

Types are the main component of cdist and define functionality. If you +use cdist, you’ll write a type for every functionality you would like +to use.

4. HOW TO USE A TYPE

You can use types from the initial manifest or the type manifest like a +normal command:

# Creates empty file /etc/cdist-configured
+__file /etc/cdist-configured --type file
+
+# Ensure tree is installed
+__package tree --state installed

A list of supported types can be found in the cdist-reference(7) manpage.

5. SINGLETON TYPES

If a type is flagged as a singleton, it may be used only +once per host. This is useful for types which can be used only once on a +system. Singleton types do not take an object name as argument.

Example:

# __issue type manages /etc/issue
+__issue
+
+# Probably your own type - singletons may use parameters
+__myfancysingleton --colour green

6. HOW TO WRITE A NEW TYPE

A type consists of

  • +parameter (optional) +
  • +manifest (optional) +
  • +singleton (optional) +
  • +explorer (optional) +
  • +gencode (optional) +

Types are stored below conf/type/. Their name should always be prefixed with +two underscores (__) to prevent collisions with other executables in $PATH.

To begin a new type, just create the directory conf/type/__NAME.

7. DEFINING PARAMETERS

Every type consists of required, optional and boolean parameters, which must +be created in a newline seperated file in parameter/required, +parameter/required_multiple, parameter/optional, +parameter/optional_multiple and parameter/boolean. +Parameters which are allowed multiple times should be listed in +required_multiple or optional_multiple respectively. For all other parameters +the standard unix behaviour of the last given wins is applied. +If either is missing, the type will have no required, no optional, no boolean +or no parameters at all.

Example:

echo servername >> conf/type/__nginx_vhost/parameter/required
+echo logdirectory >> conf/type/__nginx_vhost/parameter/optional
+echo server_alias >> conf/type/__nginx_vhost/parameter/optional_multiple
+echo use_ssl >> conf/type/__nginx_vhost/parameter/boolean

8. USING PARAMETERS

The parameters given to a type can be accessed and used in all type scripts +(e.g manifest, gencode-, explorer/). Note that boolean parameters are +represented by file existence. File exists → True, +file does not exist → False

Example: (e.g. in conf/type/__nginx_vhost/manifest)

# required parameter
+servername="$(cat "$__object/parameter/servername")"
+
+# optional parameter
+if [ -f "$__object/parameter/logdirectory" ]; then
+   logdirectory="$(cat "$__object/parameter/logdirectory")"
+fi
+
+# boolean parameter
+if [ -f "$__object/parameter/use_ssl" ]; then
+   # file exists -> True
+   # do some fancy ssl stuff
+fi
+
+# parameter with multiple values
+if [ -f "$__object/parameter/server_alias" ]; then
+   for alias in $(cat "$__object/parameter/server_alias"); do
+      echo $alias > /some/where/usefull
+   done
+fi

9. INPUT FROM STDIN

Every type can access what has been written on stdin when it has been called. +The result is saved into the stdin file in the object directory.

Example use of a type: (e.g. in conf/type/__archlinux_hostname)

__file /etc/rc.conf --source - << eof
+...
+HOSTNAME="$__target_host"
+...
+eof

If you have not seen this syntax (<< eof) before, it may help you to read +about "here documents".

10. In the __file type, stdin is used as source for the file, if - is used for source:

if [ -f "$__object/parameter/source" ]; then
+    source="$(cat "$__object/parameter/source")"
+    if [ "$source" = "-" ]; then
+        source="$__object/stdin"
+    fi
+....
WRITING THE MANIFEST

In the manifest of a type you can use other types, so your type extends +their functionality. A good example is the __package type, which in +a shortened version looks like this:

os="$(cat "$__global/explorer/os")"
+case "$os" in
+      archlinux) type="pacman" ;;
+      debian|ubuntu) type="apt" ;;
+      gentoo) type="emerge" ;;
+      *)
+         echo "Don't know how to manage packages on: $os" >&2
+         exit 1
+      ;;
+esac
+
+__package_$type "$@"

As you can see, the type can reference different environment variables, +which are documented in cdist-reference(7).

Always ensure the manifest is executable, otherwise cdist will not be able +to execute it. For more information about manifests see cdist-manifest(7).

11. SINGLETON - ONE INSTANCE ONLY

If you want to ensure that a type can only be used once per target, you can +mark it as a singleton: Just create the (empty) file "singleton" in your type +directory:

touch conf/type/__NAME/singleton

This will also change the way your type must be called:

__YOURTYPE --parameter value

As you can see, the object ID is omitted, because it does not make any sense, +if your type can be used only once.

12. THE TYPE EXPLORERS

If a type needs to explore specific details, it can provide type specific +explorers, which will be executed on the target for every created object.

The explorers are stored under the "explorer" directory below the type. +It could for instance contain code to check the md5sum of a file on the +client, like this (shortened version from the type __file):

if [ -f "$__object/parameter/destination" ]; then
+   destination="$(cat "$__object/parameter/destination")"
+else
+   destination="/$__object_id"
+fi
+
+if [ -e "$destination" ]; then
+   md5sum < "$destination"
+fi

13. WRITING THE GENCODE SCRIPT

There are two gencode scripts: gencode-local and gencode-remote. +The output of gencode-local is executed locally, whereas +the output of gencode-remote is executed on the target. +The gencode scripts can make use of the parameters, the global explorers +and the type specific explorers.

If the gencode scripts encounter an error, it should print diagnostic +messages to stderr and exit non-zero. If you need to debug the gencode +script, you can write to stderr:

# Debug output to stderr
+echo "My fancy debug line" >&2
+
+# Output to be saved by cdist for execution on the target
+echo "touch /etc/cdist-configured"

14. HINTS FOR TYPEWRITERS

It must be assumed that the target is pretty dumb and thus does not have high +level tools like ruby installed. If a type requires specific tools to be present +on the target, there must be another type that provides this tool and the first +type should create an object of the specific type.

If your type wants to save temporary data, that may be used by other types +later on (for instance file), you can save them in the subdirectory +"files" below $object (but you must create it yourself). +cdist will not touch this directory.

If your type contains static files, it’s also recommended to place them in +a folder named "files" within the type (again, because cdist guarantees to +never ever touch this folder).

15. HOW TO INCLUDE A TYPE INTO UPSTREAM CDIST

If you think your type may be useful for others, ensure it works with the +current master branch of cdist and have a look at cdist-hacker(7) on +how to submit it.

16. SEE ALSO

  • +cdist-explorer(7) +
  • +cdist-hacker(7) +
  • +cdist-stages(7) +
  • +cdist-tutorial(7) +

17. COPYING

Copyright (C) 2011-2012 Nico Schottelius. Free use of this software is +granted under the terms of the GNU General Public License version 3 (GPLv3).

diff --git a/software/cdist/man/2.1.0pre7-48-gc51edff/man7/cdist-type__apt_ppa.html b/software/cdist/man/2.1.0pre7-48-gc51edff/man7/cdist-type__apt_ppa.html new file mode 100644 index 00000000..8d8bba53 --- /dev/null +++ b/software/cdist/man/2.1.0pre7-48-gc51edff/man7/cdist-type__apt_ppa.html @@ -0,0 +1,14 @@ + + +cdist-type__apt_ppa(7)

cdist-type__apt_ppa(7)

Table of Contents

1. NAME
2. DESCRIPTION
3. REQUIRED PARAMETERS
4. OPTIONAL PARAMETERS
5. EXAMPLES
6. SEE ALSO
7. COPYING

1. NAME

cdist-type__apt_ppa - Manage ppa repositories

2. DESCRIPTION

This cdist type allows manage ubuntu ppa repositories.

3. REQUIRED PARAMETERS

+state +
+ The state the ppa should be in, either "enabled" or "disabled". +

4. OPTIONAL PARAMETERS

None.

5. EXAMPLES

# Enable a ppa repository
+__apt_ppa ppa:sans-intern/missing-bits --state enabled
+
+# Disable a ppa repository
+__apt_ppa ppa:sans-intern/missing-bits --state disabled

6. SEE ALSO

  • +cdist-type(7) +

7. COPYING

Copyright (C) 2011 Steven Armstrong. Free use of this software is +granted under the terms of the GNU General Public License version 3 (GPLv3).

diff --git a/software/cdist/man/2.1.0pre7-48-gc51edff/man7/cdist-type__apt_update_index.html b/software/cdist/man/2.1.0pre7-48-gc51edff/man7/cdist-type__apt_update_index.html new file mode 100644 index 00000000..379d1efc --- /dev/null +++ b/software/cdist/man/2.1.0pre7-48-gc51edff/man7/cdist-type__apt_update_index.html @@ -0,0 +1,6 @@ + + +cdist-type__apt_update_index(7)

cdist-type__apt_update_index(7)

Table of Contents

1. NAME
2. DESCRIPTION
3. REQUIRED PARAMETERS
4. OPTIONAL PARAMETERS
5. EXAMPLES
6. SEE ALSO
7. COPYING

1. NAME

cdist-type__apt_update_index - update apt’s package index

2. DESCRIPTION

This cdist type runs apt-get update whenever any apt sources have changed.

3. REQUIRED PARAMETERS

None.

4. OPTIONAL PARAMETERS

None.

5. EXAMPLES

__apt_update_index

6. SEE ALSO

  • +cdist-type(7) +

7. COPYING

Copyright (C) 2011 Steven Armstrong. Free use of this software is +granted under the terms of the GNU General Public License version 3 (GPLv3).

diff --git a/software/cdist/man/2.1.0pre7-48-gc51edff/man7/cdist-type__autofs_map.html b/software/cdist/man/2.1.0pre7-48-gc51edff/man7/cdist-type__autofs_map.html new file mode 100644 index 00000000..ae6f4ac0 --- /dev/null +++ b/software/cdist/man/2.1.0pre7-48-gc51edff/man7/cdist-type__autofs_map.html @@ -0,0 +1,29 @@ + + +cdist-type__autofs_map(7)

cdist-type__autofs_map(7)

Table of Contents

1. NAME
2. DESCRIPTION
3. OBJECT ID
4. REQUIRED PARAMETERS
5. OPTIONAL PARAMETERS
6. EXAMPLES
7. SEE ALSO
8. COPYING

1. NAME

cdist-type__autofs_map - Manage autofs maps

2. DESCRIPTION

This cdist type allows you to define maps for autofs.

3. OBJECT ID

The object_id is used as the mount-point as described in auto.master(5).

4. REQUIRED PARAMETERS

+map +
+ Name of the map to use. See auto.master(5). +

5. OPTIONAL PARAMETERS

+type +
+ Type of map used for this mount point. Defaults to file. + See map-type in auto.master(5) for possible values. +
+options +
+ See auto.master(5). +
+comment +
+ A comment describing this map. Is added to the generated entry in + auto.master. +

6. EXAMPLES

# Add auto mounter at /net
+__autofs_map /net --map /etc/auto.net --type program
+
+# Add auto mounter at /pub
+__autofs_map /pub --map /etc/auto.pub \
+   --type file --options nosuid,rw,bg,hard,intr --ghost

7. SEE ALSO

  • +cdist-type(7) +

8. COPYING

Copyright (C) 2011 Steven Armstrong. Free use of this software is +granted under the terms of the GNU General Public License version 3 (GPLv3).

diff --git a/software/cdist/man/2.1.0pre7-48-gc51edff/man7/cdist-type__autofs_master.html b/software/cdist/man/2.1.0pre7-48-gc51edff/man7/cdist-type__autofs_master.html new file mode 100644 index 00000000..66e0ddbc --- /dev/null +++ b/software/cdist/man/2.1.0pre7-48-gc51edff/man7/cdist-type__autofs_master.html @@ -0,0 +1,16 @@ + + +cdist-type__autofs_master(7)

cdist-type__autofs_master(7)

Table of Contents

1. NAME
2. DESCRIPTION
3. REQUIRED PARAMETERS
4. OPTIONAL PARAMETERS
5. EXAMPLES
6. SEE ALSO
7. COPYING

1. NAME

cdist-type__autofs_master - Generate the auto.master file

2. DESCRIPTION

This cdist type generates a auto.master configuration from given autofs_map +definitions. See cdist-typeauto_map(7).

3. REQUIRED PARAMETERS

None

4. OPTIONAL PARAMETERS

+header +
+ Absolute path to a file used as the header for the generated auto.master + file. +

5. EXAMPLES

# auto.master with default header
+__autofs_master
+
+# auto.master with custom header
+__autofs_master --header /path/to/header

6. SEE ALSO

  • +cdist-type(7) +

7. COPYING

Copyright (C) 2011 Steven Armstrong. Free use of this software is +granted under the terms of the GNU General Public License version 3 (GPLv3).

diff --git a/software/cdist/man/2.1.0pre7-48-gc51edff/man7/cdist-type__cdistmarker.html b/software/cdist/man/2.1.0pre7-48-gc51edff/man7/cdist-type__cdistmarker.html new file mode 100644 index 00000000..2a6531bd --- /dev/null +++ b/software/cdist/man/2.1.0pre7-48-gc51edff/man7/cdist-type__cdistmarker.html @@ -0,0 +1,23 @@ + + +cdist-type__cdistmarker(7)

cdist-type__cdistmarker(7)

Table of Contents

1. NAME
2. DESCRIPTION
3. REQUIRED PARAMETERS
4. OPTIONAL PARAMETERS
5. EXAMPLES
6. SEE ALSO
7. COPYING

1. NAME

cdist-type__cdistmarker - Add a timestamped cdist marker.

2. DESCRIPTION

This type is used to add a common marker file which indicates that a given +machine is being managed by cdist. The contents of this file consist of a +timestamp, which can be used to determine the most recent time at which cdist +was run against the machine in question.

3. REQUIRED PARAMETERS

None.

4. OPTIONAL PARAMETERS

+destination +
+ The path and filename of the marker. + Default: /etc/cdist-configured +
+format +
+ The format of the timestamp. This is passed directly to system date. + Default: -u +

5. EXAMPLES

# Creates the marker as normal.
+__cdistmarker
+
+# Creates the marker differently.
+__cdistmarker --file /tmp/cdist_marker --format '+%s'

6. SEE ALSO

  • +cdist-type(7) +

7. COPYING

Copyright (C) 2011 Daniel Maher. Free use of this software is granted under +the terms of the GNU General Public License version 3 (GPLv3).

diff --git a/software/cdist/man/2.1.0pre7-48-gc51edff/man7/cdist-type__cron.html b/software/cdist/man/2.1.0pre7-48-gc51edff/man7/cdist-type__cron.html new file mode 100644 index 00000000..9ec41178 --- /dev/null +++ b/software/cdist/man/2.1.0pre7-48-gc51edff/man7/cdist-type__cron.html @@ -0,0 +1,57 @@ + + +cdist-type__cron(7)

cdist-type__cron(7)

Table of Contents

1. NAME
2. DESCRIPTION
3. REQUIRED PARAMETERS
4. OPTIONAL PARAMETERS
5. EXAMPLES
6. SEE ALSO
7. COPYING

1. NAME

cdist-type__cron - installs and manages cron jobs

2. DESCRIPTION

This cdist type allows you to manage entries in a users crontab.

3. REQUIRED PARAMETERS

+user +
+ The user who’s crontab is edited +
+command +
+ The command to run. +

4. OPTIONAL PARAMETERS

+state +
+ Either present or absent. Defaults to present. +
+minute +
+ See crontab(5). Defaults to * +
+hour +
+ See crontab(5). Defaults to * +
+day_of_month +
+ See crontab(5). Defaults to * +
+month +
+ See crontab(5). Defaults to * +
+day_of_week +
+ See crontab(5). Defaults to * +
+raw +
+ Take whatever the user has given instead of time and date fields. + If given, all other time and date fields are ignored. + Can for example be used to specify cron EXTENSIONS like reboot, yearly etc. + See crontab(5) for the extensions if any that your cron implementation + implements. +

5. EXAMPLES

# run Monday to Saturday at 23:15
+__cron some-id --user root --command "/path/to/script" \
+   --hour 23 --minute 15 --day_of_week 1-6
+
+# run on reboot
+__cron some-id --user root --command "/path/to/script" \
+   --raw @reboot
+
+# remove cronjob
+__cron some-id --user root --command "/path/to/script" --state absent

6. SEE ALSO

  • +cdist-type(7) +
  • +crontab(5) +

7. COPYING

Copyright (C) 2011 Steven Armstrong. Free use of this software is +granted under the terms of the GNU General Public License version 3 (GPLv3).

diff --git a/software/cdist/man/2.1.0pre7-48-gc51edff/man7/cdist-type__debconf_set_selections.html b/software/cdist/man/2.1.0pre7-48-gc51edff/man7/cdist-type__debconf_set_selections.html new file mode 100644 index 00000000..50b217d8 --- /dev/null +++ b/software/cdist/man/2.1.0pre7-48-gc51edff/man7/cdist-type__debconf_set_selections.html @@ -0,0 +1,15 @@ + + +cdist-type__debconf_set_selections(7)

cdist-type__debconf_set_selections(7)

Table of Contents

1. NAME
2. DESCRIPTION
3. REQUIRED PARAMETERS
4. EXAMPLES
5. SEE ALSO
6. COPYING

1. NAME

cdist-type__debconf_set_selections - Setup debconf selections

2. DESCRIPTION

On Debian and alike systems debconf-set-selections(1) can be used +to setup configuration parameters.

3. REQUIRED PARAMETERS

+file +
+ If supplied, use the given filename as input for debconf-set-selections(1) +

4. EXAMPLES

# Setup configuration for nslcd
+__debconf_set_selections nslcd --file /path/to/file
+
+# Setup configuration for nslcd from another type
+__debconf_set_selections nslcd --file "$__type/files/preseed/nslcd"

5. SEE ALSO

  • +cdist-type(7) +

6. COPYING

Copyright (C) 2011 Nico Schottelius. Free use of this software is +granted under the terms of the GNU General Public License version 3 (GPLv3).

diff --git a/software/cdist/man/2.1.0pre7-48-gc51edff/man7/cdist-type__directory.html b/software/cdist/man/2.1.0pre7-48-gc51edff/man7/cdist-type__directory.html new file mode 100644 index 00000000..81ff32e7 --- /dev/null +++ b/software/cdist/man/2.1.0pre7-48-gc51edff/man7/cdist-type__directory.html @@ -0,0 +1,51 @@ + + +cdist-type__directory(7)

cdist-type__directory(7)

Table of Contents

1. NAME
2. DESCRIPTION
3. REQUIRED PARAMETERS
4. OPTIONAL PARAMETERS
5. BOOLEAN PARAMETERS
6. EXAMPLES
7. SEE ALSO
8. COPYING

1. NAME

cdist-type__directory - Manage a directory

2. DESCRIPTION

This cdist type allows you to create or remove directories on the target.

3. REQUIRED PARAMETERS

None.

4. OPTIONAL PARAMETERS

+state +
+ present or absent, defaults to present +
+group +
+ Group to chgrp to. +
+mode +
+ Unix permissions, suitable for chmod. +
+owner +
+ User to chown to. +

5. BOOLEAN PARAMETERS

+parents +
+ Whether to create parents as well (mkdir -p behaviour) +
+recursive +
+ If supplied the chgrp and chown call will run recursively. + This does not influence the behaviour of chmod. +

6. EXAMPLES

# A silly example
+__directory /tmp/foobar
+
+# Remove a directory
+__directory /tmp/foobar --state absent
+
+# Ensure /etc exists correctly
+__directory /etc --owner root --group root --mode 0755
+
+# Create nfs service directory, including parents
+__directory /home/services/nfs --parents
+
+# Change permissions recursively
+__directory /home/services --recursive --owner root --group root
+
+# Setup a temp directory
+__directory /local --mode 1777
+
+# Take it all
+__directory /home/services/kvm --recursive --parents \
+    --owner root --group root --mode 0755 --state present

7. SEE ALSO

  • +cdist-type(7) +

8. COPYING

Copyright (C) 2011 Nico Schottelius. Free use of this software is +granted under the terms of the GNU General Public License version 3 (GPLv3).

diff --git a/software/cdist/man/2.1.0pre7-48-gc51edff/man7/cdist-type__file.html b/software/cdist/man/2.1.0pre7-48-gc51edff/man7/cdist-type__file.html new file mode 100644 index 00000000..ec78e56b --- /dev/null +++ b/software/cdist/man/2.1.0pre7-48-gc51edff/man7/cdist-type__file.html @@ -0,0 +1,56 @@ + + +cdist-type__file(7)

cdist-type__file(7)

Table of Contents

1. NAME
2. DESCRIPTION
3. REQUIRED PARAMETERS
4. OPTIONAL PARAMETERS
5. EXAMPLES
6. SEE ALSO
7. COPYING

1. NAME

cdist-type__file - Manage files

2. DESCRIPTION

This cdist type allows you to create files, remove files and set file +attributes on the target.

3. REQUIRED PARAMETERS

None.

4. OPTIONAL PARAMETERS

+state +
+ present, absent or exists, defaults to present + where: + present: the file is exactly the one from source + absent: the file does not exist + exists: the file from source but only if it doesn’t already exist +
+group +
+ Group to chgrp to. +
+mode +
+ Unix permissions, suitable for chmod. +
+owner +
+ User to chown to. +
+source +
+ If supplied, copy this file from the host running cdist to the target. + If not supplied, an empty file or directory will be created. + If source is - (dash), take what was written to stdin as the file content. +

5. EXAMPLES

# Create  /etc/cdist-configured as an empty file
+__file /etc/cdist-configured
+# The same thing
+__file /etc/cdist-configured --state present
+# Delete existing file
+__file /etc/cdist-configured --state absent
+
+# Use __file from another type
+__file /etc/issue --source "$__type/files/archlinux" --state present
+
+# Supply some more settings
+__file /etc/shadow --source "$__type/files/shadow" \
+   --owner root --group shadow --mode 0640 \
+   --state present
+
+# Provide a default file, but let the user change it
+__file /home/frodo/.bashrc --source "/etc/skel/.bashrc" \
+   --state exists \
+   --owner frodo --mode 0600
+
+# Take file content from stdin
+__file /tmp/whatever --owner root --group root --mode 644 --source - << DONE
+Here goes the content for /tmp/whatever
+DONE

6. SEE ALSO

  • +cdist-type(7) +

7. COPYING

Copyright (C) 2011-2012 Nico Schottelius. Free use of this software is +granted under the terms of the GNU General Public License version 3 (GPLv3).

diff --git a/software/cdist/man/2.1.0pre7-48-gc51edff/man7/cdist-type__group.html b/software/cdist/man/2.1.0pre7-48-gc51edff/man7/cdist-type__group.html new file mode 100644 index 00000000..d6682d30 --- /dev/null +++ b/software/cdist/man/2.1.0pre7-48-gc51edff/man7/cdist-type__group.html @@ -0,0 +1,21 @@ + + +cdist-type__group(7)

cdist-type__group(7)

Table of Contents

1. NAME
2. DESCRIPTION
3. REQUIRED PARAMETERS
4. OPTIONAL PARAMETERS
5. EXAMPLES
6. SEE ALSO
7. COPYING

1. NAME

cdist-type__group - Manage groups

2. DESCRIPTION

This cdist type allows you to create or modify groups on the target.

3. REQUIRED PARAMETERS

None.

4. OPTIONAL PARAMETERS

+gid +
+ see groupmod(8) +
+password +
+ see above +

5. EXAMPLES

# Create a group 'foobar' with operating system default settings
+__group foobar
+
+# Same but with a specific gid
+__group foobar --gid 1234
+
+# Same but with a gid and password
+__group foobar --gid 1234 --password 'crypted-password-string'

6. SEE ALSO

  • +cdist-type(7) +

7. COPYING

Copyright (C) 2011 Steven Armstrong. Free use of this software is +granted under the terms of the GNU General Public License version 3 (GPLv3).

diff --git a/software/cdist/man/2.1.0pre7-48-gc51edff/man7/cdist-type__issue.html b/software/cdist/man/2.1.0pre7-48-gc51edff/man7/cdist-type__issue.html new file mode 100644 index 00000000..842fff8c --- /dev/null +++ b/software/cdist/man/2.1.0pre7-48-gc51edff/man7/cdist-type__issue.html @@ -0,0 +1,13 @@ + + +cdist-type__issue(7)

cdist-type__issue(7)

Table of Contents

1. NAME
2. DESCRIPTION
3. REQUIRED PARAMETERS
4. OPTIONAL PARAMETERS
5. EXAMPLES
6. SEE ALSO
7. COPYING

1. NAME

cdist-type__issue - Manage issue

2. DESCRIPTION

This cdist type allows you to easily setup /etc/issue.

3. REQUIRED PARAMETERS

None.

4. OPTIONAL PARAMETERS

+source +
+ If supplied, use this file as /etc/issue instead of default. +

5. EXAMPLES

__issue
+
+# When called from another type
+__issue --source "$__type/files/myfancyissue"

6. SEE ALSO

  • +cdist-type(7) +

7. COPYING

Copyright (C) 2011 Nico Schottelius. Free use of this software is +granted under the terms of the GNU General Public License version 3 (GPLv3).

diff --git a/software/cdist/man/2.1.0pre7-48-gc51edff/man7/cdist-type__jail.html b/software/cdist/man/2.1.0pre7-48-gc51edff/man7/cdist-type__jail.html new file mode 100644 index 00000000..cc742e93 --- /dev/null +++ b/software/cdist/man/2.1.0pre7-48-gc51edff/man7/cdist-type__jail.html @@ -0,0 +1,81 @@ + + +cdist-type__jail(7)

cdist-type__jail(7)

Table of Contents

1. NAME
2. DESCRIPTION
3. REQUIRED PARAMETERS
4. OPTIONAL PARAMETERS
5. CAVEATS
6. EXAMPLES
7. SEE ALSO
8. COPYING

1. NAME

cdist-type__jail - Manage FreeBSD jails

2. DESCRIPTION

This type is used on FreeBSD to manage jails.

3. REQUIRED PARAMETERS

+state +
+ Either "present" or "absent." +
+jailbase +
+ The location of the .tgz archive containing the base fs for your jails. +

4. OPTIONAL PARAMETERS

+name +
+ The name of the jail. Default is to use the object_id as the jail name. +
+started +
+ Either "true" or "false." Defaults to true. +
+ip +
+ The ifconfig style IP/netmask combination to use for the jail guest. If + the state parameter is "present," this parameter is required. +
+hostname +
+ The FQDN to use for the jail guest. Defaults to the name parameter. +
+interface +
+ The name of the physical interface on the jail server to bind the jail to. + Defaults to the first interface found in the output of ifconfig -l. +
+devfs-enable +
+ Whether to allow devfs mounting within the jail. Must be "true" or "false." + Defaults to true. +
+devfs-ruleset +
+ The name of the devfs ruleset to associate with the jail. Defaults to + "jailrules." This ruleset must be copied to the server via another type. + To use this option, devfs-enable must be "true." +
+onboot +
+ Whether to add the jail to rc.conf’s jail_list variable. Must be either + "true" or "false." Defaults to false. +
+jaildir +
+ The location on the remote server to use for hosting jail filesystems. + Defaults to /usr/jail. +

5. CAVEATS

This type does not currently support modification of jail options. If, for +example a jail needs to have its IP address or netmask changed, the jail must +be removed then re-added with the correct IP address/netmask or the appropriate +line (jail_<name>_ip="…") modified within rc.conf through some alternate +means.

6. EXAMPLES

# Create a jail called www
+__jail www --state present --ip "192.168.1.2" --jailbase /my/jail/base.tgz
+
+# Remove the jail called www
+__jail www --state absent --jailbase /my/jail/base.tgz
+
+# Ensure that the jail called www is started
+__jail www --state present --started true \
+   --ip "192.168.1.2 netmask 255.255.255.0" \
+   --jailbase /my/jail/base.tgz
+
+# Use the name variable explicitly
+__jail thisjail --state present --name www \
+   --ip "192.168.1.2" \
+   --jailbase /my/jail/base.tgz
+
+# Go nuts
+__jail lotsofoptions --state present --name testjail --started true \
+   --ip "192.168.1.100 netmask 255.255.255.0" \
+   --hostname "testjail.example.com" --interface "em0" \
+   --onboot yes --jailbase /my/jail/base.tgz --jaildir /jails

7. SEE ALSO

  • +cdist-type(7) +

8. COPYING

Copyright (C) 2012 Jake Guffey. Free use of this software is +granted under the terms of the GNU General Public License version 3 (GPLv3).

diff --git a/software/cdist/man/2.1.0pre7-48-gc51edff/man7/cdist-type__key_value.html b/software/cdist/man/2.1.0pre7-48-gc51edff/man7/cdist-type__key_value.html new file mode 100644 index 00000000..3dc21025 --- /dev/null +++ b/software/cdist/man/2.1.0pre7-48-gc51edff/man7/cdist-type__key_value.html @@ -0,0 +1,40 @@ + + +cdist-type__key_value(7)

cdist-type__key_value(7)

Table of Contents

1. NAME
2. DESCRIPTION
3. REQUIRED PARAMETERS
4. OPTIONAL PARAMETERS
5. EXAMPLES
6. SEE ALSO
7. COPYING

1. NAME

cdist-type__key_value - Change property values in files

2. DESCRIPTION

This cdist type allows you to change values in a key value based config +file.

3. REQUIRED PARAMETERS

+file +
+ The file to operate on. +
+delimiter +
+ The delimiter which seperates the key from the value. +

4. OPTIONAL PARAMETERS

+state +
+ present or absent, defaults to present. If present, sets the key to value, + if absent, removes the key from the file. +
+key +
+ The key to change. Defaults to object_id. +
+value +
+ The value for the key. Optional if state=absent, required otherwise. +

5. EXAMPLES

# Set the maximum system user id
+__key_value SYS_UID_MAX --file /etc/login.defs --value 666 --delimiter ' '
+
+# Same with fancy id
+__key_value my-fancy-id --file /etc/login.defs --key SYS_UID_MAX --value 666 \
+   --delimiter ' '
+
+# Enable packet forwarding
+__key_value net.ipv4.ip_forward --file /etc/sysctl.conf --value 1 \
+   --delimiter '='
+
+# Remove existing key/value
+__key_value LEGACY_KEY --file /etc/somefile --state absent --delimiter '='

6. SEE ALSO

  • +cdist-type(7) +

7. COPYING

Copyright (C) 2011 Steven Armstrong. Free use of this software is +granted under the terms of the GNU General Public License version 3 (GPLv3).

diff --git a/software/cdist/man/2.1.0pre7-48-gc51edff/man7/cdist-type__line.html b/software/cdist/man/2.1.0pre7-48-gc51edff/man7/cdist-type__line.html new file mode 100644 index 00000000..5167dd2e --- /dev/null +++ b/software/cdist/man/2.1.0pre7-48-gc51edff/man7/cdist-type__line.html @@ -0,0 +1,38 @@ + + +cdist-type__line(7)

cdist-type__line(7)

Table of Contents

1. NAME
2. DESCRIPTION
3. REQUIRED PARAMETERS
4. OPTIONAL PARAMETERS
5. EXAMPLES
6. SEE ALSO
7. COPYING

1. NAME

cdist-type__line - Manage lines in files

2. DESCRIPTION

This cdist type allows you to add lines and remove lines from files.

3. REQUIRED PARAMETERS

4. OPTIONAL PARAMETERS

+state +
+ present or absent, defaults to present +
+line +

+ Specifies the line which should be absent or present +

Must be present, if state is present.
+Must not be combined with regex, if state is absent.
+regex +

+ If state is present, search for this pattern and add + given line, if the given regular expression does not match. +

In case of absent, ensure all lines matching the
+regular expression are absent (cannot be combined with
+the line parameter, if state is absent).
If the regular expression contains / (slashes), they need
+to be escaped with \ (backslash): / becomes \/.
+file +
+ If supplied, use this as the destination file. + Otherwise the object_id is used. +

5. EXAMPLES

# Manage the DAEMONS line in rc.conf
+__line daemons --file /etc/rc.conf --line 'DAEMONS=(hwclock !network sshd crond postfix)'
+
+# Ensure the home mount is present in /etc/fstab - explicitly make it present
+__line home-fstab \
+    --file /etc/fstab \
+    --line 'filer.fs:/vol/home /home  nfs    defaults        0 0' \
+    --state present
+
+# Removes the line specifiend in "include_www" from the file "lighttpd.conf"
+__line legacy_timezone --file /etc/rc.conf --regex 'TIMEZONE=.*' --state absent

6. SEE ALSO

  • +cdist-type(7) +

7. COPYING

Copyright (C) 2012 Nico Schottelius. Free use of this software is +granted under the terms of the GNU General Public License version 3 (GPLv3).

diff --git a/software/cdist/man/2.1.0pre7-48-gc51edff/man7/cdist-type__link.html b/software/cdist/man/2.1.0pre7-48-gc51edff/man7/cdist-type__link.html new file mode 100644 index 00000000..d84d384f --- /dev/null +++ b/software/cdist/man/2.1.0pre7-48-gc51edff/man7/cdist-type__link.html @@ -0,0 +1,31 @@ + + +cdist-type__link(7)

cdist-type__link(7)

Table of Contents

1. NAME
2. DESCRIPTION
3. REQUIRED PARAMETERS
4. OPTIONAL PARAMETERS
5. EXAMPLES
6. SEE ALSO
7. COPYING

1. NAME

cdist-type__link - Manage links (hard and symbolic)

2. DESCRIPTION

This cdist type allows you to manage hard and symbolic links. +The given object id is the destination for the link.

3. REQUIRED PARAMETERS

+source +
+ Specifies the link source. +
+type +
+ Specifies the link type: Either hard or symoblic. +

4. OPTIONAL PARAMETERS

+state +
+ present or absent, defaults to present +

5. EXAMPLES

# Create hard link of /etc/shadow
+__link /root/shadow --source /etc/shadow --type hard
+
+# Relative symbolic link
+__link /etc/apache2/sites-enabled/www.test.ch   \
+   --source ../sites-available/www.test.ch      \
+   --type symbolic
+
+# Absolute symbolic link
+__link /opt/plone --source /home/services/plone --type symbolic
+
+# Remove link
+__link /opt/plone --state absent

6. SEE ALSO

  • +cdist-type(7) +

7. COPYING

Copyright (C) 2011-2012 Nico Schottelius. Free use of this software is +granted under the terms of the GNU General Public License version 3 (GPLv3).

diff --git a/software/cdist/man/2.1.0pre7-48-gc51edff/man7/cdist-type__mkfs.html b/software/cdist/man/2.1.0pre7-48-gc51edff/man7/cdist-type__mkfs.html new file mode 100644 index 00000000..7416c00d --- /dev/null +++ b/software/cdist/man/2.1.0pre7-48-gc51edff/man7/cdist-type__mkfs.html @@ -0,0 +1,30 @@ + + +cdist-type__mkfs(7)

cdist-type__mkfs(7)

Table of Contents

1. NAME
2. DESCRIPTION
3. REQUIRED PARAMETERS
4. OPTIONAL PARAMETERS
5. EXAMPLES
6. SEE ALSO
7. COPYING

1. NAME

cdist-type__mkfs - build a linux file system

2. DESCRIPTION

This cdist type is a wrapper for the mkfs command.

3. REQUIRED PARAMETERS

+type +
+ The filesystem type to use. Same as mkfs -t. +

4. OPTIONAL PARAMETERS

+device +
+ defaults to object_id +
+options +
+ file system-specific options to be passed to the mkfs command +
+blocks +
+ the number of blocks to be used for the file system +

5. EXAMPLES

# reiserfs /dev/sda5
+__mkfs /dev/sda5 --type reiserfs
+# same thing with explicit device
+__mkfs whatever --device /dev/sda5 --type reiserfs
+
+# jfs with journal on /dev/sda2
+__mkfs /dev/sda1 --type jfs --options "-j /dev/sda2"

6. SEE ALSO

  • +cdist-type(7) +
  • +mkfs(8) +

7. COPYING

Copyright (C) 2011 Steven Armstrong. Free use of this software is +granted under the terms of the GNU General Public License version 3 (GPLv3).

diff --git a/software/cdist/man/2.1.0pre7-48-gc51edff/man7/cdist-type__motd.html b/software/cdist/man/2.1.0pre7-48-gc51edff/man7/cdist-type__motd.html new file mode 100644 index 00000000..d121ad7d --- /dev/null +++ b/software/cdist/man/2.1.0pre7-48-gc51edff/man7/cdist-type__motd.html @@ -0,0 +1,15 @@ + + +cdist-type__motd(7)

cdist-type__motd(7)

Table of Contents

1. NAME
2. DESCRIPTION
3. REQUIRED PARAMETERS
4. OPTIONAL PARAMETERS
5. EXAMPLES
6. SEE ALSO
7. COPYING

1. NAME

cdist-type__motd - Manage message of the day

2. DESCRIPTION

This cdist type allows you to easily setup /etc/motd.

3. REQUIRED PARAMETERS

None.

4. OPTIONAL PARAMETERS

+source +
+ If supplied, copy this file from the host running cdist to the target. + If not supplied, a default message will be placed onto the target. +

5. EXAMPLES

# Use cdist defaults
+__motd
+
+# Supply source file from a different type
+__motd --source "$__type/files/my-motd"

6. SEE ALSO

  • +cdist-type(7) +

7. COPYING

Copyright (C) 2011 Nico Schottelius. Free use of this software is +granted under the terms of the GNU General Public License version 3 (GPLv3).

diff --git a/software/cdist/man/2.1.0pre7-48-gc51edff/man7/cdist-type__mysql_database.html b/software/cdist/man/2.1.0pre7-48-gc51edff/man7/cdist-type__mysql_database.html new file mode 100644 index 00000000..c0217eca --- /dev/null +++ b/software/cdist/man/2.1.0pre7-48-gc51edff/man7/cdist-type__mysql_database.html @@ -0,0 +1,19 @@ + + +cdist-type__mysql_database(7)

cdist-type__mysql_database(7)

Benedikt Koeppel

Table of Contents

1. NAME
2. DESCRIPTION
3. REQUIRED PARAMETERS
4. OPTIONAL PARAMETERS
5. EXAMPLES
6. SEE ALSO
7. COPYING

1. NAME

cdist-type__mysql_database - Manage a MySQL database

2. DESCRIPTION

This cdist type allows you to install a MySQL database.

3. REQUIRED PARAMETERS

None.

4. OPTIONAL PARAMETERS

+name +
+ The name of the database to install + defaults to the object id +
+user +
+ A user that should have access to the database +
+password +
+ The password for the user who manages the database +

5. EXAMPLES

__mysql_database "cdist" --name "cdist" --user "myuser" --password "mypwd"

6. SEE ALSO

  • +cdist-type(7) +

7. COPYING

Copyright (C) 2012 Benedikt Koeppel. Free use of this software is +granted under the terms of the GNU General Public License version 3 (GPLv3).

diff --git a/software/cdist/man/2.1.0pre7-48-gc51edff/man7/cdist-type__package.html b/software/cdist/man/2.1.0pre7-48-gc51edff/man7/cdist-type__package.html new file mode 100644 index 00000000..75eba252 --- /dev/null +++ b/software/cdist/man/2.1.0pre7-48-gc51edff/man7/cdist-type__package.html @@ -0,0 +1,35 @@ + + +cdist-type__package(7)

cdist-type__package(7)

Table of Contents

1. NAME
2. DESCRIPTION
3. REQUIRED PARAMETERS
4. OPTIONAL PARAMETERS
5. EXAMPLES
6. SEE ALSO
7. COPYING

1. NAME

cdist-type__package - Manage packages

2. DESCRIPTION

This cdist type allows you to install or uninstall packages on the target. +It dispatches the actual work to the package system dependant types.

3. REQUIRED PARAMETERS

None

4. OPTIONAL PARAMETERS

+name +
+ The name of the package to install. Default is to use the object_id as the + package name. +
+version +
+ The version of the package to install. Default is to install the version + choosen by the local package manager. +
+type +
+ The package type to use. Default is determined based on the $os explorer + variable. + e.g. package_apt for Debian + package_emerge for Gentoo +
+state +
+ The state the package should be in, either "present" or "absent" +

5. EXAMPLES

# Install the package vim on the target
+__package vim --state present
+
+# Same but install specific version
+__package vim --state present --version 7.3.50
+
+# Force use of a specific package type
+__package vim --state present --type __package_apt

6. SEE ALSO

  • +cdist-type(7) +

7. COPYING

Copyright (C) 2011 Steven Armstrong. Free use of this software is +granted under the terms of the GNU General Public License version 3 (GPLv3).

diff --git a/software/cdist/man/2.1.0pre7-48-gc51edff/man7/cdist-type__package_apt.html b/software/cdist/man/2.1.0pre7-48-gc51edff/man7/cdist-type__package_apt.html new file mode 100644 index 00000000..a49ec1bb --- /dev/null +++ b/software/cdist/man/2.1.0pre7-48-gc51edff/man7/cdist-type__package_apt.html @@ -0,0 +1,24 @@ + + +cdist-type__package_apt(7)

cdist-type__package_apt(7)

Table of Contents

1. NAME
2. DESCRIPTION
3. REQUIRED PARAMETERS
4. OPTIONAL PARAMETERS
5. EXAMPLES
6. SEE ALSO
7. COPYING

1. NAME

cdist-type__package_apt - Manage packages with apt-get

2. DESCRIPTION

apt-get is usually used on Debian and variants (like Ubuntu) to +manage packages.

3. REQUIRED PARAMETERS

None

4. OPTIONAL PARAMETERS

+name +
+ If supplied, use the name and not the object id as the package name. +
+state +
+ The state the package should be in, either "present" or "absent" +

5. EXAMPLES

# Ensure zsh in installed
+__package_apt zsh --state present
+
+# In case you only want *a* webserver, but don't care which one
+__package_apt webserver --state present --name nginx
+
+# Remove obsolete package
+__package_apt puppet --state absent

6. SEE ALSO

  • +cdist-type(7) +
  • +cdist-type__package(7) +

7. COPYING

Copyright (C) 2011-2012 Nico Schottelius. Free use of this software is +granted under the terms of the GNU General Public License version 3 (GPLv3).

diff --git a/software/cdist/man/2.1.0pre7-48-gc51edff/man7/cdist-type__package_luarocks.html b/software/cdist/man/2.1.0pre7-48-gc51edff/man7/cdist-type__package_luarocks.html new file mode 100644 index 00000000..deb57b79 --- /dev/null +++ b/software/cdist/man/2.1.0pre7-48-gc51edff/man7/cdist-type__package_luarocks.html @@ -0,0 +1,20 @@ + + +cdist-type__package_luarocks(7)

cdist-type__package_luarocks(7)

Christian G. Warden

Table of Contents

1. NAME
2. DESCRIPTION
3. REQUIRED PARAMETERS
4. OPTIONAL PARAMETERS
5. EXAMPLES
6. SEE ALSO
7. COPYING

1. NAME

cdist-type__package_luarocks - Manage luarocks packages

2. DESCRIPTION

LuaRocks is a deployment and management system for Lua modules.

3. REQUIRED PARAMETERS

None

4. OPTIONAL PARAMETERS

+name +
+ If supplied, use the name and not the object id as the package name. +
+state +
+ The state the package should be in, either "present" or "absent" +

5. EXAMPLES

# Ensure luasocket is installed
+__package_luarocks luasocket --state present
+
+# Remove package
+__package_luarocks luasocket --state absent

6. SEE ALSO

  • +cdist-type(7) +
  • +cdist-type__package(7) +

7. COPYING

Copyright (C) 2012 SwellPath, Inc. Free use of this software is +granted under the terms of the GNU General Public License version 3 (GPLv3).

diff --git a/software/cdist/man/2.1.0pre7-48-gc51edff/man7/cdist-type__package_opkg.html b/software/cdist/man/2.1.0pre7-48-gc51edff/man7/cdist-type__package_opkg.html new file mode 100644 index 00000000..e9f0ac07 --- /dev/null +++ b/software/cdist/man/2.1.0pre7-48-gc51edff/man7/cdist-type__package_opkg.html @@ -0,0 +1,20 @@ + + +cdist-type__package_opkg(7)

cdist-type__package_opkg(7)

Giel van Schijndel

Table of Contents

1. NAME
2. DESCRIPTION
3. REQUIRED PARAMETERS
4. OPTIONAL PARAMETERS
5. EXAMPLES
6. SEE ALSO
7. COPYING

1. NAME

cdist-type__package_opkg - Manage packages with opkg

2. DESCRIPTION

opkg is usually used on OpenWRT to manage packages.

3. REQUIRED PARAMETERS

None

4. OPTIONAL PARAMETERS

+name +
+ If supplied, use the name and not the object id as the package name. +
+state +
+ The state the package should be in, either "present" or "absent" +

5. EXAMPLES

# Ensure lsof is installed
+__package_opkg lsof --state present
+
+# Remove obsolete package
+__package_opkg dnsmasq --state absent

6. SEE ALSO

  • +cdist-type(7) +
  • +cdist-type__package(7) +

7. COPYING

Copyright (C) 2012 Giel van Schijndel. Free use of this software is +granted under the terms of the GNU General Public License version 3 (GPLv3).

diff --git a/software/cdist/man/2.1.0pre7-48-gc51edff/man7/cdist-type__package_pacman.html b/software/cdist/man/2.1.0pre7-48-gc51edff/man7/cdist-type__package_pacman.html new file mode 100644 index 00000000..25750498 --- /dev/null +++ b/software/cdist/man/2.1.0pre7-48-gc51edff/man7/cdist-type__package_pacman.html @@ -0,0 +1,24 @@ + + +cdist-type__package_pacman(7)

cdist-type__package_pacman(7)

Table of Contents

1. NAME
2. DESCRIPTION
3. REQUIRED PARAMETERS
4. OPTIONAL PARAMETERS
5. EXAMPLES
6. SEE ALSO
7. COPYING

1. NAME

cdist-type__package_pacman - Manage packages with pacman

2. DESCRIPTION

Pacman is usually used on the Archlinux distribution to manage +packages.

3. REQUIRED PARAMETERS

None

4. OPTIONAL PARAMETERS

+name +
+ If supplied, use the name and not the object id as the package name. +
+state +
+ The state the package should be in, either "present" or "absent" +

5. EXAMPLES

# Ensure zsh in installed
+__package_pacman zsh --state present
+
+# If you don't want to follow pythonX packages, but always use python
+__package_pacman python --state present --name python2
+
+# Remove obsolete package
+__package_pacman puppet --state absent

6. SEE ALSO

  • +cdist-type(7) +
  • +cdist-type__package(7) +

7. COPYING

Copyright (C) 2011-2012 Nico Schottelius. Free use of this software is +granted under the terms of the GNU General Public License version 3 (GPLv3).

diff --git a/software/cdist/man/2.1.0pre7-48-gc51edff/man7/cdist-type__package_pip.html b/software/cdist/man/2.1.0pre7-48-gc51edff/man7/cdist-type__package_pip.html new file mode 100644 index 00000000..7d176d77 --- /dev/null +++ b/software/cdist/man/2.1.0pre7-48-gc51edff/man7/cdist-type__package_pip.html @@ -0,0 +1,25 @@ + + +cdist-type__package_pip(7)

cdist-type__package_pip(7)

Table of Contents

1. NAME
2. DESCRIPTION
3. REQUIRED PARAMETERS
4. OPTIONAL PARAMETERS
5. EXAMPLES
6. SEE ALSO
7. COPYING

1. NAME

cdist-type__package_pip - Manage packages with pip

2. DESCRIPTION

Pip is used in Python environments to install packages. +It is also included in the python virtualenv environment.

3. REQUIRED PARAMETERS

None

4. OPTIONAL PARAMETERS

+name +
+ If supplied, use the name and not the object id as the package name. +
+pip +
+ Instead of using pip from PATH, use the specific pip path. +
+state +
+ Either "present" or "absent". +

5. EXAMPLES

# Install a package
+__package_pip pyro --state present
+
+# Use pip in a virtualenv located at /root/shinken_virtualenv
+__package_pip pyro --state present --pip /root/shinken_virtualenv/bin/pip

6. SEE ALSO

  • +cdist-type(7) +
  • +cdist-type__package(7) +

7. COPYING

Copyright (C) 2012 Nico Schottelius. Free use of this software is +granted under the terms of the GNU General Public License version 3 (GPLv3).

diff --git a/software/cdist/man/2.1.0pre7-48-gc51edff/man7/cdist-type__package_pkg_freebsd.html b/software/cdist/man/2.1.0pre7-48-gc51edff/man7/cdist-type__package_pkg_freebsd.html new file mode 100644 index 00000000..d50358cc --- /dev/null +++ b/software/cdist/man/2.1.0pre7-48-gc51edff/man7/cdist-type__package_pkg_freebsd.html @@ -0,0 +1,38 @@ + + +cdist-type__package_pkg_freebsd(7)

cdist-type__package_pkg_freebsd(7)

Table of Contents

1. NAME
2. DESCRIPTION
3. REQUIRED PARAMETERS
4. OPTIONAL PARAMETERS
5. EXAMPLES
6. SEE ALSO
7. COPYING

1. NAME

cdist-type__package_pkg_freebsd - Manage FreeBSD packages

2. DESCRIPTION

This type is usually used on FreeBSD to manage packages.

3. REQUIRED PARAMETERS

None

4. OPTIONAL PARAMETERS

+name +
+ If supplied, use the name and not the object id as the package name. +
+flavor +
+ If supplied, use to avoid ambiguity. +
+version +
+ If supplied, use to install a specific version of the package named. +
+pkgsite +
+ If supplied, use to install from a specific package repository. +
+state +
+ Either "present" or "absent". +

5. EXAMPLES

# Ensure zsh is installed
+__package_pkg_freebsd zsh --state present
+
+# Ensure vim is installed, use flavor no_x11
+__package_pkg_freebsd vim --state present --flavor no_x11
+
+# If you don't want to follow pythonX packages, but always use python
+__package_pkg_freebsd python --state present --name python2
+
+# Remove obsolete package
+__package_pkg_freebsd puppet --state absent

6. SEE ALSO

  • +cdist-type(7) +
  • +cdist-type__package(7) +

7. COPYING

Copyright (C) 2012 Jake Guffey. Free use of this software is +granted under the terms of the GNU General Public License version 3 (GPLv3).

diff --git a/software/cdist/man/2.1.0pre7-48-gc51edff/man7/cdist-type__package_pkg_openbsd.html b/software/cdist/man/2.1.0pre7-48-gc51edff/man7/cdist-type__package_pkg_openbsd.html new file mode 100644 index 00000000..d0b512d9 --- /dev/null +++ b/software/cdist/man/2.1.0pre7-48-gc51edff/man7/cdist-type__package_pkg_openbsd.html @@ -0,0 +1,30 @@ + + +cdist-type__package_pkg(7)

cdist-type__package_pkg(7)

Andi Brönnimann

Table of Contents

1. NAME
2. DESCRIPTION
3. REQUIRED PARAMETERS
4. OPTIONAL PARAMETERS
5. EXAMPLES
6. SEE ALSO
7. COPYING

1. NAME

cdist-type__package_pkg_openbsd - Manage OpenBSD packages

2. DESCRIPTION

This type is usually used on OpenBSD to manage packages.

3. REQUIRED PARAMETERS

None

4. OPTIONAL PARAMETERS

+name +
+ If supplied, use the name and not the object id as the package name. +
+flavor +
+ If supplied, use to avoid ambiguity. +
+state +
+ The state the package should be in, either "present" or "absent" +

5. EXAMPLES

# Ensure zsh is installed
+__package_pkg_openbsd zsh --state present
+
+# Ensure vim is installed, use flavor no_x11
+__package_pkg_openbsd vim --state present --flavor no_x11
+
+# If you don't want to follow pythonX packages, but always use python
+__package_pkg_openbsd python --state present --name python2
+
+# Remove obsolete package
+__package_pkg_openbsd puppet --state absent

6. SEE ALSO

  • +cdist-type(7) +
  • +cdist-type__package(7) +

7. COPYING

Copyright (C) 2011 Andi Brönnimann. Free use of this software is +granted under the terms of the GNU General Public License version 3 (GPLv3).

diff --git a/software/cdist/man/2.1.0pre7-48-gc51edff/man7/cdist-type__package_rubygem.html b/software/cdist/man/2.1.0pre7-48-gc51edff/man7/cdist-type__package_rubygem.html new file mode 100644 index 00000000..37c24e77 --- /dev/null +++ b/software/cdist/man/2.1.0pre7-48-gc51edff/man7/cdist-type__package_rubygem.html @@ -0,0 +1,20 @@ + + +cdist-type__package_rubygem(7)

cdist-type__package_rubygem(7)

Chase Allen James

Table of Contents

1. NAME
2. DESCRIPTION
3. REQUIRED PARAMETERS
4. OPTIONAL PARAMETERS
5. EXAMPLES
6. SEE ALSO
7. COPYING

1. NAME

cdist-type__package_rubygem - Manage rubygem packages

2. DESCRIPTION

Rubygems is the default package management system for the Ruby programming language.

3. REQUIRED PARAMETERS

None

4. OPTIONAL PARAMETERS

+name +
+ If supplied, use the name and not the object id as the package name. +
+state +
+ The state the package should be in, either "present" or "absent" +

5. EXAMPLES

# Ensure sinatra is installed
+__package_rubygem sinatra --state present
+
+# Remove package
+__package_rubygem rails --state absent

6. SEE ALSO

  • +cdist-type(7) +
  • +cdist-type__package(7) +

7. COPYING

Copyright (C) 2011 Chase Allen James. Free use of this software is +granted under the terms of the GNU General Public License version 3 (GPLv3).

diff --git a/software/cdist/man/2.1.0pre7-48-gc51edff/man7/cdist-type__package_yum.html b/software/cdist/man/2.1.0pre7-48-gc51edff/man7/cdist-type__package_yum.html new file mode 100644 index 00000000..affbe627 --- /dev/null +++ b/software/cdist/man/2.1.0pre7-48-gc51edff/man7/cdist-type__package_yum.html @@ -0,0 +1,26 @@ + + +cdist-type__package_yum(7)

cdist-type__package_yum(7)

Table of Contents

1. NAME
2. DESCRIPTION
3. REQUIRED PARAMETERS
4. OPTIONAL PARAMETERS
5. EXAMPLES
6. SEE ALSO
7. COPYING

1. NAME

cdist-type__package_yum - Manage packages with yum

2. DESCRIPTION

Yum is usually used on the Fedora distribution to manage packages. +If you specify an unknown package, yum will display the +slightly confusing error message "Error: Nothing to do".

3. REQUIRED PARAMETERS

None

4. OPTIONAL PARAMETERS

+name +
+ If supplied, use the name and not the object id as the package name. +
+state +
+ The state the package should be in, either "present" or "absent" + (the old values "installed" or "removed" will be removed in cdist 2.1). +

5. EXAMPLES

# Ensure zsh in installed
+__package_yum zsh --state present
+
+# If you don't want to follow pythonX packages, but always use python
+__package_yum python --state present --name python2
+
+# Remove obsolete package
+__package_yum puppet --state absent

6. SEE ALSO

  • +cdist-type(7) +
  • +cdist-type__package(7) +

7. COPYING

Copyright (C) 2011-2012 Nico Schottelius. Free use of this software is +granted under the terms of the GNU General Public License version 3 (GPLv3).

diff --git a/software/cdist/man/2.1.0pre7-48-gc51edff/man7/cdist-type__package_zypper.html b/software/cdist/man/2.1.0pre7-48-gc51edff/man7/cdist-type__package_zypper.html new file mode 100644 index 00000000..b441c270 --- /dev/null +++ b/software/cdist/man/2.1.0pre7-48-gc51edff/man7/cdist-type__package_zypper.html @@ -0,0 +1,23 @@ + + +cdist-type__package_zypper(7)

cdist-type__package_zypper(7)

Table of Contents

1. NAME
2. DESCRIPTION
3. REQUIRED PARAMETERS
4. OPTIONAL PARAMETERS
5. EXAMPLES
6. SEE ALSO
7. COPYING

1. NAME

cdist-type__package_zypper - Manage packages with zypper

2. DESCRIPTION

Zypper is usually used on the SuSE distribution to manage packages.

3. REQUIRED PARAMETERS

None

4. OPTIONAL PARAMETERS

+name +
+ If supplied, use the name and not the object id as the package name. +
+state +
+ The state the package should be in, either "present" or "absent" +

5. EXAMPLES

# Ensure zsh in installed
+__package_zypper zsh --state present
+
+# If you don't want to follow pythonX packages, but always use python
+__package_zypper python --state present --name python2
+
+# Remove package
+__package_zypper cfengine --state absent

6. SEE ALSO

  • +cdist-type(7) +
  • +cdist-type__package(7) +

7. COPYING

Copyright (C) 2012 Nico Schottelius. Free use of this software is +granted under the terms of the GNU General Public License version 3 (GPLv3).

diff --git a/software/cdist/man/2.1.0pre7-48-gc51edff/man7/cdist-type__partition_msdos.html b/software/cdist/man/2.1.0pre7-48-gc51edff/man7/cdist-type__partition_msdos.html new file mode 100644 index 00000000..5148f272 --- /dev/null +++ b/software/cdist/man/2.1.0pre7-48-gc51edff/man7/cdist-type__partition_msdos.html @@ -0,0 +1,36 @@ + + +cdist-type__partition_msdos(7)

cdist-type__partition_msdos(7)

Table of Contents

1. NAME
2. DESCRIPTION
3. REQUIRED PARAMETERS
4. OPTIONAL PARAMETERS
5. EXAMPLES
6. SEE ALSO
7. COPYING

1. NAME

cdist-type__partition_msdos - creates msdos partitions

2. DESCRIPTION

This cdist type allows you to create msdos paritions.

3. REQUIRED PARAMETERS

+type +
+ the partition type used in fdisk (such as 82 or 83) or "extended" +

4. OPTIONAL PARAMETERS

+partition +
+ defaults to object_id +
+bootable +
+ mark partition as bootable, true or false, defaults to false +
+size +
+ the size of the partition (such as 32M or 15G, whole numbers + only), + for remaining space, or n% for percentage of remaining + (these should only be used after all specific partition sizes are + specified). Defaults to +. +

5. EXAMPLES

# 128MB, linux, bootable
+__partition_msdos /dev/sda1 --type 83 --size 128M --bootable true
+# 512MB, swap
+__partition_msdos /dev/sda2 --type 82 --size 512M
+# 100GB, extended
+__partition_msdos /dev/sda3 --type extended --size 100G
+# 10GB, linux
+__partition_msdos /dev/sda5 --type 83 --size 10G
+# 50% of the free space of the extended partition, linux
+__partition_msdos /dev/sda6 --type 83 --size 50%
+# rest of the extended partition, linux
+__partition_msdos /dev/sda7 --type 83 --size +

6. SEE ALSO

  • +cdist-type(7) +

7. COPYING

Copyright (C) 2011 Steven Armstrong. Free use of this software is +granted under the terms of the GNU General Public License version 3 (GPLv3).

diff --git a/software/cdist/man/2.1.0pre7-48-gc51edff/man7/cdist-type__partition_msdos_apply.html b/software/cdist/man/2.1.0pre7-48-gc51edff/man7/cdist-type__partition_msdos_apply.html new file mode 100644 index 00000000..c61f631c --- /dev/null +++ b/software/cdist/man/2.1.0pre7-48-gc51edff/man7/cdist-type__partition_msdos_apply.html @@ -0,0 +1,8 @@ + + +cdist-type__partition_msdos_apply(7)

cdist-type__partition_msdos_apply(7)

Table of Contents

1. NAME
2. DESCRIPTION
3. REQUIRED PARAMETERS
4. OPTIONAL PARAMETERS
5. EXAMPLES
6. SEE ALSO
7. COPYING

1. NAME

cdist-type__partition_msdos_apply - Apply dos partition settings

2. DESCRIPTION

Create the partitions defined with __partition_msdos

3. REQUIRED PARAMETERS

None

4. OPTIONAL PARAMETERS

None.

5. EXAMPLES

__partition_msdos_apply

6. SEE ALSO

  • +cdist-type(7) +
  • +cdist-type__partition_msdos_apply(7) +

7. COPYING

Copyright (C) 2011 Steven Armstrong. Free use of this software is +granted under the terms of the GNU General Public License version 3 (GPLv3).

diff --git a/software/cdist/man/2.1.0pre7-48-gc51edff/man7/cdist-type__pf_apply.html b/software/cdist/man/2.1.0pre7-48-gc51edff/man7/cdist-type__pf_apply.html new file mode 100644 index 00000000..b2bf348d --- /dev/null +++ b/software/cdist/man/2.1.0pre7-48-gc51edff/man7/cdist-type__pf_apply.html @@ -0,0 +1,18 @@ + + +cdist-type__pf_apply(7)

cdist-type__pf_apply(7)

Table of Contents

1. NAME
2. DESCRIPTION
3. REQUIRED PARAMETERS
4. OPTIONAL PARAMETERS
5. EXAMPLES
6. SEE ALSO
7. COPYING

1. NAME

cdist-type__pf_apply - Apply pf(4) ruleset on *BSD

2. DESCRIPTION

This type is used on *BSD systems to manage the pf firewall’s active ruleset.

3. REQUIRED PARAMETERS

NONE

4. OPTIONAL PARAMETERS

NONE

5. EXAMPLES

# Modify the ruleset on $__target_host:
+__pf_ruleset --state present --source /my/pf/ruleset.conf
+require="__pf_ruleset" \
+   __pf_apply
+
+# Remove the ruleset on $__target_host (implies disabling pf(4):
+__pf_ruleset --state absent
+require="__pf_ruleset" \
+   __pf_apply

6. SEE ALSO

  • +cdist-type(7) +
  • +cdist-type__pf_ruleset(7) +
  • +pf(4) +

7. COPYING

Copyright (C) 2012 Jake Guffey. Free use of this software is +granted under the terms of the GNU General Public License version 3 (GPLv3).

diff --git a/software/cdist/man/2.1.0pre7-48-gc51edff/man7/cdist-type__pf_ruleset.html b/software/cdist/man/2.1.0pre7-48-gc51edff/man7/cdist-type__pf_ruleset.html new file mode 100644 index 00000000..106cee56 --- /dev/null +++ b/software/cdist/man/2.1.0pre7-48-gc51edff/man7/cdist-type__pf_ruleset.html @@ -0,0 +1,22 @@ + + +cdist-type__pf_ruleset(7)

cdist-type__pf_ruleset(7)

Table of Contents

1. NAME
2. DESCRIPTION
3. REQUIRED PARAMETERS
4. OPTIONAL PARAMETERS
5. EXAMPLES
6. SEE ALSO
7. COPYING

1. NAME

cdist-typepf_ruleset - Copy a pf(4) ruleset to $target_host

2. DESCRIPTION

This type is used on *BSD systems to manage the pf firewall’s ruleset.

3. REQUIRED PARAMETERS

+state +
+ Either "absent" (no ruleset at all) or "present" +

4. OPTIONAL PARAMETERS

+source +
+ If supplied, use to define the ruleset to load onto the $__target_host for pf(4). + Note that this type is almost useless without a ruleset defined, but it’s technically not + needed, e.g. for the case of disabling the firewall temporarily. +

5. EXAMPLES

# Remove the current ruleset in place
+__pf_ruleset --state absent
+
+# Enable the firewall with the ruleset defined in $__manifest/files/pf.conf
+__pf_ruleset --state present --source $__manifest/files/pf.conf

6. SEE ALSO

  • +cdist-type(7) +
  • +pf(4) +

7. COPYING

Copyright (C) 2012 Jake Guffey. Free use of this software is +granted under the terms of the GNU General Public License version 3 (GPLv3).

diff --git a/software/cdist/man/2.1.0pre7-48-gc51edff/man7/cdist-type__postgres_database.html b/software/cdist/man/2.1.0pre7-48-gc51edff/man7/cdist-type__postgres_database.html new file mode 100644 index 00000000..feee96b2 --- /dev/null +++ b/software/cdist/man/2.1.0pre7-48-gc51edff/man7/cdist-type__postgres_database.html @@ -0,0 +1,16 @@ + + +cdist-type__postgres_database(7)

cdist-type__postgres_database(7)

Table of Contents

1. NAME
2. DESCRIPTION
3. REQUIRED PARAMETERS
4. OPTIONAL PARAMETERS
5. EXAMPLES
6. SEE ALSO
7. COPYING

1. NAME

cdist-type__postgres_database - create/drop postgres databases

2. DESCRIPTION

This cdist type allows you to create or drop postgres databases.

3. REQUIRED PARAMETERS

+state +
+ either present or absent +

4. OPTIONAL PARAMETERS

+owner +
+ the role owning this database +

5. EXAMPLES

__postgres_database mydbname --state present --owner mydbusername

6. SEE ALSO

  • +cdist-type(7) +
  • +cdist-type__postgres_role(7) +

7. COPYING

Copyright (C) 2011 Steven Armstrong. Free use of this software is +granted under the terms of the GNU General Public License version 3 (GPLv3).

diff --git a/software/cdist/man/2.1.0pre7-48-gc51edff/man7/cdist-type__postgres_role.html b/software/cdist/man/2.1.0pre7-48-gc51edff/man7/cdist-type__postgres_role.html new file mode 100644 index 00000000..c2cf7094 --- /dev/null +++ b/software/cdist/man/2.1.0pre7-48-gc51edff/man7/cdist-type__postgres_role.html @@ -0,0 +1,34 @@ + + +cdist-type__postgres_role(7)

cdist-type__postgres_role(7)

Table of Contents

1. NAME
2. DESCRIPTION
3. REQUIRED PARAMETERS
4. OPTIONAL PARAMETERS
5. SEE ALSO
6. COPYING

1. NAME

cdist-type__postgres_role - manage postgres roles

2. DESCRIPTION

This cdist type allows you to create or drop postgres roles.

3. REQUIRED PARAMETERS

+state +
+ either present or absent +

4. OPTIONAL PARAMETERS

All parameter map directly to the corresponding postgres createrole +parameters.

+password +
+BOOLEAN PARAMETERS +
All parameter map directly to the corresponding postgres createrole
+parameters.
+
+login::
+createdb::
+createrole::
+superuser::
+inherit::
+
+EXAMPLES
__postgres_role myrole --state present
+
+__postgres_role myrole --state present --password 'secret'
+
+__postgres_role admin --state present --password 'very-secret' --superuser
+
+__postgres_role dbcustomer --state present --password 'bla' --createdb

5. SEE ALSO

6. COPYING

Copyright (C) 2011 Steven Armstrong. Free use of this software is +granted under the terms of the GNU General Public License version 3 (GPLv3).

diff --git a/software/cdist/man/2.1.0pre7-48-gc51edff/man7/cdist-type__process.html b/software/cdist/man/2.1.0pre7-48-gc51edff/man7/cdist-type__process.html new file mode 100644 index 00000000..8929b98b --- /dev/null +++ b/software/cdist/man/2.1.0pre7-48-gc51edff/man7/cdist-type__process.html @@ -0,0 +1,44 @@ + + +cdist-type__process(7)

cdist-type__process(7)

Table of Contents

1. NAME
2. DESCRIPTION
3. REQUIRED PARAMETERS
4. OPTIONAL PARAMETERS
5. EXAMPLES
6. SEE ALSO
7. COPYING

1. NAME

cdist-type__process - Start or stop process

2. DESCRIPTION

This cdist type allows you to define the state of a process.

3. REQUIRED PARAMETERS

+state +
+ State of the process: Either present or absent + (old values "stopped" and "running" are deprecated and will be removed in + cdist 2.1). +

4. OPTIONAL PARAMETERS

+name +

+ Process name to match on when using pgrep -f -x. +

This is useful, if the name starts with a "/",
+because the leading slash is stripped away from
+the object id by cdist.
+stop +
+ Executable to use for stopping the process. +
+start +
+ Executable to use for starting the process. +

5. EXAMPLES

# Start if not running
+__process /usr/sbin/syslog-ng --state present
+
+# Start if not running with a different binary
+__process /usr/sbin/nginx --state present --start "/etc/rc.d/nginx start"
+
+# Stop the process using kill (the type default) - DO NOT USE THIS
+__process /usr/sbin/sshd --state absent
+
+# Stop the process using /etc/rc.d/sshd stop - THIS ONE NOT AS WELL
+__process /usr/sbin/sshd --state absent --stop "/etc/rc.d/sshd stop"
+
+# Ensure cups is running, which runs with -C ...:
+__process cups --start "/etc/rc.d/cups start" --state present \
+   --name "/usr/sbin/cupsd -C /etc/cups/cupsd.conf"
+
+# Ensure rpc.statd is running (which usually runs with -L) using a regexp
+__process rpcstatd --state present --start "/etc/init.d/statd start" \
+    --name "rpc.statd.*"

6. SEE ALSO

  • +cdist-type(7) +

7. COPYING

Copyright (C) 2011-2012 Nico Schottelius. Free use of this software is +granted under the terms of the GNU General Public License version 3 (GPLv3).

diff --git a/software/cdist/man/2.1.0pre7-48-gc51edff/man7/cdist-type__qemu_img.html b/software/cdist/man/2.1.0pre7-48-gc51edff/man7/cdist-type__qemu_img.html new file mode 100644 index 00000000..bc9cf227 --- /dev/null +++ b/software/cdist/man/2.1.0pre7-48-gc51edff/man7/cdist-type__qemu_img.html @@ -0,0 +1,21 @@ + + +cdist-type__qemu_img(7)

cdist-type__qemu_img(7)

Table of Contents

1. NAME
2. DESCRIPTION
3. REQUIRED PARAMETERS
4. OPTIONAL PARAMETERS
5. EXAMPLES
6. SEE ALSO
7. COPYING

1. NAME

cdist-type__qemu_img - Manage VM disk images

2. DESCRIPTION

The qemu-img program is used to create qemu images for +qemu and (qemu-)kvm.

3. REQUIRED PARAMETERS

+size +
+ Size of the image in qemu-img compatible units. + See qemu-img(1). +

4. OPTIONAL PARAMETERS

+state +
+ The state of the image file: either "present" or "absent". + Defaults to "present". +

5. EXAMPLES

# Create a 50G size image
+__qemu_img /home/services/kvm/vm/myvmname/system-disk --size 50G
+
+# Remove image
+__qemu_img /home/services/kvm/vm/myoldvm/system-disk --state absent

6. SEE ALSO

  • +cdist-type(7) +

7. COPYING

Copyright (C) 2012 Nico Schottelius. Free use of this software is +granted under the terms of the GNU General Public License version 3 (GPLv3).

diff --git a/software/cdist/man/2.1.0pre7-48-gc51edff/man7/cdist-type__rvm.html b/software/cdist/man/2.1.0pre7-48-gc51edff/man7/cdist-type__rvm.html new file mode 100644 index 00000000..388ec29f --- /dev/null +++ b/software/cdist/man/2.1.0pre7-48-gc51edff/man7/cdist-type__rvm.html @@ -0,0 +1,20 @@ + + +cdist-type__rvm(7)

cdist-type__rvm(7)

Evax Software

Table of Contents

1. NAME
2. DESCRIPTION
3. REQUIRED PARAMETERS
4. EXAMPLES
5. SEE ALSO
6. COPYING

1. NAME

cdist-type__rvm - Install rvm for a given user

2. DESCRIPTION

RVM is the Ruby enVironment Manager for the Ruby programming language.

3. REQUIRED PARAMETERS

+state +
+ Either "present" or "absent". +

4. EXAMPLES

# Install rvm for user billie
+__rvm billie --state present
+
+# Remove rvm
+__rvm billie --state absent

5. SEE ALSO

  • +cdist-type(7) +
  • +cdist-type__rvm_ruby(7) +
  • +cdist-type__rvm_gemset(7) +
  • +cdist-type__rvm_gem(7) +

6. COPYING

Copyright (C) 2012 Evax Software. Free use of this software is granted under +the terms of the GNU General Public License version 3 (GPLv3).

diff --git a/software/cdist/man/2.1.0pre7-48-gc51edff/man7/cdist-type__rvm_gem.html b/software/cdist/man/2.1.0pre7-48-gc51edff/man7/cdist-type__rvm_gem.html new file mode 100644 index 00000000..45b31c59 --- /dev/null +++ b/software/cdist/man/2.1.0pre7-48-gc51edff/man7/cdist-type__rvm_gem.html @@ -0,0 +1,36 @@ + + +cdist-type__rvm_gemset(7)

cdist-type__rvm_gemset(7)

Evax Software

Table of Contents

1. NAME
2. DESCRIPTION
3. REQUIRED PARAMETERS
4. OPTIONAL PARAMETERS
5. EXAMPLES
6. SEE ALSO
7. COPYING

1. NAME

cdist-type__rvm_gem - Manage Ruby gems through rvm

2. DESCRIPTION

RVM is the Ruby enVironment Manager for the Ruby programming language.

3. REQUIRED PARAMETERS

+user +
+ The remote user account to use +
+gemset +
+ The gemset to use +
+state +
+ Either "present" or "absent". +

4. OPTIONAL PARAMETERS

+default +
+ Make the selected gemset the default +

5. EXAMPLES

# Install the rails gem in gemset ruby-1.9.3-p0@myset for user bill
+__rvm_gemset rails --gemset ruby-1.9.3-p0@myset --user bill --state present
+
+# Do the same and also make ruby-1.9.3-p0@myset the default gemset
+__rvm_gemset rails --gemset ruby-1.9.3-p0@myset --user bill \
+                   --state present --default yes
+
+# Remove it
+__rvm_ruby rails --gemset ruby-1.9.3-p0@myset --user bill --state absent

6. SEE ALSO

  • +cdist-type(7) +
  • +cdist-type__rvm(7) +
  • +cdist-type__rvm_ruby(7) +
  • +cdist-type__rvm_gemset(7) +

7. COPYING

Copyright (C) 2012 Evax Software. Free use of this software is granted under +the terms of the GNU General Public License version 3 (GPLv3).

diff --git a/software/cdist/man/2.1.0pre7-48-gc51edff/man7/cdist-type__rvm_gemset.html b/software/cdist/man/2.1.0pre7-48-gc51edff/man7/cdist-type__rvm_gemset.html new file mode 100644 index 00000000..9bd52487 --- /dev/null +++ b/software/cdist/man/2.1.0pre7-48-gc51edff/man7/cdist-type__rvm_gemset.html @@ -0,0 +1,31 @@ + + +cdist-type__rvm_gemset(7)

cdist-type__rvm_gemset(7)

Evax Software

Table of Contents

1. NAME
2. DESCRIPTION
3. REQUIRED PARAMETERS
4. OPTIONAL PARAMETERS
5. EXAMPLES
6. SEE ALSO
7. COPYING

1. NAME

cdist-type__rvm_gemset - Manage gemsets through rvm

2. DESCRIPTION

RVM is the Ruby enVironment Manager for the Ruby programming language.

3. REQUIRED PARAMETERS

+user +
+ The remote user account to use +
+state +
+ Either "present" or "absent". +

4. OPTIONAL PARAMETERS

+default +
+ If set to anything but "no" (the default), set the given gemset as default. +

5. EXAMPLES

# Install the gemset @myset for user charles on based on ruby-1.9.3-0
+__rvm_gemset ruby-1.9.3-p0@myset --user charles --state present
+
+# Do the same and make ruby-1.9.3-p0@myset the default gemset
+__rvm_gemset ruby-1.9.3-p0@myset --user charles --state present --default yes
+
+# Remove the gemset @myset for user john
+__rvm_ruby ruby-1.9.3-p0@myset --user john --state absent

6. SEE ALSO

  • +cdist-type(7) +
  • +cdist-type__rvm(7) +
  • +cdist-type__rvm_ruby(7) +
  • +cdist-type__rvm_gem(7) +

7. COPYING

Copyright (C) 2012 Evax Software. Free use of this software is granted under +the terms of the GNU General Public License version 3 (GPLv3).

diff --git a/software/cdist/man/2.1.0pre7-48-gc51edff/man7/cdist-type__rvm_ruby.html b/software/cdist/man/2.1.0pre7-48-gc51edff/man7/cdist-type__rvm_ruby.html new file mode 100644 index 00000000..f11ff0b9 --- /dev/null +++ b/software/cdist/man/2.1.0pre7-48-gc51edff/man7/cdist-type__rvm_ruby.html @@ -0,0 +1,28 @@ + + +cdist-type__rvm_ruby(7)

cdist-type__rvm_ruby(7)

Evax Software

Table of Contents

1. NAME
2. DESCRIPTION
3. REQUIRED PARAMETERS
4. OPTIONAL PARAMETERS
5. EXAMPLES
6. SEE ALSO
7. COPYING

1. NAME

cdist-type__rvm_ruby - Manage ruby installations through rvm

2. DESCRIPTION

RVM is the Ruby enVironment Manager for the Ruby programming language.

3. REQUIRED PARAMETERS

+user +
+ The remote user account to use +
+state +
+ Either "present" or "absent". +

4. OPTIONAL PARAMETERS

default: + If set to anything but "no" (the default), set the given version as default

5. EXAMPLES

# Install ruby 1.9.3 through rvm for user thelonious
+__rvm_ruby ruby-1.9.3-p0 --user thelonious --state present
+
+# Install ruby 1.9.3 through rvm for user ornette and make it the default
+__rvm_ruby ruby-1.9.3-p0 --user ornette --state present --default yes
+
+# Remove ruby 1.9.3 for user john
+__rvm_ruby ruby-1.9.3-p0 --user john --state absent

6. SEE ALSO

  • +cdist-type(7) +
  • +cdist-type__rvm(7) +
  • +cdist-type__rvm_gemset(7) +
  • +cdist-type__rvm_gem(7) +

7. COPYING

Copyright (C) 2012 Evax Software. Free use of this software is granted under +the terms of the GNU General Public License version 3 (GPLv3).

diff --git a/software/cdist/man/2.1.0pre7-48-gc51edff/man7/cdist-type__ssh_authorized_key.html b/software/cdist/man/2.1.0pre7-48-gc51edff/man7/cdist-type__ssh_authorized_key.html new file mode 100644 index 00000000..2db82330 --- /dev/null +++ b/software/cdist/man/2.1.0pre7-48-gc51edff/man7/cdist-type__ssh_authorized_key.html @@ -0,0 +1,17 @@ + + +cdist-type__ssh_authorized_key(7)

cdist-type__ssh_authorized_key(7)

Table of Contents

1. NAME
2. DESCRIPTION
3. REQUIRED PARAMETERS
4. OPTIONAL PARAMETERS
5. EXAMPLES
6. SEE ALSO
7. COPYING

1. NAME

cdist-type__ssh_authorized_key - Sends a user’s public key to another user’s authorized_keys

2. DESCRIPTION

This type sends a rsa key. By default uses root’s key and sends it to root’s authorized_keys

3. REQUIRED PARAMETERS

None.

4. OPTIONAL PARAMETERS

+srcuser +
+the user to take the rsa public key from +
+dstuser +
+the user to give the rsa public key to +

5. EXAMPLES

#deploy root's public key
+__ssh_authorized_key admin
+#deploy bob's public key to alice's authorized_keys
+__ssh_authorized_key --srcuser bob --dstuser alice

6. SEE ALSO

  • +cdist-type(7) +

7. COPYING

Free use of this software is +granted under the terms of the GNU General Public License version 3 (GPLv3).

diff --git a/software/cdist/man/2.1.0pre7-48-gc51edff/man7/cdist-type__start_on_boot.html b/software/cdist/man/2.1.0pre7-48-gc51edff/man7/cdist-type__start_on_boot.html new file mode 100644 index 00000000..9937cd9d --- /dev/null +++ b/software/cdist/man/2.1.0pre7-48-gc51edff/man7/cdist-type__start_on_boot.html @@ -0,0 +1,19 @@ + + +cdist-type__start_on_boot(7)

cdist-type__start_on_boot(7)

Table of Contents

1. NAME
2. DESCRIPTION
3. REQUIRED PARAMETERS
4. OPTIONAL PARAMETERS
5. EXAMPLES
6. SEE ALSO
7. COPYING

1. NAME

cdist-type__start_on_boot - Manage stuff to be started at boot

2. DESCRIPTION

This cdist type allows you to enable or disable stuff to be started +at boot of your operating system.

Warning: This type has not been tested intensively and is not fully +supported (i.e. gentoo and *bsd are not implemented).

3. REQUIRED PARAMETERS

None.

4. OPTIONAL PARAMETERS

+state +
+ present or absent, defaults to present +

5. EXAMPLES

# Ensure snmpd is started at boot
+__start_on_boot snmpd
+
+# Same, but more explicit
+__start_on_boot snmpd --state present
+
+# Ensure legacy configuration management will not be started
+__start_on_boot puppet --state absent

6. SEE ALSO

  • +cdist-type(7) +

7. COPYING

Copyright (C) 2012 Nico Schottelius. Free use of this software is +granted under the terms of the GNU General Public License version 3 (GPLv3).

diff --git a/software/cdist/man/2.1.0pre7-48-gc51edff/man7/cdist-type__timezone.html b/software/cdist/man/2.1.0pre7-48-gc51edff/man7/cdist-type__timezone.html new file mode 100644 index 00000000..37e1d9ff --- /dev/null +++ b/software/cdist/man/2.1.0pre7-48-gc51edff/man7/cdist-type__timezone.html @@ -0,0 +1,11 @@ + + +cdist-type__timezone(7)

cdist-type__timezone(7)

Table of Contents

1. NAME
2. DESCRIPTION
3. REQUIRED PARAMETERS
4. OPTIONAL PARAMETERS
5. EXAMPLES
6. SEE ALSO
7. COPYING

1. NAME

cdist-type__timezone - Allows to configure the desired localtime timezone.

2. DESCRIPTION

This type creates a symlink (/etc/localtime) to the selected timezone +(which should be available in /usr/share/zoneinfo).

3. REQUIRED PARAMETERS

None.

4. OPTIONAL PARAMETERS

None.

5. EXAMPLES

#Set up Europe/Andorra as our timezone.
+__timezone Europe/Andorra
+
+#Set up US/Central as our timezone.
+__timezone US/Central

6. SEE ALSO

  • +cdist-type(7) +

7. COPYING

Free use of this software is +granted under the terms of the GNU General Public License version 3 (GPLv3).

diff --git a/software/cdist/man/2.1.0pre7-48-gc51edff/man7/cdist-type__user.html b/software/cdist/man/2.1.0pre7-48-gc51edff/man7/cdist-type__user.html new file mode 100644 index 00000000..0e90480b --- /dev/null +++ b/software/cdist/man/2.1.0pre7-48-gc51edff/man7/cdist-type__user.html @@ -0,0 +1,41 @@ + + +cdist-type__user(7)

cdist-type__user(7)

Table of Contents

1. NAME
2. DESCRIPTION
3. REQUIRED PARAMETERS
4. OPTIONAL PARAMETERS
5. EXAMPLES
6. SEE ALSO
7. COPYING

1. NAME

cdist-type__user - Manage users

2. DESCRIPTION

This cdist type allows you to create or modify users on the target.

3. REQUIRED PARAMETERS

None.

4. OPTIONAL PARAMETERS

+comment +
+ see usermod(8) +
+home +
+ see above +
+gid +
+ see above +
+groups +
+ see above +
+password +
+ see above +
+shell +
+ see above +
+uid +
+ see above +

5. EXAMPLES

# Create user account for foobar with operating system default settings
+__user foobar
+
+# Same but with a different shell
+__user foobar --shell /bin/zsh
+
+# Set explicit uid and home
+__user foobar --uid 1001 --shell /bin/zsh --home /home/foobar

6. SEE ALSO

  • +cdist-type(7) +

7. COPYING

Copyright (C) 2011 Steven Armstrong. Free use of this software is +granted under the terms of the GNU General Public License version 3 (GPLv3).

diff --git a/software/cdist/man/2.1.0pre7-48-gc51edff/man7/docbook-xsl.css b/software/cdist/man/2.1.0pre7-48-gc51edff/man7/docbook-xsl.css new file mode 100644 index 00000000..28412259 --- /dev/null +++ b/software/cdist/man/2.1.0pre7-48-gc51edff/man7/docbook-xsl.css @@ -0,0 +1,314 @@ +/* + CSS stylesheet for XHTML produced by DocBook XSL stylesheets. + Tested with XSL stylesheets 1.61.2, 1.67.2 +*/ + +span.strong { + font-weight: bold; +} + +body blockquote { + margin-top: .75em; + line-height: 1.5; + margin-bottom: .75em; +} + +html body { + margin: 1em 5% 1em 5%; + line-height: 1.2; +} + +body div { + margin: 0; +} + +h1, h2, h3, h4, h5, h6 +{ + color: #527bbd; + font-family: tahoma, verdana, sans-serif; +} + +div.toc p:first-child, +div.list-of-figures p:first-child, +div.list-of-tables p:first-child, +div.list-of-examples p:first-child, +div.example p.title, +div.sidebar p.title +{ + font-weight: bold; + color: #527bbd; + font-family: tahoma, verdana, sans-serif; + margin-bottom: 0.2em; +} + +body h1 { + margin: .0em 0 0 -4%; + line-height: 1.3; + border-bottom: 2px solid silver; +} + +body h2 { + margin: 0.5em 0 0 -4%; + line-height: 1.3; + border-bottom: 2px solid silver; +} + +body h3 { + margin: .8em 0 0 -3%; + line-height: 1.3; +} + +body h4 { + margin: .8em 0 0 -3%; + line-height: 1.3; +} + +body h5 { + margin: .8em 0 0 -2%; + line-height: 1.3; +} + +body h6 { + margin: .8em 0 0 -1%; + line-height: 1.3; +} + +body hr { + border: none; /* Broken on IE6 */ +} +div.footnotes hr { + border: 1px solid silver; +} + +div.navheader th, div.navheader td, div.navfooter td { + font-family: sans-serif; + font-size: 0.9em; + font-weight: bold; + color: #527bbd; +} +div.navheader img, div.navfooter img { + border-style: none; +} +div.navheader a, div.navfooter a { + font-weight: normal; +} +div.navfooter hr { + border: 1px solid silver; +} + +body td { + line-height: 1.2 +} + +body th { + line-height: 1.2; +} + +ol { + line-height: 1.2; +} + +ul, body dir, body menu { + line-height: 1.2; +} + +html { + margin: 0; + padding: 0; +} + +body h1, body h2, body h3, body h4, body h5, body h6 { + margin-left: 0 +} + +body pre { + margin: 0.5em 10% 0.5em 1em; + line-height: 1.0; + color: navy; +} + +tt.literal, code.literal { + color: navy; +} + +.programlisting, .screen { + border: 1px solid silver; + background: #f4f4f4; + margin: 0.5em 10% 0.5em 0; + padding: 0.5em 1em; +} + +div.sidebar { + background: #ffffee; + margin: 1.0em 10% 0.5em 0; + padding: 0.5em 1em; + border: 1px solid silver; +} +div.sidebar * { padding: 0; } +div.sidebar div { margin: 0; } +div.sidebar p.title { + margin-top: 0.5em; + margin-bottom: 0.2em; +} + +div.bibliomixed { + margin: 0.5em 5% 0.5em 1em; +} + +div.glossary dt { + font-weight: bold; +} +div.glossary dd p { + margin-top: 0.2em; +} + +dl { + margin: .8em 0; + line-height: 1.2; +} + +dt { + margin-top: 0.5em; +} + +dt span.term { + font-style: normal; + color: navy; +} + +div.variablelist dd p { + margin-top: 0; +} + +div.itemizedlist li, div.orderedlist li { + margin-left: -0.8em; + margin-top: 0.5em; +} + +ul, ol { + list-style-position: outside; +} + +div.sidebar ul, div.sidebar ol { + margin-left: 2.8em; +} + +div.itemizedlist p.title, +div.orderedlist p.title, +div.variablelist p.title +{ + margin-bottom: -0.8em; +} + +div.revhistory table { + border-collapse: collapse; + border: none; +} +div.revhistory th { + border: none; + color: #527bbd; + font-family: tahoma, verdana, sans-serif; +} +div.revhistory td { + border: 1px solid silver; +} + +/* Keep TOC and index lines close together. */ +div.toc dl, div.toc dt, +div.list-of-figures dl, div.list-of-figures dt, +div.list-of-tables dl, div.list-of-tables dt, +div.indexdiv dl, div.indexdiv dt +{ + line-height: normal; + margin-top: 0; + margin-bottom: 0; +} + +/* + Table styling does not work because of overriding attributes in + generated HTML. +*/ +div.table table, +div.informaltable table +{ + margin-left: 0; + margin-right: 5%; + margin-bottom: 0.8em; +} +div.informaltable table +{ + margin-top: 0.4em +} +div.table thead, +div.table tfoot, +div.table tbody, +div.informaltable thead, +div.informaltable tfoot, +div.informaltable tbody +{ + /* No effect in IE6. */ + border-top: 3px solid #527bbd; + border-bottom: 3px solid #527bbd; +} +div.table thead, div.table tfoot, +div.informaltable thead, div.informaltable tfoot +{ + font-weight: bold; +} + +div.mediaobject img { + margin-bottom: 0.8em; +} +div.figure p.title, +div.table p.title +{ + margin-top: 1em; + margin-bottom: 0.4em; +} + +div.calloutlist p +{ + margin-top: 0em; + margin-bottom: 0.4em; +} + +@media print { + div.navheader, div.navfooter { display: none; } +} + +span.aqua { color: aqua; } +span.black { color: black; } +span.blue { color: blue; } +span.fuchsia { color: fuchsia; } +span.gray { color: gray; } +span.green { color: green; } +span.lime { color: lime; } +span.maroon { color: maroon; } +span.navy { color: navy; } +span.olive { color: olive; } +span.purple { color: purple; } +span.red { color: red; } +span.silver { color: silver; } +span.teal { color: teal; } +span.white { color: white; } +span.yellow { color: yellow; } + +span.aqua-background { background: aqua; } +span.black-background { background: black; } +span.blue-background { background: blue; } +span.fuchsia-background { background: fuchsia; } +span.gray-background { background: gray; } +span.green-background { background: green; } +span.lime-background { background: lime; } +span.maroon-background { background: maroon; } +span.navy-background { background: navy; } +span.olive-background { background: olive; } +span.purple-background { background: purple; } +span.red-background { background: red; } +span.silver-background { background: silver; } +span.teal-background { background: teal; } +span.white-background { background: white; } +span.yellow-background { background: yellow; } + +span.big { font-size: 2em; } +span.small { font-size: 0.6em; } diff --git a/software/cdist/os.mdwn b/software/cdist/os.mdwn new file mode 100644 index 00000000..24992439 --- /dev/null +++ b/software/cdist/os.mdwn @@ -0,0 +1,17 @@ +[[!meta title="Supported Operating Systems"]] + +cdist was tested or is know to run on at least + + * [Archlinux](http://www.archlinux.org/) + * [Debian](http://www.debian.org/) + * [CentOS](http://www.centos.org/) + * [Fedora](http://fedoraproject.org/) + * [FreeBSD](http://www.freebsd.org) + * [Gentoo](http://www.gentoo.org/) + * [Mac OS X](http://www.apple.com/macosx/) + * [OpenBSD](http://www.openbsd.org) + * [Redhat](http://www.redhat.com/) + * [Ubuntu](http://www.ubuntu.com/) + * [XenServer](http://www.citrix.com/xenserver/) + +[[!tag cdist unix]] diff --git a/software/cdist/update.mdwn b/software/cdist/update.mdwn new file mode 100644 index 00000000..9a8949d3 --- /dev/null +++ b/software/cdist/update.mdwn @@ -0,0 +1,88 @@ +[[!meta title="How to update cdist"]] + +## Update The Git Installation + +To upgrade cdist in the current branch use + + git pull + + # Also update the manpages + ./build man + export MANPATH=$MANPATH:$(pwd -P)/doc/man + +If you stay on a version branche (i.e. 1.0, 1.1., ...), nothing should break. +The master branch on the other hand is the development branch and may not be +working, break your setup or eat the tree in your garden. + +## Update The Python Package + +To upgrade to the lastet version do + + pip install --upgrade cdist + +## Update Instructions + +### Updating from 2.0 to 2.1 + + * Type \_\_package* and \_\_process use --state **present** or **absent**. + The states **removed/installed** and **stopped/running** have been removed. + Support for the new states is already present in 2.0. + * Type \_\_directory: Parameter --parents and --recursive are now boolean + The old "yes/no" values need to be removed. + * Type \_\_rvm_ruby: Parameter --default is now boolean + The old "yes/no" values need to be removed. + * Type **\_\_addifnosuchline** and **\_\_removeline** have been replaced by **\_\_line** + * The **conf** directory is now located at **cdist/conf**. + You need to migrate your types, explorers and manifests + manually to the new location. + * Replace the variable **\_\_self** by **\_\_object_name** + Support for the variable **\_\_object_name** is already present in 2.0. + * The types \_\_autofs, \_\_autofs_map and \_\_autofs_reload have been removed + (no maintainer, no users) + + +### Updating from 1.7 to 2.0 + +* Ensure python (>= 3.2) is installed on the source host +* Use "cdist config host" instead of "cdist-deploy-to host" +* Use "cdist config -p host1 host2" instead of "cdist-mass-deploy" +* Use "cdist banner" for fun +* Use **\_\_object_name** instead of **\_\_self** in manifests + +### Updating from 1.6 to 1.7 + +* If you used the global explorer **hardware_type**, you need to change + your code to use **machine** instead. + +### Updating from 1.5 to 1.6 + +* If you used **\_\_package_apt --preseed**, you need to use the new + type **\_\_debconf_set_selections** instead. +* The **\_\_package** types accepted either --state deinstalled or + --state uninstaaled. Starting with 1.6, it was made consistently + to --state removed. + +### Updating from 1.3 to 1.5 + +No incompatiblities. + +### Updating from 1.2 to 1.3 + +Rename **gencode** of every type to **gencode-remote**. + +### Updating from 1.1 to 1.2 + +No incompatiblities. + +### Updating from 1.0 to 1.1 + +In 1.1 the type **\_\_file** was split into **\_\_directory**, **\_\_file** and +**\_\_link**. The parameter **--type** was removed from **\_\_file**. Thus you +need to replace **\_\_file** calls in your manifests: + + * Remove --type from all \_\_file calls + * If type was symlink, use \_\_link and --type symbolic + * If type was directory, use \_\_directory + + +[[!tag cdist unix]]