4. Установка агента для 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 [en]. Например:

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

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

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

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

Параметры 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[type c:\windows\system32\drivers\etc\hosts];DenyKey=system.run[*]"
CONF Полный путь к пользовательскому файлу конфигурации Zabbix агента. Во время установки этот файл полностью заменит содержимое нового либо существующего конфигурационного фавйла агента. Файл должен содержать как минимум параметры Server и LogFile.
Пример: CONF="C:\абсолютный\путь\к\example.conf"
ENABLEPATH Используйте ENABLEPATH=1, чтобы добавить местоположение агента в системную переменную PATH.
ENABLEPERSISTENTBUFFER Только Zabbix агент 2. Включить использование локального постоянного хранилища для активных элементов данных.
HOSTINTERFACE Необязательный параметр, определяющий интерфейс узла сети.
HOSTMETADATA Необязательный параметр, определяющий метаданные узла сети.
HOSTMETADATAITEM Необязательный параметр, определяющий элемент данных Zabbix агента, используемый для получения метаданных узла сети.
HOSTNAME Необязательный параметр, определяющий имя узла сети.
INCLUDE Список (через точку с запятой «;») отдельных файлов или всех файлов в папке, которые нужно включить в конфигурационный файл Zabbix агента.
INSTALLFOLDER Абсолютный путь к папке, в которую будут установлены компоненты Zabbix вместе с файлом конфигурации. Для Zabbix агента 2 дополнительные конфигурационные файлы для встроенных плагинов будут установлены в подпапкуzabbix_agent2.d\plugins.d.
Пример: INSTALLFOLDER="C:\Program Files\Zabbix Agent"
LISTENIP Список IP-адресов (через запятую), на которых должен прослушивать агент.
LISTENPORT Агент будет прослушивать этот порт на предмет подключений с сервера.
LOGFILE Имя файла журнала.
LOGTYPE Тип вывода журнала.
NONMSICONFNAME Абсолютный путь к пользовательскому файлу настроек для Zabbix агента. Во время установки любые корректные параметры конфигурации агента, присутствующие в этом файле (ограниченные перечисленными в данной таблице) заменят соответствующие параметры в новом или существующем конфигурационном файле агента. Файл должен содержать, как минимум, параметр Server.
Пример: NONMSICONFNAME="C:\абсолютный\путь\к\example.conf"
PERSISTENTBUFFERFILE Только Zabbix агент 2. Файл, в котором Zabbix агент 2 должен хранить базу данных SQLite.
PERSISTENTBUFFERPERIOD Только Zabbix агент 2. Период времени, в течение которого должны храниться данные при отсутствии подключения к серверу или прокси.
SERVER Список (через запятую) IP-адресов (возможно, в нотации CIDR) или DNS-имён серверов Zabbix и прокси-серверов Zabbix. Этот параметр обязателен.
SERVERACTIVE Список адресов серверов/прокси-серверов Zabbix или конфигураций кластера для получения активных проверок.
SKIP Используйте SKIP=fw, чтобы MSI инсталлятор не добавлял правило исключения брандмауэра для Zabbix агента.
STARTUPTYPE Тип запуска службы Windows агента Zabbix. Возможные значения:
automatic — автоматически запускать службу при запуске Windows;
delayed(по умолчанию) отложить запуск службы до завершения запуска автоматически запущенных служб (доступно в Windows Server 2008/Vista и более поздних версиях);
manual — запустить службу вручную (пользователем или приложением);
disabled — отключить службу, чтобы её не мог запустить пользователь или приложение.
Пример: STARTUPTYPE=disabled
STATUSPORT Только Zabbix агент 2. Если установлено, агент будет прослушивать этот порт на предмет HTTP-запросов состояния (http://localhost:<порт>/status).
TIMEOUT Указывает, как долго ждать (в секундах) для установления соединения и обмена данными с Zabbix сервером или прокси.
TLSACCEPT Какие входящие соединения принимать (используется для пассивных проверок). Если установлено в psk, то TLSCONNECT также будет установлен в psk (если не указано иначе).
TLSCAFILE Абсолютный путь к файлу, содержащему сертификаты CA верхнего уровня для проверки сертификатов узла.
TLSCERTFILE Абсолютный путь к файлу, содержащему сертификат или цепочку сертификатов агента.
TLSCONNECT Как агент должен подключаться к Zabbix серверу или прокси (используется для активных проверок). Если установлено в psk, то TLSACCEPT также будет установлен в psk (если не указано иначе).
TLSCRLFILE Абсолютный путь к файлу, содержащему отозванные сертификаты.
TLSKEYFILE Абсолютный путь к файлу, содержащему закрытый ключ (private key) агента.
TLSPSKFILE Абсолютный путь к файлу, содержащему общий ключ (pre-shared key) агента. Если заданы как TLSPSKFILE, так и TLSPSKVALUE, то значение TLSPSKVALUE будет записано в файл, указанный в TLSPSKFILE. Рекомендуется ограничить доступ к файлу общего ключа, выставив настройки безопасности файла таким образом, чтобы его мог читать только Zabbix агент (или пользователь, запускающий агента).
TLSPSKIDENTITY Строка идентификатора общего ключа.
TLSPSKVALUE Значение строки общего ключа. Если заданы как TLSPSKFILE, так и TLSPSKVALUE, то значение TLSPSKVALUE будет записано в файл, указанный в TLSPSKFILE.
Пример: TLSPSKVALUE=1f87b595725ac58dd977beef14b97461a7c1045b9a1c963065002c5473194952
TLSSERVERCERTISSUER Разрешённый эмитент сертификата сервера (прокси).
TLSSERVERCERTSUBJECT Разрешённый субъект сертификата сервера (прокси).
Примеры

Следующий пример устанавливает 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.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 агента и использует пользовательский файл настроек, чтобы заменить конкретные параметры (например, Hostname=LAPTOP-IKP7S51S,DESKTOP-X9F4A2B) в существующем файле настроек агента.

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

Подгружаемые плагины Zabbix агента 2

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

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

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

Пакеты не включают плагин Ember+, доступный в данный момент только для сборки из исходного кода (как для Unix, так и для Windows).

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

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

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

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

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

3. Выберите для установки подгружаемые плагины Zabbix агента 2 (MongoDB plugin, PostgreSQL plugin, MSSQL plugin).

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

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.
Возможные значения: MongodbPlugin, PostgresqlPlugin, MssqlPlugin, ALL
Пример: ADDDEFAULT=MongodbPlugin,PostgresqlPlugin
ADDLOCAL Список компонентов (через запятую) для установки локально. Для получения дополнительной информации смотрите свойство ADDLOCAL.
Возможные значения: MongodbPlugin, PostgresqlPlugin, MssqlPlugin, ALL
Пример: ADDLOCAL=MongodbPlugin,MssqlPlugin
INSTALLFOLDER Абсолютный путь к папке, куда будут установлены компоненты Zabbix, с их файлами конфигурации, установленными в подпапку zabbix_agent2.d.
Пример: INSTALLFOLDER="C:\Program Files\Zabbix Agent 2"