CloudFerry is a tool for resources and workloads migration between two OpenStack clouds.

• Grizzly
• Icehouse
• Juno

• Tenants
• User roles

• Networks
  • Private
  • Public
  • Shared
• Subnets
• Ports
• Floating IPs
• Security groups
• Routers
• LBaaS objects
• Quotas

• Images

• Volumes
• Quotas

• VMs
• VM's ephemeral storage
• Flavors
• User quotas
• Tenant quotas
• Key pairs

End-user documentation is available in docs folder, to compile in HTML run:

sphinx-build docs/ sphinx-build

• Connection to source and destination clouds through external (public) network from host with CloudFerry.
• Valid private ssh-key for both clouds which will be using by CloudFerry for data transferring.
• Admin keystone access (typically admin access point lives on 35357 port).
• sudo/root access on compute and controller nodes.
• Openstack MySQL DB write access.
• Credentials of global cloud admin for both clouds.
• All the Python requirements are listed in requirements.txt.

CloudFerry can be installed as docker container or it can be installed as a python package by pip

pip install git+git://github.com/MirantisWorkloadMobility/CloudFerry.git

docker build --build-arg cf_commit_or_branch=origin/master -t <username>/cf-in-docker .

docker run -it <username>/cf-in-docker

docker save --output=/path/to/save/CloudFerry.img <username>/cf-in-docker
docker load --input=/path/to/save/CloudFerry.img

CloudFerry tool is used by running python cloudferry executable from the command line.

All available commands can be viewed with:

# see list of available commands
cloudferry list

Sample config can be generated with

oslo-config-generator --namespace cloudferry

Configuration process is quite complex and mostly manual try-and-see-if-works process.

Make sure you have migrate_whole_cloud option in migrate section of config is set to True.

Use migrate command with config file specified:

cloudferry migrate <config file>

In order to migrate specific VMs, one should use filters. This is done through modifying filters file (configs/filter.yaml by default).

Edit configs/filter.yaml:

instances:
    id:
        - 7c53a6ab-0149-4232-80b3-b2d7ce02995a
        - f0fea76a-0a7d-4c25-ab9e-f048dbc7365d

Run migration as usual:

cloudferry migrate configuration.ini --debug

See QUICKSTART.md for the quickest way of running your first successful migration.