Установка платформы Tantor
В этом разделе описаны процедуры получения дистрибутива Платформы из репозитория Разработчика и установки Платформы.
Перед установкой платформы проверьте, что открыты нужные порты, и установите Docker.
Открытые порты
Для корректной работы Платформы на устройствах с установленным агентом должны быть открыты порты 443, 4222 в сторону Платформы.
Установка Docker
Внимание
Все команды в процессе установки следует выполнять от имени пользователя root или любого другого, имеющего права sudo.
Предупреждение
Если вы устанавливаете Docker на ОС Astra Linux версии «Смоленск» или «Воронеж» с включенным режимом мандатного контроля целостности, выполнять команды нужно из-под пользователя с высоким уровнем целостности. Проверить уровень целостности можно командой:
pdp-id
Чтобы установить Docker:
Установите необходимые пакеты:
apt update apt install docker.io apt install docker-compose
Добавьте официальный репозиторий Docker и установите необходимые пакеты:
curl https://download.docker.com/linux/centos/docker-ce.repo -o /etc/yum.repos.d/docker-ce.repo yum install yum-utils \ device-mapper-persistent-data \ docker-ce \ -y
Запустите службу Docker:
systemctl start docker
Гарантируйте автоматический запуск службы docker после перезагрузки сервера:
systemctl enable docker
Скачайте docker из официального репозитория.
Измените права доступа файла /usr/local/bin/docker-compose:
chmod +x /usr/local/bin/docker-compose
Установите необходимые пакеты:
yum install yum-utils \ device-mapper-persistent-data \ docker-ce \ -y
Запустите службу Docker:
systemctl start docker
Гарантируйте автоматический запуск службы docker после перезагрузки сервера:
systemctl enable docker
Установите необходимые пакеты:
dnf install yum-utils \ device-mapper-persistent-data \ docker-ce \ -y
Запустите службу Docker:
systemctl start docker
Гарантируйте автоматический запуск службы docker после перезагрузки сервера:
systemctl enable docker
Примечание
Если вы устанавливаете Docker Engine из сторонних источников, то обратите внимание, чтобы версия докера была не менее 20.10.13.
Получение дистрибутива
Для получения дистрибутива Платформы:
Введите следующую команду:
wget https://public.tantorlabs.ru/tantor-eco-5.3.1.tar.gz -O tantor-eco-5.3.1.tar.gz
Сохраните дистрибутив на сервере, где будет установлена Платформа.
Установка Платформы
Для запуска установки Платформы:
Перейдите в директорию с сохраненным дистрибутивом Платформы.
Распакуйте дистрибутив с помощью следующей команды:
tar xvf tantor-eco-5.3.1.tar.gz
Запустите процедуру установки с помощью следующей команды:
sudo ./installer
Программа установки запросит подтверждение запуска:
Tantor Platform will be installed, version 5.3.1 Proceed? (Y/N):
для продолжения установки введите значение Y;
для отмены установки введите значение N.
По запросу программы установки введите почту Администратора системы:
-Enter Tantor Platform administrator email: <admin@example.ru>
Введите имя Администратора системы:
-Enter Tantor Platform administrator name: <Admin Name>
Внимание
Имя Администратора системы должно содержать больше четырех символов.
Введите доменное имя устройства, которое будет использоваться Платформой. Доменное имя нужно зарегистрировать в таблице 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
Программа установки спросит о наличии сертификата 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>
Программа установки запросит параметры сервера 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.
Примечание
Если во время установки Платформы вы не указали параметры сервера SMTP, вы можете добавить порт сервера SMTP, доменное имя сервера, адрес и пароль электронной почты пользователя в файл /opt/tantor/eco/platform.env:
EMAIL_PORT=25 EMAIL_HOST=smtp.example.ru EMAIL_USERNAME=admin@example.ru EMAIL_PASSWORD=1234567
Пример содержимого файла:
SSL_CERT=certificate.pem SSL_CERT_KEY=key.pem EXPLAIN_URL=https://demo.tantorlabs.ru OWNER_NAME=admin DB_PASSWORD=pmm_password EMAIL_USERNAME=tantorlabs@mail.ru PLATFORM_VERSION=5.3.1 DOMAIN=demo.tantorlabs.ru SECURE_LINK_MD5=566add14feb ADVANCED_ANALYTICS=true OWNER_EMAIL=admin@tantorlabs.ru SECRET_TOKEN=36aafbe0a782dbd EMAIL_PASSWORD=V3fP5BAqPNj EMAIL_PORT=25 EMAIL_HOST=smtp.example.ru EMAIL_USERNAME=admin@example.ru EMAIL_PASSWORD=1234567
Программа установки предложит выбрать один из вариантов установки:
Platorm: будет установлена только Платформа.
Platform + pg_explain: будет установлена Платформа и анализатор планов запросов.
Platorm + pg_explain + pg_monitor: будет установлена Платформа, анализатор планов запросов и модуль анализа логов.
Введите порядковый номер необходимого варианта установки (1-3).
Важно
Если вы выбрали вариант 3, после установки Платформы настройте модуль анализа логов (Advanced analytics)
Программа установки выведет заполненные ранее значения для подтверждения, введите:
Y — для подтверждения введенных параметров;
N — если параметры требуется изменить.
Дождитесь завершения установки Платформы.
После завершения установки будет выведено сообщение:
Tantor Platform version 5.3.1 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, в адресную строку браузера. В результате откроется начальная страница с логином/паролем.
Сохраните логин и пароль из сообщения выше для первого подключения к Платформе. Подробнее в разделе Первое подключение.
Внимание
Во время первого подключения Платформа потребует изменить пароль.