         | Did this page help you? Yes No Tell us about it... |
ec2-migrate-manifest
Description
Modify a bundled AMI to work in a new Region. For information on Regions, go to the Amazon Elastic Compute Cloud User Guide.
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]](http://docs.amazonwebservices.com/docs-common/images/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 -m
manifest_path {(-a
access_key_id -s
secret_key --region
mapping_region_name) |
--no-mapping} [--kernel
kernel-id] [--ramdisk
ramdisk_id] [--ec2cert
ec2_cert_path]
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. Condition: Required if using automatic mapping. Example: |
Conditional |
|
|
The AWS secret access key. Condition: Required if using automatic mapping. Example: |
Conditional |
|
|
The manifest file. 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. Condition: Required if you're not
providing the |
Conditional |
|
|
Region to look up in the mapping file. Condition: Required if using automatic mapping. Example: |
Conditional |
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.
