DreamObjects Migrations

Understanding the Migrations Page
The DreamObjects 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

 * 1) 	Before you begin, locate your Access Key and Secret Key from the Amazon Web Services Security Credentials page on the Amazon S3 site.
 * 2) 	Open the DreamHost Panel.
 * 3) 	On the left side of the panel expand the Storage section and click DreamObjects.
 * You are navigated to the DreamObjects page where a list of Users is displayed.
 * 1) 	Click the Migrations Tab.
 * In the picture below, no migrations have been attempted.
 * [[File: Mig2.png]]
 * 1) 	Click the Create Migrations button.
 * Several fields will display and a Choose Buckets button will become visible.
 * [[File:Mig3.png]]
 * 1) 	Enter your S3 Access Key  in the Access Key field, and your S3 Secret Key in the Secret Key field.
 * 2) 	Click the Choose Buckets button.
 * A list of your S3 Buckets will open. By default all of the buckets are highlighted in blue with a black check mark indicating that they have been selected.
 * [[File:Mig3.png]]
 * 1) 	Type a name for your Migration in the Name field above the buckets.
 * The name is for your use only. If you don't type anything a name will be automatically generated and assigned to your migration.
 * 1) 	Click to select or deselect the buckets you would like to migrate, or use the Select All or Select None buttons.
 * 2) 	Click the Start Migration button.
 * A green bar appears at the top of the screen indicating that your 'Migration has been successfully added.''
 * [[File:Mig4.png]]
 * You are returned to the main page of the Migrations Tab, and your active migration will display 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 will open.
 * [[File:Mig6.png]]
 * 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 will be asked to change their names.  If you would like, you can use dashes (as pictured above) or dots to separate words.
 * 1) Modify your bucket names to resolve any naming conflicts and then click the Resolve Conflicts button.
 * You are returned to the main page of the Migrations Tab, and your active migration will display in the Active Migrations section of the page until it has completed.
 * [[File:Mig5.png]]

Viewing Migrations
Once a Migration has been successfully added, it is viewable on the DreamObjects Migration tab. Migrations are grouped as either Active or Completed.

View Migration Details
If you'd like to see how long your Migration has been running, you can click the View Details button.

View Migration Buckets
You can get information on the status of individual buckets by clicking the View Buckets button to display the buckets for your Migration.

Migrated and migrating Buckets will 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 Sychronization.  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.