Man page of TRIMHISTORY

# TRIMHISTORY

Section: Maintenance Commands (8)
Updated: Version Exp: 9 Aug 2006
Index Return to Main Contents

## NAME

trimhistory - Remove old Hobbit history-log entries

## SYNOPSIS

trimhistory --cutoff=TIME [options]

## DESCRIPTION

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

Purging old entries can be done while Hobbit 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 Hobbit 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 Hobbit 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 Hobbit. 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 Hobbit.

$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 Hobbit.

## SEE ALSO

hobbit(7), bb-hosts(5)

## Index

NAME
SYNOPSIS
DESCRIPTION
OPTIONS
FILES
ENVIRONMENT VARIABLES
SEE ALSO

This document was created by man2html, using the manual pages.
Time: 19:49:58 GMT, August 09, 2006