Alix Voyage

A little How-To for installing Voyage onto a Alix Board.

General installation explanation can be found on the Voyage Readme.

Alix Board

Installation Voyage Linux

The installation of Voyage Linux needs a working Linux PC with a Compact Flash Card Reader. The commands hereafter are tested on a Lubuntu.

Get Voyage

First get sudo rights, create cf mounting place and download as well as untar voyage linux.

sudo su
mkdir /mnt/cf
cd /tmp/
wget http://mirror.voyage.hk/download/voyage/voyage-0.8.5.tar.bz2
tar --numeric-owner -jxvf voyage-0.8.5.tar.bz2

Prepare CF Card

Second the CF card need to be formatted with ext2. Be sure what device your CF Card is, otherwise you could erase your host linux. In this case the CF card was on /dev/sda.

fdisk /dev/sda
#   # Delete all old partitions
#   => d
#
#   # New partition using the whole CF card
#   => n -> p -> 1 -> first cylinder 1 -> last cylinder max (2015)
#
#   # Set boot flag
#   => a -> 1
#
#   # Check again
#   => p
#      Disk /dev/sda: 1039 MB, 1039933440 bytes
#      16 heads, 63 sectors/track, 2015 cylinders
#      Units = cylinders of 1008 * 512 = 516096 bytes
#      Sector size (logical/physical): 512 bytes / 512 bytes
#      I/O size (minimum/optimal): 512 bytes / 512 bytes
#      Disk identifier: 0x90909090
#
#      Device Boot      Start         End      Blocks   Id  System
#      /dev/sdb1   *           1        2015     1015528+  83  Linux
#
#   # Save changes and quit
#   => w
#
mkfs.ext2 /dev/sda1
tune2fs -c 0 /dev/sda1

Run Voyage installer script

cd voyage-0.8.5/
./usr/local/sbin/voyage.update

Go through all install menu, if you aren't sure just press enter.

What would you like to do?
	(default=1 [Create new Voyage Linux disk]):

Where is the Voyage Linux distribution directory?
	(default=/tmp/voyage-0.8.5):
	
What would you like to do?
	(default=2 [Select Target Profile]):

Please select Voyage profile:
	(default=6 [ALIX]):

What would you like to do?
	(default=3 [Select Target Disk]):
	
Which device accesses the target disk?
	/dev/sdb

Which partition should I use on /dev/sdb for the Voyage system [1]?
	1

Where can I mount the target disk [/mnt/cf]?
	/mnt/cf

What would you like to do?
	(default=4 [Select Target Bootstrap Loader]):
	
Which loader do you want (grub or lilo) [grub]?
	grub
	
Which partition is used for bootstrap [1]?
	1
	
What would you like to do?
	(default=5 [Configure Target Console]):
	
Select terminal type:
	(default=1 [Serial Terminal]):
	
Please choose speed:
	(default=5 [38400]):
	
What would you like to do?
	(default=6 [Partition and Create Filesystem]):
	
What shall I do with your Flash Media?
	(default=1 [Partition Flash Media and Create Filesystem]):

What would you like to do?
	(default=7 [Copy Distribution to Target]):

Start Voyage

Put your CF card in your Alix board and start it. The first time it takes a couple of minutes because it will connect over dhcp and generate a ssh key pair.

Afterwards find out the IP Address and connect via SSH onto the machine. The default user is root and it's default password is voyage.

System

After the system is install and the first contact established some important setting need to be done.

Make system RW

At first the system is read only. So in order to to the following stuff below you need to make your system Read and Writable.

remountrw

Change password

passwd

Change hostname

hostname NEW_HOSTNAME
echo "NEW_HOSTNAME" > /etc/hostname 
echo "127.0.0.1 NEW_HOSTNAME" >> /etc/hosts

Update system

# APT Repo-Infos updaten
apt-get update
# install important packages
# sonst Fehler: debconf: (debconf: (No usable dialog-like program is installed,
#               so the dialog based frontend cannot be used. at
#               /usr/share/perl5/Debconf/FrontEnd/Dialog.pm line 75, <> line 2.)
apt-get install dialog
# get aptitude
apt-get install aptitude
# remove lilo (we're using grub)
aptitude remove lilo
# update packages
aptitude safe-upgrade

Install NTP

# NTP Package installieren
apt-get install ntp
# /etc/ntp.conf anpassen
   # drift-file in tmpfs umlegen
   driftfile /var/tmp/ntp/ntp.drift
# NTPd neu starten
/etc/init.d/ntp restart
# NTP Abfrage einmalig starten und Zeit aktualisieren
# -q: einmal Abfrage starten
# -g: Zeit auch syncen wenn mehr als 1000 Sekunden Abweichung
ntpd -q -g

Change system timezone

dpkg-reconfigure tzdata

Setup SSH

Setup Dyndns Client

Setup Wireless Card Client

If you run nl80211 compatible wireless driver, e.g. ath5k, ath9k, p54pci, in my case the Atheros compatible Wistron DCMA81 Atheros 802.11a/b/g miniPCI wireless card and want the board to connect to an existing wireless access point or router in your network, add the interface with the following lines in /etc/network/interfaces:

For WPA1 Key

/etc/network/interfaces
auto wlan0
iface wlan0 inet dhcp
        wpa-driver wext
        wpa-ssid "<your ssid>"
        wpa-psk "<your WPA shared key>"
        wpa-key-mgmt WPA-PSK
        wpa-pairwise TKIP
        wpa-group TKIP
        wpa-proto WPA
        wireless-mode Managed

For WPA2 Key

/etc/network/interfaces
auto wlan0
iface wlan0 inet dhcp
        wpa-driver wext
        wpa-ssid "<your ssid>"
        wpa-psk "<your WPA shared key>"
        wpa-key-mgmt WPA-PSK
        wpa-pairwise CCMP TKIP
        wpa-group CCMP TKIP
        wpa-proto RSN
        wireless-mode Managed

Then run:

ifup wlan0

to connect to the wireless access point / router now. The above settings also automatically connect to wireless access point / router after reboot.

Optional

Install "important" stuff

apt-get install nano ffmpeg imagemagick gphoto2

Remove doc's & man's (~150MB)

remove.docs

Backup/Restore Image

Once your set up you can create an image of the CF card, for a later restore of the PC.

Create image

# read of /dev/sda and write image to /tmp/file.img
dd if=/dev/sda of=/tmp/file.img

Restore image

# read of /tmp/file.img and write to /dev/sda
dd if=/tmp/file.img of=/dev/sda