Установка, обновление и удаление агента мониторинга на WindowsLTS

Чтобы агент мониторинга начал собирать данные на рабочих станциях Windows, его необходимо установить и настроить. На этой странице приведены инструкции по установке, обновлению и удалению агента.

Установка агента мониторинга

Установить агент мониторинга в Windows можно несколькими способами: через exe-дистрибутив, командную строку или msi-пакет.

Установка при помощи exe-дистрибутива, если он получен через интерфейс Proceset

Запустите файл agent_setup.exe, скачанный по кнопке Windows (exe), на компьютере, где нужно установить агент мониторинга. Во время установки будут использоваться параметры, заданные при скачивании клиента.

Чтобы начать установку, нажмите Далее. По завершению установки нажмите Ок.

Если компьютер не имеет доступа к серверу приложения, установка завершится с ошибкой.

Установка при помощи exe-дистрибутива, если он получен не через интерфейс Proceset

Если agent_setup.exe был получен другим способом, то при установке поля настроек будут пустыми.

Чтобы выполнить установку, заполните поля Адрес сервера и Значение ключа, а также выберите тип ключа.

Установка через командную строку

Вы можете установить агент мониторинга с помощью файла agent_setup.exe, запустив его из командной строки.

Основные параметры

• silent — установка в фоновом режиме, без всплывающих окон и запросов
• action=install — выполняемая операция. Возможные значения: install — установка, update — обновление, remove — удаление

Дополнительные параметры

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

• autoupdate_enabled=true или false — включить или отключить автоматическое обновление агента. По умолчанию — зависит от настроек файла
• web_server.host=http://ваш-сервер:порт — адрес сервера Proceset, к которому должен подключаться агент. Например: http://server.contoso.com:8010
• auth.value=ваш_ключ_API — ключ API для доступа к системе, который можно получить в веб-интерфейсе Proceset
• auth.type=none / ad / certificate — тип авторизации. Чаще всего используется none — простая авторизация по ключу

Примеры команд

• «Тихая» установка с готовыми настройками:
  agent_setup.exe silent action=install
  

• «Тихая» установка с указанием параметров вручную:
  agent_setup.exe silent action=install autoupdate_enabled=true web_server.host=http://server.contoso.com:8010 auth.value=01235ed47546459780f1001a36e41de2 auth.type=none
  

Установка при помощи msi-пакета

Msi-пакет содержит mst-файл с готовыми настройками и подходит для систем автоматизированного развертывания ПО, например, GPO, SCCM и других. Установка в этом случае происходит согласно рекомендациям компании разработчика соответствующей системы.

В архиве находятся 2 файла:

• agent_setup.msi — файл для установки
• setting.mst — файл конфигурации

При необходимости этот дистрибутив агента мониторинга можно установить с помощью стандартного инструмента Windows — msiexec.

Пример команды msiexec для «тихой» установки агента мониторинга:

msiexec.exe /i "путь_до_файла_agent_setup.msi" /q TRANSFORMS="путь_до_файла_settings.mst"

Проверка и настройка агента мониторинга после установки

После установки агент мониторинга можно проверить и при необходимости перенастроить с помощью конфигуратора агента.

Обновление агента мониторинга

Агент мониторинга обновляется автоматически через сервер приложения. Исключение — если агент установлен с помощью msi-пакета или в настройках выключен параметр Автообновление.

Обновление агентов также возможно произвести вручную.

Восстановление старой версии агента возможно только через полную переустановку.

Автообновление

Раз в час служба агента проверяет наличие на сервере наличие новой версии агента. Если обновление доступно, агент скачивает и устанавливает его.

Перед установкой новой версии агента мониторинга создается резервная копия текущей версии.

Если обновление проходит успешно, резервные копии удаляются. Если при обновлении произошли ошибки, агент восстанавливается из резервной копии.

Поэтапное автообновление

Администратор может ограничить список компьютеров, для которых включено автообновление. Для этого:

1. В конфигурационный файл com.infomaximum.subsystem.monitoring.json, расположенный на сервере по пути C:\ProgramData\Infomaximum\, добавьте блок настройки phased_agent_upgrade.
2. Укажите в блоке:
   • stable_version — стабильная версия агента (должна быть указана в формате XXX.XXX.XXX)
   • host_mask — массив FQDN-имен компьютеров в формате регулярных выражений (не может быть пустым)
3. Сохраните изменения и перезагрузите службу Infomaximum.

Пример конфигурационного файла:

{
    "partition_life_circle_time": 3,
    "agent_activity_queue_dir": "agent_activity_queue",
    "rdb_ch_synchronization": {
        "delay": "10s",
        "interval": "30s"
    },
    "parsing_activity_enabled": true,
    "phased_agent_upgrade": {
        "stable_version": "2.6.41",
        "host_masks": [
            ".+\\.testinfomaximum\\.com"
        ] 
    }
}

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

Ручное обновление

Ручное обновление агента мониторинга может потребоваться для обновления агента на конкретном компьютере. Его можно осуществить с помощью:

• Конфигуратора агента
• Дистрибутива агента новой версии

Для обновления с помощью конфигуратора:

1. Запустите конфигуратор агента, расположенный по пути C:\Program Files\ProcesetAgent\agent_configurator.exe.
2. В открывшемся окне нажмите Обновить агент.

Для обновления с помощью дистрибутива новой версии:

1. Запустите установку нового дистрибутива agent_setup.exe.
2. Подтвердите обновление.

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

agent_setup.exe silent action=update  

Особенности обновления агента мониторинга описаны на странице Известные ограничения.

Обновление с помощью msi-пакета

Если вы используете сторонние программы или скрипты для обновления агента мониторинга, рекомендуется делать это через msi-пакет.

Для управления установкой используется встроенная в Windows утилита msiexec.

Чтобы обновить агент с помощью msi-пакета:

1. Удалите старую версию агента с помощью команды:
   msiexec /x "путь_до_файла_agent_setup.msi" /q
   

   Где:
   • /x — команда на удаление, в которой нужно указать полный путь к вашему MSI-файлу
   • /q — тихий режим
2. Установите новую версию с помощью команды:
   msiexec /i "путь_до_файла_agent_setup.msi" /q TRANSFORMS="путь_до_файла_settings.mst"
   

   Где:
   • /i — команда на установку
   • /q — тихий режим
   • TRANSFORMS="..." — путь к файлу настроек, в котором сохранены параметры подключения (адрес сервера, ключ и т. д.)

Удаление агента мониторинга

Удалить агент мониторинга с Windows можно несколькими способами: через exe-файл, командную строку или msi-пакет (если установка производилась через GPO или msiexec).

Удаление при помощи exe-файла

Для удаления агента мониторинга, установленного при помощи exe-файла:

1. Запустите файл C:\Program Files\ProcesetAgent\agent_setup.exe.
2. В открывшемся окне выберите удаление программы.

Удаление через командную строку

Выполните команду:

agent_setup.exe silent action=remove

Удаление с помощью msi-пакета

Если агент был установлен с помощью msiexec (например, через GPO), используйте команду:

msiexec.exe /x "путь_до_файла_agent_setup.msi" /q

Агент мониторинга, установленный через GPO, можно также удалить через Панель управления Windows в разделе Программы и компоненты.