DSTM

DSTM stands for "Dual Stack Transition Mechanism". It is an IPv4 to IPv6 transition proposal based on the use of IPv4 over IPv6 dynamic tunnels and the temporary attribution of IPv4 global addresses to IPv6-only hosts.

DSTM Consists of three parts: a 'Client', a 'Server' and a 'Gateway'. The 'Client' is the machine that is IPv6-only and wishes to communicate using IPv4. The 'Server' is the machine that administrates the IPv4 address pool. The 'Gateway' is the machine in charge of encapsulation and de-capsulation of IPv4 over IPv6 packets. Only the 'Gateway' requires to have direct IPv4 connectivity and a permanent IPv4 address. The 'Server' and 'Gateway' are often implemented on the same physical machine.


Where to obtain further Documentation?

From ENST Bretagne, Campus de Rennes, France at URL:
[Ecole Nationale Superieure des Telecommunications]
" http://www.ipv6.rennes.enst-bretagne.fr/dstm/"

How to obtain the Source Code?

Software for Linux is available via FTP from the following location:
" ftp://ftp.ipv6.rennes.enst-bretagne.fr/pub/FreeBSD/dstm/dstm1.2.tgz"


DSTM Installation

These pages describe the DSTM installation on a Red Had Linux machine. Refer to the “Red Hat Linux” pages under the “Operating Systems [OSs]” section for information on how to install a Red Hat Linux machine capable of running DSTM. In particular, the following steps have to be performed:


Preparation before Installing DSTM

Before proceeding, make sure that IPv6 is compiled as a “module”, that the Linux kernel sources are present in the default “/usr/src/linux/” directory and that they match with the actual running kernel in the machine.

Expand the DSTM Software
prompt> cd /usr/local/src/
prompt> tar xvf dstm1.2.tar

Compile & Install System Modules

The following compilations and installations are necessary for both the DSTM Client and the DSTM Server/Gateway. It creates the ‘iptun6’ executable that is moved into the ‘/usr/local/sbin/’ directory and it creates two object modules ‘dstm.o’ & ‘dti.o’ that are moved inside the loadable module directory at ‘/lib/modules/2.4.19-ipv6/kernel/net/ipv6/’.

prompt> cd /usr/local/src/dstmd/
prompt> make system
prompt> make installsystem

The common DSTM installation steps are now done. The succeeding installation steps and customizations differ for the DSTM Client and the DSTM Server/Gateway.


Compile the DSTM Server/Gateway

The following compilations and installations are only necessary if one wants to install the DSTM Server/Gateway. It creates the ‘rpcdstmd’ executable that is moved into the ‘/usr/local/sbin/’ directory.

prompt> cd /usr/local/src/dstmd/
prompt> make server
prompt> make installserver

Customize the DSTM Server/Gateway

In Linux [unlike FreeBSD], one does not need to worry about interface setup. The 'dti' interfaces [that correspond in fact to 4over6 interfaces], are created dynamically when the server is launched. On the other hand, the DSTM Server 'rpcdstmd' has to be configured. A sample of a configuration file 'rpcdstmd.conf' can be found in the 'server/' path of the DSTM installation directory.

The configuration file '/usr/local/etc/rpcdstmd.conf' is the one that is used by the DSTM Server. Copy the sample configuration file over and make the following changes to it:


Compile the DSTM Client

The following compilations and installations are only necessary if one wants to install the DSTM Client. It creates the ‘rpcd’ executable that is moved into the ‘/usr/local/sbin/’ directory.

prompt> cd /usr/local/src/dstmd/
prompt> make
prompt> make install

Customize the DSTM Client

In Linux [unlike FreeBSD], the 'dti' module that implements the 4over6 tunneling interface can be loaded at launch time. For this to happen, the command line option '-load' must be present when launching the DSTM client.


Last Modified by Daniel Davids on Thursday 20 March 2003