Difference between revisions of "Debian"

From Amahi Wiki
Jump to: navigation, search
m
 
(17 intermediate revisions by 2 users not shown)
Line 1: Line 1:
 
'''This page is being edited actively and a lot of sections are missing currently; feel free to help improving it.'''
 
'''This page is being edited actively and a lot of sections are missing currently; feel free to help improving it.'''
 +
 +
For ubunto please refer to the Ubuntu page.
  
 
=Current state=
 
=Current state=
Line 15: Line 17:
 
Feel free to add issues here. If you add an issue an email to the amahi developers list with a more detailed description and/or a bug report in our bugzilla is also greatly appreciated.
 
Feel free to add issues here. If you add an issue an email to the amahi developers list with a more detailed description and/or a bug report in our bugzilla is also greatly appreciated.
  
* The default debian browser (konquerer if I recall correctly) will not indicate progress while installing
+
* The default debian browser (ephipany if I recall correctly) will not indicate progress while installing
 
* Apache status is not displayed correctly in servers tab
 
* Apache status is not displayed correctly in servers tab
 
* only a few packages are available (if any) I tested phpsysinfo, hello-world and wakkiwiki. Not sure what is available to others and what has been assigned to me as tester.
 
* only a few packages are available (if any) I tested phpsysinfo, hello-world and wakkiwiki. Not sure what is available to others and what has been assigned to me as tester.
  
 
=Requirements=
 
=Requirements=
* A system to install things on. This system must support debian and have the needed resources. I've assumed the system has a network connection, but it will undoubtly be possible to get things working with an installation disk and some data transfer with USB disks.
+
* A system to install things on. This system must support debian 6.0.4 and have the needed resources. I've assumed the system has a network connection, but it will undoubtly be possible to get things working with an installation disk and some data transfer with USB disks.
 
* Some experience in installing things. This also depends on the way you want to install things (see below)
 
* Some experience in installing things. This also depends on the way you want to install things (see below)
 
* Ambition to help improving things and a lot of tolerance against problems; The current version is far from finished.
 
* Ambition to help improving things and a lot of tolerance against problems; The current version is far from finished.
Line 29: Line 31:
 
Feel free to add your platform.
 
Feel free to add your platform.
  
* OpenRD Client (primary development platform, armv5tel)
+
* x86 virtual machine under VirtualBox
 +
 
 +
We are working on getting this to run under arm as well.
 +
E.g. on:
 +
 
 +
* OpenRD Client (primary development platform, armv5tel)  
 
* SheevaPlug (same SoC as OpenRD Client, but more readily available)
 
* SheevaPlug (same SoC as OpenRD Client, but more readily available)
* x86 virtual machine under Xen.
+
* Raspberry PI
 +
Check back later if you are interested in one of these platforms
  
 
=Installation=
 
=Installation=
Line 43: Line 51:
 
* if you have a low threshold against bugs
 
* if you have a low threshold against bugs
  
Most of this was tested on SheevaPlug and OpenRD client. Some tests have also been done on an x86 virtual machine under Xen.
+
Most of this was tested on debian 6.0.4 on a 386 VM (using virtualbox).
  
 
==Installation using an image file==
 
==Installation using an image file==
Line 51: Line 59:
 
==Installation using prebuilt packages==
 
==Installation using prebuilt packages==
  
Currently this is only supported on arm little endian (armel) hardware and only tested on armv5tel.
+
<b>Currently this is only supported on 32bit. </b>
 +
 
 +
You need to install Debian on your platform. No special packages are needed. E.g. when installing on a system without a display there is no need to install a graphical desktop.
 +
 
 +
For Debian on PC I used this guide: http://www.debian.org/releases/stable/i386/ and used this iso: http://cdimage.debian.org/debian-cd/6.0.4/i386/iso-cd/debian-6.0.4-i386-netinst.iso
  
You need to install debian on your platform. No special packages are needed. E.g. when installing on a system without a display there is no need to install a graphical desktop.
+
For SheevaPlug I used this guide: http://www.cyrius.com/debian/kirkwood/sheevaplug/install.html
  
 
There are two things to keep in mind:
 
There are two things to keep in mind:
When being asked for a mysql root password, leave the password empty (actually you might get this question more than once).  
+
When being asked for a mysql root password, leave the password empty (actually you will get this question more than once). <br>
Also I opted for automatically start hddtemp.
+
For any question you get just hit return.
 +
 
 +
Then perform the following steps '''while logged in as root or with the sudo command''':
 +
* wget http://amahi.99k.org/debian.install
 +
* sh debian.install yourinstallcode
 +
Where yourinstallcode is an install code you generated on www.amahi.org
  
Then perform the following steps:
+
Note, while installing you will face a long wait after the message "install code looks good" and after "initializing plugin factory"
* get repo.tar.gz: ''' wget amahi.99k.org/repo.tar.gz''' (location will change)
+
 
* untar it: '''tar xvf repo.tar.gz''''
+
When done, reboot the system and open a browser to http://hda
* modify /etc/apt/sources.list. Add a line like: '''echo deb file:/root ./ >> /etc/apt/sources.list'''. The dir after file: should be the place where you unpacked the tarball (or if you generated the packages yourself where you issued the dpkg-scanpackages command)
+
The system will ask you to log in, use the user that you created while installing debian. Note that after log in amahi will force you to change the password of that user to a different (!) password.
* '''apt-get update'''
+
 
* '''apt-get install hda-platform'''; say y to the questions. Note that this may take quite a while.
+
Note: on arm it might be that mysql initialisation is not completely done when hdactl is started. You can see that if ps ax | grep hdactl only gives one hdactl process and your grep task. In that case kill the hdactl task and start hdactl manually (with /etc/init.d/hdactl start)
* when done, reboot the system
 
* after rebooting open a browser (this may be on a different system) and go to http://yourmachine-ip:2000 where yourmachine-ip is the ip address of your amahi debian system. It is recommended to use firefox as everything is tested with it. Konquerer does not seem to update progress on the installation
 
* insert your installation code and hit start. This will take a substantial time (especially when at 9% it says installing packages.
 
* when done without error, reboot.
 
* next refresh the ip address of your client and (so your hda is added to your /etc/resolv.conf) and browse to http://hda/setup to set up your hda.
 
  
 
==Installation using the sources==
 
==Installation using the sources==
 +
 +
Note: the procedure below describes how to generate the packages from the sources. This procedure requires the amahi git. However at the moment there are several patches pending to be committed. While generating will work, there are probably some issues present that are fixed in the binary version.
  
 
* Install debian. If you install mysql do not give it a root password.
 
* Install debian. If you install mysql do not give it a root password.
 
* on this system perform the following steps:
 
* on this system perform the following steps:
* install the needed development packages '''apt-get install build-essential devscripts debhelper fakeroot lintian git-core'''
+
* git clone git://git.amahi.org/amahi.git  
* clone the amahi git repository: '''git clone git://git.amahi.org/amahi.git
+
* wget http://amahi.99k.org/buildit
'''
+
* sh buildit
* '''cd amahi/platform/hdactl'''
+
Note that the script now requires root access
* get the debian specifc hda-install: '''wget http://amahi.99k.org/hda-install'' (this one will move to a location on amahi.org)
+
 
* check debian/hdactl.hdactl.init; if it contains a string '''mysqld''' remove the trailing '''d'''
+
You have now build your packages. you now can install the packages by performing the following steps:
* build the hdactl package by typing '''make deb'''
+
* echo "deb file:/root/amahirepo ./" >>/etc/apt/sources.list
* build the hda-platform package by typing '''cd ../platform; make deb'''
+
* apt-get update
* create a local package feed by doing the following:
+
* apt-get --force-yes -y install hda-platform
* '''cd ../..; mkdir repo; cd repo'''
+
* hda-install your-install-code
* '''cp ../platform/*/release/*.deb .''' (don't forget the dot at the end!)
+
where your-install-code is the code you obtain from www.amahi;org
* create the Packages file: '''dpkg-scanpackages -m . /dev/null > Packages'''
 
* and compress it: '''gzip Packages'''
 
  
You have now build your packages. You can install things like explained in the previous section, skipping the first two steps.
+
Note that the echo line modifying sources.list only needs to do once. Also you need to adapt the path to the place where your repo dir is. If you ran as root it will probably be the location I gave.

Latest revision as of 08:56, 11 March 2012

This page is being edited actively and a lot of sections are missing currently; feel free to help improving it.

For ubunto please refer to the Ubuntu page.

Current state

Amahi can be installed and made running on Debian. However the code is still not very mature and not many applications have been tested. Also it is not as smooth to install things as it is with the Fedora version.

This page describes how to get things working. Note that due to the immature state of the code installing it is mainly interested for people who want to get a feeling of it, help in testing and resolving issues.

PS: this page was started by a non-native English speaker. Feel free to clean up the language or improve and clarify instructions.

Known Issues

Feel free to add issues here. If you add an issue an email to the amahi developers list with a more detailed description and/or a bug report in our bugzilla is also greatly appreciated.

  • The default debian browser (ephipany if I recall correctly) will not indicate progress while installing
  • Apache status is not displayed correctly in servers tab
  • only a few packages are available (if any) I tested phpsysinfo, hello-world and wakkiwiki. Not sure what is available to others and what has been assigned to me as tester.

Requirements

  • A system to install things on. This system must support debian 6.0.4 and have the needed resources. I've assumed the system has a network connection, but it will undoubtly be possible to get things working with an installation disk and some data transfer with USB disks.
  • Some experience in installing things. This also depends on the way you want to install things (see below)
  • Ambition to help improving things and a lot of tolerance against problems; The current version is far from finished.

Tested platforms

This section lists the platforms on which this was tested. Feel free to add your platform.

  • x86 virtual machine under VirtualBox

We are working on getting this to run under arm as well. E.g. on:

  • OpenRD Client (primary development platform, armv5tel)
  • SheevaPlug (same SoC as OpenRD Client, but more readily available)
  • Raspberry PI

Check back later if you are interested in one of these platforms

Installation

Currenty there are three different ways to install the system. They are listed in order of difficulty, simplest first, most difficult but most flexible last. Note that the last two ways assume that you install Debian yourself.

Please note that is is far from complete so do not attempt to install this:

  • on systems with other valuable data
  • if you feel uncomfortable with Linux
  • if you have a low threshold against bugs

Most of this was tested on debian 6.0.4 on a 386 VM (using virtualbox).

Installation using an image file

to be written

Installation using prebuilt packages

Currently this is only supported on 32bit.

You need to install Debian on your platform. No special packages are needed. E.g. when installing on a system without a display there is no need to install a graphical desktop.

For Debian on PC I used this guide: http://www.debian.org/releases/stable/i386/ and used this iso: http://cdimage.debian.org/debian-cd/6.0.4/i386/iso-cd/debian-6.0.4-i386-netinst.iso

For SheevaPlug I used this guide: http://www.cyrius.com/debian/kirkwood/sheevaplug/install.html

There are two things to keep in mind: When being asked for a mysql root password, leave the password empty (actually you will get this question more than once).
For any question you get just hit return.

Then perform the following steps while logged in as root or with the sudo command:

Where yourinstallcode is an install code you generated on www.amahi.org

Note, while installing you will face a long wait after the message "install code looks good" and after "initializing plugin factory"

When done, reboot the system and open a browser to http://hda The system will ask you to log in, use the user that you created while installing debian. Note that after log in amahi will force you to change the password of that user to a different (!) password.

Note: on arm it might be that mysql initialisation is not completely done when hdactl is started. You can see that if ps ax | grep hdactl only gives one hdactl process and your grep task. In that case kill the hdactl task and start hdactl manually (with /etc/init.d/hdactl start)

Installation using the sources

Note: the procedure below describes how to generate the packages from the sources. This procedure requires the amahi git. However at the moment there are several patches pending to be committed. While generating will work, there are probably some issues present that are fixed in the binary version.

Note that the script now requires root access

You have now build your packages. you now can install the packages by performing the following steps:

  • echo "deb file:/root/amahirepo ./" >>/etc/apt/sources.list
  • apt-get update
  • apt-get --force-yes -y install hda-platform
  • hda-install your-install-code

where your-install-code is the code you obtain from www.amahi;org

Note that the echo line modifying sources.list only needs to do once. Also you need to adapt the path to the place where your repo dir is. If you ran as root it will probably be the location I gave.