summaryrefslogtreecommitdiffstats
path: root/doc/unsorted/dynamic_groups.txt
diff options
context:
space:
mode:
Diffstat (limited to 'doc/unsorted/dynamic_groups.txt')
-rw-r--r--doc/unsorted/dynamic_groups.txt27
1 files changed, 27 insertions, 0 deletions
diff --git a/doc/unsorted/dynamic_groups.txt b/doc/unsorted/dynamic_groups.txt
new file mode 100644
index 000000000..11535dc8b
--- /dev/null
+++ b/doc/unsorted/dynamic_groups.txt
@@ -0,0 +1,27 @@
+.. -*- mode: rst -*-
+
+.. _unsorted-dynamic_groups:
+
+==============
+Dynamic Groups
+==============
+
+Bcfg2 supports the use of dynamic groups. These groups are not included
+in a client's profile group, but instead are derived from the results
+of probes executed on the client. These dynamic groups need not already
+exist in ``Metadata/groups.xml``. If a dynamic group is defined in
+``Metadata/groups.xml``, clients that include this group will also get
+all included groups and bundles.
+
+Setting up dynamic groups
+=========================
+
+In order to define a dynamic group, setup a probe that outputs the text
+based on system properties::
+
+ group:groupname
+
+This output is processed by the Bcfg2 server, and results in dynamic
+group membership in groupname for the client. See the :ref:`Probes
+<server-plugins-probes-index>` page for a more thorough description
+of probes.