jablonka.czprosek.czf

weathermap

 Subversion Repositories:
[/] [docs/] [pages/] [errorcodes.html] - Blame information for rev 95

 

Line No. Rev Author Line
185simandl<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
2 "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
3 
4<html lang="en" xml:lang="en">
5<head>
6 <link rel="stylesheet" type="text/css" media="screen" href="weathermap.css" />
7 <meta name="generator" content=
8 "HTML Tidy for Mac OS X (vers 12 April 2006), see www.w3.org" />
9 
10 <title>PHP Weathermap
11v0.97a
12 - Error Code Reference</title>
13<style type="text/css" media="print">
14/*<![CDATA[*/
15body { font-size: 12pt; }
16a { color: black; text-decoration: underline; font-weight: normal;}
17/*]]>*/
18</style>
19</head>
20 
21<body>
22 <div id="frame">
23 
24 
25<div class="navcontainer">
26 <ul id="navlist">
27 <li><a href="main.html">Main Page</a></li>
28 <li><a href="main.html#installation">Installation</a></li>
29 <li><a href="main.html#basics">Basics</a></li>
30 <li><a href="faq.html">FAQ and Tips</a></li>
31 <li><a href="main.html#example">Sample Map</a></li>
32 <li><a href="cli-reference.html">CLI Reference</a></li>
33 <li><a href="config-reference.html">Config Reference</a></li>
34 <li><a href="advanced.html">Advanced Topics</a></li>
35 <li><a href="editor.html">Editor</a></li>
36 <li><a href="cacti-plugin.html">Cacti Plugin</a></li>
37 <li><a href="http://www.network-weathermap.com/">Site</a></li>
38 </ul>
39</div>
40 
41<div id="header">
42 <h1>PHP Weathermap
43v0.97a
44</h1>
45 <h4>Copyright &copy; 2005-2010 Howard Jones, <tt><a
46href="mailto:howie@thingy.com">howie@thingy.com</a></tt>. (<a
47href="http://www.network-weathermap.com/">Website</a>)</h4>
48</div>
49 
50 
51<h3>Error Code Reference</h3>
52 
53<p>This page is mainly here so that Google can find it, but here's a complete list of all the error codes that Weathermap can produce, and what each one means. </p>
54<p>I added this after I noticed a lot of google searches for error messages, that were not hitting a useful page in the manual. This page should be the useful page. </p>
55 
56 <dl class="errorcodes">
57 
58 <dt><a name="WMWARN01">[WMWARN01]</a></dt>
59 <dd><p>"Skipping drawing very short link (<em>linkname</em>). Impossible to draw! Try changing <a href="config-reference.html#GLOBAL_WIDTH">WIDTH</a> or <a href="config-reference.html#LINK_ARROWSTYLE">ARROWSTYLE?</a> " </p>
60 <p>Weathermap draws the arrowheads on links in proportion to the width of the link. If your link is fat, then the arrowhead will be bigger. If you have a very short link (nodes close together), you can get a situation where there is not enough room to draw the arrowheads. </p><p>If you reduce the width of the link, using <a href="config-reference.html#GLOBAL_WIDTH">WIDTH</a> then you might be able to make the arrowheads small enough so that they fit. You can also use <a href="config-reference.html#LINK_ARROWSTYLE">ARROWSTYLE</a> to choose a smaller style of arrowhead - <a href="config-reference.html#LINK_ARROWSTYLE">ARROWSTYLE</a> 1 1 is the smallest. </p>
61 <p>The most common cause of this error is that you have accidentally placed two nodes on top of each other. In that case, move one of the nodes. </p>
62 <p>In previous versions (0.8 to 0.82), this would result in the infamous "FELL THROUGH Howie's crappy binary search is wrong after all" error message. The solution is the same - move the nodes, or change the link width </p>
63 </dd>
64 
65 <dt><a name="WMWARN02">[WMWARN02]</a>, <a name="WMWARN04">[WMWARN04]</dt>
66 <dd><p>"Angled text doesn't work with non-FreeType fonts " </p>
67 <p>The standard fonts used by Weathermap are the ones bundled with the GD graphics library. These fonts (number 1-5 when you select fonts) can only be
68 drawn 'flat', and not at an angle. </p>
69 <p>If you are using link comments, or the 'angled' <a href="config-reference.html#LINK_BWSTYLE">BWSTYLE,</a> then Weathermap needs to be able to drawn text at any angle. To do this, it needs a Truetype font to be used for that part of the map (the bwlabel, or comment), which is drawn using the FreeType library. </p>
70 <p>To do this, you need to find a Truetype font, put it in your weathermap folder, and then define a new font in your map config file: <code><a href="config-reference.html#GLOBAL_FONTDEFINE">FONTDEFINE</a> 100 Vera 9</code> </p>
71 <p>Then you can use that new font (no. 100) in <a href="config-reference.html#LINK_COMMENTFONT">COMMENTFONT</a> or <a href="config-reference.html#LINK_BWFONT">BWFONT</a> lines. </p>
72 <p>You can find some TrueType fonts, and an example.conf that does this in the docs/example folder. </p><p>The reason the default comment font is not a TrueType font is that the FreeType library is an <em>optional</em> part of the GD library, so I can't assume that it will be available. </p>
73 </dd>
74 
75 <dt><a name="WMWARN03">[WMWARN03]</a></a></dt>
76 <dd><p>"Using a non-existent special font (<em>fontnumber</em>) - falling back to internal GD fonts " </p>
77 <p>If you use a font number that doesn't exist by default(e.g. larger than 5), and you haven't got a valid <a href="config-reference.html#GLOBAL_FONTDEFINE">FONTDEFINE</a> line, then you will get this error. Weathermap will use font 5 instead of the font you asked for. </p>
78 <p>Most common reason for this error is that the font file could not be found, or could not be loaded. Check the log for another error (WMWARN30 or WMWARN31). </p>
79 </dd>
80 
81 <dt><a name="WMWARN05">[WMWARN05]</a></dt>
82 <dd><p>"ProcessString: <em>key</em> refers to unknown item " </p>
83 <p>You used a 'Special Token' string, like {node:this:something}, but the 'something' you used isn't defined for the node or link you specified. This is usually a typographical error. </p>
84 </dd>
85 
86 <dt><a name="WMWARN06">[WMWARN06]</a></dt>
87 <dd><p>"Couldn't open <em>plugin-type</em> Plugin directory (<em>dir</em>). Things will probably go wrong. " </p>
88 <p>Parts of Weathermap are loaded from plugins. If these plugin directories don't exist, or are not readable due to file permissions, then the plugins can't be loaded. All data-reading is done by plugins, so without the data-source plugin directory, Weathermap won't do very much. </p>
89 <p>Check that lib/datasources, lib/pre and lib/post folders all exist inside your Weathermap folder. Check that they (and their contents) are readable by the user that Weathermap runs as (e.g. your Cacti poller user). On a Unix system, the directories should also be <em>executable</em> by that user, so that the contents of the directory can be seen. </p> </dd>
90 
91 <dt><a name="WMWARN07">[WMWARN07]</a></dt>
92 <dd><p>"ReadData: <em>type</em> <em>name</em>, target: <em>targetstring</em> on config line <em>linenumber</em> was recognised as a valid <a href="config-reference.html#LINK_TARGET">TARGET</a> by a plugin that is unable to run (<em>pluginname</em>) " </p>
93 <p>When the datasource plugins are loaded, each one is given a chance to check if everything it needs is available. If something is missing, that plugin can decline to load. If you have a <a href="config-reference.html#LINK_TARGET">TARGET</a> line that is aimed at a particular plugin, and that plugin declined to load, you will get this message. </p>
94 <p>Examples of this type of problem would be: Using cactihost: <a href="config-reference.html#LINK_TARGET">TARGETs</a> but with the command-line tool where cactihost: can't load, or using the rrdtool DS from the command-line, without correctly setting a path to rrdtool in the <tt>weathermap</tt> command-line tool. </p>
95 </dd>
96 
97 <dt><a name="WMWARN08">[WMWARN08]</a></dt>
98 <dd><p>"ReadData: <em>type</em> <em>name</em>, target: <em>targetstring</em>[4] on config line <em>linenumber</em> was not recognised as a valid <a href="config-reference.html#LINK_TARGET">TARGET</a> " </p>
99 <p>You have specified a <a href="config-reference.html#LINK_TARGET">TARGET</a> that <em>none</em> of the datasource plugins recognised. This is usually a typographical error. </p>
100 </dd>
101 
102 <dt><a name="WMWARN09">[WMWARN09]</a></dt>
103 <dd><p>"ColourFromPercent: Attempted to use non-existent scale: <em>scalename</em> for <em>itemname</em> " </p>
104 <p>You have added a <a href="config-reference.html#LINK_USESCALE">USESCALE</a> line to a <a href="config-reference.html#NODE_NODE">NODE</a> or <a href="config-reference.html#LINK_LINK">LINK,</a> but the scale name wasn't defined using <a href="config-reference.html#GLOBAL_SCALE">SCALE</a> lines first. Define the <a href="config-reference.html#GLOBAL_SCALE">SCALE,</a> or check your spelling. </p>
105 </dd>
106 
107 <dt><a name="WMWARN10">[WMWARN10]</a></dt>
108 <dd><p><a href="config-reference.html#NODE_NODE">"NODE</a> <em>nodename</em> has a relative position to an unknown node! " </p>
109 <p>You have used the relative <a href="config-reference.html#NODE_POSITION">POSITION</a> for a <a href="config-reference.html#NODE_NODE">NODE,</a> but you did it relative to a node that doesn't exist. Probably you have a typographical error/spelling error... </p>
110 </dd>
111 
112 <dt><a name="WMWARN11">[WMWARN11]</a></dt>
113 <dd><p>"There are Circular dependencies in relative <a href="config-reference.html#NODE_POSITION">POSITION</a> lines for <em>number</em> nodes. " </p>
114 <p>You are using relative <a href="config-reference.html#NODE_POSITION">POSITION</a> for nodes, but somewhere you have a node that is relative to another node that is relative to the first one again - a loop. None of the nodes in the loop can be positioned correctly. Solution: make at least one node in the loop have a normal absolute position. </p>
115 </dd>
116 
117 <dt><a name="WMWARN12">[WMWARN12]</a></dt>
118 <dd><p>"Failed to write map image. No function existed for the image format you requested. " </p>
119 <p>You specified a particular format to write the map image with IMAGEFILE, but your php/GD installation doesn't have support for that image format. </p>
120 <p>You'll need to either choose a different image format, or recompile/reinstall your php, php-gd and GD libraries to support that image format. </p>
121 </dd>
122 
123 <dt><a name="WMWARN13">[WMWARN13],[WMWARN15],[WMWARN16]</a></dt>
124 <dd><p>"Failed to overwrite existing image file <em>filename</em> - permissions of existing file are wrong? " </p>
125 <p>Most likely when using the Cacti plugin. The files in the output/ directory are owned by a different user from the one running weathermap, and so it can't overwrite those files. </p>
126 <p>The most common way to get into this situation is by using the "Recalculate Now" button in the Cacti plugin. This creates files that are owned by the user that your webserver runs as. When the poller process comes along a few minutes later, it can no longer write over those files with the new data. Solution: make sure that the directory, and it's contents are owned by the poller user (or 'cactiuser') and don't use the 'Recalculate Now' button any more. </p>
127 </dd>
128 
129 <dt><a name="WMWARN14">[WMWARN14]</a></dt>
130 <dd><p>"Failed to create image file <em>filename</em> - permissions of output directory are wrong? " </p>
131 <p>Again, usually in Cacti plugin. </p>
132 <p>Weathermap is unable to create files in the directory that the output file should go - this is the plugins/weathermap/output/ directory if you are
133 using the Cacti plugin. Make sure that directory is owned/writable by the user that runs your poller process. This is the same permissions that you would have set on the rra/ directory when installing Cacti itself. </p>
134 </dd>
135 
136 <dt><a name="WMWARN17">[WMWARN17]</a></dt>
137 <dd><p>"Skipping thumbnail creation, since we don't have the necessary function. " </p>
138 <p>Your php/php-gd/GD library doesn't include the imagecopyresampled() function, which is required to make the thumbnail images used in the Cacti plugin. To get that function , you'll need to update/recompile/reinstall your php, php-gd and GD libraries. </p>
139 </dd>
140 
141 <dt><a name="WMWARN20">[WMWARN20]</a></dt>
142 <dd><p>"No image (gd) extension is loaded. This is required by weathermap. " </p>
143 <p>All the graphics work in Weathermap is done using the gd PHP extension. Your php installation doesn't have this extension, or it is not enabled. </p>
144 <p>You'll need to install or enable that extension to use Weathermap. </p>
145 </dd>
146 
147 <dt><a name="WMWARN21">[WMWARN21]</a></dt>
148 <dd><p>"Your GD php module doesn't support PNG format. " </p>
149 <p>You specified an <a href="config-reference.html#NODE_ICON">ICON</a> or <a href="config-reference.html#GLOBAL_BACKGROUND">BACKGROUND</a> image in PNG format, and your php-gd extension doesn't support PNG format images. </p>
150 <p>You'll need to either choose a different image format, or recompile/reinstall your php, php-gd and GD libraries to support that image format. </p>
151 </dd>
152 
153 <dt><a name="WMWARN22">[WMWARN22]</a></dt>
154 <dd><p>"Your GD php module doesn't support truecolor. " </p>
155 <p>Weathermap requires that your GD library and php-gd extension support 24-bit colour (or "TrueColor"). To get that function , you'll need to update/recompile/reinstall your php, php-gd and GD libraries. Most likely, this is the result of an older version of GD. </p>
156 </dd>
157 
158 <dt><a name="WMWARN23">[WMWARN23]</a></dt>
159 <dd><p>"Your GD php module doesn't support thumbnail creation (imagecopyresampled). " </p>
160 <p>See <a href="#WMWARN17">WMWARN17</a> </p>
161 </dd>
162 
163 
164 
165 
166 <dt><a name="WMWARN24">[WMWARN24]</a></dt>
167 <dd><p>"Duplicate node name <em>nodename</em> at line <em>linenumber</em> - only the last one defined is used. " </p>
168 <p>You have used the same name for two or more <a href="config-reference.html#NODE_NODE">NODE</a> lines in your config. This is probably a typo or cut &amp; paste error. One of the two <a href="config-reference.html#NODE_NODE">NODEs</a> will not show up in the map. </p>
169 </dd>
170 
171 <dt><a name="WMWARN25">[WMWARN25]</a></dt>
172 <dd><p>"Duplicate link name <em>linkname</em> at line <em>linenumber</em> - only the last one defined is used. " </p>
173 <p>You have used the same name for two or more <a href="config-reference.html#LINK_LINK">LINK</a> lines in your config. This is probably a typo or cut &amp; paste error. One of the two <a href="config-reference.html#LINK_LINK">LINKs</a> will not show up in the map. </p>
174 </dd>
175 
176 <dt><a name="WMWARN26">[WMWARN26]</a></dt>
177 <dd><p><a href="config-reference.html#LINK_LINK">"LINK</a> DEFAULT is not the first <a href="config-reference.html#LINK_LINK">LINK.</a> Defaults will not apply to earlier <a href="config-reference.html#LINK_LINK">LINKs.</a> " </p>
178 <p>You should usually specify your DEFAULT <a href="config-reference.html#LINK_LINK">LINK</a> <em>before</em> all your 'real' <a href="config-reference.html#LINK_LINK">LINKs.</a> The reason is that when a new <a href="config-reference.html#LINK_LINK">LINK</a> is defined, it copies whatever the default settings are at that point in reading down the config file, so you will end up with inconsistent results. </p>
179 </dd>
180 
181 <dt><a name="WMWARN27">[WMWARN27]</a></dt>
182 <dd><p><a href="config-reference.html#NODE_NODE">"NODE</a> DEFAULT is not the first <a href="config-reference.html#NODE_NODE">NODE.</a> Defaults will not apply to earlier <a href="config-reference.html#NODE_NODE">NODEs.</a> " </p>
183<p>You should usually specify your DEFAULT <a href="config-reference.html#NODE_NODE">NODE</a> <em>before</em> all your 'real' <a href="config-reference.html#NODE_NODE">NODEs.</a> The reason is that when a new <a href="config-reference.html#NODE_NODE">NODE</a> is defined, it copies whatever the default settings are at that point in reading down the config file, so you will end up with inconsistent results. </p> </dd>
184 
185 <dt><a name="WMWARN28">[WMWARN28]</a></dt>
186 <dd><p>"Dropping <a href="config-reference.html#LINK_LINK">LINK</a> <em>linkname</em> - it hasn't got 2 <a href="config-reference.html#LINK_NODES">NODES!</a> " </p>
187 <p>You defined a link where one or both of the nodes in the <a href="config-reference.html#LINK_NODES">NODES</a> line don't exist. </p>
188 <p>Or you forgot to add a <a href="config-reference.html#LINK_NODES">NODES</a> line altogether. </p>
189 <p>A link goes between two nodes, so you need to tell weathermap which two nodes, and they need to exist. </p>
190 </dd>
191 
192 <dt><a name="WMWARN30">[WMWARN30]</a></dt>
193 <dd><p>"Failed to load ttf font <em>filename</em> - at config line <em>linenumber</em>" </p>
194 <p>You defined a TrueType/FreeType font with <a href="config-reference.html#GLOBAL_FONTDEFINE">FONTDEFINE,</a> but the file doesn't exist, or can't be loaded due to permissions issues. </p>
195 </dd>
196 
197 <dt><a name="WMWARN31">[WMWARN31]</a></dt>
198 <dd><p>"imagettfbbox() is not a defined function. You don't seem to have FreeType compiled into your gd module. " </p>
199 <p>You tried to use a TrueType/FreeType font, but your GD library (and/or php-gd extension) don't understand FreeType. </p>
200 <p>You'll need to either choose a different font format, or recompile/reinstall your php, php-gd, GD and perhaps freetype2 libraries to support that font format. </p>
201 </dd>
202 
203 <dt><a name="WMWARN32">[WMWARN32]</a></dt>
204 <dd><p>"Failed to load GD font: <em>filename</em> (<em>errorcode</em>) at config line <em>linenumber</em> " </p>
205<p>You defined a .gdf font with <a href="config-reference.html#GLOBAL_FONTDEFINE">FONTDEFINE,</a> but the file doesn't exist, or can't be loaded due to permissions issues. </p> </dd>
206 
207 <dt><a name="WMWARN33">[WMWARN33]</a></dt>
208 <dd><p>"NewColourFromPercent: Clipped <em>number</em>% to 100% for item <em>itemname</em>" </p>
209 <p>You are using a regular <a href="config-reference.html#GLOBAL_SCALE">SCALE</a> with a value that is calculated as a
210 percentage of the <a href="config-reference.html#NODE_MAXVALUE">MAXVALUE</a> or <a href="config-reference.html#LINK_BANDWIDTH">BANDWIDTH.</a> That calculated value was
211 higher than 100%. You could fix this with one of: </p>
212 <ul>
213 <li>Change <a href="config-reference.html#LINK_BANDWIDTH">BANDWIDTH</a> or <a href="config-reference.html#NODE_MAXVALUE">MAXVALUE</a> to the correct value.</li>
214 <li>Use an absolute <a href="config-reference.html#GLOBAL_SCALE">SCALE</a> (see USESCALE)</li>
215 <li>Disable the warning by adding <a href="config-reference.html#GLOBAL_SET">'SET</a> nowarn_clip 1' at the top of the map config file.</li>
216 </ul>
217 </dd>
218 
219 <dt><a name="WMWARN33">[WMWARN34]</a></dt>
220 <dd><p>"NewColourFromPercent: Clipped <em>number</em>% to 0% for item <em>itemname</em>" </p>
221 <p>You are using a regular <a href="config-reference.html#GLOBAL_SCALE">SCALE</a> with a value that is calculated as a
222 percentage of the <a href="config-reference.html#NODE_MAXVALUE">MAXVALUE</a> or <a href="config-reference.html#LINK_BANDWIDTH">BANDWIDTH.</a> That calculated value was
223 below 0%. You could fix this with one of: </p>
224 <ul>
225 <li>Use a '-' prefix on the <a href="config-reference.html#LINK_TARGET">TARGET</a> to make the value positive, if it's <em>always</em> negative, like attentuation readings.</li>
226 <li>Use an absolute <a href="config-reference.html#GLOBAL_SCALE">SCALE</a> (see USESCALE)</li>
227 <li>Disable the warning by adding <a href="config-reference.html#GLOBAL_SET">'SET</a> nowarn_clip 1' at the top of the map config file.</li>
228 </ul>
229 </dd>
230 
231 
232 <dt><a name="WMWARN35">[WMWARN35]</a></dt>
233 <dd><p><a href="config-reference.html#LINK_LINK">"LINK</a> <em>linkname</em> uses a <a href="config-reference.html#NODE_NODE">NODE</a> with no <a href="config-reference.html#NODE_POSITION">POSITION!"</a> </p>
234 <p>Some nodes have no position, because they are used purely as a <a href="config-reference.html#LINK_TEMPLATE">TEMPLATE</a> for other nodes.
235 You have used one of these for a real link, and as a result, Weathermap can't figure out
236 where to draw the link. </p>
237 </dd>
238 
239 
240 <dt><a name="WMWARN36">[WMWARN36]</a></dt>
241 <dd><p>"Using a non-existent special font (<em>number</em>) - falling back to internal GD fonts" </p>
242 <p>You have used a command like <a href="config-reference.html#LINK_COMMENTFONT">COMMENTFONT,</a> <a href="config-reference.html#GLOBAL_FONT">TITLEFONT</a> or <a href="config-reference.html#NODE_LABELFONT">LABELFONT</a> to change the font
243 to a custom-defined one (number > 5) but there is no <a href="config-reference.html#GLOBAL_FONTDEFINE">FONTDEFINE</a> line for that font number, OR
244 the font could not be loaded. Check back in the logs, for WMWARN30 or WMWARN31. </p>
245 </dd>
246 
247 
248 <dt><a name="WMWARN37">[WMWARN37]</a></dt>
249 <dd><p>"Couldn't open <a href="config-reference.html#NODE_ICON">ICON:</a> '<em>filename</em>' - is it a PNG, JPEG or GIF?" </p>
250 <p>The file you specified to use as an <a href="config-reference.html#NODE_ICON">ICON</a> does exist, but couldn't be loaded by the GD image library.
251 Check that the file really is an image file. </p>
252 </dd>
253 
254 
255 <dt><a name="WMARN38">[WMARN38]</a></dt>
256 <dd><p><a href="config-reference.html#NODE_ICON">"ICON</a> '<em>filename</em>' does not exist, or is not readable. Check path and permissions." </p>
257 <p>You specified an <a href="config-reference.html#NODE_ICON">ICON,</a> but the file couldn't be opened or couldn't be found at all. </p>
258 </dd>
259 
260 
261 <dt><a name="WMWARN39">[WMWARN39]</a></dt>
262 <dd><p>"line <em>number</em>: <a href="config-reference.html#LINK_TEMPLATE">TEMPLATE</a> is not first line of object. Some data may be lost." </p>
263 <p>The <a href="config-reference.html#LINK_TEMPLATE">TEMPLATE</a> command works by copying the settings from another node or link over the top
264 of the existing items. If you use some other configuration commands, then use <a href="config-reference.html#LINK_TEMPLATE">TEMPLATE,</a> the
265 results of those commands may be overwritten by the equivalent settings in the template item. </p>
266 </dd>
267 
268 
269 <dt><a name="WMWARN40">[WMWARN40]</a></dt>
270 <dd><p>"line <em>number</em>: <em><a href="config-reference.html#NODE_NODE">NODE</a> or LINK</em> <a href="config-reference.html#LINK_TEMPLATE">TEMPLATE</a> '<em>name</em>' doesn't exist! (if it does exist, check it's defined first)" </p>
271 <p>You specified a <a href="config-reference.html#LINK_TEMPLATE">TEMPLATE,</a> but the node or link doesn't exist. Also, possibly, that the template node is
272 further down in the config file. Best practice is to keep the templates together near the top of the file, along with DEFAULTs. </p>
273 </dd>
274 
275 
276 <dt><a name="WMWARN41">[WMWARN41]</a></dt>
277 <dd><p><a href="config-reference.html#LINK_OVERLIBGRAPH">"OVERLIBGRAPH</a> is used, but <a href="config-reference.html#GLOBAL_HTMLSTYLE">HTMLSTYLE</a> is static. This is probably wrong." </p>
278 <p>To generate the 'popup' graphs, the Overlib javascript is required. The default
279 HTML output from Weathermap doesn't include this for historical reasons. If you
280 specify <a href="config-reference.html#LINK_OVERLIBGRAPH">OVERLIBGRAPH,</a> you must also add <a href="config-reference.html#GLOBAL_HTMLSTYLE">'HTMLSTYLE</a> overlib' to the top section of
281 the config file. </p>
282 </dd>
283 
284 
285 <dt><a name="WMWARN42">[WMWARN42]</a></dt>
286 <dd><p>"IN/OUTOVERLIBGRAPH make no sense for a <a href="config-reference.html#NODE_NODE">NODE!"</a> </p>
287 <p><a href="config-reference.html#NODE_NODE">NODEs</a> don't have a input and output area on the image, so you can't specify separate
288 <a href="config-reference.html#LINK_OVERLIBGRAPH">OVERLIBGRAPHs</a> for each. </p>
289 </dd>
290 
291 
292 <dt><a name="WMWARN43">[WMWARN43]</a></dt>
293 <dd><p>"FindScaleExtent: non-existent <a href="config-reference.html#GLOBAL_SCALE">SCALE</a> <em>scalename</em>" </p>
294 <p>Somehow, Weathermap is trying to draw a legend for a scale that doesn't exist. This is probably a bug - please report. </p>
295 </dd>
296 
297 
298 <dt><a name="WMWARN43">[WMWARN43]</a></dt>
299 <dd><p>"You can't make a contrast with 'none'." </p>
300 <p>The 'contrast' option picks black or white depending on what colour the background is. When you set a background of 'none',
301 there is no correct answer, so Weathermap complains. Change 'contrast' to '0 0 0' or '255 255 255' as appropriate. </p>
302 </dd>
303 
304 
305 <dt><a name="WMWARN44">[WMWARN44]</a></dt>
306 <dd><p>"ReadData: <em>NODE/LINK</em> <em>name</em>: You're using asymmetric bandwidth AND half-duplex in the same link. That makes no sense." </p>
307 <p>Half-duplex calculates the percentage usage based on (input+output)/max_bandwidth. You have specified different bandwidth in each direction, but also half-duplex.
308 The calculation is not possible. </p>
309 </dd>
310 
311 
312 <dt><a name="WMWARN45">[WMWARN45]</a></dt>
313 <dd><p>"Zero-length link <em>name</em> skipped." </p>
314 <p>You have a link from a node to the same node without any <a href="config-reference.html#LINK_VIA">VIAs.</a> It isn't possible to draw. </p>
315 </dd>
316 
317 
318 <dt><a name="WMWARN99">[WMWARN99]</a></dt>
319 <dd><p>"<em>something</em> not implemented yet" </p>
320 <p>A planned feature has been partially implemented, and you've tried to use it. Wait for the next release. </p>
321 <p>Because of the way I write Weathermap, there are sometimes parts of the code that are waiting ready for me
322 to finish writing a new feature. If it's the only thing holding back a release, I'll just disable that feature for now. </p>
323 </dd>
324 
325 <dt><a name="WMEDIT01">[WMEDIT01]</a></dt>
326 <dd><p>"The map config directory is not writable by the web server user. You will not be able to edit any files until this is corrected." </p>
327 <p> </p>
328 </dd>
329 
330 <dt><a name="WMEDIT02">[WMEDIT02]</a></dt>
331 <dd><p>"OLD editor config file format. The format of this file changed in version 0.92 - please check the new editor-config.php-dist and update your editor-config.php file." </p>
332 <p> </p>
333 </dd>
334 
335 
336 <dt><a name="WMIMG01">[WMIMG01]</a></dt>
337 <dd><p>"Image file <em>filename</em> is GIF, but GIF is not supported by your GD library. " </p>
338 <p> </p>
339 </dd>
340 
341 <dt><a name="WMIMG02">[WMIMG02]</a></dt>
342 <dd><p>"Image file <em>filename</em> is JPEG, but JPEG is not supported by your GD library. " </p>
343 <p> </p>
344 </dd>
345 
346 <dt><a name="WMIMG03">[WMIMG03]</a></dt>
347 <dd><p>"Image file <em>filename</em> is PNG, but PNG is not supported by your GD library. " </p>
348 <p> </p>
349 </dd>
350 
351 <dt><a name="WMIMG04">[WMIMG04]</a></dt>
352 <dd><p>"Image file <em>filename</em> wasn't recognised (type=<em>type</em>). Check format is supported by your GD library. " </p>
353 <p> </p>
354 </dd>
355 
356 <dt><a name="WMIMG05">[WMIMG05]</a></dt>
357 <dd><p>"Image file <em>filename</em> is unreadable. Check permissions. " </p>
358 <p> </p>
359 </dd>
360 
361 <dt><a name="WMPOLL01">[WMPOLL01]</a></dt>
362 <dd><p>"About to write image file. If this is the last message in your log, increase memory_limit in php.ini" </p>
363 <p>PHP has a hard memory limit, to stop runaway scripts from killing your server. Depending on the version
364 of PHP, this can be quite low (8M in older versions). Weathermap uses a lot (relatively) of memory to produce
365 the large image files. If it hits the PHP memory limit, then PHP just kills the script with no warning. Because it
366 log that it is dead (because it is dead), it logs just before the 'risk' happens. <em>If this log message is <strong>not</strong> the last
367 message in your log file, then <strong>nothing is wrong</strong>!</em> </p>
368 <p>You can disable some messages like this one by changing settings in Cacti. Go to Settings..Misc and set Weathermap Logging to 'Quiet'. If you suddenly
369 get a mystery where Weathermap is only updating some maps, turn it back to 'Chatty' to see what is happening. </p>
370 </dd>
371 
372 <dt><a name="WMPOLL02">[WMPOLL02]</a></dt>
373 <dd><p>"Failed to overwrite <em>filename</em> - permissions of existing file are wrong? " </p>
374 <p>Weathermap couldn't overwrite an output file. Files in the weathermap/output/ directory should be writable by the Cacti poller user. </p>
375 </dd>
376 
377 <dt><a name="WMPOLL03">[WMPOLL03]</a></dt>
378 <dd><p>"Failed to create <em>filename</em> - permissions of output directory are wrong?" </p>
379 <p>The weathermap/output/ directory should be writable by the Cacti poller user. </p>
380 </dd>
381 
382 <dt><a name="WMPOLL04">[WMPOLL04]</a></dt>
383 <dd><p>"Mapfile <em>filename</em> is not readable or doesn't exist" </p>
384 <p>The mapfile could not be opened. That could be because it is not readable by the Cacti poller user, or because the file no longer exists but
385 is still in the database (check the Manage..Weathermaps screen in Cacti). </p>
386 </dd>
387 
388 <dt><a name="WMPOLL05">[WMPOLL05]</a></dt>
389 <dd><p>"No activated maps found. " </p>
390 <p>There are no maps in the database, or no maps that are enabled at the moment. There is also a scheduling
391 facility, so if no maps are due to be updated according to their schedule, you will get this message. The
392 scheduling feature is not yet in use in 0.97. </p>
393 </dd>
394 
395 <dt><a name="WMPOLL05">[WMPOLL06]</a></dt>
396 <dd><p>"Output directory (<em>directory</em>) isn't writable (tried to create '<em>filename</em>'). No maps created. You probably need to make it writable by the poller process (like you did with the RRA directory)" </p>
397 <p>The weathermap/output/ directory should be writable by the Cacti poller user. </p>
398 </dd>
399 
400 <dt><a name="WMPOLL07">[WMPOLL07]</a></dt>
401 <dd><p>"Output directory (<em>directory</em>) doesn't exist!. No maps created. You probably need to create that directory, and make it writable by the poller process (like you did with the RRA directory)" </p>
402 <p>The weathermap/output/ directory doesn't exist. It is part of the standard zip package, so you probably deleted or renamed it. </p>
403 </dd>
404 
405 <dt><a name="WMPOLL08">[WMPOLL08]</a></dt>
406 <dd><p>"Required modules for PHP Weathermap <em>versionnumber</em> were not present. Not running." </p>
407 <p>Run 'php check.php' from the command-line, to find out what modules are missing. </p>
408 </dd>
409 
410 
411 
412 <dt><a name="WMFPING01">[WMFPING01]</a></dt>
413 <dd><p>"RRD DS: RRDTool exists but is not executable? " </p>
414 <p> </p>
415 </dd>
416 
417 
418 <dt><a name="WMFPING02">[WMFPING02]</a></dt>
419 <dd><p>"FPing ReadData: Can't find fping executable. Check path at line 19 of WeatherMapDataSource_fping.php" </p>
420 <p> </p>
421 </dd>
422 
423 
424 <dt><a name="WMFPING03">[WMFPING03]</a></dt>
425 <dd><p>"FPing ReadData: No lines read. Bad hostname? (<em>target</em>)" </p>
426 <p> </p>
427 </dd>
428 
429 <dt><a name="WMRRD01">[WMRRD01]</a></dt>
430 <dd><p>"RRD DS: RRDTool exists but is not executable? " </p>
431 <p>Somehow you have the right path for rrdtool, but the rrdtool binary is not executable by the user that runs weathermap (e.g. your Cacti poller user). Check permissions on your rrdtool binary. </p>
432 </dd>
433 
434 <dt><a name="WMRRD02">[WMRRD02]</a></dt>
435 <dd><p>"RRD DS: Can't find RRDTOOL. Check line 29 of the 'weathermap' script. RRD-based <a href="config-reference.html#LINK_TARGET">TARGETs</a> will fail. " </p>
436 <p>You are using the command-line <tt>weathermap</tt> tool, but the path near the top of that file (around line 29) is not the correct path to your rrdtool binary. Edit that file and put in the correct path if you need Weathermap to be able to read .rrd files. </p>
437 </dd>
438 
439 <dt><a name="WMRRD03">[WMRRD03]</a></dt>
440 <dd><p>"RRD DS: Can't find RRDTOOL. Check your Cacti config. " </p>
441 <p>You have Weathermap integrated into Cacti, but your Cacti settings include an incorrect path to rrdtool. Probably you have a Cacti that doesn't update properly at this stage too, so change the path in Console..Settings..Paths (in Cacti) to point to the right location. </p>
442 </dd>
443 
444 <dt><a name="WMRRD04">[WMRRD04]</a></dt>
445 <dd><p>"RRD ReadData: failed to open pipe to RRDTool: <em>phperrormsg</em> " </p>
446 <p>This is probably a Weathermap bug. It was unable to get rrdtool to read a .rrd file even though the file exists. It <em>might</em> be that the user running Weathermap (or the poller) doesn't have execute permission for rrdtool. </p>
447 </dd>
448 
449 <dt><a name="WMRRD06">[WMRRD06]</a></dt>
450 <dd><p>"Target <em>rrdfile</em> doesn't exist. Is it a file? " </p>
451 <p>You have given an RRD <a href="config-reference.html#LINK_TARGET">TARGET</a> which is a directory instead of a file, or something else unusual like that... </p>
452 </dd>
453 
454 <dt><a name="WMRRD07">[WMRRD07]</a></dt>
455 <dd><p>"RRD ReadData: poller_output: <em>dsname</em> is not a valid DS name for <em>rrdfilename</em> - valid names are: <em>dsnames</em>" </p>
456 <p>This is explained in <a href="http://www.network-weathermap.com/articles/non-standard-ds-names">this article</a> </p>
457 </dd>
458 
459 
460 <dt><a name="WMRRD08">[WMRRD08]</a></dt>
461 <dd><p>"RRD ReadData: poller_output: <em>filename</em> is not a valid RRD filename within this Cacti install. &lt;path_rra&gt; is <em>pathname</em>" </p>
462 <p>The poller_output support works by looking in the Cacti database for a filename that matches your <a href="config-reference.html#LINK_TARGET">TARGET</a> line. However, Cacti
463 stores the filenames relative to the rra/ directory. Weathermap tries to convert your filename to that format, so it can find
464 it in the database, but it sometimes gets it wrong. The &lt;path_rra&gt; is the path that it is expecting to be on the beginning of absolute paths in your <a href="config-reference.html#LINK_TARGET">TARGET.</a> </p>
465 </dd>
466 
467 
468 <dt><a name="WMRRD09">[WMRRD09]</a></dt>
469 <dd><p>"Not enough output from RRDTool." </p>
470 <p>Weathermap ran rrdtool to read the rrd file for your <a href="config-reference.html#LINK_TARGET">TARGET,</a> but only got one line of output, probably an error message.
471 Run with debug logging to see what the output was, which should help figuring out what is wrong. </p>
472 </dd>
473 
474 
475 <dt><a name="WMRRD10">[WMRRD10]</a></dt>
476 <dd><p>"Can't use poller_output for rrd-aggregated data - disabling rrd_use_poller_output" </p>
477 <p> </p>
478 </dd>
479 
480 <dt><a name="WMRRD12">[WMRRD12]</a></dt>
481 <dd><p>"RRD ReadData: poller_output - Cacti environment is not right" </p>
482 <p> </p>
483 </dd>
484 
485 <dt><a name="WMDSSTATS01">[WMDSSTATS01]</a></dt>
486 <dd><p>"DSStats ReadData: Failed to find a filename for DS id <em>number</em>" </p>
487 <p> </p>
488 </dd>
489 
490 
491 
492 <dt><a name="WMEXT01">[WMEXT01]</a></dt>
493 <dd><p>"ExternalScript ReadData: Failed to run external script." </p>
494 <p> </p>
495 </dd>
496 
497 
498 <dt><a name="WMEXT02">[WMEXT02]</a></dt>
499 <dd><p>"ExternalScript ReadData: Not enough lines read from external script (<em>number</em> read, 4 expected)" </p>
500 <p> </p>
501 </dd>
502 
503 
504 
505 
506 
507 
508 
509 
510 <dt><a name="WMSNMP01">[WMSNMP01]</a></dt>
511 <dd><p>"SNMP for <em>hostname</em> has reached <em>number</em> failures. Skipping." </p>
512 <p>The SNMP datasource has a special feature to keep track of how many failures each host has had. This is to avoid the
513 Weathermap process timing out 400 times on a chassis switch that is down. After the first few, it assumes that
514 all requests to that device will fail. See the <a href="targets.html#snmp">SNMP DS documentation</a> for information on how to tune this. </p>
515 </dd>
516 
517 
518 <dt><a name="WMTIME01">[WMTIME01]</a></dt>
519 <dd><p>"Time DS Plugin recognised a <a href="config-reference.html#LINK_TARGET">TARGET,</a> but needs PHP5+ to run." </p>
520 <p>The Time DS plugin uses a PHP function that was introduced in PHP 5, and
521 can't run on PHP 4. </p>
522 </dd>
523 
524 
525 <dt><a name="WMTIME02">[WMTIME02]</a></dt>
526 <dd><p>"Time ReadData: Couldn't recognize <em>string</em> as a valid timezone name" </p>
527 <p>The timezone string you used was not correct. Probably a typo. </p>
528 </dd>
529 
530 </div>
531</body>
532</html>

Powered by WebSVN 2.2.1