jablonka.czprosek.czf

weathermap

 Subversion Repositories:
[/] [docs/] [pages/] [faq.html] - Blame information for rev 16

 

Line No. Rev Author Line
11simandl<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN"
2 "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
3 
4<html lang="en" xml:lang="en">
5<head>
6 <link rel="stylesheet" type="text/css" media="screen" href=
7 "weathermap.css" />
8 <meta name="generator" content=
9 "HTML Tidy for Mac OS X (vers 1st December 2004), see www.w3.org" />
10 
11 <title>PHP Weathermap
12v0.91
13 -FAQ</title>
14<style type="text/css" media="print">
15/*<![CDATA[*/
16body { font-size: 12pt; }
17a { color: black; text-decoration: underline; font-weight: normal;}
18/*]]>*/
19</style>
20</head>
21 
22<body>
23 <div id="frame">
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.91
44</h1>
45 <h4>Copyright &copy; 2005-2007 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 <h2><a name="faq" id="faq">FAQ &amp; Useful Tips</a></h2>
52 
53 <h3>FAQs</h3>
54 
55 <p>Here are a few things that have come up more than once from
56 previous versions. Also, it's worth checking the <a href=
57 "http://www.network-weathermap.com/">online
58 copy</a> of this document, which will be updated over time.</p>
59 <p class="important">If something isn't described here, <em>check the cacti.log for errors</em>. Weathermap usually produces a useful error message if there is a problem. Next, try setting Cacti's Log Level to DEBUG for 10 minutes, and then have a look in cacti.log. Don't forget to turn the Log Level back down again!</p>
60 
61 <dl class="faq">
62 <dt><a name="module_not_found"></a>I get some error about 'module not found', or
63 similar...can you help?</dt>
64 
65 <dd><p>The answer is probably no, or at least not directly. In
66 most cases, this is the result of a missing dependency,
67 either PHP with no GD, or with an older version, or without
68 PHP support, or without TrueColour support. I do try to
69 extend weathermap to make these error messages more
70 explanatory wherever possible, but ultimately, you need to
71 get PHP working first. </p><p>Beware that on some systems you can
72 have a working GD in your 'web' PHP (mod_php) and still have
73 a non-working command-line PHP - Debian and derivatives (Ubuntu) can suffer from this. </p><p>Also be sure that the PHP you
74 get from the command-line is the same installation as you
75 expect - 'which php' and 'whereis php' will provide some *nix
76 users with an idea that they are running the right one, as
77 does 'php -m' and 'php -v' (is it the version you expect?).
78 Also, some packaged PHP systems (MAMP, XAMPP, WAMP etc) have
79 the module installed, but disabled by default. Check your
80 php.ini to see if there is a commented-out line like
81 'extension=php_gd.dll'.</p>
82 <p>In 0.91 and newer, you may find the check.php to be useful when figuring out which php.ini and php version you should be looking at - http://yourserver/plugins/weathermap/check.php for the webserver (editor/rebuild now) version, and <tt>php check.php</tt> from the command-line for the CLI (Cacti Poller/command-line tool) version.</p>
83 </dd>
84 
85 <dt><a name="see_nothing"></a>I don't see ANYTHING in the logs when using the Cacti
86 plugin.</dt>
87 
88 <dd><p>Check if this is still the case when Weathermap is the
89 only plugin. If a plugin dies completely, it takes the poller
90 and any remaining plugins with it. This appears to be a
91 problem with some versions of 'Reports' in particular, where
92 anything listed after Reports in the plugins[] list will not
93 be run.</p>
94 </dd>
95 
96 
97 <dt><a name="nofunction"></a>I get an error message about function_exists()</dt>
98 
99 <dd><p>This is PHP telling you that a function that Weathermap requires is not available in your PHP installation. Usually, it's to do with either GD, or FreeType. It can be that you have those libraries, but not current enough versions, or versions compiled without particular options. For example, it's possible to have FreeType installed, GD installed, the php-gd module installed, but that the GD library wasn't compiled with FreeType <em>support</em> so they don't know how to talk to each other. This tends to be less of a problem on packaged systems than where you build your own libraries. </p>
100 <p>In 0.91 and newer, you may find the check.php to be useful when figuring out which php.ini and php version you should be looking at, and which functions might be missing - http://yourserver/plugins/weathermap/check.php for the webserver (editor/rebuild now) version, and <tt>php check.php</tt> from the command-line for the CLI (Cacti Poller/command-line tool) version.</p>
101 
102 </dd>
103 
104 <dt><a name="nothumb"></a>My maps don't get created/updated (or "This map hasn't been created yet")</dt>
105 
106 <dd><p>This is almost always a permissions problem. Look in your cacti.log for lines starting WEATHERMAP to see what
107 is going wrong. </p></dd>
108 
109 <dt><a name="no_overlib"></a>I've defined some <a href="config-reference.html#LINK_OVERLIBGRAPH">OVERLIBGRAPH</a> lines, but nothing appears
110 in the map HTML when I use the command-line tool.</dt>
111 
112 <dd><p>For historical reasons, the default format for <a href="config-reference.html#GLOBAL_HTMLSTYLE">HTMLSTYLE</a>
113 is 'static' which avoids javascript. To get the overlib
114 graphs to appear you need to have <a href="config-reference.html#GLOBAL_HTMLSTYLE">'HTMLSTYLE</a> overlib' near
115 the top of your map configuration file.</p></dd>
116 
117 <dt><a name="gauges"></a>The value from my RRD data is much too big!</dt>
118 
119 <dd><p>Is it about 8 times too big, by any chance? Historically, Weathermap was mainly used for SNMP Interface statistics, which use bytes-per-second counters ("octet counters" in SNMP-speak). Because of this, the standard RRD datasource plugin multiplies everything by 8, to get back to bits-per-second. New in 0.9, you can get the 'raw' value from an RRD file by using <a href="targets.html#rrd">'gauge:' as a prefix</a>.</p></dd>
120 
121 <dt><a name="timezone"></a>The timestamp on my map is all wrong!</dt>
122 
123 <dd><p>I have not seen this one myself, but a Chinese user has, and
124 it seems that PHP doesn't always use your system timezone correctly. The fix is to edit php.ini to change date.timezone </p></dd>
125 
126 
127 <dt><a name="gdbug"></a>Weathermap just dies without warning on my Debian/Ubuntu system</dt>
128 
129 <dd><p> It's a GD bug. It's documented <a href="http://bugs.libgd.org/4">here</a>, and the reason it mainly affects Debian is that Debian links to the system GD (version 2.0.33) not the built-in PHP one (2.0.28ish). For whatever reason, the problems aren't present in the PHP GD library, which has a different alpha-blending implementation as far as I can see from the docs. </p>
130<p>The bugs are apparently fixed in GD 2.0.34, which has been released and is in Debian unstable. Users report that upgrading to the version of libgd2-xpm from unstable will fix this problem if you can't wait, or recompile PHP to use it's own GD library.</p>
131</dd>
132 <dt><a name="icons"></a>Where can I find some icons to use with Weathermap? Why
133 don't you have any supplied with it?</dt>
134 
135 <dd><p>
136 There are plenty of sources online. A good google search
137 would be 'visio network icons'. Some to get you started:
138 
139 <ul>
140 <li><a href=
141 "http://www.cisco.com/web/about/ac50/ac47/2.html">Cisco's
142 distinctive icons</a> in a number of formats, and I have converted a
143 set of these into <a href="http://wotsit.thingy.com/haj/cacti/">PNG with transparency</a>, too.</li>
144 
145 <li><a href="http://www.nagiosexchange.org/">Nagios
146 Exchange</a> has icons for network maps</li>
147 
148 <li>For your own use only, you could use the ones that
149 come with MS Visio. Obviously these can't be
150 redistributed!</li>
151 </ul>As for the second part, I can't draw, and I don't know
152 of any freely distributable icons. Feel free to draw some
153 for me, and make them open source.</p>
154 </dd>
155 
156 <dt><a name="logo"></a>How can I embed an image (like my company's logo) in my
157 maps? I don't want to have to create a special
158 background...</dt>
159 
160 <dd><p>You can create a <a href="config-reference.html#NODE_NODE">NODE</a> with no links and no label, but
161 with an <a href="config-reference.html#NODE_ICON">ICON.</a> The <a href="config-reference.html#NODE_ICON">ICON</a> is your logo. You can also use this to
162 embed images from somewhere else - even dynamically produced
163 ones - how about MRTG graphs or RRD stripgraphs embedded in
164 your map?</p></dd>
165 
166 <dt><a name="curves"></a>I need to have a link that isn't just a straight
167 line...how can I do this?</dt>
168 
169 <dd><p>
170 You can use the <a href=
171 "config-reference.html#LINK_VIA">VIA</a> keyword to make a
172 link go around corners.:
173 
174 <div class="shell">
175 <pre>
176<a href="config-reference.html#LINK_LINK">LINK</a> bendylink
177 <a href="config-reference.html#LINK_NODES">NODES</a> node1 node2
178 <a href="config-reference.html#LINK_VIA">VIA</a> 200 300
179 <a href="config-reference.html#LINK_VIA">VIA</a> 360 240
180</pre>
181 </div></p>
182 </dd>
183 
184 <dt><a name="parallel"></a>I need to have more than one link from node A to node B,
185 but they just overlap...how can I do this?</dt>
186 
187 <dd><p>See <a href="http://www.network-weathermap.com/articles/parallel">this article</a> for more about parallel links.</p>
188 </dd>
189 
190 <dt><a name="aggregate"></a>I still have two links, but I use MLPPP, and I want to
191 see a single link on the map for both physical lines.</dt>
192 
193 <dd>
194 <p>See <a href="http://www.network-weathermap.com/articles/parallel">this article</a> for more about parallel and aggregated links.</p>
195 </dd>
196 
197 <dt><a name="editor_requests"></a>When will you make the editor work like
198 <em>XYZ</em>?</dt>
199 
200 <dd><p>Adding the editor in 0.7 has made adding a new core
201 weathermap into something that needs more consideration.
202 Anything that dramatically changes how you make a map (like
203 the <a href="config-reference.html#LINK_LINK">LINK</a> DEFAULT and <a href="config-reference.html#NODE_NODE">NODE</a> DEFAULT changes for 0.7) should
204 mean a similarly big change in the editor. All the options
205 should really be editable from the editor too. In reality,
206 just getting the editor to run smoothly on more than one
207 browser is sometimes painful, let alone re-tooling it to add
208 new features. With that all said, there very likely will be a
209 new version of the editor in 0.9, with drag &amp; drop
210 editing, and (more) complete support for all the new features
211 since 0.6 (which is the version that the editor really was
212 written for - it was written before I added new 0.7 features.
213 D'oh!).</p></dd>
214 
215 <dt><a name="feature_requests"></a>Will you extend weathermap to do <em>XYZ</em>?</dt>
216 
217 <dd><p>It depends. I have an internal idea of what I want
218 weathermap to be like. I don't want it to feel (too much)
219 like a small program with everyone's wishlist bolted on
220 afterwards. If it seems like something that a number of
221 people could use, and doesn't dramatically change the
222 direction of the program (it won't get <a href=
223 "http://en.wikipedia.org/wiki/Zawinski's_Law_of_Software_Envelopment"
224 title="jwz's law of software envelopment">mail-reading
225 capability</a> anytime soon), then it stands a better chance.
226 Things that take dozens of parameters to adjust something
227 very subtle are less likely. Ultimately, it is a GPLed
228 program though, so <i>you</i> can <i>always</i> add your own
229 features! I try to keep a todo list on the website for
230 current work-in-progress. Obviously, things that <i>I</i>
231 want are <i>always</i> sensible and useful<tt>:-)</tt> .</p></dd>
232 
233 <dt><a name="repayme"></a>How can I possibly repay you for making my life and work
234 so much easier?</dt>
235 
236 <dd><p>Actually, this one isn't very frequent. If you do find
237 yourself asking it, feel free to <a href="http://www.network-weathermap.com/support/donate">make a donation, or send a gift,</a>
238 though. However, I do like to <a href="http://www.network-weathermap.com/contact">hear from users</a> anyway - it's nice to
239 know that people do use this thing.</p></dd>
240 </dl>
241 </div>
242</body>
243</html>

Powered by WebSVN 2.2.1