Как установить агент сервера 1С: полное руководство

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

Установка агента обычно занимает 10–20 минут, но ошибки на этом этапе — неверная разрядность, занятые порты, запуск под неподходящей учётной записью — приводят к ситуации, когда служба вроде бы есть, а кластер недоступен. Ниже разобран полный цикл: от подготовки сервера до проверки работоспособности, отдельно для Windows и Linux.

Что такое агент сервера 1С и когда его нужно устанавливать

Агент сервера — исполняемый процесс ragent (в Windows — ragent.exe), который входит в состав компоненты «Сервер 1С:Предприятия». Он управляет кластером: хранит реестр кластера, запускает рабочие процессы rphost, менеджеры кластера rmngr и обеспечивает обмен данными между ними и клиентами. Установка отдельно от остального сервера не предусмотрена — агент ставится вместе с серверными компонентами платформы.

Устанавливать сервер 1С и, соответственно, агент нужно в клиент-серверном режиме работы — когда базы размещены в СУБД (PostgreSQL, MS SQL Server, Oracle, IBM Db2). Если компания работает в файловом режиме, агент сервера не требуется вовсе. Также сервер нужен при переходе с файлового режима на клиент-серверный и при выносе сервера 1С на отдельную машину от СУБД.

Подготовка: версия платформы, разрядность и права

Перед установкой определите три вещи. Во-первых, версию платформы: сервер и клиенты должны совпадать по версии, иначе клиенты не смогут подключиться к информационным базам. Во-вторых, разрядность: 64-разрядный сервер снимает ограничение на память рабочих процессов и является предпочтительным для нагруженных систем; 32-разрядный вариант ограничен примерно 2 ГБ на процесс и подходит только для небольших внедрений или старых конфигураций. В-третьих, учётную запись, под которой будет работать служба агента.

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

Установка агента на Windows

Запустите установщик дистрибутива «Сервер 1С:Предприятия» от имени администратора. В окне выбора компонентов отметьте «Сервер 1С:Предприятия» и, если планируете администрировать кластер с этой же машины, «Администрирование сервера 1С:Предприятия» (консоль кластера). Модули расширения веб-сервера нужны только при публикации баз через веб-сервер.

На шаге настройки службы оставьте включённой опцию «Установить сервер 1С:Предприятия как службу Windows» — это и есть регистрация агента. Укажите учётную запись и пароль пользователя службы. После завершения установки служба появится в оснастке services.msc под именем вида «Агент сервера 1С:Предприятия 8.3» и запустится автоматически.

1. 1
   Запустите setup.exe дистрибутива сервера от имени администратора
2. 2
   Выберите компоненты: сервер и консоль администрирования
3. 3
   Оставьте установку как службы Windows, укажите учётную запись USR1CV8 или свою
4. 4
   Завершите установку и убедитесь, что служба агента запущена
5. 5
   Откройте консоль кластера и проверьте наличие локального кластера

Если агент нужно установить не как службу, а запускать как приложение (например, для отладки), используйте команду ragent.exe с параметрами из каталога bin платформы. Для повторной регистрации службы вручную применяется та же команда с ключом -instsrvc, а для удаления — с ключом -rmsrvc.

"C:\Program Files\1cv8\8.3.XX.XXXX\bin\ragent.exe" -instsrvc -usr .\USR1CV8 -pwd ПарольПользователя

Установка агента на Linux

На Linux-дистрибутивах с поддержкой deb или rpm сервер ставится из пакетов: сначала общие компоненты (common), затем сервер (server), при необходимости — клиент и дополнительные пакеты. Порядок важен, потому что серверный пакет зависит от общего. Установка выполняется с правами root через стандартный менеджер пакетов.

dpkg -i common-1c_*.deb server-1c_*.deb
# или для rpm-систем:
rpm -ivh common-1c-<em>.rpm server-1c-</em>.rpm

После установки агент регистрируется как служба srv1cv8 (в новых версиях — srv1cv8-<номер версии>). Управление осуществляется через systemd: запуск, остановка и проверка статуса выполняются стандартными командами systemctl. Служба работает от пользователя usr1cv8, которому должны принадлежать каталоги платформы, указанные в параметрах запуска.

systemctl start srv1cv8
systemctl enable srv1cv8
systemctl status srv1cv8

Проверьте также локализацию системы: для корректной работы с СУБД и сортировки в базах рекомендуется установленная русская локаль (например, ru_RU.UTF-8). Отсутствие нужной локали — частая причина ошибок при создании информационных баз на Linux-сервере.

Порты, параметры запуска и каталог srvinfo

По умолчанию агент использует порт 1540 для подключений консоли кластера, кластер работает на порту 1541, а рабочие процессы занимают диапазон 1560–1591. Эти порты должны быть открыты в брандмауэре между сервером 1С, клиентскими машинами и сервером СУБД. Если порт 1540 занят другим приложением, агент не стартует — в журнале службы появится ошибка привязки сокета.

Ключевые параметры командной строки агента: -port (порт агента), -regport (порт кластера), -range (диапазон портов рабочих процессов), -d (путь к каталогу srvinfo с реестром кластера), -debug (режим отладки). Менять их имеет смысл, только если на одной машине работает несколько агентов разных версий — тогда каждому назначают свои порты и свой каталог srvinfo.

Проверка работоспособности после установки

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

Дополнительно проверьте прослушивание портов: на Windows командой netstat -an с фильтром по 1540, на Linux — ss -tlnp. Финальный шаг — создать тестовую информационную базу через консоль кластера или клиентское приложение и подключиться к ней. Успешное создание базы подтверждает, что связка «агент — СУБД» настроена правильно.

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

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

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

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