           Welcome to the freenet6 II experience...

Table of content

   1. Introduction
   2. Extracting the package
   3. Building the freenet6 client
   4. Installing the freenet 6 client
   5. Using the freenet6 client

1. Introduction

FREENET6's TSP is a new initiative launched by Viagenie, a private company in
Canada involved in IPv6 since 1996, to facilitate a faster deployment of an
IPv6 Internet. The Internet is deployed worldwide over IPv4 so this
project's goal is large scale deployment of IPv6 by using configured tunnels. 

Configured tunneling is a transition method standardized by IETF to use IPv6 in
coexistence with IPv4 by encapsulating IPv6 packets over IPv4. Any host already
connected to Internet with IPv4 which has an IPv6 stack can establish a link
to the Internet IPv6. 

Freenet6, developed by Viagenie in 1999/2000, was the first public tunnel
server service and one of the most used in the world to automatically delegate
one single IPv6 address to any host already connected to an IPv4 network over
configured tunnel simply by filling a web form and running a script. FREENET6's
TSP represents another very important step to accelerate the large scale
deployment of IPv6 to everyone on the net. 

Instead of a web interface to request configured tunnels and IPv6 addresses,
FREENET6's TSP is a new model based on a client/server approach. A protocol is
used to request a single IPv6 address to a full IPv6 prefix from a client to a
tunnel server according to the IPv6 broker model. The protocol could be
integrated directly into the operating system to provide a service like
DHCP but for requesting IPv6 addresses or prefixes over an IPv4 network
(Internet).

2. Extracting the package

To extract the package in /usr/local just issue this command
$ tar zxf package-name.tgz -C /usr/local

this will have created the "/usr/local/package-name" directory.

3. Building the freenet6 client

If you downloaded the binary version, you can skip this step.
If you want to build and install at the same time you can skip this step.

To build the freenet6 client, just type make all target=os-type
where os-type is one of the following :

   freebsd4     for FreeBSD 4.x up to 4.3.
   freebsd44    for FreeBSD 4.4 and up.
   netbsd       for NetBSD 1.4 and up.
   openbsd      for OpenBSD 2.7 and up.
   solaris8     for Solaris 8 and up.
   linux        for Linux.
   WindowsNT-2K for Windows NT and 2000 based systems.
   win32        for all Windows 9x based systems.

the binaries and basic configuration files will be
in (where-you-extract-this-package)/bin.

You should have tspc (or tspc.exe for windows) and tspc.conf.

4. Installing the freenet 6 client

To install the freenet6 client, just type
make install target=<os-type> installdir=<destination>
where <os-type> is one of the following :

   freebsd4     for FreeBSD 4.x up to 4.3.
   freebsd44    for FreeBSD 4.4 and up. 
   netbsd       for Netbsd 1.4 and up.
   openbsd      for Openbsd 2.7 and up.
   solaris8     for Solaris 8 and up.
   linux        for Linux.
   WindowsNT-2K for Windows NT and 2000 based systems.
   win32        for all Windows 9x based systems.

and <destination> is the destination directory like /usr/local/tsp.

Ex: 
$ make install target=freebsd4 installdir=/usr/local/tsp

This will copy all necessary files to /usr/local/tsp.

5. Using the freenet6 client

To get an anonymous tunnel type :
cd /usr/local/tsp/bin
./tspc -f tspc.conf

To see what's happening type :
cd /usr/local/tsp/bin
./tspc -vf tspc.conf

To get a permanent tunnel, you need to register on this web page:
http://tsps1.freenet6.net and follow on-line instructions.

Thanks for using freenet6.
