h1. Mise en place de Falling-Sky

Falling-sky est le script open-source se cachant derrière : http://test-ipv6.com/ .

Ici, ce script sera installé sur http://test-ipv6.tetaneutral.net/ dans /var/www/test-ipv6.tetaneutral.net.

h2. Installation des pré-requis systèmes

Ces pré-requis sont nécessaires uniquement pour l'installation du script.

Ils pourront êtres nettoyés une fois tout installé.

<pre>

# aptitude install apache2-prefork-dev subversion yui-compressor tidy libtemplate-perl libyaml-perl libyaml-syck-perl libjson-perl

</pre>

h2. Récupération des sources

Les sources sont accessibles depuis le serveur SVN de google

<pre>

# cd /usr/local/src

# svn checkout http://falling-sky.googlecode.com/svn/trunk/ falling-sky

</pre>

h2. Installation de mod_ip

Falling-sky fournit le module d'apache mod_ip. C'est un module qui retourne l'IP, dans un objet JSONP, depuis laquelle un client web accède à une page web.

Ce service est fourni en tant que module apache pour des raisons de performances.

<pre>

# cd /usr/local/src/falling-sky/mod_ip

# apxs2 -c -i -a mod_ip.c

</pre>

h2. Activation des modules dans apache

Falling-sky a besoin des modules mod_usertrack, mod_header et mod_expire pour fonctionner.

<pre>

# /etc/apache2/mods-enabled

# ln -sv ../mods-available/usertrack.load

# ln -sv ../mods-available/header.load

# ln -sv ../mods-available/expire.load

</pre>

h2. Ajout du VirtualHost dans apache

<pre>

# cat /etc/apache2/sites-available/test-ipv6.tetaneutral.net 

<VirtualHost *:80>

	# Basic stuff commmon to any virtual host

	ServerName test-ipv6.tetaneutral.net

	ServerAlias www.test-ipv6.tetaneutral.net

	DocumentRoot /var/www/test-ipv6.tetaneutral.net

	# I have a "server alias" for every possible name I expect to answer.

	ServerAlias test-ipv6.tetaneutral.net *.test-ipv6.tetaneutral.net 

	ServerAlias 91.224.149.206

	ServerAlias 2a01:6600:8081:ce00::1

	# Enable etags.  Improve cachability of

	# most stuff.

	FileETag MTime

	# Apache built in cookie tracking.

	# We use this to record only the most recent submission from a given browser,

	# to avoid stuffing the ballot box on the survey.

	CookieExpires "24 hours"

	CookieStyle RFC2109

	CookieTracking on

	# Limit disk access.  Don't look for .htaccess in directories.

	<Directory /var/www/test-ipv6.tetaneutral.net>

		AllowOverride None

	</Directory>

	################################################################

	# IP reporting                                                 #

	################################################################

	# mod_ip - reports IP address.  CGI arguements: callback= and fill=

	# This is a custom module in the test-ipv6.com archive.

	# This was implemented as a module for performance reasons.

	# /ip/ is *the* single most requested element (6 or more times per test!)

	<LocationMatch ^/ip/?$>

		SetHandler mod_ip

		Header append Cache-Control no-cache

		Header append Pragma no-cache

		Header append Expires "Thu, 01 Jan 1971 00:00:00 GMT"

	</locationMatch>

	################################################################

	# Cache busting                                                #

	################################################################

	# This virtualhost requires RewriteEngine

	RewriteEngine on

	# Cache Busting the javascript code

	# Each time we update index.html, we do this:

	#   <script type="text/javascript" src="/v71/index.js">

	# This is to force the browser to fetch any updated javascript.

	# We do a similiar thing for CSS.

	# This RewriteRule will see /v71 and strip it from the request.

	RewriteRule ^/v[0-9]+(/.*)$ $1 [N]

	################################################################

	# Precompressed files                                          #

	################################################################

	# Our build.pl script will generate precompressed versions

	# of our HTML, JS, and CSS; and store the compressed versions

	# on disk.  We want to serve these directly to users who support

	# compression.  This avoids having Apache do compresion on-the-fly,

	# lowering the load on the web server.

	AddType "text/html;charset=UTF-8" .htmlgz

	AddType "text/javascript;charset=UTF-8" .jsgz

	AddType "text/css;charset=UTF-8" .cssgz

	AddEncoding gzip .htmlgz

	AddEncoding gzip .jsgz

	AddEncoding gzip .cssgz

	# If the browser supports gzip, redirect users

	# of these file types to the compressed versions.

	RewriteCond %{HTTP:Accept-Encoding} gzip

	RewriteRule (.*)\.html$ $1\.htmlgz [L]

	RewriteCond %{HTTP:Accept-Encoding} gzip

	RewriteRule (.*)\.css$ $1\.cssgz [L]

	RewriteCond %{HTTP:Accept-Encoding} gzip

	RewriteRule (.*)\.js$ $1\.jsgz [L]

	################################################################

	# Images                                                       #

	################################################################

	# Images used for testing need to be un-cached, always.

	# Make sure these are either a copy of the image directory, or 

	# a symlink to the images directory.

	<Location /images-nc>

		FileETag none   

		ExpiresActive off

		RequestHeader unset If-Modified-Since

		Header append Expires "Thu, 01 Jan 1971 00:00:00 GMT"

	</location>

	# Tell browsers that once /images/ [anything] is fetched, cache it forever.

	# Don't even try and *ask* again.  These images do not change.  This will

	# permit followup tests by the user both run faster, and lower the load on 

	# the web server.

	<Location /images>

		FileETag none

		ExpiresActive on

		ExpiresDefault "access plus 10 years"

	</location>

	################################################################

	# Localization                                                 #

	################################################################

	# Fix character sets using regex.  This is so we can

	# handle unlimited number of langauges.

	<LocationMatch "/.*[.](js|jsgz)[.]">

		Header set Content-type text/javascript;charset=UTF-8

	</LocationMatch>

	<LocationMatch "/.*[.](css|cssgz)[.]">

		Header set Content-type text/css;charset=UTF-8

	</LocationMatch>

	<LocationMatch "/.*[.](html|htmlgz)[.]">

		Header set Content-type text/html;charset=UTF-8

	</LocationMatch>

	# Content Negotiation

	Options +MultiViews

	LanguagePriority en-us en

	ForceLanguagePriority prefer fallback

	AddLanguage en .en-us   

	AddLanguage en-us .en-us

	AddLanguage fr .fr

	DirectoryIndex index.html

	# Identify IPv6 prefixes

	mod_ip_prefix 2001::/32 "Teredo"

	mod_ip_prefix 2002::/16 "6to4"

	mod_ip_prefix 2001:470:8000::/33 "he.net or tunnelbroker.net"

	mod_ip_prefix 2001:470:8000::/33 "tunnelbroker.net"          

	mod_ip_prefix 2001:55c::/32 "Comcast"

	mod_ip_prefix 2001:888::/32 "XS4ALL"

	mod_ip_prefix 2001:5c0::/32 "freenet6"

	mod_ip_prefix 2001:1291:200::/48 "brudi01.sixxs.net ctbc"

	mod_ip_prefix 2001:1291:200::/40 "brudi01.sixxs.net ctbc"

	mod_ip_prefix 2001:1418:100::/48 "ittrn01.sixxs.net itgate"

	mod_ip_prefix 2001:1418:100::/40 "ittrn01.sixxs.net itgate"

	mod_ip_prefix 2001:14b8:100::/48 "fihel01.sixxs.net dna"

	mod_ip_prefix 2001:14b8:100::/40 "fihel01.sixxs.net dna"

	mod_ip_prefix 2001:15c0:65ff::/48 "simbx01.sixxs.net amis"

	mod_ip_prefix 2001:15c0:6600::/40 "simbx01.sixxs.net amis"

	mod_ip_prefix 2001:15c0:6700::/40 "simbx01.sixxs.net amis"

	mod_ip_prefix 2001:1620:f00::/48 "chzrh02.sixxs.net init7"

	mod_ip_prefix 2001:1620:f00::/40 "chzrh02.sixxs.net init7"

	mod_ip_prefix 2001:16d8:cc00::/40 "sesto01.sixxs.net phonera"

	mod_ip_prefix 2001:16d8:dd00::/48 "dkcph01.sixxs.net phonera"

	mod_ip_prefix 2001:16d8:dd00::/40 "dkcph01.sixxs.net phonera"

	mod_ip_prefix 2001:16d8:ee00::/48 "noosl01.sixxs.net phonera"

	mod_ip_prefix 2001:16d8:ee00::/40 "noosl01.sixxs.net phonera"

	mod_ip_prefix 2001:16d8:ff00::/48 "sesto01.sixxs.net phonera"

	mod_ip_prefix 2001:16d8:ff00::/40 "sesto01.sixxs.net phonera"

	mod_ip_prefix 2001:1938:100::/40 "usdal01.sixxs.net highwinds"

	mod_ip_prefix 2001:1938:200::/40 "usphx01.sixxs.net highwinds"

	mod_ip_prefix 2001:1938:80::/48 "usdal01.sixxs.net highwinds"

	mod_ip_prefix 2001:1938:81::/48 "usphx01.sixxs.net highwinds"

	mod_ip_prefix 2001:1af8:fe00::/48 "nlhaa01.sixxs.net leaseweb"

	mod_ip_prefix 2001:1af8:fe00::/40 "nlhaa01.sixxs.net leaseweb"

	mod_ip_prefix 2001:1af8:ff00::/40 "nlhaa01.sixxs.net leaseweb"

	mod_ip_prefix 2001:41e0:ff00::/48 "chzrh01.sixxs.net ipman"

	mod_ip_prefix 2001:41e0:ff00::/40 "chzrh01.sixxs.net ipman"

	mod_ip_prefix 2001:4428:200::/48 "nzwlg01.sixxs.net acsdata"

	mod_ip_prefix 2001:4428:200::/40 "nzwlg01.sixxs.net acsdata"

	mod_ip_prefix 2001:4830:1100::/48 "usbos01.sixxs.net occaid"

	mod_ip_prefix 2001:4830:1100::/40 "usbos01.sixxs.net occaid"

	mod_ip_prefix 2001:4830:1600::/48 "usqas01.sixxs.net occaid"

	mod_ip_prefix 2001:4830:1600::/40 "usqas01.sixxs.net occaid"

	mod_ip_prefix 2001:4978:100::/40 "uschi02.sixxs.net yourorg"

	mod_ip_prefix 2001:4978:200::/40 "uschi02.sixxs.net yourorg"

	mod_ip_prefix 2001:4978:300::/40 "uschi02.sixxs.net yourorg"

	mod_ip_prefix 2001:4978:400::/40 "uschi02.sixxs.net yourorg"

	mod_ip_prefix 2001:4978:f::/48 "uschi02.sixxs.net yourorg"

	mod_ip_prefix 2001:4dd0:fc00::/40 "decgn01.sixxs.net netcologne"

	mod_ip_prefix 2001:4dd0:fd00::/40 "decgn01.sixxs.net netcologne"

	mod_ip_prefix 2001:4dd0:fe00::/40 "decgn01.sixxs.net netcologne"

	mod_ip_prefix 2001:4dd0:ff00::/48 "decgn01.sixxs.net netcologne"

	mod_ip_prefix 2001:4dd0:ff00::/40 "decgn01.sixxs.net netcologne"

	mod_ip_prefix 2001:610:600::/48 "nlams05.sixxs.net surfnet"

	mod_ip_prefix 2001:610:600::/40 "nlams05.sixxs.net surfnet"

	mod_ip_prefix 2001:610:700::/40 "nlams05.sixxs.net surfnet"

	mod_ip_prefix 2001:6a0:100::/40 "plwaw01.sixxs.net icm"

	mod_ip_prefix 2001:6a0:200::/48 "plwaw01.sixxs.net icm"

	mod_ip_prefix 2001:6a8:200::/48 "bebru02.sixxs.net belnet"

	mod_ip_prefix 2001:6a8:200::/40 "bebru02.sixxs.net belnet"

	mod_ip_prefix 2001:6f8:1000::/40 "deham01.sixxs.net easynet"

	mod_ip_prefix 2001:6f8:1100::/40 "deham01.sixxs.net easynet"

	mod_ip_prefix 2001:6f8:1200::/40 "deham01.sixxs.net easynet"

	mod_ip_prefix 2001:6f8:1300::/40 "deham01.sixxs.net easynet"

	mod_ip_prefix 2001:6f8:1400::/40 "bebru01.sixxs.net easynet"

	mod_ip_prefix 2001:6f8:1c00::/48 "deham02.sixxs.net easynet"

	mod_ip_prefix 2001:6f8:1c00::/40 "deham02.sixxs.net easynet"

	mod_ip_prefix 2001:6f8:1d00::/40 "deham02.sixxs.net easynet"

	mod_ip_prefix 2001:6f8:202::/48 "bebru01.sixxs.net easynet"

	mod_ip_prefix 2001:6f8:300::/40 "bebru01.sixxs.net easynet"

	mod_ip_prefix 2001:6f8:900::/48 "deham01.sixxs.net easynet"

	mod_ip_prefix 2001:6f8:900::/40 "deham01.sixxs.net easynet"

	mod_ip_prefix 2001:770:100::/48 "iedub01.sixxs.net heanet"

	mod_ip_prefix 2001:770:100::/40 "iedub01.sixxs.net heanet"

	mod_ip_prefix 2001:7b8:1500::/40 "nlede01.sixxs.net bit"

	mod_ip_prefix 2001:7b8:2ff::/48 "nlede01.sixxs.net bit"

	mod_ip_prefix 2001:7b8:300::/40 "nlede01.sixxs.net bit"

	mod_ip_prefix 2001:7e8:2200::/48 "lulux01.sixxs.net ptlu"

	mod_ip_prefix 2001:7e8:2200::/40 "lulux01.sixxs.net ptlu"

	mod_ip_prefix 2001:808:100::/48 "plpoz01.sixxs.net poznan"

	mod_ip_prefix 2001:808:100::/40 "plpoz01.sixxs.net poznan"

	mod_ip_prefix 2001:808:e100::/48 "plpoz01.sixxs.net poznan"

	mod_ip_prefix 2001:808:e100::/40 "plpoz01.sixxs.net poznan"

	mod_ip_prefix 2001:838:300::/48 "nlams01.sixxs.net concepts"

	mod_ip_prefix 2001:838:300::/40 "nlams01.sixxs.net concepts"

	mod_ip_prefix 2001:960:2::/48 "nlams04.sixxs.net scarlet"

	mod_ip_prefix 2001:960:600::/40 "nlams04.sixxs.net scarlet"

	mod_ip_prefix 2001:960:700::/40 "nlams04.sixxs.net scarlet"

	mod_ip_prefix 2001:a60:f000::/48 "demuc02.sixxs.net mnet"

	mod_ip_prefix 2001:a60:f000::/40 "demuc02.sixxs.net mnet"

	mod_ip_prefix 2001:ad0:900::/48 "eetll01.sixxs.net linxtelecom"

	mod_ip_prefix 2001:ad0:900::/40 "eetll01.sixxs.net linxtelecom"

	mod_ip_prefix 2001:b18:2000::/48 "ptlis01.sixxs.net nfsi"

	mod_ip_prefix 2001:b18:4000::/40 "ptlis01.sixxs.net nfsi"

	mod_ip_prefix 2604:8800:100::/48 "uschi03.sixxs.net cymru"

	mod_ip_prefix 2604:8800:100::/40 "uschi03.sixxs.net cymru"

	mod_ip_prefix 2610:0100:4fff::/48 "usanc01.sixxs.net gci"

	mod_ip_prefix 2610:0100:6000::/40 "usanc01.sixxs.net gci"

	mod_ip_prefix 2a00:14f0:e000::/48 "gblon03.sixxs.net gyron"

	mod_ip_prefix 2a00:14f0:e000::/40 "gblon03.sixxs.net gyron"

	mod_ip_prefix 2a00:15b8:100::/48 "iedub02.sixxs.net digiweb"

	mod_ip_prefix 2a00:15b8:100::/40 "iedub02.sixxs.net digiweb"

	mod_ip_prefix 2a01:198:200::/48 "dedus01.sixxs.net speedpartner"

	mod_ip_prefix 2a01:198:200::/40 "dedus01.sixxs.net speedpartner"

	mod_ip_prefix 2a01:198:300::/40 "dedus01.sixxs.net speedpartner"

	mod_ip_prefix 2a01:198:400::/40 "dedus01.sixxs.net speedpartner"

	mod_ip_prefix 2a01:198:500::/40 "dedus01.sixxs.net speedpartner"

	mod_ip_prefix 2a01:198:600::/40 "dedus01.sixxs.net speedpartner"

	mod_ip_prefix 2a01:198:700::/40 "dedus01.sixxs.net speedpartner"

	mod_ip_prefix 2a01:240:fe00::/48 "frmrs01.sixxs.net jaguar"

	mod_ip_prefix 2a01:240:fe00::/40 "frmrs01.sixxs.net jaguar"

	mod_ip_prefix 2a01:348:100::/40 "gblon02.sixxs.net goscomb"

	mod_ip_prefix 2a01:348:200::/40 "gblon02.sixxs.net goscomb"

	mod_ip_prefix 2a01:348:6::/48 "gblon02.sixxs.net goscomb"

	mod_ip_prefix 2a01:8c00:ff00::/48 "czprg01.sixxs.net ignum"

	mod_ip_prefix 2a01:8c00:ff00::/40 "czprg01.sixxs.net ignum"

	mod_ip_prefix 2a02:2528:ff00::/48 "chgva01.sixxs.net ipmax"

	mod_ip_prefix 2a02:2528:ff00::/40 "chgva01.sixxs.net ipmax"

	mod_ip_prefix 2a02:278:1200::/48 "iegwy01.sixxs.net airwire"

	mod_ip_prefix 2a02:278:1200::/40 "iegwy01.sixxs.net airwire"

	mod_ip_prefix 2a02:980:1000::/48 "dkcph02.sixxs.net fullrate"

	mod_ip_prefix 2a02:980:1000::/40 "dkcph02.sixxs.net fullrate"

</virtualhost>

# cd /etc/apache2/sites-enabled

# ln -sv ../sites-available/test-ipv6.tetaneutral.net

# service apache2 restart

</pre>

h2. Configuration

Les différents scripts de Falling-Sky sont buildés par un programme en perl.

Il faut le configurer selong le système sur lequel on l'installe.

<pre>

# cd /usr/local/falling-sky/source

# cp config.inc config.inc.local

# vi config.inc.local

</pre>

Le contenu de config.inc.local est :

<pre>

#!/bin/echo used by build.pl

use strict;

$COMPRESS{"js"} =  "/usr/bin/yui-compressor --type js --charset utf-8 -o [OUTPUT] [INPUT]";

$COMPRESS{"css"} = "/usr/bin/yui-compressor --type css --charset utf-8 -o [OUTPUT] [INPUT]";

$COMPRESS{"html"} = "/usr/bin/tidy -quiet -indent -asxhtml -utf8 -w 120 < [INPUT] > [OUTPUT]";

$INSTALL = "/var/www/test-ipv6.tetaneutral.net"; 

$VARS->{"domain"} = "test-ipv6.tetaneutral.net";

$VARS->{"ipv4"} = "91.224.149.206";

$VARS->{"ipv6"} = "2a01:6600:8081:ce00::1";

$VARS->{"contact"} = 'Tetaneutral.net';

$VARS->{"mailto"} = 'contact@tetaneutral.net';

$VARS->{use_survey} = 0;

$VARS->{hash_survey} = 0;  

$VARS->{'facebook_like'} = 0;

$VARS->{"twitter_tweet"}=0;

1;

</pre>

h2. Installation

Par défaut, falling-sky est buildé pour une tripotée de langages.

Ici, on limite à l'anglais et le français.

<pre>

# cd /usr/local/falling-sky/source

# vi build.pl

@LANG = qw(en-us fr);

</pre>

Et on peut lancer le script d'installation.

<pre>

# ./build.pl --config config.inc

Processing: en-us: js/index.js

Processing: en-us: js/base.js

Processing: en-us: js/without-ui.js

Processing: en-us: js/jquery.js

Processing: en-us: js/tablesorter.js

*snip*

Processing: fr: html/when.html

Processing: fr: php/comment.php

Processing: fr: php/survey.php

Processing: fr: php/report-ip.php

</pre>

Les images doivent être installées manuellement.

<pre>

# cd /usr/local/src/falling-sky

# rsync -av images/. /var/www/test-ipv6.tetaneutral.net/images

# rsync -av images/. /var/www/test-ipv6.tetaneutral.net/images-nc

</pre>

Les fichiers doivent appartenir à l'utilisateur d'apache.

<pre>

# chown -R www-data:www-data /var/www/test-ipv6.tetaneutral.net

</pre>

h2. Modification du DNS

La plupart des tests effectués par Falling-Sky se basent sur des requêtes DNS.

Il faut donc modifier le serveur DNS pour ajouter différents enregistrements et une zone.

Ici, la zone tetaneutral.net est modifiée et une zone v6ns.test-ipv6.tetaneutral.net est ajoutée.

<pre>

# grep test-ipv6 tetaneutral.net.zone

test-ipv6                   IN CNAME   www

ipv4.test-ipv6              IN A       91.224.149.206

ipv6.test-ipv6              IN AAAA    2a01:6600:8081:ce00::1

aaaa.test-ipv6              IN AAAA    2a01:6600:8081:ce00::1

a.test-ipv6                 IN A       91.224.149.206

ds.test-ipv6                IN A       91.224.149.206

ds.test-ipv6                IN AAAA    2a01:6600:8081:ce00::1

v6ns.test-ipv6              IN NS      v6ns1.test-ipv6

v6ns1.test-ipv6             IN AAAA    2a01:6600:8000::2

# cat v6ns.test-ipv6.tetaneutral.net.zone

; -*- mode: zone; -*-

;

$TTL 86400

@    IN SOA v6ns1.v6ns.test-ipv6.tetaneutral.net. root.tetaneutral.net. (

        2013021003      ; serial

        86400      ; Refresh

        3600       ; Retry

        3600000    ; expire

        86400 )    ; negative cache TTL

                            IN  NS     v6ns1.test-ipv6.tetaneutral.net.

                            IN  MX 1   mx1.tetaneutral.net.

                            IN  MX 100 mx2.tetaneutral.net.

                            IN  A      91.224.149.206

                            IN  AAAA   2a01:6600:8081:CE00::1

; Script de test de connectivite IPv6 (fab-)

ipv4                        IN A       91.224.149.206

v4                          IN A       91.224.149.206

ipv6                        IN AAAA    2a01:6600:8081:ce00::1

v6                          IN AAAA    2a01:6600:8081:ce00::1

aaaa                        IN AAAA    2a01:6600:8081:ce00::1

a                           IN A       91.224.149.206

ds                          IN A       91.224.149.206

ds                          IN AAAA    2a01:6600:8081:ce00::1

</pre>

<pre>

# cat /etc/bind/named.conf

*snip*

    zone "tetaneutral.net" IN {

        type  master;

        file  "wan/tetaneutral.net.zone";

        allow-transfer { 91.216.110.40; 217.70.177.40; };

    };

*snip*

    zone "v6ns.test-ipv6.tetaneutral.net" IN {

        type  master;

        file  "wan/v6ns.test-ipv6.tetaneutral.net.zone";

    };

*snip*

</pre>