Установка платформы Tantor

В этом разделе описаны процедуры получения дистрибутива Платформы из репозитория Разработчика и установки Платформы.

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

Открытые порты

Для корректной работы Платформы на устройствах с установленным агентом должны быть открыты порты 443, 4222 в сторону Платформы.

Установка Docker

Внимание

Все команды в процессе установки следует выполнять от имени пользователя root или любого другого, имеющего права sudo.

Предупреждение

Если вы устанавливаете Docker на ОС Astra Linux версии «Смоленск» или «Воронеж» с включенным режимом мандатного контроля целостности, выполнять команды нужно из-под пользователя с высоким уровнем целостности. Проверить уровень целостности можно командой:

pdp-id

Чтобы установить Docker:

  1. Установите необходимые пакеты:

    apt update
    
    apt install docker.io
    
    apt install docker-compose
    

Примечание

Если вы устанавливаете Docker Engine из сторонних источников, то обратите внимание, чтобы версия докера была не менее 20.10.2.

Получение дистрибутива

Для получения дистрибутива Платформы:

  1. Введите следующую команду:

    wget https://public.tantorlabs.ru/tantor-eco-5.0.0.tar.gz -O tantor-eco-5.0.0.tar.gz
    
  2. Сохраните дистрибутив на сервере, где будет установлена Платформа, в новой директории /tmp/tantor.

Установка Платформы

Для запуска установки Платформы:

  1. Перейдите в директорию с сохраненным дистрибутивом Платформы.

  2. Распакуйте дистрибутив с помощью следующей команды:

    tar xvf tantor-eco-5.0.0.tar.gz
    
  3. Запустите процедуру установки с помощью следующей команды:

    sudo ./installer
    
  4. Программа установки запросит подтверждение запуска:

    Tantor Platform will be installed, version 5.0.0 Proceed? (Y/N):
    
    • для продолжения установки введите значение Y;

    • для отмены установки введите значение N.

  5. По запросу программы установки введите почту Администратора системы:

    -Enter Tantor Platform administrator email: <admin@example.ru>
    
  6. Введите имя Администратора системы:

    -Enter Tantor Platform administrator name: <Admin Name>
    

    Внимание

    Имя Администратора системы должно содержать больше четырех символов.

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

    -Enter Tantor Platform domain name: <host.example.ru>
    

    Внимание

    Для примера приведены:

    • почта администратора системы <admin@example.ru>;

    • имя Администратора системы <Admin Name>;

    • доменное имя устройств <host.example.ru>.

    Важно

    Если доменное имя не прописано в таблицах домена организации, пропишите его в файле hosts машины, на которой устанавливается Платформа.

    Так же пропишите это доменное имя в файле hosts машин, на которых будут устанавливаться Агенты и с которых пользователь будет обращаться на Платформу из web-браузера.

    Пример:

    192.168.0.154 host.example.ru
    
  8. Программа установки спросит о наличии сертификата SSL на имя устройства, на которое устанавливается платформа (<host.example.ru>):

    Do you have SSL certificates match domain name <host.example.ru>?
    
    • Если сертификат SSL отсутствует, программа установки сможет сама создать сертификат для указанного устройства. Для данного действия введите значение N.

    • Если сертификат в наличии, введите значение Y. Далее программа установки запросит путь к файлам сертификатов SSL:

      • введите путь к приватному ключу:

      -Enter the absolute path to SSL private key with 'pem' extension: <example_path_to_key/key.pem>
      
      • введите путь к публичному ключу:

      -Enter the absolute path to SSL public key with 'pem' extension: <example_path_to_key/certificate.pem>
      
  9. Программа установки запросит параметры сервера SMTP для отправки сообщений по электронной почте:

    Do you have details to set integration with SMTP server to send messages from Tantor Platform? (Y/N)
    
    • Для предоставления имеющихся параметров сервера SMTP введите значение Y. После этого программа установки предложит ввести следующие данные:

      • доменное имя сервера SMTP:

      Enter SMTP server domain name: <smtp.example.ru>
      
      • порт сервера SMTP:

      Enter SMTP server domain name port: <25>
      
      • адрес пользователя электронной почты сервера SMTP:

      Enter SMTP server user email: <admin@example.ru>
      
      • пароль пользователя электронной почты сервера SMTP:

      Enter SMTP server user password: <1234567>
      

      Примечание

      Параметры SMTP сервера приведены для примера.

    • Если параметры сервера SMTP недоступны, введите значение N.

  10. Программа установки предложит выбрать один из вариантов установки:

    Введите порядковый номер необходимого варианта установки (1-3).

  11. Программа установки выведет заполненные ранее значения для подтверждения, введите:

    • Y — для подтверждения введенных параметров;

    • N — если параметры требуется изменить.

  12. Дождитесь завершения установки Платформы.

После завершения установки будет выведено сообщение:

Tantor Platform version 5.0.0 is installed and running.
Please connect to Tantor Platform using:
====================================================================================================================================
Tantor Platform URL:                        https://host.example.ru
Tantor Platform  administrator email/login: admin@example.ru
Tantor Platform  administrator password:    xiet7KLumux50Q2dmV/FBue2zqtexElavkVAKnEYN/rw2YLIn51TQsXb3u8FPm4wiuHUTtEjjvBIrtBPAgRMsA==
====================================================================================================================================
Please note. You will have to change the password on the first login to Tantor Platform.

Чтобы подключиться к платформе, введите адрес, указанный в строке Tantor Platform URL, в адресную строку браузера. В результате откроется начальная страница с логином/паролем.

Сохраните логин и пароль из сообщения выше, далее см. раздел Первое подключение.

Внимание

Во время первого подключения Платформа потребует изменить пароль.