Для улучшения работы сайта мы используем файлы cookies. Оставаясь на сайте, вы соглашаетесь с политикой обработки персональных данных.

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

Версия Termit: 2.1

Аннотация

В этом документе описано, как администраторам установить компоненты системы терминального доступа «Термит».

1. Введение

Термит — это система терминального доступа (СТД). Предназначена для организации удаленного доступа конечных пользователей к приложениям, опубликованным на терминальных серверах. Пользователи получают защищенный доступ к установленным администраторами ресурсам с учетом назначенных прав доступа и текущей нагрузки на серверы.

Возможности СТД «Термит»:

  • поддержка терминальных серверов на базе операционных систем Windows и Linux;

  • совместное использование пользователями ресурсов с минимальными усилиями на администрирование и развертывание;

  • безопасный доступ к централизованно развернутым приложениям;

  • публикация рабочего стола и приложений.

1.1. Термины и определения

Термин Определение

Агент

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

Балансировщик нагрузки

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

Брокер

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

Группа доступа приложения

Пользователи, которые состоят в группе LDAP и могут запускать приложение. Поддерживаются вложенные группы

Группа серверов

Ферма терминальных серверов. С помощью группы серверов можно балансировать нагрузку и объединять их по настройкам и приложениям, которые эти серверы запускают. Группы серверов нужны для обеспечения отказоустойчивости

Пользователи

Сотрудники предприятий, внешние пользователи, которые могут запускать приложение, и администраторы, которые могут настраивать СТД «Термит»

Приложение

Программное обеспечение, которое запускается на терминальном сервере. Интерфейс отображается локально на компьютере пользователя

Рабочий стол

Экранная рабочая область, аналогичная локальному рабочему столу. Состоит из рабочей области и панели задач

Терминальная сессия

Пользовательский сеанс. Сессия начинается, когда пользователь запустил приложение. И завершается, когда пользователь закрыл приложение. Администратор может завершить сессию принудительно

Терминальный сервер

Сервер, на котором запускается программное обеспечение, например 1С, браузер или офисный пакет приложений

Шлюз удаленного доступа

Компонент системы, обеспечивающий доступ к внешним пользователям к терминальным серверам

1.2. Архитектура

В этом разделе приведены базовая архитектура и архитектура с внутренними и внешними пользователями.

1.2.1. Базовая архитектура

Ниже представлена схема базовой архитектуры с одним брокером, без балансировщика нагрузки и шлюза.

schm  arch2
Описание работы СТД «Термит»
Аутентификация
  1. Пользователь запускает клиент. Далее вводит адрес брокера.

  2. Пользователь вводит имя доменной учетной записи и пароль.

  3. Брокер проверяет эти данные на сервере LDAP.

  4. Брокер возвращает клиенту токен для аутентификации в REST API.

Получение списка приложений
  1. Клиент запрашивает у брокера список приложений, доступных пользователю. Брокер проверяет права пользователя (сравнивая его группы с теми, которые назначены на приложения) и отдает список доступных приложений.

Старт сессии
  1. Пользователь запускает нужное приложение (например, калькулятор). Клиент отправляет брокеру запрос на старт новой терминальной сессии.

  2. Брокер выбирает терминальный сервер, который может обслужить запрос.

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

  4. Десктоп-клиент стартует сессию на терминальном сервере. В процессе старта десктоп-клиент запрашивает у пользователя имя учетной записи и пароль и отправляет их терминальному серверу. Терминальный сервер проводит аутентификацию пользователя. Десктоп-клиент настраивает перенаправление звука, файловой системы, печати и запускает калькулятор в сессии.

  5. На стороне терминального сервера агент завершает создание сессии (уведомляет брокер о том, что создана сессия с X2Go/RDP ID. Далее происходит синхронизация этого ID c ID из БД).

  6. Сессия готова к работе.

1.2.2. Архитектура с внутренними пользователями

Ниже представлена схема архитектуры с внутренними пользователями, несколькими брокерами, балансировщиком нагрузки и без шлюза.

schm  internal client
Описание работы СТД «Термит»
Аутентификация
  1. Пользователь запускает клиент. Затем вводит адрес балансировщика нагрузки. Балансировщик нагрузки определяет, какой брокер будет обслуживать данного пользователя. И в дальнейшем перенаправляет все запросы пользователя на выбранный брокер.

  2. Пользователь вводит имя доменной учетной записи и пароль.

  3. Брокер проверяет эти данные на сервере LDAP.

  4. Брокер возвращает клиенту токен для аутентификации в REST API.

Получение списка приложений
  1. Клиент запрашивает у брокера список приложений, доступных пользователю. Брокер проверяет права пользователя, сравнивая его группы с теми, которые назначены на приложения, и отдает список доступных приложений.

Старт сессии
  1. Пользователь запускает нужное приложение (например, калькулятор). Клиент отправляет брокеру запрос на старт новой терминальной сессии.

  2. Брокер выбирает терминальный сервер, который может обслужить запрос.

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

  4. Десктоп-клиент начинает сессию на терминальном сервере. В процессе старта десктоп-клиент запрашивает у пользователя имя учетной записи и пароль и отправляет их терминальному серверу. Терминальный сервер проводит аутентификацию пользователя. Десктоп-клиент настраивает перенаправление звука, файловой системы, печати и запускает калькулятор в сессии.

  5. На стороне терминального сервера агент завершает создание сессии (уведомляет брокер о том, что создана сессия с X2Go/RDP ID. Далее происходит синхронизация этого ID c ID из БД).

  6. Сессия готова к работе.

1.2.3. Архитектура с внешними пользователями

Ниже представлена схема архитектуры с внешними пользователями, несколькими брокерами, балансировщиком нагрузки и шлюзом.

schm  external client
Описание работы СТД «Термит»
Аутентификация
  1. Пользователь запускает клиент. Затем вводит адрес балансировщика нагрузки. Балансировщик нагрузки определяет, какой брокер будет обслуживать данного пользователя. И в дальнейшем перенаправляет все запросы пользователя на выбранный брокер.

  2. Пользователь вводит имя доменной учетной записи и пароль.

  3. Брокер проверяет эти данные на сервере LDAP.

  4. Брокер возвращает клиенту токен для аутентификации в REST API.

Получение списка приложений
  1. Клиент запрашивает у брокера список приложений, доступных пользователю. Брокер проверяет права пользователя, сравнивая его группы с теми, которые назначены на приложения, и отдает список доступных приложений.

Старт сессии
  1. Пользователь запускает нужное приложение (например, калькулятор). Клиент отправляет брокеру запрос на старт новой терминальной сессии.

  2. Брокер выбирает терминальный сервер, который может обслужить запрос.

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

  4. Пользователь подключается к шлюзу и проходит на нем аутентификацию.

  5. Десктоп-клиент с помощью шлюза начинает сессию на терминальном сервере. В процессе старта десктоп-клиент запрашивает у пользователя имя учетной записи и пароль и отправляет их терминальному серверу. Терминальный сервер проводит аутентификацию пользователя. Десктоп-клиент настраивает перенаправление звука, файловой системы, печати и запускает калькулятор в сессии.

  6. На стороне терминального сервера агент завершает создание сессии (уведомляет брокер о том, что создана сессия с X2Go/RDP ID. Далее происходит синхронизация этого ID c ID из БД).

  7. Сессия готова к работе.

2. Требования к окружению

В этом разделе приведены рекомендуемые системные и сетевые требования.

2.1. Рекомендуемые системные требования для продуктивной инсталляции

В таблицах ниже приведены требования для балансировщика нагрузки HAProxy и шлюзов удаленного доступа OpenSSH. Вы можете использовать другие.

Компонент Требования

Брокер (серверный вариант установки, без графической среды)

ОС:

  • РЕД ОС 7.3.2, 7.3.4

  • Debian 12

  • Astra Linux 1.7.4

  • OpenSUSE 15.5

  • ALT Linux 10.1

vCPU — 4

vRAM, ГБ — 8

Хранилище, ГБ — 100

Балансировщик нагрузки HAProxy (серверный вариант установки, без графической среды)

ОС:

  • РЕД ОС 7.3.2, 7.3.4

  • Debian 12

  • Astra Linux 1.7.4

  • OpenSUSE 15.5

  • ALT Linux 10.1

vCPU — 4

vRAM, ГБ — 8

Хранилище, ГБ — 100

Терминальный сервер (серверный вариант установки, с графическим окружением)

ОС:

  • РЕД ОС 7.3.2, 7.3.4

  • Astra Linux 1.7.4

  • Windows Server 2012 R2

  • Windows Server 2016

  • Windows Server 2019

  • ALT Linux 10.1

  • Debian 12

vCPU — 4

vRAM, ГБ — 8

Хранилище, ГБ — 100

Требования к сессии:

  • Базовые:

    • vCPU — 0,5

    • vRAM, ГБ — 1

    • Хранилище, ГБ — 0,5

  • Расширенные:

    • vCPU — 1

    • vRAM, ГБ — 2

    • Хранилище, ГБ — 2

Рекомендуется резерв 15-20% от полученных значений.

Базовые требования подходят для работы с опубликованным приложением в режиме RemoteApp (текстовый редактор/редактор таблиц/браузер).

Расширенные требования подходят для работы с опубликованными приложениями в режиме RemoteApp или удаленным рабочим столом (текстовый редактор/редактор таблиц/браузер).

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

Шлюзы удаленного доступа OpenSSH (серверный вариант установки, без графической среды)

ОС:

  • РЕД ОС 7.3.2, 7.3.4

  • Debian 12

  • Astra Linux 1.7.4

  • OpenSUSE 15.5

  • ALT Linux 10.1

vCPU — 4

vRAM, ГБ — 8

Хранилище, ГБ — 100

Среда рабочего стола терминального сервера

  • MATE

  • XFCE

  • Fly-wm (для Astra Linux)

База данных

PostgreSQL 11 и выше

vCPU — 4

vRAM, ГБ — 8

Хранилище, ГБ — 100

Дополнительный диск для базы данных, ГБ — 150

Клиентская машина

ОС:

  • РЕД ОС 7.3.2, 7.3.4

  • Astra Linux 1.7.4

  • Microsoft Windows 7 x32 и x64

  • Microsoft Windows 8.1 x32 и x64

  • Microsoft Windows 10 x32 и x64

  • Microsoft Windows 11 x64

  • MacOS Х

  • ALT Linux 10.1

Служба каталогов

  • Microsoft Active Directory 2012 и выше (в качестве LDAP-каталога)

  • Samba DC 4.17 (необходимо отключить обязательное использование шифрования)

  • РЕД АДМ (Промышленная редакция) версии 1.0.2, РЕД АДМ DC 4.19.0

2.2. Минимальные системные требования для тестовой инсталляции

Компонент Требования

Брокер (серверный вариант установки, без графической среды)

ОС:

  • РЕД ОС 7.3.2, 7.3.4

  • Debian 12

  • Astra Linux 1.7.4

  • OpenSUSE 15.5

  • ALT Linux 10.1

vCPU — 2

vRAM, ГБ — 4

Хранилище, ГБ — 50

Балансировщик нагрузки HAProxy (серверный вариант установки, без графической среды)

ОС:

  • РЕД ОС 7.3.2, 7.3.4

  • Debian 12

  • Astra Linux 1.7.4

  • OpenSUSE 15.5

  • ALT Linux 10.1

vCPU — 2

vRAM, ГБ — 2

Хранилище, ГБ — 50

Шлюзы удаленного доступа OpenSSH (серверный вариант установки, без графической среды)

ОС:

  • РЕД ОС 7.3.2, 7.3.4

  • Debian 12

  • Astra Linux 1.7.4

  • OpenSUSE 15.5

  • ALT Linux 10.1

vCPU — 2

vRAM, ГБ — 2

Хранилище, ГБ — 50

База данных

PostgreSQL 11 и выше

vCPU — 2

vRAM, ГБ — 4

Хранилище, ГБ — 50

Терминальный сервер (серверный вариант установки, с графическим окружением)

ОС:

  • РЕД ОС 7.3.2, 7.3.4

  • Astra Linux 1.7.4

  • Windows Server 2012 R2

  • Windows Server 2016

  • Windows Server 2019

  • ALT Linux 10.1

  • Debian 12

vCPU — 4

vRAM, ГБ — 4

Хранилище, ГБ — 50

Базовые требования к сессии:

  • vCPU — 0,2

  • vRAM, ГБ — 0,5

  • Хранилище, ГБ — 0,2

Базовые требования подходят для работы с опубликованным приложением в режиме RemoteApp (текстовый редактор/редактор таблиц/браузер).

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

2.3. Сетевые требования

Источник Назначение Протокол Порт Описание

Брокер

База данных

TCP

5432

Связь с сервером баз данных PostgreSQL

Служба каталогов

TCP

389

LDAP

Терминальный сервер

TCP

8443

Связь: брокер  агент Термит

TCP

8443

Связь: сервис мониторинга (Prometheus)  агент Термит

TCP

9100

Связь: сервис мониторинга (Prometheus)  агент мониторинга (Prometheus)

Балансировщик нагрузки

TCP

443

Связь: балансировщик нагрузки-брокер  брокер-балансировщик нагрузки

TCP

8080

Связь: балансировщик нагрузки-брокер  брокер-балансировщик нагрузки

Межсервисная коммуникация

TCP

9090

Связь: брокер  сервис мониторинга (Prometheus)

Шлюз удаленного рабочего стола

Терминальный сервер (Linux)

TCP

22

SSH подключение к терминальному серверу

Терминальный сервер (Windows)

TCP

3389

RDP подключение к терминальному серверу

Служба каталогов

TCP

389

LDAP

Клиент

Шлюз удаленного рабочего стола

TCP

22

Связь: клиент  шлюз

Терминальный сервер (Linux)

TCP

22

SSH подключение к терминальному серверу без использования компонента шлюз

Терминальный сервер (Windows)

TCP

3389

RDP подключение к терминальному серверу без использования компонента шлюз

Балансировщик нагрузки

TCP

443

HTTPS подключение к брокеру

3. Подготовка окружения

Для подготовки окружения:

  1. Разверните серверы:

    • для брокеров. На этой ВМ будет устанавливаться сервис;

    • для терминальных серверов под управлением Windows или Linux в зависимости от требований;

    • (Опционально) для сервера баз данных. Можно использовать существующий сервер.

  2. Проверьте доступ к службе каталогов и PostgreSQL.

  3. Проверьте с помощью команд nslookup, ping, что брокер зарегистрирован на DNS-сервере и доступен. В выводе команды не должно быть ошибок.

  4. Добавьте терминальный сервер в домен службы каталогов.

  5. В каталоге пользователей создайте сервисную учетную запись для синхронизации объектов из службы каталогов. Обязательно отключите опцию «User must change password at next logon» и включите «Password never expires».

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

  7. В каталоге пользователей добавьте в состав групп, созданных на предыдущем шаге, учетные записи пользователей для взаимодействия с СТД «Термит».

4. Настройка межсетевого экрана

В этом разделе описано, как проверить настройки межсетевого экрана (МСЭ).

4.1. РЕД ОС

Чтобы проверить настройки МСЭ на каждом из серверов, выполните команду:

sudo systemctl status firewalld.service

Если в выводе команды отображается информация, как на изображении ниже, то дальнейшие шаги по конфигурации МСЭ можно пропустить, так как он выключен.

s  code1

В случае если вывод команды отличается, то необходима дополнительная конфигурация МСЭ. Для этого:

  1. Определите активную зону МСЭ с помощью команды:

    firewall-cmd --get-default-zone
  2. Добавьте правила по списку портов в необходимую активную зону с помощью команды:

    sudo firewall-cmd --zone=%Активная_Зона% --permanent --add-port=%Порт%/tcp

    Где:

    • %Активная_Зона% — текущая активная зона из шага 1.

    • %Порт% — необходимый порт. Список портов смотрите в разделе Сетевые требования.

      Например:

      sudo firewall-cmd –zone=public --permanent --add-port=5432/tcp

4.2. Astra Linux

Чтобы проверить настройки МСЭ на каждом из серверов, выполните команду:

sudo ufw status

Если выполнение команды возвращает ответ «Status: inactive», то дальнейшие шаги по конфигурации МСЭ можно пропустить, так как он выключен.

В случае если вывод команды отличается, то необходима дополнительная конфигурация МСЭ. Для этого добавьте соответствующие разрешения командой:

sudo ufw allow %Порт%/tcp

Где: %Порт% — необходимый порт. Список портов смотрите в разделе Сетевые требования.

4.3. ALT Linux

Чтобы проверить настройки МСЭ на каждом из серверов, выполните команду:

sudo efw

Если выполнение команды возвращает ответ «Firewall is disabled», то дальнейшие шаги по конфигурации МСЭ можно пропустить, так как он выключен.

В случае если вывод команды отличается, то необходима дополнительная конфигурация МСЭ. Для этого добавьте соответствующие правила. В зависимости от используемого МСЭ команды могут отличаться. Подробнее о создании правил МСЭ описано в статьях Etcnet Firewall и UFW.

4.4. Windows

Чтобы настроить межсетевой экран на сервере:

  1. Откройте любым способом Монитор брандмауэра Защитника Windows в режиме повышенной безопасности.

  2. Выберите Правила для входящих подключений.

    s  firewall
  3. Нажмите Создать правило.

  4. На вкладке Тип правила активируйте опцию Для порта.

  5. Нажмите Далее.

  6. На вкладке Протокол и порты оставьте Протокол TCP по умолчанию. В параметре Определенные локальные порты: укажите «8443». Полный список портов смотрите в разделе Сетевые требования.

  7. Нажмите Далее  Далее  Далее.

  8. На вкладке Имя задайте имя, например «Termit Agent».

Можно создать правило в межсетевом экране с помощью PowerShell:

New-NetFirewallRule -DisplayName "termit-agent TCP 8443" -Direction inbound -Profile Any -Action Allow -LocalPort 8443 -Protocol TCP

5. Базовая конфигурация базы данных

В этом разделе представлена базовая информация по подготовке сервера баз данных PostgreSQL.

Повторное использование базы данных для новой инсталляции невозможно.

5.1. РЕД ОС

В этой инструкции используется последняя доступная версия СУБД PostgreSQL 15. В случае если используется другая версия, то выполняемые команды необходимо изменить. Более подробно можно ознакомиться на сайте документации РЕД ОС.

  1. Установите PostgreSQL с помощью команды:

    sudo dnf install postgresql15-server
  2. Инициализируйте базу данных с помощью команды:

    sudo postgresql-15-setup initdb
  3. Запустите сервис PostgreSQL с помощью команды:

    sudo systemctl enable postgresql-15.service --now
  4. Чтобы разрешить удаленное подключение к СУБД, в файле конфигурации /var/lib/pgsql/15/data/postgresql.conf параметр listen_addresses должен соответствовать значению '*':

    s  bd1

    Отображение параметров на скриншоте может отличаться. Зависит от версии PostgreSQL.

  5. Чтобы разрешить удаленное подключение к СУБД с паролем, добавьте в файл конфигурации /var/lib/pgsql/15/data/pg_hba.conf строку:

    host    all             all             0.0.0.0/0               password
    s  bd2

    Отображение параметров на скриншоте может отличаться. Зависит от версии PostgreSQL.

  6. Запустите сессию служебного пользователя postgres с помощью команды:

    sudo su - postgres
  7. Запустите командную оболочку postgres с помощью команды:

    psql
  8. Если при установке брокера:

    • будет выбрана опция «подключиться к уже существующей базе данных», то выполните шаги:

      1. Создайте пустую базу данных с помощью команды:

        CREATE DATABASE %Имя_Базы%;
      2. Создайте нового пользователя с паролем с помощью команды:

        CREATE USER %Имя_Пользователя% WITH PASSWORD '%Пароль_Пользователя%';
      3. Установите права владельца для созданного пользователя на созданную базу с помощью команды:

        ALTER DATABASE %Имя_Базы% OWNER TO %Имя_Пользователя%;
      4. Выйдите из командной оболочки psql и сессии пользователя postgres с помощью команды:

        exit
      5. Перезапустите сервис PostgreSQL с помощью команды:

        sudo systemctl restart postgresql-15.service
    • будет выбрана опция «создать новую базу данных», то выполните шаги:

      1. Создайте нового пользователя с паролем и правами на создание новых баз данных с помощью команды:

        CREATE USER %Имя_Пользователя% WITH PASSWORD '%Пароль_Пользователя%' CREATEDB;
      2. Выйдите из командной оболочки psql и сессии пользователя postgres с помощью команды:

        exit
      3. Перезапустите сервис PostgreSQL с помощью команды:

        sudo systemctl restart postgresql-15.service

5.2. Astra Linux

В случае инсталляций в режиме контроля мандатного доступа («Воронеж» и «Смоленск») может потребоваться дополнительная конфигурация операционной системы. Подробнее о настройках PostgreSQL и мандатном управлении доступа.

  1. Установите PostgreSQL из репозитория с помощью команды:

    sudo apt install postgresql-11
  2. Проверьте статус сервиса PostgreSQL с помощью команды:

    sudo systemctl status postgresql
  3. При необходимости запустите сервис с помощью команды:

    sudo systemctl start postgresql
  4. Чтобы разрешить удаленное подключение к СУБД, в файле конфигурации /etc/postgresql/11/main/postgresql.conf параметр listen_addresses должен соответствовать значению '*':

    s  bd3

    Отображение параметров на скриншоте может отличаться. Зависит от версии PostgreSQL.

  5. Чтобы разрешить удаленное подключение к СУБД с паролем, добавьте в файл конфигурации /etc/postgresql/11/main/pg_hba.conf строку:

    host    all             all             0.0.0.0/0               password
    s  bd4

    Отображение параметров на скриншоте может отличаться. Зависит от версии PostgreSQL.

  6. Чтобы разрешить удаленное подключение к СУБД пользователю в режиме контроля мандатного доступа, в параметре zero_if_notfound задайте значение yes в файле /etc/parsec/mswitch.conf:

    s  bd5
  7. Запустите сессию служебного пользователя postgres с помощью команды:

    sudo su - postgres
  8. Запустите командную оболочку postgres с помощью команды:

    psql
  9. Если при установке брокера:

    • будет выбрана опция «подключиться к уже существующей базе данных», то выполните шаги:

      1. Создайте пустую базу данных с помощью команды:

        CREATE DATABASE %Имя_Базы%;
      2. Создайте нового пользователя с паролем с помощью команды:

        CREATE USER %Имя_Пользователя% WITH PASSWORD '%Пароль_Пользователя%';
      3. Установите права владельца для созданного пользователя на созданную базу с помощью команды:

        ALTER DATABASE %Имя_Базы% OWNER TO %Имя_Пользователя%;
      4. Выйдите из командной оболочки psql и сессии пользователя postgres с помощью команды:

        exit
      5. Перезапустите сервис PostgreSQL с помощью команды:

        sudo systemctl restart postgresql
    • будет выбрана опция «создать новую базу данных», то выполните шаги:

      1. Создайте нового пользователя с паролем и правами на создание новых баз данных с помощью команды:

        CREATE USER %Имя_Пользователя% WITH PASSWORD '%Пароль_Пользователя%' CREATEDB;
      2. Выйдите из командной оболочки psql и сессии пользователя postgres с помощью команды:

        exit
      3. Перезапустите PostgreSQL с помощью команды:

        sudo systemctl restart postgresql

5.3. Debian

  1. Установите сервис PostgreSQL с помощью команды:

    sudo apt install postgresql-15
  2. Проверьте статус сервиса с помощью команды:

    sudo systemctl status postgresql
  3. При необходимости запустите сервис с помощью команды:

    sudo systemctl enable postgresql --now
  4. Чтобы разрешить удаленное подключение к СУБД, в файле конфигурации /etc/postgresql/15/main/postgresql.conf, в параметре listen_addresses должно быть значение '*':

    s  debian1
  5. Чтобы разрешить удаленное подключение к СУБД, добавьте в файл конфигурации /etc/postgresql/15/main/pg_hba.conf строку:

    host    all             all             0.0.0.0/0               password
  6. Запустите сессию служебного пользователя postgres с помощью команды:

    sudo su - postgres
  7. Запустите командную оболочку postgres с помощью команды:

    psql
  8. Если при установке брокера:

    • будет выбрана опция «подключиться к уже существующей базе данных», то выполните шаги:

      1. Создайте пустую базу данных с помощью команды:

        CREATE DATABASE %Имя_Базы%;
      2. Создайте нового пользователя с паролем с помощью команды:

        CREATE USER %Имя_Пользователя% WITH PASSWORD '%Пароль_Пользователя%';
      3. Установите права владельца для созданного пользователя на созданную базу с помощью команды:

        ALTER DATABASE %Имя_Базы% OWNER TO %Имя_Пользователя%;
      4. Выйдите из командной оболочки psql и сессии пользователя postgres с помощью команды:

        exit
      5. Перезапустите сервис PostgreSQL с помощью команды:

        sudo systemctl restart postgresql
    • будет выбрана опция «создать новую базу данных», то выполните шаги:

      1. Создайте нового пользователя с паролем и правами на создание новых баз данных с помощью команды:

        CREATE USER %Имя_Пользователя% WITH PASSWORD '%Пароль_Пользователя%' CREATEDB;
      2. Выйдите из командной оболочки psql и сессии пользователя postgres с помощью команды:

        exit
  9. Перезапустите сервис PostgreSQL с помощью команды:

    sudo systemctl restart postgresql

5.4. ALT Linux

Подробнее об установке PostgreSQL можно прочесть на официальном сайте ALT Linux.

  1. Установите компоненты PostgreSQL с помощью команды:

    sudo apt-get install postgresql11-server
  2. Инициализируйте сервер БД с помощью команды:

    sudo /etc/init.d/postgresql initdb
  3. Запустите и добавьте автозапуск с помощью команды:

    sudo systemctl enable postgresql --now
  4. Чтобы разрешить удаленное подключение к СУБД, в файле конфигурации /var/lib/pgsql/data/postgresql.conf параметр listen_addresses должен соответствовать значению '*'.

    s  sql1
  5. Чтобы разрешить удаленное подключение к СУБД с паролем, добавьте в файл конфигурации /var/lib/pgsql/data/pg_hba.conf строку:

    host    all             all             0.0.0.0/0               password
    s  sql2
  6. Перезапустите сервис с помощью команды:

    sudo systemctl restart postgresql
  7. Перейдите в консоль управления БД с помощью команды:

    psql -U postgres
  8. Если при установке брокера:

    • будет выбрана опция «подключиться к уже существующей базе данных», то выполните шаги:

      1. Создайте пустую базу данных с помощью команды:

        CREATE DATABASE %Имя_Базы%;
      2. Создайте нового пользователя с паролем с помощью команды:

        CREATE USER %Имя_Пользователя% WITH PASSWORD '%Пароль_Пользователя%';
      3. Установите права владельца для созданного пользователя на созданную базу с помощью команды:

        ALTER DATABASE %Имя_Базы% OWNER TO %Имя_Пользователя%;
      4. Выйдите из командной оболочки psql и сессии пользователя postgres с помощью команды:

        exit
      5. Перезапустите сервис PostgreSQL с помощью команды:

        sudo systemctl restart postgresql
    • будет выбрана опция «создать новую базу данных», то выполните шаги:

      1. Создайте нового пользователя с паролем и правами на создание новых баз данных с помощью команды:

        CREATE USER %Имя_Пользователя% WITH PASSWORD '%Пароль_Пользователя%' CREATEDB;
      2. Выйдите из командной оболочки psql и сессии пользователя postgres с помощью команды:

        exit
      3. Перезапустите сервис PostgreSQL с помощью команды:

        sudo systemctl restart postgresql

5.5. OpenSUSE

  1. Установите компоненты PostgreSQL с помощью команды:

    При необходимости измените версию PostgreSQL.

    sudo zypper install postgresql postgresql-server postgresql-contrib
  2. Запустите и добавьте автозапуск с помощью команды:

    sudo systemctl enable postgresql --now
  3. Чтобы разрешить удаленное подключение к СУБД, в файле конфигурации /var/lib/pgsql/data/postgresql.conf, параметр listen_addresses должен соответствовать значению '*'.

    s  sql3
  4. Чтобы разрешить удаленное подключение к СУБД с паролем, добавьте в файл конфигурации /var/lib/pgsql/data/pg_hba.conf строку:

    host    all             all             0.0.0.0/0               password
    s  sql4
  5. Перезапустите сервис с помощью команды:

    sudo systemctl restart postgresql
  6. Проверьте статус сервиса с помощью команды:

    sudo systemctl status postgresql

    Статус должен быть «Active».

    s  sql5
  7. Перейдите в консоль управления БД с помощью команды:

    psql -U postgres
  8. Если при установке брокера:

    • будет выбрана опция «подключиться к уже существующей базе данных», то выполните шаги:

      1. Создайте пустую базу данных с помощью команды:

        CREATE DATABASE %Имя_Базы%;
      2. Создайте нового пользователя с паролем с помощью команды:

        CREATE USER %Имя_Пользователя% WITH PASSWORD '%Пароль_Пользователя%';
      3. Установите права владельца для созданного пользователя на созданную базу с помощью команды:

        ALTER DATABASE %Имя_Базы% OWNER TO %Имя_Пользователя%;
      4. Выйдите из командной оболочки psql и сессии пользователя postgres с помощью команды:

        exit
      5. Перезапустите сервис PostgreSQL с помощью команды:

        sudo systemctl restart postgresql
    • будет выбрана опция «создать новую базу данных», то выполните шаги:

      1. Создайте нового пользователя с паролем и правами на создание новых баз данных с помощью команды:

        CREATE USER %Имя_Пользователя% WITH PASSWORD '%Пароль_Пользователя%' CREATEDB;
      2. Выйдите из командной оболочки psql и сессии пользователя postgres с помощью команды:

        exit
      3. Перезапустите сервис PostgreSQL с помощью команды:

        sudo systemctl restart postgresql

6. Установка балансировщика нагрузки

В этом разделе описано, как установить балансировщик нагрузки HAProxy, в случае если планируется инсталляция нескольких брокеров. Если вы планируете конфигурацию с одним брокером, то пропустите этот шаг и перейдите к установке брокера.

Вы можете использовать другой балансировщик нагрузки.

Рекомендуемый тип балансировки — привязка пользователя к конкретному серверу (balance source и hash-type consistent).

Подробнее о типах балансировки.

6.1. РЕД ОС

  1. Установите ПО HAProxy с помощью команды:

    sudo dnf install haproxy
  2. Включите службу haproxy и добавьте автозагрузку с помощью команды:

    sudo systemctl enable haproxy --now
  3. Добавьте в конец файла конфигурации /etc/haproxy/haproxy.cfg настройку серверов для балансировки.

    Пример конфигурации

    В примере приведен файл конфигурации с типом балансировки Source IP Hash.

    frontend termit
       mode tcp
       bind :80
       default_backend termit_servers
    
    backend termit_servers
       option httpchk
       http-check connect port 8080
       http-check send meth GET  uri /
       mode tcp
       balance source
       hash-type consistent
       server %Имя_Термит_Брокера_1% %IP_Адрес_Термит_Брокера_1%:80 check
       server %Имя_Термит_Брокера_2% %IP_Адрес_Термит_Брокера_2%:80 check
       server %Имя_Термит_Брокера_3% %IP_Адрес_Термит_Брокера_3%:80 check
    
    frontend termit_https
       mode tcp
       bind :443
       default_backend termit_servers_https
    
    backend termit_servers_https
       option httpchk
       http-check connect port 8080
       http-check send meth GET  uri /
       mode tcp
       balance source
       hash-type consistent
       server %Имя_Термит_Брокера_1% %IP_Адрес_Термит_Брокера_1%:443 check
       server %Имя_Термит_Брокера_2% %IP_Адрес_Термит_Брокера_2%:443 check
       server %Имя_Термит_Брокера_3% %IP_Адрес_Термит_Брокера_3%:443 check
    
    frontend termit_8443_https
       mode tcp
       bind :8443
       default_backend termit_servers_8443_https
    
    backend termit_servers_8443_https
       option httpchk
       http-check connect port 8080
       http-check send meth GET  uri /
       mode tcp
       balance source
       hash-type consistent
       server %Имя_Термит_Брокера_1% %IP_Адрес_Термит_Брокера_1%:8443 check
       server %Имя_Термит_Брокера_2% %IP_Адрес_Термит_Брокера_2%:8443 check
       server %Имя_Термит_Брокера_3% %IP_Адрес_Термит_Брокера_3%:8443 check
  4. Проверьте созданный файл конфигурации с помощью команды ниже. Вывод команды не должен содержать ошибок. Предупреждения (warnings) не являются ошибками.

    sudo haproxy -f /etc/haproxy/haproxy.cfg -c
  5. Перезапустите службу с помощью команды:

    sudo systemctl restart haproxy
  6. Проверьте доступность СТД «Термит» по URL адресу, указанному при установке брокер серверов.

6.2. Astra Linux

Для установки используется последняя доступная в репозитории Astra Linux версия HAProxy (2.2.29-2astra13). Подробнее о конфигурации можно ознакомиться на официальном сайте Astra Linux.

  1. Установите ПО HAProxy с помощью команды:

    sudo apt install haproxy
  2. Включите службу haproxy и добавьте автозагрузку с помощью команды:

    sudo systemctl enable haproxy --now
  3. Добавьте в конец файла конфигурации /etc/haproxy/haproxy.cfg настройку серверов для балансировки.

    Пример конфигурации

    В примере приведен файл конфигурации с типом балансировки Source IP Hash.

    frontend termit
       mode tcp
       bind :80
       default_backend termit_servers
    
    backend termit_servers
       option httpchk
       http-check connect port 8080
       http-check send meth GET  uri /
       mode tcp
       balance source
       hash-type consistent
       server %Имя_Термит_Брокера_1% %IP_Адрес_Термит_Брокера_1%:80 check
       server %Имя_Термит_Брокера_2% %IP_Адрес_Термит_Брокера_2%:80 check
       server %Имя_Термит_Брокера_3% %IP_Адрес_Термит_Брокера_3%:80 check
    
    frontend termit_https
       mode tcp
       bind :443
       default_backend termit_servers_https
    
    backend termit_servers_https
       option httpchk
       http-check connect port 8080
       http-check send meth GET  uri /
       mode tcp
       balance source
       hash-type consistent
       server %Имя_Термит_Брокера_1% %IP_Адрес_Термит_Брокера_1%:443 check
       server %Имя_Термит_Брокера_2% %IP_Адрес_Термит_Брокера_2%:443 check
       server %Имя_Термит_Брокера_3% %IP_Адрес_Термит_Брокера_3%:443 check
    
    frontend termit_8443_https
       mode tcp
       bind :8443
       default_backend termit_servers_8443_https
    
    backend termit_servers_8443_https
       option httpchk
       http-check connect port 8080
       http-check send meth GET  uri /
       mode tcp
       balance source
       hash-type consistent
       server %Имя_Термит_Брокера_1% %IP_Адрес_Термит_Брокера_1%:8443 check
       server %Имя_Термит_Брокера_2% %IP_Адрес_Термит_Брокера_2%:8443 check
       server %Имя_Термит_Брокера_3% %IP_Адрес_Термит_Брокера_3%:8443 check
  4. Проверьте созданный файл конфигурации с помощью команды ниже. Вывод команды не должен содержать ошибок. Предупреждения (warnings) не являются ошибками.

    sudo haproxy -f /etc/haproxy/haproxy.cfg -c
  5. Перезапустите службу с помощью команды:

    sudo systemctl restart haproxy
  6. Проверьте доступность СТД «Термит» по URL адресу, указанному при установке брокера.

6.3. Debian

  1. Установите ПО HAProxy с помощью команды:

    sudo systemctl install haproxy
  2. Включите службу haproxy и добавьте автозагрузку с помощью команды:

    sudo systemctl enable haproxy --now
  3. Добавьте в конец файла конфигурации /etc/haproxy/haproxy.cfg настройку серверов для балансировки:

    Пример конфигурации

    В примере приведен файл конфигурации с типом балансировки Source IP Hash.

    frontend termit
       mode tcp
       bind :80
       default_backend termit_servers
    
    backend termit_servers
       option httpchk
       http-check connect port 8080
       http-check send meth GET  uri /
       mode tcp
       balance source
       hash-type consistent
       server %Имя_Термит_Брокера_1% %IP_Адрес_Термит_Брокера_1%:80 check
       server %Имя_Термит_Брокера_2% %IP_Адрес_Термит_Брокера_2%:80 check
       server %Имя_Термит_Брокера_3% %IP_Адрес_Термит_Брокера_3%:80 check
    
    frontend termit_https
       mode tcp
       bind :443
       default_backend termit_servers_https
    
    backend termit_servers_https
       option httpchk
       http-check connect port 8080
       http-check send meth GET  uri /
       mode tcp
       balance source
       hash-type consistent
       server %Имя_Термит_Брокера_1% %IP_Адрес_Термит_Брокера_1%:443 check
       server %Имя_Термит_Брокера_2% %IP_Адрес_Термит_Брокера_2%:443 check
       server %Имя_Термит_Брокера_3% %IP_Адрес_Термит_Брокера_3%:443 check
    
    frontend termit_8443_https
       mode tcp
       bind :8443
       default_backend termit_servers_8443_https
    
    backend termit_servers_8443_https
       option httpchk
       http-check connect port 8080
       http-check send meth GET  uri /
       mode tcp
       balance source
       hash-type consistent
       server %Имя_Термит_Брокера_1% %IP_Адрес_Термит_Брокера_1%:8443 check
       server %Имя_Термит_Брокера_2% %IP_Адрес_Термит_Брокера_2%:8443 check
       server %Имя_Термит_Брокера_3% %IP_Адрес_Термит_Брокера_3%:8443 check
  4. Проверьте файл конфигурации с помощью команды:

    sudo haproxy -f /etc/haproxy/haproxy.cfg -c
  5. Перезапустите службу с помощью команды:

    sudo systemctl restart haproxy

6.4. ALT Linux

  1. Установите ПО HAProxy с помощью команды:

    sudo apt-get install haproxy
  2. Включите службу haproxy и добавьте автозагрузку с помощью команды:

    sudo systemctl enable haproxy --now
  3. Добавьте в конец файла конфигурации /etc/haproxy/haproxy.cfg настройку серверов для балансировки.

    Пример конфигурации

    В примере приведен файл конфигурации с типом балансировки Source IP Hash.

    frontend termit
       mode tcp
       bind :80
       default_backend termit_servers
    
    backend termit_servers
       option httpchk
       http-check connect port 8080
       http-check send meth GET  uri /
       mode tcp
       balance source
       hash-type consistent
       server %Имя_Термит_Брокера_1% %IP_Адрес_Термит_Брокера_1%:80 check
       server %Имя_Термит_Брокера_2% %IP_Адрес_Термит_Брокера_2%:80 check
       server %Имя_Термит_Брокера_3% %IP_Адрес_Термит_Брокера_3%:80 check
    
    frontend termit_https
       mode tcp
       bind :443
       default_backend termit_servers_https
    
    backend termit_servers_https
       option httpchk
       http-check connect port 8080
       http-check send meth GET  uri /
       mode tcp
       balance source
       hash-type consistent
       server %Имя_Термит_Брокера_1% %IP_Адрес_Термит_Брокера_1%:443 check
       server %Имя_Термит_Брокера_2% %IP_Адрес_Термит_Брокера_2%:443 check
       server %Имя_Термит_Брокера_3% %IP_Адрес_Термит_Брокера_3%:443 check
    
    frontend termit_8443_https
       mode tcp
       bind :8443
       default_backend termit_servers_8443_https
    
    backend termit_servers_8443_https
       option httpchk
       http-check connect port 8080
       http-check send meth GET  uri /
       mode tcp
       balance source
       hash-type consistent
       server %Имя_Термит_Брокера_1% %IP_Адрес_Термит_Брокера_1%:8443 check
       server %Имя_Термит_Брокера_2% %IP_Адрес_Термит_Брокера_2%:8443 check
       server %Имя_Термит_Брокера_3% %IP_Адрес_Термит_Брокера_3%:8443 check
  4. Проверьте созданный файл конфигурации с помощью команды ниже. Вывод команды не должен содержать ошибок. Предупреждения (warnings) не являются ошибками.

    sudo haproxy -f /etc/haproxy/haproxy.cfg -c
  5. Перезапустите службу с помощью команды:

    sudo systemctl restart haproxy
  6. Проверьте доступность СТД «Термит» по URL адресу, указанному при установке брокера.

6.5. OpenSUSE

  1. Установите ПО HAProxy с помощью команды:

    sudo zypper install haproxy
  2. Запустите службу haproxy с помощью команды:

    sudo systemctl enable haproxy --now
  3. Проверьте статус службы haproxy с помощью команды:

    sudo systemctl status haproxy

    Статус должен быть «Active».

    s  sql6
  4. Добавьте в конец файла конфигурации /etc/haproxy/haproxy.cfg настройку серверов для балансировки.

    Пример конфигурации

    В примере приведен файл конфигурации с типом балансировки Source IP Hash.

    frontend termit
       mode tcp
       bind :80
       default_backend termit_servers
    
    backend termit_servers
       option httpchk
       http-check connect port 8080
       http-check send meth GET  uri /
       mode tcp
       balance source
       hash-type consistent
       server %Имя_Термит_Брокера_1% %IP_Адрес_Термит_Брокера_1%:80 check
       server %Имя_Термит_Брокера_2% %IP_Адрес_Термит_Брокера_2%:80 check
       server %Имя_Термит_Брокера_3% %IP_Адрес_Термит_Брокера_3%:80 check
    
    frontend termit_https
       mode tcp
       bind :443
       default_backend termit_servers_https
    
    backend termit_servers_https
       option httpchk
       http-check connect port 8080
       http-check send meth GET  uri /
       mode tcp
       balance source
       hash-type consistent
       server %Имя_Термит_Брокера_1% %IP_Адрес_Термит_Брокера_1%:443 check
       server %Имя_Термит_Брокера_2% %IP_Адрес_Термит_Брокера_2%:443 check
       server %Имя_Термит_Брокера_3% %IP_Адрес_Термит_Брокера_3%:443 check
    
    frontend termit_8443_https
       mode tcp
       bind :8443
       default_backend termit_servers_8443_https
    
    backend termit_servers_8443_https
       option httpchk
       http-check connect port 8080
       http-check send meth GET  uri /
       mode tcp
       balance source
       hash-type consistent
       server %Имя_Термит_Брокера_1% %IP_Адрес_Термит_Брокера_1%:8443 check
       server %Имя_Термит_Брокера_2% %IP_Адрес_Термит_Брокера_2%:8443 check
       server %Имя_Термит_Брокера_3% %IP_Адрес_Термит_Брокера_3%:8443 check
  5. Проверьте созданный файл конфигурации с помощью команды ниже. Вывод команды не должен содержать ошибок. Предупреждения (warnings) не являются ошибками.

    sudo haproxy -f /etc/haproxy/haproxy.cfg -c
  6. Перезапустите службу с помощью команды:

    sudo systemctl restart haproxy
  7. Проверьте статус службы с помощью команды:

    sudo systemctl status haproxy

    Статус должен быть «Active».

7. Установка брокера

В этом разделе описано, как установить брокер.

7.1. РЕД ОС

Перед установкой брокера выполните шаги 1-2 по установке Docker, Docker Compose или перейдите к шагу 3 (установочный скрипт выполнит шаги 1-2 в тихом режиме):

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

  1. Чтобы установить Docker, Docker Compose, выполните команду:

    sudo dnf install docker-ce docker-ce-cli docker-compose
  2. Чтобы установленные компоненты добавить в автозагрузку, выполните команду:

    sudo systemctl enable docker --now
  3. Скопируйте дистрибутив на сервер.

  4. Распакуйте архив с помощью команды:

    unzip termit-2.1.*-*.zip
  5. При необходимости выдайте права на запуск скрипта с помощью команды:

    sudo chmod +x ./install.sh
  6. Запустите скрипт:

    sudo ./install.sh install
  7. Введите пароль администратора системы (суперпользователь).

  8. Укажите имя узла брокера. Имя может быть любым.

  9. Появится сообщение:

    «What do you want to do? (1/2)
    1. Install first node of a new cluster
    2. Add a new node to existing cluster
    Enter 1 or 2»

    Укажите «1».

  10. Введите адрес FQDN брокера (инсталляция Standalone) или балансировщика (инсталляция с несколькими брокерами), например «broker.example.com». Портал будет доступен по этому адресу.

  11. Появится сообщение:

    Do you want to connect to an existing database or create a new one? (1/2)
    
    1. Connect to an existing database
    2. Create new database
    
    Enter 1 or 2?
    1. Если вы хотите подключиться к существующей базе данных (БД), то:

      1. Укажите «1».

      2. Укажите имя хоста БД, например «db.example.com».

      3. Укажите порт «5432».

      4. Укажите имя БД, например «example».

      5. Укажите имя пользователя БД, например «termit».

      6. Введите пароль для БД.

    2. Если вы хотите создать новую базу данных (БД), то:

      1. Укажите «2».

      2. Укажите имя хоста БД, например «db.example.com».

      3. Укажите порт «5432».

      4. Укажите имя новой БД.

      5. Укажите имя пользователя БД, например «termit».

      6. Введите пароль для БД.

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

s  key

Для подтверждения успешной операции в браузере, в адресной строке, введите адрес брокера https://broker.example.com. В появившемся окне аутентификации укажите логин «admin» и пароль «admin» от учетной записи по умолчанию.

  • Если брокер установился с ошибкой, то проверьте логи в контейнерах: «config-service» и «broker-client» с помощью команды:

    sudo docker logs %ID_Контейнера%
  • В случае переустановки брокера выполните шаги по деинсталляции.

  • Подробнее о настройках компонентов операционной системы можно прочесть на официальном сайте Astra Linux.

7.2. Astra Linux

Перед установкой брокера выполните шаги 1-2 по установке Docker, Docker Compose или перейдите к шагу 3 (установочный скрипт выполнит шаги 1-2 в тихом режиме):

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

  1. Чтобы установить Docker, Docker Compose, выполните команду:

    sudo apt install docker.io docker-compose
  2. Чтобы запустить сервис, выполните команду:

    sudo systemctl start docker
  3. Скопируйте дистрибутив на сервер.

  4. Распакуйте архив с помощью команды:

    unzip termit-2.1.*-*.zip
  5. При необходимости выдайте права на запуск скрипта с помощью команды:

    sudo chmod +x ./install.sh
  6. Запустите скрипт:

    sudo ./install.sh install
  7. Введите пароль администратора системы (суперпользователь).

  8. Укажите имя узла брокера. Имя может быть любым.

  9. Появится сообщение:

    «What do you want to do? (1/2)
    1. Install first node of a new cluster
    2. Add a new node to existing cluster
    Enter 1 or 2»

    Укажите «1».

  10. Введите адрес FQDN брокера (инсталляция Standalone) или балансировщика (инсталляция с несколькими брокерами), например «broker.example.com». Портал будет доступен по этому адресу.

  11. Появится сообщение:

    Do you want to connect to an existing database or create a new one? (1/2)
    
    1. Connect to an existing database
    2. Create new database
    
    Enter 1 or 2?
    1. Если вы хотите подключиться к существующей базе данных (БД), то:

      1. Укажите «1».

      2. Укажите имя хоста БД, например «db.example.com».

      3. Укажите порт «5432».

      4. Укажите имя БД, например «example».

      5. Укажите имя пользователя БД, например «termit».

      6. Введите пароль для БД.

    2. Если вы хотите создать новую базу данных (БД), то:

      1. Укажите «2».

      2. Укажите имя хоста БД, например «db.example.com».

      3. Укажите порт «5432».

      4. Укажите имя новой БД.

      5. Укажите имя пользователя БД, например «termit».

      6. Введите пароль для БД.

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

s  key

Для подтверждения успешной операции в браузере, в адресной строке, введите адрес брокера https://broker.example.com. В появившемся окне аутентификации укажите логин «admin» и пароль «admin» от учетной записи по умолчанию.

  • Если брокер установился с ошибкой, то проверьте логи в контейнерах: «config-service» и «broker-client» с помощью команды:

    sudo docker logs %ID_Контейнера%
  • В случае переустановки брокера выполните шаги по деинсталляции.

  • Подробнее о настройках компонентов операционной системы можно прочесть на официальном сайте Astra Linux.

7.3. Debian

  1. Установите Docker с помощью команды:

    sudo apt install docker.io docker-compose
  2. Добавьте в автозагрузку с помощью команды:

    sudo systemctl enable docker --now
  3. Распакуйте архив с помощью команды:

    unzip termit-2.1.*-*.zip
  4. Запустите установку с помощью команды:

    sudo ./install.sh install
  5. Введите пароль администратора системы (суперпользователь).

  6. Укажите имя узла брокера. Имя может быть любым.

  7. Появится сообщение:

    «What do you want to do? (1/2)
    1. Install first node of a new cluster
    2. Add a new node to existing cluster
    Enter 1 or 2»

    Укажите «1».

  8. Введите адрес FQDN брокера (инсталляция Standalone) или балансировщика (инсталляция с несколькими брокерами), например «broker.example.com». Портал будет доступен по этому адресу.

  9. Появится сообщение:

    Do you want to connect to an existing database or create a new one? (1/2)
    
    1. Connect to an existing database
    2. Create new database
    
    Enter 1 or 2?
    1. Если вы хотите подключиться к существующей базе данных (БД), то:

      1. Укажите «1».

      2. Укажите имя хоста БД, например «db.example.com».

      3. Укажите порт «5432».

      4. Укажите имя БД, например «example».

      5. Укажите имя пользователя БД, например «termit».

      6. Введите пароль для БД.

    2. Если вы хотите создать новую базу данных (БД), то:

      1. Укажите «2».

      2. Укажите имя хоста БД, например «db.example.com».

      3. Укажите порт «5432».

      4. Укажите имя новой БД.

      5. Укажите имя пользователя БД, например «termit».

      6. Введите пароль для БД.

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

s  key

Для подтверждения успешной операции в браузере, в адресной строке, введите адрес брокера https://broker.example.com. В появившемся окне аутентификации укажите логин «admin» и пароль «admin» от учетной записи по умолчанию.

7.4. ALT Linux

Чтобы установить брокер:

  1. Установите компоненты Docker с помощью команды:

    sudo apt-get install docker-ce docker-compose
    s  broker
  2. Запустите и добавьте службу docker в автозагрузку с помощью команды:

    sudo systemctl enable docker --now
  3. Распакуйте архив Термит с помощью команды:

    unzip ./termit-2.1*.*-*.zip
  4. Установите Термит командой ниже из директории с дистрибутивом:

    sudo ./install.sh install
  5. Введите пароль администратора системы (суперпользователь).

  6. Укажите имя узла брокера. Имя может быть любым.

  7. Появится сообщение:

    «What do you want to do? (1/2)
    1. Install first node of a new cluster
    2. Add a new node to existing cluster
    Enter 1 or 2»

    Укажите «1».

  8. Введите адрес FQDN брокера (инсталляция Standalone) или балансировщика (инсталляция с несколькими брокерами), например «broker.example.com». Портал будет доступен по этому адресу.

  9. Появится сообщение:

    Do you want to connect to an existing database or create a new one? (1/2)
    
    1. Connect to an existing database
    2. Create new database
    
    Enter 1 or 2?
    1. Если вы хотите подключиться к существующей базе данных (БД), то:

      1. Укажите «1».

      2. Укажите имя хоста БД, например «db.example.com».

      3. Укажите порт «5432».

      4. Укажите имя БД, например «example».

      5. Укажите имя пользователя БД, например «termit».

      6. Введите пароль для БД.

    2. Если вы хотите создать новую базу данных (БД), то:

      1. Укажите «2».

      2. Укажите имя хоста БД, например «db.example.com».

      3. Укажите порт «5432».

      4. Укажите имя новой БД.

      5. Укажите имя пользователя БД, например «termit».

      6. Введите пароль для БД.

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

s  key

Для подтверждения успешной операции в браузере, в адресной строке, введите адрес брокера https://broker.example.com. В появившемся окне аутентификации укажите логин «admin» и пароль «admin» от учетной записи по умолчанию.

  • Если брокер установился с ошибкой, то проверьте логи в контейнерах: «config-service» и «broker-client» с помощью команды:

    sudo docker logs %ID_Контейнера%
  • В случае переустановки брокера выполните шаги по деинсталляции.

  • Подробнее о настройках компонентов операционной системы можно прочесть на официальном сайте Astra Linux.

7.5. OpenSUSE

  1. Установите компоненты Docker с помощью команды:

    sudo zypper install docker docker-compose docker-compose-switch
  2. Запустите службу с помощью команды:

    sudo systemctl enable docker --now
  3. Скопируйте дистрибутив на сервер.

  4. Распакуйте архив Термит с помощью команды:

    unzip ./termit-2.1*.*-*.zip
  5. При необходимости выдайте права на запуск скрипта с помощью команды:

    sudo chmod +x ./install.sh
  6. Запустите скрипт:

    sudo ./install.sh install
  7. Введите пароль администратора системы (суперпользователь).

  8. Укажите имя узла брокера. Имя может быть любым.

  9. Появится сообщение:

    «What do you want to do? (1/2)
    1. Install first node of a new cluster
    2. Add a new node to existing cluster
    Enter 1 or 2»

    Укажите «1».

  10. Введите адрес FQDN брокера (инсталляция Standalone) или балансировщика (инсталляция с несколькими брокерами), например «broker.example.com». Портал будет доступен по этому адресу.

  11. Появится сообщение:

    Do you want to connect to an existing database or create a new one? (1/2)
    
    1. Connect to an existing database
    2. Create new database
    
    Enter 1 or 2?
    1. Если вы хотите подключиться к существующей базе данных (БД), то:

      1. Укажите «1».

      2. Укажите имя хоста БД, например «db.example.com».

      3. Укажите порт «5432».

      4. Укажите имя БД, например «example».

      5. Укажите имя пользователя БД, например «termit».

      6. Введите пароль для БД.

    2. Если вы хотите создать новую базу данных (БД), то:

      1. Укажите «2».

      2. Укажите имя хоста БД, например «db.example.com».

      3. Укажите порт «5432».

      4. Укажите имя новой БД.

      5. Укажите имя пользователя БД, например «termit».

      6. Введите пароль для БД.

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

s  key

Для подтверждения успешной операции в браузере, в адресной строке, введите адрес брокера https://broker.example.com. В появившемся окне аутентификации укажите логин «admin» и пароль «admin» от учетной записи по умолчанию.

  • Если брокер установился с ошибкой, то проверьте логи в контейнерах: «config-service» и «broker-client» с помощью команды:

    sudo docker logs %ID_Контейнера%
  • В случае переустановки брокера выполните шаги по деинсталляции.

  • Подробнее о настройках компонентов операционной системы можно прочесть на официальном сайте Astra Linux.

8. Установка дополнительного брокера

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

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

8.1. РЕД ОС

Перед установкой дополнительного брокера выполните шаги 1-2 по установке Docker, Docker Compose или перейдите к шагу 3 (установочный скрипт выполнит шаги 1-2 в тихом режиме):

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

  1. Чтобы установить Docker, Docker Compose, выполните команду:

    sudo dnf install docker-ce docker-ce-cli docker-compose
  2. Чтобы установленные компоненты добавить в автозагрузку, выполните команду:

    sudo systemctl enable docker --now
  3. При необходимости выдайте права на запуск скрипта с помощью команды:

    sudo chmod +x ./install.sh
  4. Запустите скрипт:

    sudo ./install.sh install
  5. Введите пароль администратора системы.

  6. Укажите имя узла брокера. Имя может быть любым.

  7. Появится сообщение:

    «What do you want to do? (1/2)
    1. Install first node of new cluster
    2. Add new node to existing cluster
    Enter 1 or 2»

    Укажите «2».

  8. Укажите имя хоста базы данных (БД), например «db.example.com».

  9. Укажите порт «5432».

  10. Укажите имя БД, например «example».

  11. Укажите имя пользователя БД, например «termit».

  12. Введите пароль для БД.

  13. Вставьте скопированный ключ шифрования.

  14. Введите адрес, выбранный на шаге 7, и проверьте статус брокера в меню после аутентификации.

Установка брокера занимает около двух минут. Для подтверждения успешной операции перейдите на портал администрирования и проверьте, что в разделе Брокеры брокер появился в списке со статусом «Работает».

8.2. Astra Linux

Перед установкой дополнительного брокера выполните шаги 1-2 по установке Docker, Docker Compose или перейдите к шагу 3 (установочный скрипт выполнит шаги 1-2 в тихом режиме):

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

  1. Чтобы установить Docker, Docker Compose, выполните команду:

    sudo apt install docker.io docker-compose
  2. Чтобы запустить сервис, выполните команду:

    sudo systemctl start docker
  3. При необходимости выдайте права на запуск скрипта с помощью команды:

    sudo chmod +x ./install.sh
  4. Запустите скрипт:

    sudo ./install.sh install
  5. Введите пароль администратора системы.

  6. Укажите имя узла брокера. Имя может быть любым.

  7. Появится сообщение:

    «What do you want to do? (1/2)
    1. Install first node of new cluster
    2. Add new node to existing cluster
    Enter 1 or 2»

    Укажите «2».

  8. Укажите имя хоста базы данных (БД), например «db.example.com».

  9. Укажите порт «5432».

  10. Укажите имя БД, например «example».

  11. Укажите имя пользователя БД, например «termit».

  12. Введите пароль для БД.

  13. Вставьте скопированный ключ шифрования.

  14. Введите адрес, выбранный на шаге 7, и проверьте статус брокера в меню после аутентификации.

Установка брокера занимает около двух минут. Для подтверждения успешной операции перейдите на портал администрирования и проверьте, что в разделе Брокеры брокер появился в списке со статусом «Работает».

8.3. Debian

  1. Установите Docker с помощью команды:

    sudo apt install docker.io docker-compose
  2. Добавьте в автозагрузку с помощью команды:

    sudo systemctl enable docker --now
  3. При необходимости выдайте права на запуск скрипта с помощью команды:

    sudo chmod +x ./install.sh
  4. Запустите скрипт:

    sudo ./install.sh install
  5. Введите пароль администратора системы.

  6. Укажите имя узла брокера. Имя может быть любым.

  7. Появится сообщение:

    «What do you want to do? (1/2)
    1. Install first node of new cluster
    2. Add new node to existing cluster
    Enter 1 or 2»

    Укажите «2».

  8. Укажите имя хоста базы данных (БД), например «db.example.com».

  9. Укажите порт «5432».

  10. Укажите имя БД, например «example».

  11. Укажите имя пользователя БД, например «termit».

  12. Введите пароль для БД.

  13. Вставьте скопированный ключ шифрования.

  14. Введите адрес, выбранный на шаге 7, и проверьте статус брокера в меню после аутентификации.

Установка брокера занимает около двух минут. Для подтверждения успешной операции перейдите на портал администрирования и проверьте, что в разделе Брокеры брокер появился в списке со статусом «Работает».

8.4. ALT Linux

  1. Установите компоненты Docker с помощью команды:

    sudo apt-get install docker-ce docker-compose
  2. Запустите и добавьте службу docker в автозагрузку с помощью команды:

    sudo systemctl enable docker --now
  3. При необходимости выдайте права на запуск скрипта с помощью команды:

    sudo chmod +x ./install.sh
  4. Запустите скрипт:

    sudo ./install.sh install
  5. Введите пароль администратора системы.

  6. Укажите имя узла брокера. Имя может быть любым.

  7. Появится сообщение:

    «What do you want to do? (1/2)
    1. Install first node of new cluster
    2. Add new node to existing cluster
    Enter 1 or 2»

    Укажите «2».

  8. Укажите имя хоста базы данных (БД), например «db.example.com».

  9. Укажите порт «5432».

  10. Укажите имя БД, например «example».

  11. Укажите имя пользователя БД, например «termit».

  12. Введите пароль для БД.

  13. Вставьте скопированный ключ шифрования.

  14. Введите адрес, выбранный на шаге 7, и проверьте статус брокера в меню после аутентификации.

Установка брокера занимает около двух минут. Для подтверждения успешной операции перейдите на портал администрирования и проверьте, что в разделе Брокеры брокер появился в списке со статусом «Работает».

8.5. OpenSUSE

  1. Установите компоненты Docker с помощью команды:

    sudo zypper install docker docker-compose docker-compose-switch
  2. Запустите службу с помощью команды:

    sudo systemctl enable docker --now
  3. При необходимости выдайте права на запуск скрипта с помощью команды:

    sudo chmod +x ./install.sh
  4. Запустите скрипт:

    sudo ./install.sh install
  5. Введите пароль администратора системы.

  6. Укажите имя узла брокера. Имя может быть любым.

  7. Появится сообщение:

    «What do you want to do? (1/2)
    1. Install first node of new cluster
    2. Add new node to existing cluster
    Enter 1 or 2»

    Укажите «2».

  8. Укажите имя хоста базы данных (БД), например «db.example.com».

  9. Укажите порт «5432».

  10. Укажите имя БД, например «example».

  11. Укажите имя пользователя БД, например «termit».

  12. Введите пароль для БД.

  13. Вставьте скопированный ключ шифрования.

  14. Введите адрес, выбранный на шаге 7, и проверьте статус брокера в меню после аутентификации.

Установка брокера занимает около двух минут. Для подтверждения успешной операции перейдите на портал администрирования и проверьте, что в разделе Брокеры брокер появился в списке со статусом «Работает».

9. Установка ПО на терминальный сервер

Перед установкой агента на терминальный сервер необходимо установить ПО на терминальный сервер.

9.1. РЕД ОС

  1. В файле конфигурации sshd (/etc/ssh/sshd_config), в параметре X11Forwarding, укажите значение «yes».

  2. Чтобы установить Java 11 на терминальный сервер, выполните команду:

    sudo dnf install java-11-openjdk
  3. Чтобы изменить версию Java, используемую по умолчанию, выполните команду:

    sudo alternatives --config java

    И выберите пункт меню, соответствующий Java 11.

  4. Чтобы установить X2Go server на терминальный сервер, выполните команду:

    sudo dnf install x2goserver-xsession x2goserver-fmbindings x2goserver-common x2goserver x2goagent -y
  5. Установите агент, используя скрипт, полученный при создании сервера.

9.2. Astra Linux

  1. В файле конфигурации sshd (/etc/ssh/sshd_config), в параметре X11Forwarding, укажите значение «yes».

  2. В файле конфигурации /etc/systemd/logind.conf, в параметре KillUserProcesses задайте значение no для корректной работы переподключения сессии и перезагрузите терминальный сервер.

    s  kill user
  3. Установите компоненты OpenJDK с помощью команды:

    sudo apt install openjdk-11-jdk

    Подробнее об установке OpenJDK можно прочесть на официальном сайте Astra Linux.

  4. В случае если ранее были установлены другие версии OpenJDK, выполните дополнительную конфигурацию, выбрав установленную 11 версию с помощью команды:

    sudo update-alternatives --config java
  5. Установите компоненты X2Go сервера с помощью команды:

    sudo apt install x2goserver-xsession x2goserver-fmbindings x2goserver-common x2goserver-x2goagent
  6. Установите агент, используя скрипт, полученный при создании сервера.

  7. Установите пакет xprintidle из репозитория Debian:

    1. Чтобы добавить репозиторий Debian 10 (замените «buster» на кодовое имя версии Debian, которую вы хотите использовать) и автоматического создания файла debian.list, выполните команду:

      echo "deb http://deb.debian.org/debian buster main" | sudo tee -a /etc/apt/sources.list.d/debian.list

      Эта команда создаст файл debian.list в директории /etc/apt/sources.list.d/, если ранее он не был создан, и добавит указанную строку в файл.

  8. Чтобы добавить отсутствующие GPG-ключи для репозиториев Debian, выполните команду:

    sudo apt-key adv --keyserver keyserver.ubuntu.com --recv-keys 648ACFD622F3D138 0E98404D386FA1D9 DCC9EFBF77E11517
  9. Обновите список пакетов с помощью команды:

    sudo apt update
  10. Установите xprintidle с помощью apt:

    sudo apt install xprintidle

    При возникновении затруднений с зависимостями попробуйте разрешить их вручную.

  11. При необходимости удалите репозиторий Debian. Это поможет избежать конфликтов в будущем:

    sudo rm /etc/apt/sources.list.d/debian.list
    sudo apt update

9.3. Debian

  1. В файле конфигурации sshd (/etc/ssh/sshd_config), в параметре X11Forwarding, укажите значение «yes».

  2. Установите компоненты OpenJDK с помощью команды:

    sudo apt install openjdk-17-jdk
  3. В случае если ранее были установлены другие версии OpenJDK, выполните дополнительную конфигурацию, выбрав установленную 17 версию с помощью команды:

    sudo update-alternatives --config java
  4. Установите компоненты X2Go сервера с помощью команды:

    sudo apt install x2goserver-xsession x2goserver-fmbindings x2goserver-common x2goserver-x2goagent
  5. Установите агент, используя скрипт, полученный при создании сервера.

  6. Установите пакет xprintidle из репозитория Debian:

    1. Чтобы добавить репозиторий Debian 10 (замените «buster» на кодовое имя версии Debian, которую вы хотите использовать) и автоматического создания файла debian.list, выполните команду:

      echo "deb http://deb.debian.org/debian buster main" | sudo tee -a /etc/apt/sources.list.d/debian.list

      Эта команда создаст файл debian.list в директории /etc/apt/sources.list.d/, если ранее он не был создан, и добавит указанную строку в файл.

  7. Чтобы добавить отсутствующие GPG-ключи для репозиториев Debian, выполните команду:

    sudo apt-key adv --keyserver keyserver.ubuntu.com --recv-keys 648ACFD622F3D138 0E98404D386FA1D9 DCC9EFBF77E11517
  8. Обновите список пакетов с помощью команды:

    sudo apt update
  9. Установите xprintidle с помощью apt:

    sudo apt install xprintidle

    При возникновении затруднений с зависимостями попробуйте разрешить их вручную.

  10. При необходимости удалите репозиторий Debian. Это поможет избежать конфликтов в будущем:

    sudo rm /etc/apt/sources.list.d/debian.list
    sudo apt update

9.4. ALT Linux

  1. В файле конфигурации sshd (/etc/openssh/sshd_config), в параметре X11Forwarding, укажите значение «yes».

  2. В файле конфигурации /etc/systemd/logind.conf, в параметре KillUserProcesses задайте значение no для корректной работы переподключения сессии и перезагрузите терминальный сервер.

  3. Установите компоненты Java с помощью команды:

    sudo apt-get install java-11-openjdk
  4. Установите компоненты X2Go сервера с помощью команды:

    sudo apt-get install x2goserver-xsession x2goserver-fmbindings x2goserver-x2goagent
  5. Добавьте X2Go в автозапуск с помощью команды:

    sudo systemctl enable x2goserver --now
  6. Установите пакет xprintidle с помощью команды:

    sudo apt-get install xprintidle
  7. Установите агент, используя скрипт, полученный при создании сервера.

9.5. Windows

Ниже описано, как добавить роль, изменить политики, установить OpenJDK 11 и агент на терминальный сервер.

Для Windows Server 2012R2 и Windows Server 2016 (редакции ниже 1803) необходимо:

  1. Установить утилиту curl.

  2. Установочные файлы из архива curl, из каталога bin, разместить в системной директории C:\Windows\system32.

  1. Активируйте роль «Remote Desktop Session Host» («Узел сеансов удаленных рабочих столов»):

    1. Откройте Диспетчер серверов  Панель мониторинга.

    2. В правом верхнем углу нажмите Управление.

    3. Выберите Добавить роли и компоненты.

    4. Нажмите Далее.

    5. На вкладке Тип установки оставьте по умолчанию опцию Установка ролей и компонентов.

    6. Нажмите Далее.

    7. На вкладке Выбор сервера оставьте по умолчанию Выберите сервер из пула серверов.

    8. Нажмите Далее.

    9. На вкладке Роли сервера активируйте опцию Службы удаленных рабочих столов.

    10. Нажмите Далее  Далее  Далее.

    11. На вкладке Службы ролей активируйте опцию Remote Desktop Session Host (Узел сеансов удаленных рабочих столов) и нажмите Добавить компоненты.

    12. Нажмите Далее  Установить.

      После установки и добавления роли перезагрузите ВМ.

  2. Включите политику «Разрешить удаленный запуск любых программ» и выключите политику «Ограничить пользователей служб удаленных рабочих столов одним сеансов служб удаленных рабочих столов»:

    1. Откройте консоль MMC.

    2. В левом верхнем углу нажмите Файл и выберите Добавить или удалить оснастку.

      s  politics2
    3. В доступных оснастках выберите Редактор объектов групповой политики.

    4. В параметре Объект групповой политики оставьте по умолчанию Локальный компьютер.

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

    5. Нажмите Готово  ОК.

    6. Раскройте Политика «Локальный компьютер».

    7. Раскройте Конфигурация компьютера  Административные шаблоны  Компоненты Windows.

      s  politics3
    8. Выберите Службы удаленных рабочих столов  Узел сеансов удаленных рабочих столов  Подключения.

      s  politics1
    9. Нажмите два раза левой кнопкой мыши на политику «Разрешить удаленный запуск любых программ».

    10. Активируйте опцию Включено и нажмите ОК.

    11. Нажмите два раза левой кнопкой мыши на политику «Ограничить пользователей служб удаленных рабочих столов одним сеансов служб удаленных рабочих столов».

    12. Активируйте опцию Отключено и нажмите ОК.

    13. Откройте cmd.exe и примените политики с помощью команды gpupdate /force или перезагрузите сервер.

      После успешной операции в выводе команды появится сообщение «Computer Policy update has completed successfully».

  3. Настройте разрешение на подключение пользователей по RDP:

    1. Удобным способом откройте Управление компьютером.

    2. Выберите Локальные пользователи и группы.

      s  comp
    3. Выберите Группы  Пользователи удаленного рабочего стола.

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

    5. Нажмите Добавить.

    6. В поле Введите имена выбираемых объектов (примеры): введите Пользователи домена.

    7. Нажмите ОК  ОК.

  4. Загрузите OpenJDK 11 и выполните шаги по установке. На шаге Custom Setup включите установку переменной окружения JAVA_HOME:

    s  openjdk
  5. Установите агент, используя скрипт, полученный при создании сервера.

10. Установка шлюза удаленного доступа

В этом разделе описано, как установить шлюз удаленного доступа для аутентификации по LDAP.

  1. Установите компонент openssh-server:

    РЕД ОС
    sudo dnf install openssh-server
    Astra Linux
    sudo apt install openssh-server
    Debian
    sudo apt install openssh-server
    OpenSUSE
    sudo zypper install openssh-server
    ALT Linux
    sudo apt-get install openssh-server
  2. Настройте шлюз удаленного доступа через ввод в домен. Подробнее о вводе в домен смотрите в статье на сайтах:

11. Установка клиента

Чтобы установить клиент:

  1. В браузере, в адресной строке введите адрес, по которому доступна СТД «Термит», например https://broker.example.com.

  2. Введите имя пользователя и пароль.

    Пользователь входит под доменной учетной записью. Атрибут для имени пользователя — samAccountName.

Windows
  1. В левом меню выберите раздел Скачать клиент.

  2. Скачайте Термит клиент для Windows 7/8.1 или Термит клиент для Windows 10/11 и установите его.

Также можно установить клиент в «тихом» режиме. Информация о ходе выполнения отображаться не будет. Для установки в таком режиме добавьте параметр /S: «C:%путь до exe файла%\termit-desktop-2.1.*.exe» /S.

MacOS
  1. Скачайте Термит клиент для Mac OS и выполните шаги по установке.

  2. Скачайте Клиент X2Go для Mac OS, соответствующий вашей ОС, и выполните шаги по установке.

  3. Скачайте XQuartz и выполните шаги по установке.

  4. Скачайте и установите приложение Microsoft Remote Desktop из App Store или с сайта macadmins.software, нажав на значок напротив «Remote Desktop Standalone Installer».

    При подключении к сессии на терминальном сервере Windows будет открыто приложение Microsoft Remote Desktop и окно для ввода пароля. После ввода пароля запустится сессия. Во время сессии завершать работу приложения Microsoft Remote Desktop нельзя, так как это приведет к отключению от сессии.

Перед запуском клиента в настройках необходимо разрешить использование СТД «Термит». Для этого выберите в меню Apple  Системные настройки, затем в боковом меню нажмите Конфиденциальность и безопасность, прокрутите вниз до параметра Разрешить использование приложений, загруженных из: и выберите App Store и от подтвержденных разработчиков.
Linux
Astra Linux
  1. Скачайте Термит клиент для Linux deb.

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

    1. Измените параметры файла sources с помощью команды:

      sudo mcedit /etc/apt/sources.list
    2. Укажите пароль.

    3. Измените параметры файла sources и сохраните.

      В большинстве дистрибутивов Astra Linux исходный файл sources.list содержит только репозиторий на CD/DVD для установки с диска. Для использования дополнительных репозиториев Astra Linux добавьте ресурсы с официального сайта Astra Linux в файл sources.list.
      s  freerdp
    4. Обновите репозиторий с помощью команды:

      sudo apt update
    5. Установите FreeRDP:

      sudo apt install freerdp2-x11
    6. Установите клиент Термит:

      sudo apt install ./termit-desktop-2.1.*-amd64.deb

      Где:

      ./termit-desktop-2.1.*-amd64.deb — название файла.

РЕД ОС
  1. Скачайте Термит клиент для Linux rpm и выполните шаги по установке.

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

    1. Обновите репозиторий с помощью команды:

      sudo dnf update
    2. Установите FreeRDP:

      sudo dnf install freerdp-krb
    3. Установите клиент Термит:

      sudo dnf install ./termit-desktop-2.1.*-amd64.rpm

      Где:

      ./termit-desktop-2.1.*-amd64.rpm — название файла.

ALT Linux
  1. Скачайте Термит клиент для Linux rpm.

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

    1. Обновите репозиторий с помощью команды:

      sudo apt-get update
    2. Установите FreeRDP:

      sudo apt-get install freerdp
    3. Установите клиент Термит:

      sudo apt-get install ./termit-desktop-2.1.*-amd64.rpm
    4. Для корректного запуска клиента Термит установите бит setuid:

      sudo chmod 4755 /opt/Термит/chrome-sandbox

12. Установка сертификата на клиент

Для успешного подключения к СТД «Термит» необходимо, чтобы используемый SSL-сертификат был добавлен в список доверенных на клиенте.

12.1. РЕД ОС

  1. Скопируйте файл корневого сертификата в каталог /etc/pki/ca-trust/source/anchors/ с помощью команды:

    sudo cp %Путь_к_сертификату% /etc/pki/ca-trust/source/anchors/

    Где: %Путь_к_сертификату% — полный путь к файлу сертификата в формате PEM.

  2. Чтобы применить изменения, выполните команды:

    sudo update-ca-trust force-enable
    sudo update-ca-trust extract
  3. Перезапустите браузер и проверьте доверие сертификату, открыв адрес брокера Термит.

12.2. Astra Linux

Сертификат должен быть в формате CRT.

Если формат сертификата отличается, необходимо выполнить его конвертацию используя утилиту openssl, например:

  • Если сертификат имеет кодировку DER:

    openssl x509 -inform DER -in %Исходный_Сертификат% -out %Конечный_Сертификат%
  • Если исходный сертификат имеет кодировку PEM:

    openssl x509 -inform PEM -in %Исходный_Сертификат% -out %Конечный_Сертификат%

    Где:

    • %Исходный_Сертификат% — путь к исходному сертификату «certificate.cer».

    • %Конечный_Сертификат% — путь к конечному сертификату, например «certificate.crt».

      1. Скопируйте полученные выше сертификаты в каталог /usr/local/share/ca-certificates с помощью команды:

        sudo cp %Путь_к_сертификату% /usr/local/share/ca-certificates

        Где: %Путь_к_сертификату% — полный путь к файлу сертификата.

      2. Чтобы применить изменения, выполните команду:

        sudo update-ca-certificates
      3. Перезапустите браузер и проверьте доверие сертификату, открыв адрес брокера Термит.

Для систем Linux иногда необходима дополнительная ручная конфигурация хранилищ браузеров Firefox и Chrome\Chromium:

Chrome\Chromium
  1. Перейдите в меню Настройки  Конфиденциальность и безопасность  Безопасность  Настроить сертификаты и перейдите на вкладку Центры сертификации.

  2. Добавьте необходимый сертификат или цепочку сертификатов с помощью кнопки Импорт.

  3. Укажите необходимый уровень доверия.

Firefox
  1. Перейдите в Настройки  Приватность и защита  Защита  Сертификаты  Просмотр сертификатов.

  2. Добавьте необходимый сертификат или цепочку сертификатов с помощью кнопки Импорт.

  3. Укажите необходимый уровень доверия.

12.3. ALT Linux

Подробнее об установке сертификата можно прочесть на официальном сайте

  1. Скопируйте корневой сертификат в хранилище сертификатов с помощью команды ниже. Сертификат должен быть в формате .CRT.

    sudo cp %путь_к_сертификату% /etc/pki/ca-trust/source/anchors/
  2. Обновите сертификаты с помощью команды:

    sudo update-ca-trust

12.4. Windows

  1. Запустите сертификат двойным нажатием на него и выберите опцию Установить сертификат.

  2. Выберите опцию Текущий пользователь:

    При работе с правами администратора установка возможна в хранилище сертификатов компьютера (для всех пользователей).

  3. Выберите опцию Поместить все сертификаты в следующие хранилище, нажмите Обзор и выберите Доверенные корневые центры сертификации.

    При наличии промежуточного центра сертификации повторите шаги выше, выбрав хранилище Промежуточные центры сертификации на шаге 3.

  4. Перезапустите браузер и проверьте доверие сертификату, открыв адрес брокера Термит.

12.5. MacOS

  1. Запустите сертификат двойным нажатием на него, сертификат будет добавлен в приложение Связка ключей.

  2. Найдите в приложении добавленный сертификат или цепочку сертификатов.

  3. Укажите необходимый уровень доверия.

13. Деинсталляция компонентов

Деинсталляция компонентов СТД «Термит» включает в себя удаление:

  • брокера;

  • агента;

  • клиента.

При необходимости удалите XQuartz и X2Go клиенты на MacOS.

13.1. Удаление брокера

Чтобы удалить брокер терминального сервера:

  1. Перейдите в каталог, куда был распакован дистрибутив.

  2. Запустите скрипт с параметром uninstall:

    sudo ./install.sh uninstall

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

13.2. Удаление агента

13.2.1. Linux

Чтобы удалить агент:

  1. Перейдите в каталог, где был запущен скрипт установки агента.

  2. Удалите с помощью команды:

    sudo ./agent-installer linux-uninstall

13.2.2. Windows

Чтобы удалить агент Termit:

Эта операция может быть выполнена только с правами администратора.

  1. Перейдите в каталог, куда был установлен агент Termit по умолчанию — C://Program Files/TermitAgent.

  2. Удалите с помощью команды:

    .\agent-installer.exe windows-uninstall

13.3. Удаление клиента

13.3.1. РЕД ОС

Чтобы удалить клиент, введите команду:

sudo dnf remove termit-desktop

13.3.2. Astra Linux

Чтобы удалить клиент, введите команду:

sudo apt remove termit-desktop

13.3.3. ALT Linux

Чтобы удалить клиент, введите команду:

sudo apt-get remove termit-desktop

13.3.4. MacOS

Чтобы удалить клиент:

  1. Откройте Finder.

  2. В боковом меню Finder нажмите Программы.

  3. Удалите клиент.

13.3.5. Windows

Чтобы удалить клиент:

  1. Введите Панель управления в поле поиска на панели задач, а затем в списке результатов выберите Панель управления.

  2. Перейдите в Программы  Программы и компоненты.

  3. Удалите клиент.

Также можно удалить клиент в «тихом» режиме. Информация о ходе выполнения отображаться не будет. Для удаления в таком режиме добавьте параметр /S: «C:\Program Files\termit-desktop\Uninstall Термит.exe» /S.