Конфигурация экземпляра, компонентов ПО и служб. Настройка

Введение

Здесь представлены инструкции по настройке файлов конфигурации после развёртывания и обновления ПО Comindware Platform, его компонентов и служб.

Управление системными службами

В Comindware Platform 5.0 системные службы настраиваются с помощью файла конфигурации экземпляра ПО.

Важно!

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

Обновление конфигурации системных служб с версии 4.7

Инструкции по обновлению конфигурации с версий 4.7.x на версию 5.0 см. в статье «Обновление версии экземпляра ПО с его остановкой».

Ниже перечислены системные службы и соответствующие параметры конфигурации. См. Пример файла конфигурации экземпляра ПО.

Системная служба	Назначение	Параметр, значение по умолчанию
Резервное копирование	Управление созданием резервных копий экземпляра ПО	`backup.enabled` `backup.sessionsEnabled: true` `backup.schedulesEnabled: true`
Получение эл. почты	Получение новых электронных писем	`email.listenerEnabled: true`
Отправка эл. почты	Отправка электронных писем	`email.senderEnabled: true`
Полнотекстовый поиск	Индексирование значений атрибутов и обновление поисковых индексов	`search.enabled: true` `search.rebuildingEnabled: true` `search.indexingEnabled: true`
Уведомления	Формирование и отправка системных уведомлений	`notifications.enabled: true` `notifications.onUserTaskEnabled: true` `notifications.pushEnabled: true` `notifications.onMaintenanceEnabled: true`
Бизнес-процессы	Выполнение бизнес-процессов; обработка таймеров (включая запуск по расписанию и таймерам резервного копирования, интеграция, процессов, синхронизации с сервером каталогов)	`bpms.enabled: true` `bpms.timersEnabled: true`
Синхронизация с OData	Синхронизация данных с внешними системами по протоколу OData	`sync.oData.enabled: true` `sync.oData.sessionsEnabled` `sync.oData.schedulesEnabled: true`
Синхронизация с LDAP	Синхронизация пользователей и групп с LDAP-сервером	`sync.ldap.enabled: true` `sync.ldap.sessionsEnabled: true` `sync.ldap.schedulesEnabled: true`
Монитор производительности	Сбор показателей производительности системы	`sensors.enabled: true`
Трассировка производительности	Сбор данных трассировки для анализа производительности	`tracing.enabled: true`

Конфигурация экземпляра ПО Comindware Platform

Откройте файл конфигурации экземпляра ПО (<instanceName> — имя экземпляра ПО) для редактирования:
nano /usr/share/comindware/configs/instance/<instanceName>.yml
При необходимости измените параметры, например:
- journal.server — адрес сервера OpenSearch (Elasticsearch).
- journal.name — префикс индекса сервера OpenSearch (Elasticsearch) (необязательно, по умолчанию назначается префикс cmw<instanceName>).
- journal.username — имя пользователя сервера OpenSearch (Elasticsearch) (необязательно).
- journal.password — пароль сервера OpenSearch (Elasticsearch) (необязательно).
- db.workDir — директория для хранения базы данных экземпляра ПО.
- db.name — префикс кэшей в базе данных экземпляра ПО.
- userStorage.localDisk.path — директория для хранения загруженных файлов.
- mq.server — адрес и порт брокера сообщений Apache Kafka.
- mq.group — идентификатор группы очереди сообщений.
- mq.name — префикс имени очередей сообщений.
- mq.node — идентификатор узла очереди сообщений.
- backup.defaultFolder — директория для хранения резервных копий экземпляра ПО.
- backup.defaultFileName — имя файла резервной копии экземпляра ПО.
Внимание!

Директивы isFederationAuthEnabled и manageAdapterHost требуется удалить, если они присутствуют.

Значения параметров mq.server (адрес и порт брокера сообщений), mq.group (идентификатор группы очереди сообщений), mq.node (идентификатор узла очереди сообщений,) и cluster.name / clusterName (имя экземпляра ПО) должны совпадать в трёх файлах конфигурации:
- /usr/share/comindware/configs/instance/<instanceName>.yml
- /var/www/<instanceName>/adapterhost.yml
- /var/www/<instanceName>/apigateway.yml
При этом:
- mq.group и mq.node не должны совпадать между собой;
- если узлов несколько, значения параметра mq.node должны быть разными на разных узлах.
Пример конфигурации с одним узлом:
# Имя экземпляра ПО clusterName: <instanceName> ##### Настройка очереди сообщений ##### # Адрес и порт брокера сообщений {{ apacheKafkaVariants }}. mq.server: <kafkaBrokerIP>:<kafkaBrokerPort> # Идентификатор группы очереди сообщений. mq.group: <instanceName> # Префикс имени очередей сообщений. mq.name: <instanceName> # Идентификатор узла очереди сообщений. mq.node: <instanceName>
Сохраните файл конфигурации.
Убедитесь, что директории, указанные в файле конфигурации, существуют. При необходимости создайте их и задайте права доступа:
mkdir -p <path/to/Database> mkdir -p <path/to/Streams> mkdir -p <path/to/Backup> chown -R <User>:<Group> <path/to/Database> <path/to/Streams> <path/to/Backup>
Здесь значения <User> и <Group> должны совпадать с такими же параметрами в файле /usr/lib/systemd/system/comindware<instanceName>.service
Перезапустите службу экземпляра ПО:
systemctl restart comindware<instanceName>

Пример YML-файла конфигурации экземпляра ПО

##### Настройка базовых параметров Comindware Platform ##### 
# Имя экземпляра Comindware Platform. 
clusterName: <instanceName> 
# Имя узла экземпляра Comindware Platform. 
#nodeName: <instanceName> 
# Путь к экземпляру, по которому Comindware Platform находит свою конфигурацию. 
configPath: <configPath> 
# Адрес службы журналирования OpenSearch (Elasticsearch). 
journal.server: http://<searchHostIP>:<searchHostPort> 
# Индекс службы журналирования OpenSearch (Elasticsearch). 
# Допускается использовать только строчные буквы и цифры. 
# Если в имени индекса будут прописные буквы или спецсимволы (например, дефис), 
# служба журналирования автоматически преобразует их в строчные буквы и символы подчёркивания. 
#journal.name: <instanceName> 
# Имя пользователя для аутентификации службы журналирования OpenSearch (Elasticsearch). 
#journal.username: 
# Пароль для аутентификации службы журналирования OpenSearch (Elasticsearch). 
#journal.password: 
# Выключение службы журналирования. 
#journal.enabled: false 
# Выключение проверки валидации сертификатов 
#journal.certificateSkipValidation: false 
# URI-адрес экземпляра Comindware Platform. 
fqdn: <hostName> 
# Порт экземпляра Comindware Platform. 
port: <portNumber> 
# Версия экземпляра Comindware Platform. 
version: <versionNumber> 
 
 
##### Настройка базы данных ##### 
# Использование тонкого клиента. 
#db.asThinClient: true 
# Конечные точки для подключения тонкого клиента. 
#db.asThinClientEndpoints: 127.0.0.1:10800 
# Путь к базе данных. 
db.workDir: /var/lib/comindware/<instanceName>/Database 
# Папка установки Apache Ignite. 
#db.homeDir: 
# Путь к файлу конфигурации Apache Ignite. 
#db.configPath: 
# Настройки JVM. 
#db.jvmOpts: 
# Настройки Java. 
#db.javaOpts: 
# Включение автоматической активации кластера Apache Ignite при запуске. 
# При использовании нескольких узлов рекомендуется отключить на всех узлах. 
#db.baselineAutoActivationEnabledFlag: false 
# Включение автоматической настройки узлов Apache Ignite. 
# На всех узлах должно быть одинаковое значение. 
#db.baselineAutoAdjustEnabledFlag: true 
# Время ожидания фактического изменения настройки узлов Apache Ignite 
# с момента последнего изменения. 
# На всех узлах должно быть одинаковое значение. 
#db.baselineAutoAdjustTimeout: 3000 
# Согласованный глобальный уникальный идентификатор узла Apache Ignite. 
#db.consistentId: 
# Используемый префикс кэшей в базе данных 
# На всех узлах должно быть одинаковое значение. 
db.name: <instanceName> 
# Вес узла (целочисленное значение) с точки зрения кластера Apache Ignite. 
# Суммарный вес всех узлов не должен превышать 100. 
# Значение по умолчанию: 100/кол-во узлов. 
#db.weight: 
# Путь к онтологии Comindware Platform 
#db.n3Dir: 
# Количество резервных копий для каждого кэша. При db.systemCacheConfig.cacheMode = Replicated не оказывает влияния. 
#db.cacheConfig.backups: 2 
# Тип кэша. Доступные значения: Partitioned | Replicated 
#db.cacheConfig.cacheMode: Replicated 
# Задержка ребалансировки (в секундах) при изменении топологии кластера Apache Ignite. 
#db.cacheConfig.rebalanceDelay: 0 
# Тип ребалансировки. Доступные значения: Sync | Async | None 
#db.cacheConfig.rebalanceMode: Async 
# Тип синхронизации данных кэша. Доступные значения: FullSync | FullAsync | PrimarySync 
#db.cacheConfig.writeSynchronizationMode: FullSync 
 
 
##### Настройка хранения загруженных файлов ##### 
# Тип хранилища (LocalDisk | S3). 
userStorage.type: LocalDisk 
# Путь к пользовательским файлам экземпляра. 
userStorage.localDisk.path: /var/lib/comindware/<instanceName>/Streams 
# Имя корзины S3 для хранения загруженных файлов. 
#userStorage.s3.bucket: 
# Имя подключения к S3. 
#userStorage.s3.connection: <s3ConnectionName> 
 
##### Настройка хранения временных файлов ##### 
# Тип хранилища (LocalDisk | S3). 
tempStorage.type: LocalDisk 
# Путь к временным файлам экземпляра. 
tempStorage.localDisk.path: /var/lib/comindware/<instanceName>/Temp 
# Имя корзины S3 для хранения временных файлов. 
#tempStorage.s3.bucket: 
# Имя подключения к S3. 
#tempStorage.s3.connection: <s3ConnectionName> 
# Временная папка 
tempWorkingDir: /var/lib/comindware/<instanceName>/LocalTemp 
 
 
##### Настройка очереди сообщений ##### 
# Адрес и порт брокера сообщений Apache Kafka. 
mq.server: <kafkaBrokerIP>:<kafkaBrokerPort> 
# Идентификатор группы очереди сообщений. 
mq.group: <instanceName> 
# Префикс имени очередей сообщений. 
mq.name: <instanceName> 
# Идентификатор узла очереди сообщений. 
mq.node: <instanceName>_Exclusive 
# Выключение функции очереди сообщений. 
#mq.enabled: false 
# Протокол безопасности очереди сообщений. 
# (Plaintext | Ssl | SaslPlaintext | SaslSsl) 
#mq.securityProtocol: Plaintext 
 
##### Настройка SSL-подключения очереди сообщений ##### 
# Путь к файлу корневого сертификата брокера сообщений. 
#mq.ssl.caLocation: 
# Выключение идентификации адреса брокера сообщений. 
#mq.ssl.endpointIdentificationEnabled: false  
 
##### Настройка SASL-подключения очереди сообщений ##### 
# Имя пользователя, используемое для подключения посредством SASL. 
#mq.sasl.username: 
#Пароль для аутентификации, используемый для подключения посредством SASL. 
#mq.sasl.password: 
# Тип механизма SASL (None | Plain | ScramSha256 | ScramSha512). 
#mq.sasl.mechanism: 
 
 
##### Настройка очереди сообщений для коммуникации с адаптерами ##### 
# Выключение функции коммуникации брокера сообщений с адаптером 0. 
#mq.adapter.0.enabled: false 
# Выключение отправителя сообщений. 
#mq.adapter.0.producer.enabled: false 
# Выключение получателя сообщений. 
#mq.adapter.0.consumer.enabled: false 
# Выключение функции коммуникации брокера сообщений с адаптером 1. 
#mq.adapter.1.enabled: false 
# Выключение отправителя сообщений. 
#mq.adapter.1.producer.enabled: false 
# Выключение получателя сообщений. 
#mq.adapter.1.consumer.enabled: false 
# Выключение функции коммуникации брокера сообщений с адаптером 2. 
#mq.adapter.2.enabled: false 
# Выключение отправителя сообщений. 
#mq.adapter.2.producer.enabled: false 
# Выключение получателя сообщений. 
#mq.adapter.2.consumer.enabled: false 
# Выключение функции коммуникации брокера сообщений с адаптером 3. 
#mq.adapter.3.enabled: false 
# Выключение отправителя сообщений. 
#mq.adapter.3.producer.enabled: false 
# Выключение получателя сообщений. 
#mq.adapter.3.consumer.enabled: false 
 
##### Создание топиков ##### 
# Коэффициент репликации для создаваемого топика. 
#mq.replicationFactor: 3 
# Количество партиций для создаваемого топика. 
#mq.numPartitions: 16 
# Таймаут для запроса метаданных (миллисекунды). 
#mq.metadataTimeout: 3000 
# Тип сжатия данных в топиках. 
#mq.compressionType: Lz4 
# Таймаут на обработку сообщения (должен быть больше таймаута сессии 
# указанного в параметрах брокера, (миллисекунды). 
#mq.maxPollInterval: 300000 
 
##### Настройка OpenID-аутентификации ##### 
# Имя OpenID-сервиса, использующегося для входа. 
#auth.openId.displayName: 
# Включение функции OpenID. 
#auth.openId.enabled: true 
# Адрес сервера OpenID Connect. 
#auth.openId.server: 
# Пространство имен или контекст, в котором происходит аутентификация пользователей. 
# Используется для управления идентификацией и доступом в системе OpenID Connect. 
#auth.openId.realm: 
# Уникальный идентификатор клиентского приложения, используемый 
# для аутентификации и авторизации запросов по протоколу OpenID Connect. 
#auth.openId.clientId: 
# Секретный ключ OpenId Connect 
#auth.openId.clientSecret: 
# Список идентификаторов целевой аудитории, для которой предназначены токены,  
# используемые в процессе аутентификации и авторизации в OpenID Connect. 
#auth.openId.audience: 
 
##### Настройки аутентификации ##### 
# Минимальная длина пароля пользователя 
#auth.minimalPasswordLength: 14 
# Время истечения сессии пользователя в формате дд.чч:мм:сс 
#auth.sessionExpirationTime: 00.12:00:00 
 
 
##### Настройка резервного копирования ##### 
# Папка для резервного копирования по умолчанию. 
# Будет использоваться во вновь создаваемых конфигурациях резервного копирования. 
backup.defaultFolder: /var/backups/<instanceName>/Backup 
# Имя файла резервных копий по умолчанию. 
# Будет использоваться во вновь создаваемых конфигурациях резервного копирования. 
backup.defaultFileName: Backup 
# Выключение функции резервного копирования. 
#backup.enabled: false 
# Выключение сеансов резервного копирования. 
# Выключает выполнение резервного копирования, но не создание сеансов резервного копирования. 
#backup.sessionsEnabled: false 
# Выключение создания сеансов резервного копирования по расписанию. 
#backup.schedulesEnabled: false 
# Максимальное количество сеансов резервного копирования. 
#backup.maxSessions: 5 
 
##### Конфигурация резервного копирования по умолчанию ##### 
# <backupName> — имя конфигурации резервного копирования, без пробелов 
# Имя файлов резервных копий. 
# К нему будут добавляться метка времени и расширение cdbbz, например: 
# Backup.202202161625.cdbbz 
#backup.default.<backupName>.name: Backup 
# Тип хранилища (LocalDisk | S3). 
#backup.default.<backupName>.repository.type: LocalDisk 
# Путь к файлам резервных копий. 
#backup.default.<backupName>.repository.localDisk.path: /var/backups/<instanceName>/Backup 
# Имя корзины S3 для хранения файлов резервных копий. 
#backup.default.<backupName>.repository.s3.bucket: 
# Имя подключения к S3. 
#backup.default.<backupName>.repository.s3.connection: <s3ConnectionName> 
# Описание конфигурации 
#backup.default.<backupName>.description: 
# Периодичность запуска резервного копирования. 
#backup.default.<backupName>.period: 23:00 
# Дни запуска резервного копирования. 
#backup.default.<backupName>.days: [Sunday,  Monday, Tuesday, Wednesday, Thursday, Friday, Saturday] 
# Время начала запуска резервного копирования. 
#backup.default.<backupName>.timeFrom: 00:01 
# Время окончания запуска резервного копирования. 
#backup.default.<backupName>.timeUpTo: 23:59 
# Количество резервных копий одновременно хранящихся в системе. 
# Старые будут удалены автоматически. 
#backup.default.<backupName>.keepRecent: 10 
# Управление составом резервной копии — загруженные файлы 
#backup.default.<backupName>.withStreams: true 
# Управление составом резервной копии —  файлы скриптов. 
#backup.default.<backupName>.withScripts: true 
# Управление составом резервной копии — файлы истории (OpenSearch (Elasticsearch)). 
#backup.default.<backupName>.withJournal: true 
 
 
##### Настройка дополнительного хранилища для конфигурации резервного копирования по умолчанию ##### 
# Тип хранилища (LocalDisk | S3). 
#backup.default.<backupName>.extraRepository.type: LocalDisk 
# Путь к файлам резервных копий. 
#backup.default.<backupName>.extraRepository.localDisk.path: /var/backups/<instanceName>/BackupExtraRepository 
# Имя корзины S3 для хранения файлов резервных копий. 
#backup.default.<backupName>.extraRepository.s3.bucket: 
# Имя подключения к S3. 
#backup.default.<backupName>.extraRepository.s3.connection: <s3ConnectionName> 
 
##### Настройка резервного копирования данных службы журналирования (OpenSearch (Elasticsearch)) ##### 
# Тип хранилища (LocalDisk | S3). 
#backup.journalRepository.type: LocalDisk 
# Путь к файлам резервных копий 
#backup.journalRepository.localDisk.path: /var/backups/<instanceName>/Backup 
# Имя корзины S3 для хранения файлов резервных копий. 
#backup.journalRepository.s3.bucket: 
# Имя подключения, настроенного в конфигурации службы журналирования. 
#backup.journalRepository.s3.journalConnection: <s3ConnectionName> 
# Имя подключения к S3, настроенного в этом файле конфигурации экземпляра Comindware Platform. 
#backup.journalRepository.s3.platformConnection: <s3ConnectionName> 
 
##### Конфигурация подключения к хранилищу S3 ##### 
# Описание конфигурации. 
#s3.<s3ConnectionName>.description: 
# Адрес подключения к S3. 
#s3.<s3ConnectionName>.endpointURL: 
# Информация учётной записи. Ключ подключения к хранилищу S3 
#s3.<s3ConnectionName>.accessKey: 
# Информация учётной записи. Секретный ключ подключения к хранилищу S3. 
#s3.<s3ConnectionName>.secretKey: 
# Использовать адресацию в стиле системных путей. 
# Установите значение true, если сервер принимает только запросы path-style вида: 
# https://<s3hostname>/bucket-name/key-name 
#s3.<s3ConnectionName>.pathStyleAccess: true 
 
 
##### Настройка полнотекстового поиска ##### 
# Выключение функции полнотекстового поиска. 
#search.enabled: false 
# Выключение обновления индексов полнотекстового поиска. 
#search.rebuildingEnabled: false 
# Выключение индексирования для полнотекстового поиска. 
#search.indexingEnabled: false 
 
##### Настройка сенсоров мониторинга ##### 
# Выключение функции сенсоров мониторинга. 
#sensors.enabled: false 
 
##### Настройка синхронизации аккаунтов с LDAP-сервисом ##### 
# Выключение функции синхронизации. 
#sync.ldap.enabled: true 
# Выключение запуска сеансов LDAP синхронизации. 
# Выключает выполнение сеансов, но не их создание. 
#sync.ldap.sessionsEnabled: true 
# Выключение создания сеансов LDAP синхронизации по расписанию 
#sync.ldap.schedulesEnabled: true 
# Максимальное время (в секундах) на выполнение запроса аутентификации 
#sync.ldap.connectionTimeout: 300 
# Максимальное время (в секундах) на выполнение поискового запроса 
#sync.ldap.searchTimeout: 600 
# Выключение проверки валидации сертификатов 
#sync.ldap.certificateSkipValidation: true 
# Выключение интеграции OData 
#sync.oData.enabled: false 
# Выключение запуска сеансов синхронизации данных по OData. 
# Выключает выполнение сеансов, но не их создание. 
#sync.oData.sessionsEnabled: false 
# Выключение создания сеансов синхронизации данных по OData по расписанию. 
#sync.oData.schedulesEnabled: false 
# Интервал экспорта данных по OData (минуты). 
#sync.oData.exportTimeInterval: 60 
 
##### Настройки трассировки производительности ##### 
# Выключение функции трассировки производительности. 
#tracing.enabled: false 
 
##### Настройки электронной почты ##### 
# Выключение функции проверки наличия и получения новых писем. 
#email.listenerEnabled: false 
# Выключение функции отправки электронной почты. 
#email.senderEnabled: false 
# Выключение логотипа в экспортированных файлах. 
#hideLogoOnExport: false 
 
##### Настройки уведомлений ##### 
# Выключение функции отправки уведомлений. 
#notifications.enabled: false 
# Выключение отправки уведомлений по пользовательским задачам. 
#notifications.onUserTaskEnabled: false 
# Выключение отправки уведомлений об обсуждениях. 
#notifications.pushEnabled: false 
# Выключение отправки уведомлений на страницах обслуживания. 
#notifications.onMaintenanceEnabled: false 
 
 
##### Настройка бизнес-процессов ##### 
# Выключение функции бизнес-процессов 
#bpms.enabled: false 
# Количество потоков выполнения бизнес-процессов 
#bpms.threadsCount: 4 
# Выключение процессных таймеров 
#bpms.timersEnabled: false 
 
##### Настройка обработчика сервис-запросов ##### 
# Включение функции обработчика сервис-запросов 
requestProcessor.enabled: true 
# Список обработчиков сервис-запросов.  
# Если не указан, включает все доступные на узле  запросы 
# (conversation, useractivity, notification, architect) 
#requestProcessor.services: 
#  - apiPrefix: conversation 
#  - enabled: true 
# Настройка отображения количества строк таблицы на одной странице 
# Задайте варианты, которые будут отображаться 
# в меню выбора количества строк таблицы. 
#queryPageResultRange: [ 50, 500, 5000, 1000000000 ] 
# Максимально время (в секундах) на выполнение запроса таблицы. 
#datasetQueryTimeout: 30 
# Максимальное время (в секундах) запроса суммарного кол-ва элементов таблицы. 
#datasetQueryTotalTimeout: 1 
 
##### Настройка аккаунтов ##### 
# Включение/выключение для всех пользователей возможности добавления замещений для собственного аккаунта. 
#account.selfSubstitutionsEnabled: true 
 
##### Настройка загружаемых документов ##### 
# Выключение валидации содержимого загружаемых документов 
#documents.formatMatchContent: false 
 
##### Настройка криптографии ##### 
# Включение/выключение функции криптографии 
#useGostAlgorithms: true 

Конфигурация службы apigateway

Откройте файл конфигурации apigateway.yml экземпляра ПО для редактирования:
nano /var/www/<instanceName>/apigateway.yml
Измените необходимые параметры.
Удостоверьтесь, что значение параметра cluster.name (имя экземпляра ПО) совпадает с clusterName и значение параметров mq.server (адрес и порт брокера сообщений), mq.group (идентификатор группы очереди сообщений), mq.node (идентификатор узла очереди сообщений) — с аналогичными параметрами в файле конфигурации экземпляра.
Сохраните файл конфигурации.
Перезапустите службу apigateway:
systemctl restart apigateway<instanceName>

Пример конфигурации службы apigateway.yml

# Имя экземпляра ПО 
cluster.name: <instanceName> 
# Имя узла экземпляра 
#nodeName: 
# Включение/выключение конфигурации журналирования экземпляра (true | false) 
log.enabled: true 
# Путь к файлу конфигурации журналирования экземпляра 
log.configurationFile: /var/www/<instanceName>/logs.config 
# Адрес и порт брокера сообщений Apache Kafka. 
mq.server: <kafkaBrokerIp>:<kafkaBrokerPort> 
# Идентификатор группы очереди сообщений 
mq.group: <instanceName> 
# Префикс имени очередей сообщений 
mq.name: <instanceName> 
# Идентификатор узла очереди сообщений 
mq.node: <instanceName> 
# Протокол безопасности очереди сообщений. (Plaintext | Ssl | SaslPlaintext | SaslSsl) 
#mq.securityProtocol: Plaintext 
# Путь к файлу корневого сертификата брокера сообщений 
#mq.ssl.caLocation: 
# Выключение идентификации адреса брокера сообщений 
#mq.ssl.endpointIdentificationEnabled: false 
# Имя пользователя, используемое для подключения при помощи SASL 
#mq.sasl.username: 
# Пароль для аутентификации, используемый для подключения при помощи SASL 
#mq.sasl.password: 
# Тип механизма SASL. (None | Plain | ScramSha256 | ScramSha512) 
#mq.sasl.mechanism: 
# Параметр ReplicationFactor для создаваемого топика 
#mq.replicationFactor: 3 
# Параметр NumPartitions для создаваемого топика 
#mq.numPartitions: 16 
# Таймаут для запроса метаданных (мс) 
#mq.metadataTimeout: 3000 
# Таймаут для запроса метаданных (мс) 
#mq.deliveryTimeout: 10000 
# Тип сжатия данных в топиках 
#mq.compressionType: lz4 
# Таймаут на обработку сообщения (должен быть больше таймаута сессии указанного в параметрах брокера, мс) 
#mq.maxPollInterval: 300000 
# Порт для входящих соединений 
#listen.port: 
# Протокол входящих соединений (None, Http1, Http2, Http1AndHttp2) 
listen.protocol: Http1AndHttp2 
# Путь к сокету apigateway (указан в конфигурационном файле Nginx) 
listen.socketPath: /var/www/<instanceName>/App_Data/apigateway.socket 
# Включение/выключение файлового хранилища  (true | false) 
fileStorage.enabled: false 
# Тип файлового хранилища (Platform — встроенное | Custom — особая DLL-библиотека ) 
#fileStorage.type: Platform 
# Адрес сервера для загрузки файлов 
#fileStorage.attachmentServerUri: http://<service URL> 
# Путь к загружаемым файлам 
#fileStorage.uploadAttachment.path: /api/Attachment/Upload 
# HTTP-метод отправки файлов в хранилище. (GET | POST | PUT | DELETE) 
#fileStorage.uploadAttachment.method: POST 
# Путь загрузки файлов из хранилища 
#fileStorage.downloadAttachment.path: /api/Attachment/GetReferenceContent/{0} 
# HTTP-метод загрузки файлов из хранилища. (GET | POST | PUT | DELETE) 
#fileStorage.downloadAttachment.method: GET 
# Путь удаления файлов из хранилища 
#fileStorage.removeAttachment.path: /api/Attachment/Remove/{0} 
# HTTP-метод удаления файлов из хранилища. (GET | POST | PUT | DELETE) 
#fileStorage.removeAttachment.method: DELETE 
# Вкл./выкл. страницы для мониторинга подключений (true | false) 
statusPage.enabled: true 
# Префиксы служб API 
services: 
  - apiPrefix: conversation 
  - apiPrefix: useractivity 
  - apiPrefix: notification 
  - apiPrefix: architect 
  - apiPrefix: subscription 
  - className: Comindware.ApiGateway.Services.SubscriptionHub 

Конфигурация службы adapterhost

Откройте файл конфигурации adapterhost.yml экземпляра ПО для редактирования:
nano /var/www/<instanceName>/adapterhost.yml
Измените необходимые параметры.
Удостоверьтесь, что значения параметров mq.server (адрес и порт брокера сообщений), mq.group (идентификатор группы очереди сообщений), mq.node (идентификатор узла очереди сообщений) и clusterName (имя экземпляра ПО) совпадают с аналогичными параметрами в файле конфигурации экземпляра ПО.
Сохраните файл конфигурации.
После внесения изменений перезапустите службу adapterhost:
systemctl restart adapterhost<instanceName>

Пример файла конфигурации adapterhost.yml

# Имя экземпляра ПО 
clusterName: <instanceName> 
# Уникальный идентификатор сервиса AdapterHost. 
serviceId: Comindware.AdapterHost.<instanceName> 
# Папка загрузчика экземпляра ПО. 
loaderFolder: ./bin/Debug/net8.0/LoadData 
# Путь к файлам журналирования экземпляра ПО 
log.folder: ../../Web/Logs 
# Язык приложения по умолчанию. 
serverLanguage: ru-RU 
# Имена адаптеров которые необходимо исключить 
ignoredAdapters: [""] 
# Имена путей передачи данных которые необходимо исключить 
ignoredProcedures: [""] 
 
##### Настройка очереди сообщений ##### 
# Адрес и порт брокера сообщений Apache Kafka 
mq.server: <kafkaBrokerIp>:<kafkaBrokerPort> 
# Идентификатор группы очереди сообщений 
#mq.group: <instanceName> 
# Идентификатор узла очереди сообщений 
#mq.node: <instanceName>_Exclusive 
# Префикс имени очередей сообщений 
#mq.name: 
# Протокол безопасности очереди сообщений. (Plaintext | Ssl | SaslPlaintext | SaslSsl) 
mq.securityProtocol: Plaintext 
 
##### Настройки SSL-подключения очереди сообщений ##### 
# Путь к файлу корневого сертификата брокера сообщений 
#mq.ssl.caLocation: 
# Выключение/включение идентификации адреса брокера сообщений 
#mq.ssl.endpointIdentificationEnabled: false 
 
##### Настройка SASL-подключения очереди сообщений ##### 
# Имя пользователя, используемое для подключения посредством SASL 
#mq.sasl.username: 
# Пароль для аутентификации, используемый для подключения посредством SASL 
#mq.sasl.password: 
# Тип механизма SASL. (None | Plain | ScramSha256 | ScramSha512) 
#mq.sasl.mechanism: None 
# Путь к внутренним адаптерам 
internalAdaptersDir: ..\..\Adapters\InternalAdapters 
 
##### Настройка входящих TCP-соединений ##### 
# Порт для входящих соединений 
#listen.port: 5000 

Конфигурация Apache Ignite

Откройте файл конфигурации Apache Ignite для редактирования:
nano /var/www/<instanceName>/Ignite.config
В блоке <bean class="org.apache.ignite.configuration.DataRegionConfiguration"> задайте максимальный объём выделяемой памяти:
- 3 ГБ:
  <property name="maxSize" value="#{3L * 1024 * 1024 * 1024}" />
- 8 ГБ:
  <property name="maxSize" value="#{8L * 1024 * 1024 * 1024}" />
В случае изменения максимального объёма выделяемой памяти отредактируйте параметр checkpointPageBufferSize. Чтобы рассчитать размер значения, разделите размер maxSize на четыре, при этом значение должно быть в диапазоне 256 МБ — 2 ГБ.
- 8 ГБ:
  <property name="checkpointPageBufferSize" value="#{2L * 1024 * 1024 * 1024}" />
Перезапустите службу экземпляра ПО:
systemctl restart comindware<instanceName>

Конфигурация кучи Java

В зависимости от объёма оперативной памяти на сервере следует отредактировать конфигурацию области памяти для кучи Java.

Откройте файл конфигурации среды экземпляра ПО для редактирования:
nano /etc/sysconfig/comindware<instanceName>-env
Задайте объём памяти, который выделяется для кучи Java:
JVM_OPTS=-Xms512m -Xmx16g -XX:MaxDirectMemorySize=1g ...
Здесь:
- -Xms — начальный размер кучи;
- -Xmx — максимальный размер кучи.
Сохраните файл конфигурации.

Перезапустите службу экземпляра ПО:

systemctl daemon-reload 
systemctl restart comindware<instanceName> 

Конфигурация NGINX

Откройте файл конфигурации NGINX для редактирования:
- Astra Linux, Debian, DEB-дистрибутивы
  nano /etc/nginx/sites-available/comindware<instanceName>
- РЕД ОС, RPM-дистрибутивы
  nano /etc/nginx/conf.d/comindware<instanceName>
- Альт Сервер
  nano /etc/nginx/sites-available.d/comindware<instanceName>

В директиве server задайте номер порта и адрес сервера, по которым будет доступен экземпляр ПО:

server { 
    # Адрес сервера для доступа к экземпляру ПО. 
    server_name <hostName> 
    # Номер порта для доступа к экземпляру ПО. 
    listen <portNumber> 
} 

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

    error_log /var/log/nginx/<instanceName>-error.log; 
    access_log /var/log/nginx/<instanceName>-access.log; 

Сохраните файл конфигурации.
Проверьте, что изменения работают корректно:
nginx -t
При успешном вступлении изменений в силу перезагрузите NGINX:
nginx -s reload