К статье
Практический материал

Администрирование · 11 мин

Агент сервера 1С: за что отвечает и как его администрировать

Агент сервера 1С: назначение, процессы ragent и rmngr, порты, кластер, управление службой, типичные ошибки и способы диагностики.

Агент сервера 1С:Предприятие — это центральный процесс серверной инфраструктуры платформы, без которого кластер серверов просто не существует. Именно агент принимает подключения от консоли администрирования и клиентских приложений, ведёт реестр кластера и координирует работу остальных процессов. Понимание его роли необходимо любому администратору, который разворачивает клиент-серверный вариант 1С или диагностирует сбои доступа к информационным базам.

Многие проблемы, которые выглядят как «1С не запускается», на деле сводятся к остановленной службе агента, занятому порту или повреждённому реестру кластера. Чтобы быстро локализовать причину, нужно знать, какие процессы за что отвечают, какие порты используются и где хранятся служебные файлы.

Что такое агент сервера 1С и где он работает

Агент сервера 1С — это исполняемый модуль ragent, который устанавливается вместе с компонентой «Сервер 1С:Предприятия». В ОС Windows он обычно работает как служба «Агент сервера 1С:Предприятия», в Linux — как демон, запускаемый скриптом или через systemd. Агент стартует первым и поднимает остальную инфраструктуру кластера.

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

Физически агент хранит данные кластера в каталоге srvinfo (в Windows обычно в профиле служебного пользователя, в Linux — в домашнем каталоге пользователя, от имени которого запущен демон). Там находятся файлы реестра, список информационных баз, настройки кластера и журналы.

Основные функции агента

Первая функция — приём и маршрутизация подключений. Когда клиентское приложение обращается к серверу 1С, оно сначала соединяется с агентом. Агент возвращает клиенту адрес подходящего рабочего процесса, после чего основной обмен данными идёт уже напрямую с ним.

Вторая функция — ведение реестра кластера. В реестре хранятся: список зарегистрированных информационных баз с параметрами подключения к СУБД, настройки кластера, список рабочих серверов, назначенные требования функциональности, зарегистрированные администраторы. Потеря или повреждение реестра означает, что кластер «забывает» все базы, хотя сами данные в СУБД остаются нетронутыми.

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

Четвёртая функция — обслуживание консоли администрирования. Все операции в консоли кластеров (добавление баз, изменение свойств, просмотр сеансов) выполняются через подключение к агенту.

Процессы кластера: ragent, rmngr, rphost

Чтобы правильно диагностировать проблемы, важно различать три ключевых процесса сервера 1С. Они работают совместно, но отвечают за разные задачи.

ПроцессРольКоличество
ragentАгент: приём подключений, реестр кластера, управление процессамиОдин на сервер (на порт кластера)
rmngrМенеджер кластера: распределение нагрузки, фоновые задания, блокировкиОдин или несколько на кластер
rphostРабочий процесс: исполнение кода, обращения к СУБД, сеансы пользователейНесколько, по нагрузке

Типичная схема обращения выглядит так: клиент подключается к ragent, получает адрес rphost и работает с ним. Менеджер кластера rmngr при этом координирует распределение соединений между рабочими процессами и управляет сервисами сеансовых данных и фоновых заданий.

Сетевые порты агента сервера

Агент использует стандартный диапазон портов, который важно открыть на межсетевых экранах между клиентами, сервером 1С и сервером СУБД. По умолчанию применяются следующие значения.

ПортНазначение
1540Порт агента кластера (подключения клиентов и консоли)
1541Порт менеджера кластера
1560–1591Динамический диапазон рабочих процессов rphost

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

cmd
netstat -ano | findstr 1540

Команда выше покажет, слушает ли какой-либо процесс порт агента на сервере. Если строки нет — агент не запущен или завершился с ошибкой. Для проверки доступности порта с клиентской машины удобно использовать Test-NetConnection servername -Port 1540 в PowerShell.

Управление службой агента

В Windows агент управляется как обычная служба: через оснастку «Службы», командную строку или PowerShell. Перезапуск службы агента приводит к перезапуску всего кластера, поэтому выполнять его следует только вне рабочего времени или после предупреждения пользователей.

Перезапуск агента сервера 1С в Windows
  1. 1
    Предупредите пользователей и дождитесь завершения активных сеансов либо завершите их через консоль кластера.
  2. 2
    Откройте оснастку services.msc и найдите службу «Агент сервера 1С:Предприятия» нужной версии.
  3. 3
    Выполните перезапуск службы или команды net stop / net start с точным именем службы.
  4. 4
    Проверьте, что процессы ragent, rmngr и rphost появились в диспетчере задач.
  5. 5
    Откройте консоль кластера и убедитесь, что информационные базы видны и сеансы устанавливаются.

В Linux агент обычно запускается скриптом из состава поставки или юнитом systemd. Управление выполняется командами вида systemctl start srv1cv8 (имя юнита зависит от способа установки). Перед перезапуском убедитесь, что у служебного пользователя есть права на каталог srvinfo и логи.

Реестр кластера и каталог srvinfo

Каталог srvinfo — это «память» кластера. В нём находятся файлы реестра (в том числе список информационных баз и их параметры), журналы регистрации кластера и служебные данные. Путь к каталогу задаётся параметром запуска агента -d и отображается в свойствах службы.

Типовая ситуация: после переустановки сервера или смены служебного пользователя кластер стартует «пустым» — консоль открывается, но информационных баз нет. Чаще всего причина в том, что агент начал использовать новый пустой каталог srvinfo. Решение — указать в параметрах запуска путь к прежнему каталогу либо создать базы в кластере заново, привязав их к существующим базам СУБД.

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

Типичные ошибки администраторов
01
Удаление srvinfo для «чистки» без резервной копии — кластер теряет список баз, приходится регистрировать их заново.
02
Запуск службы агента от имени пользователя без прав на каталог srvinfo и логи — служба падает сразу после старта.
03
Закрытый порт 1540 на брандмауэре — клиенты не видят сервер, хотя служба работает.
04
Два агента разных версий на одних портах — конфликт портов и непредсказуемое поведение кластера.
05
Перезапуск агента в разгар рабочего дня — обрыв сеансов и потеря несохранённых данных пользователей.

Диагностика типичных проблем

Если клиенты сообщают об ошибке «Ошибка соединения с сервером 1С:Предприятия», действуйте последовательно: сначала проверьте, запущена ли служба агента, затем — слушает ли процесс порт 1540, затем — доступен ли порт с клиентской машины, и только после этого разбирайтесь с кластером и базами.

Если служба не стартует, смотрите журналы: системный журнал Windows (или journalctl в Linux) и технологический журнал 1С, если он настроен. Частые причины — занятый порт, повреждённый реестр кластера, недостаток прав у служебной учётной записи.

Маршрут решения

Как выбрать действие

Служба агента остановленаЗапустите службу и проверьте появление процессов ragent, rmngr, rphost
Служба работает, но порт 1540 не слушаетсяПроверьте журналы на ошибки старта и конфликт портов с другими приложениями
Порт слушается, но клиенты не подключаютсяПроверьте брандмауэр и сетевую доступность порта с клиентской машины
Кластер открывается, но список баз пустПроверьте параметр -d службы: агент, скорее всего, использует другой каталог srvinfo
Базы видны, но сеансы не устанавливаютсяПроверяйте рабочие процессы rphost, доступность СУБД и параметры самой базы
Контрольные точки

Как проверить результат

Процессы в диспетчере задач
Норма

Присутствуют ragent, rmngr и хотя бы один rphost

Тревожный признак

Есть только ragent или процессы появляются и исчезают

Прослушивание порта 1540
Норма

netstat показывает LISTENING на порту агента

Тревожный признак

Порт не слушается или занят другим приложением

Консоль кластера
Норма

Кластер открывается, базы и сеансы отображаются

Тревожный признак

Ошибка подключения к кластеру или пустой список баз

Подключение клиента
Норма

Клиент входит в базу без ошибок соединения

Тревожный признак

Ошибка соединения на этапе обращения к серверу

Ограничения и особенности

Агент сам по себе не исполняет прикладной код и не работает с данными — за это отвечают рабочие процессы. Поэтому «тормоза» базы редко связаны с агентом: обычно узкое место — rphost, СУБД или дисковая подсистема.

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

Отдельно учитывайте, что файловый вариант работы 1С агента сервера не использует вовсе — там клиенты обращаются к файлу базы напрямую. Агент нужен только в клиент-серверной архитектуре.

Итог

Что важно запомнить

Агент сервера 1С (ragent) — управляющий процесс кластера: принимает подключения, хранит реестр в srvinfo, запускает rmngr и rphost. Ключевой порт — 1540. Перезапуск агента обрывает все сеансы, а файлы srvinfo нельзя трогать при работающей службе. Диагностику начинайте со службы, затем порта, затем сети.

Частые вопросы

Чем агент сервера 1С отличается от сервера 1С?

«Сервер 1С» — это вся серверная инфраструктура: агент, менеджер кластера и рабочие процессы. Агент — только один из процессов, но управляющий: без него остальные компоненты кластера не функционируют.

Можно ли запустить несколько агентов на одном компьютере?

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

Что будет, если удалить каталог srvinfo?

Кластер потеряет реестр: исчезнет список информационных баз и настройки. Данные в СУБД сохранятся, базы можно зарегистрировать в кластере заново, но все настройки придётся восстанавливать вручную.

Как узнать, какой каталог srvinfo использует агент?

В Windows откройте свойства службы агента и посмотрите путь запуска — там указан параметр -d с каталогом. В Linux смотрите параметры запуска демона или конфигурацию systemd-юнита.

Почему после перезагрузки сервера базы «пропали»?

Чаще всего агент стартовал с другим каталогом srvinfo или от имени другого пользователя, для которого создался новый пустой каталог. Сверьте параметр -d в свойствах службы с фактическим расположением реестра.

Нужно ли открывать порты 1560–1591 наружу?

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