

---- List of NRG Configuration Strings ----

 - This should be a complete list of configuration option keywords.
   Default values for many of these configuration strings can be found in
   the Default.conf file.


   RRDTemplate[target]:		The template for creating a .rrd file.

   RRDArchive[target]:		The directory for storing old .rrd files.

   RunScript[target]:           The run script to use to gather and archive
                                data for the target.

   GetTimeout[target]:		The timeout for collecting data from snmpget
				or some other collector.

   WebRootDir[target]:		The part of the absolute path to your
				web pages that does not show up in URLs.

   ImageDir[target]:		The URL path to the directory that contains
				rrdtool+nrg.gif and other general .gif files.

   RRD[target]:			The URL path and file name for an RRD.

   System[target]:		The domain name or IP address of a system to
				collect statistics from.  This configuration
                                string also supports the name:port syntax to
                                allow for getting SNMP stats from SNMP agents
                                at ports other than the usual port 161.

   Variable[target][ds]:	For gathering SNMP stats, this should be
				set to an SNMP OID.  For gathering other
				stats, this sould be set to a Unix command
				enclosed in backticks ("`").  The OID may be
				abbreviated by using an abbreviation that 
				appears in the etc/nrg-oid-names file.

   MaximumValue[target]:	The maximum value of the data sources
				associated with "target".  The MaximumValue
				always refers to the processed values of a DS.
				If this maximum value is know, use it!  Using 
				this keyword causes RRDtool to do simple sanity
				checks.  Specifically, correctly using this 
				keyword causes RRDtool to correctly handle 
				COUNTER roll-overs and resets. 

   GraphPageTemplate[target]:	The template to use for creating rrdcgi
				scripts that graph an RRD.

   Label[target][var]:		The label for a variable that appears inside
				an RRDtool gif file.

   CalcDef[target][var]:		An RPN expression that alters the "ds"
				part of a Variable statement or the "var"
				part of another/other CalcDef statement(s).
 
   Graph[target][ds|var]:	The color and type that specifies how a DS
				should be graphed.  For example, "blue
				LINE2" to draw a blue line two pixels wide.
                                NOTE: TESTME the ds/var part of this keyword
                                can *not* be a perl regular expression.

   UpperLimit[target]:		This is not the upper limit of a graph!  But
				rather, this is the minimum upper bound
				of a graph.  Use this keyword to expand
				graphs up.  For example, the value 100 will
				result in graphs that have a upper bound
				of 100 or *more*.  Setting the UpperLimit to
				the maximum value for some DS will result
				in disabling RRDtool's autoscaling down
				(ie it will "expand" graphs up.)  To disable
				RRDtool's autoscaling up (to the max
				value for the DSs graphed), use a nifty
				CalcDef like so:
		                  CalcDef[somerrd][mcpu]: cpu,100,GT,100,cpu,IF
				If this CalcDef is applied to all DSs in a 
				graph, then the graph will have an upper limit
				of 100.
				
   LowerLimit[target]:		This is not the lower limit of a graph.  But
				rather, this is the maximum lower bound of
				a graph.  For example, the value -100 will 
				result in a graph that has a lower limit of
				-100 or less.  Use this keyword to expand
				graphs down.
 
   YLabel[target]:		The label for the Y axis (that appears inside 
				RRDtool gifs on the left hand side.)

   GraphPrint[target]: 		The valid values for this keyword are ave, max,
				and last.  This keyword defines what DS values 
				will appear (inside RRDtool gifs) after the DS 
				labels.

   Units[target]:		The label to put after ave, max and/or last.
				To autoscale a DS value printed inside an
				RRDtool gif, use the string %s inside it's
				Units keyword definintion.  For example, 
				"%sb/s" might display as "20 b/s", "30 Kb/s", 
                                "20 Mb/s".

   UnitsExponent[target]:        Do fixed autoscaling of the quantity labels 
                                for the y-axis.  Use the value zero to disable 
                                y-axis quantity label autoscaling.  Use the 
                                value 6 (when graphing bytes) to fix y-axis 
                                quantity labels to megabytes, etc.

   PageTitle[target]:		The HTML <TITLE> tag for a graph web page.

   PageTop[target]:		The HTML header for a graph web page.

   PageBody[target]:		The HTML body for a graph web page.

   PageBottom[target]:		The HTML footer for a graph web page.

   TableWebPage[target]:	Defines a table web page that should be 
				created by nrg-tablemaker 

   TableRegExp[target]:		The perl regular expression that specifies 
				which graph web pages should be listed in an
				table web page.

   TableTitle[target]:		The HTML <TITLE> tag for a table web page.

   Base[]:                       This refers to the conversion factor for
                                converting some units to kilo units.  For 
                                networks, the default value of 1000 is correct
                                (1 kbit/sec == 1000 bit/sec).  For memory 
                                and disk storage the correct value is 1024
                                (1 kbyte == 1024 bytes)

