В данной статье будет рассказано про агент сервера 1С:Предприятие 8.3 (справедливо и для версии 8.2 ) в случае использования агента в операционных системах семейства Windows. Будут приведены параметры запуска агента, а также описание выполняемых при его запуске действий.
Для того чтобы выполнить запуск кластера серверов «1С:Предприятия» необходимо запустить агент сервера, а точнее программу ragent.exe , которая располагается в каталоге bin каталога установки системы «1С:Предприятия». По умолчанию это:
При запуске агента сервера ragent.exe возможно использовать следующие параметры:
Параметр | Описание |
---|---|
-port <порт> | Номер сетевого порта агента сервера (ragent). Этот порт используется консолью кластера для обращения к центральному серверу. Порт агента кластера также указывается в качестве сетевого порта рабочего сервера.Значение по умолчанию: 1540 . |
-regport <порт> | Номер сетевого порта главного менеджера кластера (rmngr), создаваемого по умолчанию при первом запуске ragent.Значение по умолчанию: 1541 . |
-range <диапазоны> | Диапазоны сетевых портов для динамического выбора. Из них выбираются служебные порты процессов кластера при невозможности их выбора из настроек соответствующего рабочего сервера.Значение по умолчанию: 1560:1591 . |
-debug | Запуск кластера серверов в режиме отладки конфигураций. |
-d <каталог> | Каталог, в котором будут расположены (или располагаются) служебные файлы кластера серверов (в том числе список кластеров и список информационных баз кластера). Если путь к каталогу содержит пробелы, путь нужно заключать в кавычки, но в этом случае имя каталога не должно завершаться символом «\».Значение по умолчанию: %LOCALAPPDATA%\1C\1Cv8 (%USERPROFILE%\Local Settings\Application Data\1C\1Cv8 для Windows XP и Windows Server 2003). |
-seclev <уровень> | Уровень безопасности процесса агента кластера. Определяет уровень безопасности соединений, устанавливаемых с процессом ragent. Уровень может принимать значения:
Значение по умолчанию: 0. |
-instsrvc | Регистрация агента кластера как сервиса Windows. Если ragent запущен с этим ключом, то он выполняет регистрацию в списке сервисов Windows и завершается.Ключ -instsrvc несовместим с ключом -rmsrvc. |
-rmsrvc | Отмена регистрации агента кластера как сервиса Windows. Если ragent запущен с этим ключом, то он отменяет свою регистрацию в списке сервисов Windows и завершается.Ключ -rmsrvc несовместим с ключом -instsrvc. |
-usr <имя> -pwd <пароль> |
Имя и пароль пользователя Windows, от имени которого должен запускаться ragent как сервис Windows. Могут использоваться только совместно с ключом -instsrvc при регистрации ragent как сервиса Windows. |
-srvc | Запустить процесс ragent как сервис Windows и передать управление менеджеру сервисов. |
-start | Запустить ragent, зарегистрированный как сервис Windows. Выполняет запуск ragent, ранее зарегистрированного как сервис Windows, после чего завершается. |
-stop | Остановить ragent, зарегистрированный и запущенный как сервис Windows. Выполняет остановку ragent, ранее зарегистрированного и запущенного как сервис Windows, после чего завершается. |
-agent | Использовать как Агент сервера «1С:Предприятия» |
Название и значение параметра должны разделяться символом «пробел».
При запуске агент сервера выполняет поиск списка зарегистрированных на данном компьютере серверов, используя переданные ему при запуске параметры. Если список кластеров найден, агент получает от них информацию о рабочих процессах, которые должны быть запущены в каждом из кластеров и выполняет их запуск.
Если список кластеров не обнаружен, агент создает кластер по умолчанию. Кластер по умолчанию имеет следующие характеристики:
Агент сервера может быть запущен и как служба и как приложение.
Для запуска агента сервера как приложения нужно выполнить команду ragent.exe
Ragent.exe -debug -port <порт> -regport <порт> -range <диапазоны> -seclev <уровень> -d <каталог>
Остановка агента сервера, запущенного как приложение, выполняется нажатием клавиш Ctrl + C.
Если при установке был выбран вариант запуска агента как службы, то данная служба будет зарегистрирована и запущена автоматически, а также будет запускаться при старте операционной системы.
Если агент сервера был установлен как приложение (а также в случае удаления службы), существует возможность зарегистрировать службу вручную, а затем выполнить ее запуск. Для регистрации службы необходимо выполнить команду ragent.exe со следующими возможными параметрами (если какой-либо параметр не указан, будет использовано значение по умолчанию):
Ragent.exe -instsrvc -usr <имя> -pwd <пароль> -debug -port <порт> -regport <порт> -range <диапазоны> -seclev <уровень> -d <каталог>
При регистрации агент сервера создает службу с именем:
Для отмены регистрации службы (удаления службы) необходимо выполнить команду:
Ragent.exe -rmsrvc
Для запуска службы выполняется команда:
Ragent.exe -start
Для остановки службы, команда:
Ragent.exe -stop
Помогла ли Вам данная статья?
Необходимый компонент клиент-серверной конфигурации 1С старших версий: «служба агент сервера 1С» представляет собой отдельный модуль, входящий в поставку серверного ПО программного комплекса и функционирующий, как служба операционной системы Windows.
Назначение службы — управление пользовательскими и системными заданиями. Служба агент сервера 1С может оказаться источником непредвиденных проблем самого разного толка. С некоторыми из них можно легко справиться с помощью изменения настроек службы, для чего предусмотрен отдельный пользовательский интерфейс. Но как поступить, если служба не запускается вовсе.
В версии 8.2 возникновении такой ситуации сигнализирует ошибка 1C сопровождающаяся следующим пояснительным текстом: «Ошибка при запуске службы агент сервера 1с предприятия 8.2 ».
Обычно такая ошибка возникает либо в процессе установки нового экземпляра 1С на сервер, либо при попытке одновременного запуска сразу же двух серверов приложений 1С: 8.1 и 8.2 на одном и том же физическом сервере. Рассмотрим каждый из вариантов по отдельности.
Вы можете сказать, что 2-ой и 3-й пункты избыточны, но лучше перебздеть, чем недобздеть. Инструкция справедлива не только для доменного пользователя, но и для локального.
Здесь показан ярлык, с помощью которого можно установить агент сервера 1С как службы Windows. Установка службы производится ключом "-instsrvc " . Обратите внимание на то, что у Вас есть возможность изменить каталог, в котором располагаются параметры сервера 1С и его логи. Делается это через параметр "-d " . В данном примере указан каталог: E:\Servers1C\WorkServer81 . Настоятельно рекомендуется заключать путь к каталогу в кавычки, особенно если в пути присутствуют пробелы или латинские символы.
Следует отметить, что даже соблюдение этих простых требований к правилам написания каталога не гарантирует зупуск агента сервера 1С. Бывают случаи, когда сервис агент сервера 1С не запускается. В данном случае, рекомендую путь к каталогу составлять исключительно из латинских символов и каждый каталог не длиньше 8 символов.
Вот как выглядит сам сервис агента сервера 1С :
На закладке службы "Вход в систему " не забудьте указать необходимый логин, под которым будет запускаться сервис агента сервера 1С .
На сам каталог, в который будут писаться параметры сервера 1С и логи серева 1С, необходимо предоставить права пользователю, под которым запускается агент сервера 1С . (Нажмите кнопку "Добавить " в окне "Свойств" каталога сервера).
Добавляем необходимого пользователя и ставим галочку напротив прав "Изменить " в колонке "Разрешить ".
Допустим, нам нужен второй сервер 1С, но уже версии 8.2. Нужно учесть, что 1С-сервер 8.1 и 8.2 по умолчанию используют одни и те же порты для своей работы.
Для регистрации второго агента сервера 1С, например для разработчиков, нужно выставить незанятый порт для агента сервера через параметр "-port " и незанятый порт для кластера связанного с ним через параметр "-regport " . Для предоставления разработчикам отладочной информации с сервера необходимо указать параметр "-debug " в строке запуска сервиса. Для разработчиков обязательно нужно использовать отдельный сервер 1С, поэтому через параметр "-d " указываем каталог со своими настройками сервера 1С для разработчиков. (Диапазон рабочих портов остаётся одним и тем же у обоих серверов - данные порты занимаются динамически. Для справки - для работы рабочего процесса 1С необходимо 2 порта, следовательно, по умолчанию, в диапазоне потров с 1560 по 1591 можно использовать по максимому 16 рабочих процессов. )
Вот как выглядит сам сервис агента тестового сервера 1С (сервер 1С для разработчиков):
На закладке тестовой службы "Вход в систему " также не забудьте указать необходимый логин, под которым будет запускаться сервис агента тестового сервера 1С (для разработчиков).
Предполагается, что мы уже скопировали через экспорт, следуя инструкции , один из агентов сервера 1С как службы Windows. В дальнейшем изменения параметров службы производятся через реестр Windows . Службыы Windows располагаются по пути реестра HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\1C:Enterprise 8.1 Server Agent
Пишем красивое описание в параметр Description :
И красивое имя для службы в параметр DisplayName :
В строковом параметре ImagePath выставляем необходимые значения параметров службы:
В параметре Start выставляем значение 4 , которое переводит службу в отключенное состояние.
При копировании службы в Windows 2008 данной инструкции было предостаточно.
А вот если у Вас на сервере используется Windows 2003, то необходимо произвести копирование устройства сервера 1С :
Копирование устройства сервера 1С в Windows 2003
Открываем путь реестра HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\1C:Enterprise 8.1 Server Agent\Enum ...
И смотрим строковый параметр 0 . Его значение выглядит примерно так:
Данный путь в строке указывает на эту ветку:
Данную ветку также нужно копировать. Для этого сначала экспортируем её:
Получившийся reg -файл (файл реестра) открываем блокнотом...
И добавляем в ключевых строках необходимый идентификатор, в данной случае - Debug .
Для добавления нового устройства (прописывания его в реестр Windows) нам необходимо предоставить права доступа на ветку реестра HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\1C:Enterprise 8.1 Server Agent\Enum\Root . В меню по правой кнопке выбираем пункт "Разрешения... ":
Указываем пользователя, под которым мы работаем:
Даём ему необходимые права (Полные права):
Теперь смело запускаем отредактированный ранее reg -файл. В окне запроса соглашаемся и нажимаем кнопку "Да ":
После внесения изменений можем убрать права.
Перегружаем сервер...
Не забудьте проверить права у созданного нами новой службы:
57
Бывает, однажды, ни с того и с чего программа 1С нам выдает: Ошибка соединения с сервером 1С:Предприятие Не запущен ни один рабочий процесс. Соединение с базой невозможно. Несколько вариантов поиска ошибок и решений: ...
28
Я уже писал несколько статей: Настройка и оптимизация сервера, кластера 8.3 Добавление, перезапуск, оптимизация рабочих процессов сервера кластера теперь немного подробнее: Кластер 1С 8.3 Первым делом, после...
18
У многих возникают проблемы с rphost.exe, разного вида: rphost занимает всю память rphost грузит процессор rphost жрет память причем 1С даже на запущена, а в диспетчере следующее: ежеминутно расчет на 2-3 мегабайта. Как быть и...
17
Если фоновый процесс COM-соединения завершается с ошибкой: {Обработка.ОбменДаннымиXML.МодульОбъекта(15947)}: Ошибка при вызове конструктора (COMОбъект): -2147221005(0x800401F3): Invalid class string Нужно зарегистрировать библиотеку ComConnecto