- check compatibility
- install required software
- webminstats install
- webminstats update
- remove webminstats
- webminstats module installation
- webminstats module upgrade
- delete a webminstats module
- troubleshooting
First look at webminstats
requires to know if it can work on your host.
remark : if you work on an rpm based distribution, prefer rpm package.
perl
this language is installed on most unix computers. You just have to check the release
webmin
Webminstats is a module for
webmin software.
download
webmin is often provided by Linux distribution, but you can get the last release (in tar.gz or rpm) from
webmin
install
note that webminstats use :
- webmin core engine
- and sometimes the "cron-webmin-module" to manage acquisition by cron (if /etc/cron.d exists, webminstats does not use "cron-webmin-module")
test
test it with this URL : http://localhost:10000 or https://localhost:10000
Webminstats use
rrdtool as database software, so you have to install it too.
download
Some distributions may provides rrdtool packages, but my advice is to download it from :
But you must be careful with binaries : webminstats now use rrdtool Perl module RRDs, and this one depends on Perl version.
- some rpm packages do not have this dependency, so you have to check package files (
rpm -ql rrdtool| grep RRDs.so)
- debian users should install librrds-perl package
- with tar.gz install, do not forget to have a
make install-site-perl
install
nothing special if release accorded to Perl
test
you can test it with
perl -e 'use RRDs;print "ok\n"' command.
interactive install from webmin interface
- open your browser on http://localhost:10000/webmin/edit_mods.cgi (or use webmin/webmin configuration/webmin module)
- choose "install module", and select the sysstats's wbm file you just download (wbm format is just another name for tar.gz file in "webmin" language)
- click "install module from file" button and webmin show what it install
- then go to webmin index/system and click on "historic system statics" to install webminstats embedded modules
- for each module, you will see if install is ok
cron stop
Initial Configuration - Installing Modules.
Installing module upload.tar.gz -> Files installed -> cpu-0.11.0d -> upgrade -> Completed
database modifications ...ok
cron restart
start data aquisition
after install, you have to click on "start" button (bottom of main page) to launch data acquisition.
if your webmin install is not "linux-standard"(config files on /etc lib and scripts on /usr, ...), you will have to adapt the /etc/cron.d/webminstats file for a correct sysstats.pl path.
same as
webminstats install
webmin will erase old webminstats version, but not webminstats databases.
webminstats can detect old install and recover it's data.
- open your browser on http://localhost:10000/webmin/edit_mods.cgi (or use webmin/webmin configuration/webmin module)
- choose in "delete module" panel the module "historic system statics"
- click on "delete selected module"
- webmin does not know where webminstats database are (used for upgrade), but in this case, you have to remove /etc/webmin/sysstats directory, "by hand"
- open http://localhost:10000/sysstats/install_mod.cgi (or use configure module/upgrade add a module, from webminstats)
- select a tar.gz module
- click "install module"
- you will go back on main page with information on install
- if all is ok, a new icon should appear
same as
webminstats module install
as said, webminstats should detect previous module and upgrade
- open http://localhost:10000/sysstats/install_mod.cgi (or use configure module/upgrade add a module, from webminstats)
- click on the module you want to remove
- then click on the trash icon, on top, right
- first have a look at error file :
/tmp/.webmin/webminstats.debug
- then have a look at the FAQ
- at least, you can ask question on forums
back to main page
version 1.3 on 24 november 2003