|
@@ -27,7 +27,7 @@ level margin: \\n[rst2man-indent\\n[rst2man-indent-level]]
|
|
|
.\" new: \\n[rst2man-indent\\n[rst2man-indent-level]]
|
|
|
.in \\n[rst2man-indent\\n[rst2man-indent-level]]u
|
|
|
..
|
|
|
-.TH "BORG-TRANSFER" 1 "2022-06-25" "" "borg backup tool"
|
|
|
+.TH "BORG-TRANSFER" 1 "2022-06-26" "" "borg backup tool"
|
|
|
.SH NAME
|
|
|
borg-transfer \- archives transfer from other repository
|
|
|
.SH SYNOPSIS
|
|
@@ -91,6 +91,60 @@ consider first N archives after other filters were applied
|
|
|
.BI \-\-last \ N
|
|
|
consider last N archives after other filters were applied
|
|
|
.UNINDENT
|
|
|
+.SH EXAMPLES
|
|
|
+.INDENT 0.0
|
|
|
+.TP
|
|
|
+.B ::
|
|
|
+# 0. Have borg 2.0 installed on client AND server, have a b12 repo copy for testing.
|
|
|
+.sp
|
|
|
+# 1. Create a new "related" repository:
|
|
|
+# here, the existing borg 1.2 repo used repokey\-blake2 (and aes\-ctr mode),
|
|
|
+# thus we use repokey\-blake2\-aes\-ocb for the new borg 2.0 repo.
|
|
|
+# staying with the same chunk id algorithm (blake2) and with the same
|
|
|
+# key material (via \-\-other\-repo <oldrepo>) will make deduplication work
|
|
|
+# between old archives (copied with borg transfer) and future ones.
|
|
|
+# the AEAD cipher does not matter (everything must be re\-encrypted and
|
|
|
+# re\-authenticated anyway), you could also choose repokey\-blake2\-chacha20\-poly1305.
|
|
|
+# in case your old borg repo did not use blake2, just remove the "\-blake2".
|
|
|
+$ borg \-\-repo \fI\%ssh://borg2@borgbackup/./tests/b20\fP rcreate
|
|
|
+.IP "System Message: ERROR/3 (docs/borg-transfer.rst:, line 88)"
|
|
|
+Unexpected indentation.
|
|
|
+.INDENT 7.0
|
|
|
+.INDENT 3.5
|
|
|
+\-\-other\-repo \fI\%ssh://borg2@borgbackup/./tests/b12\fP \-e repokey\-blake2\-aes\-ocb
|
|
|
+.UNINDENT
|
|
|
+.UNINDENT
|
|
|
+.sp
|
|
|
+# 2. Check what and how much it would transfer:
|
|
|
+$ borg \-\-repo \fI\%ssh://borg2@borgbackup/./tests/b20\fP transfer
|
|
|
+.IP "System Message: ERROR/3 (docs/borg-transfer.rst:, line 92)"
|
|
|
+Unexpected indentation.
|
|
|
+.INDENT 7.0
|
|
|
+.INDENT 3.5
|
|
|
+\-\-other\-repo \fI\%ssh://borg2@borgbackup/./tests/b12\fP \-\-dry\-run
|
|
|
+.UNINDENT
|
|
|
+.UNINDENT
|
|
|
+.sp
|
|
|
+# 3. Transfer (copy) archives from old repo into new repo (takes time and space!):
|
|
|
+$ borg \-\-repo \fI\%ssh://borg2@borgbackup/./tests/b20\fP transfer
|
|
|
+.IP "System Message: ERROR/3 (docs/borg-transfer.rst:, line 96)"
|
|
|
+Unexpected indentation.
|
|
|
+.INDENT 7.0
|
|
|
+.INDENT 3.5
|
|
|
+\-\-other\-repo \fI\%ssh://borg2@borgbackup/./tests/b12\fP
|
|
|
+.UNINDENT
|
|
|
+.UNINDENT
|
|
|
+.sp
|
|
|
+# 4. Check if we have everything (same as 2.):
|
|
|
+$ borg \-\-repo \fI\%ssh://borg2@borgbackup/./tests/b20\fP transfer
|
|
|
+.IP "System Message: ERROR/3 (docs/borg-transfer.rst:, line 100)"
|
|
|
+Unexpected indentation.
|
|
|
+.INDENT 7.0
|
|
|
+.INDENT 3.5
|
|
|
+\-\-other\-repo \fI\%ssh://borg2@borgbackup/./tests/b12\fP \-\-dry\-run
|
|
|
+.UNINDENT
|
|
|
+.UNINDENT
|
|
|
+.UNINDENT
|
|
|
.SH SEE ALSO
|
|
|
.sp
|
|
|
\fIborg\-common(1)\fP
|