OnWorks favicon

migrate-ebs-imagep - Online in the Cloud

Run migrate-ebs-imagep in OnWorks free hosting provider over Ubuntu Online, Fedora Online, Windows online emulator or MAC OS online emulator

This is the command migrate-ebs-imagep that can be run in the OnWorks free hosting provider using one of our multiple free online workstations such as Ubuntu Online, Fedora Online, Windows online emulator or MAC OS online emulator



migrate-ebs-image - Copy an EBS-backed Amazon Image from one region to another


% migrate-ebs-image --from us-east-1 --to ap-southeast-1 ami-123456


This script copies an EBS-backed Unix/Linux/windows AMI located in the EC2 region
indicated by --from to the region indicated by --to. All associated volume snapshots,
including LVM and RAID volumes, are migrated as well.

If --from is omitted, then the source region is derived from the endpoint URL contained in
the EC2_URL environment variable. The --to option is required.

This script works with any EBS backed image, including Linux PVM, Linux HVM (cluster) and
Windows images. It will not work with any instance-store backed image. To migrate such
instances, please see one of the recipes listed online, for example:



Options can be abbreviated. For example, you can use -l for --list-regions and -b for

--from Region in which the AMI is currently located (e.g. "us-east-1")
--to Region to which the AMI is to be copied (e.g. "us-west-1") REQUIRED
--access_key EC2 access key
--secret_key EC2 secret key
Add additional block devices to the image.
--endpoint EC2 URL (defaults to http://ec2.amazonaws.com/)
--kernel Force assignment of kernel in destination image.
--ramdisk Force assignment of ramdisk in destination image.
--quiet Quench status messages
--list_regions List the EC2 regions

The --block-device-mapping (-b) option is used to add ephemeral storage to the destination
image. Amazon's API doesn't describe ephemeral volumes that are associated with images,
and so this information is not copied from the source to the destination image, requiring
you to add it back manually. The value of the argument is a block device mapping string in
the same format as described for the command line program ec2-register:

migrate-ebs-image -f us-east-1 -t ap-southeast-1 \
-b /dev/sdy=ephemeral0 \

Ordinarily the script attempts to guess the correct matching kernel and ramdisk for the
destination image based on approximate string matching. You can override these values by
manually specifying the kernel and/or ramdisk ID in the destination region. Note that no
checking is performed that the values you provide are correct.


The following environment variables are used if the corresponding options are not present:

EC2_ACCESS_KEY your access key
EC2_SECRET_KEY your secret key
EC2_URL the desired region endpoint


This script is part of the Perl VM::EC2 package. To install from the command line:

% perl -MCPAN -e 'install VM::EC2'
% migrate-ebs-image --from us-east-1 --to ap-southeast-1 ami-123456


This script launches two "m1.small" instances, one each in the source and destination
regions. It also creates transient volumes in both regions to hold the root volume and all
other EBS snapshots associated with the image. Running it will incur charges for instance
run time and data storage.

In addition, this script will transfer data from one region to another across the
internet, incurring internet data out fees on the source side, and internet data in fees
on the destination side. Volumes that contain a filesystem, such as ext4 or ntfs, are
copied from source to destination using rsync. Volumes that are part of a RAID or LVM
volume are copied at the block level using gzip and dd via the secure shell. In general,
rsync will be much faster and parsimonious of network bandwidth than block copying!

Use migrate-ebs-imagep online using onworks.net services

Free Servers & Workstations

Download Windows & Linux apps

  • 1
    Clover EFI bootloader
    Clover EFI bootloader
    Project has moved to
    Features:Boot macOS, Windows, and Linux
    in UEFI or legacy mode on Mac or PC with
    Download Clover EFI bootloader
  • 2
    Join us in Gitter!
    Enable the URPMS repository in your
    system -
    Download unitedrpms
  • 3
    Boost C++ Libraries
    Boost C++ Libraries
    Boost provides free portable
    peer-reviewed C++ libraries. The
    emphasis is on portable libraries which
    work well with the C++ Standard Library.
    See http://www.bo...
    Download Boost C++ Libraries
  • 4
    VirtualGL redirects 3D commands from a
    Unix/Linux OpenGL application onto a
    server-side GPU and converts the
    rendered 3D images into a video stream
    with which ...
    Download VirtualGL
  • 5
    Library to enable user space
    application programs to communicate with
    USB devices. Audience: Developers, End
    Users/Desktop. Programming Language: C.
    Download libusb
  • 6
    SWIG is a software development tool
    that connects programs written in C and
    C++ with a variety of high-level
    programming languages. SWIG is used with
    Download SWIG
  • More »

Linux commands