archive-log.pl
archive-log.pl archives a collection's queries.log and clicks.log log files to the collection's archive directory.
archive-log.pl <collection config> [view]
Arguments
- The collection configuration file must be specified, and must be a filesystem path to an existing, readable and valid collection configuration file.
- A view may be specified, and should be one of "live" or "offline".
Function
archive-log.pl will take query logs and click logs from the specified view ("offline" if no view is specified, or "live" if no view is specified and the collection is a meta collection) and will compress them and store them in the collections "archive" directory. It will then create empty new query and click logs. update.pl will run this script to archive logs at the end of an update, at which point the "live" logs will have been swapped into the "offline" view (thus the "offline" default view).
Meta collections and log archival
Since this process is only normally called when a collection is updated, logs for meta collections may never be archived unless a schedule task is set up to run this script (or perform some other log rotation). Setting up such a task is recommended for any meta collection receiving a significant volume of queries.