1. Установка агента для 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 агента, так и для Zabbix агента 2.

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

2. Примите лицензионное соглашение:

3. Выберите компоненты Zabbix для установки — демон Zabbix агента, Zabbix sender, Zabbix get:

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

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

Параметр Описание
Host name Имя узла сети машины, на которую устанавливается Zabbix агент. Задаёт параметр Hostname.
Zabbix server IP/DNS Список (через запятую) IP-адресов, опционально в нотации CIDR, или DNS-имён Zabbix серверов или Zabbix прокси. Этот параметр обязателен. Устанавливает параметр Server.
Agent listen port Порт, который будет слушать агент на предмет подключений со стороны сервера. Устанавливает параметр ListenPort.
Server or Proxy for active checks Адрес сервера/прокси Zabbix либо конфигурация кластера для получения активных проверок. Адрес сервера/прокси — это IP-адрес или DNS-имя и необязательный порт через двоеточие. Устанавливает параметр ServerActive.
Enable PSK Отметьте флажок, чтобы включить поддержку TLS с использованием общего ключа (pre-shared key). Устанавливает параметры TLSConnect и TLSAccept в значение psk.
Add agent location to the PATH Отметьте флажок, чтобы добавить местоположение агента в системную переменную PATH.

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

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

Параметр Описание
Pre-shared key identity Строка идентификатора общего ключа (PSK). Устанавливает параметр TLSPSKIdentity.
Pre-shared key value Значение строки общего ключа. Создаёт файл psk.key, содержащий ключ, и устанавливает параметр TLSPSKFile в местоположение ключа (по умолчанию: C:\Program Files\Zabbix Agent\psk.key). Рекомендуется ограничить доступ к файлу общего ключа, изменив настройки безопасности файла таким образом, чтобы прочитать его мог только Zabbix агент (или пользователь, запускающий агента).

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

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

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

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

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

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

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

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

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

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

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

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

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

mkdir "C:\Program Files\Zabbix Agent" 2>nul
msiexec.exe /l*v "C:\package.log" /i "C:\zabbix_agent-7.4.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-7.4.1-windows-amd64-openssl.msi" /qn+ NONMSICONFNAME="C:\agent.conf"

# пример agent-template.conf:
LogFile=[LogFile]
[AllowDenyKey]
Server=192.0.2.8
Hostname=DESKTOP-X9F4A2B
[Include]
[TLSConnect]
[TLSAccept]
[TLSPSKIdentity]
[TLSPSKFile]

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

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

# пример agent-custom.conf:
Server=192.0.2.8
Hostname=DESKTOP-X9F4A2B

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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