1
0

backup 3.2 KB

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