Difference between revisions of "Amahi Plug Edition"
| Line 6: | Line 6: | ||
* DockStar | * DockStar | ||
* Any other Plug Computer based on the Marvell Plug Computer | * Any other Plug Computer based on the Marvell Plug Computer | ||
| + | |||
| + | = Requirements = | ||
| + | |||
| + | You'll need: | ||
| + | * A storage device, of 2GB or more, that your plug computer can boot from. | ||
| + | * The latest Amahi ''rootfs'' from http://dl.amahi.org/marvell/ - 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-clean-f12-disk.sh | ||
= Quick Install = | = Quick Install = | ||
| − | Step 1: Download and | + | Step 1: Download and extract the [http://dl.amahi.org/marvell/ Amahi ''rootfs'' image] into an empty USB hard drive, USB flash drive, or SD card (depending on what your device supports), formatted as ext3. |
Step 2: Boot your device using the drive or card you created in step 1. | Step 2: Boot your device using the drive or card you created in step 1. | ||
| Line 18: | Line 25: | ||
== Step 1: Prepare your boot device == | == Step 1: Prepare your boot device == | ||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
Connect your boot device (USB hard drive, USB flash drive, or SD card) into a working Linux machine.<br/> | Connect your boot device (USB hard drive, USB flash drive, or SD card) into a working Linux machine.<br/> | ||
If needed, partition your device to create a partition you'll use to boot. No need to format it.<br/> | If needed, partition your device to create a partition you'll use to boot. No need to format it.<br/> | ||
| − | If a swap partition is desired (highly recommended for the | + | If a swap partition is desired (highly recommended for the DockStar), create a second partition on your storage device, between 512MB and 2GB (depending on how big your device is), and format it as ''Linux Swap''. |
| + | |||
| + | 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.<br/> | ||
| + | Edit the ''create-clean-f12-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, if needed. It should contain the name of the Amahi ''rootfs'' file you downloaded. Example: '''rootfs="amahi-marvell-0.8.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'''. | ||
| + | |||
| + | <strong color="red">Big Warning!</strong> Putting the wrong partition in this script will completely erase that partition! Be careful what partition you target! | ||
| + | |||
| + | Run the ''create-clean-f12-disk.sh'' script: '''bash create-clean-f12-disk.sh''' | ||
== Step 2: Boot your plug == | == Step 2: Boot your plug == | ||
| − | Boot the | + | 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. |
== Step 3: Install Amahi == | == Step 3: Install Amahi == | ||
| − | + | Find the plug computer IP address (check your DHCP server), and launch the Amahi installer by visiting http://plug_computer_ip:2000 | |
| + | |||
| + | It will ask for an install code. That code can be obtained by creating an Amahi profile here: https://www.amahi.org/user (you'll need to create an account first, if you don't already have one). | ||
Revision as of 14:29, 3 August 2010
Contents
Supported devices
- SheevaPlug
- GuruPlug
- Pogoplug
- DockStar
- Any other Plug Computer based on the Marvell Plug Computer
Requirements
You'll need:
- A storage device, of 2GB or more, that your plug computer can boot from.
- The latest Amahi rootfs from http://dl.amahi.org/marvell/ - 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-clean-f12-disk.sh
Quick Install
Step 1: Download and extract the Amahi rootfs image into an empty USB hard drive, USB flash drive, or SD card (depending on what your device supports), formatted as ext3.
Step 2: Boot your device using the drive or card you created in step 1.
Step 3: Install Amahi, by loading http://plug_ip:2000 and entering the install code you got when you created your Amahi profile.
Detailed Installation Instructions
Step 1: Prepare your boot device
Connect your boot device (USB hard drive, USB flash drive, or SD card) into a working Linux machine.
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 DockStar), create a second partition on your storage device, between 512MB and 2GB (depending on how big your device is), and format it as Linux Swap.
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-clean-f12-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, if needed. It should contain the name of the Amahi rootfs file you downloaded. Example: rootfs="amahi-marvell-0.8.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 partition in this script will completely erase that partition! Be careful what partition you target!
Run the create-clean-f12-disk.sh script: bash create-clean-f12-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.
Step 3: Install Amahi
Find the plug computer IP address (check your DHCP server), and launch the Amahi installer by visiting http://plug_computer_ip:2000
It will ask for an install code. That code can be obtained by creating an Amahi profile here: https://www.amahi.org/user (you'll need to create an account first, if you don't already have one).
