CloudStack 4.0 test procedure

Test with source code release

This is test procedure for Apache CloudStack 4.0 source release. Everyone is welcome to have a test with the forthcoming 4.0 release.

To setup an environment for CloudStack, usually it will take a while, e.g install a hypervisor host, install Mysql server etc. Here we'll use DevCloud(http://wiki.cloudstack.org/display/COMM/DevCloud) to simplify the test procedure. 

Setup environment

0. Following steps are tested on Mint 13, should work on ubuntu 12.04.

1. Install devcloud

• Install VirtualBox(https://www.virtualbox.org/wiki/Downloads) on your machine.
  • Note: If you are on Mac OS X(10.6 or below), must enable 64bit(http://support.apple.com/kb/HT3773)
• Download DevCloud image from http://download.cloud.com/templates/devcloud/DevCloud.ova into your machine.
• Import DevCloud.ova into VirtualBox:
  • Open VirtualBox, File->Import Appliance->choose DevCloud.ova
  • Use the default configuration
  • NOTE: please do NOT select "re-initialize the MAC address of all network cards"
• Start devcloud VM
• For more information about how to install devcloud, please refer to http://wiki.cloudstack.org/display/COMM/DevCloud

2. Install development tools

• sudo aptitude install openjdk-6-jdk ant
• sudo apt-get update 
• sudo apt-get install python-software-properties
• sudo add-apt-repository ppa:natecarlson/maven3
• sudo aptitude update
• sudo aptitude install maven3
• install jsch** wget http://downloads.sourceforge.net/project/jsch/jsch.jar/0.1.48/jsch-0.1.48.jar
  • sudo cp jsch-0.1.48.jar /usr/share/ant/lib/

3. Download the source build (replacing $version with the correct detailed version string in any commands below)

• Download latest source code release from http://people.apache.org/~chipchilders/cloudstack/4.0/

  mkdir -p ~/cloudstack; cd ~/cloudstack
  wget http://people.apache.org/~chipchilders/cloudstack/4.0/KEYS
  wget http://people.apache.org/~chipchilders/cloudstack/4.0/apache-cloudstack-$version-incubating-src.zip
  wget http://people.apache.org/~chipchilders/cloudstack/4.0/apache-cloudstack-$version-incubating-src.zip.asc
  wget http://people.apache.org/~chipchilders/cloudstack/4.0/apache-cloudstack-$version-incubating-src.zip.md5
  wget http://people.apache.org/~chipchilders/cloudstack/4.0/apache-cloudstack-$version-incubating-src.zip.sha
  wget http://people.apache.org/~chipchilders/cloudstack/4.0/apache-cloudstack-$version-incubating-src.tar.gz
  wget http://people.apache.org/~chipchilders/cloudstack/4.0/apache-cloudstack-$version-incubating-src.tar.gz.asc
  wget http://people.apache.org/~chipchilders/cloudstack/4.0/apache-cloudstack-$version-incubating-src.tar.gz.md5
  wget http://people.apache.org/~chipchilders/cloudstack/4.0/apache-cloudstack-$version-incubating-src.tar.gz.sha
  

• install gpg (if needed): sudo apt-get install gpg
• import keys:  gpg --recv-keys CC56CEA8 DB3ECA42 2908DED2 6FE50F1C
• verify signatures and hash files:

gpg --verify apache-cloudstack-$version-incubating-src.tar.gz.asc
gpg --verify apache-cloudstack-$version-incubating-src.zip.asc
gpg --print-md MD5 apache-cloudstack-$version-incubating-src.tar.gz | diff - apache-cloudstack-$version-incubating-src.tar.gz.md5
gpg --print-md MD5 apache-cloudstack-$version-incubating-src.tar.gz | diff - apache-cloudstack-$version-incubating-src.tar.gz.md5
gpg --print-md SHA512 apache-cloudstack-$version-incubating-src.tar.gz | diff - apache-cloudstack-$version-incubating-src.tar.gz.sha
gpg --print-md SHA512 apache-cloudstack-$version-incubating-src.zip | diff - apache-cloudstack-$version-incubating-src.zip.sha

4. Extract the source code and verify the contents:

unzip apache-cloudstack-$version-incubating-src.zip
OR
tar xvfz apache-cloudstack-$version-incubating-src.tar.gz

5. Compile

• cd apache-cloudstack-$version-incubating-src
• mvn -P deps** NOTE: mvn may require adding it to the path like: export PATH=$PATH:/usr/share/maven3/bin
• ant clean-all build-all

6. Deploy into DevCloud

• ant rdeploy
• ant rdeploydb

7. Start CloudStack management server

• ant rdebug

8. Configure CloudStack management server

• Access web UI: http://localhost:8080/client
• Login with admin/password
• Choose "I have used cloudstack before, skip this guide"
• Click "Infrastrucre", click "zone", "add zone"
• select "basic zone" during the add zone wizard.
• type name "test cloud", dns1 "8.8.8.8", internal dns1 "10.0.2.3", hypervisor "Xenserver", select "local storage enabled", then click next.
• skip "physical network setup" page
• in "pod" page, type: reserved system gateway: 10.0.2.2, reserved system mask: 255.255.255.0, start reserved system ip: 10.0.2.200, end reserved system ip: 10.0.2.220
• in "guest traffic" page, guest gateway: 10.0.2.2, netmask: 255.255.255.0, guest start ip: 10.0.2.100, guest end ip: 10.0.2.199
• in "cluster" page, type cluster name: "test cloud"
• in "host " page, host name: 10.0.2.15, user name: root, password: password
• in "secondary storage" page, server: 10.0.2.15, path: /opt/storage/secondary
• In "zone creation comple", select "yes" to enable zone.

9. Wait for secondary storage VM coming up.
10. Add new instance

• In the first step of "Add instance " wizard ,  select template,
• In step 2, select "tiny Linux"
• In step 3, select "tinyOffering"
• In step 4, select "No thanks"
• Skip step 5 and 6.
• Launch VM