Перейти к основному содержимому

Автоматизированная установка

Сведения

При переходе к данному разделу предполагается, что процессподготовки к установке уже пройден.

Данный раздел рассматривает процесс автоматизированной установки СУБД Pangolin.

В СУБД Pangolin реализован терминальный интерфейс приложения Pangolin Installer, который позволяет пользователям запускать процесс установки (а также обновления) через консоль (режим terminal).

Порядок установки​

Для осуществления автоматизированной установки СУБД Pangolin выполните последовательно следующие шаги:

  1. Распакуйте дистрибутив новой версии СУБД Pangolin. Убедитесь в наличии лицензии.
  2. Настройте конечные узлы СУБД.
  3. Настройте пользователя с доступом к sudo без пароля.
  4. Подготовьте виртуального окружения.
  5. Проведите процесс установки при помощи Pangolin Installer
  6. Проверьте результат процесса установки.
Подсказка

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

Ограничения и требования​

Убедитесь, что:

Предусловия​

примечание

Для корректной работы скриптов автоматизации необходимо, чтобы на целевых узлах (master/replica/arbiter) у скриптов автоматизации была возможность доступа к rpm/deb-пакетам каждого участвующего в обновлении или первичном развертывании компонента. Для организации данного доступа во время установки будет создан локальный репозиторий со всеми возможными rpm/deb-пакетами дистрибутива, в том числе с rpm/deb-пакетами из 3rd Party части дистрибутива. Данный репозиторий не подвергается процессу удаления после окончания установки Pangolin.

Предварительная настройка конечных узлов СУБД​

Для ускорения автоматизированной установки, следует на всех конечных узлах СУБД добавить строку следующего вида в файл /etc/sudoers:

Defaults: user !requiretty

Где user - пользователь, через которого выполняется подключение на конечные узлы и имеющий привилегированные права sudo.

Настройка пользователя с доступом к sudo без пароля​

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

Пример последовательной настройки для пользователя dbadmin:

  1. Откройте файл sudoers в текстовом редакторе. Например, с помощью команды:

    visudo

  2. Добавьте в конец файла строку:

    dbadmin ALL=(ALL) NOPASSWD: ALL

  3. (Опционально) Для ускорения выполнения автоматизированных сценариев добавьте:

    Defaults: dbadmin !requiretty

  4. Сохраните файл и закройте редактор.

Подготовка виртуального окружения​

Рекомендуется запускать развертывание Pangolin в виртуальной среде Python. Для этого необходимо выполнить установку пакета pangolin-installer-venv-controller на управляющем хосте, который поставляется в составе дистрибутива:

  1. Разархивируйте rpm/deb-пакет venv из папки 3rdparty архива дистрибутива:

    tar -xz -f 3rdparty/3rdparty.tar.gz ./pangolin-installer-venv-controller*

  2. Выполните установку пакета:

    sudo dnf install pangolin-installer-venv-controller-{product_version}-{OS}.x86_64.rpm
    Подсказка

    Пример готовой команды:

    sudo dnf -y install pangolin-installer-venv-controller-8.2.0-sberlinux9.x86_64.rpm

  3. Активируйте виртуальное окружение для начала последующей установки:

    source /opt/pangolin-installer/bin/activate
Подсказка

При установке пакета pangolin-installer-venv-controller выполняется проверка наличия всех необходимых пакетных зависимостей для корректного выполнения процесса установки на стенде запуска Ansible сценариев.

Кроме того, при запуске автоматизированной установки также выполняется проверка зависимостей на узлах СУБД Pangolin и автоматически устанавливается пакет pangolin-installer-venv-controlled.

Если какой-либо пакет отсутствует или его версия ниже требуемой, будет выведена ошибка, и процесс установки СУБД будет приостановлен.

Запуск сценария установки​

Для перехода к процессу установки перейдите в раздел с описанием сценария «Автоматизированная установка при помощи инструмента Pangolin Installer».

Проверка результата​

Для проверки успешности установки рекомендуется использовать чек-лист проверки корректности работы СУБД Pangolin.

Действия, в случае неудачной установки​

В случае, если установка прошла неудачно, выполните пункты на выбор:

  • очистите КТС перед началом новой установки. Для этого выполните удаление продукта СУБД Pangolin по инструкции.

  • выполните переустановку СУБД с помощью Pangolin Installer:

    pangolin-installer terminal -c config.yml -a install