From a53b5658667bedcea171e91aa4d78af8b7a3eb19 Mon Sep 17 00:00:00 2001 From: Dobrica Pavlinusic Date: Sat, 29 Jan 2011 15:37:56 +0100 Subject: [PATCH] document ASA operation --- README.ASA | 35 +++++++++++++++++++++++++++++++---- 1 file changed, 31 insertions(+), 4 deletions(-) diff --git a/README.ASA b/README.ASA index f762f57..65107d5 100644 --- a/README.ASA +++ b/README.ASA @@ -2,11 +2,38 @@ This document tries to describe ASA extensions for BackupPC 3.2.0 Written by Dobrica Pavlinusic 2011-01-27 -Search and archive maintain data in PostgreSQL and full-text search. Since full-text search -is single-writer, we need to serialize somehow requests for it's update. +This is second iteration of adding search over arbitrary filename substrings and archive +to CD/DVD media with tracking of copies and additional md5sum creation on them for easy +burned media verification. -This is implemented using archive host feature using _search_archive.pl configuration -file in /etc/BackupPC/pc/_search_archive.pl +ASA maintains it's data in PostgreSQL and KinoSearch (for faster part-of-filename matching). +Since full-text search is single-writer, we need to serialize somehow requests for it's update. + +Implementation is based on archive host feature in BackupPC using _search_archive.pl configuration +file located at /etc/BackupPC/pc/_search_archive.pl + +This provides us with serialization and hooks around it, but lacked incremental tar creation which +is essential because we want to burn always increasing archive on CD/DVD media. + +This is implemented using new global configuration directive TarCreateIncremental + +Using BackupPC hooks to integrate and archive host also provided following advantages: + - web interface for archive host contains our log messages + - all updates are invoked automatically on end of each run (system is always up to date) + +BackupPC can dump multiple machines in parallel, this invoking our _search_archive host and index +update while update from different machine is still in process. Archive host will reject request, +but next invocation of same host will fix problem automatically. + +To be sure that all pending archives are indexed, you can also run cron job which invokes _search_archive +on all pending increments: + + /BackupPC_ASA_ArchiveStart _search_archive backuppc + +You can also force archival of particual pending backups from single host by adding hostname(s) or +hostname:num to backup individual increment. + +Alternativly, you can use _search_archive web interface to invoke increment creation and indexing. -- 2.20.1