4
Preparing for data migration
5
----------------------------
7
Before starting a migration, there are a few important things to do
10
1. Take a complete backup.
12
2. Take some time to purge obsolete branches.
14
A complete backup gives you a safety net in case anything goes wrong.
16
Purging obsolete branches reduces the amount of data that needs to
17
be migrated. See `Finding obsolete branches`_ later for some tips
21
Introducing the upgrade-related commands
22
----------------------------------------
24
There are 3 important commands to be aware of when migrating data.
26
* **check** - check a repository, branch or tree for data integrity errors
28
* **reconcile** - fix data integrity errors
30
* **upgrade** - migrate data to a different format.
32
**reconcile** is rarely needed but it's good practice to run **check**
33
before runing **upgrade**.
35
For detailed help on these commands, see the Bazaar User Reference.
37
.. _Bazaar User Reference: ../user-reference/index.html
40
Migrating a standalone branch
41
-----------------------------
46
Migrating branches in a shared repository
47
-----------------------------------------
52
Migrating stacked branches
53
--------------------------
55
All branches stacked on another branch need to be upgraded **before**
56
the stacked on branch. For branches managed on Launchpad, the default
57
policy is for branches to be stacked on trunk so that means that you
58
need to give your community plenty of time to upgrade any branches
59
they own on Launchpad before you schedule the trunk upgrade.
added
removed
doc/en/upgrade-guide/data_migration.txt
