From 6d712d2017fc53ae409f14deaa9fb23955587f6a Mon Sep 17 00:00:00 2001 From: Mike Gabriel Date: Tue, 27 Jun 2017 12:21:59 +0200 Subject: README.md: Add multi-site configuration details. --- README.md | 35 +++++++++++++++++++++++++++++++++++ 1 file changed, 35 insertions(+) diff --git a/README.md b/README.md index 9045139..51cebdf 100644 --- a/README.md +++ b/README.md @@ -52,6 +52,41 @@ The syntax for doing this is simple and easy to manage via the configuration fil teachers = teacher-printer +## Using a Single Configuration for Multiple Sites + +You can manage multiple sites (e.g. schools, customers, networks) in one +``standardskriver.cfg`` file and deploy that configuration file across the +managed sites (very useful when deploying diskless workstation images to multiple +sites). + +Each site needs to be given a unique name (e.g. SCHOOL-01, SCHOOL-02, +etc.). This site ID goes into an extra file: +``/etc/standardskriver.site``. This file is optional. The first line is +read from this file, gets sanitized and the outcome is the site ID. + +In ``/etc/standardskriver.cfg you can then put sections like: + + [machine.SCHOOL-01] + # special rules for SCHOOL-01 + 10.1.2.3 = school-01-admin-printer + + [machine.SCHOOL-02] + 10.3.6.3 = school-02-admin-printer + + 10.0.0.0/8 = main-printer + +The same configuration scheme is possible for POSIX groups: + + [groups.SCHOOL-01] + teachers = school-01-teacher-printer + + [groups.SCHOOL-02] + teachers = school-02-teacher-printer + + [groups] + students = students-printer + + ## License and Copyright The Standard Skriver Tool is licensed under the GPL-2+ license. -- cgit v1.2.3