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 a mobile platform server and on a 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.

Preparing Virtualization Environment

Consider creating a virtual machine on a local computer by means of the Oracle VirtualBox 7.0.20 virtualization software.

To prepare virtualization environment:

1. Download the Ubuntu OS ISO image with 22.04 version.

2. Create a virtual machine in Oracle VirtualBox using the Create Virtual Machine dialog box:

Set the parameters:

• On the Virtual Machine Name and Operating System page:

• Name. Enter custom name of the virtual machine.

• Folder. Specify the path to the folder where the virtual machine will be created.

• ISO Image. Select the ISO image with Ubuntu OS downloaded at Step 1.

• On the Hardware page:

• Base Memory. Specify RAM volume. Minimum requirement - 8 GB.

• Processors. Specify the number of virtual processors. Minimum requirement - 4 processors.

• On the Virtual Hard Disk page:

• Disk Size. Specify hard disk size. Minimum requirement - 25 GB.

3. Make sure that the NAT connection type is select in virtual machine network settings and set up port forwarding, for example, the 1022 port of the local computer will correspond to the 22 port of the virtual machine:

4. Connect to the virtual machine on the local computer via SSH. To do this, select execute the command in the command line:

ssh -p <port number> <IP address>

In substitutions:

• <port number>. Specify the local computer port used at Step 3.

• <IP address>. Specify IP address of the local computer.

For example:

ssh -p 1022 127.0.0.1

After executing the operations the virtualization environment is prepared, that is, the virtual machine is created and set up on the local computer.

To exchange files between the local computer and the virtual machine, use the WinSCP or FileZilla utility.

To work with the administrator console, after installing mobile platform server set up port forwarding of the local computer and the virtual machine to the 80 port.

Installing Docker Components

To install Docker components:

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

2. Delete earlier versions of Docker:

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

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