View source for ChaosVPN:Fonera

= ChaosVPN: Fonera Instructions =

== Supported Hardware ==

  * Fonera 2.0n

== Software ==

[http://download.fonosfera.org/LATEST/fonera2.0n-FON2300/ Signed Official Foneros DEV Images in this Dir (check there for Updates)]

[http://www.music-piracy.com/fonera2n-chaosvpn.img Latest ChaosVPN Fonera Image] - openfly's build

  * Foneros 2.3.7.0 beta 2
  * ChaosVPN 2.12
  * Tinc 1.0.18

[http://www.aculei.net/~mjoyce/chaosvpn/ Source Available here] at your own peril.

== Instructions ==

=== Step 1 ===

To be able to access your Fonera 2.0 using the ssh protocol.
If yes skip step 2.

=== Step 2 - Flash to Official Dev Image go get SSH working ===

you will need to reflash your stock fonera with a DEV image.<br>

I've included a link to a tested DEV image in the [[http://wiki.hamburg.ccc.de/ChaosVPN::Fonera#Software Software section]].  <br>
You download the .tgz of the image. <br>
'''Do not untar or ungzip it. ''' <br>
Simply access the administrative web interface on the device.  <br>
Head to the system / settings section.  <br>
Upload the tarball to the device to start the reflash.  <br>
A progress bar should appear to indicate the device is being flashed.  <br>
'''Do not unpower the device until the flash has completed.''' <br> 
[[File:800px-2.0n_2.3.0.0_Settings_System.png]]<br>
'''Do not unpower the device until the flash has completed.'''  <br><br>

Upon the completion of a flash, the system should automatically reboot itself. <br>
Please give it time to do so.  <br>
There have been instances where it has hung just after a reflash, or simply acted oddly.  <br>
I've simply waited until I was certain no more was going on on the device and then gave it a quick reboot.<br>
This can also address browser issues.

=== Step 3 - upload the ChaosVPN image to your Fonera ===

Now you can access ssh on the device. <br>
<br>
'''Login:''' <br>
User: Root<br>
Password: the same as your administrative password used on the web UI.<br>
<br>
Verify you can login correctly. <br>

==== Without Internet ==== 
Once you have done so, scp (Secure CoPy) the ChaosVPN image tarball to the device. <br>

Programs:<br>
you can use simply scp in Linux. <br>
you can use winscp or putty in Windows. <br>

Exampel code
 scp fonera2n-chaosvpn.img admin@fonera:tmp/fonera2n-chaosvpn.img

Confirm that everything uploads nicely.<br>
More about [[https://secure.wikimedia.org/wikipedia/en/wiki/Secure_copy Secure CoPy]]

==== With Internet: ==== 

 cd /tmp
 wget http://www.music-piracy.com/fonera2n-chaosvpn.img


=== Step 4 - The flashing of the device with Backup  ===
If you do not want to backup. (case: new Device / clean install) skip this step<br>
The tarball as included is laid out to demonstrate how you can upgrade your device properly. <br>
Since you won't be "upgrading" from a previous ChaosVPN instance some things are slightly different. <br>
Let's look at what is in the tarball.

 20100824_FON2303_2.3.6.1_r1730_DEV.img	
 fonera2n-chaosvpn.img
 upgrade
 upgrade_developer

fonera2n-chaosvpn.img, and upgrade are symlinks to the image and upgrade script respectively.  

fonera2n-chaosvpn.img is the image you will be upgrading to. (check the [[http://wiki.hamburg.ccc.de/ChaosVPN::Fonera#Software Software Seccion]] for newer images)

Let's look at upgrade_developer:

 <nowiki>
 #!/bin/ash

 VERSION=$(cat /etc/fon_version)
 # FAILSAFE=$(cat /etc/failsafe)
 DEVICE=$(cat /etc/fon_device)

 if [ "$DEVICE" = "fonera20n" ]
 then
 uci set registered.fonreg.dev=1
 uci commit
 tar cvzf /tmp/sysupgrade.tgz /etc/passwd /etc/group /etc/dropbear /etc/samba/smbpasswd /etc/samba/secrets.tdb /etc/config/firewall /etc/config/upnpd /etc/config/umtsd /etc/config/registered /etc/config/gdata /etc/config/facebook /etc/config/flickr /etc/config/mountd /etc/config/fon /etc/config/ddns /etc/config/wizard /etc/pureftpd.pdb /etc/pureftpd.passwd /etc/config/luci_dlmanager /etc/config/twitter /etc/config /firewall /etc/tinc /etc/init.d/firewall
 mtd -j /tmp/sysupgrade.tgz -r write fonera2n-chaosvpn.img image > /dev/null 2>&1 
 return 0
 else
 return 1
 fi
 </nowiki>

Okay so there's '''only 2 important lines''' in the script.  <br>
The '''tar''' creation call, <br>
and the call to '''mtd'''.  <br>

What the tar creation call does, is it creates a tarball in /tmp of the fonera called "sysupgrade.tgz".  <br>
Everything you tar up into it ( using an absolute directory path ), will be saved there and deployed after the firmware is upgraded.<br>
What this allows you to do is save settings of your device.<br>
You will need to specify the paths of areas of the file structure you want preserved manually.<br>

The mtd call is the upgrade call.

 mtd -j /tmp/sysupgrade.tgz -r write fonera2n-chaosvpn.img image

=== Step 5 - The flashing of the device without Backup ===

The flashing of the device without Backup. <br>
for New Device / clean install

 mtd -r write fonera2n-chaosvpn.img image

=== Step 6 -  The long waiting ===

Now you should see some dialogue that says the firmware is flashing with an oscillating w / e thing going.<br>
Eventually this will end and the device will reboot. <br>
This is expected.  Anything else, is not.

Please '''do not unpower''' the device until you are certain the operation has completed, or are certain that anything still occurring MUST be bad.<br>

After you login the new webUI will look like this: <br>
[[File:Fonera2n-latestFirmware.jpg]]<br><br>
and connecting by ssh: <br>
[[File:Loginssh-foneraupdatet.jpg]]

=== Step 7 - IP Allocation ===

Go to [[ChaosVPN::IPRanges]], select a range and fill out the corresponding data.<br>
'''Please conform to standards.'''  <br>
Be sparing in your address space allocations.  <br>
You don't need a /16 for your apt.  <br>

=== Step 8 - Setting up TINC keys ===

So by now your fonera should have rebooted. <br>
You should have set up an administrative password, and made the device network accessible in the WebUI. <br>

So connect over ssh to the device.  <br>
You should see some ChaosVPN messages in the MoTD, take this as a sign you've gotten this far without error.  <br>

First thing you are going to want to do is generate a keypair for your node.  

 tincd -n chaos --generate-keys=2048

Hit 2 times [Enter]. Do not change the default name/location of the keys. Default it get drop in /etc/tinc/chaos/.  <br>
Make a copy in a '''SECURE location not on that device'''.

E-Mail Haegar directly, or the ChaosVPN mailing list to have your node added.  

Send info such as the following:

 nodename: hackerspace  ( short, no spaces, no non chars, descriptive )
 network: 10.100.xxx.xxx/24 ( use the address space you allocated in the IP ranges wiki )
 owner: you@youremail.com ( make this legitimate )
 gatewayhost: your external address if you have a static one
 network6: same as network, but for ipv6.

 key: public key here 

Wait for Haegar or someone else to confirm you have been added to the VPN successfully. (it can take ~24h).

=== Configuring ChaosVPN ===

There is a chaosvpn.conf in /etc/tinc/ .  <br>
You have to change 2 things in the config:
 <nowiki>$my_peerid		= "thenameofyournode";

$my_vpn_ip		= "172.31.x.x";</nowiki>

Once you have filled out your chaosvpn.conf file correctly.

==== Checking to see if it worked ====

Please give ChaosVPN a testrun. After you are you get the validation of the adding to the ChaosVPN.
 
 chaosvpn

Hope no error appears. <br>

 netstat -nr

You should see a hell of a lot of routes using the chaos_vpn interface.
This is good.

Check /etc/tinc/chaos/hosts/ see if a whole bunch of node info has appeared.

Wait several minutes from first execution then test ping some of the "test ping" addresses as defined in the IP Ranges wiki page.
10.100.69.1 is the NYC Resistor fonera.
See if you can ping it from the router.

If all went well you are now pinging.  
Get someone to ping you back.
You now have a functional node.

=== Firewall Rules ===

People have diverse configuration needs.  You may have to make your own changes the iptables on the fonera.  For me the following two iptables commands are all that is required to allow bi-directional communication from devices connected to the fonera, and the rest of the ChaosVPN.

 /usr/bin/iptables -I forwarding_rule -j ACCEPT -p all -s '0/0' -d '0/0' -i 'br-lan' -o 'chaos_vpn'
 /usr/bin/iptables -I forwarding_rule -j ACCEPT -p all -s '0/0' -d '0/0' -i 'chaos_vpn' -o 'br-lan'

Also you should throw ChaosVPN, and the iptables rules into /etc/init.d/ somewhere. I put them all in the firewalls init.d script.  This is probably wrong.  There is probably a better way.

=== Adding DNS entries ===

Create the file /etc/hosts.local and add your DNS entries, <br>
than edit /etc/config/dhcp
 option domain   'mynodeiscool.hack'
 
 option addnhosts        '/etc/hosts.local'