Переходите на новый сайт Базы знаний. Актуализация контента происходит теперь там.
Перейти в новую Базу знаний
PIX Agent Host
PIX Agent Host является компонентом для управления PIX Agent'ами.
PIX Agent Host предназначен:
  • для запуска пользовательских сессий;
  • для запуска и прекращения работы PIX Agent.
Функционал можно использовать для работы процессов и задач в PIX Master, выполнение которых должно осуществляться на удаленном рабочем столе в случаях если:
  • есть ограничения для ручного запуска сессии и агента;
  • или серверов и задач для агентов слишком много для ручного сопровождения (функционал «Машины» в PIX Master).
Кроме того, AgentHost помогает предотвращать возникновения нештатной ситуации, связанной с «незапуском» агента на сервере. В этом случае AgentHost определит, что сессия запущена, но активного агента нет и завершит сессию, затем - перезапустит сессию и агента.
    Установка компонента PIX Agent Host
    В установщике платформы PIX (PIX Studio) для компонента PIX Agent нужно выбрать установку подчиненного компонента PIX Agent Host (А).

      Запуск службы
      После установки службу PIX Agent Host Service необходимо запустить (два варианта):
      • вручную в оснастке Службы (Н);
      • используя команду run в PowerShell.

        Необходимо также настроить Автоматический (отложенный) запуск:

        Также включить автоперезапуск на вкладке "Восстановление":

        Команды для AgentHostService.exe в PowerShell
        • Команда run запускает AgentHostService службу;
        • Команда install создаёт службу Windows и после установки запускает ее;
        • Команда uninstall удаляет службу Windows;
        • Команды help выводит информацию о параметрах - .\AgentHostService.exe help

          Переключатель для старого и нового RDP-клиента
          В PIX Studio 2.16.2 для взаимодействия с удалённым рабочим столом RDP (Remote Desktop Protocol) была реализована поддержка криптографического протокола TLS 1.2, обеспечивающего более защищённую передачу данных, чем ранее использовавшийся TLS 1.0.
          RDP-сессию запускает новый клиент - приложение wfreerdp.exe.
          В некоторых случаях работа нового RDP-клиента приводит к ошибкам в работе роботов, в т.ч. тех, что исправно работали на предыдущих версиях PIX Studio и PIX Agent, поэтому в версию PIX Studio 2.16.5 добавлена возможность переключаться между старым и новым RDP-клиентом (FreeRdpClient.exe и wfreerdp.exe). По умолчанию используется прежний RDP-клиент - FreeRdpClient.exe.
            В appsettings.json существует два блока для настройки переключения между старым и новым RDP-клиентом: 
            
   "HostHubConnectionOptions": {
     "MasterUri": "https://localhost:5001",
     "MachineId": "00000000-0000-0000-0000-000000000000" 
   },
   "RdpOptions": {
    "UseLegacyRdpClient": true
   },
   "AgentOptions": {
     "UseLegacyRdpClient": true
   }
 }
            Настройка в блоке RdpOptions определяет, какой RDP-клиент хост будет использовать при поднятии сессии для Agent.
            Настройка в блоке AgentOptions определяет, какой RDP-клиент Agent будет использовать для удержания RDP-сессии (аналогичная настройка, что и в пользовательском интерфейсе).
              При обновлении Agent.Host новые блоки в конфигурации добавлены не будут, и если пользователю требуется воспользоваться этими настройками, то их необходимо будет добавить вручную.
              Закрытие сессий и агентов
              В версиях Agent.Host, идущих вместе с PIX Studio ниже версии 2.16.5, было ограничение, из-за которого он не мог закрывать агентов и сессии, которые он не поднимал. В версиях начиная с PIX Studio 2.16.5 это ограничение устранено.
                Настройки PIX AgentHostService производятся в конфигурационном файле appsettings.json.
                Подробнее настройки конфигурации в appsettings.json описаны в файле по ссылке.