Changes

From Amahi Wiki
Jump to: navigation, search
1,346 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 1012.04 LTS (LucidPrecise 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 1012.04 LTS Desktop 32 bit and/or 64 bit with the recommended development packages installed.* An Amahi sandbox, running Ubuntu 1012.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 1012.04 LTS Desktop 32 bit.
# Install essential build toolchain.
## sudo apt-get update
## sudo apt-get install build-essential## sudo apt-get install devscripts## sudo apt-get install debhelper## sudo apt-get install fakeroot## sudo apt-get install lintian# Install git. # sudo aptitude install 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 1012.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. Follow these steps to build Ubuntu packages. Update Changelog 1. If you are repackaging for a newhttp# git clone git://bugsgit.amahi.org/issues/show/487 version Run dch -v with the version number currently in the makefile. Where you run the command depends on if you are changing hdactl or hda-platformamahi.git # cd deb/ubuntu/karmic/hdactl OR # cd deb/ubuntu/karmic/hda-platform  # dch -v <version number>  Add the changes that you made *Follow these steps to the system. If you are just updating for a new version state so.  If you are not changing the version number run dch -a. Where you run the command depends on if you are changing hdactl or hda-platform. # cd deb/ubuntu/karmic/hdactl OR # cd deb/ubuntu/karmic/hda-platform  # dch -a NOTE: If you are just building a .deb for your own testing you can just run make deb or continue to step 2.  2. To build hdactl package, change to 'platform/hdactl' directory and run 'make deb'Ubuntu packages # cd platform/hdactl # rm -rf hdactl-hup # rm -rf platform/hdactl/release # make deb   NOTE: The removing of hdactl-hup is only needed if it is present.  You will find the .deb file generated under platform/hdactl/release directory. NOTE: For ease of use use gdebi to install.  3. To build hda-platform package, change to 'platform/platform' directory and run 'make deb'.  # cd platform/platform # make deb
You will find # After downloading the source, navigate to the .deb file generated under platformdirectory (/trunk/platform/release).# Navigate to the package you wish to build (hdactl or platform).# (if appropriate) run "dch -i" to edit the changelog if you have made changes# run "make deb" to compile the packages directory# run "debuild" to create binary packages or "debuild -S" to create source packages.
=Architecture differences=
= Known Bugs =
*Debian control script for platform may be missing some dependencies. [http://bugs.amahi.org/issues/show/487 bug 487]*<s>Passenger does not install see Considerations [http://bugs.amahi.org/issues/show/483 bug 483]</s> This now works in Lucid fine*<s>HDACTL init scripts do not work Check out our project at [http://bugs.amahi.org/issuesprojects/show/484 bug 484ubuntu our bugtracker]</s> Some do work under Fedora formatting (interesting!). amahi-installer script needs work to run.
=Considerations=
*<s>Apache mod_passenger</s> This has been implemented in the installer since it is now in the default repositories.
12,424

edits