Secure, Reliable, Fast

Application Delivery Service

CRM, ERP ... Core Applications

Anytime, Anywhere

Setuping GrandeNet ADN on your Server or Computer

This document describes how to setup GrandeNet ADN on your Computer or Server, running the Linux. If you want to install on NayuOS, please follow this other tutorial: Howto Setup Grandenet On NayuOS

You can check the list of officially supported distributions on this link:

This guide can be followed if you received your token by email as a Free Trial or if you got the token after request your ADN Setup on your Grandenet Account.

Preparation (optional)

The only software required to be pre-installed is wget, however it is already present on mostly of linux distributions. If you don't have it you can install with the one of the followed commands (depending of your linux):

  • On debian/ubuntu or any 'apt-get' like system:
root@localhost:~# apt-get install wget
  • On redhat/centos or any 'yum' like system:
root@localhost:~# yum install wget

The installation of Re6st (network agent)

Once you got the Token, you need to run the follow command (as root):

root@localhost:~#  wget http://deploy.erp5.cn/gnet/re6st; bash re6st

After some time, you are going to be asked by the token you received:

Insert your re6st token if you have (ignore if you already have a configured re6st): 

You can copy and paste the token, just make sure you don't introduce additional spaces before or after the token. After you press enter, the installation should finish without errors.

After a while (from 1 to 5 min) the re6st is installed and configured on your host machine.

Checking if Re6st is running

After the installation finishes, you can check if re6st is running:

root@localhost:~# service re6stnet status
re6stnet.service - (null)
        Loaded: loaded (/etc/init.d/re6stnet)
        Active: active (running) since Tue 2016-08-16 04:26:48 EDT; 5min ago
        Process: 512 ExecStart=/etc/init.d/re6stnet start (code=exited, status=0/SUCCESS)
        CGroup: /system.slice/re6stnet.service
                ├─ 623 /opt/re6st/parts/python2.7/bin/python2.7 /usr/sbin/re6stnet @re6stnet.conf
                ├─ 823 openvpn --dev-type tap --dev re6stnet-tcp --persist-tun --persist-key --script-security 2 --up /opt/re6st/eggs/re6stnet-0.461-py2.7.egg/re6st/ovpn-client --tls-server --mode server --client-...
        ├─ 834 babeld -h 15 -H 15 -L /var/log/re6stnet/babeld.log -S /var/lib/re6stnet/babeld.state -I /var/run/re6stnet/babeld.pid -s -C ipv6-subtrees true -C default max-rtt-penalty 5000 rtt-max 500 rtt-...

You can also verify if a re6stnet-tcp interface is created:

root@localhost:~# ifconfig re6stnet-tcp
re6stnet-tcp Link encap:Ethernet  HWaddr 72:8e:8b:28:b6:32  
          inet6 addr: fe80::708e:8bff:fe28:b632/64 Scope:Link
          UP BROADCAST RUNNING MULTICAST  MTU:1500  Metric:1
          RX packets:678779 errors:0 dropped:0 overruns:0 frame:0
          TX packets:670212 errors:0 dropped:0 overruns:0 carrier:0
          collisions:0 txqueuelen:100 
          RX bytes:257902283 (245.9 MiB)  TX bytes:95583566 (91.1 MiB)

And also check if re6st included an ipv6 on "lo" interface with the suffix "2401:5180:0:"

root@localhost:~# ip -6 a l dev lo
1: lo: <LOOPBACK,UP,LOWER_UP> mtu 65536 
    inet6 2401:5180:0:9999::1/64 scope global 
       valid_lft forever preferred_lft forever
    inet6 ::1/128 scope host 
       valid_lft forever preferred_lft forever

On the first run can delay a bit to start to work, about 5 to 10 minutes (there are cases which it can take much longer), we are working to make the bootstrap phase faster. Once you computer finally joins to the re6st network, your ping6 may works:

 root@localhost:~# ping6 2401:5180:0::1
PING 2401:5180:0::1(2401:5180::1) 56 data bytes
64 bytes from 2401:5180::1: icmp_seq=1 ttl=64 time=45.6 ms
64 bytes from 2401:5180::1: icmp_seq=2 ttl=64 time=46.0 ms
...

In case your ICMP is blocked, you can use wget for example:

root@localhost:~#  wget http://[2001:67c:1254::bd5e]:8080/notfound.html
--2016-08-19 20:18:40-- http://[2001:67c:1254::bd5e]:8080/notfound.html/
Connecting to [2001:67c:1254::bd5e]:8080 ... connected.
HTTP request sent, awaiting response... 200 OK
Length: 1495 (1.5K) [text/html]
Saving to: `notfound.html'

100%[===========================================================================================================>] 1,495 --.-K/s in 0s

2016-08-19 20:18:41 (10.2 MB/s) - `index.html' saved [1495/1495]

Accessing External IPv6 (optional)

By default your IPv6 network is limited to all others members of the Grandenet network, so you don't have access by default to others services running on IPv6 which don't have Grandenet.

In order to enable the access to external networks, include "default" at /etc/re6stnet/re6stnet.conf. Be carefull, as this makes your machine exposed to any IPv6 network, and the connection to Non-Grandenet members are not OPTIMISED.

What's next?

After the re6st, starts this IPv6 network you join will be used to intercommunicate with the frontend servers. By using Grandenet ADN on your computer, your connection with the frontend and other users of the Grandenet ADN can be improved up to 80% in certain cases.

Now learn how to setup a local service and connect it using GrandeNet Frontends: