Как изменить службу агента сервера 1С

Служба агента сервера 1С (1C:Enterprise Server Agent) — ключевой компонент клиент-серверной архитектуры: именно она управляет рабочими процессами, кластерами и соединениями с информационными базами. Изменять её параметры приходится при переустановке платформы, переносе сервера на другую машину, смене учётной записи, с которой работает служба, или при необходимости использовать нестандартный порт.

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

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

Какие параметры службы агента сервера 1С можно изменить

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

Чаще всего администраторы меняют учётную запись, под которой работает служба, сетевой порт агента (по умолчанию 1540) и путь к каталогу служебных файлов кластера srvinfo. Реже требуется изменить имя службы, например, когда на одном сервере работают несколько экземпляров агента разных версий платформы.

Как узнать текущие параметры службы

Откройте оснастку «Службы» (services.msc) и найдите службу с именем вида «Агент сервера 1С:Предприятия 8.3» или «1C:Enterprise 8.3 Server Agent». Двойной клик по службе покажет путь к исполняемому файлу вместе с параметрами запуска в поле «Исполняемый файл».

Те же сведения хранятся в реестре по пути HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\ в разделе с именем службы. Параметр ImagePath содержит полную командную строку запуска ragent.exe со всеми ключами — именно её нужно скопировать и сохранить перед изменениями.

sc qc "1C:Enterprise 8.3 Server Agent (x86-64)"

Команда sc qc выводит конфигурацию службы, включая тип запуска и учётную запись, а sc query — текущее состояние (работает или остановлена). Это удобно для проверки из командной строки без открытия графической оснастки.

Изменение учётной записи службы

Смена учётной записи требуется, когда агент должен работать от доменного пользователя — например, для доступа к сетевым ресурсам или для аутентификации на SQL-сервере через Windows-авторизацию. Откройте свойства службы, перейдите на вкладку «Вход в систему», укажите новую учётную запись в формате ДОМЕН\Пользователь и пароль.

Новой учётной записи необходимо выдать полные права на каталог srvinfo (обычно внутри каталога установки платформы) и на каталоги с временными файлами. Если агент обращается к СУБД по Windows-аутентификации, пользователь должен иметь соответствующие права на SQL-сервере.

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

Изменение порта и параметров запуска агента

Порт агента задаётся ключом -port в строке запуска ragent.exe. Чтобы его изменить, остановите службу, откройте реестр, найдите раздел службы и отредактируйте значение ImagePath, заменив номер порта на нужный. Учтите, что от порта агента зависят порты рабочих процессов (по умолчанию диапазон 1560–1591) и порт менеджера кластера (1541) — их тоже можно задать ключами -rangep и -port соответствующих компонентов.

Другие полезные ключи строки запуска: -d задаёт каталог srvinfo, а параметры отладки включают запись технологического журнала. Добавляйте ключи аккуратно, сохраняя синтаксис: каждый параметр отделяется пробелом, пути с пробелами заключаются в кавычки.

1. 1
   Остановите службу агента сервера 1С
2. 2
   Сохраните текущее значение ImagePath из реестра
3. 3
   Отредактируйте ImagePath, указав новый порт в ключе -port
4. 4
   Откройте новый порт в брандмауэре Windows
5. 5
   Запустите службу и проверьте, что порт прослушивается (netstat -ano)
6. 6
   Переподключите консоль администрирования к серверу с новым портом

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

Перерегистрация и переустановка службы

Если параметров слишком много или служба повреждена, проще удалить её и зарегистрировать заново. Удаление выполняется командой sc delete "имя_службы" при остановленной службе. Затем служба регистрируется заново запуском ragent.exe с ключом -instsrvc и нужными параметрами.

"C:\Program Files\1cv8\8.3.xx.xxxx\bin\ragent.exe" -instsrvc -port 1540 -d "C:\Program Files\1cv8\srvinfo" -usr "ДОМЕН\svc1c" -pwd "Пароль"

При перерегистрации важно указать тот же каталог srvinfo, что использовался раньше, — в нём хранится реестр кластера: список баз, настройки рабочих процессов, администраторы. Если указать новый пустой каталог, кластер создастся «с нуля», и все регистрации баз придётся восстанавливать вручную.

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

Проверка результата и типичные ошибки

После любых изменений проверьте три вещи: служба запущена и не падает (оснастка «Службы» и «Просмотр событий»), нужный порт прослушивается процессом ragent.exe (команда netstat -ano | find "1540"), кластер доступен в консоли администрирования и содержит все базы.

Если служба не запускается, первым делом смотрите журнал событий Windows (раздел «Система» и «Приложение»): там фиксируются ошибки запуска служб с кодами причин. Синтаксическая ошибка в ImagePath, отсутствие файла ragent.exe по указанному пути и недостаток прав — три самые частые причины.

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