Просмотр кода страницы Оффлайн установка платформы SmartPlayer на операционный системы Ubuntu / Astra/en

<languages/>
== '''Description of the Situation''' ==  
This page describes the possibility of self-service offline installation of the SmartPlayer platform on Ubuntu and Astra operating systems.  
== '''Supported Versions''' ==  
{| class="wikitable"  
|+ Supported Versions Table  
|-  
! Operating System !! OS Distribution !! Recommended for Installation  
|-  
| Ubuntu Server 24.04 LTS || [https://image_os.hb.bizmrg.com/ubuntuServer/ubuntu-24.04.1-live-server-amd64.iso Link] || Yes  
|-  
| Ubuntu Server 22.04 LTS || [https://image_os.hb.bizmrg.com/ubuntuServer/ubuntu-22.04.2-live-server-amd64.iso Link] || No 
|-  
| Ubuntu Server 18.04 LTS || [https://image_os.hb.bizmrg.com/ubuntuServer/ubuntu-18.04.6-live-server-amd64.iso Link] <br> Support for the 32-bit version ends with this version || No 
|-  
| Ubuntu Server 16.04 LTS || [https://image_os.hb.bizmrg.com/ubuntuServer/ubuntu-16.04.7-server-amd64.iso Link 64-bit version] <br> [https://image_os.hb.bizmrg.com/ubuntuServer/ubuntu-16.04.6-server-i386.iso 32-bit version] || No
|-  
| AstraLinux Orel || [https://image_os.hb.bizmrg.com/astraLinux/astra-linux-orel.iso Link] || Yes, for government institutions. <br>  
* Distributor ID: AstraLinuxCE  
* Description: Astra Linux CE 2.12.43 (Orel)  
* Release: 2.12.43  
* Codename: orel  
|}  
== '''More Details''' ==  
The SmartPlayer representative provides the following platform components. The archive versions may vary depending on the specific version being deployed in the example. Usually, the SmartPlayer representative provides the most up-to-date version at the time:  
{{Note|  
* If the server application uses NodeJS 8, download [https://distributions.hb.bizmrg.com/PLATFORM/GENERAL/docker_images_v3.0.0.tar.gz docker_images_v3.0.0.tar.gz]  
* If the server application uses NodeJS 16, download [https://distributions.hb.ru-msk.vkcs.cloud/PLATFORM/GENERAL/docker_images_v3.1.0.tar.gz docker_images_v3.1.0.tar.gz]  
* If the server application uses NodeJS 18, download [https://distributions.hb.ru-msk.vkcs.cloud/docker_images_v3.2.0.tar.gz docker_images_v3.2.0.tar.gz]  
* If the server application uses NodeJS 20, download [https://distributions.hb.bizmrg.com/PLATFORM/GENERAL/docker_images_v3.3.1.tar.gz docker_images_v3.3.1.tar.gz] |warn}}  
* '''sp_docker_v_${current_version_docker}_bv_${current_version_backend}_fv_${current_version_frontend}.zip''' – an archive containing the SmartPlayer platform server application, Docker configuration files, and a pre-built personal account interface.  
* '''node_modules_${current_version_backend}.tar.gz''' – required libraries for the server part of the platform.  
{{Note| Conditions:  
# If the host machine is Windows – node_modules should be built on Windows (x32 or x64).  
# If the host machine is Linux – node_modules should be built on Linux. |warn}}  
* [https://distributions.hb.bizmrg.com/PLATFORM/GENERAL/unzip_6.0-21ubuntu1_amd64.deb unzip_6.0-21ubuntu1_amd64.deb] – a package for extracting zip archives on the server. By default, Ubuntu Server includes the ".tar" archiver, which does not support extracting "zip" files. Files can be repackaged before uploading to the server, eliminating the need to install this package on the server.

== '''Подробнее''' ==
Представитель SmartPlayer передает следующий состав платформы. Версии архивов могут отличаться, зависит от конкретной версии, которая разворачивается на примере. Обычно представитель SmartPlayer присылает актуальную версию для текущего момента:
{{Note|
* Если используется серверное приложение использующее 8 NodeJS, то необходимо загрузить [https://distributions.hb.bizmrg.com/PLATFORM/GENERAL/docker_images_v3.0.0.tar.gz docker_images_v3.0.0.tar.gz] 
* Если используется серверное приложение использующее 16 NodeJS, то необходимо загрузить [https://distributions.hb.ru-msk.vkcs.cloud/PLATFORM/GENERAL/docker_images_v3.1.0.tar.gz docker_images_v3.1.0.tar.gz]
* Если используется серверное приложение использующее 18 NodeJS, то необходимо загрузить [https://distributions.hb.ru-msk.vkcs.cloud/docker_images_v3.2.0.tar.gz docker_images_v3.2.0.tar.gz]
* Если используется серверное приложение использующее 20 NodeJS, то необходимо загрузить [https://distributions.hb.bizmrg.com/PLATFORM/GENERAL/docker_images_v3.3.1.tar.gz docker_images_v3.3.1.tar.gz]|warn}}
* '''sp_docker_v_${current_version_docker}_bv_${current_version_backend}_fv_${current_version_frontend}.zip''' - архив с серверным приложением платформы SmartPlayer, конфигурационные файл для Docker, собранный по умолчанию личный кабинет платформы
* [https://distributions.hb.bizmrg.com/PLATFORM/GENERAL/unzip_6.0-21ubuntu1_amd64.deb unzip_6.0-21ubuntu1_amd64.deb] - пакет для разархивирования zip-архивов на сервере. По умолчанию в Ubuntu сервер идет архиватор ".tar" который не умеет разархивировать "zip"-файлы. Можно в процессе перепаковать файлы и потом загрузить их на сервер, тогда не потребуется установка пакета на сервере.
== '''Installing Docker and Docker-compose''' ==  
Depending on the operating system, the user selects the appropriate version of Docker and Docker-compose for installation on the server OS:  
{| class="wikitable"  
|+ Versions of Docker and Docker-compose  
|-  
! Link to the archive with docker / docker-compose !! Description  
|-  
|[https://distributions.hb.bizmrg.com/PLATFORM/GENERAL/docker-and-docker-compose_ubuntu_server_24_04.tar.gz Link] || Archive for offline installation of Docker for Ubuntu Server 24.04 LTS  
|-  
|[https://distributions.hb.bizmrg.com/PLATFORM/GENERAL/docker-and-docker-compose_ubuntu_server_22_04.tar.gz Link] || Archive for offline installation of Docker for Ubuntu Server 22.04 LTS  
|-  
|[https://distributions.hb.bizmrg.com/PLATFORM/GENERAL/docker-and-docker-compose_ubuntu_server_18_04.tar.gz Link] || Archive for offline installation of Docker for Ubuntu Server 18.04 LTS  
|-  
|[https://distributions.hb.bizmrg.com/PLATFORM/GENERAL/docker-and-docker-compose_ubuntu_server_16_04.tar.gz Link] || Archive for offline installation of Docker for Ubuntu Server 16.04 LTS  
|}  
== '''Installation Algorithm''' ==  
{{Note|Due to font rendering, some commands may appear to use slanted quotes. However, only single quotes are used.|warn}}  
{{Note|Replace the "*" symbol with the actual version of the file in the specified commands.|warn}}  
'''Be sure to request a new user from the SmartPlayer technical support team.'''  
To begin installation, connect to the server and upload all archives to the home directory of the SmartPlayer user. You can use the "sftp" utility or any other method to upload the archives to the server.  
* Extract the Docker archive and navigate to the extracted directory:<br>  
<code>tar -zxvf docker-and-docker-compose*.tar.gz && cd docker-and-docker-compose*</code>  
* Install Docker and the necessary components:<br>  
<code>sudo ./install-docker-and-docker-compose-offline.sh</code>  
* '''Optional:''' To use Docker without sudo, add the user to the docker group:  
<code>sudo usermod -aG docker $USER</code>  
* Add the SmartPlayer user to the docker group:  
<code>sudo usermod -aG docker smartplayer</code><br>  
After completing the above steps, the user should disconnect and reconnect to the server.  
* Verify the functionality of Docker and Docker Compose:  
<code>docker --version</code>  
* The response depends on the operating system where Docker is installed.  
<code>docker-compose --version</code><br>  
The response will vary based on the operating system:  
[[File:Ответ_операционки.png|thumb|center| Example response display |800px]]  
{{Note|For docker-compose ver.2 (included in archives for Ubuntu starting from version 24.04), it is recommended to enable compatibility mode (works with the "docker-compose" command, and containers use "_" as a separator):  
* <code>echo 'docker compose --compatibility "$@"' > /bin/docker-compose</code>  
* <code>chmod +x /bin/docker-compose</code> |warn}}  
* Enable Docker to start on boot:  
<code>sudo systemctl enable docker</code>  
* Extract the archive to the specified directory where the platform will be installed. Replace "*" with the actual file version:  
<code>unzip sp_docker_v_*.zip -d smartplayer</code>  
* Extract the archive to the specified directory. Path: "~/application_directory/backend/app/".  
<code>unzip node_module_bv_*.zip –d ~/smartplayer/backend/app/</code>  
* Enable the server configuration with the command:  
<code>mv ~/smartplayer/backend/app/pm2.app.config.example.js ~/smartplayer/backend/app/pm2.app.config.js</code>  
* Import Docker images:  
<code>docker image load -i /home/smartplayer/smartplayer/tools/installer/docker_images_*.tar.gz</code>  
* Verify that all images have been loaded:  
<code>docker image ls</code>  
The expected result should look like the screenshot below:  
[[File:Вывод_докера.png|thumb|center| Example display |800px]]  
* '''Optional:''' If everything has loaded successfully, the image archive can be deleted:  
<code>rm docker_images_v3.3.1.tar.gz</code>  
* Fill in the environment configuration:  
<code>mv .env.example .env</code>  
<code>nano .env</code>  
* The user should fill in the following fields:  
{{Note|  
# MYSQL_ROOT_PASSWORD, MYSQL_PASSWORD - passwords for MySQL connection (generate a strong password).  
# CMS_URL - URL of the personal account. For example, if the server is accessible at "http://192.168.56.101/cms", specify this address (without a trailing slash).  
# APP_URL - URL of the server application. For example, if the server is accessible at "http://192.168.56.101", specify this address (without a trailing slash).  
# MYSQL_BACKUP_DOCKER_CONTAINER - specify the MySQL container, e.g., smartplayer_mysql_1  
# MYSQL_BACKUP_STORAGE - specify the MySQL backup type, e.g., local  
# MYSQL_BACKUP_LOCAL_DIR - specify the absolute path to the directory, e.g.:  
  "/home/smartplayer/smartplayer/data/mysql-dumps/"  
Save the configuration and exit. (ctrl+S, ctrl+X)  
[[File:Конфиг_с_параметрами.png|thumb|center| Example configuration display with highlighted parameters |800px]] |warn}}  
* Change the server address in the personal account configuration:  
<code>nano cms/cms/config.js</code><br>  
Modify the "ip_address" parameter:  
[[File:Ип_адрес.png|thumb|center| Example display of the modified IP address |800px]]  
* Enable automatic MySQL database backups (run this command as the SmartPlayer user):  
<code>./mysql_backup/init_auto_backups.sh</code><br>  
To manually check MySQL backups, use the command:<br>  
<code>sudo -u smartplayer /home/smartplayer/smartplayer/mysql_backup/mysql_backup.sh</code>  
* Configure "nginx". Copy the appropriate configuration file depending on the server setup. In this case, the personal account and the server share the same IP address:  
<code>cp nginx/conf_examples/one_domain/http/smartplayer.conf nginx/conf/</code>  
<code>nano nginx/conf/smartplayer.conf</code>  
[[File:Имя_сервера.png|thumb|center| Example display of the configuration where the personal account and server share the same IP address |800px]]  
Save the configuration and exit. (ctrl+S, ctrl+X)  
* Start the applications and wait 2 minutes:  
<code>docker-compose up -d</code>  
* Create database tables:  
<code>docker exec -it smartplayer_backend_1 sh -c './cli.js db init'</code>  
* Upload widgets:  
<code>docker exec -it smartplayer_backend_1 sh -c './cli.js widgets upload'</code>  
* Create a user:  
<code>docker exec -it smartplayer_backend_1 sh -c './cli.js company create-with-user'</code>  
{{Note|By default, the SmartPlayer technical support team should create the first user with the login - root@smartplayer.org.<br>  
If an error occurs while creating the user, repeat the previous step to create database tables.|warn}}  
* Check the server application status using the command:  
<code>docker exec -it smartplayer_backend_1 sh -c 'pm2 list'</code>  
A correct output should look like the example below:  
[[File:Корректный_вывод.png|thumb|center| Example display of the correct output |800px]]
Key	Value
HOST	wiki.smartplayer.org
CONNECTION	keep-alive
PRAGMA	no-cache
CACHE-CONTROL	no-cache
SEC-CH-UA	"HeadlessChrome";v="129", "Not=A?Brand";v="8", "Chromium";v="129"
SEC-CH-UA-MOBILE	?0
SEC-CH-UA-PLATFORM	"Windows"
UPGRADE-INSECURE-REQUESTS	1
USER-AGENT	Mozilla/5.0 AppleWebKit/537.36 (KHTML, like Gecko; compatible; ClaudeBot/1.0; +claudebot@anthropic.com)
ACCEPT	text/html,application/xhtml+xml,application/xml;q=0.9,image/avif,image/webp,image/apng,/;q=0.8,application/signed-exchange;v=b3;q=0.7
SEC-FETCH-SITE	none
SEC-FETCH-MODE	navigate
SEC-FETCH-USER	?1
SEC-FETCH-DEST	document
ACCEPT-ENCODING	gzip, deflate, br, zstd
Key	Value
action	edit
title	Оффлайн_установка_платформы_SmartPlayer_на_операционный_системы_Ubuntu_/_Astra/en