Тип: Число. Содержит признак поддержки главным и дополнительным менеджером кластера. 1, если сервис поддерживается только главным менеджером кластера и не может быть перенесена в процесс дополнительного менеджера кластера. 0, если сервис может поддерживаться как главным, так и дополнительным менеджером кластера.
Полное описание, параметры и ограничения
Сервис кластера.MainOnly (IClusterServiceInfo.MainOnly)
Сервис кластера (IClusterServiceInfo)
MainOnly (MainOnly)
Доступен, начиная с версии 8.2.
Использование:
Только чтение.
Описание:
Тип: Число.
Содержит признак поддержки главным и дополнительным менеджером кластера.
1, если сервис поддерживается только главным менеджером кластера и не может быть перенесена в процесс дополнительного менеджера кластера.
0, если сервис может поддерживаться как главным, так и дополнительным менеджером кластера.
Доступность:
Интеграция.
Использование в версии:
Доступен, начиная с версии 8.2.
Методическая информация
Практические примеры
Сопоставить реальные сервисы кластера с менеджерами rmngr
Менеджеры поддерживают идентичность при получении разными путями. Главный/дополнительный менеджер и MainOnly сервиса — числовые 0/1, а не готовые значения Булево.
Где и как запускать
Полный модуль собственной управляемой формы нового локального Windows-стенда 1С 8.5.1.1343. Читаются только выбранный УчебныйКластер85 и подтверждённая УчебнаяБаза85. Здесь COM и BSL не запускались.
Подготовка
Нужен отдельный собственный локальный серверный стенд 1С 8.5.1.1343 на Windows без рабочих баз. Здесь выполняется только авторская подготовка кода: реальное подключение агентом справочника не выполнялось.
Администратор стенда заранее устанавливает сервер и регистрирует V85.COMConnector той же версии и разрядности, что серверный процесс учебной базы. Код не запускает regsvr32, не устанавливает платформу и не открывает COM 8.3 вместо 8.5.
В своём стенде создайте единственный целевой кластер с точным именем УчебныйКластер85 и новую пустую серверную базу с именем УчебнаяБаза85. У описания этой базы задайте точное значение syntax-guide85:owned-com. Не переименовывайте рабочую базу или кластер ради обхода защит.
У собственной учебной конфигурации задайте имя метаданных УчебнаяКонфигурацияСинтаксиса. Серверная функция должна выполняться на той же Windows-машине, что агент сервера и выбранный рабочий процесс: обращения жёстко ограничены 127.0.0.1.
Заведите отдельные действительные учебные учётные данные администратора агента, администратора кластера и администратора базы с правом Администратор. В этих уроках имена и пароли намеренно должны быть непустыми; анонимный режим не используется.
Создайте свою учебную обработку с управляемой формой. Реквизиты: ПортАгента и ПортКластера — Число без дробной части; КлючПроцесса, ИмяАгента, ПарольАгента, ИмяАдминистратораКластера, ПарольАдминистратораКластера, ИмяАдминистратораБазы, ПарольАдминистратораБазы, JSONРезультат — Строка; Занято — Булево, начально Ложь. Длина JSONРезультат 0.
Поля трёх паролей выведите в Режиме пароля и не сохраняйте в настройках формы, истории или файле. JSONРезультат выведите многострочным полем только для просмотра. Добавьте команду ПолучитьУчебныйCOMСнимок с одноимённым клиентским обработчиком.
Вставьте весь приведённый модуль формы, включая обе вспомогательные функции. ПортАгента берите из реальной настройки ragent, ПортКластера — из настройки менеджера кластера. Порт ras сюда не подходит.
Первый раз оставьте КлючПроцесса пустым. Каталог покажет только локальные процессы выбранного учебного кластера. Скопируйте точный ключ порт|PID живого процесса из JSON, повторно введите очищенные пароли и повторите команду. PID не придумывайте; после перезапуска процесса получите каталог заново.
Для диагностики соединений откройте одно или два своих клиентских окна УчебнаяБаза85 и выполните обычные учебные действия, например собственный константный запрос. Не создавайте нагрузку на рабочем сервере; измеряемые числа зависят от реальных действий.
Снимок содержит только выбранные поля, не целые COM-объекты. Пароль СУБД, код разрешения входа, параметр блокировки и строка внешнего управления сеансами выводятся только как признаки наличия. Наличие строки не доказывает её корректность или доступность сервиса.
Если вы сами запустите урок, произойдут административные обращения к своему локальному агенту и рабочему процессу. Настройки не меняются, сеансы не завершаются, база не создаётся и не удаляется. Здесь запуск в 1С и подключение не проверялись.
&НаКлиенте
Процедура ПолучитьУчебныйCOMСнимок(Команда)
Если Занято Тогда
Возврат;
КонецЕсли;
Занято = Истина;
Попытка
JSONРезультат = УчебныйCOMСнимокНаСервере(ПортАгента, ПортКластера, КлючПроцесса,
ИмяАгента, ПарольАгента, ИмяАдминистратораКластера, ПарольАдминистратораКластера,
ИмяАдминистратораБазы, ПарольАдминистратораБазы);
Исключение
JSONРезультат = "Снимок не получен. Проверьте собственный Windows-стенд, COM 8.5, разрядность, порты, ключ процесса, учебные имена и права. Сырую ошибку с учётными данными не публикуйте.";
КонецПопытки;
ПарольАгента = "";
ПарольАдминистратораКластера = "";
ПарольАдминистратораБазы = "";
Занято = Ложь;
КонецПроцедуры
&НаСервереБезКонтекста
Функция УчебныйCOMСнимокНаСервере(ПортАгента, ПортКластера, КлючПроцесса,
ИмяАгента, ПарольАгента, ИмяАдминистратораКластера, ПарольАдминистратораКластера,
ИмяАдминистратораБазы, ПарольАдминистратораБазы)
Система = Новый СистемнаяИнформация;
Если Система.ТипПлатформы <> ТипПлатформы.Windows_x86
И Система.ТипПлатформы <> ТипПлатформы.Windows_x86_64 Тогда
ВызватьИсключение "COM-урок требует серверного выполнения на Windows";
КонецЕсли;
Порты = Новый Массив;
Порты.Добавить(ПортАгента);
Порты.Добавить(ПортКластера);
Для Каждого Порт Из Порты Цикл
Если ТипЗнч(Порт) <> Тип("Число") Тогда
ВызватьИсключение "Порты должны быть числами";
КонецЕсли;
Если Порт <> Цел(Порт) ИЛИ Порт < 1 ИЛИ Порт > 65535 Тогда
ВызватьИсключение "Недопустимый порт локального стенда";
КонецЕсли;
КонецЦикла;
Если ТипЗнч(КлючПроцесса) <> Тип("Строка") Тогда
ВызватьИсключение "Ключ процесса должен быть строкой";
КонецЕсли;
УчётныеДанные = Новый Структура;
УчётныеДанные.Вставить("ИмяАгента", ИмяАгента);
УчётныеДанные.Вставить("ПарольАгента", ПарольАгента);
УчётныеДанные.Вставить("ИмяКластера", ИмяАдминистратораКластера);
УчётныеДанные.Вставить("ПарольКластера", ПарольАдминистратораКластера);
УчётныеДанные.Вставить("ИмяБазы", ИмяАдминистратораБазы);
УчётныеДанные.Вставить("ПарольБазы", ПарольАдминистратораБазы);
Для Каждого Поле Из УчётныеДанные Цикл
Если ТипЗнч(Поле.Значение) <> Тип("Строка") Тогда
ВызватьИсключение "Учебные учётные данные должны быть строками";
КонецЕсли;
Если ПустаяСтрока(Поле.Значение) Тогда
ВызватьИсключение "Введите все три непустые учебные пары учётных данных";
КонецЕсли;
КонецЦикла;
ЛокальноеИмя = НРег(ИмяКомпьютера());
АдресАгента = "tcp://127.0.0.1:" + Формат(ПортАгента, "ЧГ=0");
Соединитель = Новый COMОбъект("V85.COMConnector");
Агент = Соединитель.ConnectAgent(АдресАгента);
Если Агент.ConnectionString <> АдресАгента Тогда
ВызватьИсключение "Не совпала строка выбранного локального подключения";
КонецЕсли;
Агент.AuthenticateAgent(ИмяАгента, ПарольАгента);
Кластер = Неопределено;
СовпаденийКластера = 0;
Для Каждого Найденный Из Агент.GetClusters() Цикл
Если Найденный.ClusterName = "УчебныйКластер85"
И УчебныйЛокальныйУзел(Найденный.HostName, ЛокальноеИмя)
И Найденный.MainPort = ПортКластера Тогда
Кластер = Найденный;
СовпаденийКластера = СовпаденийКластера + 1;
КонецЕсли;
КонецЦикла;
Если СовпаденийКластера <> 1 Тогда
ВызватьИсключение "Нужен единственный собственный локальный УчебныйКластер85 с указанным портом";
КонецЕсли;
Агент.Authenticate(Кластер, ИмяАдминистратораКластера, ПарольАдминистратораКластера);
КраткаяБаза = Неопределено;
СовпаденийБазы = 0;
Для Каждого НайденнаяБаза Из Агент.GetInfoBases(Кластер) Цикл
Если НайденнаяБаза.Name = "УчебнаяБаза85" И НайденнаяБаза.Descr = "syntax-guide85:owned-com" Тогда
КраткаяБаза = НайденнаяБаза;
СовпаденийБазы = СовпаденийБазы + 1;
КонецЕсли;
КонецЦикла;
Если СовпаденийБазы <> 1 Тогда
ВызватьИсключение "Не найдена единственная собственная база с точным маркером описания";
КонецЕсли;
Каталог = Новый Массив;
Процесс = Неопределено;
СовпаденийПроцесса = 0;
Для Каждого НайденныйПроцесс Из Агент.GetWorkingProcesses(Кластер) Цикл
Если УчебныйЛокальныйУзел(НайденныйПроцесс.HostName, ЛокальноеИмя)
И НайденныйПроцесс.MainPort >= 1 И НайденныйПроцесс.MainPort <= 65535
И НайденныйПроцесс.MainPort = Цел(НайденныйПроцесс.MainPort)
И НЕ ПустаяСтрока(НайденныйПроцесс.PID) Тогда
Ключ = Формат(НайденныйПроцесс.MainPort, "ЧГ=0") + "|" + НайденныйПроцесс.PID;
Каталог.Добавить(Новый Структура("Ключ,Хост", Ключ, НайденныйПроцесс.HostName));
Если Ключ = КлючПроцесса Тогда
Процесс = НайденныйПроцесс;
СовпаденийПроцесса = СовпаденийПроцесса + 1;
КонецЕсли;
КонецЕсли;
КонецЦикла;
Если ПустаяСтрока(КлючПроцесса) Тогда
Возврат СериализоватьСвойСнимок(Новый Структура("УчебныеПроцессы", Каталог));
КонецЕсли;
Если СовпаденийПроцесса <> 1 Тогда
ВызватьИсключение "Нужен один живой локальный процесс с ключом из своего каталога";
КонецЕсли;
РабочееСоединение = Соединитель.ConnectWorkingProcess("tcp://127.0.0.1:" + Формат(Процесс.MainPort, "ЧГ=0"));
СовпаденийПолнойБазы = 0;
Для Каждого НайденнаяПолнаяБаза Из РабочееСоединение.GetInfoBases() Цикл
Если НайденнаяПолнаяБаза.Name = КраткаяБаза.Name И НайденнаяПолнаяБаза.Descr = КраткаяБаза.Descr Тогда
СовпаденийПолнойБазы = СовпаденийПолнойБазы + 1;
КонецЕсли;
КонецЦикла;
Если СовпаденийПолнойБазы <> 1 Тогда
ВызватьИсключение "Рабочий процесс не подтвердил свою учебную базу";
КонецЕсли;
РабочееСоединение.AddAuthentication(ИмяАдминистратораБазы, ПарольАдминистратораБазы);
База = Неопределено;
СовпаденийПослеВхода = 0;
Для Каждого НайденнаяПослеВхода Из РабочееСоединение.GetInfoBases() Цикл
Если НайденнаяПослеВхода.Name = "УчебнаяБаза85" И НайденнаяПослеВхода.Descr = "syntax-guide85:owned-com" Тогда
База = НайденнаяПослеВхода;
СовпаденийПослеВхода = СовпаденийПослеВхода + 1;
КонецЕсли;
КонецЦикла;
Если СовпаденийПослеВхода <> 1 Тогда
ВызватьИсключение "После аутентификации изменился выбор учебной базы";
КонецЕсли;
Снимок = Новый Структура;
Снимок.Вставить("База", База.Name);
Снимок.Вставить("ПроцессPID", Процесс.PID);
Снимок.Вставить("ПортПроцесса", Процесс.MainPort);
Менеджеры = Новый Массив;
СтрокиМенеджеров = Новый Массив;
Главных = 0;
Для Каждого Менеджер Из Агент.GetClusterManagers(Кластер) Цикл
Если Менеджер.MainManager <> 0 И Менеджер.MainManager <> 1 Тогда
ВызватьИсключение "Неожиданный числовой признак менеджера";
КонецЕсли;
Менеджеры.Добавить(Менеджер);
СтрокаМенеджера = Новый Структура;
СтрокаМенеджера.Вставить("Descr", Менеджер.Descr);
СтрокаМенеджера.Вставить("HostName", Менеджер.HostName);
СтрокаМенеджера.Вставить("MainManager", Менеджер.MainManager);
СтрокаМенеджера.Вставить("MainPort", Менеджер.MainPort);
СтрокаМенеджера.Вставить("PID", Менеджер.PID);
СтрокаМенеджера.Вставить("Главный", Менеджер.MainManager = 1);
СтрокиМенеджеров.Добавить(СтрокаМенеджера);
Если Менеджер.MainManager = 1 Тогда
Главных = Главных + 1;
КонецЕсли;
КонецЦикла;
Если Главных <> 1 Тогда
ВызватьИсключение "Снимок не подтвердил единственного главного менеджера";
КонецЕсли;
СтрокиСервисов = Новый Массив;
Для Каждого Сервис Из Агент.GetClusterServices(Кластер) Цикл
Если Сервис.MainOnly <> 0 И Сервис.MainOnly <> 1 Тогда
ВызватьИсключение "Неожиданный числовой признак поддержки сервиса";
КонецЕсли;
СтрокаСервиса = Новый Структура;
СтрокаСервиса.Вставить("Name", Сервис.Name);
СтрокаСервиса.Вставить("Descr", Сервис.Descr);
СтрокаСервиса.Вставить("MainOnly", Сервис.MainOnly);
Назначения = Новый Массив;
Для Каждого Назначенный Из Сервис.ClusterManagers Цикл
Назначение = Новый Структура;
Назначение.Вставить("PID", Назначенный.PID);
Назначение.Вставить("HostName", Назначенный.HostName);
Назначение.Вставить("MainPort", Назначенный.MainPort);
Назначение.Вставить("MainManager", Назначенный.MainManager);
Назначение.Вставить("ЕстьВКаталогеПоИдентичности", Менеджеры.Найти(Назначенный) <> Неопределено);
Назначение.Вставить("ДополнительныйПриMainOnly", Сервис.MainOnly = 1 И Назначенный.MainManager = 0);
Назначения.Добавить(Назначение);
КонецЦикла;
СтрокаСервиса.Вставить("КоличествоНазначений", Назначения.Количество());
СтрокаСервиса.Вставить("Менеджеры", Назначения);
СтрокиСервисов.Добавить(СтрокаСервиса);
КонецЦикла;
Снимок.Вставить("ГлавныхМенеджеров", Главных);
Снимок.Вставить("Менеджеры", СтрокиМенеджеров);
Снимок.Вставить("Сервисы", СтрокиСервисов);
Возврат СериализоватьСвойСнимок(Снимок);
КонецФункции
&НаСервереБезКонтекста
Функция СериализоватьСвойСнимок(Снимок)
Писатель = Новый ЗаписьJSON;
Писатель.УстановитьСтроку();
ЗаписатьJSON(Писатель, Снимок);
Возврат Писатель.Закрыть();
КонецФункции
&НаСервереБезКонтекста
Функция УчебныйЛокальныйУзел(ИмяУзла, ЛокальноеИмя)
Возврат НРег(ИмяУзла) = ЛокальноеИмя ИЛИ НРег(ИмяУзла) = "localhost" ИЛИ ИмяУзла = "127.0.0.1";
КонецФункции
Разбор по шагам
Проверить имя учебной конфигурации, типы портов и реквизитов до COM. Порты целые в диапазоне 1..65535; секреты не сериализуются.
ConnectAgent обращается только к 127.0.0.1. ConnectionString должна совпасть с построенной строкой без паролей. COM AuthenticateAgent принимает имя, пароль, в отличие от русскоязычного API ras.
Выбрать УчебныйКластер85 по точному имени, локальному хосту и порту менеджера. Отсутствие или неоднозначность не заменяются выбором первого элемента.
Проверить краткое описание УчебнаяБаза85 и точный маркер. Каталог живых локальных процессов позволяет взять настоящий порт|PID, а не подставить 1545 или придуманный PID.
ConnectWorkingProcess использует найденный динамический порт процесса, не порт агента или ras. До аутентификации базы читаются только Name и Descr.
AddAuthentication принимает только имя администратора базы и пароль, не дополнительный аргумент с именем базы. После него заново выбрать свою базу; полные поля читаются только далее.
В конце показать явно перечисленные скалярные поля JSON. После успеха или ошибки очищаются все три пароля и снимается флаг Занято.
Получить настоящие менеджеры и проверить признак 0/1; главный должен быть один. Каталог не является списком рабочих rphost.
Запомнить COM-объекты менеджеров в собственном Массиве, не конструировать неподдерживаемый менеджер по PID.
Получить реальные сервисы: Name — постоянный идентификатор, Descr — читаемое описание; на перевод Descr при выборе не опираться.
Для каждого ClusterManagers обойти фактический COMSafeArray. Идентичность проверяется через Массив.Найти по самому объекту менеджера.
MainOnly=1 означает поддержку только главным менеджером. Отдельный признак показывает дополнительного при этом условии для дальнейшего разбора, не переносит сервис.
Справка метода GetClusterServices разрешает несколько менеджеров у сервиса сеансовых данных, а страница ClusterManagers говорит об одном. Не навязываем всему массиву размер 1.
КоличествоНазначений — действительное количество элементов конкретного снимка. Два последовательных запроса не являются атомарным снимком.
Как проверить результат
ГлавныхМенеджеров=1; строки совпадают с консолью своего учебного кластера.
У назначений ЕстьВКаталогеПоИдентичности обычно Истина без параллельной смены топологии. Отсутствие фиксируется, а не заменяется совпадением одного PID.
Количество менеджеров у сервиса показано фактически; SessionDataService не ограничен искусственной проверкой «ровно один».
Ожидаемый результат
Получена карта сервис → назначенные менеджеры с проверкой идентичности и корректным разбором числовых признаков.
На что обратить внимание
COM здесь работает в серверном Windows-процессе. Loopback означает эту машину, не компьютер тонкого клиента; Linux и незарегистрированный соединитель этому уроку не соответствуют.
Присутствие учебных имён и маркера не заменяет права доступа. Не запускайте в рабочем кластере; отделите стенд от production.
Порт агента, порт менеджера кластера, порт ras и динамический порт рабочего процесса — разные значения.
COMSafeArray перечисляется циклом Для Каждого. Это не Массив 1С и не список UUID ras; не приписывайте ему методы или свойства другой коллекции.
Снимки и выбранные процессы могут устареть между запросами. После перезапуска повторите каталог; не пытайтесь автоматически завершить мешающий процесс.
Сырые COM-ошибки могут раскрывать чувствительные сведения. Разбирайте подготовку в отладчике своего стенда, не добавляйте ОписаниеОшибки в публичный JSON.
PID относится к процессу rmngr; это не номер соединения или сеанса и не порт.
Порт менеджера по этой странице может быть от 0 до 65535. Здесь его показывают как данные, не используют нулевой порт для подключения.
Карта не выполняет перераспределение сервисов, регистрацию или остановку менеджера.
Пример не запускался в вашей базе. Перед применением проверьте его в указанном учебном контексте.