Replicating migrations

Replication transfers data from source virtual machines to the target environment. It creates or updates target disks without deploying the virtual machines.

You can run multiple replications for the same migration to keep data in sync before deployment. This reduces the amount of data transferred during the final synchronization and minimizes downtime when switching to the target environment.

You can start replication immediately when creating a migration or start it later on the Replications tab.

Prerequisites

A migration must be created before replication, as described in Creating migrations.

To replicate a migration

Admin panel

On the Compute > Migration > Migrations tab, click the name of the required migration.
On the Replications tab, click Create replication.
In the Create replication window, configure the replication options:
- Enable Shut down instances to shut down source VMs during the final switch to the target environment.
- Enable Auto-deploy VMs to automatically deploy VMs after replication completes.
Click Create.

After replication starts, data is transferred from the source to the target environment. You can monitor the replication progress and status in the replication details.

If Auto-deploy VMs is enabled, deployment starts automatically after replication completes.

Command-line interface

Use the following command:

vinfra service compute maas migration replication add --migration <migration>
                                                      [--shutdown-instances | --dont-shutdown-instances] 
                                                      [--auto-deploy | --manual-deploy]

--migration <migration>: Migration ID or name
--shutdown-instances: Shut down source instances after migration completes
--dont-shutdown-instances: Do not shut down source instances after migration completes
--auto-deploy: Automatically create deployments for the migration
--manual-deploy: Create deployments manually for the migration

For example, to replicate the migration ubuntu_24.04, run:

# vinfra service compute maas migration replication add --migration ubuntu_24.04 --dont-shutdown-instances --auto-deploy

You can check your created migration replication in the vinfra service compute maas migration replication list output:

# vinfra service compute maas migration replication list --migration Ubuntu-22.04-UEFI
+---------------+-------+------------+------------+-------------+----------------------------+
| id            | index | status     | replica_mb | replica_sec | created_at                 |
+---------------+-------+------------+------------+-------------+----------------------------+
| 7675ecfd<...> | 1     | REPLICATED | 6382.75    | 87.72       | 2026-05-07T17:17:09.170469 |
+---------------+-------+------------+------------+-------------+----------------------------+

To cancel a replication

Canceling a replication takes effect immediately and cannot be reversed.

Admin panel

On the Compute > Migration > Migrations tab, click the name of the required migration.
On the Replications tab, click the ongoing replication.
On the replication right pane, click Cancel.
In the confirmation window, click Confirm.

Command-line interface

Use the following command:

vinfra service compute maas migration replication cancel --migration <migration> <replication>

--migration <migration>: Migration ID or name
<replication>: Replication ID or name

For example, to cancel the replication with the ID 1444135b-863e-4f4c-94b4-d415c497c169, run:

# vinfra service compute maas migration replication cancel --migration ubuntu_24.04 1444135b-863e-4f4c-94b4-d415c497c169

To delete a replication

Admin panel

On the Compute > Migration > Migrations tab, click the name of the required migration.
On the Replications tab, click the required replication.
On the replication right pane, click Delete.
In the confirmation window, click Delete.

Command-line interface

Use the following command:

vinfra service compute maas migration replication remove --migration <migration> <replication>

--migration <migration>: Migration ID or name
<replication>: Replication ID or name

For example, to delete the replication with the ID 1444135b-863e-4f4c-94b4-d415c497c169, run:

# vinfra service compute maas migration replication remove --migration ubuntu_24.04 1444135b-863e-4f4c-94b4-d415c497c169