Amahi Wiki - User contributions [en]

Marvell Plug Computer Booting

2011-07-15T11:30:45Z

Mattwire:

Back to [[Amahi_Plug_Edition]]

= SheevaPlug =

Here's how to allow your SheevaPlug to boot from a USB drive or SD card. 

Connect to the serial console (use 2 stop bits & 115200 bps).

= JTAG serial console =
If you do not have access to a serial console on your plug then you will need a JTAG module to do this:
* Connect the JTAG module to the SheevaPlug (be careful; connecting it the wrong way will fry it! See the warning sticker on the plug, and the photo on the box for proper connection), and connect the USB side to your computer (can be Windows, Linux or Mac).

'''Windows'''

On Windows, install a driver
(Use the disc that came with plug or You can download it from [http://sourceforge.net/projects/esia/files/drivers/ here]), and [http://plugcomputer.org/plugwiki/index.php/SerialTerminal/Windows/PuTTY use PuTTY (serial)].

'''Linux'''

On Linux, execute the following command:
cat > /etc/udev/rules.d/85-sheevaplug.rules <<'EOF'
# if no driver has claimed the interface yet, load ftdi_sio
ACTION=="add", SUBSYSTEM=="usb", ENV{DEVTYPE}=="usb_interface", \
ATTRS{idVendor}=="1c0c", ATTRS{idProduct}=="0102", \
DRIVER=="", \
RUN+="/sbin/modprobe -b ftdi_sio"

# add the sheevaplug VID and PID to the list of devices supported by ftdi_sio
ACTION=="add", SUBSYSTEM=="drivers", \
ENV{DEVPATH}=="/bus/usb-serial/drivers/ftdi_sio", \
ATTR{new_id}="1c0c 0102"

# optionally create a convenience symlink for the console device
ACTION=="add", KERNEL=="ttyUSB*", \
ATTRS{interface}=="SheevaPlug JTAGKey FT2232D B", \
ATTRS{bInterfaceNumber}=="01", \
SYMLINK+="sheevaplug"
EOF

Then use [http://sourceforge.net/projects/gtkterm/ gtkterm]: use 2 stop bits & 115200 bps speed when creating the profile; keep the defaults for the rest. Instead of gtkterm, you can also use the simpler screen: ''yum -y install screen; screen /dev/ttyUSB1 115200'' 
Once connected, if you want to close your terminal session, hit Ctrl-A followed by Shift-K. You'll be asked if you're sure you want to kill this window; just say yes!

'''Mac OS X'''

On Mac OS X, Install the [http://www.ftdichip.com/Drivers/VCP/MacOSX/FTDIUSBSerialDriver_v2_2_14.dmg FTDI driver], download [http://dl.dropbox.com/u/3022105/Amahi/sheeva/Info.plist.patch Info.plist.patch] to your desktop, then run the following commands to connect to the SheevaPlug console:
sudo patch -p0 < ~/Desktop/Info.plist.patch
sudo kextunload /System/Library/Extensions/FTDIUSBSerialDriver.kext
sudo kextload /System/Library/Extensions/FTDIUSBSerialDriver.kext

Then plug in the device to USB:

screen /dev/tty.usbserial-[TAB]B 115200

For [TAB], hit the TAB key; the value there will be unique to each SheevaPlug computer, so TAB will allow you to auto-fill the correct value. Type '''B''' after that value has been auto-filled.

= Once Connected via a serial console =

Once connected, if you want to close your terminal session, hit Ctrl-A followed by Ctrl-K (or Shift-K on Linux). You'll be asked if you're sure you want to kill this window; just say yes!
* Reset the SheevaPlug.
* At the terminal, press enter a couple of seconds after boot to prevent it from booting using the onboard flash (Ubuntu). You should end up with a ''Marvell>>'' prompt.

'''arcNumber'''

The ArcNumber parameter references a particular mach-type/machine from the kernel's Arm machine table. This needs to be configured correctly for your device otherwise it may not boot or may not have all the features (eg. arcNumber=2678 is required for eSata Sheevaplug).

Find the correct arcNumber for your device [http://www.arm.linux.org.uk/developer/machines/ here].

'''USB Boot'''

* There are some commands you need to run to make it permanently boot from the USB port ('''NOTE:''' this step is only necessary once):
setenv mainlineLinux yes
setenv arcNumber 2097
setenv bootargs_root 'root=/dev/sda1 rootdelay=15'
setenv bootcmd_usb 'usb start; ext2load usb 0:1 0x6400000 /boot/uImage'
setenv bootcmd 'setenv bootargs $(console) $(bootargs_root); run bootcmd_usb; bootm 0x6400000'
saveenv
reset

'''SD Card Boot'''

* If you want to make it permanently boot from the SD card, the commands you need to run are:
('''NOTE:''' this step is only necessary once. I assume that the root partition is /dev/mmcblk0p1 and the swap partition is /dev/mmcblk0p2).
setenv mainlineLinux yes
setenv arcNumber 2097
setenv bootargs_console console=ttyS0,115200
setenv bootargs_root 'rw root=/dev/mmcblk0p1 rootdelay=15 rootfstype=ext3'
setenv bootcmd_mmc 'mmcinit; ext2load mmc 0:1 0x800000 /boot/uImage'
setenv bootcmd 'setenv bootargs $(bootargs_console) $(bootargs_root); run bootcmd_mmc; bootm 0x0800000'
saveenv
reset

= GuruPlug =

Configuring [[Uboot for GuruPlug]]

= Pogoplug / DockStar =

See the instructions here on how to allow the PogoPlug & DockStar to boot from USB: http://plugapps.com/index.php5?title=PlugApps:Pogoplug_Setboot 
Stop after executing the ''pogo_u-boot_install.sh'' script in step 1.

= OpenRD Client =

The instructions for the OpenRD client are roughly similar to the ones for Sheevaplug. There are a few notable differences though.
* If your serial port does not work you need to use VID 0403 and PID 9e90
* the arcNumber for OpenRD Client is 2361
* when booting from an usb device the device will be /dev/sdb if you also have an internal disk mounted. You need to change bootargs accordingly (e.g. root=/dev/sdb1)
* apparently doing 'usb start' twice from u-boot makes that the usb device is not re-detected. In that case it is needed to powercycle the device.

= OpenRD Base =

I have no OpenRD Base but the key difference between Base and Client as far as booting concerns is the arcNumber. OpenRD Base has arcNumber 2325 
If you manage to get things working with OpenRD Base please update this section.

= References =
* See also [https://fedoraproject.org/wiki/Architectures/ARM/SheevaplugUSB https://fedoraproject.org/wiki/Architectures/ARM/SheevaplugUSB]

Plug warboard

2011-07-15T11:30:10Z

Mattwire:

Back to [[Amahi_Plug_Edition]]

When you note a problem, please indicate what version you're running (0.2, 0.3, ...)

= Warboard =

* VPN works. the date needs to be set to something recent:
date --set 'Thu May 27 16:44:57 EDT 2010'
hwclock --systohc --utc
* tar and unzip need to be in the image:
yum -y install tar unzip
* Greyhole *is* working
* crontab does not appear to be working
* had to add with noatime in / to prevent flash burnout
* should control monit - it keeps on pounding the flash with messages in /var/log/monit
* would like to add swap to flash based drives
* mt-daapd and amahi-transmission are dying
* ntpd is not installed??
[root@fedora-arm ~]# date
Sun Apr 30 06:57:12 EDT 2000

= OpenVPN =


# service openvpn start
Starting openvpn: FATAL: Module ip_tables not found.
iptables v1.4.5: can't initialize iptables table `filter': iptables who? (do you need to insmod?)
Perhaps iptables or your kernel needs to be upgraded.
FATAL: Module ip_tables not found.
iptables v1.4.5: can't initialize iptables table `filter': iptables who? (do you need to insmod?)
Perhaps iptables or your kernel needs to be upgraded.
FATAL: Module ip_tables not found.
iptables v1.4.5: can't initialize iptables table `nat': iptables who? (do you need to insmod?)
Perhaps iptables or your kernel needs to be upgraded.
[FAILED]


= Fixed =

* local DNS server is not working for external hostnames (caused by dnssec enabled in named.conf). Workaround
echo -e 'DNSSEC="off"\nDLV="off"' > /etc/sysconfig/dnssec
service named restart

Plug Tips and Tricks

2011-07-15T11:28:46Z

Mattwire:

Back to [[Amahi_Plug_Edition]]

= Introduction =

This page contains some tips, tricks and howto's for the plug distro. Feel free to add your own.

= Setting the timezone =

The timezone is not set on a new plug install (See [http://bugs.amahi.org/issues/show/757 #757]. To set it manually follow the steps below:

* Login as root or su to root.
* choose from /usr/share/zoneinfo which timezone you want to set your plug to.
* Issue the command '''rm /etc/localtime; ln -sf /usr/share/zoneinfo/Europe/Amsterdam /etc/localtime'''
* Issue the command '''hda-php-zone-change "Europe/Amsterdam"''' to set the timezone for PHP.
''Obviously replace Europe/Amsterdam with whatever timezone you want to set the timezone to.''

= Useful commands =
The following useful commands are not installed by default:
* which
* man
* scp
* ssh
* make

To install issue the command:
yum -y install which man openssh-clients make

= Advanced =
== Using the onboard NAND flash as a swap drive ==
Note that many devices are configured to fallback to booting from NAND flash if no USB/SD card is found. This makes it almost impossible to brick your device.

''If you use the NAND flash as swap you will lose this ability.''

{{Code|cfdisk /dev/mtdblock2}}
* Create a "Linux swap / Solaris" partition that takes all the space:
# remove any existing partitions, if any
# create a new primary partition
# select Type option, enter "82"
# select Write option
# select Quit option
{{Code|mkswap /dev/mtdblock2
echo "/dev/mtdblock2 swap swap defaults 0 0" >> /etc/fstab
swapon -a}}

== Copy a root filesystem from one disk to another ==
This may be useful if you have set up things on a USB device and want to copy to an internal harddisk:

The code below assumes the old (usb) disk is at /dev/sdb1 and the new (internal) disk is at /dev/sda1. Substitute accordingly
{{Code|
# /dev/sda1 is the target filesystem; must have an empty filesystem on it
mount /dev/sda1 /mnt
mkdir /mnt2
# /dev/sdb2 is the source filesystem
mount /dev/sdb1 /mnt2
cd /mnt2
cp -ar * /mnt
}}

Plug notes

2011-07-15T11:27:04Z

Mattwire: Redirected page to Amahi Plug Edition

#REDIRECT [[Amahi_Plug_Edition]]

'''Note: Most of this information is duplicated elsewhere. It needs to be verified and removed as necessary.'''

See [[Amahi_Plug_Edition | Amahi_Plug_Edition]] for installation and supported devices.

= Misc Notes =

* restarting rpm db in chrooted environment:
{{Code|rm /var/lib/rpm/__db*
rpm --rebuilddb -vv}}

Plug Tips and Tricks

2011-07-15T11:25:39Z

Mattwire:

= Introduction =

This page contains some tips, tricks and howto's for the plug distro. Feel free to add your own.

= Setting the timezone =

The timezone is not set on a new plug install (See [http://bugs.amahi.org/issues/show/757 #757]. To set it manually follow the steps below:

* Login as root or su to root.
* choose from /usr/share/zoneinfo which timezone you want to set your plug to.
* Issue the command '''rm /etc/localtime; ln -sf /usr/share/zoneinfo/Europe/Amsterdam /etc/localtime'''
* Issue the command '''hda-php-zone-change "Europe/Amsterdam"''' to set the timezone for PHP.
''Obviously replace Europe/Amsterdam with whatever timezone you want to set the timezone to.''

= Useful commands =
The following useful commands are not installed by default:
* which
* man
* scp
* ssh
* make

To install issue the command:
yum -y install which man openssh-clients make

= Advanced =
== Using the onboard NAND flash as a swap drive ==
Note that many devices are configured to fallback to booting from NAND flash if no USB/SD card is found. This makes it almost impossible to brick your device.

''If you use the NAND flash as swap you will lose this ability.''

{{Code|cfdisk /dev/mtdblock2}}
* Create a "Linux swap / Solaris" partition that takes all the space:
# remove any existing partitions, if any
# create a new primary partition
# select Type option, enter "82"
# select Write option
# select Quit option
{{Code|mkswap /dev/mtdblock2
echo "/dev/mtdblock2 swap swap defaults 0 0" >> /etc/fstab
swapon -a}}

== Copy a root filesystem from one disk to another ==
This may be useful if you have set up things on a USB device and want to copy to an internal harddisk:

The code below assumes the old (usb) disk is at /dev/sdb1 and the new (internal) disk is at /dev/sda1. Substitute accordingly
{{Code|
# /dev/sda1 is the target filesystem; must have an empty filesystem on it
mount /dev/sda1 /mnt
mkdir /mnt2
# /dev/sdb2 is the source filesystem
mount /dev/sdb1 /mnt2
cd /mnt2
cp -ar * /mnt
}}

Marvell Plug Computer Booting

2011-07-15T11:22:19Z

Mattwire:

= SheevaPlug =

Here's how to allow your SheevaPlug to boot from a USB drive or SD card. 

Connect to the serial console (use 2 stop bits & 115200 bps).

= JTAG serial console =
If you do not have access to a serial console on your plug then you will need a JTAG module to do this:
* Connect the JTAG module to the SheevaPlug (be careful; connecting it the wrong way will fry it! See the warning sticker on the plug, and the photo on the box for proper connection), and connect the USB side to your computer (can be Windows, Linux or Mac).

'''Windows'''

On Windows, install a driver
(Use the disc that came with plug or You can download it from [http://sourceforge.net/projects/esia/files/drivers/ here]), and [http://plugcomputer.org/plugwiki/index.php/SerialTerminal/Windows/PuTTY use PuTTY (serial)].

'''Linux'''

On Linux, execute the following command:
cat > /etc/udev/rules.d/85-sheevaplug.rules <<'EOF'
# if no driver has claimed the interface yet, load ftdi_sio
ACTION=="add", SUBSYSTEM=="usb", ENV{DEVTYPE}=="usb_interface", \
ATTRS{idVendor}=="1c0c", ATTRS{idProduct}=="0102", \
DRIVER=="", \
RUN+="/sbin/modprobe -b ftdi_sio"

# add the sheevaplug VID and PID to the list of devices supported by ftdi_sio
ACTION=="add", SUBSYSTEM=="drivers", \
ENV{DEVPATH}=="/bus/usb-serial/drivers/ftdi_sio", \
ATTR{new_id}="1c0c 0102"

# optionally create a convenience symlink for the console device
ACTION=="add", KERNEL=="ttyUSB*", \
ATTRS{interface}=="SheevaPlug JTAGKey FT2232D B", \
ATTRS{bInterfaceNumber}=="01", \
SYMLINK+="sheevaplug"
EOF

Then use [http://sourceforge.net/projects/gtkterm/ gtkterm]: use 2 stop bits & 115200 bps speed when creating the profile; keep the defaults for the rest. Instead of gtkterm, you can also use the simpler screen: ''yum -y install screen; screen /dev/ttyUSB1 115200'' 
Once connected, if you want to close your terminal session, hit Ctrl-A followed by Shift-K. You'll be asked if you're sure you want to kill this window; just say yes!

'''Mac OS X'''

On Mac OS X, Install the [http://www.ftdichip.com/Drivers/VCP/MacOSX/FTDIUSBSerialDriver_v2_2_14.dmg FTDI driver], download [http://dl.dropbox.com/u/3022105/Amahi/sheeva/Info.plist.patch Info.plist.patch] to your desktop, then run the following commands to connect to the SheevaPlug console:
sudo patch -p0 < ~/Desktop/Info.plist.patch
sudo kextunload /System/Library/Extensions/FTDIUSBSerialDriver.kext
sudo kextload /System/Library/Extensions/FTDIUSBSerialDriver.kext

Then plug in the device to USB:

screen /dev/tty.usbserial-[TAB]B 115200

For [TAB], hit the TAB key; the value there will be unique to each SheevaPlug computer, so TAB will allow you to auto-fill the correct value. Type '''B''' after that value has been auto-filled.

= Once Connected via a serial console =

Once connected, if you want to close your terminal session, hit Ctrl-A followed by Ctrl-K (or Shift-K on Linux). You'll be asked if you're sure you want to kill this window; just say yes!
* Reset the SheevaPlug.
* At the terminal, press enter a couple of seconds after boot to prevent it from booting using the onboard flash (Ubuntu). You should end up with a ''Marvell>>'' prompt.

'''arcNumber'''

The ArcNumber parameter references a particular mach-type/machine from the kernel's Arm machine table. This needs to be configured correctly for your device otherwise it may not boot or may not have all the features (eg. arcNumber=2678 is required for eSata Sheevaplug).

Find the correct arcNumber for your device [http://www.arm.linux.org.uk/developer/machines/ here].

'''USB Boot'''

* There are some commands you need to run to make it permanently boot from the USB port ('''NOTE:''' this step is only necessary once):
setenv mainlineLinux yes
setenv arcNumber 2097
setenv bootargs_root 'root=/dev/sda1 rootdelay=15'
setenv bootcmd_usb 'usb start; ext2load usb 0:1 0x6400000 /boot/uImage'
setenv bootcmd 'setenv bootargs $(console) $(bootargs_root); run bootcmd_usb; bootm 0x6400000'
saveenv
reset

'''SD Card Boot'''

* If you want to make it permanently boot from the SD card, the commands you need to run are:
('''NOTE:''' this step is only necessary once. I assume that the root partition is /dev/mmcblk0p1 and the swap partition is /dev/mmcblk0p2).
setenv mainlineLinux yes
setenv arcNumber 2097
setenv bootargs_console console=ttyS0,115200
setenv bootargs_root 'rw root=/dev/mmcblk0p1 rootdelay=15 rootfstype=ext3'
setenv bootcmd_mmc 'mmcinit; ext2load mmc 0:1 0x800000 /boot/uImage'
setenv bootcmd 'setenv bootargs $(bootargs_console) $(bootargs_root); run bootcmd_mmc; bootm 0x0800000'
saveenv
reset

= GuruPlug =

Configuring [[Uboot for GuruPlug]]

= Pogoplug / DockStar =

See the instructions here on how to allow the PogoPlug & DockStar to boot from USB: http://plugapps.com/index.php5?title=PlugApps:Pogoplug_Setboot 
Stop after executing the ''pogo_u-boot_install.sh'' script in step 1.

= OpenRD Client =

The instructions for the OpenRD client are roughly similar to the ones for Sheevaplug. There are a few notable differences though.
* If your serial port does not work you need to use VID 0403 and PID 9e90
* the arcNumber for OpenRD Client is 2361
* when booting from an usb device the device will be /dev/sdb if you also have an internal disk mounted. You need to change bootargs accordingly (e.g. root=/dev/sdb1)
* apparently doing 'usb start' twice from u-boot makes that the usb device is not re-detected. In that case it is needed to powercycle the device.

= OpenRD Base =

I have no OpenRD Base but the key difference between Base and Client as far as booting concerns is the arcNumber. OpenRD Base has arcNumber 2325 
If you manage to get things working with OpenRD Base please update this section.

= References =
* See also [https://fedoraproject.org/wiki/Architectures/ARM/SheevaplugUSB https://fedoraproject.org/wiki/Architectures/ARM/SheevaplugUSB]

Plug notes

2011-07-15T11:20:59Z

Mattwire:

'''Note: Most of this information is duplicated elsewhere. It needs to be verified and removed as necessary.'''

See [[Amahi_Plug_Edition | Amahi_Plug_Edition]] for installation and supported devices.

= Using the onboard NAND flash as a swap drive =

{{Code|cfdisk /dev/mtdblock2}}
* Create a "Linux swap / Solaris" partition that takes all the space:
# remove any existing partitions, if any
# create a new primary partition
# select Type option, enter "82"
# select Write option
# select Quit option
{{Code|mkswap /dev/mtdblock2
echo "/dev/mtdblock2 swap swap defaults 0 0" >> /etc/fstab
swapon -a}}

= Misc Notes =

* restarting rpm db in chrooted environment:
{{Code|rm /var/lib/rpm/__db*
rpm --rebuilddb -vv}}

Marvell Plug Computer Booting

2011-07-15T11:17:17Z

Mattwire:

Amahi Plug Edition

2011-07-15T10:43:51Z

Mattwire:

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-openrdcdetails.aspx OpenRD 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'''
* [http://dl.amahi.org/marvell/create-amahi-f12-plug-disk.sh 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 [http://dl.amahi.org/marvell/ 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 [http://www.amahi.org/ 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)

; '''Step 3'''
: Install Amahi, by loading <code>http://plug_ip:2000</code> and entering the install code you got when you [https://www.amahi.org/user created your Amahi profile].

= Known issues =

For a list of working / not working apps for plug computers, see [[Plug Apps| Plug Apps]] page. Also, please check and file any issues in the [http://bugs.amahi.org/projects/show/plug Amahi bug tracker project for the Plug port]

= Detailed Installation Instructions =

Fully detailed procedure.

== Step 1: Prepare your boot device ==

Connect your boot device (USB hard drive, USB flash drive, or SD card) into a working Linux machine (you can use your plug computer!)

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:
{| cellpadding="7"
! 2GB Flash Drive or SD Card
! 4GB Flash Drive or SD Card
! 8GB Flash Drive or SD Card
! 16GB Flash Drive or SD Card
! USB Hard Drive (40+ GB)
|-
|2GB, unformatted
|4GB, unformatted
|512MB, Linux Swap 7.5GB, unformatted
|1GB, Linux Swap 15GB, unformatted
|2GB, Linux Swap The 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'''.

<div style="border: 1px solid #B66; padding: .5em 1em; color: #000; background-color: #FEE; margin: 3px 3px 1em 3px;">
'''BIG WARNING! Putting the wrong partitions in this script will completely erase those partitions! Be careful what partitions you target!
</div>

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.

Find the plug computer IP address (check your router DHCP logs or DHCP server), and launch the Amahi installer by visiting http://plug_computer_ip:2000

(Use nmap or ping -b to find new devices on your LAN, if you can't find your plug computer IP address on your DHCP server.)

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).

== Enjoy ==

After it reboots, access your HDA by logging in at <code>http://plug_computer_ip</code> 

Username: admin
Password: amahi

The root password is: amahi 
(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.

You'll need to [[RenewIP|release and then renew the IP address]] of your client computers, once your old DHCP server is disabled.

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:

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 [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:
{{Code|/root/hda-install.log}}
 {{Code|egrep -v 'POST<nowiki>|GET|</nowiki>progress' /tmp/amahi-ruby-install.log}}

Plug notes

2011-07-15T10:41:17Z

Mattwire:

'''Note: Most of this information is duplicated elsewhere. It needs to be verified and removed as necessary.'''

See [[Amahi_Plug_Edition | Amahi_Plug_Edition]] for installation and supported devices.

= Getting the plug booting Fedora 12 =

Here are the steps to make the plug boot from USB
* General [http://fedoraproject.org/wiki/Architectures/ARM/SheevaplugUSB directions]
* Connect the ethernet cable to your network (Mouton says: is this necessary now? Can't we just wait until the Amahi Install section below to connect the plug to the LAN?)
* Connect the JTAG module to the SheevaPlug (be careful; connecting it the wrong way will fry it! See the warning sticker on the plug, and the photo on the box for proper connection), and connect the USB side to your computer (can be Windows, Linux or Mac).
* On Windows: install a driver (disc that came with plug), and [http://plugcomputer.org/plugwiki/index.php/SerialTerminal/Windows/PuTTY use PuTTY (serial)].
* On Linux, execute the following command, and use [http://sourceforge.net/projects/gtkterm/ gtkterm]: use 2 stop bits & 115200 bps speed when creating the profile; keep the defaults for the rest. Instead of gtkterm, you can also use the simpler screen: ''yum -y install screen; screen /dev/ttyUSB1 115200''
{{Text|Text=cat > /etc/udev/rules.d/85-sheevaplug.rules <<'EOF'
<nowiki>#</nowiki> if no driver has claimed the interface yet, load ftdi_sio
ACTION<nowiki>==</nowiki>"add", SUBSYSTEM<nowiki>==</nowiki>"usb", ENV{DEVTYPE}<nowiki>==</nowiki>"usb_interface", \
ATTRS{idVendor}<nowiki>==</nowiki>"1c0c", ATTRS{idProduct}<nowiki>==</nowiki>"0102", \
DRIVER<nowiki>==</nowiki>"", \
RUN+="/sbin/modprobe -b ftdi_sio"

<nowiki>#</nowiki> add the sheevaplug VID and PID to the list of devices supported by ftdi_sio
ACTION<nowiki>==</nowiki>"add", SUBSYSTEM<nowiki>==</nowiki>"drivers", \
ENV{DEVPATH}<nowiki>==</nowiki>"/bus/usb-serial/drivers/ftdi_sio", \
ATTR{new_id}<nowiki>=</nowiki>"1c0c 0102"

<nowiki>#</nowiki> optionally create a convenience symlink for the console device
ACTION<nowiki>==</nowiki>"add", KERNEL<nowiki>==</nowiki>"ttyUSB*", \
ATTRS{interface}=="SheevaPlug JTAGKey FT2232D B", \
ATTRS{bInterfaceNumber}<nowiki>==</nowiki>"01", \
SYMLINK+="sheevaplug"
EOF}}
* Reset the device from the JTAG module (Mouton says: how? I tried to push the button, but that doesn't seem to reset the device... Do you mean login using the terminal emulator, and issue a reboot command..?)
* At the terminal, press enter a couple of seconds after boot to prevent it from booting using the onboard flash (Ubuntu). You should end up with a ''Marvell>>'' prompt.
* There are some commands you need to run to make it permanently boot from the USB port ('''NOTE:''' this step is only necessary once):
{{Code|setenv mainlineLinux yes
setenv arcNumber 2097
setenv bootargs_root 'root<nowiki>=</nowiki>/dev/sda1 rootdelay<nowiki>=</nowiki>15'
setenv bootcmd_usb 'usb start; ext2load usb 0:1 0x6400000 /boot/uImage'
setenv bootcmd 'setenv bootargs $(console) $(bootargs_root); run bootcmd_usb; bootm 0x6400000'
saveenv
reset}}
* In order to install the rootfs onto a flash or disk, mount the flash drive on a linux system and execute the [http://dl.amahi.org/marvell/create-clean-f12-disk.sh create-clean-f12-disk.sh] script. You'll need to have the [http://dl.amahi.org/marvell/amahi-marvell-0.5.tar.bz2 amahi-marvell-0.5.tar.bz2] file in the current directory. It may take a while, but this must be done before booting up the plug and installing Amahi.

'''NOTE:''' This script is very dangerous (it can destroy the machine it is run on if not used properly). You will need to change the partition destination.

* Insert USB Flash Drive into the plug.
* Once this is complete, the JTAG module can be disconnected. There will be no need for serial connection any longer. Once the USB Flash Drive is connected and the plug booted, you will be able to connect via SSH (default root password is "amahi").

= Connecting to a Plug on a Mac =

On Mac OS X, Install the [http://www.ftdichip.com/Drivers/VCP/MacOSX/FTDIUSBSerialDriver_v2_2_14.dmg FTDI driver], download [http://dl.dropbox.com/u/3022105/Amahi/sheeva/Info.plist.patch Info.plist.patch] to your desktop, then run the following commands to connect to the SheevaPlug console:
{{Code|sudo patch -p0 < ~/Desktop/Info.plist.patch
sudo kextunload /System/Library/Extensions/FTDIUSBSerialDriver.kext
sudo kextload /System/Library/Extensions/FTDIUSBSerialDriver.kext
screen /dev/tty.usbserial-[TAB]B 115200}}

For [TAB], hit the TAB key; the value there will be unique to each SheevaPlug computer, so TAB will allow you to auto-fill the correct value. Once connected, if you want to close your terminal session, hit Ctrl-A followed by Ctrl-K (or Shift-K on Linux). You'll be asked if you're sure you want to kill this window; just say yes!

= Using the onboard NAND flash as a swap drive =

{{Code|cfdisk /dev/mtdblock2}}
* Create a "Linux swap / Solaris" partition that takes all the space:
# remove any existing partitions, if any
# create a new primary partition
# select Type option, enter "82"
# select Write option
# select Quit option
{{Code|mkswap /dev/mtdblock2
echo "/dev/mtdblock2 swap swap defaults 0 0" >> /etc/fstab
swapon -a}}

= Misc Notes =

* restarting rpm db in chrooted environment:
{{Code|rm /var/lib/rpm/__db*
rpm --rebuilddb -vv}}

Amahi Plug Edition

2011-07-15T10:41:14Z

Mattwire:

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-openrdcdetails.aspx OpenRD 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'''
* [http://dl.amahi.org/marvell/create-amahi-f12-plug-disk.sh 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 [http://dl.amahi.org/marvell/ 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 [http://www.amahi.org/ 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)

; '''Step 3'''
: Install Amahi, by loading <code>http://plug_ip:2000</code> and entering the install code you got when you [https://www.amahi.org/user created your Amahi profile].

= Known issues =

For a list of working / not working apps for plug computers, see [[Plug Apps| Plug Apps]] page. Also, please check and file any issues in the [http://bugs.amahi.org/projects/show/plug Amahi bug tracker project for the Plug port]

= Detailed Installation Instructions =

Fully detailed procedure.

== Step 1: Prepare your boot device ==

Connect your boot device (USB hard drive, USB flash drive, or SD card) into a working Linux machine (you can use your plug computer!)

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:
{| cellpadding="7"
! 2GB Flash Drive or SD Card
! 4GB Flash Drive or SD Card
! 8GB Flash Drive or SD Card
! 16GB Flash Drive or SD Card
! USB Hard Drive (40+ GB)
|-
|2GB, unformatted
|4GB, unformatted
|512MB, Linux Swap 7.5GB, unformatted
|1GB, Linux Swap 15GB, unformatted
|2GB, Linux Swap The 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'''.

<div style="border: 1px solid #B66; padding: .5em 1em; color: #000; background-color: #FEE; margin: 3px 3px 1em 3px;">
'''BIG WARNING! Putting the wrong partitions in this script will completely erase those partitions! Be careful what partitions you target!
</div>

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.

Find the plug computer IP address (check your router DHCP logs or DHCP server), and launch the Amahi installer by visiting http://plug_computer_ip:2000

(Use nmap or ping -b to find new devices on your LAN, if you can't find your plug computer IP address on your DHCP server.)

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).

== Enjoy ==

After it reboots, access your HDA by logging in at <code>http://plug_computer_ip</code> 

Username: admin
Password: amahi

The root password is: amahi 
(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.

You'll need to [[RenewIP|release and then renew the IP address]] of your client computers, once your old DHCP server is disabled.

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:

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 [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 [[Plug_warboard]] for documented issues.

These are mostly what matter for debugging:
{{Code|/root/hda-install.log}}
 {{Code|egrep -v 'POST<nowiki>|GET|</nowiki>progress' /tmp/amahi-ruby-install.log}}

Plug notes

2011-07-15T10:35:37Z

Mattwire:

'''Note: Most of this information is duplicated elsewhere. It needs to be verified and removed as necessary.'''

See [[Amahi_Plug_Edition | Amahi_Plug_Edition]] for installation and supported devices.

= Getting the plug booting Fedora 12 =

Here are the steps to make the plug boot from USB
* General [http://fedoraproject.org/wiki/Architectures/ARM/SheevaplugUSB directions]
* Connect the ethernet cable to your network (Mouton says: is this necessary now? Can't we just wait until the Amahi Install section below to connect the plug to the LAN?)
* Connect the JTAG module to the SheevaPlug (be careful; connecting it the wrong way will fry it! See the warning sticker on the plug, and the photo on the box for proper connection), and connect the USB side to your computer (can be Windows, Linux or Mac).
* On Windows: install a driver (disc that came with plug), and [http://plugcomputer.org/plugwiki/index.php/SerialTerminal/Windows/PuTTY use PuTTY (serial)].
* On Linux, execute the following command, and use [http://sourceforge.net/projects/gtkterm/ gtkterm]: use 2 stop bits & 115200 bps speed when creating the profile; keep the defaults for the rest. Instead of gtkterm, you can also use the simpler screen: ''yum -y install screen; screen /dev/ttyUSB1 115200''
{{Text|Text=cat > /etc/udev/rules.d/85-sheevaplug.rules <<'EOF'
<nowiki>#</nowiki> if no driver has claimed the interface yet, load ftdi_sio
ACTION<nowiki>==</nowiki>"add", SUBSYSTEM<nowiki>==</nowiki>"usb", ENV{DEVTYPE}<nowiki>==</nowiki>"usb_interface", \
ATTRS{idVendor}<nowiki>==</nowiki>"1c0c", ATTRS{idProduct}<nowiki>==</nowiki>"0102", \
DRIVER<nowiki>==</nowiki>"", \
RUN+="/sbin/modprobe -b ftdi_sio"

<nowiki>#</nowiki> add the sheevaplug VID and PID to the list of devices supported by ftdi_sio
ACTION<nowiki>==</nowiki>"add", SUBSYSTEM<nowiki>==</nowiki>"drivers", \
ENV{DEVPATH}<nowiki>==</nowiki>"/bus/usb-serial/drivers/ftdi_sio", \
ATTR{new_id}<nowiki>=</nowiki>"1c0c 0102"

<nowiki>#</nowiki> optionally create a convenience symlink for the console device
ACTION<nowiki>==</nowiki>"add", KERNEL<nowiki>==</nowiki>"ttyUSB*", \
ATTRS{interface}=="SheevaPlug JTAGKey FT2232D B", \
ATTRS{bInterfaceNumber}<nowiki>==</nowiki>"01", \
SYMLINK+="sheevaplug"
EOF}}
* Reset the device from the JTAG module (Mouton says: how? I tried to push the button, but that doesn't seem to reset the device... Do you mean login using the terminal emulator, and issue a reboot command..?)
* At the terminal, press enter a couple of seconds after boot to prevent it from booting using the onboard flash (Ubuntu). You should end up with a ''Marvell>>'' prompt.
* There are some commands you need to run to make it permanently boot from the USB port ('''NOTE:''' this step is only necessary once):
{{Code|setenv mainlineLinux yes
setenv arcNumber 2097
setenv bootargs_root 'root<nowiki>=</nowiki>/dev/sda1 rootdelay<nowiki>=</nowiki>15'
setenv bootcmd_usb 'usb start; ext2load usb 0:1 0x6400000 /boot/uImage'
setenv bootcmd 'setenv bootargs $(console) $(bootargs_root); run bootcmd_usb; bootm 0x6400000'
saveenv
reset}}
* In order to install the rootfs onto a flash or disk, mount the flash drive on a linux system and execute the [http://dl.amahi.org/marvell/create-clean-f12-disk.sh create-clean-f12-disk.sh] script. You'll need to have the [http://dl.amahi.org/marvell/amahi-marvell-0.5.tar.bz2 amahi-marvell-0.5.tar.bz2] file in the current directory. It may take a while, but this must be done before booting up the plug and installing Amahi.

'''NOTE:''' This script is very dangerous (it can destroy the machine it is run on if not used properly). You will need to change the partition destination.

* Insert USB Flash Drive into the plug.
* Once this is complete, the JTAG module can be disconnected. There will be no need for serial connection any longer. Once the USB Flash Drive is connected and the plug booted, you will be able to connect via SSH (default root password is "amahi").

= Connecting to a Plug on a Mac =

On Mac OS X, Install the [http://www.ftdichip.com/Drivers/VCP/MacOSX/FTDIUSBSerialDriver_v2_2_14.dmg FTDI driver], download [http://dl.dropbox.com/u/3022105/Amahi/sheeva/Info.plist.patch Info.plist.patch] to your desktop, then run the following commands to connect to the SheevaPlug console:
{{Code|sudo patch -p0 < ~/Desktop/Info.plist.patch
sudo kextunload /System/Library/Extensions/FTDIUSBSerialDriver.kext
sudo kextload /System/Library/Extensions/FTDIUSBSerialDriver.kext
screen /dev/tty.usbserial-[TAB]B 115200}}

For [TAB], hit the TAB key; the value there will be unique to each SheevaPlug computer, so TAB will allow you to auto-fill the correct value. Once connected, if you want to close your terminal session, hit Ctrl-A followed by Ctrl-K (or Shift-K on Linux). You'll be asked if you're sure you want to kill this window; just say yes!

= Using the onboard NAND flash as a swap drive =

{{Code|cfdisk /dev/mtdblock2}}
* Create a "Linux swap / Solaris" partition that takes all the space:
# remove any existing partitions, if any
# create a new primary partition
# select Type option, enter "82"
# select Write option
# select Quit option
{{Code|mkswap /dev/mtdblock2
echo "/dev/mtdblock2 swap swap defaults 0 0" >> /etc/fstab
swapon -a}}

= Reporting issues =

These are mostly what matter for debugging:
* {{Code|/root/hda-install.log}}
* {{Code|egrep -v 'POST<nowiki>|GET|</nowiki>progress' /tmp/amahi-ruby-install.log}}
* See [[SP_warboard]] for documented issues.

= Misc Notes =

* restarting rpm db in chrooted environment:
{{Code|rm /var/lib/rpm/__db*
rpm --rebuilddb -vv}}

= How to use two HDA on the same network =
[[How to use two HDA on the same network]]

Plug Tips and Tricks

2011-07-15T10:31:48Z

Mattwire:

Plug warboard

2011-07-15T10:31:38Z

Mattwire:

For installation notes, etc. see [[Plug notes]].

When you note a problem, please indicate what version you're running (0.2, 0.3, ...)

= Warboard =

* VPN works. the date needs to be set to something recent:
date --set 'Thu May 27 16:44:57 EDT 2010'
hwclock --systohc --utc
* tar and unzip need to be in the image:
yum -y install tar unzip
* Greyhole *is* working
* crontab does not appear to be working
* had to add with noatime in / to prevent flash burnout
* should control monit - it keeps on pounding the flash with messages in /var/log/monit
* would like to add swap to flash based drives
* mt-daapd and amahi-transmission are dying
* ntpd is not installed??
[root@fedora-arm ~]# date
Sun Apr 30 06:57:12 EDT 2000

= OpenVPN =


# service openvpn start
Starting openvpn: FATAL: Module ip_tables not found.
iptables v1.4.5: can't initialize iptables table `filter': iptables who? (do you need to insmod?)
Perhaps iptables or your kernel needs to be upgraded.
FATAL: Module ip_tables not found.
iptables v1.4.5: can't initialize iptables table `filter': iptables who? (do you need to insmod?)
Perhaps iptables or your kernel needs to be upgraded.
FATAL: Module ip_tables not found.
iptables v1.4.5: can't initialize iptables table `nat': iptables who? (do you need to insmod?)
Perhaps iptables or your kernel needs to be upgraded.
[FAILED]


= Fixed =

* local DNS server is not working for external hostnames (caused by dnssec enabled in named.conf). Workaround
echo -e 'DNSSEC="off"\nDLV="off"' > /etc/sysconfig/dnssec
service named restart

Plug notes

2011-07-15T10:24:31Z

Mattwire:

= Installation =

See [[Amahi_Plug_Edition | Amahi_Plug_Edition]] for installation and supported devices.

= Warboard and Apps =

For known issues, check the [[Plug warboard | warboard]]

= Applications =

For known issues and working apps check the [[Plug Apps | Plug Apps]] page

= Getting the plug booting Fedora 12 =

Here are the steps to make the plug boot from USB
* General [http://fedoraproject.org/wiki/Architectures/ARM/SheevaplugUSB directions]
* Connect the ethernet cable to your network (Mouton says: is this necessary now? Can't we just wait until the Amahi Install section below to connect the plug to the LAN?)
* Connect the JTAG module to the SheevaPlug (be careful; connecting it the wrong way will fry it! See the warning sticker on the plug, and the photo on the box for proper connection), and connect the USB side to your computer (can be Windows, Linux or Mac).
* On Windows: install a driver (disc that came with plug), and [http://plugcomputer.org/plugwiki/index.php/SerialTerminal/Windows/PuTTY use PuTTY (serial)].
* On Linux, execute the following command, and use [http://sourceforge.net/projects/gtkterm/ gtkterm]: use 2 stop bits & 115200 bps speed when creating the profile; keep the defaults for the rest. Instead of gtkterm, you can also use the simpler screen: ''yum -y install screen; screen /dev/ttyUSB1 115200''
{{Text|Text=cat > /etc/udev/rules.d/85-sheevaplug.rules <<'EOF'
<nowiki>#</nowiki> if no driver has claimed the interface yet, load ftdi_sio
ACTION<nowiki>==</nowiki>"add", SUBSYSTEM<nowiki>==</nowiki>"usb", ENV{DEVTYPE}<nowiki>==</nowiki>"usb_interface", \
ATTRS{idVendor}<nowiki>==</nowiki>"1c0c", ATTRS{idProduct}<nowiki>==</nowiki>"0102", \
DRIVER<nowiki>==</nowiki>"", \
RUN+="/sbin/modprobe -b ftdi_sio"

<nowiki>#</nowiki> add the sheevaplug VID and PID to the list of devices supported by ftdi_sio
ACTION<nowiki>==</nowiki>"add", SUBSYSTEM<nowiki>==</nowiki>"drivers", \
ENV{DEVPATH}<nowiki>==</nowiki>"/bus/usb-serial/drivers/ftdi_sio", \
ATTR{new_id}<nowiki>=</nowiki>"1c0c 0102"

<nowiki>#</nowiki> optionally create a convenience symlink for the console device
ACTION<nowiki>==</nowiki>"add", KERNEL<nowiki>==</nowiki>"ttyUSB*", \
ATTRS{interface}=="SheevaPlug JTAGKey FT2232D B", \
ATTRS{bInterfaceNumber}<nowiki>==</nowiki>"01", \
SYMLINK+="sheevaplug"
EOF}}
* Reset the device from the JTAG module (Mouton says: how? I tried to push the button, but that doesn't seem to reset the device... Do you mean login using the terminal emulator, and issue a reboot command..?)
* At the terminal, press enter a couple of seconds after boot to prevent it from booting using the onboard flash (Ubuntu). You should end up with a ''Marvell>>'' prompt.
* There are some commands you need to run to make it permanently boot from the USB port ('''NOTE:''' this step is only necessary once):
{{Code|setenv mainlineLinux yes
setenv arcNumber 2097
setenv bootargs_root 'root<nowiki>=</nowiki>/dev/sda1 rootdelay<nowiki>=</nowiki>15'
setenv bootcmd_usb 'usb start; ext2load usb 0:1 0x6400000 /boot/uImage'
setenv bootcmd 'setenv bootargs $(console) $(bootargs_root); run bootcmd_usb; bootm 0x6400000'
saveenv
reset}}
* In order to install the rootfs onto a flash or disk, mount the flash drive on a linux system and execute the [http://dl.amahi.org/marvell/create-clean-f12-disk.sh create-clean-f12-disk.sh] script. You'll need to have the [http://dl.amahi.org/marvell/amahi-marvell-0.5.tar.bz2 amahi-marvell-0.5.tar.bz2] file in the current directory. It may take a while, but this must be done before booting up the plug and installing Amahi.

'''NOTE:''' This script is very dangerous (it can destroy the machine it is run on if not used properly). You will need to change the partition destination.

* Insert USB Flash Drive into the plug.
* Once this is complete, the JTAG module can be disconnected. There will be no need for serial connection any longer. Once the USB Flash Drive is connected and the plug booted, you will be able to connect via SSH (default root password is "amahi").

= Connecting to a Plug on a Mac =

On Mac OS X, Install the [http://www.ftdichip.com/Drivers/VCP/MacOSX/FTDIUSBSerialDriver_v2_2_14.dmg FTDI driver], download [http://dl.dropbox.com/u/3022105/Amahi/sheeva/Info.plist.patch Info.plist.patch] to your desktop, then run the following commands to connect to the SheevaPlug console:
{{Code|sudo patch -p0 < ~/Desktop/Info.plist.patch
sudo kextunload /System/Library/Extensions/FTDIUSBSerialDriver.kext
sudo kextload /System/Library/Extensions/FTDIUSBSerialDriver.kext
screen /dev/tty.usbserial-[TAB]B 115200}}

For [TAB], hit the TAB key; the value there will be unique to each SheevaPlug computer, so TAB will allow you to auto-fill the correct value. Once connected, if you want to close your terminal session, hit Ctrl-A followed by Ctrl-K (or Shift-K on Linux). You'll be asked if you're sure you want to kill this window; just say yes!

= Amahi Install =

After booting from it,

* Configure a profile for the system in http://www.amahi.org. Pay attention to the IP of the HDA you configure. Let's call it PLUG_FIXED_IP.
* Ensure you have inserted the USB Flash Drive and boot the system
* Until we optimize things, it will take 4 or 5 minutes to boot the first time.
* The first time it boots, it will try to use DHCP. In my case, I configured a static IP so that when it boots with DHCP I know what IP it has. This may be different than the static you configured above.
Note that the sticker on the SP device with the MAC address on it is sometimes wrong. i.e. the MAC address your device will use will be different from the address on this sticker. Use nmap or ping -b to find new devices on your LAN, if you can't find it on your DHCP server.
* Access the installer via http://IP_OR_NAME_OF_THE_PLUG_IN_DHCP:2000/
* Wait patiently if it does not respond. This does require internet connectivity
* The installer takes about 1 minute to install with that :)
* Input the install code for that system
* When asked to, click the big red button to reboot
* The reboot will take a minute or two
* Access it with the configured IP: http://IP_OR_NAME_OF_THE_PLUG/
* First login: admin/amahi. I will ask you to reset the password the first time

'''NOTE:''' With about 1/8th of the rpms on a typical x86 install, you will experience a lot of failures with apps (VPN does not work, apps will be missing deps, etc. etc.).

= Using the onboard NAND flash as a swap drive =

{{Code|cfdisk /dev/mtdblock2}}
* Create a "Linux swap / Solaris" partition that takes all the space:
# remove any existing partitions, if any
# create a new primary partition
# select Type option, enter "82"
# select Write option
# select Quit option
{{Code|mkswap /dev/mtdblock2
echo "/dev/mtdblock2 swap swap defaults 0 0" >> /etc/fstab
swapon -a}}

= Reporting issues =

These are mostly what matter for debugging:
* {{Code|/root/hda-install.log}}
* {{Code|egrep -v 'POST<nowiki>|GET|</nowiki>progress' /tmp/amahi-ruby-install.log}}
* See [[SP_warboard]] for documented issues.

= Misc Notes =

* restarting rpm db in chrooted environment:
{{Code|rm /var/lib/rpm/__db*
rpm --rebuilddb -vv}}

= How to use two HDA on the same network =
[[How to use two HDA on the same network]]

Plug Tips and Tricks

2011-07-15T10:21:35Z

Mattwire:

Amahi Plug Edition

2011-07-15T10:15:48Z

Mattwire:

Amahi Plug Edition

2011-07-15T10:06:33Z

Mattwire:

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-openrdcdetails.aspx OpenRD 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'''
* [http://dl.amahi.org/marvell/create-amahi-f12-plug-disk.sh 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 [http://dl.amahi.org/marvell/ 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 [http://www.amahi.org/ 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)

; '''Step 3'''
: Install Amahi, by loading <code>http://plug_ip:2000</code> and entering the install code you got when you [https://www.amahi.org/user created your Amahi profile].

= Known issues =

For a list of working / not working apps for plug computers, see [[Plug Apps|Apps page]]. Also, please check and file any issues in the [http://bugs.amahi.org/projects/show/plug Amahi bug tracker project for the Plug port]

= Detailed Installation Instructions =

Fully detailed procedure.

== Step 1: Prepare your boot device ==

Connect your boot device (USB hard drive, USB flash drive, or SD card) into a working Linux machine (you can use your plug computer!)

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:
{| cellpadding="7"
! 2GB Flash Drive or SD Card
! 8GB Flash Drive or SD Card
! 16GB Flash Drive or SD Card
! USB Hard Drive (40+ GB)
|-
|2GB, unformatted
|512MB, Linux Swap 7.5GB, unformatted
|1GB, Linux Swap 15GB, unformatted
|2GB, Linux Swap The 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, if needed. It should contain the name of the Amahi ''rootfs'' file you downloaded. Example: '''rootfs="amahi-marvell-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'''.

<div style="border: 1px solid #B66; padding: .5em 1em; color: #000; background-color: #FEE; margin: 3px 3px 1em 3px;">
'''BIG WARNING! Putting the wrong partitions in this script will completely erase those partitions! Be careful what partitions you target!
</div>

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.

Find the plug computer IP address (check your router DHCP logs or DHCP server), and launch the Amahi installer by visiting http://plug_computer_ip:2000

(Use nmap or ping -b to find new devices on your LAN, if you can't find your plug computer IP address on your DHCP server.)

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).

== Enjoy ==

After it reboots, access your HDA by logging in at <code>http://plug_computer_ip</code> 

Username: admin
Password: amahi

The root password is: amahi 
(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.

You'll need to [[RenewIP|release and then renew the IP address]] of your client computers, once your old DHCP server is disabled.

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:

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 [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]]