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 As a side-effect,
  67 .I backup
  68 run on the default dump set,
  69 .LR set1 ,
  70 will also print the last few
  71 .I fossil
  72 dump scores.
  73 .PP
  74 .I Tobackup
  75 prints the names of all the sealed arenas not yet backed up to a disc
  76 in the current
  77 .IR set .
  78 .PP
  79 .I Dumparenas
  80 copies the named
  81 .IR arena s,
  82 one per track,
  83 to the device
  84 .IR dev ,
  85 which is first mounted via
  86 .IR cdfs (4).
  87 .I Venti/rdarena
  88 is used to extract each arena.
  89 .PP
  90 .I Tobackup
  91 and
  92 .I dumparenas
  93 are invoked internally by
  94 .IR backup .
  95 .PP
  96 .I Restore
  97 copies each data track (assumed to be a saved arena) on
  98 .I dev
  99 (by default,
 100 .LR /dev/sdC0 )
 101 into its appropriate place in the
 102 .I venti
 103 arenas partition
 104 (locally,
 105 .BR /dev/sde0/arenas ),
 106 thus adding the arena to the current
 107 .I venti
 108 store.
 109 The arena size of the arena partition must match the size of the arenas
 110 on optical disc (except for ~60K of trailing debris on the optical disc arenas).
 111 .PP
 112 .I Arena-#
 113 must be the number (starting from zero)
 114 of the first arena slot in the arenas partition that
 115 you wish to restore into from the current optical disc
 116 .RI ( not
 117 necessarily that of the first arena on the disc).
 118 .I Restore
 119 will prompt for confirmation that the first arena is the correct one,
 120 after printing a summary of its arena header.
 121 Typing
 122 .L y
 123 will proceed normally,
 124 .L n
 125 will abort all processing,
 126 and
 127 .L skip
 128 will cause
 129 .I restore
 130 to proceed to the next track and ask for confirmation of it.
 131 .PP
 132 The arenas partition must be formatted
 133 (see
 134 .I fmtarenas
 135 in
 136 .IR venti-fmt (8))
 137 before restoring into it.
 138 When all the arenas have been restored,
 139 it will be necessary to build a new
 140 .I venti
 141 index,
 142 the usual steps being to run
 143 .IR checkarenas ,
 144 .IR fmtisect ,
 145 .IR fmtbloom ,
 146 .IR fmtindex ,
 147 and
 148 .IR "buildindex -b" ,
 149 all from
 150 .IR venti-fmt (8).
 151 .SH FILES
 152 .TF /sys/lib/backup
 153 .TP
 154 .B /sys/lib/backup
 155 backup scripts and records
 156 .TP
 157 .B set1
 158 subdirectory containing records for default backup set
 159 .TP
 160 .B /sys/log
 161 source of dump scores
 162 .SH SOURCE
 163 .B /sys/lib/backup
 164 .SH SEE ALSO
 165 .IR venti (1),
 166 .IR cdfs (4),
 167 .IR venti (8),
 168 .IR venti-fmt (8),
 169 .IR venti-backup (8)
 170 .br
 171 .IR "Venti Backup on Blu-Ray Discs"
 172 .SH BUGS
 173 Assumes a single arenas partition named
 174 .LR arena0 .
 175 Assumes that the file server's arenas are accessible on it as
 176 .LR /dev/fs/arena0 .