Migrating ZFS File Systems

To migrate a local or remote ZFS or UFS file system to a target ZFS file system, use shadow migration. The target file system is also called the shadow file system.

Use the following commands to manage shadow migration:

• The shadowadm command stops, resumes, or cancels shadow migration.

• The shadowstat command with its options monitors migrations running on the system. Use the shadowstat command without options to monitor the progress of migrations. The displayed information is continuously updated until you type Ctrl-C.

  The command's -E and -e options are particularly useful.

  • To list all currently running migrations and identify those that could not be completed because of errors, use the -E option.

  • To list a specific migration and check if errors are causing the migration to fail, use the -e option.

For an example that shows how these commands are used, see Starting and Monitoring File System Migrations.

Caution:

When migrating file systems, observe the following rules:

• Do not add or remove data from the file system while it is being migrated. Otherwise, those changes are excluded from migration.

• Do not change the mountpoint property of the shadow file system while migration is in progress.