Webmin System stats git

<c>
config
<q>
I do not have any link in config page
<a>
<em>release</em> &lt; 0.8.6<br /> 
it seems to be a bug in our language usage, so
check your webmin language (in webmin configuration).
the english selection seems to always work. <br />

or you can have a direct access to module config
with url like http://localhost:10000/sysstats/edit_module.cgi?idx=disk-0.7.5
(for disk module)
<br />
fixed in 0.8.6 release

<c>
old
<q>
disk, irq and network modules don't work
<a>
first, check for /bin/bash2 file on your system
if it doesn't exist, create a link from /bin/bash to /bin/bash2
<br />
second, this modules need to be configured if you have a release
before 0.8.3

<c>
installation
<q>
does webminstat work on my unix ?
<a>
webminstat can work on any unix system, but some acquisition scripts are only
written for linux now, see <a href="require.html">requirement</a> page.<br />
So, want to <a href="contribute.html">contribute</a> ?

<c>
installation
<q>
no rrd files
<a>
during installation, rrdtool was not found, so the data file were not created
2 solutions :
<ul>
<li>create a link from your rrdtool to /usr/bin/rrdtool, remove all
webminstats files and reinstall</li>
<li>change your /etc/webmin/sysstats/config, suppress your modules and
reinstall them. be sure to put the path to the command with the binary</li>
</ul> 

<c>
old
<q>
error message from cron : $(!tmp) ...  bad substitution
<a>
it occurs when some bash version 2 syntaxe script is sent to bash version
1.<br />
fixed in webminstat version 0.7.4 (explicit call to bash2 or
change to bash 1 syntaxe)

<c>
modules
<q>
why do I have only one month of data on screen ?
<a>
It's because the files used to store data are too small :)
Do not laugh !, we use rrdtool round-robin data file (constant size)
to store data, and it was created to store only one month.
To store 2 month, use the following commands :
cd /etc/webmin/sysstats/modules
for fic in `find . -name "*.rrd"`; do 
  rrdtool resize $fic 3 GROW 1000
  mv -f  resize.rrd $fic
 done
<br />
the release 0.12.0 adds a yearly graph

<c>
installation
<q>
I install the rpm file and I do not have access to the webminstats
<a>
<ul>
<li>you have to go to webmin page (http://localhost:10000)</li>
<li>open webmin/webmin users/</li>
<li>open root user and add (click) this module in authorized module list</li>
</ul> 

<c>
old
<q>
my network module do not work in 0.8.2 release
<a>
this is a bug, it has been fixed in 0.8.3 release.
all modules now use "average" consolidation

<c>
old
<q>
I upgrade webminstats, and I loose old data
<a>
there is a module upgrade detection, which work when you upgrade a webminstat
module. but it does not work on a webminstats global update (because webmin
erase all datas). 
You have to go /etc/webmin/sysstats/modules and copy your rrd files by hand
<br />
fixed in 0.8.3 release

<c>
modules
<q>
the max data info is not the same in hourly/daily/weekly graphs
<a>
the first goal is to keep database as little as possible
so each one is structured  as follow :
<ol>
<li>a part for "hourly" data, with one record by 60s (1 minute) : 70 records</li>
<li>a part for "daily" data, with one record by 120s (2 minutes): 750 records</li>
<li>a part for "weekly" data, with one record by 900s (15 minute): 650 records</li>
<li>a part for "monthly" data, with one record by 3600s (1 hour) : 2200 records</li>
</ol>
to pass from hourly to daily (and so on), webminstat ask rrdtool to compute
an average on the datas, so you can see (for exemple), 
<ul>
<li>on hourly, the load averaged over 1 minute</li>
<li>on daily, the load averaged over 2 minutes</li> 
<li>on weekly, the load averaged over 15 minutes</li> 
<li>on monthly, the load averaged over 1 hour</li> 
</ul> 
the default function is AVERAGE, but you can change the consolidation function for each
module : availables functions are MIN, MAX, AVERAGE, LAST

<c>
modules
<q>
ERROR: unknown function 'info'
<a>
since 0.8.3 release, we use other rrdtool functions as info, dump, restore,
which do not exist in old rrdtool release.<br />
update in 1.0.33 or more

<c>
old
<q>
webminstats "freeze"
<a>
2 way to search :
<ul>
<li>look the source page (html code) in your browser (alt+u on netscape for
  exemple)</li>
<li>edit /etc/webmin/sysstats/config file and change the debug_mod line to 
debug_mode=1
then reload the page, and have a look into /var/webmin/sysstats/webminstats.debug file</li>
</ul>
problem fixed in 0.8.5 release

<c>
usage
<q>
how to install/upgrade webminstat
<a>
<ol>
<li>open your browser on webmin main page</li>
<li>go to webmin configuration/webmin module</li>
<li>select install a module, it will replace the old one if exists</li>
<li>since 0.8.3 release, the data and config are keeped</li>
</ol> 

<c>
usage
<q>
how to install/upgrade a webminstat module
<a>
<ol>
<li>open your browser on webminstat main page</li>
<li>click on "configure module"</li>
<li>click on "add a new module"</li>
</ol> 

<c>
usage
<q>
how to produce batch graphs ?
<a>
webminstats usage is interactive, not batch, but you can do it since 0.9.3
release with the batch_graph.pl script : <br />
syntaxe : /usr/libexec/webmin/sysstats/batch_graph.pl module working_directory

<c>
usage
<q>
how to debug scripts ?
<a>
<ul>
<li>edit your /etc/webmin/sysstats/config and add a line "set -x"</li>
<li>then execute the command /etc/webmin/sysstats/sysstats.sh 2&gt;&amp;1 &gt;
/tmp/sysstats.output</li>
<li>have a look into /tmp/sysstats.output file or send it to me with webmin,
webminstats, distribution version</li>
<li>don't forget to restore the old config file</li>
</ul> 

<c>
usage
<q>
how to remove this cron messages : ERROR: illegal attempt to update using time
1025422862 when last update time ...
<a>
this message is sent if data aquisition is launched too nearly<br />
this aquisition is scheduled each minute, as a cron job, so :
<ul>
<li>check your root cron jobs (crontab -l), you should have only one line
<br />
* * * * * /etc/webmin/sysstats/sysstats.sh</li>
<li>you use a time synchronisation (rdate, ntpdate ...), which change back
your clock</li>
<li>cron is not scheduling with a good accuracy, and
the jobs are launched with a positive nice, so if the load is very heavy,
execution time may be not linear<br />
in this case, only one (bad) way : change the cron jobs to<br />
* * * * * /etc/webmin/sysstats/sysstats.sh &gt; /dev/null</li>
</ul> 

<c>
old
<q>
installation on suse distribution
<a>
to have webminstats work on suse, you have to
<ul>
<li>create a symbolic link from /bin/bash to /bin/bash2 (or change script's
headers from bash2 to bash)</li>
<li>create a symbolic link from /usr/bin/i386-suse-linux-rrdtool to
/usr/bin/rrdtool (or change webminstat's configuration :
/etc/webmin/sysstats/config file)</li>
<li>create a symbolic link from /usr/bin/lsof to /usr/sbin/lsof (or change
filesopen.sh script)</li>
<li>create a symbolic link from /var/log/mail to /var/log/maillog (or change
mailq.sh script)</li>
</ul> 
all this should not be necessary since release 0.8.9

<c>
installation
<q>
Module sysstats does not support this operating system
<a>
all webmin modules check for compatibility, so compare a list with the
installed operating system. <br />
if you are using a linux os not in the list :
<ol>
<li>send me a mail with the result of the command : grep os_type
/etc/webmin/config</li>
<li>you can try to cheat, by replacing the os_type value by "generic-linux" or
one the following
<ul>
<li>cobalt-linux</li>
<li>corel-linux</li>
<li>debian-linux</li>
<li>generic-linux</li>
<li>gentoo-linux</li>
<li>lfs-linux</li>
<li>mandrake-linux</li>
<li>msc-linux</li>
<li>open-linux</li>
<li>redhat-linux</li>
<li>slackware-linux</li>
<li>suse-linux</li>
<li>turbo-linux</li>
</ul>
</li>
</ol> 

<c>
usage
<q>
how to remove a module
<a>
<ol>
<li>go to "configure module" page</li>
<li>select the module</li>
<li>click on trash icon (last on top, right)</li>
<li>it will ask you to confirm</li>
</ol>

<c>
usage
<q>
how to stop a module aquisition
<a>
<ol>
<li>go to "configure module" page</li>
<li>select the module</li>
<li>click on pause icon (second on top, right)</li>
<li>the icon change to "record" icon</li>
<li>in the configure module page, you will see in status column "stopped</li>
</ol>

<c>
old
<q>
Installing module xxxx.tar.gz -&gt; Failed, There is an error in the module file. 
<a>
webminstat use gnu tools, such tar, with gnu extensions options, such -z for
tar
this options does not exists on solaris or hpux.
there is 2 ways to fix this :
<ul>
<li>install gnu tar</li>
<li>modify the systats-lib.pl to add a pipe with gunzip command</li>
</ul>
fixed in 0.9.2 release

<c>
installation
<q>
Error - Missing Content-Type Header
<a>
look at /var/webmin/sysstats/webminstats.debug file for perl messages<br />
<ul>
<li>this can occur with 0.9.x release with a bad rrdtool version (do not match
perl version)</li>
<li>check if the perl-CGI package is installed</li>
</ul>

<c>
installation
<q>
Can't locate RRDs.pm in @INC 
<a>
since 0.9.X webminstats use RRDs perl module (part of rrdtool package) to access
database.
but this module is perl version dependent. for example, I have :
$ locate RRDs<br /> 
/usr/lib/perl5/5.6.1/i386-linux/auto/RRDs<br /> 
/usr/lib/perl5/5.6.1/i386-linux/auto/RRDs/RRDs.bs<br /> 
/usr/lib/perl5/5.6.1/i386-linux/auto/RRDs/RRDs.so<br /> 
/usr/lib/perl5/5.6.1/i386-linux/RRDs.pm<br /> 
which match with my perl 5.6.1<br /> 
if not, search for a "good" rrdtool version.

<c>
old
<q>
no data aquisition in 0.9.0
<a>
webminstats data aquisition is now lauchned by the script
/etc/cron.d/webminstats.cron<br />
on suse, it is not execute (check you /var/log/messages or /var/log/cron)<br />
but if you rename it to /etc/cron.d/webminstats , it seems to work ...<br />
fixed in 0.9.1

<c>
installation
<q>
undefined symbol: png_create_write_struct
<a>
this occurs with release 0.9.0 on mandrake 8.2 and 9.0<br />
webminstats 0.9 use RRDs perl module instead of rrdtool command to access
rrdtool database.<br />
the RRDs.pm is broken in the mandrake packages, so install rrdtool packages from
webminstats sourceforge site.

<c>
modules
<q>
disk graph curves do not match df output
<a>
for now, disk capacity is computed from the number of used blocks and the
number of blocks.<br />
but the ext2 and ext3 reserve around 5% for root usage in case of file system
full, so the real capacity for a lambda a user is 5% lesser than used/total
blocks

<c>
modules
<q>
filesopen and mysql do not show any graph
<a>
in 0.9.2 release, I add "configurable sample rate" and the init is buggy for
this 2 modules.<br />
just open the configuration page and change the sample rate to any desired
value

<c>
modules
<q>
after an upgrade to 0.9.x release, I have no more data
<a>
along code rewrite (from shell-script to perl) aquisition script was renamed
from sysstats.sh to sysstats.pl, but the cron job can already contain the old
name.<br />
to fix, you can :
<ul>
<li>just stop/start data aquisition from main webminstats page</li>
<li>edit crontab (/etc/cron.d/webminstats file or "crontab -e" command)</li>
</ul> 

<c>
modules
<q>
how to erase all data
<a>
before 0.9.5 relase : the easier way is to un-install a module and then re-install it<br />
since 0.9.5, the configuration page has en empty button

<c>
divers
<q>
problem with batch_graph.pl on network module
<a>
this is a bug, the network module is not coded as the others ones (relics)
fixed in 0.9.4

<c>
modules
<q>
parameters for scripts in custom module
<a>
webminstats tests if the given script exists,
and disable this parameter if not to avoid mail warnings,
so apply the run button, and it will run

<c>
usage
<q>
I do not see the graphs in "panorama" mode
<a>
seems to be a problem with some themes (simple_theme for example),
so try a classic one as "old webmin theme".<br />
fixed in 0.9.6

<c>
usage
<q>
warnings about too big log files
<a>
you can configure the limit in
https://localhost:10000/config.cgi?sysstats
with the parameter "maximum log size before warning"

<c>
installation
<q>
is webmin software necessary ?
<a>
almost yes ...
but you can also try without it : see https://sourceforge.net/forum/message.php?msg_id=2468347

<c>
installation
<q>
I do not find "wbm" files
<a>
"wbm" suffix stands for "webmin", but is not a new format.
webmin accepts modules in tar or tar.gz format, and do not care about suffix.
So my software is packaged in "tar.gz".

<c>
usage
<q>
what are 500m values ?
<a>
for values below 1, rrdtool change y scale to 1/1000.
So 500m stands for 500/1000 (in fact 0.5).

<c>
usage
<q>
ERROR while creating graph : Garbage
<a>
this occurs with webminstats <= 0.9.8 and rrdtools >= 1.2
because of some incompatiblity between rrdtools 1.0.x and 1.2.x
<br /> 
to solve this, you have to patch the sysstats-lib.pl file by changing lines 962 et 963 with <br />
        my $date = strftime "%a %b %e %Hh%Mm%Ss %Y", localtime;<br /> 
        my $sig  = "COMMENT:Created $date";
<br />
fixed in 0.9.9

<c>
modules
<q>
snmp module do not recover informations
<a>
first try to get it with the snmpget command<br />
if you are using the perl Net::SNMP module, you have to use numeric oid (not symbolic ones).
you may use snmpget -On to convert symbolic oid to numeric ones.

<c>
usage
<q>
webminstats aquisition is too long
<a>
a sensor should not perturb the computer.
If the aquisition is too long, the host problem may be cached,
so webminstats aquisition script can send a warning.
<br />
now the problem is : why is the aquisition script too long ?
in general, the problem comes from syslog parsing.
In the current release, all the log (mail module, firewall module,
internet module...)  are parsed on each run, so if the log comes big, it
 can be  very slow.
(this will be fixed in a future release).
<br />
now the advices :
<ul>
<li>check your log sizes and check the logrotate configuration</li>
<li>you can change the time used for warning by going to
https://localhost:10000/config.cgi?sysstats and configure "maximum time
for aquisition "</li>
</ul> 

<c>
usage
<q>
no aquisition with 0.10.4
<a>
the installation changed in 0.10.4 : I now use symbolic links instead file copy
<br />
on some linux box, it seams to be a problem between cron and the new links :
<br />
<ul>
<li>check your cron syslog file</li>
<li>check and fix /usr/libexec/webmin/sysstats/webminstats permissions</li>
</ul> 
if you still have problem, you can revert to old system :
<br />
rm -f /etc/cron.d/webminstats
<br />
cp /usr/libexec/webmin/sysstats/webminstats /etc/cron.d/webminstats

<c>
config
<q>
javascript errors when display graphs
<a>
check if your parameter name does not contain 'illegal' characters, such 
',' (used by webminstats as separator), ':' (used by rrdtools)

<c>
installation
<q>
webminstats is broken after a webmin upgrade
<a>
This can occur if you are installing webmin from tar.gz (not from package)
, because webminstats use symbolic links to webmin directory
<br />
the problem should be fixed in 0.13.0 release

<c>
installation
<q>
can not install the rpm package
<a>
some distribution (example : mandriva) repackage webmin and change the standard install directories, 
so wbm-sysstats can not install (can not find /usr/libexec/webmin).
<br />
there is ways to solve it :
<ul>
<li>(recommanded) : re-install webmin from official rpm package (http://www.webmin.com/download.html), then install webminstats from rpm</li>
<li>keep your webmin, and install webminstats from tar.gz</li>
</ul>

<c>
usage
<q>
webminstats error on fedora 14
<a>
the problem comes from the rrdtool fedora 14 base package. you should install
the fedora update package

<c>
config
<q>
Is it possible to 'add' a second or third graph ?
<a>
Yes it is possible, in the module with the "display" feature.
On configuration page, for each parameter, you have a line
called "display data", with a default value to "default", others values are "stop", 1 , 2 ...

all parameters with the same value will be graphed together, and a link will allow to select the others "display"
you can change the display numbers to names with the "display's name" section  on top of screen (after "database" and "execution parameter" sections)

<c>
webmin
<q>
can I clone webminstat module using webmin tool
<a>
Webminstats was not designed to support cloning (cron file, pos file are the same for the 2 modules).
If you still want to use webmin cloning, be sure only one of the 2 modules is running, and use at lease webminstats 2.2.

<c>
modules
<q>
can I clone a webminstats's module
<a>
it is possible possible since release 2.7

<c>
usage
<q>
I can not find webminstats in webmin menu
<a>
the webminstats module can be found in "system" section with "Historic System Statistics" name.

<c>
config
<q>
how to change the account which will recieve alarms by mail
<a>
the default account is root.
You can change it in the module config, but to apply the change,
you have to stop/start cron aquisition.