Understanding the Migrations Page
The 'Migrations' tab makes it easy to copy buckets or containers from other object storage services supporting S3 or Swift compatible APIs.
Creating a migration from an S3 account
Locate your Access Key and Secret Key from the Amazon Web Services Security Credentials page on the Amazon S3 site.
Navigate to the (Panel > ‘Could Services’ > ‘DreamObjects’) page in your DreamHost panel.
Click the ‘Migrations’ Tab.
In the picture below, no migrations have been attempted:
Click the Create Migration button.
Several fields display and a Choose Buckets button appears:
Enter your S3 Access Key in the Access Key field, and your S3 Secret Key in the Secret Key field.
Click the Choose Buckets button.
A list of your S3 Buckets opens. By default, all of the buckets are highlighted in blue with a black check mark indicating that they are selected:
Enter a name for your migration in the Name field above the buckets. The name is for your use only. If you don’t enter a name, one is automatically generated and assigned to your migration.
Click to select or deselect the buckets you wish to migrate, or use the Select All or Select None buttons.
Click the Start Migration button.
A green bar appears at the top of the screen indicating that your migration is successfully added:
You are returned to the main page of the 'Migrations' tab and your active migration displays in the Active Migrations section of the page.
Bucket naming convention conflicts
If the naming conventions used for your S3 buckets or Swift Containers are not compatible with the naming conventions for DreamObjects, a Bucket Name Conflicts screen appears:
Currently, Bucket names using capital letters cannot be imported because capital letters can create DNS issues. If you have S3 Buckets or Swift Containers that use capital letters, you are asked to change their names. If you wish, you can use dashes (as pictured above) or dots to separate words.
To avoid any issues, modify your bucket names to resolve any naming conflicts, then click the Resolve Conflicts button.
You are returned to the main page of the 'Migrations' and your active migration displays in the Active Migrations section of the page until it completes:
Once a Migration has been successfully added, it is viewable on the DreamObjects 'Migration' tab. Migrations are grouped as either Active or Completed:
Viewing migration details
If you’d like to see how long your Migration has been running, you can click the View Details button:
Understanding the status of migration Buckets
You can obtain information on the status of individual buckets by clicking the View Buckets button to display the buckets for your Migration:
Migrated and migrating Buckets reflect one of the following five states:
- Queued — the Bucket or Container and all of its objects have been successfully copied to DreamObjects.
- In Progress — the Bucket or Container is in the process of being copied to DreamObjects and has not yet completed the action.
- Stopped — the migration process for the Bucket or Container has either failed, or was manually stopped by the user requesting the migration.
- Partial — some Buckets or Containers and their contents have been migrated, and some have not. This may have been caused by a failure during Object Synchronization. Such failures can be caused by deleting your S3 or Swift Buckets, or by revoking your S3 or Swift credentials before the migration is complete.
- Complete — the Bucket or Container and all of its objects have been successfully copied to DreamObjects.