File: 0.04.10a/server/base/help.inc.php (View as HTML)

  1: <?php // help.inc.php
  2: /* -------------------------------------------------------------
  3: This file is part of FreeNATS
  4: 
  5: FreeNATS is (C) Copyright 2008 PurplePixie Systems
  6: 
  7: FreeNATS is free software: you can redistribute it and/or modify
  8: it under the terms of the GNU General Public License as published by
  9: the Free Software Foundation, either version 3 of the License, or
 10: (at your option) any later version.
 11: 
 12: FreeNATS is distributed in the hope that it will be useful,
 13: but WITHOUT ANY WARRANTY; without even the implied warranty of
 14: MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
 15: GNU General Public License for more details.
 16: 
 17: You should have received a copy of the GNU General Public License
 18: along with FreeNATS.  If not, see www.gnu.org/licenses
 19: 
 20: For more information see www.purplepixie.org/freenats
 21: -------------------------------------------------------------- */
 22: 
 23: $NATS_Help=array();
 24: 
 25: function ha($id,$text)
 26: {
 27: global $NATS_Help;
 28: $NATS_Help[strtoupper($id)]=$text;
 29: }
 30: 
 31: ha("FreeNATS","FreeNATS is a network monitoring package");
 32: 
 33: ha("Node","A node is a system or device which you are monitoring. Note that nodes can have tests pointing to different physical devices and vice-versa");
 34: ha("Node:Create","Create a new {node} with this {node:id|NodeID}");
 35: ha("Node:ID","The NodeID is a unique text name for a {node}. Maximum length 60 chars and only normal characters allowed.");
 36: ha("Node:Enabled","The node is enabled for tests to be performed (and displayed in all applicable views)");
 37: ha("Node:AlertActive","Alerts will be generated for this node and alert actions performed if selected");
 38: ha("Node:PingTest","Do a ping (ICMP) test first before other tests - will always record results if enabled");
 39: ha("Node:RequirePing","Require the ping to pass for other tests to even be tried - will always fail if {Node:PingTest|ping test} is disabled");
 40: 
 41: ha("Group","A group is a collection of one or more {node|nodes}. Note that nodes can be members of more than one group.");
 42: ha("Group:Create","Create a new {group} with this name");
 43: 
 44: ha("Test:Name","A custom name can be assigned to the test for use in displays and alerts. If blank an automated name will be generated.");
 45: ha("Test:Attempts","Number of times to attempt a test (will always try once). Defaults to 1 if zero or unset.");
 46: ha("Test:Timeout","Timeout value for the test - alters the defaults or system-wide variable settings for the relevant test (seconds)");
 47: ha("Test:SimpleEvaluation","Use simple pass/fail evaluation (i.e. if a web test returns any data it passes else it fails)");
 48: ha("Test:Recorded","Record the results of this test for historic reports");
 49: ha("Test:Enabled","Perform the test or not (will update nothing if disabled)");
 50: 
 51: ha("History:Should","A rough calculation based on 5 minute polling from the start to finish (or now if sooner)");
 52: 
 53: ha("View","A view is a custom set of nodes/groups/tests which can be used in a variety of ways");
 54: ha("View:Create","Creates a {view} of the specified name");
 55: ha("View:Public","The view can be seen by people not logged into FreeNATS");
 56: ha("View:Colons","If text status is selected for a view item a colon will be displayed before it");
 57: ha("View:Dashes","Display a dash before a test last run time where applicable");
 58: ha("View:TimeAgo","Use XX:XX ago or normal datetime for test details");
 59: ha("View:Columns","Display list-type elements in this number of columns (0 for off)");
 60: ha("View:Refresh","Send a http-equv to refresh the page after this many seconds (0 for off)");
 61: ha("View:UseColour","Use colour for status display as in normal FreeNATS display");
 62: ha("View:ShowDetail","Show details of the test/object(s) such as node tests");
 63: ha("View:TextStatus","Textual status such as passed, failed etc");
 64: 
 65: ha("Report","Reports show the %age of service availability in a specified period");
 66: 
 67: ha("Schedule","A schedule controls what times a node is tested and are managed through the admin page");
 68: ha("Schedule:DefaultAction","What will happen if no exceptions are matched (the opposite will happen if one is matched)");
 69: 
 70: ha("AlertAction","An alert action is performed when a node fails a test, they are configured through the admin page");
 71: ha("AAction:Warnings","The action is triggered for warning level events as well as failures (including downgrading from failure to warning if {AAction:Decreases|decreases} is set)");
 72: ha("AAction:Decreases","The action is triggered when the level goes down to closed (or {AAction:Warnings|warnings} if set)");
 73: ha("AAction:Limit","Max times this action can run in any one day (0 = unlimited) to avoid flooding");
 74: ha("AAction:Counter","Number of times this action has run in the day shown - you can manually reset this here");
 75: 
 76: ha("Variable","System variables are used to control the system environment. To delete a variable just save it with a blank name.");
 77: ha("Var:log.level","The system log level - 10 is everything, 0 is fatal only. 5-6-ish is probably a good balance.");
 78: 
 79: ha("Var:site.enable.interactive","Must be set (1) to allow interactive web sessions (like this one)");
 80: ha("Var:site.popupmessage","If set (1) will show a popup message when saving changes etc");
 81: ha("Var:site.dtformat","Site-wide custom date time format (in PHP format) i.e. Y-m-d H:i:s");
 82: 
 83: ha("Var:site.text.failed","Text to show for a failed status (defaults to Failed if unset)");
 84: ha("Var:site.text.passed","Text to show for a passed status (defaults to Passed if unset)");
 85: ha("Var:site.text.untested","Text to show for untested items (defaults to Untested if unset)");
 86: ha("Var:site.text.warning","Text to show for a warning status (defaults to Warning if unset)");
 87: 
 88: ha("Var:test.icmp.timeout","Timeout in seconds to wait for an ICMP response before declaring a failure in seconds (default 10)");
 89: ha("Var:test.icmp.trytwice","Depreciated - replaced with {Var:test.icmp.attempts|test.icmp.attempts}");
 90: ha("Var:test.icmp.attempts","Number of times the main &quot;require ping&quot; test will attempt before failing (default 2)");
 91: ha("Var:test.icmp.returnms","If set (1) returns ping results in MilliSeconds (ms) (default 0)");
 92: ha("Var:test.http.timeout","Default timeout for HTTP/s streams used in web tests (uses system default if unset or &lt;1)");
 93: ha("Var:test.imap.timeout","Default timeout for IMAP tests in seconds (uses environment default if unset or 0)");
 94: ha("Var:test.smtp.timeout","Default timeout for SMTP tests in seconds (uses 20 seconds if 0 or unset)");
 95: ha("Var:test.mysql.timeout","Default timeout for MySQL tests in seconds (uses environmental default if unset or 0)");
 96: 
 97: 
 98: ha("Var:retain.alert","Days to retain alert records for (default 356 if 0 or unset). Retain forever with value -1.");
 99: ha("Var:retain.record","Days to retain test result records for use in history and graphs (default 356 if 0 or unsert). Retain forever with value -1.");
100: ha("Var:retain.testrun","Days to retain test run records for (default 30 if 0 or unset). Retain forever with value -1.");
101: ha("Var:retain.syslog","Days to retain log entries for (default 30 if 0 or unset). Retain forever with value -1.");
102: 
103: ha("Var:freenats.tracker","Participate in the automated feedback process - 1 for yes low level, 2 for detailed, 0 for disabled (default 0)");
104: function hdisp($id,$html=true)
105: {
106: global $NATS_Help;
107: if (!isset($NATS_Help[strtoupper($id)])) return "";
108: $t=$NATS_Help[strtoupper($id)];
109: $o="";
110: $mode="text";
111: $linktext=false;
112: for ($a=0; $a<strlen($t); $a++)
113: 	{
114: 	$c=$t[$a];
115: 	
116: 	if ($c=="{") // start of a link
117: 		{
118: 		$mode="link";
119: 		$linktext=false;
120: 		$linkid="";
121: 		$linktxt="";
122: 		}
123: 		
124: 	else if ( ($mode=="link") && ($c=="|") ) // in a link and move into text mode...
125: 		{
126: 		$linktext=true;
127: 		}
128: 		
129: 	else if ( ($mode=="link") && ($c=="}") ) // in a link and the end of the link
130: 		{
131: 		if (!$linktext) $linktxt=$linkid;
132: 		if ($html) $o.="<a href=\"help.php?id=".$linkid."\">";
133: 		$o.=$linktxt;
134: 		if ($html) $o.="</a>";
135: 		$mode="text";
136: 		}
137: 		
138: 	else if ( $mode=="link" ) // in a link
139: 		{
140: 		if ($linktext) $linktxt.=$c;
141: 		else $linkid.=$c;
142: 		}
143: 		
144: 	else // in text
145: 		$o.=$c;
146: 	}
147: return $o;
148: }
149: 
150: function hlink($id,$size=16)
151: {
152: global $NATS_Help;
153: if (isset($NATS_Help[strtoupper($id)]))
154: 	return "<a href=\"javascript:freenats_help('".$id."')\"><img src=\"images/info".$size.".gif\" title=\"".hdisp($id,false)."\" border=0></a>";
155: 	
156: return "<img src=\"images/info".$size."g.gif\" border=0 title=\"Sorry, no help available. (".$id.")\">";
157: }
158: 
159: function ph($id,$size=16)
160: {
161: echo hlink($id,$size);
162: }
163: ?>