OpenRD Ultimate will need some tweaking as the current kernel does not support OpenRD Ultimate yet.

eSata SheevaPlug will need an updated kernel to support the eSata port (#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 Amahi4Plug repo look for the latest file named amahi-marvell-*.tar.bz2

This script to copy the above rootfs into your storage device. Important: you will have to modify this script to suit your device, as it obliterates the content of it

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.

There are three major steps in getting things going

Step 1

Download the latest rootfs image then use the script to extract and put it into an empty USB hard drive, USB flash drive, or SD card (depending on what your device supports). While it does that, you may want to setup a profile for your HDA at Amahi

Step 2

Boot your device using the drive or card you created in step 1. Find out the IP it got assigned from your existing DHCP server (typically your router). Alternately if you have console access log in at the console prompt (user: admin, password: amahi) and run /sbin/ifconfig. The ip address is at the second line of the eth0 section (inet addr)

Detailed Installation Instructions

Step 1: Prepare your boot device

If needed, partition your device to create a partition you'll use to boot. No need to format it.

If a swap partition is desired (highly recommended for the PogoPlug & DockStar), create a second partition on your storage device, between 512MB and 2GB (depending on how big your storage device is), and format it as Linux Swap.

Example partitioning depending on your boot device type & size:

2GB Flash Driveor SD Card

4GB Flash Driveor SD Card

8GB Flash Driveor SD Card

16GB Flash Driveor SD Card

USB Hard Drive(40+ GB)

2GB, unformatted

4GB, unformatted

512MB, Linux Swap7.5GB, unformatted

1GB, Linux Swap15GB, unformatted

2GB, Linux SwapThe rest, unformatted

Download the Amahi rootfs file and create-clean-f12-disk.sh script into your Linux machine. Don't store them on the storage device you want to use on your plug computer.
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.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.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.

BIG WARNING! Putting the wrong partitions in this script will completely erase those partitions! Be careful what partitions you target!

Run the create-amahi-f12-plug-disk.sh script under root:

sh create-amahi-f12-plug-disk.sh

Step 2: Boot your plug

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.

Step 3: Install Amahi

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.

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:

mkswap /dev/sda2
swapon -a

You will also need to edit the /etc/fstab file to use that new partition at startup

Check that everything is now working with

free

The total on the swap line should not be 0 if all worked out. Otherwise make sure the fstab has the right device for swapping.

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.

Customize and Extend

If you need customizations for your device, you can install the ARM cross compilation toolset to compile things like the kernel, multimedia libraries, etc. etc.