|
Size: 3512
Comment:
|
Size: 4152
Comment:
|
| Deletions are marked like this. | Additions are marked like this. |
| Line 1: | Line 1: |
| = Download and install netsukuku on a ubuntu machine = | = Cross-compile the firmware for your router from a ubuntu machine = |
| Line 3: | Line 3: |
| Install packages for building. | A basic knowldge of the procedure of compiling a !OpenWrt firmware and flashing your router is a prerequisite for this task. Make sure that you have the needed software installed in your system. |
| Line 6: | Line 9: |
| sudo apt-get install build-essential -y && sudo apt-get install pkg-config -y && sudo apt-get install libglib2.0-dev libpth-dev libgee-0.8-dev -y && sudo apt-get install libgcrypt20-dev -y && echo ok |
sudo apt-get update sudo apt-get install build-essential subversion git-core libncurses5-dev gawk wget gettext |
| Line 13: | Line 13: |
| Prepare a directory for compilation. | == Download == First, we download !OpenWrt. The version we tested this was svn revision 39211. |
| Line 16: | Line 18: |
| mkdir ~/netsukuku-dev cd ~/netsukuku-dev for pkg in tasklet-0.9.tar.gz zcd-0.9.tar.gz netsukuku-rpc-0.9.tar.gz \ andns-rpc-0.9.tar.gz ntkresolv-0.9.tar.gz netsukuku-0.9.tar.gz do wget http://download.savannah.gnu.org/releases/netsukuku/${pkg} tar xf ${pkg} done |
mkdir ~/openwrt cd ~/openwrt svn -r 39211 co svn://svn.openwrt.org/openwrt/trunk workdir cd workdir # Revision 39211 needs patches: # http://patchwork.openwrt.org/patch/4588/ wget -O - http://patchwork.openwrt.org/patch/4588/raw | patch -p1 ./scripts/feeds update -a ./scripts/feeds install -a |
| Line 26: | Line 29: |
| Compile. | Now download and apply a patch to the !OpenWrt configuration files in order to make its build system download and build netsukuku. |
| Line 29: | Line 33: |
| cd ~/netsukuku-dev/tasklet-0.9 && ./configure --enable-logtasklet --prefix=/usr && make && make check && sudo make install cd ~/netsukuku-dev/zcd-0.9 && ./configure --enable-logtasklet --prefix=/usr && make && sudo make install cd ~/netsukuku-dev/netsukuku-rpc-0.9 && ./configure --enable-logtasklet --prefix=/usr && make && sudo make install cd ~/netsukuku-dev/andns-rpc-0.9 && ./configure --enable-logtasklet --prefix=/usr && make && make check && sudo make install cd ~/netsukuku-dev/ntkresolv-0.9 && ./configure --enable-logtasklet --prefix=/usr --sysconfdir=/etc && make && make check && sudo make install cd ~/netsukuku-dev/netsukuku-0.9 && ./configure --enable-logtasklet --prefix=/usr --sysconfdir=/etc && make && make check && sudo make install |
wget -O - http://download.savannah.gnu.org/releases/netsukuku/openwrt-39211-netsukuku-0.9.patch 2>/dev/null | patch -p0 |
| Line 69: | Line 36: |
| == Configure machine to resolve names == | == Build == |
| Line 71: | Line 38: |
| You can see a sample configuration of the resolver library in /usr/share/doc/ntkresolv/ntkresolv.ini.sample You have to edit the configuration file in /etc/ntkresolv/ntkresolv.ini |
We prepare to compile !OpenWrt with Netsukuku. |
| Line 78: | Line 41: |
| sudo vi /etc/ntkresolv/ntkresolv.ini | make menuconfig |
| Line 81: | Line 44: |
| Configure like this: | Select your Target, Subtarget and Profile (e.g. Atheros AR7xxx/AR9xxx - Generic - TP-LINK TL-WR1043N/ND) We have to produce the binaries with eglibc instead of uClibc. <<BR>> For this, select "Advanced configuration options". <<BR>> Inside it, select "Toolchain Options". <<BR>> Inside it, as C Library implementation choose eglibc 2.15. Inside category {{{Network}}}, select package {{{netsukuku}}} It is optional to activate the !OpenWrt web interface. You find it inside {{{LuCI}}}, {{{Collections}}}, {{{luci}}} Build with: |
| Line 84: | Line 63: |
| [NTKRESOLV] ANDNASERVER=127.0.0.1 |
ionice -c 3 nice -n 20 make |
| Line 88: | Line 66: |
| To instruct your system resolver to use ANDNA edit the configuration file /etc/nsswitch.conf and place "andna [NOTFOUND=return]" before "dns" in the |
After approx. 90 minutes (+ download time of various pkgs) you will find your new firmware in ./bin/ar71xx-eglibc. Flash your router. Then connect to it and configure as you like the usual bits. The password for root, the IP address of your LAN and the wireless settings (SSID, channel, security, ...) <<BR>> For this steps refer to documentation of !OperWrt that you can find online. == Configure Netsukuku == Connect to the router as root. Edit the configuration file /etc/nsswitch.conf and place "andna [NOTFOUND=return]" before "dns" in the |
| Line 93: | Line 85: |
| sudo vi /etc/nsswitch.conf | vi /etc/nsswitch.conf |
| Line 96: | Line 88: |
| There should be a line like this: | Configure dnsmasq so that it listens on port 53 but only for its real IP, e.g. 192.168.2.1. <<BR>> The requests are to be forwarded to 127.0.0.1 on port 53 where we will listen with dns-to-andna. |
| Line 99: | Line 93: |
| hosts: files andna [NOTFOUND=return] dns | vi /etc/dnsmasq.conf |
| Line 102: | Line 96: |
| == Configure the daemon settings == There are a few settings that are configurable and influence the behaviour of the daemon. See a sample file in /usr/share/doc/netsukuku/ntkd.ini.sample The settings are in /etc/netsukuku/ntkd.ini Change settings only if you do know what you are doing. |
The file has to include these lines: |
| Line 115: | Line 99: |
| sudo vi /etc/netsukuku/ntkd.ini | listen-address=192.168.2.1 bind-interfaces no-resolv server=127.0.0.1 |
| Line 118: | Line 105: |
| == Start / stop the daemon == | Configure /etc/resolv.conf so that it points to the real DNS server, e.g. 8.8.8.8. <<BR>> On !OpenWrt /etc/resolv.conf is usually a symlink. Make it persistent and modify. |
| Line 120: | Line 109: |
| Open a terminal. | {{{ cd /etc cp resolv.conf real.resolv.conf rm resolv.conf mv real.resolv.conf resolv.conf vi resolv.conf }}} Configure /etc/ntkresolv/ntkresolv.ini so that DNS_TO_ANDNA listens to 127.0.0.1. {{{ vi /etc/ntkresolv/ntkresolv.ini }}} The file has to include the line: {{{ DNS_TO_ANDNA=127.0.0.1 }}} == Start / stop the daemon and the DNS redirector == Open a terminal and connect to the router as root. |
| Line 123: | Line 135: |
| For instance you can have one or more ethernet ports in your computer. <<BR>> You can have a WiFi card. In this case connect to a wireless network before launching the daemon. |
For !OpenWrt this is usually {{{br-lan}}}. |
| Line 134: | Line 143: |
| Launch the daemon with the NICs you want to use (eth0, eth1, wlan0, ...) | Launch the daemon with the NICs you want to use. |
| Line 137: | Line 146: |
| sudo ntkd -i eth0 -i eth1 -i wlan0 | ntkd -i br-lan |
| Line 145: | Line 154: |
| === Test the network === | Open another terminal and connect to the router as root. |
| Line 147: | Line 156: |
| From another terminal check your IP configuration. | Launch the DNS redirector. |
| Line 150: | Line 159: |
| ip a ip r list table ntk |
dns-to-andna |
| Line 154: | Line 162: |
| Also verify that you have registered a name. <<BR>> For example, if your computer has hostname 'mylaptop' then it should have tried to register the name 'mylaptop.ntk'. |
The redirector will not exit, so you have to leave the terminal open. |
| Line 159: | Line 164: |
| {{{ ping mylaptop.ntk }}} |
== Test == Now you should be able to connect even a unsupported device (android, mac, windows) and reach netsukuku nodes. |
Cross-compile the firmware for your router from a ubuntu machine
A basic knowldge of the procedure of compiling a OpenWrt firmware and flashing your router is a prerequisite for this task.
Make sure that you have the needed software installed in your system.
sudo apt-get update sudo apt-get install build-essential subversion git-core libncurses5-dev gawk wget gettext
Download
First, we download OpenWrt. The version we tested this was svn revision 39211.
mkdir ~/openwrt cd ~/openwrt svn -r 39211 co svn://svn.openwrt.org/openwrt/trunk workdir cd workdir # Revision 39211 needs patches: # http://patchwork.openwrt.org/patch/4588/ wget -O - http://patchwork.openwrt.org/patch/4588/raw | patch -p1 ./scripts/feeds update -a ./scripts/feeds install -a
Now download and apply a patch to the OpenWrt configuration files in order to make its build system download and build netsukuku.
wget -O - http://download.savannah.gnu.org/releases/netsukuku/openwrt-39211-netsukuku-0.9.patch 2>/dev/null | patch -p0
Build
We prepare to compile OpenWrt with Netsukuku.
make menuconfig
Select your Target, Subtarget and Profile (e.g. Atheros AR7xxx/AR9xxx - Generic - TP-LINK TL-WR1043N/ND)
We have to produce the binaries with eglibc instead of uClibc.
For this, select "Advanced configuration options".
Inside it, select "Toolchain Options".
Inside it, as C Library implementation choose eglibc 2.15.
Inside category Network, select package netsukuku
It is optional to activate the OpenWrt web interface. You find it inside LuCI, Collections, luci
Build with:
ionice -c 3 nice -n 20 make
After approx. 90 minutes (+ download time of various pkgs) you will find your new firmware in ./bin/ar71xx-eglibc.
Flash your router.
Then connect to it and configure as you like the usual bits. The password for root, the IP address of your LAN and the wireless settings (SSID, channel, security, ...)
For this steps refer to documentation of OperWrt that you can find online.
Configure Netsukuku
Connect to the router as root.
Edit the configuration file /etc/nsswitch.conf and place "andna [NOTFOUND=return]" before "dns" in the line for the database "hosts".
vi /etc/nsswitch.conf
Configure dnsmasq so that it listens on port 53 but only for its real IP, e.g. 192.168.2.1.
The requests are to be forwarded to 127.0.0.1 on port 53 where we will listen with dns-to-andna.
vi /etc/dnsmasq.conf
The file has to include these lines:
listen-address=192.168.2.1 bind-interfaces no-resolv server=127.0.0.1
Configure /etc/resolv.conf so that it points to the real DNS server, e.g. 8.8.8.8.
On OpenWrt /etc/resolv.conf is usually a symlink. Make it persistent and modify.
cd /etc cp resolv.conf real.resolv.conf rm resolv.conf mv real.resolv.conf resolv.conf vi resolv.conf
Configure /etc/ntkresolv/ntkresolv.ini so that DNS_TO_ANDNA listens to 127.0.0.1.
vi /etc/ntkresolv/ntkresolv.ini
The file has to include the line:
DNS_TO_ANDNA=127.0.0.1
Start / stop the daemon and the DNS redirector
Open a terminal and connect to the router as root.
You have to know which network cards (NIC) you want to handle with netsukuku. For OpenWrt this is usually br-lan.
Find the name of the NICs with
ip l
Launch the daemon with the NICs you want to use.
ntkd -i br-lan
The daemon will not exit, so you have to leave the terminal open.
When you want to stop the daemon and exit netsukuku, press CTRL-C and it will remove all the configurations that it had set up.
Open another terminal and connect to the router as root.
Launch the DNS redirector.
dns-to-andna
The redirector will not exit, so you have to leave the terminal open.
Test
Now you should be able to connect even a unsupported device (android, mac, windows) and reach netsukuku nodes.