From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: (qmail 30644 invoked by alias); 11 Sep 2009 11:30:27 -0000 Received: (qmail 30638 invoked by alias); 11 Sep 2009 11:30:27 -0000 X-SWARE-Spam-Status: No, hits=-1.9 required=5.0 tests=AWL,BAYES_00,SPF_HELO_PASS X-Spam-Status: No, hits=-1.9 required=5.0 tests=AWL,BAYES_00,SPF_HELO_PASS X-Spam-Check-By: sourceware.org X-Spam-Checker-Version: SpamAssassin 3.2.5 (2008-06-10) on bastion2.fedora.phx.redhat.com Subject: cluster: STABLE3 - config validate: add man page To: cluster-cvs-relay@redhat.com X-Project: Cluster Project X-Git-Module: cluster.git X-Git-Refname: refs/heads/STABLE3 X-Git-Reftype: branch X-Git-Oldrev: b25166629f95f0e3a4e0cd527fb17f25e8ca1699 X-Git-Newrev: 3f88e836e582c63938d2fd3862080a8e920a6f52 From: "Fabio M. Di Nitto" Message-Id: <20090911112957.3F64E1201B0@lists.fedorahosted.org> Date: Fri, 11 Sep 2009 11:30:00 -0000 X-Scanned-By: MIMEDefang 2.67 on 10.5.11.16 Mailing-List: contact cluster-cvs-help@sourceware.org; run by ezmlm Precedence: bulk List-Id: List-Subscribe: List-Post: List-Help: , Sender: cluster-cvs-owner@sourceware.org X-SW-Source: 2009-q3/txt/msg00338.txt.bz2 Gitweb: http://git.fedorahosted.org/git/cluster.git?p=cluster.git;a=commitdiff;h=3f88e836e582c63938d2fd3862080a8e920a6f52 Commit: 3f88e836e582c63938d2fd3862080a8e920a6f52 Parent: b25166629f95f0e3a4e0cd527fb17f25e8ca1699 Author: Fabio M. Di Nitto AuthorDate: Fri Sep 11 13:29:25 2009 +0200 Committer: Fabio M. Di Nitto CommitterDate: Fri Sep 11 13:29:25 2009 +0200 config validate: add man page Signed-off-by: Fabio M. Di Nitto --- config/tools/man/Makefile | 1 + config/tools/man/ccs_config_validate.8 | 52 ++++++++++++++++++++++++++++++++ 2 files changed, 53 insertions(+), 0 deletions(-) diff --git a/config/tools/man/Makefile b/config/tools/man/Makefile index 7cb76ab..e29dbf0 100644 --- a/config/tools/man/Makefile +++ b/config/tools/man/Makefile @@ -1,4 +1,5 @@ TARGET= ccs_config_dump.8 \ + ccs_config_validate.8 \ ccs_tool.8 \ confdb2ldif.8 diff --git a/config/tools/man/ccs_config_validate.8 b/config/tools/man/ccs_config_validate.8 new file mode 100644 index 0000000..8884952 --- /dev/null +++ b/config/tools/man/ccs_config_validate.8 @@ -0,0 +1,52 @@ +.TH CCS_CONFIG_VALIDATE "8" "September 2009" +.SH NAME +ccs_config_validate +.SH DESCRIPTION +Usage: +.PP +ccs_config_validate [options] +.SH OPTIONS +.TP +\fB\-h\fR +Print this help, then exit +.TP +\fB\-V\fR +Print program version information, then exit +.TP +\fB\-v\fR +Produce verbose output +.SS "Validating XML configuraton files:" +.TP +\fB\-f\fR configfile +Validate an alternate config file without preloading it with default values. +.TP +\fB\-l\fR configfile +Validate an alternate config file with preloading of default values (recommended option). +.SS "Advanced options:" +.TP +\fB\-r\fR +Force validation of runtime config +.HP +\fB\-C\fR config_loader +Override config plugin loader +.TP +\fB\-t\fR tempfile +Force temporay file to tempfile +.TP +\fB\-n\fR +Do not remove temporary file +.TP +\fB\-o\fR +Overwrite temporary file (dangerous) +.SH "DEFAULT" +Default operation for ccs_config_validate is to load the currently configured environment +and verify the outcoming configuration. +.TP +Example 1: current environment uses a configuration file (/etc/cluster/cluster.conf). +The user modifies cluser.conf and executes ccs_config_validate without options. +The tool will validate the modified cluster.conf after including default values. +.TP +Example 2: current environment is set to load the configuration from LDAP. Users +modifies LDAP databse and before pushing the change to the nodes, she/he can issue +ccs_config_validate to verify the contents o the LDAP database automatically +(as long as the correct LDAP environment is set in the cman/cluster sysconfig/defaults files).