msgcache - Cache client messages for later pickup by xymonfetch
msgcache [options]
msgcache implements a Xymon message cache. It is intended for use with
clients which cannot deliver their data to the Xymon server in the normal way.
Instead of having the client tools connect to the Xymon server, msgcache runs
locally and the client tools then deliver their data to the msgcache daemon.
The msgcache daemon is then polled regularly by the
xymonfetch(8)
utility, which collects the client messages stored by msgcache and forwards
them to the Xymon server.
NOTE: When using msgcache, the
XYMSRV setting for the clients
should be
XYMSRV=127.0.0.1 instead of pointing at the real Xymon
server.
Clients delivering their data to msgcache instead of the real Xymon server will
in general not notice this. Specifically, the client configuration data
provided by the Xymon server when a client delivers its data is forwarded
through the xymonfetch / msgcache chain, so the normal centralized client
configuration works.
However, other commands which rely on clients communicating directly with the
Xymon server will not work. This includes the
config and
query
commands which clients may use to fetch configuration files and query the
Xymon server for a current status.
The
download command also does not work with msgcache. This means that
the automatic client update facility will not work for clients communicating
via msgcache.
- --listen=IPADDRESS[:PORT]
- Defines the IP-address and portnumber where msgcache
listens for incoming connections. By default, msgcache listens for
connections on all network interfaces, port 1984.
- --server=IPADDRESS[,IPADDRESS]
- Restricts which servers are allowed to pick up the cached
messages. By default anyone can contact the msgcache utility and request
all of the cached messages. This option allows only the listed servers to
request the cached messages.
- --max-age=N
- Defines how long cached messages are kept. If the message
has not been picked up with N seconds after being delivered to msgcache,
it is silently discarded. Default: N=600 seconds (10 minutes).
- --daemon
- Run as a daemon, i.e. msgcache will detach from the
terminal and run as a background task
- --no-daemon
- Run as a foreground task. This option must be used when
msgcache is started by xymonlaunch(8) which is the normal way of
running msgcache.
- --pidfile=FILENAME
- Store the process ID of the msgcache task in FILENAME.
- --logfile=FILENAME
- Log msgcache output to FILENAME.
- --debug
- Enable debugging output.
xymonfetch(8),
xymon(7)