Migrating containers across regions¶

Requirements¶

• You must install the full Guzzle package, so that the process can take advantage of Guzzle’s batching functionality (it allows parallel requests to be batched for greater efficiency). You can do this by running:

composer require guzzle/guzzle

• Depending on the size and number of transfer items, you will need to raise PHP’s memory limit:

ini_set('memory_limit', '512M');

• You will need to enact some kind of backoff/retry strategy for rate limits. Guzzle comes with a convenient feature that just needs to be added as a normal subscriber:

use Guzzle\Plugin\Backoff\BackoffPlugin;

// set timeout in secs
$timeout = 10;

// set HTTP error codes
$httpErrors = array(500, 503, 408);

$backoffPlugin = BackoffPlugin::getExponentialBackoff($timeout, $httpErrors);
$client->addSubscriber($backoffPlugin);

This tells the client to retry up to 10 times for failed requests have resulted in these HTTP status codes: 500, 503 or 408.

Setup¶

You can access all this functionality by executing:

$ordService = $client->objectStoreService('cloudFiles', 'ORD');
$iadService = $client->objectStoreService('cloudFiles', 'IAD');

$oldContainer = $ordService->getContainer('old_container');
$newContainer = $iadService->getContainer('new_container');

$iadService->migrateContainer($oldContainer, $newContainer);

It’s advisable to do this process in a Cloud Server in one of the two regions you’re migrating to/from. This allows you to use privateURL as the third argument in the objectStoreService methods like this:

$client->objectStoreService('cloudFiles', 'IAD', 'privateURL');

This will ensure that traffic between your server and your new IAD container will be held over the internal Rackspace network which is free.

Options¶

You can pass in an array of arguments to the method:

$options = array(
    'read.batchLimit'  => 100,
    'read.pageLimit'   => 100,
    'write.batchLimit' => 50
);

$iadService->migrateContainer($oldContainer, $newContainer, $options);