Oddthesis-logo

Page: How to start?

There are two ways to start with JBoss Cloud. If you don't want to build images self, you can grab them from our server. But if you wish to have fresh images from our repository you can use metapliance (simple way) or prepare own build environment (long way) to build them.

Note that all appliances have default root password set to oddthesis.

Preparing own build environment

To build packages and appliances for JBoss Cloud you need Fedora 10 or 11. We'll add RHEL/CentOS support in the future.

Notice for Fedora 10 users

Fedora 11 users don't need to follow this step, if you're running Fedora 11 skip to Necessary software step.

To build working VMware appliances JBoss Cloud Support requires two packages from updates-testing repository. To install them, run this command:

yum --enablerepo=updates-testing update livecd-tools appliance-tools

It's a required step for own build environment and for metapliance too. Without this packages, VMware images won't work.

Necessary software

Before you create first package for JBoss Cloud you should install necessary software on your box. All you need is to execute this command:

yum -y install git gcc gcc-c++ make rubygem-rake wget rpmdevtools java-1.6.0-openjdk-devel autoconf expect

To be able to build appliances install also these packages:

yum -y install createrepo appliance-tools sudo

You should also install dependencies needed by spec files:

yum -y install libdnet-devel libdnet libicu-devel httpd-devel glib2-devel ruby-devel

For building some of the packages you'll need also Maven2 installed. It can be downloaded from Maven2 download site.

Amazon EC2 support

To build EC2 images, install also ec2-ami-tools package:

rpm -Uvh http://s3.amazonaws.com/ec2-downloads/ec2-ami-tools.noarch.rpm

Additional gems

A few gems are also required to install before you can use JBoss-Cloud:

gem install builder xml-simple mime-types

jboss-cloud

Next step is to download sources of jboss-cloud:

git clone git://github.com/bobmcwhirter/jboss-cloud.git jboss-cloud
cd jboss-cloud

After that you should initialize submodules for this project, just run:

git submodule init
git submodule update

Initialize also submodules in jboss-cloud-support module!

cd lib/jboss-cloud-support
git submodule init
git submodule update

Now you can list all available build options:

cd ../../
rake -T

Your system is now prepared for building JBoss Cloud bits. Build it. Use it. Be happy.

P.S. Make sure your user is in wheel group and you have line

%wheel  ALL=(ALL)       NOPASSWD: ALL

uncommented in /etc/sudoers file. To edit this file use visudo command!

If you have any feature requests or found a bug — feel free to file a new ticket!

Creative Commons License Copyright 2008. Odd Thesis by Bob McWhirter is licensed under a Creative Commons Attribution-Share Alike 3.0 United States License.