summaryrefslogtreecommitdiffstats
path: root/doc
diff options
context:
space:
mode:
authorFabian Affolter <fabian@affolter-engineering.ch>2011-01-22 19:08:52 +0100
committerSol Jerome <sol.jerome@gmail.com>2011-01-22 13:07:16 -0600
commitc4af4157365711a6033a511406ec2bb29ffa80bf (patch)
treedde6c3d75a08e742c11e2d164c89ad0063c3a541 /doc
parentbef8a906b086a473dc1dd43a5930316238a6114d (diff)
downloadbcfg2-c4af4157365711a6033a511406ec2bb29ffa80bf.tar.gz
bcfg2-c4af4157365711a6033a511406ec2bb29ffa80bf.tar.bz2
bcfg2-c4af4157365711a6033a511406ec2bb29ffa80bf.zip
Small layout updates
Diffstat (limited to 'doc')
-rw-r--r--doc/server/plugins/misc/trigger.txt38
1 files changed, 38 insertions, 0 deletions
diff --git a/doc/server/plugins/misc/trigger.txt b/doc/server/plugins/misc/trigger.txt
new file mode 100644
index 000000000..7547f2fdd
--- /dev/null
+++ b/doc/server/plugins/misc/trigger.txt
@@ -0,0 +1,38 @@
+.. -*- mode: rst -*-
+
+.. _server-plugins-misc-trigger:
+
+=======
+Trigger
+=======
+
+Trigger is a plugin that calls external scripts (on the server) when
+clients are configured.
+
+Setup
+=====
+
+First, add Trigger to the **plugins** line in ``bcfg2.conf``. Then do the
+following::
+
+ mkdir /var/lib/bcfg2/Trigger
+ echo "#!/bin/sh\necho $1\n" > /var/lib/bcfg2/Trigger/test.sh
+ chmod +x /var/lib/bcfg2/Trigger/test.sh
+
+Use cases
+=========
+
+#. Completing network builds (ie resetting from the build target to the
+ boot PXE target)
+#. Integration with external systems
+
+Trigger Arguments
+=================
+
+Triggers are run with a series of arguments.
+
+#. client hostname
+#. -p
+#. client profile
+#. -g
+#. group1:group2:..:groupN (all client groups)