Служба каталогов "Эллес"

Общие сведения

Руководство содержит описание общей схемы и последовательности установки приложений продукта «Служба каталогов»:

приложение «Служба каталогов (ядро)» — пакет inno-samba;
приложение «Менеджер службы каталогов» — пакет dsm;
модуль формирования и экспорта метрик – пакет inno-samba-dc-exporter.

Инструкции по установке отдельных пакетов содержатся в документации на приложения:

«Руководство по установке» на приложение «Служба каталогов (ядро)»;
«Руководство по установке» на приложение «Менеджер службы каталогов»;
«Руководство по эксплуатации» на приложение «Служба каталогов (ядро)», подраздел «Установка» раздела «Мониторинг».

Состав дистрибутива

Дистрибутив продукта состоит из deb-пакетов входящих в него приложений:

пакет inno-samba_<версия>_<архитектура>.deb;
пакет inno-samba-dc-exporter_<версия>_<архитектура>.deb;
пакет dsm_<версия>_<архитектура>.deb.

Дистрибутив распространяется следующими способами:

в виде deb-пакетов, доступных для установки из apt-репозитория https://artifacts.inno.tech/repository/<клиент>-<редакция>-apt-packages;

Перед установкой требуется добавить apt-репозиторий в список репозиториев операционной системы и обеспечить к нему доступ, используя полученные от ГК «Иннотех» публичный ключ и реквизиты пользователя.
в виде архивов в формате tar.gz, доступных для загрузки из репозитория https://artifacts.inno.tech/repository/<клиент>-<редакция>-raw-packages.

Доступ к репозиторию осуществляется с использованием полученных от ГК «Иннотех» реквизитов.

Архивы в репозитории сгруппированы по версиям. Для каждой версии предоставляется стандартный набор архивов с файлами для проверки контрольных сумм:

Способы установки

Доступны следующие способы установки приложений продукта:

установка из apt-репозитория;
установка из архивов.

Установка из apt-репозитория

Для установки требуется следующее:

наименование apt-репозитория в формате https://artifacts.inno.tech/repository/<клиент>-<редакция>-apt-packages;
файл с публичным ключом для доступа к apt-репозиторию;
реквизиты для доступа к apt-репозиторию.

Для установки пакетов на сервере из apt-репозитория:

Добавьте публичный ключ для доступа к apt-репозиторию с пакетом стандартным способом, соответствующим используемому дистрибутиву Linux.

Например, на Astra Linux 1.7 SE или Ubuntu 20.04 используйте стандартную утилиту apt-key:

sudo apt-key add keyfile.pgp

При необходимости установки ключа для проверки подписи исполняемых файлов в защищенном режиме работы Astra Linux 1.7 SE следуйте инструкции в официальной документации.

На Ubuntu 22.04 и выше выполните (от имени пользователя root):

cat keyfile.gpg | gpg --dearmor > /usr/share/keyrings/innotech-keyring.gpg

Создайте файл /etc/apt/auth.conf.d/innotech.conf и задайте в нем реквизиты для доступа к репозиторию в стандартном формате:
```
machine <repo_host> login <repo_user> password <repo_password>
```
Подключите требуемый apt-репозиторий в соответствии с инструкциями для используемого дистрибутива Linux (см., например, инструкцию в официальной документации Astra Linux).

Например, добавьте его в список репозиториев следующим образом:
```
echo -e "deb https://artifacts.inno.tech/repository/<клиент>-<редакция>-apt-packages main" | sudo tee /etc/apt/sources.list.d/innotech.list
```
Обновите пакеты с помощью стандартной команды.

Например, при использовании дистрибутива на основе Debian выполните:
```
sudo apt update
```
Установите пакеты в требуемой последовательности, используя стандартные команды.

Например, при использовании дистрибутива на основе Debian выполните:
```
sudo apt install inno-samba
```

Установка из архивов

Для установки требуется следующее:

наименование репозитория с пакетами в формате https://artifacts.inno.tech/repository/<клиент>-<редакция>-raw-packages;
реквизиты для доступа к apt-репозиторию.

Для установки пакетов на сервере из архивов:

Загрузите архивы с пакетами требуемых версий и соответствующие файлы контрольных сумм из репозитория https://artifacts.inno.tech/repository/<клиент>-<редакция>-raw-packages любым доступным способом.
Убедитесь в целостности архивов, сравнив их контрольные суммы с контрольными суммами в соответствующих файлах.

Например:
```
shasum -a 512 -c inno-samba-packages-1.1.0.tar.gz inno-samba-packages-1.1.0.tar.gz.sha512
```
Создайте временный каталог для распаковки и распакуйте архив:

Например:
```
mkdir inno-samba
tar xvf inno-samba-packages-1.1.0-amd64.tar.gz -C inno-samba
```
Установите deb-пакеты стандартным способом:

Например:
```
cd inno-samba/packages
sudo apt install inno-samba_1.1.0_amd64.deb
```

Последовательность установки

Приложения продукта устанавливаются на контроллере домена в следующем порядке:

Подготовка окружения в соответствии с документацией на приложения (см. разделы «Предварительные требования» в руководствах по установке).
Установка пакета inno-samba одним из доступных способов (см. раздел «Установка» в руководстве по установке для приложения «Служба каталогов (ядро)»).
Создание (инициализация) нового домена Samba AD или присоединение к существующему домену (см. раздел «Инициализация/присоединение» в руководстве по эксплуатации для приложения «Служба каталогов (ядро)»).
Настройка серверов DNS и DHCP, а также настройка репликации (при необходимости).
Установка пакета dsm одним из доступных способов (см. раздел «Установка» в руководстве по установке для приложения «Менеджер службы каталогов»).
Установка пакета inno-samba-dc-exporter одним из доступных способов (см. подраздел «Установка» раздела «Мониторинг» в руководстве по эксплуатации для приложения «Служба каталогов (ядро)»).
Настройка сбора метрик (см. раздел «Настройка сбора метрик» раздела «Мониторинг» в руководстве по эксплуатации для приложения «Служба каталогов (ядро)»).

Руководство по установке