1 Windows aģenta instalēšana no MSI
Pārskats
Zabbix aģentu var instalēt operētājsistēmā Windows, izmantojot 32 bitu vai 64 bitu MSI instalēšanas pakotnes, kas ir pieejamas lejupielādei.
Minimālās OS prasības MSI instalēšanai ir:
- Zabbix aģentam: Windows XP (64 bitu) vai Windows Server 2003
- Zabbix aģentam 2: Windows 10 (32 bitu) vai Windows Server 2016
32 bitu pakotnes nevar instalēt 64 bitu sistēmās.
Pakotnēs ir iekļauts:
- TLS atbalsts (TLS konfigurācija nav obligāta)
- utilītas Zabbix get un Zabbix sender (tās var instalēt kopā ar Zabbix aģentu/aģentu 2 vai atsevišķi)
Zabbix aģenta 2 pakotnēs nav iekļauti ielādējami spraudņi (MongoDB, PostgreSQL, MSSQL), kas ir jālejupielādē un jāinstalē atsevišķi.
Instalēšanu var veikt, izmantojot iestatīšanas vedni vai komandrindu.
Lai gan instalēšana, izmantojot MSI pakotnes, tiek pilnībā atbalstīta, pareizai kļūdu apstrādei ieteicams instalēt vismaz Microsoft .NET Framework 2.
Ieteicams izmantot instalētāja piedāvāto noklusējuma instalēšanas vietu. Pielāgotas atrašanās vietas izmantošana bez nepieciešamajām atļaujām var apdraudēt instalācijas drošību.
Instalēšana no iestatīšanas vedņa
Tālāk norādītās instalēšanas darbības attiecas gan uz Zabbix aģentu, gan uz Zabbix aģentu 2.
1. Veiciet dubultklikšķi uz lejupielādētā MSI faila, lai sāktu instalēšanu:

2. Pieņemiet galalietotāja licences līgumu:

3. Atlasiet instalējamos Zabbix komponentus (Agent daemon, Zabbix sender, Zabbix get):
Ieteicams izmantot instalētāja piedāvāto noklusējuma instalēšanas vietu. Pielāgotas atrašanās vietas izmantošana bez nepieciešamajām atļaujām var apdraudēt instalācijas drošību.

Ja tiek izmantota pielāgota atrašanās vieta ārpus Program Files direktorijas un mērķa mape jau pastāv, instalētājs nemainīs tās atļaujas.
Jaunas instalēšanas laikā jums tiks piedāvāts vai nu manuāli iestatīt atbilstošās atļaujas, vai turpināt, tās nemainot.
4. Konfigurējiet tālāk norādītos parametrus. To vērtības tiks iestatītas Zabbix aģenta konfigurācijas failā:
| Parameter | Description |
|---|---|
| Host name | Datora hosts nosaukums, kurā tiek instalēts Zabbix aģents. Iestata parametru Hostname. |
| Zabbix server IP/DNS | Ar komatiem atdalīts IP adrešu saraksts, pēc izvēles CIDR notācijā, vai Zabbix serveru vai Zabbix starpniekserveru DNS nosaukumi. Šis parametrs ir obligāts. Iestata parametru Server. |
| Agent listen port | Aģents klausīsies šajā portā uz savienojumiem no servera. Iestata parametru ListenPort. |
| Server or Proxy for active checks | Zabbix servera/starpniekservera adrese vai klastera konfigurācija, no kuras saņemt aktīvās pārbaudes. Servera/starpniekservera adrese ir IP adrese vai DNS nosaukums, kā arī izvēles ports, kas atdalīts ar kolu. Iestata parametru ServerActive. |
| Enable PSK | Atzīmējiet izvēles rūtiņu, lai iespējotu TLS atbalstu izmantojot iepriekš koplietotas atslēgas. Iestata parametrus TLSConnect un TLSAccept uz psk. |
| Add agent location to the PATH | Atzīmējiet izvēles rūtiņu, lai pievienotu Zabbix aģenta atrašanās vietu sistēmas PATH mainīgajam. |
Ja tiek noteikts esošs Zabbix aģents, tiks parādītas tā konfigurācijas faila parametru vērtības. Turklāt esošais konfigurācijas fails instalēšanas laikā tiks pārdēvēts, un tiks izveidots jauns konfigurācijas fails.

5. Konfigurējiet PSK parametrus, ja iepriekšējā solī atzīmējāt izvēles rūtiņu Enable PSK. Šie parametri arī tiks iestatīti Zabbix aģenta konfigurācijas failā:
| Parameter | Description |
|---|---|
| Pre-shared key identity | Iepriekš koplietotās atslēgas identitātes virkne. Iestata parametru TLSPSKIdentity. |
| Pre-shared key value | Iepriekš koplietotās atslēgas virknes vērtība. Izveido failu psk.key, kurā ir atslēga, un iestata parametru TLSPSKFile uz atslēgas atrašanās vietu (noklusējums: C:\Program Files\Zabbix Agent\psk.key). Ir ieteicams ierobežot piekļuvi iepriekš koplietotās atslēgas failam, pielāgojot faila drošības iestatījumus tā, lai to varētu lasīt tikai Zabbix aģents (vai lietotājs, kas palaiž aģentu). |

6. Noklikšķiniet uz Install, lai sāktu instalēšanu.
Visi atlasītie Zabbix komponenti un Zabbix aģenta konfigurācijas fails tiks instalēti jūsu norādītajā atrašanās vietā (noklusējums: C:\Program Files\Zabbix Agent).
Tas pats attiecas uz Zabbix aģentu 2, izņemot to, ka tā iebūvēto spraudņu papildu konfigurācijas faili tiks instalēti apakšmapē zabbix_agent2.d\plugins.d.
Turklāt zabbix_agentd.exe (vai zabbix_agent2.exe) tiks iestatīts kā Windows pakalpojums ar aizkavētu automātisko palaišanu (vai automātisko palaišanu Windows versijās pirms Windows Vista/Server 2008).
Ja instalēšanas laikā darbojas cita Zabbix aģenta versija, jums tiks piedāvāts izvēlēties vai nu aizvērt lietotni un mēģināt to palaist atkārtoti, vai atstāt to atvērtu, tādā gadījumā būs nepieciešama sistēmas restartēšana.

7. Noklikšķiniet uz pogas Finish, lai izietu no iestatīšanas vedņa.

Instalēšana no komandrindas
Zabbix aģentu var instalēt no komandrindas, palaižot MSI instalētāju ar msiexec. Piemēram:
msiexec.exe /l*v "C:\package.log" /i "C:\zabbix_agent-7.0.0-windows-amd64-openssl.msi" /qn+ SERVER=192.0.2.1
Šī metode ļauj veikt instalēšanu bez lietotāja klātbūtnes un izmantot pielāgotas konfigurācijas, izmantojot parametrus.
Atbalstītie parametri
Zabbix aģenta MSI instalētāja pakotnes atbalsta šādus parametrus gan Zabbix aģentam, gan Zabbix agent 2.
Zabbix aģenta/agent2 parametri instalēšanas laikā tiek iestatīti konfigurācijas failā. Noklikšķiniet uz parametra nosaukuma, lai skatītu tā detalizētu aprakstu un konfigurācijas piemērus lapā Zabbix agent (Windows). Zabbix agent 2 gadījumā skatiet lapu Zabbix agent 2 (Windows).
| Parameter | Description |
|---|---|
| ADDDEFAULT | Ar komatiem atdalīts komponentu saraksts, kas jāinstalē ar noklusējuma konfigurāciju. Papildinformāciju skatiet ADDDEFAULT property. Iespējamās vērtības: AgentProgram, GetProgram, SenderProgram, ALLPiemērs: ADDDEFAULT=AgentProgram,GetProgram |
| ADDLOCAL | Ar komatiem atdalīts komponentu saraksts, kas jāinstalē lokāli. Papildinformāciju skatiet ADDLOCAL property. Iespējamās vērtības: AgentProgram, GetProgram, SenderProgram, ALLPiemērs: ADDLOCAL=AgentProgram,SenderProgram |
| ALLOWDENYKEY | Ar semikoliem atdalīts AllowKey vai DenyKey parametru saraksts, lai ierobežotu Zabbix aģenta pārbaudes. Ja nepieciešams, izmantojiet atpakaļslīpsvītru, lai ekrānētu atdalītāju (\;). Iestata AllowKey un DenyKey parametrus aģenta konfigurācijas failā.Piemērs: ALLOWDENYKEY="AllowKey=system.run[more C:\Windows\System32\drivers\etc\hosts\\; echo 'File read complete'];DenyKey=system.run[*]" |
| CONF | Pilns ceļš uz Zabbix aģenta veidnes konfigurācijas failu. Instalēšanas laikā šis fails kļūs par aģenta konfigurācijas failu. Failā jābūt vismaz Server un LogFile parametriem. Piemērs: CONF="C:\full\path\to\example.conf" |
| DONOTSTART | Izmantojiet DONOTSTART=1, lai MSI instalētājs nepalaiž Zabbix aģenta pakalpojumu.MSI instalētāja pakotnēs atbalstīts kopš Zabbix 7.0.22. |
| ENABLEPATH | Izmantojiet ENABLEPATH=1, lai pievienotu Zabbix aģenta atrašanās vietu sistēmas PATH mainīgajam. |
| ENABLEPERSISTENTBUFFER | Tikai Zabbix agent 2. Iespējo lokālās pastāvīgās krātuves izmantošanu aktīvajiem vienumiem. |
| HOSTINTERFACE | Neobligāts parametrs, kas definē hosta interfeisu. |
| HOSTMETADATA | Neobligāts parametrs, kas definē hosta metadatus. |
| HOSTMETADATAITEM | Neobligāts parametrs, kas definē vienumu, ko izmanto hosta metadatu iegūšanai. |
| HOSTNAME | Neobligāts parametrs, kas definē hosta nosaukumu. |
| HOSTNAMEITEM | Neobligāts parametrs, kas definē vienumu, ko izmanto hosta nosaukuma iegūšanai. MSI instalētāja pakotnēs atbalstīts kopš Zabbix 7.0.22. |
| INCLUDE | Ar semikoliem atdalīts atsevišķu failu vai visu direktorijā esošo failu saraksts, kas jāiekļauj Zabbix aģenta konfigurācijas failā. |
| IGNOREALREADYEXISTSFOLDER | Jaunām instalācijām izmantojiet IGNOREALREADYEXISTSFOLDER=1, lai atļautu instalēšanu esošā mērķa mapē ārpus Program Files direktorijas. Ja šis parametrs nav norādīts, instalēšana neizdodas, ja šāda mērķa mape jau pastāv. |
| INSTALLFOLDER | Pilns ceļš uz mapi, kurā tiks instalēti Zabbix komponenti un Zabbix aģenta konfigurācijas fails. Zabbix agent 2 gadījumā papildu konfigurācijas faili iebūvētajiem spraudņiem tiks instalēti apakšmapē zabbix_agent2.d\plugins.d.Piemērs: INSTALLFOLDER="C:\Program Files\Zabbix Agent" |
| LISTENIP | Ar komatiem atdalīts IP adrešu saraksts, uz kurām aģentam jāuzklausa savienojumi. |
| LISTENPORT | Aģents uzklausīs savienojumus no serveris šajā portā. |
| LOGFILE | Zabbix aģenta žurnālfaila nosaukums. |
| LOGTYPE | Žurnāla izvades tips. |
| NONMSICONFNAME | Pilns ceļš uz Zabbix aģenta pielāgotu konfigurācijas failu. Instalēšanas laikā jebkuri derīgi aģenta konfigurācijas parametri, kas atrodas šajā failā (ierobežoti līdz tiem, kas uzskaitīti šajā tabulā), tiks ierakstīti jaunizveidotajā aģenta konfigurācijas failā. Failā jābūt vismaz Server parametram. Piemērs: NONMSICONFNAME="C:\full\path\to\example.conf" |
| PERSISTENTBUFFERFILE | Tikai Zabbix agent 2. Fails, kurā Zabbix agent 2 jāglabā SQLite datubāze. |
| PERSISTENTBUFFERPERIOD | Tikai Zabbix agent 2. Laika periods, cik ilgi dati jāglabā, ja nav savienojuma ar serveris vai starpniekserveris. |
| SERVER | Ar komatiem atdalīts IP adrešu saraksts, pēc izvēles CIDR notācijā, vai Zabbix serveru vai Zabbix starpniekserveru DNS nosaukumi. Šis parametrs ir obligāts, izņemot gadījumu, kad STARTAGENTS ir iestatīts uz 0. |
| SERVERACTIVE | Zabbix serveris/starpniekserveris adrese vai klastera konfigurācija, no kuras saņemt aktīvās pārbaudes. |
| SKIP | Izmantojiet SKIP=fw, lai MSI instalētājs nepievienotu Windows Firewall izņēmuma noteikumu Zabbix aģentam. |
| SOURCEIP | Avota IP adrese izejošajiem savienojumiem ar Zabbix serveris vai Zabbix starpniekserveris, vai savienojumu izveidei, izpildot dažus vienumus (web.page.get, net.tcp.port u. c.). MSI instalētāja pakotnēs atbalstīts kopš Zabbix 7.0.22. |
| STARTAGENTS | Iepriekš atzaroto zabbix_agentd instanču skaits, kas apstrādā pasīvās pārbaudes. Ja iestatīts uz 0, pasīvās pārbaudes tiek atspējotas un aģents neklausīsies nevienā TCP portā. MSI instalētāja pakotnēs atbalstīts kopš Zabbix 7.0.22. |
| STARTUPTYPE | Zabbix aģenta pakalpojuma palaišanas tips. Iespējamās vērtības: automatic - pakalpojums tiek palaists automātiski, startējot Windows; delayed - (noklusējums) pakalpojuma palaišana tiek aizkavēta, līdz automātiski palaistie pakalpojumi ir pabeiguši startēšanu (pieejams Windows Vista/Server 2008 un jaunākās versijās); manual - pakalpojums tiek palaists manuāli (lietotājam vai lietojumprogrammai); disabled - pakalpojums tiek atspējots, lai to nevarētu palaist lietotājs vai lietojumprogramma. Piemērs: STARTUPTYPE=disabled |
| STATUSPORT | Tikai Zabbix agent 2. Ja iestatīts, aģents uzklausīs HTTP statusa pieprasījumus šajā portā (http://localhost:<port>/status). |
| TIMEOUT | Norāda, cik ilgi jāgaida (sekundēs), lai izveidotu savienojumu un apmainītos ar datiem ar Zabbix starpniekserveris vai serveris. |
| TLSACCEPT | Ienākošie savienojumi, ko pieņemt (izmanto pasīvajām pārbaudēm). Ja iestatīts uz psk, tad TLSCONNECT arī tiks iestatīts uz psk (ja vien nav norādīts citādi). |
| TLSCAFILE | Pilns ceļš uz failu, kurā ir augstākā līmeņa CA sertifikāti vienaudža sertifikāta verifikācijai. |
| TLSCERTFILE | Pilns ceļš uz failu, kurā ir aģenta sertifikāts vai sertifikātu ķēde. |
| TLSCONNECT | Kā aģentam jāpieslēdzas Zabbix serveris vai starpniekserveris (izmanto aktīvajām pārbaudēm). Ja iestatīts uz psk, tad TLSACCEPT arī tiks iestatīts uz psk (ja vien nav norādīts citādi). |
| TLSCRLFILE | Pilns ceļš uz failu, kurā ir atsauktie sertifikāti. |
| TLSKEYFILE | Pilns ceļš uz failu, kurā ir Zabbix aģenta privātā atslēga. |
| TLSPSKFILE | Pilns ceļš uz failu, kurā ir Zabbix aģenta iepriekš koplietotā atslēga. Ja ir iestatīti gan TLSPSKFILE, gan TLSPSKVALUE, TLSPSKVALUE vērtība tiks ierakstīta failā, kas norādīts TLSPSKFILE. Ir ieteicams ierobežot piekļuvi iepriekš koplietotās atslēgas failam, pielāgojot faila drošības iestatījumus tā, lai to varētu lasīt tikai Zabbix aģents (vai lietotājs, kas palaiž aģentu). |
| TLSPSKIDENTITY | Iepriekš koplietotās atslēgas identitātes virkne. |
| TLSPSKVALUE | Iepriekš koplietotās atslēgas virknes vērtība. Ja ir iestatīti gan TLSPSKFILE, gan TLSPSKVALUE, TLSPSKVALUE vērtība tiks ierakstīta failā, kas norādīts TLSPSKFILE. Piemērs: TLSPSKVALUE=1f87b595725ac58dd977beef14b97461a7c1045b9a1c963065002c5473194952 |
| TLSSERVERCERTISSUER | Atļautais serveris (starpniekserveris) sertifikāta izdevējs. |
| TLSSERVERCERTSUBJECT | Atļautais serveris (starpniekserveris) sertifikāta subjekts. |
| UNSAFEUSERPARAMETERS | Atļauj visus rakstzīmes nodot lietotāja definēto parametru argumentos. MSI instalētāja pakotnēs atbalstīts kopš Zabbix 7.0.22. |
Piemēri
Šis piemērs instalē Zabbix aģents ar pielāgotu konfigurāciju. Tas arī iespējo TLS atbalstu izmantojot iepriekš koplietotas atslēgas.
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[*]"
Nākamais piemērs instalē jaunāku Zabbix aģents versiju un izmanto veidnes konfigurācijas failu (CONF="C:\agent-template.conf").
Instalēšanas laikā šis fails kļūs par aģents konfigurācijas failu.
Lai mantotu parametrus no vecā konfigurācijas faila, izmantojiet parametru vietturus (piem., [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 example:
LogFile=[LogFile]
[AllowDenyKey]
Server=192.0.2.8
Hostname=DESKTOP-X9F4A2B
[Include]
[TLSConnect]
[TLSAccept]
[TLSPSKIdentity]
[TLSPSKFile]
Alternatīvi varat izmantot pielāgotu konfigurācijas failu (NONMSICONFNAME="C:\agent-custom.conf").
Instalēšanas laikā visi derīgie aģents konfigurācijas parametri, kas atrodas šajā failā (ierobežoti līdz tiem, kas uzskaitīti tabulā iepriekš), tiks ierakstīti jaunizveidotajā aģents konfigurācijas failā.
Lai saglabātu esošo aģents konfigurāciju, definējiet saglabājamos parametrus.
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 example:
Server=192.0.2.8
Hostname=DESKTOP-X9F4A2B
Zabbix aģents 2 ielādējamie spraudņi
Zabbix aģents 2 ielādējamie spraudņi var tikt instalēti operētājsistēmā Windows, izmantojot 64 bitu MSI instalētāja pakotnes, kas pieejamas lejupielādei. Ember+ spraudnis ir iekļauts šajās pakotnēs kopš Zabbix 7.0.10.
Minimālās OS prasības MSI instalācijai ir Windows 10 (64 bitu) vai Windows Server 2016.
Līdzīgi kā Zabbix aģents/aģents2, ielādējamie spraudņi var tikt instalēti, izmantojot iestatīšanas vedni vai komandrindu.
Pirms spraudņa instalēšanas, lūdzu, pārbaudiet tā README failu. Tas var saturēt specifiskas prasības un instalēšanas norādījumus.
Instalēšana no iestatīšanas vedņa
1. Veiciet dubultklikšķi uz lejupielādētā MSI faila, lai sāktu instalēšanu.
2. Pieņemiet gala lietotāja licences līgumu.
3. Atlasiet instalējamos Zabbix aģents 2 ielādējamos spraudņus.
Ieteicams izmantot instalētāja piedāvāto noklusējuma instalēšanas vietu. Pielāgotas atrašanās vietas izmantošana bez nepieciešamajām atļaujām var apdraudēt instalācijas drošību.
4. Noklikšķiniet uz Install, lai sāktu instalēšanu.
Visi atlasītie Zabbix aģents 2 ielādējamie spraudņi tiks instalēti jūsu norādītajā vietā (noklusējums: C:\Program Files\Zabbix Agent 2), un to konfigurācijas faili tiks instalēti apakšmapē zabbix_agent2.d.
5. Noklikšķiniet uz pogas Finish, lai izietu no iestatīšanas vedņa.
Instalēšana no komandrindas
Zabbix aģents 2 ielādējamie spraudņi var tikt instalēti no komandrindas, palaižot MSI instalētāju ar msiexec. Piemēram:
msiexec.exe /l*v "C:\package.log" /i "C:\zabbix_agent2_plugins-7.0.0-windows-amd64.msi" /qn+
Zabbix aģents 2 ielādējamo spraudņu MSI instalētāja pakotnes atbalsta šādus parametrus.
| Parameter | Description |
|---|---|
| ADDDEFAULT | Ar komatiem atdalītu komponentu saraksts, kas jāinstalē ar noklusējuma konfigurāciju. Plašāka informācija: ADDDEFAULT property. Iespējamās vērtības: ALL, EmberplusPlugin, MongodbPlugin, MssqlPlugin, PostgresqlPluginPiemērs: ADDDEFAULT=MongodbPlugin,PostgresqlPlugin |
| ADDLOCAL | Ar komatiem atdalītu komponentu saraksts, kas jāinstalē lokāli. Plašāka informācija: ADDLOCAL property. Iespējamās vērtības: ALL, EmberplusPlugin, MongodbPlugin, MssqlPlugin, PostgresqlPluginPiemērs: ADDLOCAL=MongodbPlugin,MssqlPlugin |
| INSTALLFOLDER | Pilns mapes ceļš, kurā tiks instalēti Zabbix komponenti, bet to konfigurācijas faili tiks instalēti zabbix_agent2.d apakšmapē.Piemērs: INSTALLFOLDER="C:\Program Files\Zabbix Agent 2" |