Procedure for setup of ELIOT - Virtual Environment using ThinOS:
Pre-requisites
Hardware Level:
x86_64 / arm64 hardware
Software Level:
Ubuntu OS running as VM / Bare Metal
Ubuntu OS version should be 16.04 and above
From Deployment script,
| Panel |
|---|
$ git clone https://gerrit.akraino.org/r/eliot |
Create a folder in $HOME , then do above step
Configurations in eliot_setup.sh
Modify the upcoming variables in eliot_setup.sh according to you ELIOT edge node specifications
- edgenode_password This should be password of where you want to setup your Edge node
- edgenode_username This should be username of where you want to setup your Edge node
- edgenode_ip This should be IP address of where you want to setup your Edge node
Configurations in thin_os_setup.sh
tap value can be tap0 or tap1 ,etc.
Check your ifconfig first and ensure that your tap name is not existed before.
edge_node_ip_pattern - This has to be 'inet <your_edge_node_ip_address>'
Run the script eliot_setup.sh only.
In this process, ELIOT Manager will setup the ELIOT edge node and also provides the overall setup for ELIOT
| Note |
|---|
No need to explicitly invoke the thin_os_setup.sh. In the eliot_setup.sh, thin_os_setup.sh will be invoked automatically. |
After Thinos vm(edge node vm) is installed,
Give login credentials the thinos vm created in edge node
login name as root
Password as root
Configuring the networking for ThinOS VM:
| Panel |
|---|
$ ifconfig eth0 192.168.100.100 |
| Note |
|---|
192.168.100.100 - Private IP address for ThinOS VM |
| Panel |
|---|
$ route add default gw <tap_interface_address> |
| Note |
|---|
This should be the same address which is used to assign the tap interface in edge node on the thin_os_setup.sh in the following line which is executed already. Example in our case, it is $ ifconfig tap0 192.168.100.1 Currently supported Platforms:The deployment script for ELIOT edge node and ELIOT Master node setup is currently suitable for the x86_64 and arm64 machines Common errors to neglect:The following errors may occur after downloading disk.qcow2 - thinos image file from public server RTNETLINK answers: Operation not permitted |
Troubleshooting:
If eliot_setup.sh failed due to some error, while installing/downloading the lightweight os, you have to do the following in ELIOT edge node.
Delete the newly created tap interface if it is created
If your created tap interface name is tap0,
| Panel |
|---|
$ sudo ip link del tap0 |
Remove the created disk.qcow2 file
| Panel |
|---|
$ cd eliot/src $ sudo rm disk.qcow2 |
Kill your running thin_os_setup.sh process by finding pid of it
| Panel |
|---|
$ ps -eaf | grep thin_os $ kill -9 <pid> |
Counter-measures for some errors which might occur while Installing:
If you encounter "Bad argument MASQUERADE" error while running script, then do the following
| Panel |
|---|
$ cd src $ sudo rm nic.txt ( or ) $ cp /dev/null nic.txt |
ELIOT Deployments in Virtual Environments Overview
...