Deployment and Preparation of Ubuntu-Based Server

Foresight Mobile Platform works in the Docker containerization environment. Set up and deploy the Docker subsystem infrastructure on mobile platform server and on Relay server, if it is used.

To deploy a server:

1. Prepare virtualization environment if a virtual server is used. Foresight Mobile Platform supports Oracle VirtualBox, VMware Workstation and Microsoft Hyper-V.

2. Make sure that the operating system meets the system requirements.

3. Install Docker components.

4. Install the docker-compose utility to simultaneously manage several containers included in the application.

After executing the operation the server is prepared for installing a mobile platform server.

Installing Docker Components

To install Docker components:

1. Enter the server console locally or remotely using SSH client.

2. Delete earlier versions of Docker if they do not correspond to the required version:

% sudo apt remove docker.io docker docker-engine docker-compose

The specified components are possibly absent in the system.

3. Update the package index:

% sudo apt-get update

4. Install the apt-transport-https, ca-certificates prepackages to work with the HTTPS protocol, the curl tool to send data from server, software-properties-common to manage the Docker repository:

% sudo apt-get install apt-transport-https ca-certificates curl software-properties-common

5. Add official GPG key of the Docker vendor:

% curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo apt-key add -

6. Connect the Docker repository for the operating system in use:

% sudo add-apt-repository "deb [arch=amd64] https://download.docker.com/linux/ubuntu $(lsb_release -cs) stable"

If installation completed with errors, execute the command:

$ sudo add-apt-repository "deb [arch=amd64] https://download.docker.com/linux/ubuntu xenial stable"

7. Repeat packages index update:

% sudo apt-get update

8. Install Docker packages:

% sudo apt-get install docker-ce

If installation completed with errors, execute the command:

$ sudo apt-get upgrade

9. Add the current account to the Docker group of users to start containers without requesting root privileges:

% sudo usermod -aG docker $USER

10. Log out and log in again to the operating system, finish all user sessions in the console, use SSH or restart the server.

11. Check if Docker was installed correctly:

• If there is an Internet connection, execute the command:

% docker run hello-world

As a result, the test Docker image is loaded, the test container is started and the response with the operation status is obtained.

• If there is no Internet connection, execute the command:

% docker version

As a result, the response with client version and Docker component server version is obtained:

Client:
Version:
....
....

Server:
Version:
....
....

12. Delete the text container and the Docker image:

% docker container rm $(docker container ls –aq) && docker image rm $(docker image ls –aq)

After executing the operation, Docker components are installed to server.

Installing the docker-compose Utility

If Foresight Mobile Platform 25.10 is used, the docker-compose utility is included in Docker components, and additional installation is not required.

If Foresight Mobile Platform 25.03 or earlier is used, execute the commands to install the docker-compose utility:

% sudo curl -L https://github.com/docker/compose/releases/download/1.29.2/docker-compose-$(uname -s)-$(uname -m) -o /usr/local/bin/docker-compose
% sudo chmod +x /usr/local/bin/docker-compose
% docker-compose --version

After executing the operations the docker-compose is installed and the utility version title is displayed.