__ __
\ \/ /___ __ __ ___ ___ ___ 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.6
1. Introduction
======================
Voyage Linux is Debian derived distribution that is best run on a x86-based
embedded platforms such as WRAP, ALIX and Soekris 45xx/48xx 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, VoIP gateway and network storage device.
For more documentation about Voyage Linux, please visit wiki at
http://wiki.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
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 whlie (~1 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
======================
edit /etc/network/interface and uncomment the interface configuration section:
# for hostap driver
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"
To enable wlan0 device (for Prism 2.5/hostap driver)
# for atheros madwifi-ng driver
auto ath0
iface ath0 inet static
address 10.1.20.1
netmask 255.255.255.0
broadcast 10.1.20.255
madwifi-base wifi0
wireless-mode Master
up iwpriv ath0 mode 3
up iwconfig ath0 mode master
up iwconfig ath0 essid voyage
up iwconfig ath0 txpower auto
up iwconfig ath0 enc off
up iwconfig ath0 rate auto
up nat.sh ath0 eth0 "10.1.20.0/24"
To enable ath0 device (for Atheros/madwifi-ng driver)
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