Voyage Linuxon
Voyage MPDon
Voyage MuBoxon

You are hereBlogs

Blogs


Getting Started (v0.6.x)

 __  __
 \ \/ /___ __  __ ___  ___  ___    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   
	
	 - a tag to identify the NAT interface, no need to be a real 
		device name, but should be unqiue if multiple NAT devices are 
		configured
	 - the outbound device name for NAT
	 - the IP network with mask for NAT

3.2 DHCP/DNS - dnsmasq
======================
DHCP support from dnsmasq is now enabled by default. 

Edit /etc/dnsmasq.more.conf and there are following lines:

dhcp-leasefile=/var/tmp/dnsmasq.leases
dhcp-range=wlan0,10.1.10.10,10.1.10.250,24h
dhcp-range=eth1,10.1.20.10,10.1.20.250,24h
dhcp-range=eth2,10.1.30.10,10.1.30.250,24h
dhcp-range=eth3,10.1.40.10,10.1.40.250,24h

dnsmasq will provide IP address lease 10.1.10.10-250, 10.1.20.10-250, 
10.1.30.10-250, 10.1.40.10-250.

Comment out all the lines in /etc/dnsmasq.more.conf to disable DHCP in dnsmasq.

3.3 Hostap
======================
Kernel source was patched to include the current driver version 0.4.7 for 
2.6.8 and 2.6.12 voyage kernels.  Starting from 2.6.14, it is included in 
stock kernel.  The hostap driver in all voyage kernels has 
PRISM2_NON_VOLATILE_DOWNLOAD enabled to allow non-volatile flashing of 
firmware.  

(http://hostap.epitest.fi/)

3.4 Prism54
======================
Prism54 driver is included in voyage kernel.  Voyage Linux already bundled 
the required firmware in /usr/lib/hotplug/firmware/isl3890.

(http://www.prism54.org)

3.5 Madwifi
======================
Voyage distro is now using madwifi-ng driver as default.  
To configure atheros device, the full interface definition should look like:

    auto ath0
	iface ath0 inet static
	        address 10.1.20.1
	        netmask 255.255.255.0
	        broadcast 10.1.20.255
	        madwifi-base wifi1
	        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"
	
Please note tht voyage kernel does not comes with madwifi driver anymore.  
Instead, they are available in separate module package.  

madwifi-ng has the default auto create option which will create the VAP device 
in STA mode.  To disable autocreate option, in /etc/modules you can add:

   ath_pci autocreate=none
   
or add a new files /etc/modprobe.d/madwifi with the followng line:

   options ath_pci autocreate=none

(http://www.madwifi.org)

3.5 Bridging 
====================== 
The most common way to WDS bridge wireless (ath0 & ath1), LAN (eth0) as follow:

	auto br0
	iface br0 inet static
	       address 192.168.1.2
	       netmask 255.255.255.0
	       network 192.168.1.0
	       broadcast 192.168.1.255
	       gateway 192.168.1.1
	       bridge_ports eth0 ath0 ath1
	       pre-up wlanconfig ath0 create wlandev wifi0 wlanmode ap
	       pre-up wlanconfig ath1 create wlandev wifi0 wlanmode wds
	       pre-up iwpriv ath0 mode 11g
	       pre-up iwconfig ath0 essid "voyage-wds" channel 1
	       up ifconfig ath0 down ; ifconfig ath0 up # this is a workaround
	       up iwpriv ath1 wds 1
	       up iwpriv ath1 wds_add AA:BB:CC:DD:EE:FF
	       up ifconfig ath1 down ; ifconfig ath1 up # this is a workaround
	       post-down wlanconfig ath0 destroy
	       post-down wlanconfig ath1 destroy
	       
Removing the ath1 (WDS VAP) line, a simple wireless bridge is setup instead.

There are some samples in /etc/network/interface to ease the setup of bridge.

3.6 NoCatSplash
======================
NoCatSplash is included in Voyage Linux, but it is disabled by default.  Edit 
/etc/default/nocatsplash and set ENABLE="true" to enable it.  You will can start 
or stop NoCatSplash by 
	/etc/init.d/nocatsplash [start|stop]
	
Next, you will also need to edit /etc/nocat.conf to setup NoCatSplash properly.  
The most common way is to add the following lines at the end of /etc/nocat.conf:
ExternalDevice  eth0  
InternalDevice  wlan0
LocalNetwork    10.1.10.0/24

Make sure that wlan0 matches the LocalNetwork IP address, you should double-
check that from ifconfig.

3.7 NoCatAuth
======================
NoCatAuth is not included in Voyage Linux.  However, it can be installed by 
running:
	apt-get install nocatauth-gateway
	
Same as NoCatSplash, set ENABLE="true" in /etc/default/nocatauth-gateway to 
enable it in boot up.   Note that nocat.conf is located in 
/etc/nocatauth/gateway and the most common to configure nocatauth-gateway is 
appending the following to nocat.conf:

ExternalDevice  eth0  
InternalDevice  wlan0
LocalNetwork    10.1.10.0/24

You may also want to touch GatewayMode (default=Passive):
GatewayMode [Passive|Captive|Open]

It is better to un-install NoCatSplash by "apt-get remove nocatsplash" and 
"rm /etc/nocat.conf" explicitly to avoid confusion.

As nocatauth requires perl to run, you are required to have a larger disk space 
to run (probably 128MB).  Please also make sure that you can only run either 
NoCatSplash or NoCatAuth, not both.

3.8 Hostapd
======================
To enable hostapd, edit /etc/default/hostapd and add the following line:

RUN_DAEMON="yes"

A sample /etc/hostapd/hostapd.conf is like below:

#bridge=br0   #uncomment this line if bridged.
interface=ath0
driver=madwifi
logger_syslog=-1
logger_syslog_level=2
logger_stdout=-1
logger_stdout_level=2
debug=4
dump_file=/tmp/hostapd.dump
ctrl_interface=/var/run/hostapd
ctrl_interface_group=0
macaddr_acl=0
auth_algs=3
eapol_key_index_workaround=0
eap_server=0
wpa=3
ssid=voyage-wds
wpa_passphrase=voyage-wds
wpa_key_mgmt=WPA-PSK
wpa_pairwise=TKIP
eapol_version=1
 

3.9 wpa-supplicant
======================

If you want to connect to a WPA-PSK enabled AP, first generate the 
/etc/wpa_suppliant.conf.  For example, if the essid and pre-shared key are 
both "voyage-wds", execute the following commands:

# wpa_passphrase voyage-wds voyage-wds>> /etc/wpa_supplicant/wpa_supplicant.conf

Then, edit /etc/wpa_supplicant/wpa_supplicant.conf and adding key_mgmt and 
proto parameters:

network={
    ssid="voyage-wds"
    #psk="voyage-wds"
    psk=76ab47787aa8b560895f617dd351ad9d32faa86232f5366b6554832073d07481
    key_mgmt=WPA-PSK
    proto=WPA
#   proto=RSN	# uncomment for WPA2
}

Edit /etc/network/interfaces and add the following entries:

auto ath0
iface ath0 inet dhcp
        madwifi-base wifi0
        wireless-mode Managed
        wpa-conf /etc/wpa_supplicant/wpa_supplicant.conf

This will create ath0 for wifi0 devices, using the specified wpa_supplicant.conf

3.10 LED Support
======================
Voyage kernel >= 2.6.23 (as in Voyage 0.5) comes with LED driver for WRAP, ALIX 
and Soekris 48xx boards.

To enable LED control, simply load the corresponding kernel module
	# modprobe leds-alix (for ALIX)
	# modprobe leds-wrap (for WRAP)
	# modprobe leds-net48xx (for Soekris 48xx)

LED could then be controlled in /sys/class/leds/:#. For example,

To turn on LED on ALIX:
	# echo 1 > /sys/class/leds/alix\:1/brightness
	# echo 1 > /sys/class/leds/alix\:2/brightness
	# echo 1 > /sys/class/leds/alix\:3/brightness

To turn off LED:
	# echo 0 > /sys/class/leds/alix\:1/brightness
	# echo 0 > /sys/class/leds/alix\:2/brightness
	# echo 0 > /sys/class/leds/alix\:3/brightness

There are more interesting feature for LED control, first load the following 
LED trigger modules:
	# modprobe ledtrig-heartbeat
	# modprobe ledtrig-timer

1. enable LED1 for heartbeat trigger - higher the load, faster it blinks
	# echo heartbeat > /sys/class/leds/alix\:1/trigger

2. enable LED2 to show ide disk activity
	# echo ide-disk > /sys/class/leds/alix\:2/trigger

3. enable LED3 for net device, on eth0 for link, send and receive
	echo netdev > /sys/class/leds/alix\:3/trigger
	echo eth0 > /sys/class/leds/alix\:3/device_name
   	echo "link tx rx" > /sys/class/leds/alix\:3/mode

4. enable LED3 for timer-based control, 1 sec on, 5 sec off
	# echo timer > /sys/class/leds/alix\:3/trigger
	# echo 1000 >  /sys/class/leds/alix\:3/delay_on
	# echo 5000 >  /sys/class/leds/alix\:3/delay_off

to turn off trigger
	# echo none > /sys/class/leds/alix\:1/trigger
	# echo none > /sys/class/leds/alix\:2/trigger
	# echo none > /sys/class/leds/alix\:3/trigger 
	
In 0.5.1, if ALIX and WRAP install profile is selected, heartbeat and ide-disk 
driver will be automatically enabled at boot. To disable this feature, edit
/etc/default/voyage-util and update VOYAGE_LED variable to "NO":
	VOYAGE_LEDS="NO"

4. Board-specific Notes
=======================

4.1 WRAP support
======================

4.1.1 Watchdog for WRAP
=======================
For WRAP board, wd1100 has been ported to kernel 2.6.  If you choose WRAP
option in voyage.update, wd1100 driver will be added to /etc/module.  

To load wd1100 to kernel, run the following commands:

	modprobe wd1100
	echo 0 > /proc/sys/dev/wd/graceful
	echo 30 > /proc/sys/dev/wd/timeout
or
	modprobe wd1100 sysctl_wd_graceful=0 sysctl_wd_timeout=30

This will set timeout value to 30 seconds.  

You will have to restart watchdog userland program to activate watchdog timer
	/etc/init.d/watchdog restart

In addition, you will need to make sure that /etc/watchdog.conf is properly 
configured.  For above watchdog module configuration for WRAP, the following 
settings should do:

watchdog-device = /dev/watchdog
interval	    = 15

And make sure the watchdog device is available:
	
	mknod -m 600 /dev/watchdog c 10 130

You may also add the following line to /etc/modules to enable loading wd1100 
driver at startup: 
	
	wd1100 sysctl_wd_graceful=0 sysctl_wd_timeout=30

To test watchdog module, you can try to stop the watchdog userland program.
	/etc/init.d/watchdog stop
The hardware will restart after 30 seconds at most.

4.1.2 Temperature sensors for WRAP
==================================
If you choose WRAP in voyage.update, the required modules would be added
to /etc/modules.  It adds the following modules in /etc/modules:
	scx200_acb base=0x810,0x820
	lm77

You will find a new driver in /sys/bus/i2c/drivers/lm77/.  To read the 
temperature, 
	cat /sys/class/i2c-adapter/i2c-1/1-0048/temp1_input

Divide the temps by 1000 you will get the temperature reading in Celcius.  
Unfortunately, the temperature reading can not be retrieved using "sensors" util.

Please note that latest WRAP2D/E does not host lm77 sensor anymore.
------------------------------------------
If you are using commodity hardware other than WRAP, the easiest way would be 
installing lm-sensors package by
	
	apt-get install lm-sensors
	
and then run sensors-detect

4.2 ALIX support
======================

4.2.1 Temperature sensors for ALIX.1 and ALIX2/3
================================================
When running Voyage Linux with ALIX, choose ALIX profile in voyage update,
the required modules would be added to /etc/modules.  It adds the following 
modules in /etc/modules:
	w83627hf 
	lm90
	geodewdt
	
ALIX.1 board uses w83627hf driver while ALIX.2/3 uses lm90.  You can get the 
temperature reading from sensors program, or get the values from sysfs:

(for ALIX.1)
	cat /sys/devices/platform/w83627hf.656/temp1_input
	cat /sys/devices/platform/w83627hf.656/temp2_input
	cat /sys/devices/platform/w83627hf.656/temp3_input


You may also use sensors utility to get the temperature reading.  If temp1 
reading may not be ready at boot up, you need to modify w83627hf section in 
/etc/sensors.conf:

chip "w83782d-*" "w83627hf-*"
...
	set sensor1 1
	
Known Issue: the readings returned from w83627hf is not very accurate.  temp1 
reading is too low (~30C) and some offset should be applied.  But temp1 reading 
can move down to 20C if you apply cooling agent on the Geode processor.  temp2 
and temp3 do not move up or down too much at idle or under high low.

(for ALIX.2/3)
	cat /sys/class/i2c-adapter/i2c-0/0-004c/temp1_input
	cat /sys/class/i2c-adapter/i2c-0/0-004c/temp2_input

4.2.2 Geode Watchdog driver for ALIX
====================================
Voyage Linux comes with geodewdt driver that uses the multi-function general 
purpose timer in CS5536 for watchdog timer.  To use geodewdt driver, load 
geodewdt driver or add geodewdt to /etc/modules.  Restart watchdog daemon to 
make it effective.

There was a known issue in Voyage 0.4.1 with ALIX.2/3b boards.  It has been 
identified that Voyage 0.4.1 cannot be booted successfully on ALIX.2/3b board 
with some BIOS versions.  Voyage 0.4.1 kernel has in-kernel, geode-specific 
codes that enables the multi-purpose general function timer (mfgpt), which is 
required for the watchdog driver. The kernel code works properly on Alix.1c 
board. However, the same piece of code may not work on Alix.2/3 and will 
encounter boot hang.

There are three workarounds.
1. Use Voyage 0.4.0 instead of 0.4.1
2. Uses 0.94 or later TinyBIOS with "MFGPT workaround" set to ON
3. Use ALIX.1c instead of ALIX.2/3b board for running Voyage Linux 0.4.1. 

Voyage 0.5 with kernel 2.6.23 comes with a new implementation of mfgpt code 
that no longer requires "MFGPT workaround".  Hence, "MFGPT workaround" 
in TinyBIOS must set to OFF.  Otherwise, same bootup hang will be encountered.  
Care must be taken to turn off "MFGPT workaround" if you upgrade from 0.4.1 to 
0.5.

5. General Issues
======================

  What are the serial port console settings:
	- In 0.3, voyage.update provides options for serial port settings
	- In 0.2 or before, the serial port console must be set at ==> 9600 N 8 1

  Where are the files stored that need to be read-write:
	- Initially they are stored on /ro, at boot time they are copied over to 
	  a dynamic ram drive (limited to 8 Mb) at /rw.
	  Files are then symlinked to the /rw.

  How can I add a program:
	- use "apt-get install " of course

  How can I add a file or install a program from sources (without using apt-get)
  so it comes up every time I boot:
	- /usr/local/sbin/remountrw to allow Read-Write
	- Move the file or the program to it's location in /ro
	- Symlink the file's original location to /rw
	- fastreboot

	EXAMPLE:
	You install "webmin" from sources, the miniserver is in /var/webmin 
	directory, configuration files are in /etc/webmin directory and the start on
	is in /etc/init.d/webmin :

	- move /var/webmin directory to /ro/var/webmin
	- symlink in the original /var to /rw//var/webmin
	- create a symlink in /etc/rcS.d/ to start automagically as last one at boot time

	#remountrw
	#mv /var/webmin /ro/var/webmin
	#ln -s /rw//var/webmin /var/webmin
	#ln -s /etc/init.d/webmin /etc/rcS.d/S56webmin
	#fastreboot

Please find the community wiki (wike.voyage.hk) for more information

6. Support
======================

Wiki Documentation - http://wiki.voyage.hk

6.1 Mailing Lists
======================
A mailing list is setup for discussing supporting and development issues for 
Voyage Linux:

To subscribe, send an empty message to :
	voyage-linux-subscribe@list.voyage.hk 
	
To unsubscribe, send an empty message to :
	voyage-linux-unsubscribe@list.voyage.hk 
	
To post a message, send mail to :
	voyage-linux@list.voyage.hk 
	
The list archives can be viewed and searched at :
	http://list.voyage.hk/pipermail/voyage-linux/

6.2 Development (0.6 or later)
======================
Starting from 0.6.0, Voyage Linux is built by Debian Live.  You can find
the subversion repository for Debian Live config in:

http://svn.voyage.hk/repos/voyage/trunk/voyage-live

Getting start to build Voyage Linux under Debian r5.0(lenny) or Voyage SDK:
# apt-get install live-helper
# svn co http://svn.voyage.hk/repos/voyage/trunk/voyage-live voyage-live
# cd voyage-live
# ./build.sh iso 	<= this will build the Live CD
# ./build.sh tar 	<= this will build .tar.bz2 distro
# ./build.sh sdk 	<= this will build sdk Live CD

6.3 Development (0.5 or before)
======================
Voyage Linux is completely buildable through customization framework. You can 
access the CVS Web Repository at: 
	http://cvs.voyage.hk/cgi-bin/viewcvs.cgi/
	
Currently, only voyage-custom project is under development.

There is no plan to provide public access for the CVS repository.  Only 
Web access is available in this moment. However, to encourage development 
nightly tarball is accessible to everyone at:
	http://www.voyage.hk/download/nightly/
	
If you have made chanages to Voyage Linux and the supporting scripts, you 
are encouraged to send all patches to voyage-linux@list.voyage.hk

Voyage includes customization script to allow customizing voyage distro. 
It allows system integrator or interest parties to customize voyage linux 
to roll out their own version based on voyage.

*** customization script only works for Voyage 0.3-0.5 versions.  Support for
0.6 is not yet verified and tested.

voyage-custom.sh syntax:

	voyage-custom.sh  

For example,

	voyage-custom.sh  /myproj

This will generate the customization distro called voyage-myproj in the 
current directory .

To build the sample "voyage-mesh" distro using customization script:

	/usr/share/voyage-custom/voyage-custom.sh \
		 \
		/usr/share/voyage-custom/src/mesh

Please note that the script is very experimental and is not tested heavily.  
It is also assumed that you run the script under Debian.  So, it may not work 
under other Linux distribution.  Use it at your own risk!

For more on how to make a customization disto, please read:
	/usr/share/voyage-custom/src/README
or
	http://wiki.voyage.hk/dokuwiki/doku.php?id=customization
	
The customization scripts can also be found in CVS and nightly tarball as well.

6.4 Known Issues
======================
- when running madwifi driver with AP mode, stuck beacon problem may occur:
    wifi0: ath_bstuck_tasklet: Stuck beacon; resetting (beacon miss )
  When this error happens, sometime it is not recoverable.  After some test,
  it is found that the most stable vesion is 0.9.4-rc2, fallback by:
 # wget http://www.voyage.hk/dists/0.6/madwifi/madwifi-modules-2.6.26-486-voyage_0.9.4~rc2-1+6.0-3_i386.deb
 # apt-get install madwifi-modules-2.6.26-486-voyage_0.9.4~rc2-1+6.0-3_i386.deb
  
- If Voyage cannot boot complaining rootfs can't be located, tty to added the 
following to the kernel boot parameters:
	"ide=nodma all_generic_ide"

- Sometimes, grub boot screen may not appear after BIOS post if the boot
partition is too large (~4GB).  Creating a smaller boot partition (512MB) and 
install Voyage to it may solve this issue.

- There have been repeatedly reported problem for lilo installation problem
while voyage.update is installing lilo bootloader to the flash media.  This
problem should have be fixed in Voyage 0.5.  If you encounter a similar 
problem again, please report to voyage-linux mailing list.

- In case you encountered locale and dialog complain when installing package
via "apt-get install", you can carry out the following commands to get rid
of the error message:
	apt-get install dialog apt-utils

- There is a problem reported when installing voyage over usb device using ub 
kernel module.  Moreover, it is assumed that voyage is installed in /dev/hda1
of the target platform.  

6.5 Live CD and PXE boot
======================
Voyage Live CD is now available for every stable voyage release:
	http://www.voyage.hk/download/ISO/
	
Daily build Live CD is also available at:
	http://www.voyage.hk/download/ISO/voyage-current.iso

You can run the Live CD under VMWare for testing purpose.  In addition, it
can act as a installation CD and PXE boot server as well.

You can find README.live-cd and README.pxe from the root direcory of Live CD.
	
6.6 TODOs
======================
1. light-weighted web server (thttpd + php) for system configuration
2. further reducing in size
3. scripts for setting up network configuration

7. Appendix
======================

7.1 Release History
======================
	Voyage 0.6
    * [2010-02-17] voyage-0.6.5
    * [2009-07-07] voyage-0.6.2
    * [2009-02-17] voyage-0.6.1
    * [2008-12-30] voyage-0.6.0
    
	Voyage 0.5
    * [2008-06-29] voyage-0.5.2
    * [2008-06-23] voyage-0.5.1
    * [2008-02-29] voyage-0.5.0
    
    Voyage 0.4
    * [2007-07-23] voyage-0.4.1
    * [2007-06-23] voyage-0.4.0
    
    Voyage 0.3
    * [2007-04-14] voyage-0.3.1
    * [2007-03-20] voyage-0.3
    * [2007-01-28] voyage-0.3pre3
    * [2006-12-05] voyage-0.3pre2
    * [2006-11-17] voyage-0.3pre1
    
    Voyage 0.2
    * [2006-04-05] voyage-0.2
    * [2006-02-25] voyage-0.2pre4
    * [2006-02-05] voyage-0.2pre3
    * [2006-01-06] voyage-0.2pre2
    * [2005-07-21] voyage-0.2pre1
    
    Voyage 0.1
    * [2005-07-07] voyage-0.1sarge
    * [2005-02-14] voyage-0.1
    * [2005-02-01] voyage-0.1pre5
    * [2005-01-19] voyage-0.1pre4
    * [2005-01-13] voyage-0.1pre3
    * [2005-01-06] voyage-0.1pre2
    * [2005-01-02] voyage-0.1pre1

7.1 Corresponding Debian and Kernel release
======================
    * Lenny, 2.6.30 - Voyage 0.6.5
	* Lenny, 2.6.26 - Voyage 0.6
	* Etch,  2.6.23 - Voyage 0.5
	* Etch,  2.6.20 - Voyage 0.4
	* Etch,  2.6.17 - Voyage 0.3
	* Sarge, 2.6.15 - Voyage 0.2
	* Sarge, 2.6.8 - Voyage 0.1
	
======================
Last Updated: 20100217
======================

Voyage ONE 0.5.2 released

Voyage ONE was an un-released special edition of Voyage Linux which was developed in 2008. It is aimed at providing most usable server software and make Voyage Linux as a complete, usable product for any embedded x86 platform.

We now decided to make it available for public download.

voyage-one-0.5.2.tar.bz2 [2009-11-23]

Voyage ONE is based on Voyage Linux 0.5.2 version and it includes the following features:

  • VoIP : asterisk zaptel
  • VPN and tunneling : vtun openvpn stunnel
  • Meshing : AWDS batmand olsrd
  • Others: aprtables iperf usbutils gpsd ntp quagga snmpd

To access asterisk-gui,

    http://<voyage IP>:8088/asterisk/static/index.html
    username: admin
    password: voyage

We would like hear your comments about Voyage ONE and discuss its possibilities.
In future, we will continue to develop Voyage ONE based on latest Voyage Linux.
Please post your feedback to the community mailing-list.

Getting Started (v0.5.x)



404 Not Found

Not Found

The requested URL /cgi-bin/viewvc.cgi/*checkout*/voyage-custom/src/stage1/overlay_fs/README was not found on this server.


Apache/2.2.22 (Debian) DAV/2 SVN/1.6.17 PHP/5.4.41-0+deb7u1 Server at cvs.voyage.hk Port 80

Voyage Linux 0.6.2 released

Voyage 0.6.2 is released and its goal is approaching stable.

We want to move 0.6.2 to stable as soon as possible in order to start 0.7 development with a newer kernel. Tmpfs now replaces aufs, so all modification on /var/log etc. will go to tmpfs and sync back to disk at shutdown. To sync back to disk manually while running, run:

# remountrw
# /etc/init.d/voyage-sync sync
# remountro

If you want to add more directories to tmpfs, modify VOYAGE_SYNC_DIRS in /etc/default/voyage-util.

Madwifi driver is upgraded to r4022 trunk with free hal. However, "stuck beacon" issue still exists in madwifi driver when running AP mode. Fall back to stable 0.9.4rc2 version by:

# wget http://www.voyage.hk/dists/0.6/madwifi/madwifi-modules-2.6.26-486-voyage
_0.9.4~rc2-1+6.0-3_i386.deb
# dpkg -i madwifi-modules-2.6.26-486-voyage_0.9.4~rc2-1+6.0-3_i386.deb

Support or get involved in Voyage Linux!

Voyage Linux / Features

Voyage Linux is Debian derived distribution that is best run on a x86 embedded platforms such as PC Engines ALIX/WRAP, Soekris 45xx/48xx/65xx and Atom-based boards.

It can also run on low-end x86 PC platforms. Typical installation requires 256MB 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.

Latest versions:

Daily snapshot:

For faster download, please download from mirror sites

See README for installation instructions and further information. Follow this page for Live-CD instructions.

Develop

The SDK provides development tools and libraries needed to build Voyage Linux distro, Live CD, Debian package and the kernel.

Download and Installing SDK Live CD

The easiest way to develop and customize Voyage Linux is using the SDK Live CD. The SDK Live CD is available for download in this directory or from mirror sites.

To install, follows Voyage Linux's getting start guide for detailed instructions.

If you are using Windows workstation, you are advised to installed the SDK to VMWare, VirtualBox or QEMU.

Building Voyage Linux using SDK or Debian Live

Starting from 0.6.0, Voyage Linux is built by Debian Live. You can find
the subversion repository for Debian Live config in:

Getting start to build Voyage Linux using Voyage SDK. If you are not using Voyage SDK, you need a Debian GNU/Linux system with live-build package installed. Check out a copy of Debian Live configuration from subversion repository and build the Voyage Linux by:

# svn co http://svn.voyage.hk/repos/voyage/trunk/voyage-live voyage-live
# cd voyage-live
# ./build.sh iso 	<= this will build the Live CD
# ./build.sh tar 	<= this will build .tar.bz2 distro
# ./build.sh sdk 	<= this will build sdk Live CD

For customizing Voyage Live for your own need, please refer to Debian Live Wiki and manual.

Voyage Linux 0.6.1 released

Along with Debian Lenny r5.0, we release Voyage 0.6.1 as promised.

voyage-0.6.1.tar.bz2 [2009-02-19] [Live CD] [README] [CHANGELOG]

0.6.1 is still a development release as there has been some reported issues on madwifi driver, voyage-sync aufs, etc. We are hoping that 0.6.2 would improve the stability in these areas.

0.6.1 also includes amd64 port for x86 64-bit systems as well as SDK for the first time. Both amd64 and SDK are in experimental stage and only limited testing has been carried out. SDK details and usage instructions will be updated on this site later.

Support or get involved in Voyage Linux!

Donation

If you found Voyage Linux useful or you have been making money by using it, please express your appreciation and encourage further work on this project via donation.
(Please note that your donation will be shown as payment - a limitation for donation to HK by Paypal.)

- credit card/PayPal balance

You can also consider buying products from Voyage Store or sponsor a mirror download site.

Thank you
We would like to thank the following companies and individuals for their generous support of the Voyage Linux:

Hardware donors and development support

    Name Donation / Sponsorship
    Squeeze-upgrade
    Linear power supply for Squeezebox Touch 5V
    Linear power supply for CA DacMagic 12V
    Switch-mode upgrade Arcam rDAC
    Cubieboard.org
    Cubieboard2 developer unit
    development and testing support
    exD Audio
    USB-DSD developer unit
    development and testing support
    HifiBerry
    DAC+
    high-resolution digital-to-analog converter for the Raspberry Pi Model B+
    Kevin Li
    Money donation for BeagleBone Black sponsorship
    Soekris Engineering net6501 board and standard cases
    Power supplies, 4GB USB drive and 2.5" SATA drive mounting kit
    SolidRun
    CuBox-i Carrier-1 development platform
    CuBox development unit
    discount for equipments
    PCEngines
    early access to APU platform
    various ALIX hardware
    802.11n wireless hardware
    discount for equipments
    development support
    OpenVox
    VoIP hardware - IPC100 board, IX100 board, A400M, B100M and B400M
    development support
    XMOS
    XMOS USB Audio 2.0 Development Kit

Service and Hosting

    Name Donation
    Mike O'Connor reliable virtual server for primary mirror, wiki hosting, and mailing list smarthost
    Yiorgos Adamopoulos
    Alexandros C. Couloumbis
    reliable mail exchange and spam filter for mailing list
    William M. Brack full access to US mirror host

Mirror Sponsor

Cash Donation
... are listed in reverse chronological order (>= US$50 are bold):

  • 2015-06-18 - Haruto Iba - JP
  • 2015-05-05 - Billy Cheung - HK
  • 2015-04-25 - Yawarra Information Appliances - AU
  • 2015-03-10 - Chernyshev Sergey - RU
  • 2015-02-26 - Ralf Herzog - DE
  • 2014-12-13 - Yawarra Information Appliances - AU
  • 2014-11-21 - Billy Cheung - HK
  • 2014-11-16 - Arnaud CADÈNES - FR
  • 2014-11-07 - Yawarra Information Appliances - AU
  • 2014-10-05 - Yawarra Information Appliances - AU
  • 2014-10-02 - Marián Mikušík - SK
  • 2014-09-18 - Mark Cohen - US
  • 2014-09-04 - Yawarra Information Appliances - AU
  • 2014-08-22 - Josef Ender - CH
  • 2014-08-01 - Dalimil Gala - CZ
  • 2014-06-04 - Robert Stecher - DE
  • 2014-05-05 - Christopher Hermansen - CA
  • 2014-05-01 - Andre Saischowa - DE
  • 2014-04-18 - Sang Hoon Bing - KR
  • 2014-04-11 - Simone Reuter - CH
  • 2014-02-18 - Pasechnik Yuri - RU
  • 2014-02-11 - Tsuneari Uda - JP
  • 2014-01-30 - Ralf Herzog - DE
  • 2014-01-09 - Gutehall Stefan - HK
  • 2013-11-21 - Matthias Wieser - DE
  • 2013-11-05 - Bruno Amsler - CH
  • 2013-11-01 - Erik Ahasverusen - DK
  • 2013-10-31 - Mike Carlton - US
  • 2013-09-27 - K K H Li - US
  • 2013-09-25 - CHU YIK CHI - HK
  • 2013-09-18 - Aoki Hidehiko - JP
  • 2013-09-05 - Bruce D'Arcus - US
  • 2013-08-10 - Adam Dabrowski - UK
  • 2013-08-09 - Wendell Butz - US
  • 2013-07-14 - Igor Vasilkov - RU
  • 2013-07-13 - Kawate Masayuki - JP
  • 2012-10-04 - Computer Audiophile - US
  • 2012-09-17 - Takayuki Shiose - JP
  • 2012-09-08 - Justin Clark - US
  • 2012-09-01 - Martin Macek - CZ
  • 2012-08-26 - Jacob Hallenborg - SE
  • 2012-07-11 - Robert Svec - US
  • 2012-06-18 - Adriano Santos - BR
  • 2012-05-28 - Suzuki Mitsugu - JP
  • 2012-05-02 - Erik Ahasverusen- DK
  • 2012-04-07 - Geoffrey Merck - FR
  • 2012-04-03 - Justin Foreman - US
  • 2012-03-13 - Derek Roach - US
  • 2012-02-24 - Jaroslaw Morawski - PL
  • 2012-02-14 - John Lin - US
  • 2012-02-07 - Carsten Steckel - DE
  • 2012-01-22 - Dirk De Groen - BE
  • 2012-01-21 - Ivan Karev - CH
  • 2012-01-05 - Ulf Tisting - SE
  • 2012-01-01 - Tadashi Yamaguchi - JP
  • 2011-12-24 - Evert Verduin - NL
  • 2011-12-06 - David Moorhouse - NZ
  • 2011-11-28 - David Eriksson Lundberg - SE
  • 2011-11-24 - Young Bin Yune - KR
  • 2011-11-18 - LinuxForHams - US
  • 2011-11-17 - Mark Schlegel - US
  • 2011-10-26 - Kenneth Mayne - US
  • 2011-10-17 - Salvatore Lanza - IT
  • 2011-10-13 - Claudio Caldera - IT
  • 2011-08-25 - Piero Pellegrini - IT
  • 2011-08-05 - Azzalin Luigi - IT
  • 2011-07-11 - Mark Schlegel - US
  • 2011-07-04 - Hiroshi Yagi - JP
  • 2011-06-28 - Brandon Waddell - DE
  • 2011-06-24 - Dalimil Gala - CH
  • 2011-05-19 - Ao Taiwo - US
  • 2011-05-06 - Kerry Kopp - US
  • 2011-05-05 - Julien Marodon - FR
  • 2011-05-03 - Carson Christian - US
  • 2011-04-12 - Len Dreyer - US
  • 2011-04-05 - Matthias Loepfe - CH
  • 2011-03-23 - Ted Brady - US
  • 2011-03-08 - Jeff Kelly - US
  • 2011-03-06 - James Rebman - US
  • 2011-03-02 - Jean-Louis Fuchs - CH
  • 2011-02-20 - Marek Honza - DE
  • 2011-02-17 - Frank L Klapperich III - US
  • 2011-02-12 - Dalimil Gala - CH
  • 2011-02-08 - Michael Galusha - US
  • 2011-01-17 - Aaron Beck - US
  • 2010-12-17 - Mare Island Historic Park Foundation - US
  • 2010-12-16 - Thomas Schmidt - US
  • 2010-12-06 - Jesper Jensen - DK
  • 2010-11-20 - Jon Meek - US
  • 2010-11-20 - Cédric Marmonier - FR
  • 2010-10-28 - Jan Tichý - CZ
  • 2010-10-21 - Nick Lidakis - US
  • 2010-09-04 - Dalimil Gala - CH
  • 2010-08-20 - Alexander List - CH
  • 2010-08-04 - Dalimil Gala - CZ
  • 2010-07-10 - Nick Lidakis - US
  • 2010-06-25 - Dalimil Gala - CZ
  • 2010-06-11 - Stefano Rizzetto - IT
  • 2010-03-08 - GSMweb.cz - CZ
  • 2010-02-14 - Nikolay Galeyev - US
  • 2010-02-08 - Mario Dix - DE
  • 2010-01-29 - Jean-Michel Bichoux - FR
  • 2010-01-25 - Nick Lidakis - US
  • 2010-01-17 - Andrew Biner - AU
  • 2010-01-01 - netPark, LLC - US
  • 2009-12-17 - Dalimil Gala - CZ
  • 2009-12-02 - José Angel Gonzalez Andres - ES
  • 2009-10-24 - Rupkki s.r.o. - Martin Podkrivacky - SK
  • 2009-10-18 - Felipe Fonseca - BR
  • 2009-10-02 - Noël Nachtegael - BE
  • 2009-09-06 - Frank Schroeder - DE
  • 2009-08-14 - Andrew Stenhouse - AU
  • 2009-08-06 - Douglas Shawhan - US
  • 2009-07-13 - Compevo Virtual Private Server - CA
  • 2009-06-11 - netPark, LLC - US
  • 2009-05-05 - Granville Barker - US
  • 2009-04-28 - Michael Perrin - US
  • 2009-04-27 - Franz Jakober - AT
  • 2009-03-21 - Dean Franks - US
  • 2008-12-24 - Philip Schroth - NL
  • 2008-12-08 - Arthur Chuvashov - RU
  • 2008-10-31 - Marco Zollinger - CH
  • 2008-10-25 - Roman Valls - ES
  • 2008-09-23 - Mario Dix - DE
  • 2008-09-23 - Tom Malcolmson - CA
  • 2008-08-15 - Francesco D'Arrigo - CH
  • 2008-07-08 - Carsten Bock - DE
  • 2008-07-05 - Josef Ender - CH
  • 2008-07-04 - E4A s.r.l. - IT
  • 2008-03-09 - Arthur Chuvashov - RU
  • 2008-03-01 - Michael Perrin - US
  • 2008-02-29 - Bill Jenkins - UK
  • 2007-09-20 - Robert Campbell - US
  • 2007-09-08 - Mario Dix - DE
  • 2007-06-17 - Kazunari Taguchi - JP
  • 2007-03-24 - Ty Roden - US
  • 2007-03-24 - Jonas Färdig
  • 2007-3-15 - David Strubbe - US
  • 2007-03-13 - Neilson Henriques
  • 2007-02-23 - Glenn Swonk - US
  • 2006-12-16- Jason Malacko - US
  • 2006-11-28 - Nicholas Humfrey - UK
  • 2006-11-17 - New River Valley Unwired, LLC - US

Thank you very much for your support!

Voyage Linux 0.6.0 released

We decided to release Voyage Linux 0.6.0 before the end of 2008.

voyage-0.6.0.tar.bz2 [2008-12-30] [Live CD] [README] [CHANGELOG]

Apart from Debian Lenny, there are some interesting features added in 0.6.0, such as 2.6.26 kernel, ocf patch, /ro & /rw replacement with aufs, LED drivers for ALIX, etc. Although Debian Lenny is not released yet, we are hoping that it will be released very soon. Releasing 0.6.0 ahead of Debian Lenny allows more people to test this version.

Support or get involved in Voyage Linux!

Voyage Linux Experimental Release based on Debian Lenny

After a long Olympic break, we are pleased to announce a new Voyage Linux experimental release that is now based on Debian Lenny, which is scheduled to roll out in the coming months. On-going development effort is now spent to put a final mark towards Voyage Linux 0.6.

This release is NOT for production use.

This experimental and upcoming VL 0.6 is built by Debian Live framework. Currently, it does not support disk persistency. All changes to the file systems would be lost after reboot. In addition, the Live CD cannot work as PXE server for netboot install. All of these issues will be addressed in the final VL 0.6.

[2008-10-02 update] Both disk persistency and PXE support in Live CD have been resolved. We suggest that users planning to use VL 0.6 should start testing it now, and report any bugs and your feedback.

To recap, most notable changes in VL 0.6 are:

  1. no more /rw and /ro. They are replaced by aufs, for /var/log and /var/tmp
  2. based on (to-be-released) Debian Lenny
  3. 2.6.26 kernel

Regression tests is just started and feature request backlog in wiki is now being processed. Even though Debian Lenny has not been official released, VL 0.6.0 should be ready in the next few weeks and is served as a test drive. VL 0.6.1 is planned at the same time Debian Lenny is release.

Support or get involved in Voyage Linux!