Trusted, Bureaucrats, Administrators
12,424
edits
Changes
From Amahi Wiki
→Known Issues
{{MessageBox|backgroundcolor = #FBB|
image =Warning.png|
heading =WARNING|
message = '''DEPRECATED'''<br>This is no longer supported.}}
Amahi "Plug Edition" — How to run Amahi on your Plug Computer!
For discussions see the [https://forums.amahi.org/viewforum.php?f=40 Amahi Plug Computer Forum].
= Supported devices =
* [http://www.ionicsplug.com/products.html Ionics Plugs]
* [http://www.globalscaletechnologies.com/t-guruplugdetails.aspx GuruPlug]
* [http://en.wikipedia.org/wiki/SheevaPlug SheevaPlug]
* [http://www.globalscaletechnologies.com/t-guruplugdetailsopenrdcdetails.aspx GuruPlugOpenRD Client]* [http://www.globalscaletechnologies.com/t-openrdbdetails.aspx OpenRD Base] (unverified) Supported but not recommended, due to compatibility or speed:
* [http://www.tonidoplug.com/ TonidoPlug]
* [http://www.plugapps.com/index.php5?title=Getting_Started:_Pogoplug Rooted] [http://www.pogoplug.com/ Pogoplug]— (256 RAM)* [http://www.cs.cmu.edu/~ecc/dockstar-howto.html Rooted] [http://www.seagate.com/www/en-us/products/network_storage/freeagent_dockstar/ Seagate DockStar]— (128MB RAM - a little slow)
* Any other device based on the [http://plugcomputer.org Marvell Plug Computer]
Known Issues:
* [http://www.globalscaletechnologies.com/p-35-openrd-ultimate.aspx OpenRD Ultimate] will need some tweaking as the current kernel does not support OpenRD Ultimate yet.
* eSata [http://en.wikipedia.org/wiki/SheevaPlug SheevaPlug] will need an updated kernel to support the eSata port ([http://bugs.amahi.org/issues/show/850 #850])
= Requirements =
You'll need:
* A Linux Computer* A storage device, of 2GB or more, that your plug computer can boot from.* The latest Amahi ''"rootfs'' " from the [http://dl.amahi.org/marvell/ - Amahi4Plug repo] look for the latest file named '''amahi-marvell-*.tar.bz2'''* The script to copy the above ''rootfs'' into your storage device: [http://dl.amahi.org/marvell/create-cleanamahi-f12-plug-disk.shThis script] to copy the above ''rootfs'' into your storage device. Important: you <u>will</u> have to modify this script to suit your device, as it obliterates the content of it
= Known issues Quick Overview = Because of the headless nature of the Plug devices, there are some more steps than the typical Amahi release to make things work smoothly.
; '''Step 1:3''' Download : Install Amahi, by loading <code>http://plug_ip:2000</code> and extract entering the install code you got when you [httphttps://dlwww.amahi.org/marvell/ user created your Amahi ''rootfs'' imageprofile] into an empty USB hard drive, USB flash drive, or SD card (depending on what your device supports), formatted as ext3.
= Detailed Installation Instructions =
Connect your boot device (USB hard drive, USB flash drive, or SD card) into a working Linux machine (you can use your plug computer!)
{| cellpadding="7"
! 2GB Flash Drive<br/>or SD Card
! 4GB Flash Drive<br/>or SD Card
! 8GB Flash Drive<br/>or SD Card
! 16GB Flash Drive<br/>or SD Card
|-
|2GB, unformatted
|4GB, unformatted
|512MB, Linux Swap<br/>7.5GB, unformatted
|1GB, Linux Swap<br/>15GB, unformatted
Edit the ''create-amahi-f12-plug-disk.sh'' script:
* Change the first line, the one that says '''partition="..."''' to point to the partition you want to use to boot your plug computer.<br/>If you're not sure, '''ls -l /dev/disk/by-id/''' and see if you can find it there.
* Change the second line '''swap="..."''' to point to the partition you want to use for swap. If you do not have a swap partition just set this to a partition that does not exist.* Change the third line, if needed. It should contain the name of the Amahi ''rootfs'' file you downloaded. Example: '''rootfs="amahi-marvell-1.0.9.tar.bz2"'''
* Comment (add a # character at the beginning of) the two following lines, the ones that say '''echo "Please edit this script...''' and '''exit 0'''.
<font color="red" div style="fontborder: 1px solid #B66; padding: .5em 1em; color: #000; background-weightcolor: bold#FEE; margin: 3px 3px 1em 3px;">Big Warning'''BIG WARNING! Putting the wrong partitions in this script will completely erase those partitions! Be careful what partitions you target!</fontdiv> Run the ''create-amahi-f12-plug-disk.sh'' script under root:
Boot the plug computer with your newly created drive/card attached. Give it a few minutes to boot, and it will be ready for the Amahi installation.
If you need help getting your plug computer to boot from USB or SD, instead of the on-board Flash memory, see our [[Marvell Plug Computer Booting]] page.
Note that for this step to work correctly, your plug computer needs to have access to Internet. Maybe you can just SSH into it, and ping www.amahi.org to make sure it works.
== Enjoy ==
After it reboots, access your HDA by logging in at <code>http://plug_computer_ip</code><br/>
Username: admin
(Change it!)
== Post Install Action == If all seems to work, you can now disable your old DHCP server, and let your plug computer act as your new DHCP server.<br/> You'll need to [[RenewIP|release and then renew the IP address]] of your client computers, once your old DHCP server is disabled.<br/>
You'll then be able to access the Amahi dashboard at http://hda, and your installed apps using http://app_name
If you created a swap partition while partitioning your storage device, you might need to tell Amahi to use that partition for swap space. You'll need to change '''/dev/sda2''' for the real path to your swap partition. SSH into your Amahi server, and execute the following:
Note: On the SheevaPlug, the onboard NAND flash is called /dev/mtdblock2. You might want to use it as a swap partition, as it would be faster than your SD card or USB drive.
If you need customizations for your device, you can install the [http://fedoraproject.org/wiki/Architectures/ARM/CrossToolchain ARM cross compilation toolset] to compile things like the kernel, multimedia libraries, etc. etc.
= Tips and Tricks =
Tips, tricks and howto's can be found at [[Plug Tips and Tricks]]
= Known Issues =
* See the [http://bugs.amahi.org/projects/show/plug bug tracker] for reported bugs against the plug edition.
* See [[Plug_warboard]] for documented issues.
These are mostly what matter for debugging:
/root/hda-install.log
egrep -v 'POST<nowiki>|GET|</nowiki>progress' /tmp/amahi-ruby-install.log
