Part 1: Preparing server environment#

This part describes the process of preparing the server environment for successful platform installation.

Note

If Ubuntu 20.04 is installed while NVIDIA GPU is plugged in, the latest NVIDIA GPU driver will be installed automatically.

If you plug in the NVIDIA GPU to your system after OS installation you must install the NVIDIA GPU driver manually.

Make sure your server is exclusively used for the Intel® Geti™ platform.

On the server, open a terminal and execute the following steps.

Step 1: Ensure using a sudo account to install the Intel® Geti™ platform#

The user’s account used to install the platform requires administrative privileges and must be included in the sudoers lists. Ensure it is present in /etc/sudoers.

If not, create the new account:

adduser <username>

or

sudo adduser <username>

add it to group sudo:

usermod -aG sudo <username> or sudo usermod -aG sudo <username>

and then log out and log in again with your newly created account.

Check sudo by clearing the sudo cache:

sudo -k

and by running any command with sudo, e.g.:

sudo ls

This command should simply work.

Ensure that /dev/mem is accessible by the root user.

You can check it by running the following command and observing if it returns permission errors:

sudo head /dev/mem

Step 2: (Optional) Configure proxy#

Note

Complete this step only if your Intel® Geti™ server will access the internet from behind a proxy.

  1. One way to configure a proxy is to create a file /etc/environment, e.g. with vi:

    sudo vi /etc/environment

    With all proxies that are applicable in your case. Sample /etc/environment file:

    http_proxy=http://USERNAME:PASSWORD@SERVER:PORT/
https_proxy=http://USERNAME:PASSWORD@SERVER:PORT/
no_proxy=localhost,127.0.0.1,<Intel® Geti™ server IP address>
HTTP_PROXY=http://USERNAME:PASSWORD@SERVER:PORT/
HTTPS_PROXY=http://USERNAME:PASSWORD@SERVER:PORT/
NO_PROXY=localhost,127.0.0.1,<Intel® Geti™ server IP address>

  2. Confirm proxy settings:

    source /etc/environment
env | grep -i proxy

  3. Create file /etc/apt/apt.conf and add content:

    sudo vi /etc/apt/apt.conf
# Press i
# Copy and press [right-click] below content and edit as necessary
Acquire::http::proxy "http://USERNAME:PASSWORD@SERVER:PORT/";
Acquire::https::proxy "http://USERNAME:PASSWORD@SERVER:PORT/";
# Press [Escape]
# Press [SHIFT + ZZ]

Step 3: Create a folder where all Intel® Geti™ data will be stored#

To create a folder, run the following command:

mkdir /<path>/data

Note

<path> is a mounted drive or directory with read/write access permission and adequate storage space for the dataset that you are planning to use, e.g., run df -h.

Note

While using the Intel® Geti™ platform after the installation, if you come close to running out of space (you will receive a notification), use this command to remove some temporary files: rm -rf /data-xfs/ie_storage/imports/*

To give folder required permissions, run the following command:

chmod 750 /<path>/data

Step 4: Install curl#

To install the curl command-line tool, run:

sudo apt install curl

Note

Ubuntu by default recommends using snap package manager for curl installation, but we strongly recommend using apt.

To verify if curl has been installed correctly, run the following command:

curl --version

Once curl is installed, ensure it can access the Internet when run as sudo:

sudo curl -I https://www.google.com/

Step 5: Install NVIDIA GPU drivers#

  1. Check NVIDIA GPU driver.

    nvidia-smi

    If nvidia-smi is not installed in the system, install NVIDIA GPU driver. The recommended version is 525 (nvidia-driver-525).

    Run the commands below:

    sudo apt install nvidia-dkms-525
sudo apt install nvidia-driver-525

  2. Reboot the system after installing the drivers so that they load into the kernel.

    sudo reboot

  3. Set up NVIDIA Container Toolkit with a stable repository and GPG key.

    # Check if NVIDIA gpgkey is added to the apt-key repository
apt-key list
# Look for NVIDIA Corporation entry
# If NVIDIA is not listed, run:
curl -s -L https://nvidia.github.io/nvidia-docker/gpgkey | sudo apt-key add -

Note

Intel, the Intel logo, and other Intel marks are trademarks of Intel Corporation or its subsidiaries. Other names and brands may be claimed as the property of others.