Aiccu/Installation

From SixXS Wiki
Jump to: navigation, search

Main topic page: Aiccu.

Currently in draft form. Steps have not yet been validated.

Introduction

The first thing thing to do is to take a look at the downloads section of Aiccu, to see what installation type you should be using, since a number of platforms have binary packages or package installers that know about Aiccu. If your only solution is a source distribution, or you want to compile from source, then follow the instruction in the "Compiling from Source" section below.

Once you have installed, configured and activated aiccu, you will probably want to test it. With an IPv6 compliant web browser (such as Opera 9.5, Firefox 3, Safari 3 or IE7), point your web browser to http://www.kame.net to see the dancing turtle. If it is static then you should check your configuration. Another site you can test with is http://ipv6.google.com/ (this has an IPv6 address only).

One thing that is worth noting is that you are asked to keep your tunnel up. You will be e-mailed if your tunnel is down for a certain amount of time.

Compiling from Source

  • Check the tunnel driver page, to see if you need to download the tunnel driver.
  • Download the source tarball from the downloads section (it is the first in the list).
  • Extract the archive. This can be done from the terminal (note the file name may be slighly different):
 tar -zxf aiccu_current.tar.gz
  • Change into the aiccu directory:
 cd aiccu
  • Do a "make clean" just in case:
 make clean
  • Make the project:
 make
  • Install the project. (By default this installs into /usr/sbin, though if you want it elsewhere you will need to edit the Makefile, notably the line 'DESTDIR=')
 sudo make install

This will install the following files on your system:

/usr/sbin/aiccu
/usr/share/doc/aiccu/HOWTO
/usr/share/doc/aiccu/LICENSE
/usr/share/doc/aiccu/README
/etc/aiccu.conf
/etc/init.d/aiccu


Configuration

If you are using the standard configuration for aiccu, then you will need to create, or edit the /etc/aiccu.conf file. Below is a sample configuration, which you can paste in. You will want to modify the values for username, password and tunnel_id. This configuration uses AYIYA, since it is assumed that you are stuck behind a NAT. If you don't have a username and password then you will need to register for one. You can see what tunnels are assigned to you on you SixXS home page and if you don't have one, then follow the 'request tunnel' link on the page.

# AICCU Configuration
 
# Login information - register for account at: http://www.sixxs.net/signup/create
username <your nichandle/username>
password <your password>
#note as of version AICCU 2007.01.15 (default for Ubuntu 10.04.2 LTS) the username directive DOES NOT
#strip leading space characters.   so "username ID123-SIX" IS NOT the same as "username     ID123-SIX"
 
# Protocol and server to use for setting up the tunnel (defaults: none)
#protocol <tic|tsp|l2tp>
#server <server to use>
protocol tic
server tic.sixxs.net
 
# Interface names to use
# ipv6_interface is the name of the interface that will be used as a tunnel interface.
# On *BSD the ipv6_interface should be set to gifX (eg gif0) for proto-41 tunnels
# or tunX (eg tun0) for AYIYA tunnels.
# The value sixxs also works, at least on OpenWRT
# ipv6_interface tun0 
ipv6_interface tun0
 
# The tunnel_id to use - request one at: http://www.sixxs.net/home
# (only required when there are multiple tunnels in the list)
#tunnel_id Txxxx
 
# Be verbose?
verbose false
# for your first tunnel it may well be helpful to turn on verbose mode and turn off daemonize.
 
# Daemonize?
daemonize true
 
# Automatic Login and Tunnel activation?
automatic true
 
# Require TLS?
# When set to true, if TLS is not supported on the server
# the TIC transaction will fail.
# When set to false, it will try a starttls, when that is
# not supported it will continue.
# In any case if AICCU is build with TLS support it will
# try to do a 'starttls' to the TIC server to see if that
# is supported.
requiretls false


Because your username and password are in this config file, it might be a good idea to protect them from being read by anyone but 'root'. Do a

chmod 600 /etc/aiccu.conf

to do this.

Running

To run aiccu, you use the aiccu command. Assuming standard location:

 cd /usr/sbin
 sudo aiccu start

If you run into trouble change the daemonize entry to false and the verbose entry to true, in the aiccu.conf file, as this will help you see what's failing. Some possibilities are listed in the FAQ, or if you don't find an answer there, then there is always the forum.

When everything is up and running you should see your tunnel when you run:

ifconfig -a

Additionally, if you visit The Kame Project web site, you should see an animated turtle, if you are reaching the site via IPv6.

Platforms

MacOS X

Homebrew

  • Tested with Mac OSX 10.7.5 (Lion) till OSX 10.10 (Yosemite), with tun/tap drivers from homebrew
  • Install Homebrew if not already installed. / Otherwise you need probably to brew update
  • Install tuntap: brew install tuntap
  • Install aiccu: brew install aiccu
  • Follow the description of the installer. (Change the /usr/local/etc/aiccu.conf, and just run it)

MacPorts

WARNING: The MacPorts version of AICCU is starting it from daemondo which keeps on restarting AICCU. This problem was reported in 2009 [1] but still has not been resolved after several years. You will have to disable daemondo from starting aiccu otherwise you will get locked out from the TIC server and your account will be disabled.

Instructions removed to avoid people falling into this pitfall. Please use homebrew instead.

OpenWRT

See: Installing on OpenWRT

Windows Vista

See Configuring Windows Vista