Кластеры

Раздел меню Обслуживание → Кластеры содержит инструменты управления кластерами в Платформе.

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

Имя кластера, имя и наименование сервера наследуются от имени сервера, на котором установлена и запущена Платформа, указанного в операционной системе. В качестве адреса устанавливается ip-адрес 127.0.0.1.

Примечание

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

Настройка кластера

При отсутствии кластера в Платформе доступно создание кластера вручную.

Для создания кластера:

1. В ЦН перейдите в раздел Обслуживание → Кластеры.

2. Нажмите на кнопку +. В рабочей области страницы отобразится интерфейс создания нового кластера, содержащий две вкладки: Основная и Логирование:

3. На вкладке Основная заполните следующие поля:

   • Название: произвольное название кластера, обязательно для заполнения.

   • Имя: уникальное имя кластера, необязательно для заполнения.

   • Комментарий: описание кластера, необязательно для заполнения.

   • Порт для запросов подключаемых систем.

   • Порт Центра мониторинга.

   • Порт API сервера.

   • Порт SNMP.

4. При необходимости установите флажки Балансировка нагрузки при обработке сообщений и Контроль доступного места на диске.

5. На вкладке Логирование установите необходимые уровни логирования журнала и событий кластера, длительность хранения логов и файлов, а так же максимальные размеры каталогов и файлов.

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

6. Нажмите на кнопку Сохранить изменения. Введенные данные будут сохранены, и между кнопками появится кнопка Обновить, которую можно будет использовать для обновления данных:

   

7. Перейдите в режим редактора конфигурации, используя переключатель Режим диалога / редактора конфигурации.

   Откроется окно редактора конфигурации, содержащее начальную конфигурацию.

8. Внесите необходимые изменения в конфигурацию.

9. Нажмите на кнопку Сохранить изменения для сохранения изменений.

10. Нажмите на кнопку Применить конфигурацию:

    

Настройки кластера определяют ключевые параметры работы систем.

Таблица параметров конфигурации кластера:

Параметр	Возможность уточнения	Описание
auth	нет	Настройки авторизации, применяемые для всех узлов и модулей.
coordinators	нет	Массив приоритетных координаторов для кластера, см. раздел Отказоусточивость.
heartbeatPeriod	нет	Период опроса машин координатором (в мс.).
failThreshold	нет	Максимальное количество пропущенных heartbeat-сообщений, после которых узел считается недоступным.
faultTolerance	нет	Уровень отказоустойчивости, т.е. количество реплик, на которых будет создаваться копия данных узлам.
archiveApiPort	нет	Порт для работы с очередями кластера.
apiPort	нет	Порт API кластера.
snmpPort	нет	Порт для сборки счетчиков SNPM с узлов.
counterSettings	нет	Настройки сбора счетчиков узлов и модулей в ЦН.
useBalancing	в настройках модуля процессов	Возможность включить балансировку на модулях процессов, см. раздел Балансировка.
processParams	в настройках модуля процессов	Базовые настройки балансировщика для всех модулей процессов, см. раздел Балансировка.
commonParams	в настройках модуля процессов	Максимальный объем потребляемой памяти модулями процессов, см. раздел Балансировка.
nodeParams	в настройках узла	Настройки перенаправления сообщений, см. раздел Перенаправление процессов с перегруженного узла.
globalDiagnosticParams	в настройках узла или модуля	Настройки диагностики, в том числе уровень логирования, см. раздел Элементы диагностики.
cacheSettings	нет	Настройки кеширования.
entityId	нет	GUID кластера, совпадает с clusterId.
name	нет	Имя кластера.
version	нет	Номер версии текущей конфигурации кластера.
tagsCollection	нет	Теги кластера.
systemRequestsPort	нет	Порт узла для отправки параметров адаптеров 1С.
useDiskControl	нет	Контроль диска, см. раздел Контроль дисков.
queueParams	нет	Настройки хранилища очередей.
messageProcessingParams	нет	Настройки количества откладывания сообщения.
replicationSettings	нет	Настройки репликации.
resolveList	нет	Список сопоставления ip-адресов серверов кластера с именами.
logStorageParams	нет	Настройки логирования на диск, см. раздел Логирование на диск.
useSystemUDPSender	нет	UDP рассылка для 1C.
updateTimeout	нет	Настройка периода рассылки состояния координатора серверам.
largeObjectQueueParams	нет	Настройки параметров очереди больших сообщений.
OtherMachineSenderThreadsCount	нет	Количество потоков при передаче данных между серверами кластера. Может принимать значения от 2 до 12. Значение по умолчанию - 8.
executeRequestTimeoutMs	нет	Время ожидания ответа от процесса узла, направленного процессу узла-координатора при выполнении запроса получения записей журнала или событий ЦМ. Единица измерения - миллисекунды. Значение по умолчанию - 600000.

Примечание

Некоторые параметры могут быть уточнены в конфигурации конкретного узла, модуля или системы. Если уточнения нет, то для работы берутся значения, заполненные в кластере. При возникновении ошибки Сработал лимит на размер директории Temp увеличьте значение tempFolderMaxSizeMb параметра logStorageParams, сохраните изменения и примените конфигурацию.

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

По умолчанию все серверы, создаваемые в кластере (не в nodeGroups), добавляются в группу default, в рамках которой осуществляется распределение сервисов и систем.

Внимание

Если система или сервис указаны напрямую в конфигурации конкретного сервера, они будут запущены независимо от принадлежности к группе.

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

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

Внимание

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

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

В конфигурации кластера поле nodeGroupCollection содержит массив nodeGroups - групп серверов.

    "nodeGroupCollection": {
    "$type": "DT.ClusterConfiguration.NodeGroupCollection, DT_Core",
    "nodeGroups": [
        {
            "nodeGroupId": "ee85a5bb-399b-40b2-8ec8-5157d8cad99b",
            "nodeGroupName": "1",
            "nodeIds": [
                "5d77e4f6-623a-4e24-aa20-fe9b688f2474"
            ],
            "systemsAndModulesIds": [
                "6a9ae87c-a5a6-4d76-8c86-6cd4088ec6be"
            ]
        },
        {
            "nodeGroupId": "92f96ec3-0a34-47f8-983c-dca51b01de6d",
            "nodeGroupName": "2",
            "nodeIds": [
                "d67bcf81-ab4d-491c-bdfc-cec32a642386",
                "fce58a75-dcdc-4b18-bbbf-3d1a25f2cf8e"
            ],
            "systemsAndModulesIds": [
                "5a14fdfb-d502-4939-889e-cd4d3c651ad7"
            ]
        }
    ]
}

В примере:

• 2 группы серверов (1 и 2) - nodeGroupName, nodeGroupId;

• в 1 группе: 1 сервер (nodeIds) и 1 система или сервис (systemsAndModulesIds);

• во 2 группе: 2 сервера (nodeIds) и 1 система или сервис (systemsAndModulesIds)

Внимание

Все нераспределённые сервисы и системы по умолчанию запускаются на серверах из группы по умолчанию (default). Сервис или система может быть привязана только к одной группе серверов и работает исключительно внутри этой группы. Если есть активные, но нераспределённые сервисы или системы, а в группе default отсутствуют включённые серверы, выводится сообщение об ошибке с требованием вручную распределить сервисы по группам..

Настройка группы серверов

Для группирования серверов необходимо:

1. перейти: ЦН → Обслуживание → Кластеры → открыть требуемый кластер двойным щелчком

   

Внимание

Убедитесь, что созданы необходимые Серверы, Сервисы, Системы

2. в Кластере выбрать вкладку Группы серверов

   

3. для добавления Группы нажать +

   

4. новая группа будет добавлена в конце списка

   

Номера присваиваются последовательно, начиная с 1. Редактирование названия группы возможно только в конфигурации кластера.

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

• на странице Групп серверов Кластера Перейти в режим редактора конфигурации

  

• найти соответствующую строку NodeGroupName

  

• задать название и Сохранить изменения

  

• выйти из режима редактора, группе задано соответствующее название

  

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

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

Примечание

Если ранее созданная группа была удалена, её порядковый номер становится доступным для повторного использования. Таким образом, при создании новой группы используется первый «пропущенный» (свободный) номер, чтобы поддерживать непрерывность нумерации.

6. выбрать для группы Серверы, Системы и Сервисы

   

Где:

Серверы - перечень Серверов, настроенных в ЦН

Системы - перечень Внешних систем (Интеграция), настроенных в ЦН

Сервисы - перечень Сервисов, настроенных в ЦН

Доступен мультиселект, перечень Серверов, Систем и Сервисов редактируется - можно удалить и / или добавить в группу.

7. Сохранить изменения

8. Применить конфигурацию

   

9. при необходимости повторить п.3 - 8.

Управление кластером и диагностика

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

Есть возможность включить подробное логирование по некоторым аспектам работы Платформы. Для этого необходимо добавить функциональность в массив конфигурации кластера features. Метод для получения списка доступных функциональностей: GET /api/info/features.

Примечание

Если вы используете недоверенный SSL-сертификат, при первом подключении в браузере нажмите на кнопку Дополнительные и перейдите по ссылке Перейти на <ip-адрес>.

При входе на сайт диагностики по ip машины, не являющейся координатором, происходит переадресация на сервер-координатор кластера.

Настройка кластера из нескольких серверов

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

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

   Внимание

   ЦН должен быть открыт только на сервере-координаторе. После установки Платформы на сервер, который должен быть добавлен в кластер, открывать ЦН не следует, так как при первом открытии будет создан новый кластер, и сервер нельзя будет включить в существующий кластер.

2. В ЦН перейдите в раздел Серверы.

3. В рабочей области раздела нажмите на кнопку + (Добавить).

   

4. На странице добавления сервера укажите следующие данные:

   • Название: название сервера, обязательно для заполнения.

   • Имя: имя сервера, необязательно для заполнения.

   • Комментарий: описание сервера, необязательно для заполнения.

   • Адрес: адрес сервера с установленной Платформой.

   • Порт: порт сервера с установленной Платформой (по умолчанию - 7290).

     

5. Установите флажок Включен.

6. Нажмите на кнопку Сохранить изменения.

7. Нажмите на кнопку Применить конфигурацию:

   

   Внимание

   Один из серверов кластера всегда будет являться координатором, управляющим работой других серверов кластера. Сервер-координатор выбирается в автоматическом режиме. ЦМ всегда публикуется по адресу сервера-координатора. После добавления сервера в кластер, сервер-координатор может измениться, при этом ЦМ может публиковаться по адресам как одного, так и другого сервера, в зависимости от выбранного сервера-координатора. Для открытия ЦМ рекомендуется использовать кнопку Центр мониторинга и администрирования в разделе Обслуживание ‣ Управление конфигурацией:

   

   При успешном подключении сервера к кластеру он будет отображен в рабочей области раздела ЦМ Серверы с индикатором зеленого цвета.

8. Повторите шаги 2-7 для последовательной установки других серверов.

Внимание

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

Вывод сервера из кластера

Для вывода сервера из кластера:

1. В ЦН в кластере удалить сервер (открепить от кластера).

2. Нажмите на кнопку Сохранить изменения.

3. Нажмите на кнопку Применить конфигурацию:

   

4. Вручную почистите файлы Платформы на этом сервере (кэш, архив, логи).

5. На этом сервере заново установить Платформу - запустить установщик. Сохранить, применить конфигурацию.

6. Таким образом авторизоваться в независимом от кластера ЦН.

Управление сервером с неизвестного ЦН

Если сервер получит запрос от ЦН, адрес которого не находится в списке доверенных, сервер не примет запрос и в ответ отправит сообщение с ошибкой. В ЦН будет отображена следующая ошибка: В списке зарегистрированных Центров настроек на сервере отсутствует адрес сервера Центра настроек. Чтобы добавить адрес ЦН в список доверенных на сервере-координаторе, выполните следующую команду на машине сервера-координатора:

Для Windows:

DatareonPlatformService.exe SetCS <ip adress>

Для Linux:

sudo /usr/bin/datareon/platform/DatareonPlatformService setCS <ip adress>

После этого потребуется повторно применить конфигурацию в ЦН.