The site migrations form exists in order to help you to migrate a site from one client to the other. It is designed to handle the nodes, services and supernets when doing so.
A site migration is a migration from one site to another site. If you want to migrate every site in a client, this means that you will need a site migration for every site in the migrating client.
In order to start a migration, you first need to create a site migration. You can do this by clicking on the 'new' button, this brings you to the create site migration form.
The first thing you need to do is to find the site you want to migrate. In the field “From Site or Client”, you can start typing and it will automatically fill in the Client code or Site code you're looking for. If you select one, all matching sites will show up in the grid below it. You can do the same for the target site in the right field: “To site or client”.
You can now select your sites to migrate. To do this you select the sites you want to migrate in the left grid. There are two ways to migrate a site:
When you click on the “Merge” or “Duplicate” button, the left grid is filled in with the correct target sites. At that point, nothing has been done in the backend yet. Your selections will only be applied once you click on the “OK” button. Before that, you can undo your selections with the undo button and nothing will happen. Cancelling the form will also negate anything you selected.
When you click on the “OK” button, the site migrations and corresponding sites (if needed) are created. Nodes, services and supernets are still at their original place. This migration happens at the next step.
Once a site migration has been created, you can select it in the site migrations grid. It has been sorted so that the most recent migrations appear on top. The grid hides any complete migrations by default, but if you check the “include completed”-checkbox you will be able to see all completed migrations.
When you have selected a migration, you will see two grids, containing the nodes of each site in the migration, grouped by service. You can then move one service to the other side, one at a time. The one important field in the form is the “Share migration site supernets”. This dropdown determines how supernets are transferred to the target client. There are four options you can select:
To migrate a service, you click on a the service's nodes on the migrating site. Then click on the “»” button, and then they are automatically migrated. You can also migrate the node back if desired. If no more services remain on the original site, you can set its status to complete, and the migration is finished.
You can also set the migration to completed when it's active, while there are still nodes left on the migrating site. You can also set the migration back from completed by migrating a node back to its original site. This is not recommended however.