RPM package for Xymon Monitor
=============================
This is a set of RPM packages for the Xymon server and client.

xymon-4.3.7-##.rpm
xymon-client-4.3.7-##.rpm

You should install the first package on your Xymon server(s) and the 
second one on any client machines. The server has its own built-in client
configured to run, so you don't need to install the client RPM on that box.



CHANGE NOTES
============
1) All server and client files have been moved to standard LSB/FHS locations, 
and most uses of $XYMONHOME and $XYMONCLIENTHOME variables have been replaced
with hard-coded paths. Symlinks have been provided, so scripts written to use
a home directory should still "just work".

2) The standard client distinguishes between a single recipient (XYMSRV) and
multiple recipients (XYMONSERVERS). In this package, XYMSRV is *always* set to
0.0.0.0 and you should use XYMONSERVERS to configure your report destination(s).

3) On a Xymon server, running `xymoncmd` will load the SERVER'S environment 
files instead of the local client's



CLIENT CONFIGURATION
====================
Edit XYMONSERVERS in /etc/sysconfig/xymon-client line on either the server or
the client to pick which host(s) the client reports local data to.

/sbin/service xymon-client start
or /sbin/service xymon start


DIRECTORY LAYOUT - CLIENT
=========================
 /etc/sysconfig/xymon-client	<-- xymon server to send reports to
 /etc/xymon-client		<-- configuration files
 /usr/local/share/xymon-client	<-- drop-in scripts to add to report
 /dev/shm			<-- tmpdir


DIRECTORY LAYOUT - SERVER
=========================
 /etc/xymon			<-- configuragion files
 /etc/xymon/web 		<-- web template files
 /var/lib/xymon 		<-- state data (reports, etc)
 /var/lib/xymon/tmp 		<-- longer-term temp data
 /var/cache/xymon		<-- www-generated data (reports and snapshots)
 /var/lib/xymon/notes		<-- optional "notes" channel destination
 /var/lib/xymon/periodic	<-- daily/weekly/monthly reports

 /usr/share/xymon/static 	<-- web-accessible static files (gifs, CSS, javascript, and help pages)
 /usr/share/xymon/cgi-bin 	<-- viewing CGI utilities
 /usr/share/xymon/cgi-secure 	<-- administration CGI utilities

 /var/www/xymon 		<-- root for generated pages and cgi-created snapshots and reports
  - this can be mounted on tmpfs! Use:
	rm -fR /var/www/xymon/* && mount -t tmpfs -o uid=xymon,gid=xymon,mode=755 tmpfs /var/www/xymon/

 

If you're having problems finding a file, rpm -qlp is your friend. If you're having issues with these RPMS,
please email me first before trying the list since these are NOT officially-supported packages.

Thanks!

Japheth Cleaver
cleaver@terabithia.org