UbuntuPorting

This page is being edited actively and a lot of sections are missing currently

Current state

We just started porting Amahi to Ubuntu. The support is highly experimental. There are a few important things to be fixed before you can run it with minimal tweaking. Please don't try it on a production server yet. We are using Ubuntu 9.04 (jaunty) Desktop 32 bit for development. We strongly recommend you to use the same for experiments. You can download this version from here.

Requirements

You may want to have two different installations of Ubuntu.

• A development platform, running Ubuntu 9.04 Desktop 32 bit with the recommended development packages installed.
• An Amahi sandbox, running Ubuntu 9.04 Desktop 32 bit preferably under VirtualBox.

Please don't install the Amahi packages on the development platform as this might break your networking.

Setting up the development platform

1. Install Ubuntu 9.04 Desktop 32 bit.
2. Install essential build toolchain. # sudo aptitude install build-essential
3. Install git. # sudo aptitude install git-core
4. Read Ubuntu packaging guide to get an idea of other additional packages that you may want to install to create Ubuntu packages. I will list the packages to make your part easier at a later point.

Setting up the Amahi sandbox

1. Install Sun VirtualBox. # sudo aptitude install virtualbox-ose
2. Open VirtualBox and create a new guest platform for Ubuntu and install Ubuntu 9.04 Desktop 32 bit.
3. Install VirtualBox guest additions in your Amahi sandbox.
4. Setup VirtualBox folder sharing between your development platform and Amahi sandbox.

Amahi source code

On your development platform, download Amahi source code from our git repository. Follow these steps to build Ubuntu packages.

1. Set AMAHI_DEB_MAINTAINER environment variable. # export AMAHI_DEB_MAINTAINER="Full Name <you@domain.com>" You need to have a GnuPG key created for the e-mail address that you use in this field. It will be used to sign the package. You will be prompted for the passphrase when the package is built in the later stages.
2. To build hdactl package, change to 'platform/hdactl' directory and run 'make deb'. # cd platform/hdactl # make deb You will find the .deb file generated under platform/hdactl/release directory.
3. To build hda-platform package, change to 'platform/platform' directory and run 'make deb'. # cd platform/platform # make deb You will find the .deb file generated under platform/platform/release directory.

This page is being edited actively and a lot of sections are missing currently