Как включить отладку на сервере 1С:Предприятие?

Системный администратор 1С v8.3 (Управляемые формы) IT и автоматизация бизнеса
← На главную

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

Подготовка параметров запуска агента сервера

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

Первым делом выясним, где именно задаются эти параметры. Хотя технически можно изменять реестр Windows, наиболее безопасным и предпочтительным методом является использование оснастки Службы (services.msc). Выполним следующие действия:

  1. Откроем оснастку Службы.
  2. Найдем службу с именем Агент сервера 1С:Предприятия.
  3. Остановим службу, если она запущена.
  4. В поле Параметры запуска добавим ключ -debug.

Важно помнить, что если вы вносите изменения через командную строку или реестр, параметры должны быть выстроены в корректном порядке. Частая ошибка заключается в том, что ключ -debug либо пропущен, либо стоит не в конце строки. Рекомендуется добавлять его в самом конце списка аргументов:


"C:\Program Files\1cv8\8.3.15.1830\bin\ragent.exe" -srvc -agent -regport 1541 -port 1540 -range 1560:1591 -d "D:\srvinfo" -debug

После внесения изменений в параметры запуска обязательно перезапустите службу. Помните, что сервер 1С считывает конфигурационные ключи только в момент старта процесса, поэтому без полной остановки и повторного запуска изменения не вступят в силу.

Разбор основных ключей запуска

Давайте подробно рассмотрим, за что отвечают параметры, которые мы используем при настройке службы ragent:

Важные нюансы: регистрозависимость и именование баз

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

Советуем всегда прописывать имена информационных баз в нижнем регистре и избегать использования пробелов как в оснастке администрирования серверов 1С, так и в стартовом окне клиентского приложения. Это простая дисциплина именования помогает избежать «шаманства» с неработающими точками останова. Когда имя базы в консоли кластера и имя базы, указанное в списке у пользователя, совпадают до последнего символа (включая регистр), система взаимодействия отладчика с фоновыми процессами работает стабильнее.

Что делать, если отладка по-прежнему не подключается?

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

  1. Версии платформы: Убедитесь, что версия 1С на клиенте в точности совпадает с версией на сервере. Даже небольшое расхождение в релизах может блокировать отладку.
  2. Настройки Конфигуратора: Проверьте меню Сервис — Параметры — Отладка. Выбранный предмет отладки должен соответствовать текущей задаче.
  3. Сетевые экраны: Если сервер находится в другой подсети или защищен брандмауэром, убедитесь, что диапазон портов (по умолчанию 1560:1591) открыт для входящих соединений.
  4. Перезапуск рабочих процессов: Иногда требуется не просто перезапуск службы, а полное обновление всех соединений, так как рабочие процессы rphost могли не успеть подхватить новый режим работы.

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

← На главную