Linux Debian

Этот раздел содержит инструкции по установке и обновлению Платформы на устройстве под управлением под управлением сборок Linux из ветки Debian.

Установка

Этот раздел содержит описание процедуры установки Платформы на устройство под управлением сборок Linux из ветки Debian, использующих менеджер пакетов DPKG (например Ubuntu, Linux Mint).

Внимание

В процессе установки и настройки Платформы потребуется использование прав суперпользователя для создания директорий и регистрации служб Платформы в системе.

Чтобы установить Платформу:

1. Обновите все установленные пакеты репозитория:

   sudo apt update
   

2. Установите все пакеты, от которых зависит установка пакета Платформы:

   sudo apt-get install mlocate
   sudo apt-get install libgsf-1-114
   sudo apt-get install librocksdb-dev
   sudo apt-get install libarchive13
   

   Внимание

   Для успешной установки Платформы на устройство под управлением Linux Ubuntu версии 24.04 вместо пакета mlocate следует установить пакет plocate:

   sudo apt-get install plocate
   

3. Скачайте пакет Платформы с расширением .deb

4. Установите пакет Платформы:

   sudo dpkg -i platform_версия.deb
   

   Примечание

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

   • Установка в файле environment. Для этого необходимо открыть его в каталоге /etc и добавить необходимые значения, например:

     export ROOT_DATA_FOLDER=/var/datareon/platformRoot
     export STORAGE_FOLDER=/var/datareon/platformStorage
     export LOG_KEY=/var/datareon/platformLogs
     export NODE_PORT_KEY=8888
     export CONTROL_SERVER_PORT_KEY=8887
     

   • Установка через команду Платформы:

     platformmanager initenvironment -n LOGS_FOLDER -v /var/datareon/platformLogs
     

   Для проверки текущего значения ключа откройте файл environment, либо выполните следующие команды:

   source /etc/environment
   printenv LOGS_FOLDER
   

   Для сброса ключей к стандартным значениям нужно выполнить следующую команду, указав необходимый ключ:

   platformmanager removeenvironment -n LOGS_FOLDER
   

   Если ключ ROOT_DATA_FOLDER был изменен, выполните следующую команду:

   setCertificate
   

Важно

При установке Версии 3.1.2 и выше в виду проверки целостности необходимо переместить нестандартный (пользовательский) сертификат в любое место с доступом (например, platformmanager setCertificate -path /home/имя_сертификата.pfx -password пароль_сертификата), если нестандартный сертификат находится в /usr/bin/datareon/platform

Примечание

Для установки нестандартного сертификата выполните следующие действия:

1. Скопируйте сертификат с расширением pfx (например, в домашний каталог platformmanager setCertificate -path /home/):

   /home/
   

2. Установите сертификат:

   platformmanager setCertificate -path /home/имя_сертификата.pfx -password пароль_сертификата
   

5. Запустите Платформу:

   platformmanager start
   

6. Убедитесь, что служба успешно запустилась:

   systemctl status platformmanager
   

7. Откройте в браузере Центр настройки по адресу https://server-address:7200

Внимание

Если в кластере с несколькими серверами Центр настройки и сервер-координатор находятся на разных машинах, координатор должен проверить, получена ли команда обновления конфигурации от текущего хоста, где находится сам координатор. Если команда получена от Центра настройки не зарегистрированного в кластере, координатор отклоняет обновление. Для регистрации в кластере нового Центра настройки необходимо выполнить команду на хосте координатора с указанием адреса Центра настройки:

sudo /usr/bin/datareon/platform/DatareonPlatformService setCS <ip address>

Команды platformmanager

• start - запустить службу platform;

• stop - остановить службу platform;

• restart - перезапустить службу platform;

• init - инициализировать platform;

• initenvironment - установить ключи переменных окружения;

• removeenvironment - сбросить ключи переменных окружения;

• setCertificate - установить сертификат https;

• startnode - запустить NodeManager;

• stopnode - остановить NodeManager;

• list - отобразить список запущенных сервисов:

  • Идентификатор процесса;

  • Идентификатор компонента;

  • Тип компонента;

  • Имя компонента;

• show - отобразить конфигурации сервиса; параметры:

  • -t - тип узла;

  • -n - имя узла;

• debug - запустить службу platform в отладочном режиме.

• useSsl - включить использование протокола SSL для TCP-соединений между серверами.

• unUseSsl - выключить использование протокола SSL для TCP-соединений между серверами.

Обновление

Этот раздел содержит описание процедуры обновления или установки более ранней версии Платформы на устройстве под управлением сборок Linux из ветки Debian, использующих менеджер пакетов DPKG (например Ubuntu, Linux Mint).

1. Удалите установленный пакет Платформы:

   sudo dpkg -r platform
   

2. Скачайте обновленный пакет Платформы с расширением .deb

3. Установите обновленный пакет Платформы:

   sudo dpkg -i platform_версия.deb
   

• Опционально: если требуется установить нестандартные каталоги Платформы, воспользуйтесь ключами переменных окружения. Для этого существует два способа установки:

  • Установка в файле environment. Для этого необходимо открыть его в каталоге /etc и добавить необходимые значения, например:

    export ROOT_DATA_FOLDER=/var/datareon/platformRoot
    export STORAGE_FOLDER=/var/datareon/platformStorage
    export LOG_KEY=/var/datareon/platformLogs
    export NODE_PORT_KEY=8888
    export CONTROL_SERVER_PORT_KEY=8887
    

  • Установка через команду Платформы:

    platformmanager initenvironment -n LOGS_FOLDER -v /var/datareon/platformLogs
    

  • Для проверки текущего значения ключа откройте файл environment, либо выполните следующие команды:

    source /etc/environment
    printenv LOGS_FOLDER
    

  • Для сброса ключей к стандартным значениям нужно выполнить следующую команду, указав необходимый ключ:

    platformmanager removeenvironment -n LOGS_FOLDER
    

  • Если ключ ROOT_DATA_FOLDER был изменен, выполните следующую команду:

    setCertificate
    

4. Запустите Платформу:

   platformmanager start
   

5. Убедитесь, что служба успешно запустилась:

   systemctl status platformmanager
   

6. Откройте в браузере Центр настройки по адресу https://server-address:7200

7. В разделе Справка убедитесь, что вы используете обновленную версию Платформы.

8. Нажмите на кнопку Применить конфигурацию.

Обновление сертификата

Для обновления сертификата выполните следующие действия:

1. Скопируйте новый сертификат с расширением pfx (например, в домашний каталог platformmanager setCertificate -path /home/):

   /usr/bin/datareon/platform/
   

Важно

При установке Версии 3.1.2 и выше в виду проверки целостности необходимо переместить нестандартный (пользовательский) сертификат в любое место с доступом (например, platformmanager setCertificate -path /home/имя_сертификата.pfx -password пароль_сертификата), если нестандартный сертификат находится в /usr/bin/datareon/platform

2. Установите новый сертификат:

   platformmanager setCertificate -path /usr/bin/datareon/platform/имя_сертификата.pfx -password пароль_сертификата
   

Примечание

В случае необходимости удалить сертификат, выполните следующую команду:

rm old_certificate.pfx

Проверка целостности

Начиная с версии 3.1.2, в платформе реализована проверка целостности исполняемых файлов, расположенных в каталоге: /usr/bin/datareon/platform

Проверка обеспечивает:

• Отсутствие посторонних файлов в каталоге платформы;

• Контроль версий всех исполняемых файлов;

• Подтверждение подлинности файлов с использованием сертификата Datareon.

Важно

При установке Версии 3.1.2 и выше, если нестандартный (пользовательский) сертификат размещён в каталоге /usr/bin/datareon/platform, его необходимо переместить в доступное место (например, /home/) и указать заново путь к нему с помощью команды: platformmanager setCertificate -path /home/имя_сертификата.pfx -password пароль_сертификата

Как работает проверка:

1. Проверка выполняется при запуске службы;

2. Проверяются все исполняемые файлы платформы;

3. В фоновом режиме служба выполняет проверку каждые 4 часа;

4. Если целостность сохранена, платформа продолжает работу в прежнем режиме;

5. Если целостность нарушена и обнаружен недопустимый файл:

• Процессы платформы будут остановлены;

• Информация о нарушении будет зафиксирована в логах DatareonPlatformService

ERROR All PlatformValidationService -
Ошибка проверки целостности файла C:\Program Files (x86)\Datareon\Platform\ПостороннийФайл.dll. Служба будет остановлена

В случае остановки платформы необходимо или удалить обнаруженный файл, или обновить Платформу через удаление.