User Tools

Site Tools


Joining Community-Lab

Part of this process is covered here. However, we are reproducing all the steps with more detail.

Creating an account

The first step is to register yourself in the Community-Lab Controller. If you already have a registered user you can skip this step.

Browse to and click on Create an account.

 Community-Lab panel

Fill in the registration form and press the sing up button.

 Registering new user

This confirmation message will appear:

 New user registered

You will receive an email to validate your account like the following:

Hi, welcome to
Please, validate your email using the link below:
You have 7 days remaining to activate your account.
The Community-lab operations team.

After you click on the link included in the email, the following user confirmation message will be shown:  User register confirmation

Finally, after clicking the home link, you will have full access to the Community-Lab dashboard.

 Community-Lab dashboard

Adding a computer to the management network

Every RD and sliver in Community-Lab belongs to an overlay IPv6 network called the Management Network (MN) that has been deployed using TINC VPN. If your workstation also joins the MN, it will be easier for you to interact with the slivers or nodes.

Joining the MN implies registering your workstation as a TINC host on the Controller and install, configure and start the TINC service on your machine.

You can register your workstation on the controller in the TINC Hosts tab.

 adding computer

Then, if you click the Help button you will also get some instructions like the following ones to configure your computer (please use the values shown in your help page instead of the sample ones given below):

Install dependencies

apt-get install tinc iproute

Create and configure the tinc network

# Create and configure the communitylab network
mkdir /etc/tinc/communitylab
echo 'Name = host_181
ConnectTo = server
ConnectTo = gateway_2' > /etc/tinc/communitylab/tinc.conf
mkdir /etc/tinc/communitylab/hosts
echo 'Subnet = fdf5:5351:1dfd:0:2000:0:0:b5
-----END RSA PUBLIC KEY-----' > /etc/tinc/communitylab/hosts/host_181
echo 'Address = 655
Address = 655
Subnet = fdf5:5351:1dfd:0:0:0:0:2
-----END RSA PUBLIC KEY-----' > /etc/tinc/communitylab/hosts/server
echo 'Address = 656
Subnet = fdf5:5351:1dfd:0:1:0:0:2
-----END RSA PUBLIC KEY-----' > /etc/tinc/communitylab/hosts/gateway_2
# Create scripts for setting up and down the network interface
echo '#!/bin/sh
ip -6 link set "$INTERFACE" up mtu 1400
ip -6 addr add fdf5:5351:1dfd:0:2000::b5/48 dev "$INTERFACE"
' > /etc/tinc/communitylab/tinc-up
echo '#!/bin/sh
ip -6 addr del fdf5:5351:1dfd:0:2000::b5/48 dev "$INTERFACE"
ip -6 link set "$INTERFACE" down
' > /etc/tinc/communitylab/tinc-down
# Make the scripts executable
chmod a+rx /etc/tinc/communitylab/tinc-{up,down}

Generate the key and upload it to the server

# Generate the RSA key pair for your host
tincd -n communitylab -K

Now you have to upload your public key to your host page. You can find the key at the end of /etc/tinc/communitylab/hosts/host_<HOST_ID> file. Copy and paste it in the corresponding space and click the save and continue editing button.

 upload key

Start tinc daemon

# Enable communitylab network to automatically start on boot
echo communitylab >> /etc/tinc/nets.boot
# Restart the tinc service in order to apply the new configuration
/etc/init.d/tinc restart
# Try if your connection is working by ping the server
ping6 fdf5:5351:1dfd::2

Here you can find more details about the activation of TINC on your computer.

With a working TINC connection you should see your host address in green. It means that the controller can ping your workstation, and you can ping or SSH other nodes using their IPv6 address in the MN.  Working Tinc Connection

Getting support

Please, go to this page if you want to find out how to get support.

Click here to go to the next section of this part of the tutorial or click the next link if you rather want to go back to the Tutorials Main Page.

cl-tutorial/second_b.txt · Last modified: 2015/10/20 12:52 by ivilata