Администрирование · 11 мин
Как настроить агент сервера 1С на сервере
Как настроить агент сервера 1С:Предприятие: установка, служба, порты, параметры запуска, кластер серверов, типичные ошибки и проверка работоспособности.
Агент сервера 1С:Предприятие — это центральный процесс клиент-серверной архитектуры, который управляет кластером, распределяет нагрузку между рабочими процессами и обслуживает подключения клиентов. Без корректно настроенного агента не запустится ни одна информационная база в клиент-серверном режиме. Ошибки настройки проявляются как недоступность кластера, отказы в подключении пользователей и падение производительности.
Настройка агента включает несколько этапов: установка компонентов сервера 1С, регистрация службы, выбор портов, задание параметров запуска и проверка работоспособности через консоль кластера. Порядок действий зависит от операционной системы и от того, разворачивается ли новый сервер или перенастраивается существующий.
Материал ориентирован на администраторов, которые впервые разворачивают сервер 1С или переносят его на новое оборудование. Описаны действия для Windows и Linux, типовые параметры командной строки агента, а также способы диагностики, когда агент не стартует или кластер не виден клиентам.
Что такое агент сервера 1С и когда требуется его настройка
В клиент-серверной архитектуре 1С работают три уровня: клиентское приложение, кластер серверов 1С и сервер СУБД. Кластер состоит из агента (ragent), менеджера кластера (rmngr) и рабочих процессов (rphost). Агент — точка входа: он принимает подключения клиентов и консоли администрирования, ведёт реестр кластера и запускает остальные процессы.
Настройка агента требуется при первичной установке сервера 1С, переносе кластера на другой компьютер, смене портов из-за конфликтов, добавлении второго кластера на той же машине и при диагностике сбоев запуска. Также параметры пересматривают при росте нагрузки: меняют число рабочих процессов, лимиты памяти и режимы отказоустойчивости.
Подготовка сервера перед установкой
Перед установкой убедитесь, что сервер соответствует минимальным требованиям платформы: достаточный объём оперативной памяти под рабочие процессы, стабильная сеть между сервером 1С и сервером СУБД, актуальные обновления операционной системы. Для продуктивной среды рекомендуется выделенный сервер, а не совмещение с другими ресурсоёмкими ролями.
Проверьте разрешение имён: сервер 1С и сервер СУБД должны корректно разрешать имена друг друга через DNS или файлы hosts. Ошибки разрешения имён — одна из самых частых причин, по которой кластер запускается, но базы не открываются. Также заранее определите учётную запись, под которой будет работать служба агента: ей нужны права на каталог кластера и сетевой доступ к СУБД.
На брандмауэре откройте порты, которые использует кластер. По умолчанию это порт агента 1540, порт менеджера кластера 1541 и диапазон рабочих портов 1560–1591. Если порты заняты другими приложениями, их можно изменить при регистрации службы — об этом ниже.
Установка компонентов сервера 1С
Установка выполняется из дистрибутива платформы. Запустите установщик и на этапе выбора компонентов отметьте «Сервер 1С:Предприятия» и «Администрирование сервера 1С:Предприятия» — второй компонент ставит консоль кластера, без которой управлять агентом неудобно. Если планируется работа через веб-сервер, дополнительно отметьте модули расширения веб-сервера.
В Windows установщик по умолчанию предлагает создать службу агента автоматически. Служба регистрируется под учётной записью USER1CV8, которую установщик создаёт сам, либо под указанной вами учётной записью. Для доменной среды удобнее заранее создать выделенную доменную учётную запись с минимально необходимыми правами.
В Linux установка выполняется пакетами: сначала пакеты платформы, затем пакет сервера. После установки служба агента регистрируется скриптом из состава дистрибутива либо вручную через systemd. Убедитесь, что все зависимости пакетов разрешены, иначе агент не стартует с невнятной ошибкой в журнале.
- 1Установите компоненты «Сервер 1С» и «Администрирование сервера» из дистрибутива платформы
- 2Укажите учётную запись службы и подтвердите создание службы агента
- 3Откройте порты 1540, 1541 и диапазон 1560–1591 на брандмауэре
- 4Запустите службу агента и проверьте, что процесс ragent присутствует в системе
- 5Подключитесь к кластеру через консоль администрирования и убедитесь, что кластер отображается
Регистрация службы и параметры запуска агента
Если службу нужно пересоздать или запустить с нестандартными параметрами, используется утилита ragent с ключом -instsrvc. Ниже пример регистрации службы в Windows с указанием каталога кластера и учётной записи:
"C:\Program Files\1cv8\8.3.22.1750\bin\ragent.exe" -instsrvc -usr .\USR1CV8 -pwd P@ssw0rd -d "C:\Program Files\1cv8\srvinfo" -port 1540 -regport 1541 -range 1560:1591Основные параметры командной строки агента:
- -d — каталог реестра кластера (srvinfo), где хранятся списки баз, настройки кластера и журналы;
- -port — порт агента, по умолчанию 1540;
- -regport — порт менеджера кластера, по умолчанию 1541;
- -range — диапазон портов рабочих процессов, по умолчанию 1560:1591;
- -debug — запуск в режиме отладки, нужен для отладки серверного кода;
- -srvc и -instsrvc — режим службы и регистрация службы соответственно.
Для удаления службы используется ключ -rmsrvc. Перед перерегистрацией остановите службу и убедитесь, что каталог srvinfo не повреждён: именно из него агент восстановит состав кластера после запуска.
Настройка кластера через консоль администрирования
После запуска агента откройте консоль «Администрирование серверов 1С:Предприятия». Создайте центральный сервер, указав имя компьютера, затем внутри него появится кластер с портом 1541. Если кластер не появился автоматически, добавьте его вручную, указав порт агента.
В свойствах кластера задаются важные параметры: интервал перезапуска рабочих процессов, допустимый объём памяти процессов, режим распределения нагрузки и уровень отказоустойчивости. Для большинства средних внедрений разумно включить перезапуск рабочих процессов по расписанию — это снижает эффект накопления утечек памяти.
Информационные базы добавляются через контекстное меню ветки «Информационные базы»: укажите имя базы, тип СУБД, сервер баз данных и имя базы на сервере СУБД, а также учётные данные пользователя СУБД. После добавления база становится доступна клиентам по имени сервера и имени базы в кластере.
Как проверить результат
Служба запущена, процесс ragent виден в диспетчере задач или в выводе ps
Служба останавливается сразу после запуска, ошибки в журнале событий
Кластер отображается, раскрываются ветки рабочих процессов и баз
Ошибка подключения к агенту по порту 1540
Клиентский сеанс открывает базу и виден в списке сеансов консоли
Ошибка соединения с сервером 1С или таймаут при открытии базы
Типичные проблемы и их диагностика
Самая частая ситуация — служба агента не стартует. Проверьте журнал событий Windows или syslog: типовые причины — занятый порт 1540, недоступность каталога srvinfo для учётной записи службы, повреждённые файлы реестра кластера. Занятость порта проверяется командой netstat с фильтром по номеру порта.
Вторая группа проблем — агент работает, но клиенты не подключаются. Здесь проверяйте брандмауэр (все три группы портов), разрешение имён сервера со стороны клиентов и соответствие версий платформы на сервере и клиентах. Клиент с версией платформы, несовместимой с сервером, получит ошибку ещё на этапе подключения.
Третья группа — кластер виден, база добавлена, но не открывается. Это почти всегда проблема на стыке с СУБД: неверные учётные данные, недоступность сервера баз данных, отсутствие самой базы на СУБД. Проверяйте подключение к СУБД с сервера 1С штатными средствами СУБД под теми же учётными данными.
Дополнительные сценарии: второй кластер и перенос сервера
Запуск второго агента на одном сервере
Иногда требуется изолировать тестовый и продуктивный контуры на одном физическом сервере. Для этого регистрируется вторая служба агента с другим именем службы, другим каталогом srvinfo и непересекающимися портами — например, порт агента 2540, менеджер 2541, рабочие порты 2560:2591. Каждый агент обслуживает свой независимый кластер.
Перенос кластера на новый сервер
При переносе установите платформу той же версии на новый сервер, остановите службу агента на старом сервере, скопируйте каталог srvinfo целиком, зарегистрируйте службу на новом сервере с указанием скопированного каталога и запустите её. Если имя сервера изменилось, поправьте подключения клиентов и при необходимости записи в реестре кластера через консоль.
Что важно запомнить
Настройка агента сводится к установке компонентов, регистрации службы с корректными портами и каталогом srvinfo, открытию портов на брандмауэре и проверке через консоль кластера. Большинство проблем связано с портами, правами учётной записи службы и разрешением имён — начинайте диагностику с них.
Частые вопросы
Как узнать, какие порты использует агент сервера 1С?
Откройте свойства службы агента и посмотрите строку запуска исполняемого файла — там указаны ключи -port, -regport и -range. Если служба создана установщиком с параметрами по умолчанию, это 1540, 1541 и диапазон 1560–1591. Фактически занятые порты можно проверить командой netstat -an с поиском по номеру порта.
Что делать, если служба агента падает сразу после запуска?
Сначала посмотрите журнал событий операционной системы — там обычно указана причина. Чаще всего это занятый порт, отсутствие прав у учётной записи службы на каталог srvinfo или повреждение файлов реестра кластера. Попробуйте запустить ragent вручную из командной строки без ключа службы: ошибка выведется прямо в консоль.
Можно ли изменить порт агента без переустановки сервера 1С?
Да. Остановите службу, удалите её командой ragent -rmsrvc и зарегистрируйте заново с новым значением -port и при необходимости -regport и -range. Каталог srvinfo укажите тот же — реестр кластера и список баз сохранятся. Не забудьте открыть новые порты на брандмауэре и сообщить клиентам новый порт, если он использовался в строках подключения.
Нужна ли отдельная лицензия для агента сервера 1С?
Да, для работы сервера 1С требуется лицензия на сервер, а для клиентских подключений — клиентские лицензии. Лицензии активируются программными ключами через консоль или работают с аппаратными ключами HASP. Без серверной лицензии кластер запустится, но клиентские сеансы будут отклоняться.
Как включить отладку на сервере через агента?
Перерегистрируйте службу агента с добавлением ключа -debug в строку запуска и перезапустите службу. После этого в конфигураторе включите отладку по протоколу, соответствующему режиму запуска сервера, и подключитесь к серверным предметам отладки. На продуктивном сервере режим отладки включайте только на время диагностики: он снижает производительность.
Чем отличается агент от рабочего процесса rphost?
Агент (ragent) — управляющий процесс: принимает подключения, хранит реестр кластера и координирует работу остальных процессов. Рабочие процессы rphost исполняют код прикладного решения и обслуживают сеансы пользователей. Агент на сервере один на кластер, а рабочих процессов может быть несколько — их число регулируется настройками кластера и нагрузкой.