Packaging/Ubuntu

Ubuntu is the reference platform for OpenStack. We follow the Ubuntu release cycle very closely, and do most of our QA on Ubuntu.

If you want to run OpenStack on Ubuntu, there are a few options, depending on your stability requirements and which version of Ubuntu you're running.

Ubuntu version	Only what is in Ubuntu	Only stable releases
10.04 LTS (Lucid)	N/A	Release PPA
10.10 (Maverick)	Pre-Austin snapshot	Release PPA
11.04 (Natty)	Frequent snapshots.< >Cactus expected in final release	Release PPA

Trunk PPA

A PPA<<FootNote(Personal Package Archive: an extra apt repository you can add to your sources.list to get access to software not in Ubuntu.)>> where we will upload a new version for every single commit on trunk.

Information and instructions for use can be found on Launchpad for Nova, and similarly for Swift and Glance.

The packages are built by grabbing the latest tarball from http://nova.openstack.org/tarballs/ and adding lp:~openstack-ubuntu-packagers/ubuntu/natty/nova/ubuntu on top of it, and adding a changelog entry.

Release PPA

Information and instructions for use can be found on Launchpad for Nova, and similarly for Swift and Glance..

A PPA<<FootNote(Personal Package Archive: an extra apt repository you can add to your sources.list to get access to software not in Ubuntu.)>> where we will upload only final releases.

Generating packages manually

Prerequisites

You'll need to install some packages on the build machine. Some of them are in the nova-core PPA, so add it as a repository:

sudo add-apt-repository ppa:nova-core/ppa
sudo apt-get update

During the build process, you will be informed about which packages are missing from your system, but there are some additional packages that are required for building the documentation:

sudo apt-get install python-greenlet python-rrdtool

You'll need Sphinx 1.0 or greater for doing the build or the documentation generation will fail and the build will abort. You can check what version of Sphinx is being used by your version of Python by doing:

python -c "import sphinx; print sphinx.__version__"

Generating the packages

Combine the main nova code with the packaging scripts:

bzr export nova lp:nova
bzr export nova-packaging lp:~openstack-ubuntu-packagers/ubuntu/natty/nova/ubuntu
mv nova-packaging/debian nova

Edit the changelog entry. The following commands will specify a Lucid package with version "2011.1-0ubuntu2-local1" and a changelog entry "Local build for internal testing"

cd nova
dch -v 2011.1-0ubuntu2-local1 -D lucid "Local build for internal testing"

Edit `bin/nova-manage` to specify the default location of the flagfile:

PATCH='--- nova-manage 2011-02-09 12:08:18.000000000 -0500
+++ nova-manage-fixed   2011-02-09 12:14:03.000000000 -0500
@@ -656,7 +656,7 @@
 
 def main():
     """Parse options and call the appropriate class/method."""
-    utils.default_flagfile()
+    utils.default_flagfile("/etc/nova/nova.conf")
     argv = FLAGS(sys.argv)
 
     script_name = argv.pop(0)
'

echo "$PATCH" | patch bin/nova-manage

Generate the packages:

./builddeb.sh

The packages will appear in the parent of the nova directory.