=======================================================
MCSG: Commands
=======================================================
:Title:        MCSG: Commands
:Author:       Douglas O'Leary <dkoleary@olearycomputers.com>
:Description:  MCSG: Commands
:Date created: 06/2005
:Date updated: 07/2007
:Disclaimer:   Standard: Use the information that follows at your own risk.  If you screw up a system, don't blame it on me...

:command:`cmapplyconf [-C ${config} | -P ${config} ] -p ${file}`:
   Applies the configuration files checked above. Appears to repeat the 
   configuration file checks, so checking them first may be redundant.
:command:`cmcheckconf [-C ${config}|-P ${config}] -p ${file}`  
   Configuration file checker. The -C checks cluster configuration files; 
   -P checks package configuration files, and the -p checks all the 
   configuration files listed in ${file}
:command:`cmdeleteconf [-p]` 
   Removes cluster configuration information. Use the -p option to remove 
   package definitions from the existing cluster. I imagine there's more 
   options; however, that one would seem to be the most used.
:command:`cmgetconf [-c ${cluster}|-p ${pkg}]`  
   Generates configuration files that generated the existing cluster or 
   package. Useful for identifying current configurations and for replacing 
   configuration files that have been wiped out. Probably a good idea to use 
   this to generate a config file to edit vs trying to keep track of changes 
   on all cluster nodes.
:command:`cmhaltcl [ -f ]`   
   Halts a cluster. If any pakcages are running and the -f option is not 
   supplied, the command will fail and complain about the running packages. 
   Using the -f option will force the packages to halt before killing the 
   cluster
:command:`cmhaltnode -f` 
   Halts a running node. Using the -f flag will switch any packages running 
   on that particular node to an adoptive node. This command does not 
   disable the global switch for any affected packages.
:command:`cmhaltpkg ${pkg}`
   Halts the package whereever it happens to be running.
:command:`cmmakepkg  -p ${config} -s ${script}`  
   Generates package configuration an run/halt scripts. The files generated 
   must be edited prior to use. -p = package configuration while 
   -s = run/halt script.
:command:`cmquerycl   -n ${node} -C ${config} -v`
   Use this command to set up the initial cluster configuration. Add a -n 
   option for each node in the nascent cluster. The -C option specifies the 
   cluster configuration file and the -v option requests verbose output.
:command:`cmruncl`    
   Starts up the cluster software and any configured packages on their 
   primary nodes.
:command:`cmrunnode`
   Activate a previously halted node. DO NOT use this command to start up a 
   cluster as the cluster reform process will hang. See "Hung cluster 
   reformation" for solution to this problem.