Установка агента Windows из MSI

Обзор

Zabbix агента для Windows можно установить из пакетов установщика Windows MSI (32-бит или 64-бит), доступных для загрузки.

Минимальные требования ОС для MSI установки:

  • для Zabbix агента: Windows XP (64-бит) или Windows Сервер 2003 ;
  • для Zabbix агента 2: Windows 10 (32-бит) или Windows Сервер 2016.

32-битный пакет нельзя установить на 64-битную Windows.

Пакеты включают:

  • Поддержку TLS (настройка TLS необязательна)
  • Утилиты Zabbix get и Zabbix sender (могут быть установлены вместе с Zabbix агентом/агентом 2 или отдельно)

Пакеты Zabbix агента 2 не включают подгружаемые плагины (MongoDB, PostgreSQL, MSSQL), которые нужно загрузить и установить отдельно.

Установку можно выполнить с помощью Мастера настройки (Setup Wizard) или командной строки.

Хотя установка из пакетов установщика MSI полностью поддерживается, рекомендуется установить, как минимум, Microsoft .NET Framework 2 для правильной обработки ошибок.

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

Установка с помощью мастера установки

Следующие шаги установки применимы как к Zabbix agent, так и к Zabbix agent 2.

1. Дважды щелкните загруженный MSI-файл, чтобы начать установку:

2. Примите лицензионное соглашение с конечным пользователем:

3. Выберите компоненты Zabbix (демон агента, Zabbix sender, Zabbix get), которые необходимо установить:

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

Если используется пользовательское расположение за пределами каталога Program Files, а папка назначения уже существует, установщик не изменит ее разрешения. При новой установке вам будет предложено вручную установить соответствующие разрешения или продолжить без их изменения.

4. Настройте следующие параметры. Их значения будут указаны в файле конфигурации агента Zabbix:

Parameter Description
Имя узла сети Имя узла сети компьютера, на котором устанавливается агент Zabbix. Задает параметр Hostname.
IP-адрес/DNS-сервер Zabbix Список IP-адресов, разделенных запятыми, при необходимости в нотации CIDR, или DNS-имен серверов Zabbix либо прокси Zabbix. Этот параметр является обязательным. Задает параметр Server.
Порт прослушивания агента Агент будет прослушивать этот порт для подключений от сервера. Задает параметр ListenPort.
Сервер или прокси для активных проверок Адрес сервера/прокси Zabbix или конфигурация кластера, откуда будут получаться активные проверки. Адрес сервера/прокси представляет собой IP-адрес или DNS-имя и необязательный порт, разделенные двоеточием. Задает параметр ServerActive.
Включить PSK Установите флажок, чтобы включить поддержку TLS с использованием предварительно установленных ключей. Задает для параметров TLSConnect и TLSAccept значение psk.
Добавить расположение агента в PATH Установите флажок, чтобы добавить расположение агента Zabbix в системную переменную PATH.

Если обнаружен существующий агент Zabbix, будут отображены значения параметров из его файла конфигурации. Кроме того, во время установки существующий файл конфигурации будет переименован, а новый файл конфигурации будет создан.

5. Настройте параметры PSK, если на предыдущем шаге вы установили флажок Включить PSK. Эти параметры также будут указаны в файле конфигурации агента Zabbix:

Parameter Description
Идентификатор предварительно установленного ключа Строка идентификатора предварительно установленного ключа. Задает параметр TLSPSKIdentity.
Значение предварительно установленного ключа Строковое значение предварительно установленного ключа. Создает файл psk.key, содержащий ключ, и задает для параметра TLSPSKFile расположение ключа (по умолчанию: C:\Program Files\Zabbix Agent\psk.key). Рекомендуется ограничить доступ к файлу предварительно установленного ключа, изменив параметры безопасности файла так, чтобы только агент Zabbix (или пользователь, от имени которого работает агент) мог его прочитать.

6. Нажмите Install, чтобы начать установку.

Все выбранные компоненты Zabbix и файл конфигурации агента Zabbix будут установлены в указанное вами расположение (по умолчанию: C:\Program Files\Zabbix Agent). То же относится к Zabbix agent 2, за исключением того, что дополнительные файлы конфигурации для его встроенных плагинов будут установлены во вложенную папку zabbix_agent2.d\plugins.d.

Кроме того, zabbix_agentd.exe (или zabbix_agent2.exe) будет настроен как служба Windows с отложенным автоматическим запуском (или с автоматическим запуском в версиях Windows до Windows Vista/Server 2008).

Если во время установки запущена другая версия агента Zabbix, вам будет предложено закрыть приложение и попытаться перезапустить его либо оставить его открытым; в последнем случае потребуется перезагрузка.

7. Нажмите кнопку Finish, чтобы выйти из мастера установки.

Установка из командной строки

Агент Zabbix можно установить из командной строки, запустив установщик MSI с помощью msiexec. Например:

msiexec.exe /l*v "C:\package.log" /i "C:\zabbix_agent-8.0.0-windows-amd64-openssl.msi" /qn+ SERVER=192.0.2.1

Этот метод позволяет выполнять установку без участия пользователя и использовать пользовательские конфигурации с помощью параметров.

Поддерживаемые параметры

Пакеты MSI-установщика агента Zabbix поддерживают следующие параметры как для агента Zabbix, так и для агента Zabbix 2.

Параметры агента Zabbix/агента Zabbix 2 задаются в файле конфигурации во время установки. Нажмите имя параметра, чтобы просмотреть его подробное описание и примеры настройки на странице агент Zabbix (Windows). Для агента Zabbix 2 см. страницу агент Zabbix 2 (Windows).

Параметр Описание
ADDDEFAULT Список разделённых запятыми компонентов, которые необходимо установить с конфигурацией по умолчанию. Дополнительную информацию см. в разделе свойство ADDDEFAULT.
Возможные значения: AgentProgram, GetProgram, SenderProgram, ALL
Пример: ADDDEFAULT=AgentProgram,GetProgram
ADDLOCAL Список разделённых запятыми компонентов, которые необходимо установить локально. Дополнительную информацию см. в разделе свойство ADDLOCAL.
Возможные значения: AgentProgram, GetProgram, SenderProgram, ALL
Пример: ADDLOCAL=AgentProgram,SenderProgram
ALLOWDENYKEY Список разделённых точками с запятой параметров AllowKey или DenyKey для ограничения проверок агента Zabbix. При необходимости используйте обратную косую черту для экранирования разделителя (\;). Задаёт параметры AllowKey и DenyKey в файле конфигурации агента.
Пример: ALLOWDENYKEY="AllowKey=system.run[more C:\Windows\System32\drivers\etc\hosts\\; echo 'File read complete'];DenyKey=system.run[*]"
CONF Полное имя пути к шаблону файла конфигурации для агента Zabbix. Во время установки этот файл станет файлом конфигурации агента. Файл должен содержать как минимум параметры Server и LogFile.
Пример: CONF="C:\full\path\to\example.conf"
DONOTSTART Используйте DONOTSTART=1, чтобы запретить MSI-установщику запускать службу агента Zabbix.
ENABLEPATH Используйте ENABLEPATH=1, чтобы добавить расположение агента Zabbix в системную переменную PATH.
ENABLEPERSISTENTBUFFER Только для агента Zabbix 2. Включает использование локального постоянного хранилища для активных элементов данных.
HOSTINTERFACE Необязательный параметр, определяющий интерфейс узла сети.
HOSTMETADATA Необязательный параметр, определяющий метаданные узла сети.
HOSTMETADATAITEM Необязательный параметр, определяющий элемент данных, используемый для получения метаданных узла сети.
HOSTNAME Необязательный параметр, определяющий имя узла сети.
HOSTNAMEITEM Необязательный параметр, определяющий элемент данных, используемый для получения имени узла сети.
INCLUDE Список разделённых точками с запятой отдельных файлов или всех файлов в каталоге, которые необходимо включить в файл конфигурации агента Zabbix.
IGNOREALREADYEXISTSFOLDER Для новых установок используйте IGNOREALREADYEXISTSFOLDER=1, чтобы разрешить установку в существующую папку назначения за пределами каталога Program Files. Если этот параметр не указан, установка завершается ошибкой, когда такая папка назначения уже существует.
INSTALLFOLDER Полное имя пути к папке, в которую будут установлены компоненты Zabbix и файл конфигурации агента Zabbix. Для агента Zabbix 2 дополнительные файлы конфигурации встроенных плагинов будут установлены во вложенную папку zabbix_agent2.d\plugins.d.
Пример: INSTALLFOLDER="C:\Program Files\Zabbix Agent"
LISTENIP Список разделённых запятыми IP-адресов, на которых агент должен принимать подключения.
LISTENPORT Порт, на котором агент будет принимать подключения от сервера.
LOGFILE Имя файла журнала агента Zabbix.
LOGTYPE Тип вывода журнала.
NONMSICONFNAME Полное имя пути к пользовательскому файлу конфигурации для агента Zabbix. Во время установки все допустимые параметры конфигурации агента, присутствующие в этом файле (ограниченные параметрами, перечисленными в этой таблице), будут записаны в созданный файл конфигурации агента. Файл должен содержать как минимум параметр Server.
Пример: NONMSICONFNAME="C:\full\path\to\example.conf"
PERSISTENTBUFFERFILE Только для агента Zabbix 2. Файл, в котором агент Zabbix 2 должен хранить базу данных SQLite.
PERSISTENTBUFFERPERIOD Только для агента Zabbix 2. Период времени, в течение которого должны храниться данные при отсутствии подключения к серверу или прокси.
SERVER Список разделённых запятыми IP-адресов, при необходимости в нотации CIDR, или DNS-имён серверов Zabbix или прокси Zabbix. Этот параметр является обязательным, кроме случая, когда STARTAGENTS имеет значение 0.
SERVERACTIVE Адрес сервера/прокси Zabbix или конфигурация кластера, откуда получать активные проверки.
SKIP Используйте SKIP=fw, чтобы запретить MSI-установщику добавлять правило-исключение в брандмауэр Windows для агента Zabbix.
SOURCEIP Исходный IP-адрес для исходящих подключений к серверу Zabbix или прокси Zabbix либо для установления подключений при выполнении некоторых элементов данных (web.page.get, net.tcp.port и т. д.).
STARTAGENTS Количество предварительно разветвлённых экземпляров zabbix_agentd, обрабатывающих пассивные проверки.
Если задано значение 0, пассивные проверки отключаются, и агент не будет прослушивать ни один TCP-порт.
STARTUPTYPE Тип запуска службы агента Zabbix. Возможные значения:
automatic - запускать службу автоматически при запуске Windows;
delayed - (по умолчанию) отложить запуск службы до завершения запуска автоматически запущенных служб (доступно в Windows Vista/Server 2008 и более поздних версиях);
manual - запускать службу вручную (пользователем или приложением);
disabled - отключить службу, чтобы пользователь или приложение не могли её запустить.
Пример: STARTUPTYPE=disabled
STATUSPORT Только для агента Zabbix 2. Если задано, агент будет прослушивать этот порт для HTTP-запросов состояния (http://localhost:<port>/status).
TIMEOUT Определяет, сколько времени (в секундах) ожидать установления подключения и обмена данными с прокси или сервером Zabbix.
TLSACCEPT Входящие подключения, которые необходимо принимать (используется для пассивных проверок). Если задано значение psk, TLSCONNECT также будет установлено в psk (если не указано иное).
TLSCAFILE Полное имя пути к файлу, содержащему сертификаты корневого центра сертификации для проверки сертификата узла сети.
TLSCERTFILE Полное имя пути к файлу, содержащему сертификат агента или цепочку сертификатов.
TLSCONNECT Способ подключения агента к серверу или прокси Zabbix (используется для активных проверок). Если задано значение psk, TLSACCEPT также будет установлено в psk (если не указано иное).
TLSCRLFILE Полное имя пути к файлу, содержащему отозванные сертификаты.
TLSKEYFILE Полное имя пути к файлу, содержащему закрытый ключ агента Zabbix.
TLSPSKFILE Полное имя пути к файлу, содержащему предварительно установленный ключ агента Zabbix. Если заданы TLSPSKFILE и TLSPSKVALUE, значение TLSPSKVALUE будет записано в файл, указанный в TLSPSKFILE. Рекомендуется ограничить доступ к файлу предварительно установленного ключа, изменив параметры безопасности файла так, чтобы его мог читать только агент Zabbix (или пользователь, от имени которого запущен агент).
TLSPSKIDENTITY Строка идентификатора предварительно установленного ключа.
TLSPSKVALUE Строковое значение предварительно установленного ключа. Если заданы TLSPSKFILE и TLSPSKVALUE, значение TLSPSKVALUE будет записано в файл, указанный в TLSPSKFILE.
Пример: TLSPSKVALUE=1f87b595725ac58dd977beef14b97461a7c1045b9a1c963065002c5473194952
TLSSERVERCERTISSUER Разрешённый издатель сертификата сервера (прокси).
TLSSERVERCERTSUBJECT Разрешённое имя субъекта сертификата сервера (прокси).
UNSAFEUSERPARAMETERS Разрешает передавать любые символы в аргументах пользовательских параметров.
Примеры

Следующий пример устанавливает агент Zabbix с пользовательской конфигурацией. Он также включает поддержку TLS с использованием предварительно общих ключей.

mkdir "C:\Program Files\Zabbix Agent" 2>nul
msiexec.exe /l*v "C:\package.log" /i "C:\zabbix_agent-8.0.0-windows-amd64-openssl.msi" /qn+^
 SERVER=192.0.2.1^
 INSTALLFOLDER="C:\Program Files\Zabbix Agent"^
 HOSTNAME=LAPTOP-IKP7S51S^
 TLSACCEPT=psk^
 TLSCONNECT=psk^
 TLSPSKIDENTITY="PSK 001"^
 TLSPSKFILE="C:\Program Files\Zabbix Agent\psk.key"^
 TLSPSKVALUE=1f87b595725ac58dd977beef14b97461a7c1045b9a1c963065002c5473194952^
 ENABLEPATH=1^
 ALLOWDENYKEY="AllowKey=system.run[type C:\Windows\System32\drivers\etc\hosts];DenyKey=system.run[*]"

Следующий пример устанавливает более новую версию агента Zabbix и использует файл конфигурации шаблона (CONF="C:\agent-template.conf"). Во время установки этот файл станет файлом конфигурации агента. Чтобы унаследовать параметры из старого файла конфигурации, используйте заполнители параметров (например, [AllowDenyKey]).

msiexec.exe /l*v "C:\package.log" /i "C:\zabbix_agent-8.0.1-windows-amd64-openssl.msi" /qn+ NONMSICONFNAME="C:\agent.conf"

# agent-template.conf example:
LogFile=[LogFile]
[AllowDenyKey]
Server=192.0.2.8
Hostname=DESKTOP-X9F4A2B
[Include]
[TLSConnect]
[TLSAccept]
[TLSPSKIdentity]
[TLSPSKFile]

В качестве альтернативы можно использовать пользовательский файл конфигурации (NONMSICONFNAME="C:\agent-custom.conf"). Во время установки любые допустимые параметры конфигурации агента, присутствующие в этом файле (ограниченные перечисленными в таблице выше), будут записаны в новый созданный файл конфигурации агента. Чтобы сохранить существующую конфигурацию агента, определите параметры, которые нужно сохранить.

msiexec.exe /l*v "C:\package.log" /i "C:\zabbix_agent-8.0.1-windows-amd64-openssl.msi" /qn+ NONMSICONFNAME="C:\agent-custom.conf"

# agent-custom.conf example:
Server=192.0.2.8
Hostname=DESKTOP-X9F4A2B

Загружаемые плагины агента Zabbix 2

Загружаемые плагины агента Zabbix 2 можно устанавливать в Windows с помощью 64-разрядных пакетов MSI, доступных для скачивания.

Минимальные требования к ОС для установки MSI: Windows 10 (64-разрядная версия) или Windows Server 2016.

Перед установкой плагина ознакомьтесь с его файлом README. В нем могут содержаться особые требования и инструкции по установке.

Как и агент Zabbix/agent2, загружаемые плагины можно устанавливать с помощью мастера установки или из командной строки.

Установка с помощью мастера установки

1. Дважды щелкните загруженный MSI-файл, чтобы начать установку.

2. Примите лицензионное соглашение с конечным пользователем.

3. Выберите загружаемые плагины агента Zabbix 2 для установки.

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

4. Нажмите Install, чтобы начать установку.

Все выбранные загружаемые плагины агента Zabbix 2 будут установлены в указанное вами расположение (по умолчанию: C:\Program Files\Zabbix Agent 2), а их файлы конфигурации будут установлены в подкаталог zabbix_agent2.d.

5. Нажмите кнопку Finish, чтобы выйти из мастера установки.

Установка из командной строки

Загружаемые плагины агента Zabbix 2 можно установить из командной строки, запустив установщик MSI с помощью msiexec. Например:

msiexec.exe /l*v "C:\package.log" /i "C:\zabbix_agent2_plugins-8.0.0-windows-amd64.msi" /qn+

Пакеты установщика MSI загружаемых плагинов агента Zabbix 2 поддерживают следующие параметры.

Parameter Description
ADDDEFAULT Список разделенных запятыми компонентов, которые необходимо установить с конфигурацией по умолчанию. Дополнительную информацию см. в разделе ADDDEFAULT property.
Возможные значения: ALL, CephPlugin, EmberplusPlugin, MongodbPlugin, MssqlPlugin, NvidiagpuPlugin, PostgresqlPlugin
Пример: ADDDEFAULT=MongodbPlugin,PostgresqlPlugin
ADDLOCAL Список разделенных запятыми компонентов, которые необходимо установить локально. Дополнительную информацию см. в разделе ADDLOCAL property.
Возможные значения: ALL, CephPlugin, EmberplusPlugin, MongodbPlugin, MssqlPlugin, NvidiagpuPlugin, PostgresqlPlugin
Пример: ADDLOCAL=MongodbPlugin,MssqlPlugin
INSTALLFOLDER Полный путь к папке, в которую будут установлены компоненты Zabbix, а их файлы конфигурации будут размещены в подпапке zabbix_agent2.d.
Пример: INSTALLFOLDER="C:\Program Files\Zabbix Agent 2"