Skip to content

Latest commit

 

History

History
80 lines (67 loc) · 1.77 KB

QUICKSTART.md

File metadata and controls

80 lines (67 loc) · 1.77 KB

Quick Start Guide

  1. Install CloudFerry by pip

    pip install CloudFerry
    
  2. Initialize CloudFerry environment

    mkdir my_migration
    cd my_migration
    cloudferry init
    
  3. Change config files according your clouds

  4. Migrate it

    cloudferry migrate configs/config.ini
    

Developer Quick Start Guide

  1. Get CloudFerry sources

    git clone https://github.com/MirantisWorkloadMobility/CloudFerry.git
    cd CloudFerry
    git fetch
    # The latest code is in devel branch
    git checkout -b devel origin/devel
    
  2. Install vagrant (devlab requires vagrant version >= 1.6)

    wget https://dl.bintray.com/mitchellh/vagrant/vagrant_1.7.4_x86_64.deb
    sudo dpkg -i vagrant_1.7.4_x86_64.deb
    
  3. Install virtualbox hypervisor

    sudo apt-get install virtualbox -y
    
  4. Setup development environment

    cd CloudFerry/devlab
    vagrant up grizzly icehouse nfs
    
  5. Setup virtual environment for cloudferry

    apt-get install python-dev libssl-dev python-virtualenv libffi-dev -y
    cd CloudFerry
    virtualenv .venv
    source .venv/bin/activate
    pip install pip==6.1.1
    pip install --allow-all-external -r requirements.txt
    pip install -r test-requirements.txt
    
  6. Generate cloudferry config for development lab

    cd CloudFerry
    ./devlab/provision/generate_config.sh --cloudferry-path $(pwd)
    
  7. Generate load on source VM (this will create a number of VMs on grizzly node)

    cd CloudFerry/devlab/tests
    source ./openrc.example
    python ./generate_load.py --clean
    python ./generate_load.py
    
  8. Run migration

    cd CloudFerry
    source .venv/bin/activate
    fab migrate:configuration.ini,debug=True