Как зарегистрировать службу 1С: регистрация агента сервера

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

Регистрация выполняется штатной утилитой ragent.exe из каталога установленной платформы с набором параметров командной строки. Процедура занимает несколько минут, но требует прав администратора и аккуратности: ошибка в параметрах приведёт к тому, что служба не запустится или кластер окажется недоступен для пользователей.

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

Когда требуется регистрация службы вручную

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

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

Перед началом убедитесь, что у вас есть права локального администратора на сервере и известна версия установленной платформы. Также определите, какая учётная запись будет использоваться для службы: встроенная USR1CV8 (создаётся установщиком) или доменная учётная запись с необходимыми правами.

Подготовка: что проверить перед регистрацией

Первый шаг — найти исполняемый файл агента. Он находится в каталоге установки платформы, типовой путь выглядит так: C:\Program Files\1cv8\<номер версии>\bin\ragent.exe. Если на сервере стоит несколько версий, убедитесь, что используете ragent.exe нужной версии — служба должна соответствовать версии, под которой работают базы.

Второй шаг — проверить, не зарегистрирована ли служба уже. Откройте оснастку «Службы» (services.msc) и поищите записи вида «Агент сервера 1С:Предприятия 8.3.x». Повторная регистрация службы с теми же портами приведёт к конфликту: вторая служба не сможет занять порт и не запустится.

Третий шаг — подготовить учётные данные. Если используется учётная запись USR1CV8, пароль задавался при установке. Если планируется доменная учётная запись, убедитесь, что она имеет права на каталог кластера, на каталог установки платформы и право «Вход в качестве службы».

Команда регистрации службы ragent

Регистрация выполняется утилитой ragent.exe с ключом -instsrvc и набором параметров. Общий вид команды:

ragent.exe -instsrvc -usr ".\USR1CV8" -pwd "Пароль" -d "C:\Program Files\1cv8\srvinfo" -port 1540 -regport 1541 -range 1560:1591

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

Параметры команды и их назначение

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

• -instsrvc — режим регистрации службы (для удаления используется -rmsrvc);
• -usr — имя учётной записи, от имени которой работает служба; для локальной записи указывается с точкой: .\USR1CV8;
• -pwd — пароль этой учётной записи;
• -d — каталог реестра кластера (srvinfo), где хранятся списки баз и настройки; по умолчанию создаётся в каталоге установки;
• -port — порт агента сервера, стандартно 1540;
• -regport — порт реестра кластера, стандартно 1541;
• -range — диапазон портов рабочих процессов, стандартно 1560:1591;
• -debug — необязательный параметр, включающий отладочный режим.

Если на сервере уже есть кластер на стандартных портах, для второй службы выберите другие значения — например, порт агента 2540, реестра 2541 и диапазон 2560:2591. Конфликт портов — самая частая причина того, что служба регистрируется, но не запускается.

Сравнение вариантов

Учётная запись USR1CV8

Создаётся установщиком, подходит для большинства случаев; ограничение — локальная запись, не имеет доступа к сетевым ресурсам других серверов

Доменная учётная запись

Нужна, если агенту требуется доступ к сетевым каталогам или СУБД с Windows-аутентификацией; требует выдачи прав и контроля срока действия пароля

Проверка результата после регистрации

После регистрации и запуска службы проверьте три вещи. Во-первых, состояние службы в оснастке services.msc — она должна быть в статусе «Выполняется». Если служба останавливается сразу после запуска, откройте журнал событий Windows (Просмотр событий → Журналы Windows → Приложение) и найдите сообщения от агента сервера — там обычно указана причина.

Во-вторых, проверьте, что порты прослушиваются. Команда netstat -ano | find "1540" должна показать, что порт агента находится в состоянии LISTENING. Если порт не занят — служба фактически не работает.

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

Контрольные точки

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

Статус службы в services.msc

Норма

Состояние «Выполняется», тип запуска «Автоматически»

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

Служба остановлена или завершается сразу после старта

Порт агента через netstat

Норма

Порт 1540 в состоянии LISTENING

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

Порт отсутствует в выводе или занят другим процессом

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

Норма

Видны рабочие серверы, процессы и базы

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

Кластер пуст или сервер не добавляется с ошибкой соединения

Типичные ошибки и их устранение

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

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

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

Удаление и перерегистрация службы

Если службу нужно удалить — например, при снятии старой версии платформы — используется та же утилита с ключом -rmsrvc:

ragent.exe -rmsrvc

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

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

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

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

Можно ли зарегистрировать службу, если сервер 1С уже установлен как приложение?

Да. Достаточно выполнить команду ragent.exe -instsrvc с нужными параметрами — отдельная переустановка платформы не требуется. После регистрации агент будет запускаться автоматически вместе с Windows, а запуск в режиме приложения больше не понадобится.

Что делать, если служба зарегистрирована, но не запускается?

Сначала откройте журнал событий Windows и найдите сообщения об ошибке. Чаще всего причины три: неверный пароль учётной записи, занятый порт или отсутствие прав на каталог srvinfo. Исправьте причину, затем повторите запуск службы.

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

Зарегистрируйте вторую службу с уникальными портами: например, порт агента 2540, порт реестра 2541 и диапазон рабочих процессов 2560:2591. Также укажите отдельный каталог srvinfo. Каждая служба будет обслуживать свой независимый кластер.

Потеряются ли базы при перерегистрации службы?

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

Нужны ли права администратора домена для регистрации службы?

Нет, достаточно прав локального администратора сервера. Права доменного администратора могут понадобиться только для создания или настройки доменной учётной записи, от имени которой будет работать служба.

Как узнать, под какой версией платформы зарегистрирована служба?

Откройте свойства службы в services.msc и посмотрите поле «Исполняемый файл» — путь к ragent.exe содержит номер версии платформы. Либо выполните в командной строке sc qc "имя службы" и посмотрите параметр BINARY_PATH_NAME.