Установка и настройка MULTIDIRECTORY

Обратите внимание

Все сервисы работают при помощи Traefik, используя PostgreSQL в качестве базы данных. Другие СУБД несовместимы.

При первоначальной установке происходит автоматическая настройка файла конфигурации .env

Для изменения подключения ко внешней БД замените следующие параметры на необходимые в файле .env:

POSTGRES_HOST=1.2.3.4       # Укажите ip-адрес
POSTGRES_USER=user_login    # Укажите учетные данные
POSTGRES_PASSWORD=password  # Укажите пароль от учетной записи

Обратите внимание

Создайте пользователя во внешней базе данных PostgreSQL с правами создания базы и задайте пароль созданный в файле .env

На сервере где установлена внешняя СУБД настройте файлы конфигурации:

• postgresql.conf — изменив параметр listen_addresses
• pg_hba.conf — добавив строки для разрешения подключения к базе данных

После выполнения данных действий, перезапустите сервис PostgreSQL.

Скачайте архив с предоставленными Вам образами.

Выполните разархивацию при помощи команды:

sudo tar -xvf Enterprise_complete.tar -C /opt

Перейдите в папку с файлами MULTIDIRECTORY:

 cd /opt/multidirectory 

Запустите скрипт mdctl.sh:

sudo ./mdctl.sh

Выберите язык:

Ознакомьтесь с минимальными системными требованиями и подтвердите ознакомление:

Выберите пункт «1. Установить Single»:

Введите ваш домен:

Подтвердите загрузку образов и выберите из списка доступных образов:

Подтвердите запуск контейнеров после установки:

Введите короткое имя хоста, на котором будет установлена MULTIDIRECTORY:

В зависимости от используемого сертификата выберите необходимый пункт. По умолчанию выбран пункт 3, в котором сертификат генерируется автоматически:

Введите или оставьте по умолчанию вышестоящие DNS сервера:

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

После завершения установки Вам будет предложено перейти в Web-интерфейс MULTIDIRECTORY:

После перехода в Web-интерфейс проведите настройку согласно шагам ниже.

Настройка Web-интерфейса MULTIDIRECTORY

После успешной настройки и запуска сервисов Docker – перейдите в браузер. В поисковую строку введите адреса, выведенные вам после установки MULTIDIRECTORY. 

Вы попадете в настройку WEB-интерфейса вашей MULTIDIRECTORY.

Проверьте правильность написания домена, выберите необходимые вам настройки:

• Введите имя вашего домена.
• Настроить DNS. Если стоит галочка, то настройка DNS будет произведена сразу же (настройку DNS можно произвести и позже в WEB-интерфейсе администратора).
• Настроить Kerberos. Если стоит галочка, то настройка Kerberos произойдет сразу же (настройку Kerberos можно произвести и позже из интерфейса администратора MULTIDIRECTORY).
• Сгенерировать пароли для Kerberos. Если стоит галочка, то произойдет автоматическая генерация паролей для Kerberos. После настройки WEB-интерфейса сгенерированные пароли будут выгружены в файл.

Нажмите кнопку «Далее». 

Настройка Kerberos

Если НЕ была выбрана автоматическая генерация паролей для Kerberos

Если вы сняли галочку с пункта «Сгенерировать пароли для Kerberos автоматически», появится окно, в которое необходимо будет внести пароли для krbadmin и стэша.

• Krbadmin — это служебная учетная запись сервера Kerberos. Она используется для взаимодействия с сервером LDAP. Данная учетная запись ограничена полномочиями и может управлять только своей выделенной областью в дереве LDAP.
• Пароль stash, используется для защиты мастер ключа шифрования базы данных Kerberos. Вы можете выгрузить внесенные вами пароли в файл.

Требование к паролям:

• Пароли должны быть более 7 символов;
• Пароли не должны быть одинаковыми у krbadmin и стэша (они должны отличаться друг от друга);
• Пароли должны содержать заглавные и строчные буквы (A-Z и a-z) и цифры (0-9).

После внесения паролей нажмите кнопку «Далее».

Внесите данные администратора, под которыми будет осуществлен первоначальный вход.

Требование к паролям:

• Пароли должны быть более 7 символов;
• Пароли должны содержать заглавные и строчные буквы (A-Z и a-z) и цифры (0-9).

Для продолжения нажмите кнопку «Далее». 

В появившемся окне проверьте правильность созданной учетной записи администратора:

• UPN. 
• Отображаемое имя. 
• Email. 

Нажмите кнопку «Далее». 

Загрузка лицензии

Загрузите предоставленную Вам лицензию:

Нажмите кнопку «Далее». 

Настройка DNS

Если был выбран пункт «Настроить DNS» откроется мастер настройки:

Нажмите кнопку «Далее». 

Обозначение полей

• TTL по умолчанию — продолжительность кэширования записи серверами и клиентами до её истечения. Значение измеряется в секундах.

Если был выбран пункт «Привязать к внешнему DNS серверу»

• IP — адрес Вашего внешнего DNS сервера, который будет использоваться.
• TSIG Ключ — содержимое файла, которое было сгенерировано на внешнем DNS сервере.

После заполнения всех полей нажмите кнопку «Далее».

Скачайте архив с предоставленными Вам образами.

Выполните разархивацию при помощи команды:

sudo tar -xvf Enterprise_complete.tar -C /opt

Перейдите в папку с файлами MULTIDIRECTORY:

 cd /opt/multidirectory 

Запустите скрипт mdctl.sh:

sudo ./mdctl.sh

Выберите язык скрипта:

Выберите 2 пункт (Установить MD с несколькими контроллерами домена(Geo)):

Описание вводимых параметров

Обратите внимание на выводимый текст скрипта при установке, во избежание ошибок!

• Выбреите тип сертификата для MD-узлов — сертификат безопасности который будет распространен на устанавливаемые узлы.
• Загрузка Docker-образов — подтвердите загрузку образов на узлах.
• Доступные архивы Docker-образов — выберите доступный архив с образами MD.
• Запустить контейнеры — выбор, запускать ли контейнера при установки кластера.
• Выбор DNS серверов для рекурсии (пересылки) запросов — пропишите собственные DNS сервера или нажмите «Enter» для добавления стандартных записей.
• IP-адрес master-узла PostgreSQL — введите IP-адрес сервера, который будет являться мастер базой PostgreSQL для реплик.
• Короткий hostname node PostgreSQL — укажите произвольное наименование машины.
• Завершить ввод PostgreSQL-узлов — подтвердите ввод данных для добавления узлов PostgreSQL.
• IP-адрес узла MD — укажите IP-адрес серверов, где будет устанавливаться MULTIDIRECTORY.
• Короткий hostname MD-узла — укажите произвольное наименование машины.
• Завершить ввод MD-узлов — подтвердите ввод данных для добавления узлов MULTIDIRECTORY.
• Введите имя deployment-пользователя для установки MULTIDIRECTORY — укажите учетную запись с root правами для установки компонентов кластера.
• SSH-порт — выберите предпочитаемый порт SSH или нажмите «Enter» для выбора стандартного 22 порта.

Описание вводимых параметров

• user@servers — укажите пароль от учетной записи указаной выше в скрипте установки для каждого узла.
• Начать установку Geo сейчас — подтвердите начало установки кластера на узлах, нажмите «Enter» выбрав ответ по умолчанию [y].
• Продолжить установку MULTIDIRECTORY на указанных серверах — подтвердите установку кластера MULTIDIRECTORY на указанных узлах, если все верно или прервите установку, если введеные данные не верны, комбинацией класишь «Ctrl+c»

После подтверждения вводимых данных, начнется установка кластера MULTIDIRECTORY.

Описание вводимых параметров

• Обнаружено расхождение времени или отсутствует синхронизация. Настроить PostgreSQL master как локальный NTP-сервер — выберите установить ли мастера PostgreSQL, как локального синхронизатора времени для реплик.

После всплывающей информации о завершении настройки первого узла, перейдите в интерфейс MULTIDIRECTORY по IP-адресу или FQDN, пройдите все настройки и перейдите в командную строку для продолжения установки на остальных узлах.

Описание вводимых параметров

• Вы завершили настройку в интерфейсе первого MD-узла — по завершению настройки первого узла, нажмите [y] для продолжения установки кластера MULTIDIRECTORY.

Далее продолжится установка на последующих серверах, в конце появится отладочная информация об успешной установки кластера на узлах и ссылками для перехода в интерфейс MD.

Кластер успешно установлен, если появилась данная отладочная информация.

Linux

Создайте папку для MULTIDIRECTORY:

mkdir MultiDirectory; cd MultiDirectory;

Скачайте необходимые файлы:

wget -O setup.sh https://raw.githubusercontent.com/MultiDirectoryLab/MultiDirectory/main/.package/setup.sh
wget -O docker-compose.yml https://github.com/MultiDirectoryLab/MultiDirectory/releases/download/v2.8.0/docker-compose.yml
wget -O traefik.yml https://github.com/MultiDirectoryLab/MultiDirectory/releases/download/v2.8.0/traefik.yml
wget -O kea-ctrl-agent.conf https://github.com/MultiDirectoryLab/MultiDirectory/releases/download/v2.8.0/kea-ctrl-agent.conf
wget -O dnsdist.conf https://github.com/MultiDirectoryLab/MultiDirectory/releases/download/v2.8.0/dnsdist.conf
wget -O pdns.conf https://github.com/MultiDirectoryLab/MultiDirectory/releases/download/v2.8.0/pdns.conf
wget -O recursor.conf https://github.com/MultiDirectoryLab/MultiDirectory/releases/download/v2.8.0/recursor.conf    

Запустите установку:

bash setup.sh

После заполнения будет создан файл .env.

Windows (PowerShell)

Создайте папку:

mkdir MultiDirectory; cd MultiDirectory;

Скачайте файлы:

curl -O https://raw.githubusercontent.com/MultiDirectoryLab/MultiDirectory/main/.package/setup.ps1
curl -O https://github.com/MultiDirectoryLab/MultiDirectory/releases/download/v2.8.0/docker-compose.yml
curl -O https://github.com/MultiDirectoryLab/MultiDirectory/releases/download/v2.8.0/traefik.yml
curl -O https://github.com/MultiDirectoryLab/MultiDirectory/releases/download/v2.8.0/kea-ctrl-agent.conf

Запустите сервисы при помощи команды:

 docker compose pull; docker compose up -d

Настройка Web-интерфейса MULTIDIRECTORY

После успешной настройки и запуска сервисов Docker – перейдите в браузер. В поисковую строку введите домен, который ранее был указан при генерации .env-файла. 

Вы попадете в настройку WEB-интерфейса вашей MULTIDIRECTORY.

Проверьте правильность написания домена, выберите необходимые вам настройки:

• Введите имя вашего домена.
• Настроить DNS. Если стоит галочка, то настройка DNS будет произведена сразу же (настройку DNS можно произвести и позже в WEB-интерфейсе администратора).
• Настроить Kerberos. Если стоит галочка, то настройка Kerberos произойдет сразу же (настройку Kerberos можно произвести и позже из интерфейса администратора MULTIDIRECTORY).
• Сгенерировать пароли для Kerberos. Если стоит галочка, то произойдет автоматическая генерация паролей для Kerberos. После настройки WEB-интерфейса сгенерированные пароли будут выгружены в файл.

Нажмите кнопку «Далее». 

Настройка Kerberos

Если НЕ была выбрана автоматическая генерация паролей для Kerberos

Если вы сняли галочку с пункта «Сгенерировать пароли для Kerberos автоматически», появится окно, в которое необходимо будет внести пароли для krbadmin и стэша.

• Krbadmin — это служебная учетная запись сервера Kerberos. Она используется для взаимодействия с сервером LDAP. Данная учетная запись ограничена полномочиями и может управлять только своей выделенной областью в дереве LDAP.
• Пароль stash, используется для защиты мастер ключа шифрования базы данных Kerberos. Вы можете выгрузить внесенные вами пароли в файл.

Требование к паролям:

• Пароли должны быть более 7 символов;
• Пароли не должны быть одинаковыми у krbadmin и стэша (они должны отличаться друг от друга);
• Пароли должны содержать заглавные и строчные буквы (A-Z и a-z) и цифры (0-9).

После внесения паролей нажмите кнопку «Далее».

Внесите данные администратора, под которыми будет осуществлен первоначальный вход.

Требование к паролям:

• Пароли должны быть более 7 символов;
• Пароли должны содержать заглавные и строчные буквы (A-Z и a-z) и цифры (0-9).

Для продолжения нажмите кнопку «Далее». 

В появившемся окне проверьте правильность созданной учетной записи администратора:

• UPN. 
• Отображаемое имя. 
• Email. 

Нажмите кнопку «Далее». 

Настройка DNS

Если был выбран пункт «Настроить DNS» откроется мастер настройки:

Нажмите кнопку «Далее». 

Обозначение полей

• TTL по умолчанию — продолжительность кэширования записи серверами и клиентами до её истечения. Значение измеряется в секундах.

Если был выбран пункт «Привязать к внешнему DNS серверу»

• IP — адрес Вашего внешнего DNS сервера, который будет использоваться.
• TSIG Ключ — содержимое файла, которое было сгенерировано на внешнем DNS сервере.

После заполнения всех полей нажмите кнопку «Далее».

Создание учетной записи администратора завершено. Вход в WEB-интерфейс MULTIDIRECTORY будет осуществлен автоматически.

Скачайте архив с предоставленными Вам образами.

Выполните разархивацию при помощи команды:

sudo tar -xvf Enterprise_complete.tar -C /opt

Перейдите в папку с файлами MULTIDIRECTORY:

 cd /opt/multidirectory 

При запущенной MULTIDIRECTORY запустите скрипт mdctl.sh:

sudo ./mdctl.sh

Выберите пункт «4. Обновить установку»:

Подтвердите начало обновления:

Важно!
При обновлении с версий ниже 3.0.0 обновление произойдет автоматически на версию 3.0.0, после этого будет возможно обновление на последнюю доступную версию.

Выберите образ из списка доступных образов:

После обновления скрипт предложит перейти в Web-интерфейс: