FOrcE Installation
Before getting started with Eclipse fog05 orchestation we need to install and start it
We have three possibilities for installing Eclipse fog05
- From source
- From debian packages
- Using a docker image
From source
We can now clone the Eclipse fog05 repository and build the orchestation engine
$ git clone https://github.com/eclipse-fog05/fog05 -b 0.2.x
$ cd fog05/src/force
$ make
$ sudo install -m 0755 /usr/local/bin
From debian packages
For each release .deb
files are generated for Ubuntu 18.04 LTS, and works also with newer versions of Ubuntu. Those files can be found in the release page on GitHub, and are available for x86_64
and aarch64
.
To install the force
we can simply run
$ wget https://github.com/eclipse-fog05/fog05/releases/download/v0.2.2/zenoh_0.3.0-1_amd64.deb
$ wget https://github.com/eclipse-fog05/fog05/releases/download/v0.2.2/fog05-force_0.2.2-1_amd64.deb
$ wget https://github.com/eclipse-fog05/fog05/releases/download/v0.2.2/libzenoh-0.3.0-amd64.deb
$ sudo apt install ./zenoh_0.3.0-1_amd64.deb ./libzenoh-0.3.0-amd64.deb ./fog05-force_0.2.2-1_amd64.deb
It will create the folder /etc/fos
in which we can found the configuration file force.json
and the force
, and configures the systemd service force
to start it.
The configuration file contains the address of the zenoh router used by the orchestrator.
If we have a Zenoh router running on the same machine we can modify the configuration file /etc/fos/force.json
like this:
{
"address":"0.0.0.0",
"port":"9191",
"zenoh":"tcp/127.0.0.1:7447"
}
From docker
If you have docker and docker-compose enable in you machine you can download the docker-compose.yaml
And deploy it using
$ wget https://raw.githubusercontent.com/eclipse-fog05/fog05/0.2.x/src/force/docker-compose.yaml
$ docker network create -d overlay fog05-forcenet
$ docker stack deploy -c docker-compose.yaml force
Start Eclipse fog05 force
If installed by source if shall be started by hand
$ ZENOH=<ip address of a dedicated zenoh router> force
If installed by .deb
file it can be started using systemd
To start:
$ sudo systemctl start zenoh
$ sudo systemctl start force
To stop:
$ sudo systemctl stop force
$ sudo systemctl stop zenoh
Interaction is described in fosctl usage.
Status can be checked using systemctl status force
Logs can be checked using journalctl
, journalctl -u force -f