CLOUDSTACK-6114

Introduction

The follow project aims to simplify getting a full Apache Cloudstack environment running on your machine.

The included VagrantFile will give you:

• Management

  • NFS Server
  • MySQL Server
  • Router

• XenServer 6.2

Getting started

1. Ensure your system has git installed.

2. Clone the repository:

   git clone https://github.com/imduffy15/GSoC-2014.git

3. Download and Install VirtualBox

4. Download and install Vagrant

5. Ensure all Vagrant Plugins are installed:

   cd /path/to/cloned/repo
   bash scripts/vagrant_prep.sh vbox

Configure virtualbox

1. Open virtualbox and navigate to its preferences/settings window.

2. Click onto the network tab and then onto the host only network tab.

3. Configure your adapters as follows:

   For Basic Networking you only need:

   vboxnet0

   • IPv4 IP address of 192.168.56.1
   • Subnet of 255.255.255.0
   • DHCP server disabled

   For Advanced Networking you will need:

   vboxnet1

   • IPv4 IP address of 192.168.57.1
   • Subnet of 255.255.255.0
   • DHCP server disabled

   vboxnet2

   • IPv4 IP address of 192.168.58.1
   • Subnet of 255.255.255.0
   • DHCP server disabled

Start the vagrant boxes

Cloudstack With Basic Networking:

cd /path/to/GSoC-2014/repo/basic
vagrant up

Cloudstack With Advanced Networking:

cd /path/to/GSoC-2014/repo/advanced
vagrant up

*** Common issues: ***

• 'Cannot forward the specified ports on this VM': There could be MySQL or some other service running on the host OS causing vagrant to fail setting up local port forwarding.

Start Cloudstack

1. Clone the Cloudstack Repository:

   git clone https://github.com/apache/cloudstack.git
   

   *** Note: ***

   Personally I prefer to use the 4.3 codebase rather than master. If you wish to do the same:

   git reset --hard 0810029
   

2. Download vhd-util:

   cd /path/to/cloudstack/repo
   wget http://download.cloud.com.s3.amazonaws.com/tools/vhd-util -P scripts/vm/hypervisor/xenserver/
   chmod +x scripts/vm/hypervisor/xenserver/vhd-util

3. Compile Cloudstack:

   cd /path/to/cloudstack/repo
   mvn -P developer,systemvm clean install -DskipTests=true

4. Deploy Cloudstack Database:

   cd /path/to/cloudstack/repo
   mvn -P developer -pl developer,tools/devcloud -Ddeploydb

5. Start Cloudstack:

   cd /path/to/cloudstack/repo
   mvn -pl :cloud-client-ui jetty:run

6. Install Marvin:

   cd /path/to/cloudstack/repo
   pip install tools/marvin/dist/Marvin-0.1.0.tar.gz
   

FOR BASIC NETWORKING ONLY.

python -m marvin.deployDataCenter -i /path/to/GSoC-2014/repo/basic/basic.json 

FOR ADVANCED NETWORKING ONLY.

python -m marvin.deployDataCenter -i /path/to/GSoC-2014/repo/advanced/advanced.json