Installation Guide¶

This document can be used as a quick start guide to setup the development environment. Please review the system requirements listed below before moving forward with the FDO installation and deployment.

System Requirements¶

Component	Recommended
Operating System	Ubuntu* 20.04 / Windows* 10
Docker* Engine	18.09
Docker* Compose	1.21.2
Maven*	3.5.4
Java	11
Haveged	-

Docker* Installation¶

Follow the steps to setup Docker* environment.

Running the Docker* Behind a Proxy¶

To run the Docker* system behind a proxy server, the configuration is done by the following steps:

1 . Directory docker.service.d is to be created in systemd directory as shown below.

mkdir -p /etc/systemd/system/docker.service.d

2 . For HTTP proxy, create a file http-proxy.conf in the above created directory and add the following content to this file.

[Service]
Environment="HTTP_PROXY=<Proxy IP/URL:Port>"

3 . For HTTPS proxy, create a file https-proxy.conf in the above created directory and add the following content to this file.

[Service]
Environment="HTTPS_PROXY=<Proxy IP/URL:Port>"

4 . Next, create a directory named .docker in the user home path (~/) and create a file named config.json if not present, add the following content.

{
    "proxies":
    {
        "default":
        {
            "httpProxy": "<Proxy IP/URL:Port>",
            "httpsProxy": "<Proxy IP/URL:Port>"
        }
    }
}

5 . After configuring the above, the Docker* service needs to be restarted.

sudo systemctl daemon-reload
sudo systemctl restart docker

6 . To ensure that the proxies are set successfully, run the following command

sudo systemctl show --property Environment docker

7 . FDO Docker* FAQs

1. Docker Time Synchronization Issue while building Ubuntu 20 docker image from an Ubuntu* 18 machine. Refer

2. Failure in device onboarding due to the inaccessibility of internet (while running Docker* behind a proxy network). Refer

Docker* Compose Installation¶

To install a specific version of Docker* Compose (for example 1.21.2) follow these steps:

1 . Download the specific version (1.21.2) of Docker* Compose.

sudo curl -L https://github.com/docker/compose/releases/download/1.21.2/docker-compose-`uname -s`-`uname -m` -o /usr/bin/docker-compose

2 . To apply executable permissions, run the following command.

sudo chmod +x /usr/bin/docker-compose

3 . To ensure that the required version is installed, run docker-compose --version command.

Other Development Tools¶

1 . To install OpenJDK*

sudo apt install openjdk-11-jdk-headless

2 . To install Maven*

sudo apt install maven

3 . To install Haveged

sudo apt install haveged

To Set Correct System Time¶

sudo date -s "$(wget -qSO- --max-redirect=0 google.com 2>&1 | grep Date: | cut -d' ' -f5-8)Z"

Ensure that the system time is correct, else you will receive the certificate expiration error.

Change the Google* domain according to your location.

References¶

Docker-installation-methods

Docker-compose-installation

Setting-proxy-for-docker

* represents proprietary software products. FDO claims no rights over the mentioned software products. Use them at your own discretion.