Part 3: Installation of the platform#

This part of the guide describes the process of setting up a server environment and simplified platform installation instructions.

Note

Please contact your Intel® Geti™ account representative or technical support personnel if you have any questions.

Note

Use the workstation where the Intel® Geti™ platform is installed and hosted solely for the Intel® Geti™ platform. Do not run any other software in parallel on that same machine. To learn more, go to the Best Practices page.

Installing the Intel® Geti™ platform#

The platform is installed on the machine where the installer is executed.

To start the installation, log in to your Ubuntu machine and make sure that all the hardware, software, network, and security prerequisites are met.

The first step is to download and extract the Intel® Geti™ installation package on your previously prepared server.

tar -xf <package>.tar.gz

Warning

Before extracting the package, ensure you do not have the previous platform_<VERSION> folder in the same location.

Go into the folder created by the previous command:

cd platform_<VERSION>

Now, you can choose between two modes of installation:

with wizard - where the installer asks a user for all data needed during the installation process
with configuration file - where a user must fill in all the data prior to running the installer

If you decide to install Intel® Geti™ platform on a machine without access to the Internet - please execute the steps described in the installation-on-a-machine-without-access-to-the-internet-additional-steps section. If not - you can go directly to the next sections - when we describe the two installation modes.

Installation on a machine without access to the Internet - additional steps#

While installing the Intel® Geti™ platform on a machine without access to the Internet - it is required to install some dependencies that are not a part of the installer. This process requires access to another machine - with access to the Internet (operations performed on this machine are described in the II point). To do this - please execute the following steps:

I. On a machine where Intel® Geti™ is going to be installed

Check the version of Python interpreter. It can be done by executing the following command on this machine:

python3 --version

II. On machine with access to the Internet - please collect all required Python packages:

Note

For this step please use the same OS version as is installed on a machine where Intel® Geti™ is going to be installed.

Create a new folder to keep all downloaded packages:
```
mkdir ./pip_packages
```
Go to this folder:
```
cd ./pip_packages
```
Create in this folder a virtual environment using the following command (if virtualenv component is not installed on this machine - please install it based on suggestions given by this command):
```
python3 -m venv .venv
```
Activate the virtual environment:
```
source .venv/bin/activate
```
Download required packages:

if the Python version obtained in the 1st step is 3.10 or lower - execute the following command:
```
pip download ansible==6.4.0 kubernetes==24.2.0 jmespath==0.9.5 passlib==1.7.4
```
if the Python version is greater than 3.10 - use the following command:
```
pip download ansible==10.3.0 kubernetes==24.2.0 jmespath==0.9.5 passlib==1.7.4
```
Deactivate and remove the virtual enviornment - using the following commands:
```
deactivate
rm -rf .venv
```
If the OS on the machine where Intel® Geti™ is going to be installed is a version of Ubuntu - download packages required to create virtual env:

Note

This step is not required if you are going to install the Geti™ platform on a machine with RedHat OS.

Note

This step has to be executed on a machine with the same OS as installed on a machine where Geti™ platform is going to be installed.

create a new folder to keep downloaded .deb files:
```
mkdir ./deb_packages
```
download required packages using the following command:
```
cd ./deb_packages && sudo apt-get download $(sudo apt-cache depends --recurse --no-recommends --no-suggests --no-conflicts --no-breaks --no-replaces --no-enhances --no-pre-depends python3-venv | grep "^\w") && cd ..
```

III. On a machine where Intel® Geti™ is going to be installed

If the OS on the machine is a version of Ubuntu - installation of system packages needed to create virtual environment is required:

Note

This step is not required if you are going to install the Geti™ platform on a machine with RedHat OS.

create a new folder to copy there downloaded .deb files:
```
mkdir ./deb_packages
```
copy the whole content of the folder created in the 8th step into this newly created folder

install copied packages using the following command:
```
sudo dpkg -i ./deb_packages/*.deb
```
Note

When this command is executed on Ubuntu 24.04 and higher - it may display some errors related to dependency issues - however they are usually doesn’t affect installation of packages.
Create a new folder in the folder where Intel® Geti™ installer has been extracted:
```
cd platform_<VERSION>
mkdir ./pip_packages
```
Copy the whole content of the folder created in the 2nd step into this newly created folder
Staying in the folder with Intel® Geti™ installer - create a new virtual environment:
```
python3 -m venv .venv
```
Activate this virtual environment:
```
source .venv/bin/activate
```
Install all required dependencies:
```
cd ./pip_packages
pip install *.whl
```

Installation with wizard#

To start installing the platform with wizard run the following command:

sudo ./platform_installer install

You will be asked to provide the password if you are not logged in as a passwordless sudo user.

When running in the wizard mode, the installer will prompt for the following data:

Admin username and password

The installer asks for the name of the administrator user that will be created on the platform.
```
Login name (e.g. admin@my-company.com) of the user to be created during the installation:
```
The installer verifies if the format of the entered value conforms to an email address. After that, it asks for the user’s password:
```
Password (8 - 200 characters, at least one capital letter, lower letter, digit or symbol):
Repeat for confirmation:
```
The installer verifies if the entered passwords are the same and if they comply with the security constraints.
Mail server configuration

The installer asks for all the details required to configure the mail server, which is used to send email invitations to newly added users. It is assumed that this server supports TLS. If the user decides not to enter mail server data, the platform will allow to create users but will not send invitation mails.
```
Do you want to configure mail server? (y/N)
```
If the answer is ‘y’ the installer asks one by one for:
```
SMTP address (example: smtp.your_server.com):
SMTP port (default: 587):
```
Then the installer asks for the authentication data that is to be passed when sending emails.
```
SMTP username:
SMTP password:
```
Finally, the installer asks for sender information.
```
Sender's email address: (example: admin@your_server.com):
Sender's name: (example: Platform Admin):
```
The installer verifies if the provided configuration is correct by trying to connect to the given SMTP server. If it fails, it displays the appropriate message and asks for the mail server details again.
Custom SSL certificate
```
Do you want to configure your custom SSL certificate? (y/N)
```
If the answer is ‘y’ the installer asks one by one for:
```
Path to the certificate file:
Path to the key file:
```
Only full chain certificates are supported. Key files cannot be encrypted.

The installer verifies if the provided paths point to an existing file. If not, it displays an appropriate message and asks for the path again.
Datasets location

The installer asks for the path to a data storage folder
```
Path to the data storage (e.g. /datasets):
```
Ensure that the entire directory path, starting from the root to the location, which you you plan to use for the data storage, does not contain spaces in any of its folders’ names.

The installer verifies if the provided path points to an existing folder with proper permissions and if this folder is empty. If not, it displays an appropriate message and asks for the path again.
Grafana stack configuration

Grafana is a data visualization and monitoring tool. Based on collected platform logs and metrics, it helps to better understand in-app user behaviour and understand platforms usage thanks to customizable dashboards.

Note

Installation of the Grafana stack is possible only on machines with access to the Internet - as its components are not a part of the Intel® Geti™ installation package.
```
Do you want to install the Grafana stack (not recommended on setups meeting only the minimum HW requirements)? This option is available only when the machine on which the platform is being installed has access to the Internet. [y/N]
```
If the answer is ‘y’, the Grafana stack will be installed on the platform. If the answer is ‘N’, the Grafana stack will not be installed on the platform.
Final confirmation

The installer displays the data it gathered and asks for confirmation. If it is given, it starts the installation process. If not, the installation is aborted.
The installer creates all the configuration files based on the user’s input and starts the installation process.
Watch for warnings or error messages displayed during the process and act accordingly.

Installation with configuration file#

To start installing the platform without the user interaction run the following command:

sudo ./platform_installer install --config-file <YOUR_CONFIG_FILE>

The configuration file is a yaml file with all configuration data specified in advance. The template for the file has the following initial content:

# YAML format. E.g., when a field value starts with a special character, it must be quoted.
# Name of the first user that will be created on the platform
# (email format, e.g. admin@my-company.com)
user_login:
# Password for the user specified by user_login
# (8 - 200 characters, at least one capital letter, lower letter, digit or symbol):
user_password:

# Mail server configuration
# If smtp_address is empty or the entry is missing the remaining mail server entries will be ignored
# and the mail server will not be configured
# Example entries:
# smtp_address: smtp.your_server.com
# smtp_port: 587
# smtp_username: admin@your_server.com
# smtp_password: ******
# sender_address: admin@your_server.com
# sender_name: Platform Admin
smtp_address:
smtp_port:
smtp_username:
smtp_password:
sender_address:
sender_name:

# Specifies whether the Grafana stack will be installed on the platform.
# Not recommended on setups meeting only the minimum HW requirements.
# Allowed values: true or false
# If set to true, the Grafana stack will be installed on the platform.
# If set to false or when value or entry is missing, the Grafana stack will not be installed on the platform.
grafana_enabled:

# Path to the custom SSL certificate file
# If empty or entry missing the custom SSL certificate will not be configured
cert_file:
# Full path to the custom private key file
# Ignored if cert_file empty or missing
key_file:

# Path to the data folder, empty prior to running the installation (e.g. /data)
# Ensure that the entire directory path, starting from the root to the location, which you you plan to use for
# the data storage, does not contain spaces in any of its folders' names.
data_folder:

Sample file the installation:

user_login: admin@my-company.com
user_password: fancy-password
data_folder: /data
cert_file: /home/my-user/domain.crt
key_file: /home/my-user/domain.rsa