Eclipse fog05 logo

FOrcE Installation

Edit on GitHub

Before getting started with Eclipse fog05 orchestation we need to install and start it

We have three possibilities for installing Eclipse fog05

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

Next up: Hello World!