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.txt18
1 files changed, 18 insertions, 0 deletions
diff --git a/doc/unsorted/dynamic_groups.txt b/doc/unsorted/dynamic_groups.txt
new file mode 100644
index 000000000..87e858fec
--- /dev/null
+++ b/doc/unsorted/dynamic_groups.txt
@@ -0,0 +1,18 @@
+.. -*- 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 [wiki:Plugins/Probes Probes] page for a more thorough description of probes.