Offline Installation of the SmartPlayer Platform on Ubuntu / Astra Operating Systems

```markdown

Description of the Situation

This page describes the possibility of performing an independent offline installation of the SmartPlayer platform on Ubuntu and Astra operating systems.

Supported Versions

Supported Versions Table

Operating System	Operating System Distribution	Recommended for Installation
Ubuntu Server 24.04 LTS	Link	Yes
Ubuntu Server 22.04 LTS	Link	Yes
AstraLinux Orel	Link	Yes, for government institutions. Distributor ID: AstraLinuxCE Description: Astra Linux CE 2.12.43 (Orel) Release: 2.12.43 Codename: orel
Astra 1.7.9	Provided by the customer	Yes, but only in exceptional cases, as the package versions are outdated.
Astra 1.8.5	Provided by the customer	Yes.
Other platforms	Individually, through a request to managers and preliminary testing.	—

Installing the SmartPlayer Platform on Ubuntu / Astra Operating Systems Using a RUN Script

Description

A RUN script is generated by default for installing and updating the server application.
The script automatically performs all stages of installation or update of the server application. Simply download the script to the server, grant execution permissions, and run it.

wget https://jenkins_dists_first_install_platform.hb.bizmrg.com/sp_docker_installation_first_time_*.run
chmod +x sp_docker_installation_first_time_*.run
./sp_docker_installation_first_time_*.run

Before installation, the script performs diagnostics and displays warnings if the system does not meet the requirements. Some warnings can be ignored, but in that case there is no guarantee that the application will operate stably.

Example of diagnostics performed by the script

Installation

The installation package must be requested from the SmartPlayer technical support team.

During a standard launch, no additional actions are required. The archive will automatically unpack itself and install the server application. At the end of the installation process, the system will display a login and a generated password for the personal account. These credentials must be saved or recorded. They are not stored anywhere else, and the user will not be able to retrieve them again.

Since Docker is installed during the process, the installation must be performed under the root user.

SSL Certificate

When using https, a temporary ssl certificate is generated automatically. The certificate chain (ssl.crt) and private key (ssl_private.key) must be replaced in the following directory:

/home/smartplayer/smartplayer/ssl

After that, restart the smartplayer-nginx-gateway-1 container using the following command:

docker restart smartplayer-nginx-gateway-1

Update

The update package must be requested from the SmartPlayer technical support team.

When updating, the server application must be running because the script automatically locates the installation directory using active Docker containers. If this cannot be done for any reason, the directory must be specified manually.

The update process includes:

• creating a MySQL dump;
• updating Docker configurations;
• downloading new images;
• database migration;
• widget deployment.

```

Установка платформы SmartPlayer на операционные системы Ubuntu / Astra с помощью RUN скрипта

Описание

Для установки и обновления серверного приложения по умолчанию собирается RUN-скрипт.
Скрипт автоматически проходит все этапы установки/обновления серверного приложения. Достаточно просто скачать скрипт на сервер, выдать права на запуск, и запустить.
wget https://jenkins_dists_first_install_platform.hb.bizmrg.com/sp_docker_installation_first_time_*.run
chmod +x sp_docker_installation_first_time_*.run
./sp_docker_installation_first_time_*.run
Перед установкой скрипт сделает диагностику, и выдаёт замечания при несоответствии требованиям. Некоторые замечания можно проигнорировать, но в этом случае нет гарантии, что приложение будет работать стабильно.

Пример отображения диагностики проведённой скриптом

Установка

Запросить дистрибутив для установки необходимо у команды технической поддержки SmartPlayer

При обычном запуске дополнительных действий не требуется. Архив самостоятельно распакуется у установит серверное приложение. В конце выдаст логин и сгенерированный пароль от личного кабинета. Их необходимо запомнить или сохранить себе. Это связано с тем, что эти данные нигде не хранятся и пользователь не сможет получить к ним доступ снова.

Так как в процессе устанавливается docker, необходимо запускать установку под пользователем root.

Сертификат SSL

При использовании https автоматически генерируется временный сертификат ssl. Цепочку сертификатов (ssl.crt) и приватный ключ (ssl_private.key) необходимо будет заменить в директории: /home/smartplayer/smartplayer/ssl
Затем перезагрузить контейнер — smartplayer-nginx-gateway-1 с помощью команды:
docker restart smartplayer-nginx-gateway-1

Обновление

Запросить дистрибутив для обновления необходимо у команды технической поддержки SmartPlayer

При обновлении серверное приложение должно быть запущено, потому что скрипт автоматически находит директорию по запущенным контейнерам docker. Если по какой то причине сделать это не удается, то необходимо запрашивать директорию в ручном режиме. В процессе производится:

• снятие дампа mysql;
• обновление конфигураций docker;
• загрузка новых образов;
• миграция базы данных;
• загрузка виджетов