Linux Debian

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

Установка

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

Внимание

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

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

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

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

sudo apt-get install mlocate
sudo apt-get install libgsf-1-114
sudo apt-get install librocksdb-dev
  1. Скачайте пакет Платформы с расширением .deb

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

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
    
  1. Скопируйте сертификат с расширением pfx (например, в каталог platform):

/usr/bin/datareon/platform/
  1. Установите сертификат:

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

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

systemctl status platformmanager
  1. Откройте в браузере Центр настройки по адресу https://адрес_сервера: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
  1. Скачайте обновленный пакет Платформы с расширением .deb

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

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
    
  1. Запустите Платформу:

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

systemctl status platformmanager
  1. Откройте в браузере Центр настройки по адресу https://адрес_сервера:7200

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

  3. В правом верхнем углу окна Центра настройки нажмите на кнопку Применить конфигурацию:

    ../_images/update_config.png