Migrating Data In
A migration copies data from an existing source into a MASS volume. Use it when moving off another storage system, or to seed a new volume with an existing dataset.
info
Migration is a preview feature. Review the progress and per-job summary before treating a migration as complete.
Before You Start​
- The target volume must already exist and be Ready
- While the migration runs, the target volume becomes read-only and is shielded from deletion, so the in-progress copy cannot be clobbered
Create a Migration​
- Navigate to Protection → Migrations
- Click Create
- Pick the target volume
- Pick the Source Type:
| Source | Required fields | Availability |
|---|---|---|
| NFS | Server, Export (plus optional SubPath, Version, mount options) | Dashboard and CLI |
| Local (hostPath) | Node, HostPath (absolute path on that node) | Dashboard and CLI |
| S3 | Bucket (plus optional Endpoint, Region, Prefix) and credentials | CLI only — the Dashboard option is disabled |
- Complete the source configuration and submit
You can also start a migration from a volume's detail dialog, on its Migrate / Import tab.
From the CLI​
The CLI supports all three source types, including S3:
# NFS source
mass-ctl migration create --volume-id <id> \
--source nfs --nfs-server 10.0.0.5 --nfs-export /export/data
# S3 source (needs credentials, or --s3-allow-insecure for a public bucket)
mass-ctl migration create --volume-id <id> \
--source s3 --s3-bucket my-bucket --s3-region us-east-1 \
--credential-secret my-s3-creds
# Local path on a specific node
mass-ctl migration create --volume-id <id> \
--source local --local-node node-1 --local-host-path /mnt/legacy
Track Progress​
| Where | What you get |
|---|---|
| Protection → Migrations | List of migrations with their phase |
| Migration detail dialog | Live progress and source configuration |
mass-ctl migration progress <id> --watch | Re-polls until the migration reaches a terminal phase |
mass-ctl migration list --phase Copying | Filter by phase |
Phases: Pending, Scheduled, Preparing, Copying, Verifying, Completed, Failed,
Cancelled.
Cancel a Migration​
Cancel mid-run from the detail dialog, or:
mass-ctl migration cancel <id>
Review the Result​
When a migration finishes, review its per-job summary in the detail dialog or with
mass-ctl migration describe <id>. The target volume returns to read-write.