Documentation
Table of Contents
4. Установка агента для Windows из MSI
Обзор
Zabbix агента для Windows можно установить из пакетов установщика Windows MSI (32-бит или 64-бит), доступных для загрузки.
32-битный пакет нельзя установить на 64-битную Windows.
Минимальные требования для MSI установки:
- Windows XP 64-бит и Сервер 2003 для Zabbix агента;
- Windows 10 32-бит и Сервер 2016 для Zabbix агента 2.
Утилиты Zabbix get и sender также могут быть установлены либо вместе с Zabbix агентом / агентом 2, либо отдельно.
Все пакеты поставляются с поддержкой TLS, однако, настройка TLS опциональна.
Поддерживается инсталляция как через UI, так и через командную строку.
Хотя установка Zabbix из пакетов установщика MSI полностью поддерживается, рекомендуется установить, как минимум, Microsoft .NET Framework 2 для правильной обработки ошибок. Смотрите Загрузка Microsoft .NET Framework.
Рекомендуется использовать пути по умолчанию, предоставленные установщиком, поскольку использование пользовательских путей без соответствующих разрешений может поставить под угрозу безопасность установки.
Шаги установки
Для установки дважды щёлкните на загруженном MSI файле.
Примите лицензионное соглашение, чтобы перейти на следующий шаг.
Укажите следующие параметры.
| Параметр | Описание |
|---|---|
| Host name | Имя узла сети. |
| Zabbix server IP/DNS | IP/DNS сервера Zabbix. |
| Agent listen port | Порт, который будет слушать агент (10050 по умолчанию). |
| Server or Proxy for active checks | IP/DNS сервера/прокси Zabbix для активных проверок агента. |
| Enable PSK | Отметьте, чтобы включить поддержку TLS с использованием общего ключа (pre-shared key). |
| Add agent location to the PATH | Добавление местоположения агента в переменную PATH. |
Введите идентификатор и значение общего ключа. Этот шаг доступен, только если в предыдущем шаге вы отметили опцию Enable PSK.
Выберите компоненты Zabbix для установки — демон Zabbix агента, Zabbix sender, Zabbix get.
Zabbix компоненты вместе с файлом конфигурации будут установлены в папку Zabbix Agent в Program Files. zabbix_agentd.exe будет настроен в качестве службы Windows с отложенным автоматическим запуском (или автоматическим запуском в версиях Windows до Windows Server 2008/Vista).
Установка через командную строку
Поддерживаемые параметры
Созданные MSI пакеты поддерживают следующий набор параметров.
| Параметр | Описание |
|---|---|
| ADDDEFAULT | Список программ (через запятую) для установки в их конфигурации по умолчанию. Возможные значения: AgentProgram, GetProgram, SenderProgram, ALL.Пример: ADDDEFAULT=AgentProgram,GetProgram |
| ADDLOCAL | Список программ (через запятую) для установки локально. Возможные значения: AgentProgram, GetProgram, SenderProgram, ALL.Пример: ADDLOCAL=AgentProgram,SenderProgram |
| ALLOWDENYKEY | Последовательность параметров "AllowKey" и "DenyKey" (через точку с запятой ;)Используйте \\; для экранирования разделителя.Пример: ALLOWDENYKEY="AllowKey=system.run[type c:\windows\system32\drivers\etc\hosts];DenyKey=system.run[*]" |
| CONF | Полный путь к пользовательскому файлу конфигурации. Пример: CONF=c:\full\path\to\user.conf |
| ENABLEPATH | Добавить местоположение агента в переменную PATH. |
| ENABLEPERSISTENTBUFFER | Только Zabbix агент 2. Включить использование локального постоянного хранилища для активных элементов данных. |
| HOSTINTERFACE | Необязательный параметр, определяющий интерфейс узла сети. |
| HOSTMETADATA | Необязательный параметр, определяющий метаданные узла сети. |
| HOSTMETADATAITEM | Необязательный параметр, определяющий элемент данных агента Zabbix, используемый для получения метаданных узла сети. |
| HOSTNAME | Необязательный параметр, определяющий имя узла сети. |
| INCLUDE | Последовательность включений (через точку с запятой «;»). |
| INSTALLFOLDER | Полный путь к папке, в которую будут установлены компоненты Zabbix вместе с файлом конфигурации. |
| LISTENIP | Список IP-адресов (через запятую), на которых должен прослушивать агент. |
| LISTENPORT | Агент будет прослушивать этот порт на предмет подключений с сервера. |
| LOGFILE | Имя файла журнала. |
| LOGTYPE | Тип вывода журнала. |
| PERSISTENTBUFFERFILE | Только Zabbix агент 2. Файл, в котором Zabbix агент 2 должен хранить базу данных SQLite. |
| PERSISTENTBUFFERPERIOD | Только Zabbix агент 2. Период времени, в течение которого должны храниться данные при отсутствии подключения к серверу или прокси. |
| SERVER | Список (через запятую) IP-адресов (возможно, в нотации CIDR) или DNS-имён серверов Zabbix и прокси-серверов Zabbix. |
| SERVERACTIVE | Адрес сервера/прокси-сервера Zabbix или конфигурация кластера для получения активных проверок. |
| SKIP | SKIP=fw — не устанавливать правило исключения брандмауэра. |
| STARTUPTYPE | Тип запуска службы Windows агента/агента 2 Zabbix. Возможные значения:automatic — автоматически запускать службу при запуске Windows;delayed — (по умолчанию) отложить запуск службы до завершения запуска автоматически запущенных служб (доступно в Windows Server 2008/Vista и более поздних версиях);manual — запустить службу вручную (пользователем или приложением);disabled — отключить службу, чтобы ее не мог запустить пользователь или приложение.Пример: STARTUPTYPE=disabled |
| STATUSPORT | Только Zabbix агент 2. Если установлено, агент будет прослушивать этот порт на предмет HTTP-запросов состояния (http://localhost:<порт>/status). |
| TIMEOUT | Указывает тайм-аут для связи (в секундах). |
| TLSACCEPT | Какие входящие соединения принимать. |
| TLSCAFILE | Полный путь к файлу, содержащему сертификаты CA верхнего уровня для проверки сертификатов узла, используемых для зашифрованных коммуникаций между компонентами Zabbix. |
| TLSCERTFILE | Абсолютный путь к файлу, содержащему сертификат или цепочку сертификатов агента, используемых для зашифрованных соединений между компонентами Zabbix. |
| TLSCONNECT | Как агент должен подключаться к Zabbix серверу или прокси. |
| TLSCRLFILE | Абсолютный путь к файлу, содержащему отозванные сертификаты. Этот параметр используется для зашифрованных коммуникаций между компонентами Zabbix. |
| TLSKEYFILE | Абсолютный путь к файлу, содержащему закрытый ключ (private key) агента, используемый для зашифрованных коммуникаций между компонентами Zabbix. |
| TLSPSKFILE | Абсолютный путь к файлу, содержащему общий ключ (pre-shared key) агента, используемый для зашифрованных коммуникаций с сервером Zabbix. |
| TLSPSKIDENTITY | Строка идентификатора общего ключа, используемого для зашифрованных соединений с сервером Zabbix. |
| TLSPSKVALUE | Значение строки общего ключа, используемого для зашифрованных соединений с сервером Zabbix. |
| TLSSERVERCERTISSUER | Разрешённый эмитент сертификата сервера (прокси). |
| TLSSERVERCERTSUBJECT | Разрешённый субъект сертификата сервера (прокси). |
Примеры
Чтобы установить агент Zabbix для Windows из командной строки, вы можете запустить, например:
SET INSTALLFOLDER=C:\Program Files\Zabbix Agent
msiexec /l*v log.txt /i zabbix_agent-7.0.0-x86.msi /qn^
LOGTYPE=file^
LOGFILE="%INSTALLFOLDER%\zabbix_agentd.log"^
SERVER=192.168.6.76^
LISTENPORT=12345^
SERVERACTIVE=::1^
HOSTNAME=myHost^
TLSCONNECT=psk^
TLSACCEPT=psk^
TLSPSKIDENTITY=MyPSKID^
TLSPSKFILE="%INSTALLFOLDER%\mykey.psk"^
TLSCAFILE="c:\temp\f.txt1"^
TLSCRLFILE="c:\temp\f.txt2"^
TLSSERVERCERTISSUER="My CA"^
TLSSERVERCERTSUBJECT="My Cert"^
TLSCERTFILE="c:\temp\f.txt5"^
TLSKEYFILE="c:\temp\f.txt6"^
ENABLEPATH=1^
INSTALLFOLDER="%INSTALLFOLDER%"^
SKIP=fw^
ALLOWDENYKEY="DenyKey=vfs.file.contents[/etc/passwd]"Вы также можете запустить, например:
msiexec /l*v log.txt /i zabbix_agent-7.0.0-x86.msi /qn^
SERVER=192.168.6.76^
TLSCONNECT=psk^
TLSACCEPT=psk^
TLSPSKIDENTITY=MyPSKID^
TLSPSKVALUE=1f87b595725ac58dd977beef14b97461a7c1045b9a1c963065002c5473194952Если переданы оба параметра — и TLSPSKFILE, и TLSPSKVALUE, то TLSPSKVALUE будет записано в TLSPSKFILE.