This tutorial teaches how to setup streaming hardware using two Olimex boards.

One board will be connected to the sensor and the second one will serve as an IoT-Gateway.

Note :  If the name of the slide starts with '2 *' do the action on both boards.

List of required and recommended hardware. 

This will install Re6st and SlapOS on your board. During the installation you will be asked several questions:

What is the url to the Re6st registry? (Ignore if you are using a FREEFIB Token from rapid.space) [http://re6stnet.gnet.erp5.cn/]:

In case you want to use a Re6st token, this can be simply ignored (press Enter).

Please insert your re6stnet token: [notoken]:

If you want to use a Re6st token, you can get one in the rapid.space panel with the following steps:

• Request a new software instance in your project, with the Software Release Re6st 1.0.338 (or something similar)
• Give a title to your instance and choose the Software Type Re6st Token, leave the Compute Node section blank and proceed
• Wait a few minutes, and you will see the token appear in the Connection Parameters: it is ready to use.

The next two questions can also be ignored if you want to use rapid.space as your SlapOS Master (simply press Enter):

What is the url to the SlapOS Master API?  (ignore if you already have a configured re6st and slapos): [https://slap.vifib.com/]:

What is the url to the SlapOS Master Website?  (ignore if you already have a configured re6st and slapos): [https://panel.rapid.space/]:

In this question you can enter the name for your computer. This is the name which will appear in the SlapOS Master Panel. You may want to choose a name which makes it easy for you to recognize the respective board (for example "Wendelin-Olimex-IoT-Gateway"). Please do not include spaces in the name here.

Name your computer (ignore if you already have a configured re6st and slapos or if you don't want to register your computer to SlapOS Master): [noname]:

Next, to get a SlapOS token, go to your project's main page on the SlapOS Panel, and click on Add Compute Node Token. A new token will be generated, and displayed on the line Your Token.

Input your slapos token (ignore if you already have a configured slapos) [notoken]:

You can ignore the next question (because you will use Re6st):

Which interface will provide IPv6? (ignore if you already have a configured re6st) [lo]:

The last setting can also be left to the default value (simply press Enter):

How many SlapOS computer partitions would you like? [10]:

Now you will have to wait until the installation is finished.

To ensure the installation was successful you can run:

slapos node status

This should return something similar to:

watchdog                         RUNNING   pid 8936, uptime 0:02:36

Your IoT Gateway is ready now

Open the file /etc/opt/slapos/slapos.cfg. Go down until you find the following section:

#download-from-binary-cache-force-url-list =
#  https://lab.nexedi.com/nexedi/slapos/raw/1.0.
#  https://lab.node.vifib.com/nexedi/slapos/raw/1.0.

Uncomment these three lines, so that it looks like this:

download-from-binary-cache-force-url-list =
  https://lab.nexedi.com/nexedi/slapos/raw/1.0.
  https://lab.node.vifib.com/nexedi/slapos/raw/1.0.

Then save the file and proceed to the next tutorial in the learning track.

Note: The reason why this change is necessary is because shacache runs only 8 threads. So when all threads all already occupied, SlapOS is not able to download binaries and decides to compile everything. This behaviour is quite acceptable for most cases but not for Single Board Computers so you should force SlapOS to retry to download binaries from shacache until it succeeds (or find that the SR is not available in shacache).

#!/usr/bin/bash

# Set default policy to accept
iptables -P INPUT ACCEPT
iptables -P OUTPUT ACCEPT
iptables -P FORWARD ACCEPT

ip6tables -P INPUT ACCEPT
ip6tables -P OUTPUT ACCEPT
ip6tables -P FORWARD ACCEPT

# Flush all existing rules
iptables -F
ip6tables -F

You can manually reactivate the firewall with the following command:

sudo setup-olimex-firewall