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 agent, так и к Zabbix agent 2.
1. Дважды щелкните по загруженному MSI-файлу, чтобы начать установку:

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

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

Если используется пользовательское расположение вне каталога Program Files, и целевая папка уже существует, установщик не изменит ее разрешения.
При новой установке вам будет предложено либо вручную задать соответствующие разрешения, либо продолжить без их изменения.
4. Настройте следующие параметры. Их значения будут записаны в файл конфигурации Zabbix agent:
| Parameter | Description |
|---|---|
| Host name | Имя узла сети, на котором устанавливается Zabbix agent. Устанавливает параметр 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 с использованием предварительно общего ключа. Устанавливает параметры TLSConnect и TLSAccept в значение psk. |
| Add agent location to the PATH | Установите флажок, чтобы добавить расположение Zabbix agent в системную переменную PATH. |
Если обнаружен уже установленный Zabbix agent, будут отображены значения параметров из его файла конфигурации. Кроме того, существующий файл конфигурации будет переименован во время установки, а новый файл конфигурации будет создан.

5. Настройте параметры PSK, если на предыдущем шаге вы установили флажок Enable PSK. Эти параметры также будут записаны в файл конфигурации Zabbix agent:
| Parameter | Description |
|---|---|
| Pre-shared key identity | Строка идентификатора предварительно общего ключа. Устанавливает параметр TLSPSKIdentity. |
| Pre-shared key value | Строковое значение предварительно общего ключа. Создает файл psk.key, содержащий ключ, и устанавливает параметр TLSPSKFile в расположение ключа (по умолчанию: C:\Program Files\Zabbix Agent\psk.key). Рекомендуется ограничить доступ к файлу предварительно общего ключа, настроив параметры безопасности файла так, чтобы его мог читать только Zabbix agent (или пользователь, от имени которого запущен агент). |

6. Нажмите Install, чтобы начать установку.
Все выбранные компоненты Zabbix и файл конфигурации Zabbix agent будут установлены в указанное вами расположение (по умолчанию: 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 agent, вам будет предложено либо закрыть приложение и попытаться запустить его снова, либо оставить его открытым, в этом случае потребуется перезагрузка.

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

Установка из командной строки
Zabbix агент можно установить из командной строки, запустив установщик MSI msiexec [en]. Например:
msiexec.exe /l*v "C:\package.log" /i "C:\zabbix_agent-7.0.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.0.22. |
| ENABLEPATH | Используйте ENABLEPATH=1, чтобы добавить расположение Zabbix agent в системную переменную PATH. |
| ENABLEPERSISTENTBUFFER | Только Zabbix agent 2. Включает использование локального постоянного хранилища для активных элементов данных. |
| HOSTINTERFACE | Необязательный параметр, определяющий интерфейс узла сети. |
| HOSTMETADATA | Необязательный параметр, определяющий метаданные узла сети. |
| HOSTMETADATAITEM | Необязательный параметр, определяющий элемент данных, используемый для получения метаданных узла сети. |
| HOSTNAME | Необязательный параметр, определяющий имя узла сети. |
| HOSTNAMEITEM | Необязательный параметр, определяющий элемент данных, используемый для получения имени узла сети. Поддерживается в пакетах MSI-установщика начиная с Zabbix 7.0.22. |
| INCLUDE | Список отдельных файлов или всех файлов в каталоге, разделенных точкой с запятой, которые следует включить в файл конфигурации Zabbix agent. |
| IGNOREALREADYEXISTSFOLDER | Для новых установок используйте IGNOREALREADYEXISTSFOLDER=1, чтобы разрешить установку в существующую целевую папку вне каталога Program Files. Если этот параметр не указан, установка завершится ошибкой, если такая целевая папка уже существует. |
| 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.0.22. |
| STARTAGENTS | Количество предварительно порожденных экземпляров zabbix_agentd, обрабатывающих пассивные проверки. Если установлено значение 0, пассивные проверки отключаются, и агент не будет прослушивать ни один TCP-порт. Поддерживается в пакетах MSI-установщика начиная с Zabbix 7.0.22. |
| 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 | Полный путь к файлу, содержащему сертификаты корневого CA(ов) для проверки сертификата узла. |
| 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.0.22. |
Примеры
Следующий пример устанавливает Zabbix агента с пользовательскими настройками. Он также включает поддержку использования общих ключей (pre-shared keys) TLS.
mkdir "C:\Program Files\Zabbix Agent" 2>nul
msiexec.exe /l*v "C:\package.log" /i "C:\zabbix_agent-7.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-7.0.1-windows-amd64-openssl.msi" /qn+ CONF="C:\agent-template.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-7.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 можно установить на Windows с помощью 64-битных пакетов MSI инсталлятора, доступных для загрузки. Плагин Ember+ включён в эти пакеты с версии Zabbix 7.0.10.
Минимальные требования к ОС для установки MSI: Windows 10 (64-разрядная версия) или Windows Server 2016.
Как и Zabbix агент/агент2, подгружаемые плагины можно установить с помощью мастера установки или командной строки.
Перед установкой плагина, пожалуйста, проверьте его файл README. Он может содержать особые требования и инструкции по установке.
Установка с помощью мастера настройки
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-7.0.0-windows-amd64.msi" /qn+
Пакеты MSI инсталлятора подгружаемых модулей Zabbix агента 2 поддерживают следующие параметры.
| Параметр | Описание |
|---|---|
| ADDDEFAULT | Список компонентов (через запятую) для установки в их конфигурации по умолчанию. Для получения дополнительной информации смотрите свойство ADDDEFAULT. Возможные значения: ALL, EmberplusPlugin, MongodbPlugin, MssqlPlugin, PostgresqlPluginПример: ADDDEFAULT=MongodbPlugin,PostgresqlPlugin |
| ADDLOCAL | Список компонентов (через запятую) для установки локально. Для получения дополнительной информации смотрите свойство ADDLOCAL. Возможные значения: ALL, EmberplusPlugin, MongodbPlugin, MssqlPlugin, PostgresqlPluginПример: ADDLOCAL=MongodbPlugin,MssqlPlugin |
| INSTALLFOLDER | Абсолютный путь к папке, куда будут установлены компоненты Zabbix, с их файлами конфигурации, установленными в подпапку zabbix_agent2.d.Пример: INSTALLFOLDER="C:\Program Files\Zabbix Agent 2" |