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

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.

On RHEL5/6, the server package uses the rrdtool RPM from the Optional or
Supplemental channel (you might need to enable it). Compatible packages should
also be available in CentOS versions and/or EPEL. Packages will follow the EPEL
version of rrdtool (which is 1.2, as of this writing); if you're using rpmforge's
1.4 version, you'll need to rebuild.

The EPEL upgrade is being tracked in https://bugzilla.redhat.com/show_bug.cgi?id=846374


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

In Fedora 18 and above, a systemd unit file is provided. Both 'xymon' 
and 'xymon-client' commands are actually aliases to a single 
xymonlaunch.service unit file, which can be called directly.


DIRECTORY LAYOUT - CLIENT
=========================
 /etc/sysconfig/xymon-client    <-- xymon server to send reports to
 /etc/xymon-client              <-- configuration files
 /dev/shm                       <-- tmpdir

Create this directory (not packaged)
 /usr/local/share/xymon-client  <-- drop-in scripts to add to client report


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/run/xymon                 <-- pid files and sockets (systemd systems use /run/xymon)
 /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

If you're upgrading from previous versions of the server RPM, be aware that the default XYMONHOME
directory changed in 4.3.17 from /usr/share/xymon/server to /usr/share/xymon. Some config files
may need to be modified by hand.

If you find these packages helpful or have any questions, please drop me a line! Feedback is appreciated!


-Japheth "J.C." Cleaver
cleaver@terabithia.org



QUICK 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. Thus, custom scripts being written for 
client reporting should always specify "--env=/etc/xymon-client/xymonclient.cfg" 

4) xymonping is no longer built in the package. On install, your xymonserver.cfg 
file will be automatically munged to use fping instead.

5) /var/www/xymon can be mounted on a tmpfs for a nice performance boost.
   Use something like: 

   mount -t tmpfs -o uid=xymon,gid=xymon,mode=755 tmpfs /var/www/xymon/

6) systemd support is available for Fedora 18+. If you used a previous version
   of this package, you may need to yum ERASE and reinstall the xymon-client
   RPM to properly replace the init script config with the system unit file.

7) $XYMONHOME on the server is now /usr/share/xymon/ . The change should be
   transparent, but if you had hard-coded /usr/share/xymon/server/ into your
   scripts you'll want to upgrade them. You should also verify that
   xymonserver.cfg changes have been carried over. 

   Replacing a directory with a symlink is actually hard to do in RPM. On a 
   live system that's being upgraded, verify symlink installation right away.


See CHANGES-terabithia for more details, a changelog, and additional operational
tweaks in these packages.