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
	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
`-k, --privatekey` `private_key`	The path to the user's PEM-encoded RSA key file. Example: `-k pk-HKZYKTAIG2ECMXYIBH3HXV4ZBZQ55CLO.pem`	Yes
`-c, --cert` `cert`	The user's PEM encoded RSA public key certificate file. Example: `-c cert-HKZYKTAIG2ECMXYIBH3HXV4ZBZQ55CLO.pem`	Yes
`-a, --access-key` `access_key_id`	The AWS access key ID. Example: `-a AKIADQKE4SARGYLE`	Yes
`-s, --secret-key` `secret_key`	The AWS secret access key. Example: `-s eW91dHViZS5jb20vd2F0Y2g/dj1SU3NKMTlzeTNKSQ==`	Yes
`--manifest` `manifest`	The location of the Amazon S3 source manifest. Default: None Example: `--manifest my-ami.manifest.xml`	Yes
`--kernel` `kernel_id`	The ID of the kernel to select. Example: `--kernel aki-ba3adfd3`	No
`--ramdisk` `ramdisk_id`	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: `--ramdisk ari-badbad00`	No
`--mapping-file` `mapping_file`	Overrides the file containing kernel and RAM disk region mappings. Example: `--mapping-file eu-mappings`	No
`--mapping-url` `url`	Overrides the file containing kernel and RAM disk region mappings from the specified hostname portion of a URL. Example: `--mapping-url mysite.com/eu-mappings`	No
`--no-mapping`	Disables automatic mapping of kernels and RAM disks. Example: `--mapping-file mysite.com/eu-mappings`	No
`--region`	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: `--region eu-west-1`	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-1 

Backing up manifest...
Successfully migrated my-ami.manifest.xml It is now suitable for use in eu-west-1.

ec2-migrate-manifest