Установка пакета dsm

Раздел содержит инструкции по установке приложения «Менеджер службы каталогов».

Подготовка к установке

Перед началом установки приложения на сервере убедитесь в наличии требуемого программного обеспечения и выполните шаги по предварительной настройке.

Требования к программному обеспечению

В текущей реализации приложение может устанавливаться на сервер под управлением ОС Astra Linux Special Edition версии 1.7 и выше.

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

Предварительная настройка

Для предварительной настройки:

  1. В каталоге opt создайте подкаталог dsm.

  2. В подкаталоге dsm создайте файл application.yml.

    Итоговый путь к файлу:

    /opt/dsm/application.yml

  3. Добавьте в файл application.yml необходимые параметры (см. пример файла):

    При создании файла application.yml соблюдайте отступы. В противном случае приложение не запустится.
    • секция server:

      • port — порт для подключения к приложению;

        Значение по умолчанию — port: 8080.
      • ssl — настройки SSL-соединения:

        В примере файла application.yml указаны параметры SSL-соединения, при которых приложение будет доступно только по HTTPS.
        • key-store — путь к хранилищу ключей, содержащему сертификат SSL;

        • key-store-password — пароль, используемый для доступа к хранилищу ключей;

        • key-store-type — тип хранилища ключей (JKS или PKCS12);

        • key-alias — псевдоним, идентифицирующий ключ в хранилище ключей;

        • key-password — пароль, используемый для доступа к ключу в хранилище ключей;

    • секция logging:

      • level — уровень логирования для приложения (формат: <название приложения>: <уровень логирования>);

    • секция ldap:

      • connection — настройки подключения к контроллеру домена:

        • host — адрес для подключения;

        • port — порт для подключения;

        • user — имя пользователя;

        • password — пароль пользователя;

      • base-dn — объект каталога, начиная с которого производится поиск;

    • секция domain:

      • name — имя домена;

    • секция management:

      • server:port — порт для подключения к актуаторам приложения.

    Пример application.yml:

    server:
      port: 8090
      ssl:
        key-store: /opt/dsm/springboot.p12
        key-store-password: password
        key-store-type: pkcs12
        key-alias: springboot
        key-password: password
    
    logging:
      level:
        tech.inno.dsm: DEBUG
    
    ldap:
      connection:
        host: 172.0.0.1
        port: 389
        user: CN=Administrator,CN=Users,DC=SAMBA,DC=LAN
        password: Welkom123
      base-dn: DC=SAMBA,DC=LAN
    
    domain:
      name: SAMBA.LAN
    
    management:
      server:
        port: 8081

Установка

Для установки:

  1. Подключите apt-репозиторий или загрузите архив с пакетом dsm (см. раздел «Способы установки»).

  2. Установите пакет:

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

      sudo apt install dsm
    • при установке из архива укажите путь к распакованным файлам и имя пакета; например:

      sudo apt install /dsm/deb/dsm_1.4.0-1_amd64.deb

После установки приложение запускается автоматически под root-правами. Пользовательский интерфейс приложения доступен в веб-браузере на порте, указанном в файле application.yml (по умолчанию — 8080).

Запуск приложения выполняется под root-правами, допустимо использовать значение порта ниже 1000.