| Rev 1 |
|
Rev 85 |
| Line 6... |
|
Line 6... |
<link rel="stylesheet" type="text/css" media="screen" href="weathermap.css" /> |
|
<link rel="stylesheet" type="text/css" media="screen" href="weathermap.css" /> |
<meta name="generator" content= |
|
<meta name="generator" content= |
"HTML Tidy for Mac OS X (vers 12 April 2006), see www.w3.org" /> |
|
"HTML Tidy for Mac OS X (vers 12 April 2006), see www.w3.org" /> |
|
|
|
<title>PHP Weathermap |
|
<title>PHP Weathermap |
v0.91 |
|
v0.97a |
- Installation - Cacti Plugin</title> |
|
- Installation - Cacti Plugin</title> |
<style type="text/css" media="print"> |
|
<style type="text/css" media="print"> |
/*<![CDATA[*/ |
|
/*<![CDATA[*/ |
body { font-size: 12pt; } |
|
body { font-size: 12pt; } |
a { color: black; text-decoration: underline; font-weight: normal;} |
|
a { color: black; text-decoration: underline; font-weight: normal;} |
| Line 39... |
|
Line 39... |
</ul> |
|
</ul> |
</div> |
|
</div> |
|
|
|
<div id="header"> |
|
<div id="header"> |
<h1>PHP Weathermap |
|
<h1>PHP Weathermap |
v0.91 |
|
v0.97a |
</h1> |
|
</h1> |
<h4>Copyright © 2005-2007 Howard Jones, <tt><a |
|
<h4>Copyright © 2005-2010 Howard Jones, <tt><a |
href="mailto:howie@thingy.com">howie@thingy.com</a></tt>. (<a |
|
href="mailto:howie@thingy.com">howie@thingy.com</a></tt>. (<a |
href="http://www.network-weathermap.com/">Website</a>)</h4> |
|
href="http://www.network-weathermap.com/">Website</a>)</h4> |
</div> |
|
</div> |
|
|
|
|
|
|
| Line 55... |
|
Line 55... |
<h4>Requirements</h4> |
|
<h4>Requirements</h4> |
<p><strong>Before</strong> doing anything else, please verify that your <a href="http://cactiusers.org/">Plugin Architecture</a> is working properly with a simpler plugin, like <a href="http://wotsit.thingy.com/haj/cacti/links-plugin.html">Links</a> or <a href="http://cactiusers.org/">Tools</a>. Weathermap is relatively complex, and fault-finding both your Cacti Plugin Architecture and Weathermap at the same time will make life harder for you!</p> |
|
<p><strong>Before</strong> doing anything else, please verify that your <a href="http://cactiusers.org/">Plugin Architecture</a> is working properly with a simpler plugin, like <a href="http://wotsit.thingy.com/haj/cacti/links-plugin.html">Links</a> or <a href="http://cactiusers.org/">Tools</a>. Weathermap is relatively complex, and fault-finding both your Cacti Plugin Architecture and Weathermap at the same time will make life harder for you!</p> |
|
|
|
<p>You will need the 'pcre' and 'gd' PHP modules in <em>your command-line PHP</em>. The poller-process runs using the command-line PHP which is not always the same as the server-side one. In some situations it is possible to have two completely different PHP installations serving these two - if you install from a package, then re-install from source, but to a different directory, for example. The poller process should warn you if the part it needs is not present.</p> |
|
<p>You will need the 'pcre' and 'gd' PHP modules in <em>your command-line PHP</em>. The poller-process runs using the command-line PHP which is not always the same as the server-side one. In some situations it is possible to have two completely different PHP installations serving these two - if you install from a package, then re-install from source, but to a different directory, for example. The poller process should warn you if the part it needs is not present.</p> |
|
|
|
<p>Before you start using it, you might want to change one PHP setting. Weathermap uses a fair bit of memory by PHP standards, as it builds the image for the map in memory before saving it. As a result, your PHP process <i>may</i> run out of memory. PHP has a 'safety valve' built-in, to stop runaway scripts from killing your server, which defaults to 8MB in most versions (this has changed in 5.2.x). This is controlled by the 'memory_limit =' line in php.ini. You may need to increase this to 32MB or even more if you have problems. These problems will typically show up as the poller process just dying with no warning or error message, as PHP kills the script.</p> |
|
<p>Before you start using it, you might want to change one PHP setting. Weathermap uses a fair bit of memory by PHP standards, as it builds the image for the map in memory before saving it. As a result, your PHP process <i>may</i> run out of memory. PHP has a 'safety valve' built-in, to stop runaway scripts from killing your server, which defaults to 8MB in most versions (this has changed in 5.2.x). This is controlled by the 'memory_limit =' line in php.ini. You may need to increase this to 32MB or even more if you have problems. In fact, the current Cacti manual suggests 128MB. These problems will typically show up as the poller process just dying with no warning or error message, as PHP kills the script.</p> |
|
|
|
<h4>Installation</h4> |
|
<h4>Installation</h4> |
<p>To use the Cacti plugin, you <i>must</i> unpack the zip file into a directory called '<i><cacti_root></i>/plugins/weathermap'. The zip contains a folder called 'weathermap' already, so unzipping it in the plugins folder should do the job.</p> |
|
<p>To use the Cacti plugin, you <i>must</i> unpack the zip file into a directory called '<i><cacti_root></i>/plugins/weathermap'. The zip contains a folder called 'weathermap' already, so unzipping it in the plugins folder should do the job.</p> |
|
|
|
<p>You can then use the pre-install checker to see if your PHP environment has everything it needs. To do this, you need to run a special <tt>check.php</tt> script, twice...</p> |
|
<p>You can then use the pre-install checker to see if your PHP environment has everything it needs. To do this, you need to run a special <tt>check.php</tt> script, twice...</p> |
| Line 74... |
|
Line 74... |
chown cactiuser output |
|
chown cactiuser output |
</pre></div> |
|
</pre></div> |
|
|
|
<h4>Getting Started</h4> |
|
<h4>Getting Started</h4> |
|
|
|
<p>To actually enable the plugin, you need to add a line to your Cacti includes/config.php file: |
|
<p>To actually enable the plugin, you need to add a line to your Cacti config file. This file is includes/config.php for Cacti 0.8.6 and includes/global.php for Cacti 0.8.7: |
<div class="shell"><pre> |
|
<div class="shell"><pre> |
$plugins = array(); |
|
$plugins = array(); |
$plugins[] = 'monitor'; |
|
$plugins[] = 'monitor'; |
<b>$plugins[] = 'weathermap';</b> |
|
<b>$plugins[] = 'weathermap';</b> |
</pre></div> |
|
</pre></div> |
