Imported Upstream version 2.4.4p3
[debian/amanda] / docs / ZFTAPE
1 Amanda with floppy tape drives on Linux: 
2 (A.Gebhardt <albrecht.gebhardt@uni-klu.ac.at>)
3
4
5 Amanda now supports the ftape driver version 3.04d (see 
6 http://www-math.math.rwth-aachen.de/~LBFM/claus/ftape).
7 It adjusts the blocksize automatically to 32k and supports QIC volume tables.
8
9 It uses only one open() call for writing backups to one tape, so the 
10 "busy"-lamp of the drive will be on all the time. (With normal amanda
11 code it would be off in pauses between two files written to tape.)
12
13 For volume table support you have to get libvtblc first (Available at
14 ftp://pc02-stat.sci.uni-klu.ac.at/pub/Linux/libvtblc). This library contains
15 the functions and subroutines from the vtblc utility, distributed with ftape.
16 (May be, this library will be part of a future ftape package).
17
18 You have to set the raw tape device for volume table operations, usually
19 /dev/rawft0, either via "configure --with-ftape-rawdevice=..." or
20 with "rawtapedev=..." in amanda.conf (configure checks for /dev/rawft[0-3],
21 to get a guess for this value). 
22 Dont forget to make this device read/writeable for your backup user.
23
24 For compilation you need the header files from ftape 3.04d in your include
25 tree.
26
27 The volumetable of a tape "amlabeled" TEST-VOL2 with 4 backups on it
28 would look like (listed with vtblc utility from ftape):
29
30 gamma@backup[backup]$ vtblc
31  Nr  Id          Label                   Date           Start      End    Space
32 --------------------------------------------------------------------------------
33   0 VTBL "TEST-VOL2             "  23:08:06 03/15/98        3        4    0.00%
34   1 VTBL "gamma //beta/C 0      "  00:00:00 03/15/98        5      374    0.68%
35   2 VTBL "gamma sda2 0          "  00:00:00 03/15/98      375     1029    1.21%
36   3 VTBL "alpha sda2 0          "  00:00:00 03/15/98     1030     1906    1.62%
37   4 VTBL "alpha sda6 0          "  00:00:00 03/15/98     1907     8092    11.45%
38   5 VTBL "AMANDA Tape End       "  01:45:15 03/16/98     8093     8094    0.00%
39
40 With lvtblc, currently available with the libvtblc library, you can list 
41 the complete label strings 
42 (44 characters, not only the first 22 characters as with vtblc):
43   
44 gamma@backup[backup]$ lvtblc -l
45  Nr  Id          Label                                         Date 
46 --------------------------------------------------------------------------------
47   0 VTBL "TEST-VOL2                                   "  23:08:06 03/15/98
48   1 VTBL "gamma //beta/C 0                            "  00:00:00 03/15/98
49   2 VTBL "gamma sda2 0                                "  00:00:00 03/15/98
50   3 VTBL "alpha sda2 0                                "  00:00:00 03/15/98
51   4 VTBL "alpha sda6 0                                "  00:00:00 03/15/98
52   5 VTBL "AMANDA Tape End                             "  01:45:15 03/16/98
53
54 Note on datestamps:
55 volume 0    (amanda label): reflects the time of starting the backup 
56 volume i    (backup files): amanda datestamps of the backup files
57 last volume (end marker)  : reflects the time of finishing the backup
58
59
60 I tested this on a Linux machine (P90 / 96Mb RAM / 256 Mb swap) with two other 
61 clients (Linux / WfW) using
62
63 kernel 2.0.33, 
64 ftape 3.04d, 
65 amanda 2.4.0b6p4 
66
67 with an internal Iomega Ditto 3200 (TR-3) drive attached to an Iomega Ditto 
68 Dash controller (at 2000 Kbps). My "tapetype" follows:
69
70 define tapetype DITTO-TR3 {
71     comment "Iomega DITTO 3200 Travan 3 tape drives"
72     length 1500 mbytes          #
73     filemark 29 kbytes          # ???
74     speed 256 kbytes            # = 2000 Kbit/s ?
75 }
76
77 Note on filemark size:
78 Filemarks are not written to the tape (they are written to the header segment 
79 and use there 128 byte), so their size could even be 0. But a tape segment 
80 takes at least 29 kb (+3 kb ecc-code = 32 kb), so in the worst case an eof will
81 waste 29 kb.
82