Repository navigation
Expand file tree
/
Copy pathfaq.html
More file actions
211 lines (211 loc) · 12.9 KB
/
Copy pathfaq.html
File metadata and controls
211 lines (211 loc) · 12.9 KB
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
<!DOCTYPE html>
<html lang="en">
<head>
<meta charset="utf-8">
<meta name="viewport" content="width=device-width, initial-scale=1">
<title>Troubleshooting and common questions — Network Weathermap 2.0</title>
<link rel="stylesheet" href="../manual.css?v=d7053b1ca317">
</head>
<body>
<a class="skip-link" href="#content">Skip to content</a>
<header class="manual-header">
<a class="brand" href="../index.html">Network Weathermap <span>2.0</span></a>
<p>Cacti plugin manual</p>
</header>
<div class="manual-layout">
<nav class="manual-nav" aria-label="Manual sections">
<a href="main.html">Start here</a><a href="editor.html">Editor</a><a href=
"cacti-plugin.html">Viewing & management</a><a href="appearance.html">Appearance &
images</a><a href="install-cacti.html">Installation</a><a href=
"upgrading.html">Upgrading</a><a aria-current="page" href=
"faq.html">Troubleshooting</a><a href="config-reference.html">Configuration</a><a href=
"targets.html">Data sources</a><a href="advanced.html">Advanced</a><a href=
"cli-reference.html">Command line</a><a href="changes.html">Changes</a><a href=
"errorcodes.html">Error codes</a>
</nav>
<main id="content">
<h1 id="faq">Troubleshooting and common questions</h1>
<p>Start with the WEATHERMAP messages in Cacti's log and the timestamp on the map. A saved
editor change, a newly rendered map and an updated Cacti graph happen at different stages.
Checking which one has stopped updating will help narrow down the problem.</p>
<section id="nothumb">
<h2>The viewer is blank or stale</h2>
<p>Check registration, active status, map permissions, rendering interval and the poller
log. Confirm the poller can read the configuration, images/fonts and RRDs and write output.
A successful editor save does not force a poller run. Check that the browser is showing the
intended map and installation.</p>
</section>
<section id="see_nothing">
<h2>There are no Weathermap log messages</h2>
<p>Confirm the plugin is installed/enabled and the Cacti poller is running. Check whether
rendering is disabled or scheduled less frequently. Enable the plugin Debug Mode
temporarily when needed, reproduce one cycle, then restore the setting to avoid unnecessary
log volume.</p>
</section>
<section id="save">
<h2>Changes do not save or selection does not apply</h2>
<p>In a properties dialog, select a candidate then click Use interface/Add/Replace as
appropriate, followed by Save. Cancel discards dialog edits. Check errors,
destination-directory write permissions and concurrent changes in other tabs. Refresh and
reopen the object to verify the saved result. Do not repeatedly overwrite a map someone
else is editing.</p>
</section>
<section id="picker">
<h2>An interface is missing from search</h2>
<p>Use a shorter phrase from the device/data-source name, interface index or description.
Browse all and use Next/Previous results; only up to 100 matches are returned per page.
Confirm graph permissions and that Cacti has created the interface graph and data source.
The interface picker uses the standard interface query; an arbitrary graph template is not
necessarily an assignable traffic interface. Identical graph titles need clearer names in
Cacti.</p>
</section>
<section id="no_overlib">
<h2>Hover graphs are missing or show the wrong data</h2>
<p>Confirm the map has the intended OVERLIBGRAPH URL and the viewer account can open that
Cacti graph directly. Graph IDs and data-source IDs are different. Traffic sources set the
map reading; preview URLs set images. If a wrong preview remains, inspect main versus
additional preview separately. A CPU preview does not replace traffic measurements. Custom
or remote preview URLs depend on their target server and authentication.</p>
</section>
<section id="overliboffscreen">
<h2>A hover popup is too wide or goes off screen</h2>
<p>The current viewer fits previews to the browser window. First check the graph URL's
<code>graph_width</code> and <code>graph_height</code>, and try the popup at normal browser
zoom. A custom image can have very different dimensions from a Cacti graph.</p>
<p>The older <a href="config-reference.html#LINK_OVERLIBWIDTH">OVERLIBWIDTH</a> and
<a href="config-reference.html#LINK_OVERLIBHEIGHT">OVERLIBHEIGHT</a> directives are still
recognised. They supply size hints; they do not request a different graph from Cacti.
Change the image URL or hover defaults to change the graph itself.</p>
</section>
<section id="gauges">
<h2>Values are eight times too large, or utilisation is wrong</h2>
<p>Ordinary RRD traffic values are bytes/sec and are converted to bits/sec. Use gauge: for
values that should not receive that conversion, such as percentage CPU. Check DS names,
first-endpoint direction, capacity, aggregation and any scale factors. 1G equals 1000M with
KILO 1000. An Errors graph is not a traffic graph. See the data-source guide.</p>
</section>
<section id="spikes">
<h2>A traffic spike is visible now but absent from a preview</h2>
<p>Map snapshots and graphs may cover different timestamps or consolidation intervals.
Compare the map's render time with graph time range, resolution and cache/Boost state.
Refresh the full Cacti graph and compare the same period before concluding that the
measurement is lost. Sharper preview images do not create additional historical
samples.</p>
</section>
<section id="history">
<h2>Undo/Redo is unavailable or refuses a restore</h2>
<p>Close the dialog first. Only the last two saved changes in that map/tab/session are
available. A new edit after Undo clears Redo; concurrent map or dependency changes
invalidate old snapshots. Check writable private PHP temporary storage and browser
tab-coordination support. Storage limits retain up to eight histories and 8 MiB per
authenticated session; inactive histories expire after four hours. Image uploads and
configuration-file deletion are not covered.</p>
<p>History uses the browser's Web Locks API, with a SharedWorker fallback, to coordinate
tabs safely. If neither is available, the editor disables history while keeping normal
editing available. Check browser support and the page's secure context when both buttons
remain unavailable after a successful edit.</p>
</section>
<section id="curves">
<h2>Curved comments remain straight</h2>
<p>Use a TrueType comment font and enable Follow link curve in Map Style. Via Style
determines the route separately. Text uses straight fallback for unsafe bends or
insufficient space. Move the comment percentage, shorten it or adjust the route. Bitmap
fonts cannot provide the same curved glyph rendering.</p>
</section>
<section id="icons">
<h2>Uploading or deleting an image fails</h2>
<p>Use PNG/JPEG/GIF within 5 MB and four million pixels; PHP/web-server limits can be
lower. Check the library directory permissions. Referenced images cannot be deleted,
including references found through includes. Remove assignments first. SVG uploads and
symlink management are not supported by the image form.</p>
</section>
<section id="gdbug">
<h2>Rendering fails, fonts are missing or labels are unreadable</h2>
<p>Check GD image-format support, FreeType, font file paths and PHP memory limits in the
actual rendering environment. Large canvases and images need more memory. Web PHP and
poller CLI PHP can differ. Review logs for the concrete error rather than applying old
Debian/PHP 4 workarounds. Cacti themes style the UI; map colours and fonts are configured
separately.</p>
</section>
<section id="module_not_found">
<h2>A data-source dependency is unavailable</h2>
<p>Check the selected source's requirements: local RRD access/RRDtool, PHP SNMP, fping or a
Cacti integration. Do not install an unrelated PHP module just because an old manual says
so. Read the exact source warning and confirm whether the dependency exists under the
poller account.</p>
</section>
<section id="nofunction">
<h2>A PHP function or class is missing</h2>
<p>Confirm the installed plugin files belong to one consistent release and that Cacti/PHP
versions meet requirements. Verify required extensions under both PHP environments. Do not
copy random older libraries into the plugin to silence the error.</p>
</section>
<section id="logo">
<h2>Can a logo or other image appear without a link?</h2>
<p>Yes. Use a node with an icon and no connected links; omit its label if unnecessary.
Upload the image through Manage Images and assign it in Node Properties. A background is
more suitable when the image should define the canvas backdrop.</p>
</section>
<section id="bends">
<h2>How do I bend a link around other objects?</h2>
<p>Open Link Properties and choose <strong>Via</strong>, then click the canvas to place a
bend. Via Style chooses a curved or angled route. In raw configuration, each <a href=
"config-reference.html#LINK_VIA">VIA</a> adds a point along the route:</p>
<pre><code>LINK uplink
NODES router switch
VIA 200 100
VIA 360 100</code></pre>
<p>The endpoints must already exist. Moving a comment along a link changes its text
position; it does not add a bend.</p>
</section>
<section id="parallel">
<h2>Two links between the same nodes overlap</h2>
<p>Give each link its own via point so the paths pass on different sides. For more control,
use endpoint offsets in <a href="config-reference.html#LINK_NODES">NODES</a>; the reference
includes pictures and examples of parallel links. Each link keeps its own traffic source,
capacity and graph URLs.</p>
<p>If you want one arrow showing the total instead, use <a href=
"editor.html#combining">combined traffic sources</a>. That changes what is measured, rather
than just separating the lines visually.</p>
</section>
<section id="aggregate">
<h2>Combining sources did not combine the graphs</h2>
<p>This is expected: TARGET sums readings separately for IN and OUT, while INFOURL and
OVERLIBGRAPH remain independent. Create a matching aggregate graph in Cacti if you want a
historical total, then configure its URLs. Separate links are often clearer for main/backup
circuits.</p>
</section>
<section id="editor_requests">
<h2>A setting is not exposed by the form</h2>
<p>Use Edit Raw Configuration and the configuration reference for supported expert options.
Report missing workflows or unclear labels to the Cacti plugin issue tracker with a
concrete example; older claims that the editor cannot upload images, edit colours or work
with curves no longer apply.</p>
</section><span id="feature_requests"></span><span id="repayme"></span>
<section id="timezone">
<h2>Timestamp timezone or locale looks wrong</h2>
<p>Compare the PHP timezone and locale used by the poller with those used by web PHP. The
renderer uses Intl-based strftime-style formatting for timestamps. A timezone name in a
time: target is separate from the server timezone. Use a valid PHP timezone identifier and
check the displayed map timestamp after rendering.</p>
</section>
<section id="report">
<h2>Report a reproducible problem</h2>
<p>Include Cacti, Weathermap, PHP and RRDtool versions, browser/theme, exact steps,
expected/actual results and relevant log lines. Identify release tag versus develop commit.
Provide a minimal sanitised map when practical. Remove community strings, passwords, tokens
and private addresses before posting publicly.</p>
</section>
<footer>
<p>Network Weathermap 2.0, maintained by The Cacti Group. Based on the original PHP Network
Weathermap and manual by Howard Jones, © 2005–2019; Cacti fork contributions © 2022–2026
The Cacti Group and contributors.</p>
<p><a href="https://github.com/Cacti/plugin_weathermap">Project</a> · <a href=
"https://github.com/Cacti/plugin_weathermap/issues">Report a problem</a> · <a href=
"https://forums.cacti.net/">Cacti forums</a> · <a href="../../LICENSE">License</a> ·
<a href="../../COPYING">Additional license notices</a></p>
</footer>
</main>
</div>
</body>
</html>