sys/man/8/backup

   1 .TH BACKUP 8
   2 .SH NAME
   3 backup, tobackup, dumparenas, restore \- backup venti arenas to blu-ray discs or restore from them
   4 .SH SYNOPSIS
   5 .B backup
   6 [
   7 .B -n
   8 ] [
   9 .B -d
  10 .I dev
  11 ] [
  12 .B -s
  13 .I set
  14 ]
  15 .br
  16 .B tobackup
  17 [
  18 .I set
  19 ]
  20 .br
  21 .B dumparenas
  22 .I dev
  23 .I arena
  24 \&...
  25 .br
  26 .B restore
  27 .I arena-#
  28 [
  29 .I dev
  30 ]
  31 .SH DESCRIPTION
  32 These programs reside in
  33 .B /sys/lib/backup
  34 and provide a means to backup
  35 .IR venti (8)
  36 storage to Blu-ray (or other large optical) discs,
  37 while keeping track of which arenas have been written to which discs.
  38 Multiple backup sets are supported,
  39 as is (re)loading a
  40 .I venti
  41 store from a backup thus made.
  42 .PP
  43 The first time that
  44 .I backup
  45 is run,
  46 it will dump all sealed
  47 .I venti
  48 arenas.
  49 Thereafter,
  50 it will append only those sealed arenas not already written to a disc
  51 within the given backup set.
  52 The
  53 .B -s
  54 option uses a backup
  55 .I set
  56 other than the default.
  57 The
  58 .B -d
  59 option uses a disc burner
  60 other than the default
  61 .LR /dev/sdD0 .
  62 The
  63 .B -n
  64 option goes through the motions but does not burn any tracks
  65 on the Blu-ray disc.
  66 .PP
  67 .I Tobackup
  68 prints the names of all the sealed arenas not yet backed up to a disc
  69 in the current
  70 .IR set .
  71 .PP
  72 .I Dumparenas
  73 copies the named
  74 .IR arena s,
  75 one per track,
  76 to the device
  77 .IR dev ,
  78 which is first mounted via
  79 .IR cdfs (4).
  80 .I Venti/rdarena
  81 is used to extract each arena.
  82 .PP
  83 .I Tobackup
  84 and
  85 .I dumparenas
  86 are invoked internally by
  87 .IR backup .
  88 .PP
  89 .I Restore
  90 copies each data track (assumed to be a saved arena) on
  91 .I dev
  92 (by default,
  93 .LR /dev/sdC0 )
  94 into its appropriate place in the
  95 .I venti
  96 arenas partition
  97 (locally,
  98 .BR /dev/sde0/arenas ),
  99 thus adding the arena to the current
 100 .I venti
 101 store.
 102 The arena size of the arena partition must match the size of the arenas
 103 on optical disc (except for ~60K of trailing debris on the optical disc arenas).
 104 .PP
 105 .I Arena-#
 106 must be the number (starting from zero)
 107 of the first arena slot in the arenas partition that
 108 you wish to restore into from the current optical disc
 109 .RI ( not
 110 necessarily that of the first arena on the disc).
 111 .I Restore
 112 will prompt for confirmation that the first arena is the correct one,
 113 after printing a summary of its arena header.
 114 Typing
 115 .L y
 116 will proceed normally,
 117 .L n
 118 will abort all processing,
 119 and
 120 .L skip
 121 will cause
 122 .I restore
 123 to proceed to the next track and ask for confirmation of it.
 124 .PP
 125 The arenas partition must be formatted
 126 (see
 127 .I fmtarenas
 128 in
 129 .IR venti-fmt (8))
 130 before restoring into it.
 131 When all the arenas have been restored,
 132 it will be necessary to build a new
 133 .I venti
 134 index,
 135 the usual steps being to run
 136 .IR checkarenas ,
 137 .IR fmtisect ,
 138 .IR fmtbloom ,
 139 .IR fmtindex ,
 140 and
 141 .IR "buildindex -b" ,
 142 all from
 143 .IR venti-fmt (8).
 144 .SH FILES
 145 .TF /sys/lib/backup
 146 .TP
 147 .B /sys/lib/backup
 148 backup scripts and records
 149 .TP
 150 .B set1
 151 subdirectory containing records for default backup set
 152 .TP
 153 .B /sys/log
 154 source of dump scores
 155 .SH SOURCE
 156 .B /sys/lib/backup
 157 .SH SEE ALSO
 158 .IR venti (1),
 159 .IR cdfs (4),
 160 .IR venti (8),
 161 .IR venti-fmt (8),
 162 .IR venti-backup (8)
 163 .br
 164 .IR "Venti Backup on Blu-Ray Discs"
 165 .SH BUGS
 166 Assumes a single arenas partition named
 167 .LR arena0 .
 168 Assumes that the file server's arenas are accessible on it as
 169 .LR /dev/fs/arena0 .