
-------------------------------------------------------------------------------
SARAH - Syslog Automated Rotation and Archive Handler
-------------------------------------------------------------------------------
** Current Version: 0.7b

** What is sarah?

sarah is a program which is used to trim, rotate, archive and delete log
files.  It is meant to run periodically out of cron, determining what to do
based on a configuration file.

sarah is currently in beta testing.  The current version is being distributed
without any guarantees that it will work, or that it won't delete everything
on your system.  That is not to say that I expect sarah to blow away your
files; I use sarah to rotate my own logs.  That's why I wrote it.

** Where can I get it?

The current version of sarah is available at ftp://ftp.conundrum.com/pub/sarah/

** Requirements

At this time, sarah is known to run with the default distribution of perl
5.005_03 and 5.005_02 on FreeBSD 3.x, and Solaris 2.5.1, 2.6 and 2.7.  It is
expected that sarah will work with any perl5 interpreter on any *nix, but
testing should be done to confirm this.  If you run sarah on a system not
described above, please send a quick note to me at mattp@conundrum.com to let
me know how it goes.

sarah currently requires that your perl5 installation is setup to allow the
use of syslogging, even if you don't plan to use the syslogging features of
sarah.  If you haven't already, it may be necessary to convert your local
syslog.h header file to a perl header file.  See the perldoc on 'h2ph' if
sarah dies complaining that it "Can't locate syslog.ph".

** Licensing

Licensing for the current version of sarah is quite simple: I (Matthew
Pounsett) retain all rights to this code.  Anyone is free to use sarah,
and non-beta versions may be redistributed in unmodified form.  Beta versions
of sarah may not be redistributed in any form without the permission of the
author.  You are free to use parts of sarah in your own code, however that
code can not then be redistributed without the permission of the author.

** Installation

There are several simple steps to installation:

1) Edit the top of the sarah program, changing the $config, $compBin,
   $compSuffix, $rotate_msg and $syslogdPID variables to suit your system.
   The defaults there will match current FreeBSD systems.

   $compBin and $compSuffix may be changed to use any compression program, not
   just gzip.  sarah has been tested using gzip, compress, bzip and bzip2, but
   any compression program which will accept the -f (force) switch will work
   as long as you set the compressed file suffix correctly.

2) Copy sarah into the binary directory of your choice.  /usr/local/bin/ is
   the usual choice.

3) Copy sarah.conf.sample into the location you set for $config at the top of
   sarah, then modify it to meet your needs.  sarah.conf is usually stored as
   /usr/local/etc/sarah.conf

4) If you want, copy the man page (sarah.1) into the man section 1 directory.
   Don't worry if you choose not to do this.  You can still access the sarah
   documentation by typing 'perldoc sarah'

5) Set cron to run sarah periodically.  Sarah is normally run as root every
   minute.  Consult the crontab(1) or crontab(5) man pages on your system if
   you're not certain how to do this.  Common crontab entries for sarah might
   look like one of these:

   * * * * *		/usr/local/bin/sarah
   * * * * *	root	/usr/local/bin/sarah

   Check the perl documentation ('perldoc sarah') or the sarah(1) man page for
   command line arguments you may want to use.

That's it!  sarah should now be running, and rotating your logs for you.

** Support, bugs and other beasties

We'd all like to believe there aren't any (bugs or beasties), but this *is*
beta software after all.  Bug reports are more than welcome, as are feature
requests and pleas for help.  To that end, I've set up two mailing lists:

sarah-announce:
   The sarah-announce mailing list is for me to make announcements about new
   releases and updates of the software.  Subscribe to this if you just want
   to know when something new happens.  Traffic is extremely low.. say one
   message every two months, on average.

sarah-support:
   This is for discussion among the users of sarah.  It's useful for getting
   help, reporting bugs, or asking for new features.  All are welcome.
   Traffic is very low at present.

You can subscribe to either list by sending email to listar@conundrum.com with
the command "subscribe sarah-announce" or "subscribe sarah-support" in the
body of the message.  I don't recommend subscribing to both, since messages to
sarah-announce are automatically copied to sarah-support.  You can also
subscribe via a web interface at http://www.conundrum.com/listar/.

Thanks for using sarah!  I hope to hear how you like it.  If you want to send
me some feedback, but don't feel like getting involved in a mailing list,
please feel free to send your comments directly to me at mattp@conundrum.com.

-------------------------------------------------------------------------------
$Id: README,v 1.10 2001/10/01 21:42:59 mattp Exp $
-------------------------------------------------------------------------------
