Difference between revisions of "UbuntuPorting"
From Amahi Wiki
PraveenKumar (talk | contribs) |
Andypflueger (talk | contribs) |
||
| Line 12: | Line 12: | ||
=Setting up the development platform= | =Setting up the development platform= | ||
# Install Ubuntu 9.04 Desktop 32 bit. | # Install Ubuntu 9.04 Desktop 32 bit. | ||
| − | # Install essential build toolchain. # sudo aptitude install build-essential | + | # Install essential build toolchain. |
| + | ## sudo aptitude install build-essential | ||
| + | ## sudo apt-get install devscripts | ||
| + | ## sudo apt-get install debhelper | ||
# Install git. # sudo aptitude install git-core | # Install git. # sudo aptitude install git-core | ||
# Read [https://wiki.ubuntu.com/PackagingGuide/Complete 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. | # Read [https://wiki.ubuntu.com/PackagingGuide/Complete 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. | ||
| Line 28: | Line 31: | ||
# 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. | # 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. | ||
# 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. | # 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. | ||
| + | |||
| + | =Post install gotchas (asp's notes)= | ||
| + | After building the deb packages above and installing using the Ubuntu pkg installer, was able to then startup hdactl (using '/etc/init.d/hdactl start') and then http;//hda worked. | ||
| + | |||
| + | # Had to install the pluginfactory gem by running 'gem install -no-rdoc -no-ri pluginfactory' | ||
| + | # Noticed that Apache runs as 'www-data' on Ubuntu instead of 'apache' user like on Fedora. Amahi-app-installer.log indicated 'apache' user was not found after attempting to install an app on Application tab of platform. | ||
'''This page is being edited actively and a lot of sections are missing currently''' | '''This page is being edited actively and a lot of sections are missing currently''' | ||
Revision as of 01:51, 27 August 2009
This page is being edited actively and a lot of sections are missing currently
Contents
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
- Install Ubuntu 9.04 Desktop 32 bit.
- Install essential build toolchain.
- sudo aptitude install build-essential
- sudo apt-get install devscripts
- sudo apt-get install debhelper
- Install git. # sudo aptitude install git-core
- 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
- Install Sun VirtualBox. # sudo aptitude install virtualbox-ose
- Open VirtualBox and create a new guest platform for Ubuntu and install Ubuntu 9.04 Desktop 32 bit.
- Install VirtualBox guest additions in your Amahi sandbox.
- 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.
- 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.
- 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.
- 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.
Post install gotchas (asp's notes)
After building the deb packages above and installing using the Ubuntu pkg installer, was able to then startup hdactl (using '/etc/init.d/hdactl start') and then http;//hda worked.
- Had to install the pluginfactory gem by running 'gem install -no-rdoc -no-ri pluginfactory'
- Noticed that Apache runs as 'www-data' on Ubuntu instead of 'apache' user like on Fedora. Amahi-app-installer.log indicated 'apache' user was not found after attempting to install an app on Application tab of platform.
This page is being edited actively and a lot of sections are missing currently
