Changes

From Amahi Wiki
Jump to: navigation, search
760 bytes removed ,  03:26, 21 July 2012
no edit summary
'''This page is being edited actively and a lot of sections are missing currentlyno longer accurate. Please use guidance located [http://docs.amahi.org here]'''
=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 912.04 LTS (jauntyPrecise Pangolin) Desktop 32 bit for development. We strongly recommend you to use the same for experiments. You can download this version from [http://www.ubuntu.com/getubuntu/download here].
=Requirements=
You may want to have two different installations of Ubuntu.
* A development platform, running Ubuntu 912.04 LTS Desktop 32 bit and/or 64 bit with the recommended development packages installed.* An Amahi sandbox, running Ubuntu 912.04 LTS Desktop 32 bit '''preferably''' under [http://www.virtualbox.org/ 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 912.04 LTS Desktop 32 bit.
# Install essential build toolchain.
## sudo aptitude install build-essential## sudo apt-get install devscriptsupdate## sudo apt-get install build-essential devscripts debhelper# Install git. # sudo aptitude install fakeroot lintian reprepro 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.
=Setting up the Amahi sandbox=
# Install [http://www.virtualbox.org/ Sun VirtualBox]. # sudo aptitude install virtualbox-ose
# Open VirtualBox and create a new guest platform for Ubuntu and install Ubuntu 912.04 LTS Desktop 32 bit.# Install VirtualBox guest additions in your Amahi sandbox.# sudo apt-get install virtualbox-ose-guest-utils (do this inside your virtual machine!)
# Setup VirtualBox folder sharing between your development platform and Amahi sandbox.
 
Of course you can also download virtualbox from the virtualbox website and install the guest additions from the virtual CD with these additions (select install guest additions from the menu to mount the CD).
=Amahi source code=
On your development platform, download Amahi source code from our git repository. # git clone git://git.amahi.org/amahi.git*Follow these steps to build Ubuntu packages.
# Set AMAHI_DEB_MAINTAINER environment variableAfter downloading the source, navigate to the platform directory (/trunk/platform). # export AMAHI_DEB_MAINTAINER="Full Name <you@domain.com>" You need Navigate to have a GnuPG key created for the e-mail address that package you use in this field. It will be used wish 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 'or platform/hdactl' directory and run 'make deb'). # cd platform/hdactl (if appropriate) run "dch -i" to edit the changelog if you have made changes# run "make deb You will find " to compile the .deb file generated under platform/hdactl/release directory.packages# To build hdarun "debuild" to create binary packages or "debuild -platform package, change S" to 'platform/platform' directory and run 'make deb'. # cd platform/platform # make deb You will find the .deb file generated under platform/platform/release directorycreate source packages.
=Architecture differences=
 * Apache runs as 'www-data' instead of 'apache'No /etc/sysconfig folder. Instead, configuration is scattered all over the place.** Fix - Edit /var/hda/platform/html/script/install-app Requires copying the following: uid = Etc.getpwnamfunctions library required by several shellscripts ("apache"but works fine).uid
=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.
= Known Bugs =
Check out our project at [http://bugs.amahi.org/projects/show/ubuntu our bugtracker]
=Considerations=
Instead of using FastCGI, perhaps package Amahi with capability to use Ubuntu'*<s native phusion passenger (aka mod_rails) package. Add the following line to >Apache mod_passenger</s> This has been implemented in the Third Party Software Sources:  deb http://apt.brightbox.net hardy main (The simplest way to do that installer since it is to create a file now in /etc/apt/sources.list.d/ containing the deb instruction, and then run 'apt-get update')default repositoriesOnce you've done this then you can install Phusion Passenger by running:  apt-get install libapache2-mod-passenger
'''This page is being edited actively and a lot of sections are missing currently'''
12,424

edits