Page History

...

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

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

...

Install your required development tools (if not already available)

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/

...

Download the source build

...

Note
Replace $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/^{Image Added}

Code Block

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:

Code Block

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

...

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

...

Compile

cd apache-cloudstack-$version-incubating-src

...

mvn -P

...

 deps
ant clean-all build-all

...

Deploy into the DevCloud VM

ant rdeploy

...

ant rdeploydb

...

Start CloudStack management server

ant rdebug

...

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 "Infrastructure", click the "View All" button in the "Zones" display box, click "add zone"
• select Select "basic zone" during the add zone wizard.
• type Type name "test cloud", dns1 "8.8.8.8", internal dns1 "10.0.2.3", hypervisor "Xenserver", select "local storage enabled" (Say Yes if prompted to agree), then click next.
• skip Skip "physical network setup" page
• in In "pod" page, type: pod name: 'test pod',   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 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 In "cluster" page, type cluster name: "test cluster"in
• In "host " page,   host name: 10.0.2.15, user name: root, password: password
• in In "secondary storage" page,   server: 10.0.2.15, path: /opt/storage/secondary
• In "zone creation comple", select "yes" to enable zone.

...

Wait for secondary storage VM coming up.

...

This may take a bit...

Add a 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

Other testing

At this point, it would be good to check that you can access the console of the newly created instance, followed by destroying the instance.

End!

If we made it this far, the release has at least been reasonably "smoke tested".