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

1. Navigate to Protection → Migrations
2. Click Create
3. Pick the target volume
4. 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

5. 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.