-
Notifications
You must be signed in to change notification settings - Fork 0
/
Copy path14_faq.html
478 lines (332 loc) · 18.7 KB
/
14_faq.html
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
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
436
437
438
439
440
441
442
443
444
445
446
447
448
449
450
451
452
453
454
455
456
457
458
459
460
461
462
463
464
465
466
467
468
469
470
471
472
473
474
475
476
477
478
<!DOCTYPE html>
<!--[if IE 8]><html class="no-js lt-ie9" lang="en" > <![endif]-->
<!--[if gt IE 8]><!--> <html class="no-js" lang="en" > <!--<![endif]-->
<head>
<meta charset="utf-8">
<meta name="viewport" content="width=device-width, initial-scale=1.0">
<title>Frequently Asked Questions — RPi-Monitor v2.13-r0</title>
<link rel="shortcut icon" href="_static/favicon.ico"/>
<link rel="stylesheet" href="_static/css/theme.css" type="text/css" />
<link rel="stylesheet" href="_static/pygments.css" type="text/css" />
<link rel="next" title="Configuration" href="20_index.html" />
<link rel="prev" title="Understanding program execution" href="13_execution.html" />
<script src="//pagead2.googlesyndication.com/pagead/js/adsbygoogle.js"></script>
<script>
(adsbygoogle = window.adsbygoogle || []).push({
google_ad_client: "ca-pub-6853682829194266",
enable_page_level_ads: true
});
</script>
<script async src="https://www.googletagmanager.com/gtag/js?id=UA-114314379-1"></script>
<script>
window.dataLayer = window.dataLayer || [];
function gtag(){dataLayer.push(arguments);}
gtag('js', new Date());
gtag('config', 'UA-18642541-8');
</script>
<script src="_static/js/modernizr.min.js"></script>
</head>
<body class="wy-body-for-nav">
<div class="wy-grid-for-nav">
<nav data-toggle="wy-nav-shift" class="wy-nav-side">
<div class="wy-side-scroll">
<div class="wy-side-nav-search">
<a href="index.html" class="icon icon-home"> RPi-Monitor
</a>
<div class="version">
2.13
</div>
<div role="search">
<form id="rtd-search-form" class="wy-form" action="search.html" method="get">
<input type="text" name="q" placeholder="Search docs" />
<input type="hidden" name="check_keywords" value="yes" />
<input type="hidden" name="area" value="default" />
</form>
</div>
</div>
<div class="wy-menu wy-menu-vertical" data-spy="affix" role="navigation" aria-label="main navigation">
<ul>
<li class="toctree-l1"><a class="reference internal" href="01_features.html">Keys features of RPi-Monitor</a></li>
</ul>
<ul class="current">
<li class="toctree-l1 current"><a class="reference internal" href="10_index.html">Getting started</a><ul class="current">
<li class="toctree-l2"><a class="reference internal" href="11_installation.html">Installation and upgrade</a></li>
<li class="toctree-l2"><a class="reference internal" href="12_custom_installation.html">Custom installation</a></li>
<li class="toctree-l2"><a class="reference internal" href="13_execution.html">Understanding program execution</a></li>
<li class="toctree-l2 current"><a class="current reference internal" href="#">Frequently Asked Questions</a></li>
</ul>
</li>
</ul>
<ul>
<li class="toctree-l1"><a class="reference internal" href="20_index.html">Configuration</a></li>
</ul>
<ul>
<li class="toctree-l1"><a class="reference internal" href="30_index.html">Usages</a></li>
</ul>
<ul>
<li class="toctree-l1"><a class="reference internal" href="40_index.html">To go further</a></li>
</ul>
<hr />
<div style="padding: 0;">
<script async src="//pagead2.googlesyndication.com/pagead/js/adsbygoogle.js"></script>
<ins class="adsbygoogle"
style="display:inline-block;width:300px;height:250px"
data-ad-client="ca-pub-6853682829194266"
data-ad-slot="2876944524"></ins>
<script>
(adsbygoogle = window.adsbygoogle || []).push({});
</script>
</div>
</div>
</div>
</nav>
<section data-toggle="wy-nav-shift" class="wy-nav-content-wrap">
<nav class="wy-nav-top" aria-label="top navigation">
<i data-toggle="wy-nav-top" class="fa fa-bars"></i>
<a href="index.html">RPi-Monitor</a>
</nav>
<div class="wy-nav-content">
<div class="rst-content">
<div role="navigation" aria-label="breadcrumbs navigation">
<ul class="wy-breadcrumbs">
<li><a href="index.html">Docs</a> »</li>
<li><a href="10_index.html">Getting started</a> »</li>
<li>Frequently Asked Questions</li>
<li class="wy-breadcrumbs-aside">
<!-- User defined GitHub URL -->
<a href="https://github.com/XavierBerger/RPi-Monitor/blob/develop/docs/source/14_faq.rst" class="fa fa-github"> Edit on GitHub</a>
</li>
</ul>
<hr/>
</div>
<div role="main" class="document" itemscope="itemscope" itemtype="http://schema.org/Article">
<div itemprop="articleBody">
<div class="section" id="frequently-asked-questions">
<h1>Frequently Asked Questions<a class="headerlink" href="#frequently-asked-questions" title="Permalink to this headline">¶</a></h1>
<p><strong>RPi-Monitor</strong> is displaying <code class="docutils literal"><span class="pre">NaN</span></code> instead of value in my “unsupported” distro. Can you fixe this issue?</p>
<blockquote>
<div><p>There are a lot of GNU/Linux distribution available, I can’t support all of them.
I decided since the beginning use to Raspbian as target OS. The version v2.13 has been
tested with <code class="docutils literal"><span class="pre">2017-11-29-raspbian-stretch-lite.img</span></code> on <strong>Raspberry Pi B</strong>.</p>
<p>Remember, in <strong>RPi-Monitor</strong>, everything is configurable. It should then be possible
to update configuration files to match the specificities of your distro.</p>
</div></blockquote>
<div class="line-block">
<div class="line"><br /></div>
</div>
<p><strong>RPi-Monitor</strong>‘s graphs are not clean and frequently drop down to zero as in screenshot bellow. How can I have a clean curve?</p>
<blockquote>
<div><a class="reference internal image-reference" href="_images/faq001.png"><img alt="_images/faq001.png" class="align-center" src="_images/faq001.png" style="width: 400px;" /></a>
<p><strong>RPi-Monitor</strong> is periodically getting data from program of files.
If the program is not answering or if the file is empty, the value is unknown.
This unknown value will be drawn as a zero in graphs. If, as in the upper
example, the program reading the sensor isn’t giving reliable values, it is
advised to create a script writing the temperature result into a file and to
configure <strong>RPi-Monitor</strong> to read this file. In this case, if the file is not
updated, the previous value will be read and drawn in graphs.</p>
</div></blockquote>
<div class="line-block">
<div class="line"><br /></div>
</div>
<p><strong>RPi-Monitor</strong>‘s web interface is not working, I’ve only white pages?</p>
<blockquote>
<div><strong>RPi-Monitor</strong> requires HTML5 local storage and cookies to work properly.
You should check that these both functionalities are activated into your browser
and check that no plug-ins is blocking them.</div></blockquote>
<div class="line-block">
<div class="line"><br /></div>
</div>
<p>Is <strong>RPi-Monitor</strong> supporting distribution XXX? Can you make <strong>RPi-Monitor</strong> compatible with distribution XXX?</p>
<blockquote>
<div><strong>RPi-Monitor</strong> was developed on Raspbian. This distribution is then fully supported.
I will not officially support any other distribution but you will find in
github repository as well as in this documentation some configuration files that
may help you to configure <strong>RPi-Monitor</strong> on your system.
Remember, <strong>RPi-Monitor</strong> is highly configurable and should be able to run on
every system able to run <code class="docutils literal"><span class="pre">perl</span></code>. Have a look to <a class="reference external" href="27_configuration_templates.html">examples</a>
in this documentation for details.</div></blockquote>
<div class="line-block">
<div class="line"><br /></div>
</div>
<p>I have a problems running <code class="docutils literal"><span class="pre">rpimonitord</span></code>: failed “Can’t locate _______.pm in @INC ...</p>
<blockquote>
<div>The installation is not done properly. You should read again the installation
procedure and pay attention to the dependencies.</div></blockquote>
<div class="line-block">
<div class="line"><br /></div>
</div>
<p>I would like to use my favorite web server instead of the one embedded into <strong>RPi-Monitor</strong>. Is it possible?</p>
<blockquote>
<div><strong>Yes</strong>, this is possible but not recommended. <strong>RPi-Monitor</strong> embedded web server is
optimized to reduce the usage of the SDCard (using shared memory instead of writing data on disk),
reduce the resources used into the system. The Web interface is requiring some specific feature that can only
be delivered by <strong>RPi-Monitor</strong> embedded web server (like empty.rrd file generation
ensuring a clean display of graphs).</div></blockquote>
<div class="line-block">
<div class="line"><br /></div>
</div>
<p>Can you add login/password and authentication to RPI-Monitor web interface?</p>
<blockquote>
<div><p><strong>No</strong>. I’ll never add such a feature to <strong>RPi-Monitor</strong>. Why? Just because it is
something complex to do in a clean and fully secured way. Some software are
already design to do the job and they do it well.</p>
<p>A <a class="reference external" href="34_autentication.html#authentication-and-secure-access">solution is proposed in this documentation using nginx</a> frontend.</p>
</div></blockquote>
<div class="line-block">
<div class="line"><br /></div>
</div>
<p>Can I do customize <strong>RPi-Monitor</strong>, change data extracted, add images, change texts...</p>
<blockquote>
<div><strong>Yes</strong>, in <strong>RPi-Monitor</strong> almost everything is configurable. This can be done by
configuration file. Everything is explained in this documentation.</div></blockquote>
<div class="line-block">
<div class="line"><br /></div>
</div>
<p>I tried to install <strong>RPi-Monitor</strong> into an OS not officially supported and some data are missing. How can I fix it?</p>
<blockquote>
<div>As said previously, in <strong>RPi-Monitor</strong> almost everything is configurable. You
should find the command to execute or the file to read to get the missing
value directly in the shell. Once the command is found you will need to
update the configuration file. Have a look to <strong>RPi-Monitor</strong> configuration chapter and to
Interactive Configuration Helper (<code class="docutils literal"><span class="pre">rpimonitord</span> <span class="pre">-i</span></code>).</div></blockquote>
<div class="line-block">
<div class="line"><br /></div>
</div>
<p>I would like to monitor a cluster of raspberries with your tool. Is there a way to gather the whole data in one node?</p>
<blockquote>
<div><p>It could have any answer to such a question. One possibility would be to use
ssh and configure <strong>RPi-Monitor</strong> to execute commands on each remote nodes of
your cluster and process the data locally.</p>
<p>To do so, you should create one configuration file per node to monitor and
use all of them in <strong>RPi-Monitor</strong>. Using pages feature could be very usefull.
You can use the main page to display some consolidate data in addition to one
page per cluster.</p>
<p>You can also use the snmp capabilities to share data from node to central point.</p>
</div></blockquote>
<div class="line-block">
<div class="line"><br /></div>
</div>
<p>I found a bug into <strong>RPi-Monitor</strong>. How can I share my discovery?</p>
<blockquote>
<div>You should open an issue in <a class="reference external" href="https://github.com/XavierBerger/RPi-Monitor/issues">github</a>
and describe you problem and how to reproduce it.</div></blockquote>
<div class="line-block">
<div class="line"><br /></div>
</div>
<p>Download bandwidth is shown as negative values. It’s bug or feature?</p>
<blockquote>
<div>This is a feature :-). But, remember, everything is customizable in <strong>RPI-Monitor</strong>...</div></blockquote>
<div class="line-block">
<div class="line"><br /></div>
</div>
<p>I want to create a package for my favorite distribution which is not supported by defalut. How can I contribute to this project?</p>
<blockquote>
<div><strong>RPi-Monitor</strong> source code is hosted in github. Refer to
<cite>Packaging section of contributing chapter <41_contributing.html#packaging></cite> for details.</div></blockquote>
<div class="line-block">
<div class="line"><br /></div>
</div>
<p>I’ve some issue with my installation or customization of <strong>RPi-Monitor</strong> and I want to reinstall it from scratch. How can I do it?</p>
<blockquote>
<div><p>Here is the instruction to reinstall <strong>RPi-Monitor</strong> from scratch:
First, uninstall <strong>RPi-Monitor</strong> with the following command:</p>
<div class="highlight-default"><div class="highlight"><pre><span></span><span class="n">apt</span><span class="o">-</span><span class="n">get</span> <span class="n">purge</span> <span class="n">rpimonitor</span>
<span class="n">rm</span> <span class="o">-</span><span class="n">fr</span> <span class="o">/</span><span class="n">etc</span><span class="o">/</span><span class="n">rpimonitor</span>
<span class="n">rm</span> <span class="o">-</span><span class="n">fr</span> <span class="o">/</span><span class="n">usr</span><span class="o">/</span><span class="n">share</span><span class="o">/</span><span class="n">rpimonitor</span>
</pre></div>
</div>
<p>Then reinstall by following <a class="reference external" href="11_installation.html#installation-from-repository">installation instruction</a>
of this documentation.</p>
</div></blockquote>
<div class="line-block">
<div class="line"><br /></div>
</div>
<p>Some data are not extracting correctly at boot but when I restart <code class="docutils literal"><span class="pre">rpimonotord</span></code> everything becomes OK until I reboot. How can I fix thi issue?</p>
<blockquote>
<div>If you reach such situation, you certainly configure your source using a
command whitout the full path. For example <code class="docutils literal"><span class="pre">gettemp.sh</span></code> instead of
<code class="docutils literal"><span class="pre">/usr/bin/gettemp.sh</span></code>. The first command is working in your shell because the
variable $PATH is set and the executable is reachable (that why it work when
you restart <code class="docutils literal"><span class="pre">rpimonitord</span></code>).
When you start your computer, the $PATH variable is not set so <code class="docutils literal"><span class="pre">gettemp.sh</span></code>
will not work. The solution is to use the full path command <code class="docutils literal"><span class="pre">/usr/bin/gettemp.sh</span></code></div></blockquote>
<div class="line-block">
<div class="line"><br /></div>
</div>
<p>I just update my distribution and <strong>RPi-Monitor</strong> is still saying that packages required to be updated. Why?</p>
<blockquote>
<div><p>If you want to update this information immediately, you can execute this script
manually: <code class="docutils literal"><span class="pre">/etc/init.d/rpimonitord</span> <span class="pre">update</span></code>.
You can also install dpkg hook to execut this update automatically.</p>
<p>Refer to <a class="reference external" href="13_execution.html#startup-script">startup section</a> of this documentation.</p>
</div></blockquote>
<div class="line-block">
<div class="line"><br /></div>
</div>
<p>I required better resolutions of the reading provided by <strong>RPi-Monitor</strong>. Can we increase the frequency with which <strong>RPi-Monitor</strong> collects the data?</p>
<blockquote>
<div><strong>Yes</strong>, it is possible to define the RRD structure per data extracted.
Refer to documentation and man page to know how use this advanced feature.</div></blockquote>
<p>I want to uninstall <strong>RPi-Monitor</strong>, How can I do it?</p>
<blockquote>
<div><p>To uninstall <strong>RPi-Monitor</strong>, you can execute the following command:</p>
<div class="highlight-default"><div class="highlight"><pre><span></span><span class="n">sudo</span> <span class="n">apt</span><span class="o">-</span><span class="n">get</span> <span class="n">remove</span> <span class="n">rpimonitor</span>
</pre></div>
</div>
<p>or:</p>
<div class="highlight-default"><div class="highlight"><pre><span></span><span class="n">sudo</span> <span class="n">apt</span><span class="o">-</span><span class="n">get</span> <span class="n">purge</span> <span class="n">rpimontor</span>
</pre></div>
</div>
<p>Finally delete the directory <code class="docutils literal"><span class="pre">/var/lib/rpimonitor</span></code></p>
</div></blockquote>
</div>
</div>
</div>
<footer>
<div class="rst-footer-buttons" role="navigation" aria-label="footer navigation">
<a href="20_index.html" class="btn btn-neutral float-right" title="Configuration" accesskey="n" rel="next">Next <span class="fa fa-arrow-circle-right"></span></a>
<a href="13_execution.html" class="btn btn-neutral" title="Understanding program execution" accesskey="p" rel="prev"><span class="fa fa-arrow-circle-left"></span> Previous</a>
</div>
<hr/>
<div role="contentinfo">
<p>
© Copyright 2018, Xavier Berger.
Last updated on Mar 18, 2018.
</p>
</div>
Built with <a href="http://sphinx-doc.org/">Sphinx</a> using a <a href="https://github.com/rtfd/sphinx_rtd_theme">theme</a> provided by <a href="https://readthedocs.org">Read the Docs</a>.
<ins class="adsbygoogle"
style="display:block"
data-ad-client="ca-pub-6853682829194266"
data-ad-slot="2876944524"
data-ad-format="auto"></ins>
<script>
(adsbygoogle = window.adsbygoogle || []).push({});
</script>
</footer>
</div>
</div>
</section>
</div>
<script type="text/javascript">
var DOCUMENTATION_OPTIONS = {
URL_ROOT:'./',
VERSION:'',
LANGUAGE:'None',
COLLAPSE_INDEX:false,
FILE_SUFFIX:'.html',
HAS_SOURCE: true,
SOURCELINK_SUFFIX: ''
};
</script>
<script type="text/javascript" src="_static/jquery.js"></script>
<script type="text/javascript" src="_static/underscore.js"></script>
<script type="text/javascript" src="_static/doctools.js"></script>
<script type="text/javascript" src="_static/js/theme.js"></script>
<script type="text/javascript">
jQuery(function () {
SphinxRtdTheme.Navigation.enableSticky();
});
</script>
</body>
</html>