         | Did this page help you? Yes No Tell us about it... |
ec2-migrate-bundle
Description
Copy a bundled AMI from one Region to another. For information on Regions, go to the Amazon Elastic Compute Cloud User Guide.
![[Note]](http://docs.amazonwebservices.com/docs-common/images/note.png) | Note |
|---|---|
After copying a bundled AMI to a new Region, make sure to register it as a new AMI. During migration, Amazon EC2 replaces the kernel and
RAM disk in the manifest file with a kernel and RAM disk
designed for the destination Region. Unless the --no-mapping
parameter is given,
|
Syntax
ec2-migrate-bundle -k
private_key -c
cert -a
access_key_id -s
secret_key --bucket
source_s3_bucket
--destination-bucket
destination_s3_bucket
--manifest manifest_path
[--location location] [--ec2cert
ec2_cert_path] [--kernel
kernel-id] [--ramdisk
ramdisk_id] [--no-mapping]
[--region mapping_region_name]
Options
| Option | Description | Required |
|---|---|---|
|
|
The path to the user's PEM-encoded RSA key file. Example: |
Yes |
|
|
The user's PEM encoded RSA public key certificate file. Example: |
Yes |
|
|
The AWS access key ID. Example: |
Yes |
|
|
The AWS secret access key. Example: |
Yes |
|
|
The source Amazon S3 bucket where the AMI is located, followed by an optional '/'-delimited path prefix. Example: |
Yes |
|
|
The destination Amazon S3 bucket, followed by an optional '/'-delimited path prefix. If the destination bucket does not exist, it is created. Example: |
Yes |
|
|
The location of the Amazon S3 source manifest. Default: None Example: |
Yes |
|
|
The location of the destination Amazon S3 bucket. If the bucket exists and the location is specified, the tool exits with an error. if the specified location does not match the actual location. If the bucket exists and no location is specified, the tool uses the bucket's location. If the bucket does not exist and the location is specified, the tool creates the bucket in the specified location. If the bucket does not exist and location is not specified, the tool creates the bucket without a location constraint (in the US). Valid Values: Default: US Example: |
No |
|
|
The access control list policy of the bundled image. Valid Values: Default:
Example: |
No |
|
|
Automatically retries on all Amazon S3 errors, up to five times per operation. Example: |
No |
|
|
The ID of the kernel to select. Example: |
No |
|
|
The ID of the RAM disk to select. Some kernels require additional drivers at launch. Check the kernel requirements for information on whether you need to specify a RAM disk. To find kernel requirements, go to the Resource Center and search for the kernel ID. Example: |
No |
|
|
Disables automatic mapping of kernels and RAM disks. Example:
|
No |
|
|
Region to look up in the mapping file. If no Region is specified, Amazon EC2 attempts to determine the Region from the location of the Amazon S3 bucket. Example: |
No |
Output
Status messages describing the stages and status of the bundling process.
Example
This example copies the AMI specified in the
my-ami.manifest.xml manifest from the US to the
EU.
$ec2-migrate-bundle --cert cert-THUMBPRINT.pem --privatekey pk-THUMBPRINT.pem --access-key AKIADQKE4SARGYLE --secret-key eW91dHViZS5jb20vd2F0Y2g/dj1SU3NKMTlzeTNKSQ== --bucket my-us-bucket --destination-bucket my-eu-bucket --manifest my-ami.manifest.xml --location EUDownloading manifest my-ami.manifest.xml from my-us-bucket to /tmp/ami-migration-my-ami.manifest.xml/my-ami.manifest.xml ... Copying 'my-ami.part.00'... Copying 'my-ami.part.01'... Copying 'my-ami.part.02'... Copying 'my-ami.part.03'... Copying 'my-ami.part.04'... Copying 'my-ami.part.05'... Copying 'my-ami.part.06'... Copying 'my-ami.part.07'... Copying 'my-ami.part.08'... Copying 'my-ami.part.09'... Copying 'my-ami.part.10'... Your new bundle is in S3 at the following location: my-eu-bucket/my-ami.manifest.xml
