ec2-migrate-manifest
Description
Modify a bundled AMI to work in a new region. For information on regions, go to the
You must use this command if you are bundling in one region for use in
another or if you copy a bundled AMI out of band (without using
ec2-migrate-bundle) and want to use it in a different
region.
![[Note]](note.png) | Note |
|---|---|
This command replaces the kernel and RAM disk in the manifest file with a kernel and RAM disk designed for the destination region. |
Syntax
ec2-migrate-manifest
-k private_key
-c cert
-a access_key_id
-s secret_key
--manifest manifest_path
--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 location of the Amazon S3 source manifest. Default: None Example: |
Yes |
|
|
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 |
|
|
Overrides the file containing kernel and RAM disk region mappings. Example: |
No |
|
|
Overrides the file containing kernel and RAM disk region mappings from the specified hostname portion of a URL. 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, The tool 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-manifest --manifest my-ami.manifest.xml --cert cert-HKZYKTAIG2ECMXYIBH3HXV4ZBZQ55CLO.pem --privatekey pk-HKZYKTAIG2ECMXYIBH3HXV4ZBZQ55CLO.pem --region eu-west-1Backing up manifest... Successfully migrated my-ami.manifest.xml It is now suitable for use in eu-west-1.