From 9e72515db88a7de8ccdde256314c2671cc011bbb Mon Sep 17 00:00:00 2001 From: "Chris St. Pierre" Date: Mon, 14 May 2012 11:06:34 -0400 Subject: added docs for selectively disabling Cfg validation --- doc/server/plugins/generators/cfg.txt | 20 +++++++++++++------- 1 file changed, 13 insertions(+), 7 deletions(-) (limited to 'doc') diff --git a/doc/server/plugins/generators/cfg.txt b/doc/server/plugins/generators/cfg.txt index 1d9d55927..031c9e3fc 100644 --- a/doc/server/plugins/generators/cfg.txt +++ b/doc/server/plugins/generators/cfg.txt @@ -237,13 +237,19 @@ For ``sudoers``, a very simple validator is:: This uses the ``visudo`` command's built-in validation. -.. note: - - Before 1.3 is released, it will be possible to disable validation - in the configuration, but enable it for ``bcfg2-test``. This is - recommended for heavily-used servers, since running an external - command is fairly resource intensive and could quickly exhaust the - file descriptors of a server. +If you wish to disable validation, this can be done with the following +setting in ``bcfg2.conf``:: + + [cfg] + validation=no + +If you have a very large number of validators, you may wish to disable +validation by default to avoid slowing down the generation of +configurations on the server, and use ``bcfg2-test`` (for instance, as +a post-commit hook or as part of a code review process) to run +validation. You can do this by setting ``validation=no`` in +``bcfg2.conf`` as described above, and then calling ``bcfg2-test`` +with the ``--cfg-validation`` flag. File permissions ================ -- cgit v1.2.3-1-g7c22