Other Linux Software Configuration

6LBR should work with any Linux distribution or with MacOS-X. If your distribution is not Debian-like, you might have to manually update the start-up scripts or the dependencies.

This page describes the generic Linux installation, see the RaspberryPi or BeagleBone pages for platform specific remarks.

Dependencies

The external package bridge-utils is required for the tap-bridging mode. For example for Debian, you can install it using the following command :

apt-get install bridge-utils

On MacOS-X, bridging is only supported from Lion onwards.

Binary package installation

6LBR can be installed using .deb packages. You can either build the packages yourself, or download the .deb file hosted on the 6LBR project website.

Download

We provides binary packages for Debian based BeagleBone and Raspberry. Check the releases page for the latest packages.

wget https://raw.github.com/wiki/cetic/6lbr/releases/rpi/cetic-6lbr_1.4.0_armhf.deb

installation

dpkg -i cetic-6lbr_1.3.3_armhf.deb 

Installation from sources

If you prefer to follow the latest updates rather then use the packages, you can build 6lbr from the sources. The master branch will always contain the latest tag and is a stable branch. The develop is the unstable work-in-progess, use at your own risk. Periodically, more stable snapshots are created for the develop version.

Dependencies

Git and libncurses are required for fetching and building the sources. For example for Debian, you can install them using the following command :

apt-get install git build-essential libncurses5-dev

Download

1. Obtain the latest version of 6LBR:
   

   git clone https://github.com/cetic/6lbr
   cd 6lbr
   git checkout develop-xxxxx #optional, if you plan to use a develop snapshot</pre>
   git submodule update --init --recursive
   cd examples/6lbr

build

1. In 6lbr source directory, do the following commands :
   

   make all
   make plugins
   make tools

Installation

1. Install it directly (as root)
   

   make install
   make plugins-install
   update-rc.d 6lbr defaults

Configuration

1. Chose your run mode, by default 6LBR starts up as Router, but other modes are possible, see 6LBR-Modes
2. Chose your interface configuration
3. Update the configuration file as needed using the documentation as reference.
4. Start the daemon
   

   service 6lbr start

5. Check the connectivity, once 6LBR is started you should be able to ping and reach the web server. If you’re not sure of 6LBR address, you can retrieve it in /var/log/6lbr.ip. If this file is not present or empty, that means 6LBR could not start properly
6. Configure the Runtime Parameters, e.g. your network prefix, NAT64, … in the webserver Configuration Page
7. Configure your whole network and enjoy :)