Администрирование · 10 мин
Агент сервера 1С: какой файл запускает службу
Разбираем, какой файл отвечает за агент сервера 1С: ragent.exe, его расположение, параметры запуска, проверку службы и типичные ошибки администраторов.
За работу сервера 1С:Предприятие отвечает исполняемый файл ragent.exe — это и есть агент сервера 1С. Именно этот процесс запускается как служба Windows «Агент сервера 1С:Предприятия» (или демон в Linux) и принимает подключения от клиентов, консоли кластера и других компонентов. Понимание того, какой файл запускается, где он лежит и с какими параметрами работает, нужно при диагностике сбоев службы, переносе сервера и обновлении платформы.
Файл ragent.exe устанавливается вместе с компонентой «Сервер 1С:Предприятия» и находится в каталоге конкретной версии платформы. Типичный путь в Windows: C:\Program Files\1cv8\<номер версии>\bin\ragent.exe, в Linux — /opt/1cv8/x86_64/<номер версии>/ragent. Поскольку на одном сервере может стоять несколько версий платформы, важно проверять, из какого каталога реально запущен процесс, а не предполагать путь «по памяти».
Какой файл является агентом сервера 1С
Агент сервера 1С — это центральный процесс кластера серверов. Исполняемый файл называется ragent.exe в Windows и ragent в Linux. Он входит в состав дистрибутива «Сервер 1С:Предприятия» и не устанавливается отдельно. Если на машине развёрнут только клиент 1С, файла ragent там не будет.
Агент выполняет несколько функций: ведёт реестр кластера (список информационных баз, рабочих процессов, сеансов), принимает подключения консоли администрирования и передаёт задания рабочим процессам rphost.exe. Без запущенного агента кластер не работает, даже если все остальные файлы на месте.
Кроме ragent.exe, в каталоге bin лежат и другие исполняемые файлы сервера, которые часто путают с агентом. Различать их важно, чтобы не перезапускать и не диагностировать «не тот» процесс.
| Файл | Роль | Когда запускается |
|---|---|---|
| ragent.exe | Агент кластера, главный процесс | Как служба, постоянно |
| rphost.exe | Рабочий процесс, исполняет код сервера | Автоматически агентом при нагрузке |
| rmngr.exe | Менеджер кластера | Автоматически агентом |
| ragent.exe с ключом -srvc | Режим службы Windows | При старте службы |
Где находится файл ragent.exe
В Windows стандартный путь установки — C:\Program Files\1cv8\<версия>\bin\ragent.exe для 64-разрядной платформы. Для 32-разрядной версии на 64-разрядной ОС путь может быть C:\Program Files (x86)\1cv8\.... Номер версии выглядит как четыре группы цифр, например 8.3.22.1750, и у каждой установленной версии свой каталог.
В Linux файл располагается по адресу /opt/1cv8/x86_64/<версия>/ragent. Рядом, в том же каталоге, лежат конфигурационные файлы и утилиты, например скрипты управления демоном. Права на запуск файла должны быть у пользователя, от имени которого работает сервер 1С (обычно usr1cv8).
Чтобы узнать точный путь запущенного агента, не перебирая каталоги вручную, используйте диспетчер задач Windows: на вкладке «Подробности» найдите ragent.exe, щёлкните правой кнопкой и выберите «Открыть расположение файла». В Linux помогает команда ps aux | grep ragent — она покажет полный путь к запущенному процессу и его параметры.
ps aux | grep ragentКак проверить, какой файл запускает служба
Служба Windows «Агент сервера 1С:Предприятия» привязана к конкретному файлу ragent.exe из конкретного каталога версии. Если на сервере обновляли платформу, служба могла остаться привязанной к старой версии — это частая причина странных сбоев после обновления.
Чтобы проверить привязку, откройте «Службы» (services.msc), найдите службу агента сервера 1С, откройте её свойства и посмотрите поле «Исполняемый файл». Там будет полная строка запуска с путём и параметрами. Альтернатива — команда в командной строке:
sc qc "1C:Enterprise 8.3 Server Agent"В выводе команды смотрите строку BINARY_PATH_NAME. Она покажет, какой именно ragent.exe стартует службой, с какими ключами и из какого каталога. Если путь указывает на удалённую версию платформы, служба не запустится с ошибкой «файл не найден».
- 1Откройте services.msc и найдите службу агента сервера 1С
- 2Откройте свойства службы и скопируйте строку исполняемого файла
- 3Проверьте, существует ли указанный файл ragent.exe по этому пути
- 4Сверьте версию в пути с актуальной установленной версией платформы
- 5При несовпадении перерегистрируйте службу с правильным путём
Параметры запуска агента
Строка запуска ragent.exe содержит ключи, которые определяют поведение агента. Типичная строка выглядит так: "C:\Program Files\1cv8\8.3.22.1750\bin\ragent.exe" -srvc -agent -regport 1541 -port 1540 -range 1560:1591 -d "C:\Program Files\1cv8\srvinfo".
Ключ -srvc означает запуск в режиме службы Windows, -agent — режим агента кластера. Параметры -port и -regport задают порты агента (по умолчанию 1540 и 1541), -range — диапазон портов рабочих процессов. Ключ -d указывает каталог реестра кластера — там хранятся файлы с описанием информационных баз и настроек.
Каталог реестра кластера заслуживает отдельного внимания: его потеря или повреждение означает, что кластер «забудет» все зарегистрированные базы, хотя сами базы данных в СУБД останутся целыми. Перед любыми экспериментами со службой делайте копию этого каталога.
Типичные ошибки и их причины
Самая распространённая проблема — служба не запускается после обновления платформы. Причина почти всегда в том, что обновление установило новую версию рядом со старой, а служба по-прежнему ссылается на старый ragent.exe, который мог быть удалён. Решение — перерегистрировать службу с актуальным путём.
Вторая типичная ситуация — конфликт портов. Если на одном сервере запущено два кластера (например, тестовый и рабочий) с одинаковыми портами 1540/1541, второй агент не стартует. Каждому кластеру нужен свой набор портов, например 2540/2541 для второго экземпляра.
Третья группа ошибок связана с правами. Учётная запись, от имени которой работает служба (по умолчанию создаётся пользователь USR1CV8), должна иметь полный доступ к каталогу реестра кластера и право «Вход в качестве службы». После ручной смены пользователя службы эти права часто забывают выдать.
Как перерегистрировать службу на нужный файл
Если служба указывает на несуществующий или устаревший ragent.exe, службу нужно удалить и зарегистрировать заново. Делается это от имени администратора в командной строке. Сначала остановите службу, затем удалите её командой sc delete с точным именем службы.
После удаления зарегистрируйте службу заново, указав правильный путь к ragent.exe актуальной версии и все нужные параметры, включая каталог реестра кластера. В дистрибутиве платформы есть также утилита установки сервера, которая выполняет регистрацию автоматически при выборе соответствующего режима установки.
После перерегистрации запустите службу и проверьте результат: служба должна быть в состоянии «Работает», порты 1540 и 1541 — прослушиваться (команда netstat -an | find "154"), а консоль администрирования — подключаться к кластеру и показывать список баз.
Как проверить результат
Служба запущена, тип запуска — автоматически
Служба остановлена или завершается сразу после старта
Порты в состоянии LISTENING в выводе netstat
Порты не прослушиваются — агент не работает
Консоль видит кластер и список информационных баз
Ошибка подключения или пустой список баз
Путь ведёт к ragent.exe актуальной версии
Путь указывает на удалённую или старую версию
Особенности для Linux и отличия от Windows
В Linux агент сервера 1С запускается как демон, обычно через systemd-юнит или init-скрипт, поставляемый с дистрибутивом платформы. Исполняемый файл без расширения — /opt/1cv8/x86_64/<версия>/ragent. Логика параметров та же: порты, диапазон рабочих портов, каталог реестра кластера (по умолчанию /home/usr1cv8/.1cv8/1C/1cv8 или каталог, заданный ключом -d).
Проверка работающего агента выполняется командами systemctl status для соответствующего юнита или ps aux | grep ragent. Права на файлы критичны: владельцем каталога реестра и рабочих каталогов должен быть пользователь, под которым стартует демон. Ошибки прав — первая причина отказа запуска сервера 1С в Linux.
Частые вопросы
Чем ragent.exe отличается от rphost.exe?
ragent.exe — агент кластера, управляющий процесс, который работает постоянно как служба. rphost.exe — рабочие процессы, которые агент запускает автоматически для исполнения кода серверных вызовов; их может быть несколько, и они создаются и завершаются динамически.
Можно ли запустить агент сервера 1С не как службу?
Да, ragent.exe можно запустить из командной строки как обычное приложение без ключа -srvc — это удобно для диагностики, потому что сообщения об ошибках выводятся в консоль. Для постоянной работы в продуктивной среде используется режим службы.
Что делать, если служба агента не запускается после обновления платформы?
Проверьте путь к исполняемому файлу в свойствах службы — скорее всего, он указывает на старую версию. Перерегистрируйте службу с путём к ragent.exe новой версии, сохранив прежний каталог реестра кластера, чтобы список баз не потерялся.
Где хранятся настройки кластера, который обслуживает агент?
В каталоге реестра кластера, заданном ключом -d при запуске (в Windows обычно C:\Program Files\1cv8\srvinfo). Там лежат файлы с описанием информационных баз, рабочих серверов и настроек. Этот каталог нужно включать в резервное копирование.
Какие порты использует агент сервера 1С по умолчанию?
Порт агента — 1540, порт менеджера кластера (реестра) — 1541, диапазон рабочих процессов — 1560–1591. Эти порты должны быть открыты в брандмауэре между сервером 1С, клиентами и сервером СУБД.
Можно ли на одном сервере запустить два агента разных версий?
Можно, но каждому кластеру нужен собственный набор портов и отдельный каталог реестра. Например, второй агент регистрируют с портами 2540/2541 и своим каталогом srvinfo, иначе возникнет конфликт портов.
Что важно запомнить
Агент сервера 1С — это файл ragent.exe (ragent в Linux) из каталога bin конкретной версии платформы. Проверяйте путь к файлу в свойствах службы, а перед изменениями делайте копию каталога реестра кластера.