togatherd - SNMP data gatherer daemon
togatherd [options] configfile...
togatherd collects data from SNMP devices regularly and saves them via the
program rrdtool(1). The TGcgi(1) scripts use this
data to display WWW pages with graphs of the data.
Displays a short usage information and exits.
Names a configuration file. Can be given multiple times. Configuration files can be given as arguments on the command line too.
Specify a file which contains the names of configuration files, one on each line.
Names a MRTG configuration file. togatherd can use MRTG config files to ease the transition from MRTG to ToGather. Only one MRTG config file can be given but you can use the MRTG option ``include: otherfile'' to merge several files to one. See reference in the MRTG documentation.
Don't fork to background. Won't disconnect from the terminal and will display any messages on STDOUT/STDERR (instead of syslog).
Test only. Checks if the configuration is correct and reports errors. Won't touch the config cache so you can test a config file while another daemon is running on it.
Be verbose. Will tell you sometimes what it's doing. Accepts a number for the verbosity level (useful: 1-3).
With this option togatherd will rebuild the config cache rergardless whether it thinks it hasn't changed or --test is set. Won't touch the cache if another daemon is running on the config file.
togatherd will switch its process owners user id to this user if given.
togatherd will switch its process owners group id to this group if given.
Check a configuration:
togatherd -t -v /var/netstat/config.cfg
And start the daemon if it's correct:
togatherd -u netstat -g netadm /var/netstat/config.cfg
togatherd can be control by some SIGNALs:
SIGINT causes togatherd to exit SIGTERM SIGHUP reload the config file SIGUSR1 increase the verbosity level SIGUSR2 set the verbosity level to 0
You can use the program tgctl to send some of the SIGNALs to the daemon. See tgctl(1) for
how to tell togatherd to reload a config or to stop.
togatherd only collects data and populates the database (represented by some rrd files). It does not create any graphs or web pages like MRTG does. The ToGather package contains some CGIs to create web pages and graphs from the collected data.
The ToGather applications don't access a config file directly. Instead the
file is parsed once and a 'cache' is created which allows faster access.
The drawback is that at least the daemon togatherd needs write access to this cache file which usually means write access to
the config files' directory.
Calling togatherd -t configfile after changing the configfile recreates the cache. Any other ToGather
application shouldn't need write access to the cache file later.
ToGather(1), tg_config(1), tgweb.cgi(1),
rrdtool(1)
Rainer Bawidamann, Rainer.Bawidamann@rz.uni-ulm.de University of Ulm, University Computer Centre
This program is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 2 of the License, or (at your option) any later version
This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.
You should have received a copy of the GNU General Public License along with this program; if not, write to the Free Software Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA