Mac OS X Tunnel Client Configuration Guide

This document describes how to configure your Mac to connect to Internodes IPv6 router.

Before you start

1. Ensure Mac OS X Developer Tools is installed (you'll need /usr/bin/make).
2. Disable any existing IPv6 interfaces. Turn 'Configure IPv6' to 'Off' for all network interfaces.

Software installation

1. Install The tun/tap Driver

1. Visit http://tuntaposx.sourceforge.net/ and download the installer package for your OSX version.
2. Install the package (it's easy).

2. Install Gateway6

1. Visit http://go6.net/4105/download.asp, and download "Gateway6 Source Code (Linux/Unix/Darwin/BSD)".
2. Extract the file.
3. Open Terminal. Find your Hard Drive, go to Applications, Utilities, then Terminal.
4. Type sudo -s and enter a password if required.
5. Type cd ~/Desktop/gw6c-5_1-RELEASE-src and press enter to change into the source folder. Once that has been completed then type vim tspc-advanced/src/lib/md5c.c and hit enter. This will bring up a configuration page. Scroll down until you find #include "md5.h".
6. After finding #include "md5.h", add the line #include <stdint.h> above #include "md5.h". To Edit the configuration file press "a", this will allow you to start editing. Once you have finished editing the configuration file press "Escape" then type ":wq". This will save and quit the configuration file.
7. Next go to the "tspc-advanced" folder. To change the folder type cd tspc-advanced and hit enter, then type make all target=darwin and hit enter. This will then run 11 lines of information.
8. Run the command make install target=darwin installdir=/usr/local/gw6c. This will then install the application.
9. When the application has finished installing you will need to change the directory use the following command cd /usr/local/gw6c/bin.
10. Type the command chmod +x /usr/local/g26c/template/*.sh. This will alter the permission of any file name with a .sh extension.
11. We now need to change the configuration details (edit gw6c.conf). Below is an example of a completed configuration file. Just replace the bold text with your Internode username and password details. The "if_prefix" is the name of your ethernet driver.

    userid=yourdialupusername
    passwd=yourdialuppassword
    server=sixgw.adl6.internode.on.net
    auth_method=any
    host_type=router
    prefixlen=64
    if_prefix=yournormalinterface
    dns_server=192.231.203.132
    gw6_dir=/usr/local/gw6c
    auto_retry_connect=yes
    retry_delay=30
    keepalive=yes
    keepalive_interval=30
    tunnel_mode=v6anyv4
    if_tunnel_v6v4=gif0
    if_tunnel_v6udpv4=tun0
    if_tunnel_v4v6=
    client_v4=auto
    client_v6=auto
    template=darwin
    proxy_client=no
    broker_list=tsp-broker-list.txt
    last_server=tsp-last-server.txt
    always_use_same_server=no
    log_filename=gw6c.log
    log_rotation=yes
    log_rotation_size=32
    log_rotation_delete=no
    syslog_facility=USER
    

12. Now start the program using the command ./gw6c. This will start the application creating the IPv6 connection.
13. To make sure the connection is up and running type ifconfig. This will bring up all the IP addresses for the connection. The connection that we are looking for should be down the bottom, named tun0.
14. To test the connection is working simply run the command ping6 www.ipv6.org. This will ping over IPv6 to verify that there is data flow.

3. Launching gw6c

Launch the gw6c application by running ./gw6c

You should get some output to confirm you are connected to Internode:

# ./gw6c
Gateway6 Client v5.1-RELEASE build May 26 2008-17:42:25  
Built on ///Darwin youhostname.dns 9.2.2 Darwin Kernel
Version 9.2.2: Tue Mar 4 21:17:34 PST 2008;
root:xnu-1228.4.31~1/RELEASE_I386 i386///


Connection to sixgw.internode.on.net established.

You should also see the tunnel interface, tun0, come up:

bash-3.2# ifconfig
[Output Removed]
tun0: flags=8851 <UP,POINTOPOINT,RUNNING,SIMPLEX,MULTICAST> mtu 1500
   inet6 fe80::217:f2ff:fed5:9ef5%tun0 prefixlen 64 scopeid 0x8 
   inet6 2001:44b8:61::c --> 2001:44b8:61::a prefixlen 128 
   open (pid 15771)

Test your connection by using the ping6 utility to echo a host, in this case, www.ipv6.org

# ping6 2001:6b0:1:ea:202:a5ff:fecd:13a6
PING6(56=40+8+8 bytes) 2001:44b8:61::b --> 2001:6b0:1:ea:202:a5ff:fecd:13a6
16 bytes from 2001:6b0:1:ea:202:a5ff:fecd:13a6, icmp_seq=0 hlim=45 time=425.293 ms
16 bytes from 2001:6b0:1:ea:202:a5ff:fecd:13a6, icmp_seq=1 hlim=45 time=418.561 ms
16 bytes from 2001:6b0:1:ea:202:a5ff:fecd:13a6, icmp_seq=2 hlim=45 time=420.806 ms

Generic Notes

Firefox 2.x

By default, Firefox disables IPv6 support on MacOS X but not on other platforms. To enable IPv6 on Firefox, do:

1. "about:config" in the url box.
2. filter "ipv6",
3. select "network.dns.disableIPv6"
4. and set the value to "false".

... or try using Firefox 3.x (which enables IPv6 support by default).