Установка агента Windows из MSI
Обзор
агент Zabbix можно установить в Windows с помощью 32-битных или 64-битных MSI-пакетов установки, доступных для загрузки.
Минимальные требования к ОС для установки из MSI:
- Для агента Zabbix: Windows XP (64-bit) или Windows Server 2003
- Для агента Zabbix 2: Windows 10 (32-bit) или Windows Server 2016
32-битные пакеты нельзя устанавливать в 64-битных системах.
Пакеты включают:
- поддержку TLS (настройка TLS необязательна)
- утилиты Zabbix get и Zabbix sender (могут быть установлены вместе с агентом Zabbix/агентом 2 или отдельно)
Пакеты агента Zabbix 2 не включают загружаемые плагины (MongoDB, PostgreSQL, MSSQL), которые необходимо загрузить и установить отдельно.
Установка может быть выполнена с помощью мастера установки или командной строки.
Хотя установка с использованием MSI-пакетов полностью поддерживается, для корректной обработки ошибок рекомендуется установить как минимум Microsoft .NET Framework 2.
Рекомендуется использовать расположение установки по умолчанию, предлагаемое установщиком. Использование пользовательского расположения без необходимых разрешений может поставить под угрозу безопасность установки.
Установка с помощью мастера установки
Следующие шаги установки применимы как к Zabbix агент, так и к Zabbix агент 2.
1. Дважды щелкните загруженный MSI-файл, чтобы начать установку:

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

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

4. Настройте следующие параметры. Их значения будут заданы в файле конфигурации Zabbix агент:
| Параметр | Описание |
|---|---|
| Имя узла сети | Имя узла сети машины, на которой устанавливается 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 агент:
| Параметр | Описание |
|---|---|
| Идентификатор предварительно разделяемого ключа | Строка идентификатора предварительно разделяемого ключа. Задает параметр TLSPSKIdentity. |
| Значение предварительно разделяемого ключа | Строковое значение предварительно разделяемого ключа. Создает файл 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 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.0
Этот метод позволяет выполнять автоматическую установку без участия пользователя и использовать пользовательские параметры конфигурации.
Поддерживаемые параметры
Пакеты MSI-установщика Zabbix агент поддерживают следующие параметры как для Zabbix агент, так и для Zabbix агент 2.
Параметры Zabbix агент/agent2 задаются в файле конфигурации во время установки. Нажмите на имя параметра, чтобы просмотреть его подробное описание и примеры настройки на странице 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 агент. |
| 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.0^
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:
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:
Server=192.0.2.8
Hostname=DESKTOP-X9F4A2B
Подключаемые плагины Zabbix агент 2
Подключаемые плагины Zabbix агент 2 loadable plugins можно установить в Windows с помощью 64-разрядных пакетов установщика MSI, доступных для загрузки.
Минимальные требования к ОС для установки MSI — Windows 10 (64-bit) или 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. Возможные значения: ALL, CephPlugin, EmberplusPlugin, MongodbPlugin, MssqlPlugin, NvidiagpuPlugin, PostgresqlPluginПример: ADDDEFAULT=MongodbPlugin,PostgresqlPlugin |
| ADDLOCAL | Список компонентов, разделённых запятыми, для локальной установки. Дополнительную информацию смотрите в свойстве ADDLOCAL. Возможные значения: ALL, CephPlugin, EmberplusPlugin, MongodbPlugin, MssqlPlugin, NvidiagpuPlugin, PostgresqlPluginПример: ADDLOCAL=MongodbPlugin,MssqlPlugin |
| INSTALLFOLDER | Полный путь к папке, в которую будут установлены компоненты Zabbix, а их файлы конфигурации будут установлены в подпапку zabbix_agent2.d.Пример: INSTALLFOLDER="C:\Program Files\Zabbix Agent 2" |