Provided by: xymon_4.3.0~beta2.dfsg-9.1_i386 bug

NAME

       trimhistory - Remove old Xymon history-log entries

SYNOPSIS

       trimhistory --cutoff=TIME [options]

DESCRIPTION

       The  trimhistory  tool  is  used  to  purge  old entries from the Xymon
       history logs. These logfiles accumulate information  about  all  status
       changes  that  have occurred for any given service, host, or the entire
       Xymon system, and is  used  to  generate  the  event-  and  history-log
       webpages.

       Purging  old entries can be done while Xymon is running, since the tool
       takes care not to commit updates  to  a  file  if  it  changes  mid-way
       through  the  operation.  In  that  case, the update is aborted and the
       existing logfile is left untouched.

       Optionally, this tool will also remove logfiles from hosts that are  no
       longer  defined  in  the  Xymon bb-hosts(5) file. As an extension, even
       logfiles from services can be removed, if the service no longer  has  a
       valid status-report logged in the current Xymon status.

OPTIONS

       --cutoff=TIME
              This  defines  the cutoff-time when processing the history logs.
              Entries dated before this time are discarded. TIME is  specified
              as  the number of seconds since the beginning of the Epoch. This
              is easily  generated  by  the  GNU  date(1)  utility,  e.g.  the
              following command will trim history logs of all entries prior to
              Oct. 1st 2004:

                  trimhistory --cutoff=`date +%s --date="1 Oct 2004"`

       --outdir=DIRECTORY
              Normally, files in  the  BBHIST  directory  are  replaced.  This
              option causes trimhistory to save the shortened history logfiles
              to another directory, so you can verify that the operation works
              as intended. The output directory must exist.

       --drop Causes  trimhistory  to  delete  files  from  hosts that are not
              listed in the bb-hosts(5) file.

       --dropsvcs
              Causes trimhistory to delete files from services  that  are  not
              currently  tracked  by Xymon. Normally these files would be left
              untouched if only the host exists.

       --droplogs
              Process the BBHISTLOGS directory also,  and  delete  status-logs
              from  events  prior  to  the  cut-off  time.  Note that this can
              dramatically increase the processing time, since there are often
              lots and lots of files to process.

       --progress[=N]
              This  will cause trimhistory to output a status line for every N
              history logs or status-log collections it processes, to indicate
              how far it has progressed. The default setting for N is 100.

       --env=FILENAME
              Loads   the   environment   from   FILENAME   before   executing
              trimhistory.

       --debug
              Enable debugging output.

FILES

       $BBHIST/allevents
              The eventlog of all events that have happened in Xymon.

       $BBHIST/HOSTNAME
              The per-host eventlogs.

       $BBHIST/HOSTNAME.SERVICE
              The per-service eventlogs.

       $BBHISTLOGS/*/*
              The historical status-logs.

ENVIRONMENT VARIABLES

       BBHIST The directory holding all history logs.

       BBHISTLOGS
              The  top-level   directory   for   the   historical   status-log
              collections.

       BBHOSTS
              The location of the bb-hosts file, holding the list of currently
              known hosts in Xymon.

SEE ALSO

       xymon(7), bb-hosts(5)