Longstop Manual (Draft v1.1)

16. Jun. 2008

Introduction

Longstop is a command utility to archive and backup files to DVD or CD. It uses a MySQL database maintain information on what files are stored on which DVD. This is the initial draft of a basic user manual for the installation and use of Longstop.

At the current moment the application is alpha. Reports and issues should be sent to the author via the sourceforge website.

http://sourceforge.net/projects/longstop



Functionality

Longstop provide scripts to backup or archive data and extract or list that data. An overview of the basic modes of operation are described below.

Backup and Archiving

The control of what is backed up is performed by a set of inclusion and exclusion patterns. For subversion repositories and MySQL databases the relevant dump of the repository is used to created a backup. For backup all files which fit the pattern set are copied. For archive only those files that do not have more than the defined number of copies (default 3) on separate media are backed up.

The pattern are perl regular expression syntax not unix globs.

If the loaded media is part of a known media set the option of deleting the media set is given.

Extraction and Listing

Two scripts are provides to perform simple comand line extraction or listing.

The extraction default is to restore the latest version of all files that match the extraction patterns list. The extraction can also be defined from a command file with the main script. In the command line case if the archive set is not defined only the contents of the currently loaded DVD are extracted.

The listing default is to list all version of files that match the listing patterns across all media. In the command line case if the archive set is not defined only the contents of the currently loaded DVD are listed.

The inclusion and exclusion patterns are also perl regular expression syntax syntax.

Requirements

Perl 5.8 or greater

Wodim

Growisofs

MySQL 5.x or greater

Wodim and Growisofs should be available in an appropriate package for your distro. Do not use with cdrecord, the application has not been tested with cdrecord and there are no intentions to test with cdrecord.

Installation

Unpack the tarball to your preferred directory (e.g. my-directory) with the tool of your choice.

cd my-directory/longstop-release

./install.sh

The install.sh script should download and install the Perl modules required for the application to run.

./testDVD.pl

this will checkout basic DVD writer functionality

Usage

There four basic scripts. A brief description of their usage can be obtained by either via perldoc.

perldoc <command>

or the html file in Docs directory

longstop.pl

Works on command file (see command file format in longstop-release/Docs/longstop.htm or perldoc).

longstop-list.pl

List files in an archive. If archive not specificied list files on DVD/CD in drive

longstop-extract.pl

Extract files in an archive. If archive not specificied list files on DVD/CD in drive

longstop-deleteMedia.pl

Deletes media from database. This DOES NOT remove data from the media it merely removes information about the media from database.