This page describes how to get the Baccus Software running.

We are using the Debian operating system. Most of the required software is available for direkt installation on this platform.

Prerequisites

Minimum requisites:

  • Tcl 8.5, package tcl8.5
  • Trf, package tcl-trf
  • tcllib, package tcllib
  • Tcl Sqlite3 bindings, package libsqlite3-tcl
  • critcl 3, see below

Debian Jessie:

apt-get install tcl8.5 tcl-trf tcllib libsqlite3-tcl critcl

Debian Wheezy:

apt-get install tcl8.5 tcl-trf tcllib libsqlite3-tcl
git clone git://github.com/andreas-kupries/critcl
cd critcl
sudo tclsh ./build.tcl install

Initial Setup - Step by Step

  1. Make yourself a workspace, e.g.: mkdir baccus && cd baccus.
  2. Get the sources from our darcs repository:

    for p in astra atexit baccus brisa fp tie_sqlite3; \
        do darcs get http://at.magma-soft.at/darcs/$p; done
    
  3. Enter the baccus package directory: cd baccus

  4. Make the baccus script executable and run it: chmod +x baccus&& ./baccus
  5. You get a prompt, where you can get some help: baccus> help

Test Baccus

  1. Make a test backup in the /tmp directory: backup .. /tmp/afis test This will backup the just created baccus directory into /tmp/afis. Afer one and a half minute i get output like this:

    urta:error: CheckUrta:/tmp/afis/fix.idx: no urta
    .
    ...notice: : backup
    notice: /h: 0
    notice: /m: 1
    notice: /s: 29
    notice: elapsed: 89
    notice: store,FixBlock,total: 1
    notice: store,VarBlock,skipped: 43
    notice: store,VarBlock,total: 1133
    notice: store,bytes: 997160
    notice: store,directory: 45
    notice: store,file: 350
    notice: store,total: 395
    notice: unix,exec,hostname: 1
    notice: unix,exec,id: 1
    
    
    baccus> 
    
  2. Repeat the test backup. I have to exit the baccus interpreter first, which is a bug. After one second i get:

    .
    ...notice: : backup
    notice: /m: 0
    notice: /s: 1
    notice: elapsed: 1
    notice: store,FixBlock,skipped: 1
    notice: store,FixBlock,total: 3
    notice: store,VarBlock,skipped: 1128
    notice: store,VarBlock,total: 1133
    notice: store,bytes: 1066294
    notice: store,directory: 45
    notice: store,file: 350
    notice: store,total: 395
    notice: unix,exec,hostname: 1
    notice: unix,exec,id: 1
    
    
    baccus> 
    
  3. List the backups: tags /tmp/afis. I get:

     run :status:stats:      start      -        end      :duration:  tag  : comment
     :                  record                     user@host/path
    1: close:stats:20150825-12:25:07-20150825-12:26:36:      89:test:
     :d:1:343:sha1:Na6DhzjEDEh/ojNm+aUFcdR4ep4=:jorge@pwx.magma.intern/home/jorge/progs/baccus
    2: close:stats:20150825-12:35:57-20150825-12:35:58:       1:test:
     :d:1:343:sha1:J3Mq1J/qU4Q4cPNbcbtPz4YVgTU=:jorge@pwx.magma.intern/home/jorge/progs/baccus
    
    
    baccus> 
    
  4. Restore the second one: restore /tmp/afis 2 /tmp/baccus Note: the commandline help currently is lying, use the one I give here (bug). After no time i get:

    .
    .
    ............................................................................
    ............................................................................
    ............................................................................
    ............................................................................
    ............................................................................
    ..............notice: : restore
    notice: /m: 0
    notice: /s: 0
    notice: elapsed: 0
    notice: unix,exec,id: 1