Агент мониторинга на ОС Windows

Установка при помощи exe-дистрибутива

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

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

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

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

1. Основные параметры:
   • silent — параметр, определяющий «тихую» установку
   • action — тип операции (install/update/remove)
2. Опциональные параметры:
   • autoupdate_enabled — автообновление агента (true/false)
   • web_server.host — адрес сервера
   • auth.value — ключ API (значение можно получить в веб-интерфейсе системы)
   • auth.type — тип авторизации для данного ключа API (none/ad/certificate)

Пример:

agent_setup.exe silent action=install autoupdate_enabled=true web_server.host=http://srv.domain.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, путь на сервере к которому С:/ProgramData/Infomaximum/, добавьте блок настройки phased_agent_upgrade. Укажите в блоке:
   • stable_version — стабильная версия агента (должна быть указана и проходить валидацию по шаблону XXX.XXX.XXX)
   • host_mask — массив FQDN имен компьютеров в формате регулярных выражений (не может быть пустым)
2. Сохраните изменения и перезагрузите службу 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. Подтвердите действие обновления агента мониторинга.

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

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

Для удаления агента мониторинга, установленного при помощи exe-файла, запустите файл C:\Program Files\ProcesetAgent\agent_setup.exe. Открывается окно с предложением удалить программу.

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

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

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