__ __
\ \/ /___ __ __ ___ ___ ___ Useful Commands:
\ // _ \\ \/ /,-_ |/ _ |/ -_) remountrw - mount disk as read-write
\/ \___/ \ / \___,\_ |\___| remountro - mount disk as read-only
_/_/ _'_| remove.docs - remove all docs and manpages
{ V o y a g e } - L i n u x
< http://linux.voyage.hk > Version: 0.9
1. Introduction
======================
Voyage Linux is Debian derived distribution that is best run on a x86 embedded
platforms such as PC Engines ALIX/WRAP, Soekris 45xx/48xx and Atom-based boards.
It can also run on low-end x86 PC platforms. Typical installation requires
128MB disk space, although larger storage allows more packages to be installed.
Voyage Linux is so small that it is best suitable for running a full-feature
firewall, wireless access point, Asterisk/VoIP gateway, music player or network
storage device.
Currently, Voyage Linux has the following editions:
* Voyage Linux - the basic version
* Voyage MPD - Music Player Daemon
* Voyage ONE - VoIP software - Asterisk, dahdi etc
All editions are delivered as distribution tarball and Live CD in i386
architecture. AMD64 architecture is available for Voyage Linux only. We also
offer SDK to ease customizing Voyage Linux.
For more information about Voyage Linux, please visit:
http://linux.voyage.hk
2. Installation
======================
Download the Voyage Linux software package from
http://www.voyage.hk/download/voyage/
to a Linux machine.
extract the software tarball:
tar --numeric-owner -jxf voyage-.tar.bz2
as root, run the installation script:
cd voyage-
./usr/local/sbin/voyage.update
Before you run the installer you may have to format the disk device. Assuming
Compact Flash device on /dev/sda.
fdisk /dev/sda
mkfs.ext2 /dev/sda1
tune2fs -c 0 /dev/sda1
To save more spaces for not having reserved filesystem block, you may also run:
tune2fs -r 0 -c 0 /dev/sda1
There is a helper script in ./usr/local/sbin/format-cf.sh to ease formatting
and creation of ext2 file system. Use it at your own risk!
./usr/local/sbin/format-cf.sh /dev/sda
Voyage Linux now requires at least 128MB storage to run. However, more disk
space is recommended if you want to add more software and be able to run
"apt-get upgrade".
voyage.update scripts will ask you a couple of questions to complete the
installation:
1 - Create new Voyage Linux disk
2 - Update existing Voyage configuration
3 - Exit
Press 1 to install voyage to disk device. After all, you will be prompted to
the main installation menu. You should go through the menu item 1 - 6 in
sequence.
1 - Specify Distribution Directory
2 - Select Target Profile
3 - Select Target Disk
4 - Select Target Bootstrap Loader
5 - Configure Target Console
6 - Copy Distribution to Target
7 - Exit
It will take a short while (1-5 min.) to copy all files from software package to
disk device. The above configuration will be saved to .voyage.config. If you
run voyage.update next time, it will use same configuration as default.
Once Voyage Linux is booted up, you will be prompted for login. The default
root password is "voyage", please change the root password after first login.
# remountrw
# passwd
3. Configuration
======================
3.1 Network Interface
======================
By default, eth0 requests IP address using DHCP.
In /etc/network/interfaces,
auto eth0
iface eth0 inet dhcp
auto br0
iface br0 inet dhcp
bridge_ports eth0 eth1
This will create a bridge interface br0 with eth0 and eth1 as slave.
For wireless device configuration, edit /etc/network/interface and have
the follow interface configuration section:
# for nl80211 driver (e.g. ath5k, ath9k, p54pci)
auto wlan0
iface wlan0 inet static
address 10.1.10.1
netmask 255.255.255.0
broadcast 10.1.10.255
hostapd /etc/hostapd/hostapd.wlan0.conf
up nat.sh wlan0 eth0 "10.1.10.0/24"
Also see below for hostapd configuration:
# for hostap driver (Prism 2.5)
auto wlan0
iface wlan0 inet static
address 10.1.10.1
netmask 255.255.255.0
broadcast 10.1.10.255
up iwconfig wlan0 essid voyage mode Master
up nat.sh wlan0 eth0 "10.1.10.0/24"
Both enable wlan0 device as wireless interface in a separate network and the
wireless interface runs in NAT mode.
A friendly script, nat.sh, is located in /usr/local/sbin/, generates all
necessary iptables rules for NAT'ing interface. nat.sh is now integrated to
work with nocat. Syntax:
nat.sh