4 Инсталација Windows агента из MSI-ја

Преглед

Zabbix агент се може инсталирати на Windows користећи 32-битне или 64-битне MSI инсталационе пакете, доступне за преузимање.

Минимални захтеви оперативног система за MSI инсталацију су:

  • За Zabbix агента: Windows XP (64-битни) или Windows Server 2003
  • За Zabbix агента 2: Windows 10 (32-битни) или 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 компоненте (Agent daemon, Zabbix sender, Zabbix get) које ће бити инсталиране:

Препоручује се коришћење подразумеване локације за инсталацију коју је обезбедио инсталер. Коришћење прилагођене локације без потребних дозвола може угрозити безбедност инсталације.

4. Конфигуришите следеће параметре. Њихове вредности ће бити подешене у конфигурационој датотеци Zabbix агента:

Parameter Description
Име домаћина Име домаћина машине на којој се инсталира Zabbix агент. Поставља параметар Hostname.
Zabbix IP/DNS сервера Листа IP адреса раздвојених зарезима, опционо у CIDR нотацији, или DNS имена Zabbix сервера или Zabbix проксија. Овај параметар је обавезан. Поставља параметар Сервер.
Порт за слушање агента Агент ће слушати на овом порту за везе са сервера. Поставља параметар ListenPort.
Сервер или прокси за активне провере Адреса Zabbix сервера/проксија или конфигурација кластера за добијање активних провера. Адреса сервера/проксија је IP адреса или DNS име и опционо порт одвојени двотачком. Поставља параметар ServerActive.
Омогућавање PSK-а Означите поље за потврду да бисте омогућили TLS подршку користећи унапред дељене кључеве. Поставља параметре TLSConnect и TLSAccept на psk.
Додавање локације агента у PATH Означите поље за потврду да бисте додали локацију Zabbix агента у системску променљиву PATH.

Ако се открије постојећи Zabbix агент, биће приказане вредности параметара из његове конфигурационе датотеке. Поред тога, постојећа конфигурациона датотека ће бити преименована током инсталације и биће креирана нова конфигурациона датотека.

5. Конфигуришите PSK параметре ако сте у претходном кораку означили поље за потврду Омогући PSK. Ови параметри ће такође бити подешени у конфигурационој датотеци Zabbix агента:

Parameter Description
Идентитет унапред дељеног кључа Низ идентитета унапред дељеног кључа. Поставља параметар TLSPSKIdentity.
Вредност унапред дељеног кључа Вредност низа унапред дељеног кључа. Креира датотеку psk.key која садржи кључ и поставља параметар TLSPSKFile на локацију кључа (подразумевано: C:\Program Files\Zabbix Agent\psk.key). Препоручује се да се ограничи приступ датотеци са унапред дељеним кључем подешавањем безбедносних подешавања датотеке тако да је само Zabbix агент (или корисник који покреће агент) може прочитати.

6. Кликните на Инсталирај да бисте започели инсталацију.

Све изабране 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. Кликните на дугме Заврши да бисте изашли из Чаробњака за подешавање.

Инсталација из командне линије

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.0

Ова метода омогућава инсталације без надзора и прилагођене конфигурације коришћењем параметара.

Подржани параметри

MSI инсталациони пакети за Zabbix агент подржавају следеће параметре и за Zabbix агент и за Zabbix агент 2

Параметри Zabbix агента/агента2 се подешавају у конфигурационој датотеци током инсталације. Кликните на име параметра да бисте видели његов детаљан опис и примере конфигурације на страници Zabbix агент (Windows). За Zabbix агента 2, погледајте страницу Zabbix агент 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 агента. Ако је потребно, користите обрнуту косу црту да бисте избегли делимитер (\;). Поставља параметре AllowKey и DenyKey у конфигурационој датотеци агента.
Пример: ALLOWDENYKEY="AllowKey=system.run[type C:\Windows\System32\drivers\etc\hosts];DenyKey=system.run[*]"
CONF Комплетна путања до шаблона конфигурационе датотеке за Zabbix агента. Током инсталације, ова датотека ће постати конфигурациона датотека агента. Датотека мора да садржи најмање параметре Сервер и LogFile.
Пример: CONF="C:\full\path\to\example.conf"
ENABLEPATH Користите ENABLEPATH=1 да бисте додали локацију Zabbix агента у системску PATH променљиву.
ENABLEPERSISTENTBUFFER Само Zabbix агент 2. Омогућите коришћење локалне трајне меморије за активне ставке.
HOSTINTERFACE Опциони параметар који дефинише интерфејс домаћина.
HOSTMETADATA Опциони параметар који дефинише метаподатке домаћина.
HOSTMETADATAITEM Опциони параметар који дефинише ставку која се користи за добијање метаподатака домаћина.
HOSTNAME Опциони параметар који дефинише име домаћина.
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 агента. Током инсталације, сви важећи параметри конфигурације агента присутни у овој датотеци (ограничени на оне наведене у овој табели) биће записани у новокреираној датотеци конфигурације агента. Датотека мора да садржи најмање параметар Сервер.
Пример: NONMSICONFNAME="C:\full\path\to\example.conf"
PERSISTENTBUFFERFILE Само за Zabbix агента 2. Датотека у којој Zabbix агент 2 треба да чува SQLite базу података.
PERSISTENTBUFFERPERIOD Само за Zabbix агента 2. Временски период за који подаци треба да се чувају када нема везе са сервером или проксијем.
[SERVER]](/manual/appendix/config/zabbix_agentd_win#server) Листа IP адреса раздвојених зарезима, опционо у CIDR нотацији, или DNS имену Zabbix сервера или Zabbix проксија. Овај параметар је обавезан.
SERVERACTIVE Адреса Zabbix сервера/проксија или конфигурација кластера за добијање активних провера.
SKIP Користите SKIP=fw да бисте спречили MSI инсталатер да дода правило изузетка Windows заштитног зида за Zabbix агента.
STARTUPTYPE Тип покретања Zabbix агентске услуге. Могуће вредности:
аутоматски - аутоматски покреће сервис при покретању Windows-а;
одложено - (подразумевано) одлаже покретање сервиса након што аутоматски покренути сервиси заврше покретање (доступно на Windows Vista/Server 2008 и новијим верзијама);
ручно - ручно покреће сервис (од стране корисника или апликације);
онемогућено - онемогућава сервис тако да га корисник или апликација не могу покренути.
Пример: STARTUPTYPE=disabled
STATUSPORT Само Zabbix агент 2. Ако је подешено, агент ће слушати на овом порту HTTP захтеве за статус (http://localhost:<port>/status).
TIMEOUT Одређује колико дуго треба чекати (у секундама) за успостављање везе и размену података са Zabbix проксијем или сервером.
TLSACCEPT Долазне везе које треба прихватити (користе се за пасивне провере). Ако је подешено на psk, онда ће TLSCONNECT такође бити подешен на psk (осим ако није другачије наведено).
TLSCAFILE Комплетна путања датотеке која садржи сертификате CA(s) највишег нивоа за peer верификацију сертификата.
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 Наслов дозвољеног сертификата сервера (прокси).
Примери

Следећи пример инсталира 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.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-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"). Током инсталације, сви важећи параметри конфигурације агента присутни у овој датотеци (ограничени на оне наведене у горњој табели) биће записани у новокреирану конфигурациону датотеку агента.

Да бисте задржали постојећу конфигурацију агента, дефинишите параметре који ће бити сачувани.

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:
       Сервер=192.0.2.8
       Име хоста=DESKTOP-X9F4A2B

Додаци за учитавање за Zabbix агент 2

Zabbix агент 2 додаци за учитавање може се инсталирати на Windows помоћу 64-битних MSI инсталационих пакета, доступних за преузимање.

Минимални захтеви оперативног система за MSI инсталацију су Windows 10 (64-битни) или Windows Server 2016.

Пакети укључују:

Пакети не укључују Ember+ додатак, који је тренутно доступан само за изградњу из изворног кода (и за Unix и за Windows).

Пре инсталирања додатка, проверите његову README датотеку. Она може садржати додатне захтеве и упутства за инсталацију специфична за додатак.

Слично као код Zabbix agent/agent2, додаци који се могу учитати могу се инсталирати помоћу чаробњака за подешавање или командне линије.

Инсталирање преко Чаробњака за подешавање

1. Двапут кликните на преузету MSI датотеку да бисте започели инсталацију.

2. Прихватите Уговор о лиценцирању крајњег корисника.

3. Изаберите додатке за учитавање Zabbix агента 2 (MongoDB plugin, PostgreSQL plugin, MSSQL plugin) који треба инсталирати.

Препоручује се коришћење подразумеване локације за инсталирање коју је дао инсталер. Коришћење прилагођене локације без потребних дозвола може угрозити безбедност инсталације.

4. Кликните на Инсталирај да бисте започели инсталацију.

Сви изабрани додаци за учитавање Zabbix агента 2 биће инсталирани на вашу наведену локацију (подразумевано: C:\Program Files\Zabbix Agent 2), са њиховим конфигурационим датотекама инсталираним у поддиректоријуму zabbix_agent2.d.

5. Кликните на дугме Заврши да бисте изашли из Чаробњака за подешавање.

Инсталација из командне линије

Додаци за учитавање Zabbix агента 2 могу се инсталирати из командне линије покретањем MSI инсталера са msiexec. На пример:

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

MSI инсталациони пакети додатака за учитавање Zabbix агента 2 подржавају следеће параметре.

Parameter Description
ADDDEFAULT Листа компоненти раздвојених зарезима које треба инсталирати у њиховој подразумеваној конфигурацији. За више информација, погледајте ADDLOCAL својство.
Могуће вредности: 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"