View source for How To:Mirror Dumps to Virtual Tapes and Real Tapes using RAIT

{{How To Header}}
= Deprecated =
Using RAIT to mirror dumps is deprecated, see [[How To:Write dump to multiple storage]] for better mechanism.

= Overview =
The basis of a RAIT configuration is the [[RAIT Device]], which allows Amanda to mirror (with two child devices) or stripe with parity (with 3 or more child devices) data across several child devices.  See [[How To:Stripe Dumps across Tapes using RAIT]] for a bit more background on the RAIT device and RAIT-related changers.

=Mirroring a backup=

RAIT with only two drives, creates a perfect copy of the data: a mirror of your backup.
Each of these mirrors is handled by its own device. For example, one of the mirrors can
write to a real tape device, and the other mirror can write a virtual tape (vtape) using 
the VFS device.  The vtapes can be used for fast recovery, and the tapes can be stored
offsite.

This example shows how to mirror a dump to virtual tapes and real tapes.  First, get each set up and running independently.  For example, your vtape configuration (based on [[How To:Set Up Virtual Tapes]]) might look like
 tpchanger "chg-disk:/u01/vtapes"
with, say, 25 slots in <tt>/u01/vtapes</tt>.  Similarly, your physical tape configuration might be
  tpchanger "chg-zd-mtx"
  changerdev "/dev/mtx1"
  changerfile "/etc/amanda/myconfig/chg-zd-mtx.conf"

Combining these two is fairly straightforward.  The first can be specified directly, since it has no configuration parameters, but the second will require its own changer definition:
 define changer "robot" {
  tpchanger "chg-zd-mtx"
  changerdev "/dev/mtx1"
  changerfile "/etc/amanda/myconfig/chg-zd-mtx.conf"
 }
Then, specify both to the RAIT changer as the Amanda tape device:
 tpchanger "chg-rait:{chg-disk:/u01/vtapes,robot}"

Run some {{man|8|amtape}} subcommands to exercise the new changer, then an {{man|8|amcheck}} and {{man|8|amdump}}.  Easy as that!

== Old, chg-multi method ==
''This method is for use in Amanda-2.6.1 and earlier, before the new RAIT changer was available.''

Together with the "chg-multi" changer, which is suitable for a whole range of applications, this setup requires these parameters in '''amanda.conf''' (the parameters '''dumpcycle''', '''runspercycle''' and '''tapecycle''' should be adapted to your environment):

 dumpcycle 1 week
 runspercycle 5
 tapecycle 10
 tpchanger "chg-multi"
 changerfile "chg-multi-mirror.conf"
 # tapedev is not needed
 # changerdev is not needed

We create the file '''chg-multi-mirror.conf''' in the same directory, with these contents:

 multieject 0
 needeject 0
 gravity 0
 ejectdelay 0
 statefile /home/amanda/daily/changerstatus
 firstslot 1
 lastslot 10
 slot 1 rait:{file:/amandatapes/daily/vtape1,tape:/dev/nst0}
 slot 2 rait:{file:/amandatapes/daily/vtape2,tape:/dev/nst0}
 slot 3 rait:{file:/amandatapes/daily/vtape3,tape:/dev/nst0}
 slot 4 rait:{file:/amandatapes/daily/vtape4,tape:/dev/nst0}
 slot 5 rait:{file:/amandatapes/daily/vtape5,tape:/dev/nst0}
 slot 6 rait:{file:/amandatapes/daily/vtape6,tape:/dev/nst0}
 slot 7 rait:{file:/amandatapes/daily/vtape7,tape:/dev/nst0}
 slot 8 rait:{file:/amandatapes/daily/vtape8,tape:/dev/nst0}
 slot 9 rait:{file:/amandatapes/daily/vtape9,tape:/dev/nst0}
 slot 10 rait:{file:/amandatapes/daily/vtape10,tape:/dev/nst0}

This assumes we have only 1 tapedrive (/dev/nst0), which we need to manually change the tape each day.

We create the 10 virtual tapes:

 $ for i in 1 2 3 4 5 6 7 8 9 10; do mkdir -p /amandatapes/daily/vtape$i/data; done

We insert a tape in the physical tapedrive, and label the first tape.  This will label both the virtual tape vtape1 and the tape in the physical drive identically:

 $ amlabel daily DAILY-01 slot 1
 $ amcheck daily

Last check, and we are ready for the normal amdump run.

==Using amrecover with half of the mirror==

When needing to restore, you can use the specific vtape, or the physical tape.
Just specify the correct device to amrecover (or amrestore) on the command line, or with the '''settape''' subcommand from amrecover.

 # amrecover daily -d amandaserver.example.com:file:/amandatapes/daily/vtape5

Note that, when you specify the driver, you must specify the hostname too.

Alternatively, you could set up a special configuration for restoring, named "halfmirror" 
that is almost identical to the normal config, except for the chg-multi.conf: 
fill that file without ''rait'' option and only the virtual tape half of the mirror:

In the '''amanda.conf''' from the configuration named ''halfmirror'':

 tpchanger "chg-multi"
 changerfile "chg-multi-halfmirror.conf"
 amrecover_changer "halfmirror"
 amrecover_do_fsf true
 amrecover_check_label true

'''chg-multi-halfmirror.conf''':

 multieject 0
 needeject 0
 gravity 0
 ejectdelay 0
 statefile /home/amanda/daily/restorchgstatus   # different name than the normal mirror
 firstslot 1
 lastslot 10
 slot 1 file:/amandatapes/daily/vtape1
 slot 2 file:/amandatapes/daily/vtape2
 slot 3 file:/amandatapes/daily/vtape3
 slot 4 file:/amandatapes/daily/vtape4
 slot 5 file:/amandatapes/daily/vtape5
 slot 6 file:/amandatapes/daily/vtape6
 slot 7 file:/amandatapes/daily/vtape7
 slot 8 file:/amandatapes/daily/vtape8
 slot 9 file:/amandatapes/daily/vtape9
 slot 10 file:/amandatapes/daily/vtape10

By using a different name for '''statefile''' above, we do not interfere with the notion
of current tape etc from the normal daily configuration. (This would not work with chg-disk.)

And recovering from this set of vtapes goes like:

 # amrecover halfmirror -d halfmirror

{|
| bgcolor=yellow | Tip
|}
If you are short in diskspace, you can get fancy, and keep only the last 5 (runspercycle) vtapes online, 
by removing the contents of the data directory in each vtape that is older than runspercycle, 
except the first pair of files (the label).
Even the "TAPEEND" pair of files is not strictly needed for Amanda.
An erased vtape, with correct label then looks like:

 $ ls -l /amandatapes/daily/vtape4
 -rw-------  1 amanda disk      10 Mar 29 00:04 00000-DAILY-04
 -rw-------  1 amanda disk   32768 Mar 29 00:04 00000.DAILY-04