diff --git a/doc/man/man7/cdist-tutorial.text b/doc/man/man7/cdist-tutorial.text index 24e665b5..91b5fdee 100644 --- a/doc/man/man7/cdist-tutorial.text +++ b/doc/man/man7/cdist-tutorial.text @@ -98,40 +98,20 @@ cdist, which are usually underline prefixed (__). +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. Objects are instances of +**types**, like in object orientated programming. An object is represented +by the type + slash + object name: ***__file/etc/cdist-configured*** is an +object of the type ***__file*** with the name ***etc/cdist-configured***. -PREPARING YOUR MACHINE / SETUP ------------------------------- -Before you actually - -- ensure sshd is running on the target host: - -ssh target_host - -- ensure you can login as root - -ssh root@target host - -- ensure login as root works without keys -(see ssh... manpage) - -cdist will do a lot of requests to the target -host, thus you'll have to enter your password -many times, if you don't do this :-) - -- speedup processing with ControlMaster option of -ssh +Cdist searches for the initial manifest at **conf/manifest/init** and +executes it as a shell script using **/bin/sh -e**. -YOUR FIRST CONFIGURATION ------------------------- -DEFINE STATE IN THE INITAL MANIFEST ------------------------------------ - -The initial manifest is used to map -configurations to a host. - USING SOME BASIC TYPES ---------------------- what is a type, how to use it, @@ -162,58 +142,14 @@ __debug:: +BRANCHES IN HERE? +------------ +TUNING CDIST +------------ - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - +- speedup processing with ControlMaster option of +ssh SEE ALSO