/brz/remove-bazaar

To get this branch, use:
bzr branch http://gegoxaren.bato24.eu/bzr/brz/remove-bazaar

« back to all changes in this revision

Viewing changes to doc/en/admin-guide/backup.txt

  • Committer: Jelmer Vernooij
  • Date: 2020-08-22 22:46:24 UTC
  • mfrom: (7490.40.105 work)
  • mto: This revision was merged to the branch mainline in revision 7521.
  • Revision ID: jelmer@jelmer.uk-20200822224624-om4a4idsr7cn8jew
merge lp:brz/3.1.

Show diffs side-by-side

added added

removed removed

Lines of Context:
44
44
The features that make Bazaar a good distributed version control system also
45
45
make it a good choice for backing itself up.  In particular, complete and
46
46
consistent copies of any branch can easily be obtained with the ``branch`` and
47
 
``pull`` commands.  As a result, a backup process can simply run ``bzr pull``
 
47
``pull`` commands.  As a result, a backup process can simply run ``brz pull``
48
48
on a copy of the main branch to fully update that copy.  If this backup
49
49
process runs periodically, then the backups will be as current as the last
50
50
time that ``pull`` was run.  (This is in addition to the fact
76
76
Bound Branch Backups
77
77
~~~~~~~~~~~~~~~~~~~~
78
78
 
79
 
When ``bzr pull`` is run regularly to keep a backup copy up to date, then it
 
79
When ``brz pull`` is run regularly to keep a backup copy up to date, then it
80
80
is possible that there are new revisions in the original branch that have not
81
81
yet been pulled into the backup branch.  To alleviate this problem, we can set
82
82
the branches up so that new revisions are *pushed* to the backup rather than
86
86
is set up on the server itself rather than on the backup machine.  For each
87
87
branch that should be backed up, you just need to use the ``bind`` command to
88
88
set the URL for the backup branch.  In our example, we first need to create
89
 
the branches on the backup server (we'll use ``bzr push``, but we could as
90
 
easily have used ``bzr branch`` from the backup server)
 
89
the branches on the backup server (we'll use ``brz push``, but we could as
 
90
easily have used ``brz branch`` from the backup server)
91
91
 
92
92
::
93
93
 
143
143
but when it came time to restore from backups, finding out that the backups
144
144
themselves were flawed.  As such, it is important to check the quality of the
145
145
backups periodically.  In Bazaar, there are two ways to do this: using the
146
 
``bzr check`` command and by simply making a new branch from the backup.  The
147
 
``bzr check`` command goes through all of the revisions in a branch and checks
 
146
``brz check`` command and by simply making a new branch from the backup.  The
 
147
``brz check`` command goes through all of the revisions in a branch and checks
148
148
them for validity according to Bazaar's internal invariants.  Since it goes
149
149
through every revision, it can be quite slow for large branches.  The other
150
150
way to ensure that the backups can be restored from is to perform a test
151
151
restoration.  This means performing the restoration process in a temporary
152
 
directory.  After the restoration process, ``bzr check`` may again be relevant
 
152
directory.  After the restoration process, ``brz check`` may again be relevant
153
153
for testing the validity of the restored branches.  The following two sections
154
154
present two restoration recipes.
155
155