Важно: Данный раздел актуален для Платформы данных On-Premise.
На этой странице представлен наиболее простой способ установки, не затронуты варианты установки с локального репозитория или установки в облаке.
Для установки RT.ClusterManager хост должен удовлетворять следующим требованиям:
1. Поддерживаемые ОС:
2. Требования к оборудованию:
3. Настроенный DNS сервер:
1. Обновите операционную систему:
Перед установкой рекомендуется обновить операционную систему, например если на хосте установлена RedOS 7.3, то выполните следующую команду:
dnf update -y
2. Месторасположение файлов:
В соответствии с FHS (Filesystem Hierarchy Standard) рекомендуем расположить програмное обеспечение RT.ClusterManager (каталог rtcm) в /opt:
cd /opt
Архив с ПО RT.ClusterManager можно скачать, возпользовавшись менеджером репозиториев Nexus, который расположен по адресу:
https://repo.data.rt.ru/#browse/browse:rt.clustermanager_arch
Чтобы пройти по ссылке напрямую к директории с архивом необходимо предварительно зарегистрироваться в Nexus по адресу:
https://repo.data.rt.ru
curl -L -O https://$NEXUS_USER:$NEXUS_PASS@repo.data.rt.ru/repository/rt.clustermanager_arch/$RTCM_VERSION_ARCHIVE_FILE
Логин и пароль от личного кабинета подходит к Nexus репозиторию.
tar xvf RT.ClusterManager_*.gz
cd rtcm
Если требуется можно донастроить параметры в docker-compose.yaml, перед началом установки.
./install-rtcm.sh install
http://<server>:8080
После первого старта нужно выполнить небольшую доработку конфигурационного файла, для чего:
vi docker-compose.yaml
#dns:
# - insert_your_DNS_address_here
dns:
- 192.168.0.15
./topgun.sh down
./topgun.sh up
Здесь и далее - серверы, хосты, ноды - являются тождеством.
Важно к планированию подойти ответсвенно, что поможет избежать ошибок в будушем.
При планировании характеристик хостов, которые будут использоваться при создании кластеров необходимо учесть следующее:
В процессе установки и настройки операционной системы, для каждого хоста вам необходимо выполнить следующие операции:
1. Установите операционную систему.
Процесс зависит от ваших исходных данных.
2. Настройте сеть.
К сожалению, описать все варианты под каждую ОС сложно, но в качестве примера можно привести утилиту nmtui, она позволит настроить сеть в псевдографическом интерфейсе и доступна во многих дистрибутивах по умолчанию. Но можно настроить сеть и по своему усмотрению.
При настройке сети не забудьте указать DNS сервер и поисковый DNS-суффикс (search domain).
3. Обновите операционную систему (пример для RedOS 7.3).
dnf update -y
4. Заведите пользователя (под которым будет проводиться установка).
Здесь мы в качестве примера используем пользователя ansible, но можно создать любого, какого вам захочется, главное учитите этот момент далее в документации.
useradd ansible
passwd ansible
5. Добавьте права no sudo.
Пользователю ansible для работы требуется повышение прав без пароля.
echo "ansible ALL=(ALL) NOPASSWD:ALL" >> /etc/sudoers
6. Настройте имя компьютера.
Командой su мы перезайдём в консоль и сразу увидим результат.
hostnamectl set-hostname srv-redos73-01.red.local
su
7. Настройте часовой пояс.
Команда date позволит нам проверить настроенное время.
Правильно выставленное время критически важно в сценариях, где используется Kerberos, также оно необходимо для удобного чтения логов.
timedatectl set-timezone Europe/Moscow
date
8. Отключите ipv6.
Пример для RedOS, в других дистрибутивах нужно обратиться к соответствующей документации.
echo "net.ipv6.conf.all.disable_ipv6 = 1" > /etc/sysctl.d/ipv6.conf
sysctl -p /etc/sysctl.d/ipv6.conf
systemctl restart NetworkManager
Проверить можно так (не должно показывать inet6):
ip a
RT.ClusterManager должен иметь безпарольный ssh доступ на все подконтрольные ему хосты кластера.
Для создания и настройки ssh ключей необходимо выполнить следующие действия:
1. Создайте пользователя ansible на RT.ClusterManager (если не был создан ранее) и сгенрерируйте ssh ключ для ранее созданного пользователя ansible (на все вопросы отвечаем утвердительно):
useradd ansible
passwd ansible
su ansible
ssh-keygen -t rsa -b 2048 -m PEM
2. Распределите ключи по нодам:
Здесь важно выполнить добавление ssh ключа на сам RT.ClusterManager. Названия серверов у вас будут свои.
ssh-copy-id srv-redos73-cm.red.local
ssh-copy-id srv-redos73-01.red.local
ssh-copy-id srv-redos73-02.red.local
ssh-copy-id srv-redos73-03.red.local
Вам необходимо выполнить следующие операции:
1. Загрузка плагинов.
На странице загрузки можно найти ссылки на плагины:
https://docs.data.rt.ru/Документация/common_docs/landing_download
Минимальный набор это 1 плагин провайдера и 1 плагин продукта.
Плагин RT.System позволяет создавать связь между RT.ClusterManager и уже созданными хостами в сети.
Скачайте RT.System и плагин нужного вам продукта.
2. Добавление ssh ключа.
В web-интерфейсе RT.ClusterManager → "Ключи" → "+" → Добавьте приватную часть своего ssh ключа.
Тут есть вариант вставить ключ в виде текста или в виде файла, воспользуйтесь более удобным для вас способом.
В web-интерфейсе RT.ClusterManager → "Плагины" нажмите на кнопку "+" и добавьте ваши оба плагина.
3. Настройка провайдера.
В web-интерфейсе RT.ClusterManager → "Провайдеры" → "+" → Заполните название провайдера, выбирите плагин RT.System.
Нажмите на наименование созданного провайдера и внутри нажимая на кнопку "+" добавьте имена наших хостов.
В этом моменте желательно быть предельно внимательным, потому что отредактировать провалидированные хосты будет проблематично.
Если хостов у вас много есть возможность загрузить их из JSON-файла, в котором описывается инфраструктура.
Теперь нужно зайти в каждый созданный хост и заполнить 2-а поля:
4. Валидация.
Убедитесь, что RT.ClusterManager видит серверы, для чего:
Вернитесь в Web-интерфейс RT.ClusterManager → "Провайдеры" → <наш_созданный_провайдер> → Справа вверху кнопка "Валидация".
Процесс обычно занимает около 30 сек, отслеживать его можно или во вкладке "События" или обновляя страницу.
Если будут ошибки можно обратится к базе знаний к разделам "Нет доступа до хоста" и "Не проброшен ssh-ключ".
https://docs.data.rt.ru/Документация/RT_ClusterManager/rt_cm_knowlage_base
В случае успеха, в провайдере, напротив каждого хоста будет гореть зелёная кнопка "Готов к работе", значит всё хорошо и можно двигаться дальше.
5. Создание кластера.
На этом этапе у нас есть установленный и настроенный RT.ClusterManager, далее нужно обратиться к документации продукта и следовать дальнейшим инструкциям.