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, izmantojot iestatīšanas vedni

Tālāk aprakstītās instalēšanas darbības attiecas gan uz Zabbix aģents, gan uz Zabbix aģents 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.

4. Konfigurējiet tālāk norādītos parametrus. To vērtības tiks iestatītas Zabbix aģents 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 Zabbix serveru vai Zabbix starpniekserveru IP adrešu saraksts, pēc izvēles CIDR pierakstā, vai DNS nosaukumi. Šis parametrs ir obligāts. Iestata parametru Server.
Agent listen port aģents klausīsies šajā portā 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 un pēc 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ģents atrašanās vietu sistēmas PATH mainīgajam.

Ja tiek atrasts esošs Zabbix aģents, tiks parādītas parametru vērtības no tā konfigurācijas faila. Turklāt instalēšanas laikā esošais konfigurācijas fails tiks pārdēvēts un tiks izveidots jauns konfigurācijas fails.

5. Konfigurējiet PSK parametrus, ja iepriekšējā darbībā atzīmējāt izvēles rūtiņu Enable PSK. Šie parametri arī tiks iestatīti Zabbix aģents 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, kas satur atslēgu, 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ģents konfigurācijas fails tiks instalēti jūsu norādītajā vietā (noklusējums: C:\Program Files\Zabbix Agent). Tas pats attiecas uz Zabbix aģents 2, izņemot to, ka papildu konfigurācijas faili tā iebūvētajiem spraudņiem 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ģents versija, jums tiks piedāvāts izvēlēties vai nu aizvērt lietojumprogrammu un mēģināt to restartēt, vai atstāt to atvērtu; tādā gadījumā būs nepieciešama sistēmas pārstartēšana.

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

Instalēšana no komandrindas

Zabbix aģents var tikt instalēts no komandrindas, palaižot MSI instalētāju ar msiexec. Piemēram:

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

Šī metode ļauj veikt neuzraudzītas instalācijas un pielāgotas konfigurācijas, izmantojot parametrus.

Atbalstītie parametri

Zabbix aģents MSI instalētāja pakotnes atbalsta tālāk norādītos parametrus gan Zabbix aģentam, gan Zabbix aģentam 2.

Zabbix aģenta/aģenta2 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 aģentam 2 skatiet lapu Zabbix agent 2 (Windows).

Parametrs Apraksts
ADDDEFAULT Ar komatiem atdalīts komponentu saraksts, kas jāinstalē to noklusējuma konfigurācijā. Papildinformāciju skatiet ADDDEFAULT property.
Iespējamās vērtības: AgentProgram, GetProgram, SenderProgram, ALL
Piemē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, ALL
Piemē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ļvērsto slīpsvītru, lai atdalītāju atdalītu (\;). 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 parametriem Server un LogFile.
Piemērs: CONF="C:\full\path\to\example.conf"
DONOTSTART Izmantojiet DONOTSTART=1, lai neļautu MSI instalētājam palaist Zabbix aģenta servisu.
ENABLEPATH Izmantojiet ENABLEPATH=1, lai pievienotu Zabbix aģenta atrašanās vietu sistēmas PATH mainīgajam.
ENABLEPERSISTENTBUFFER Tikai Zabbix aģentam 2. Iespējo lokālās pastāvīgās krātuves izmantošanu aktīvajiem vienumiem.
HOSTINTERFACE Neobligāts parametrs, kas nosaka hosta saskarni.
HOSTMETADATA Neobligāts parametrs, kas nosaka hosta metadatus.
HOSTMETADATAITEM Neobligāts parametrs, kas nosaka vienumu, ko izmantot hosta metadatu iegūšanai.
HOSTNAME Neobligāts parametrs, kas nosaka hosta nosaukumu.
HOSTNAMEITEM Neobligāts parametrs, kas nosaka vienumu, ko izmantot hosta nosaukuma iegūšanai.
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ā.
INSTALLFOLDER Pilns ceļš uz mapi, kurā tiks instalēti Zabbix komponenti un Zabbix aģenta konfigurācijas fails. Zabbix aģentam 2 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, kurās aģentam jāgaida savienojumi.
LISTENPORT Aģents šajā portā gaidīs savienojumus no servera.
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ā visi šajā failā esošie derīgie aģenta konfigurācijas parametri (tikai tie, kas norādīti šajā tabulā) tiks ierakstīti jaunizveidotajā aģenta konfigurācijas failā. Failā jābūt vismaz parametram Server.
Piemērs: NONMSICONFNAME="C:\full\path\to\example.conf"
PERSISTENTBUFFERFILE Tikai Zabbix aģentam 2. Fails, kurā Zabbix aģentam 2 jāglabā SQLite datubāze.
PERSISTENTBUFFERPERIOD Tikai Zabbix aģentam 2. Laika periods, cik ilgi dati jāglabā, ja nav savienojuma ar serveri vai starpniekserveri.
SERVER Ar komatiem atdalīts Zabbix serveru vai Zabbix starpniekserveru IP adrešu saraksts, pēc izvēles CIDR pierakstā, vai DNS nosaukumi. Šis parametrs ir obligāts, izņemot gadījumu, ja STARTAGENTS ir iestatīts uz 0.
SERVERACTIVE Zabbix servera/starpniekservera adrese vai klastera konfigurācija, no kuras saņemt aktīvās pārbaudes.
SKIP Izmantojiet SKIP=fw, lai neļautu MSI instalētājam pievienot Windows ugunsmūra izņēmuma noteikumu Zabbix aģentam.
SOURCEIP Izejošo savienojumu avota IP adrese uz Zabbix serveri vai Zabbix starpniekserveri, vai savienojumu izveidei, izpildot dažus vienumus (web.page.get, net.tcp.port u.c.).
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ā.
STARTUPTYPE Zabbix aģenta servisa palaišanas tips. Iespējamās vērtības:
automatic - palaist servisu automātiski Windows startēšanas laikā;
delayed - (noklusējums) aizkavēt servisa palaišanu pēc tam, kad automātiski palaistie servisi ir pabeiguši startēšanu (pieejams Windows Vista/Server 2008 un jaunākās versijās);
manual - palaist servisu manuāli (lietotājam vai lietotnei);
disabled - atspējot servisu, lai to nevarētu palaist lietotājs vai lietotne.
Piemērs: STARTUPTYPE=disabled
STATUSPORT Tikai Zabbix aģentam 2. Ja iestatīts, aģents šajā portā gaidīs HTTP statusa pieprasījumus (http://localhost:<port>/status).
TIMEOUT Norāda, cik ilgi gaidīt (sekundēs), lai izveidotu savienojumu un apmainītos ar datiem ar Zabbix starpniekserveri vai serveri.
TLSACCEPT Ienākošie savienojumi, kurus pieņemt (izmanto pasīvajām pārbaudēm). Ja iestatīts uz psk, tad arī TLSCONNECT 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 otras puses sertifikāta pārbaudei.
TLSCERTFILE Pilns ceļš uz failu, kurā ir aģenta sertifikāts vai sertifikātu ķēde.
TLSCONNECT Kā aģentam jāpieslēdzas Zabbix serverim vai starpniekserverim (izmanto aktīvajām pārbaudēm). Ja iestatīts uz psk, tad arī TLSACCEPT 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, tad 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, tad TLSPSKVALUE vērtība tiks ierakstīta failā, kas norādīts TLSPSKFILE.
Piemērs: TLSPSKVALUE=1f87b595725ac58dd977beef14b97461a7c1045b9a1c963065002c5473194952
TLSSERVERCERTISSUER Atļautais servera (starpniekservera) sertifikāta izdevējs.
TLSSERVERCERTSUBJECT Atļautais servera (starpniekservera) sertifikāta subjekts.
UNSAFEUSERPARAMETERS Atļaut visām rakstzīmēm tikt nodotām lietotāja definēto parametru argumentos.
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-8.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[*]"

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ēram, [AllowDenyKey]).

msiexec.exe /l*v "C:\package.log" /i "C:\zabbix_agent-8.0.1-windows-amd64-openssl.msi" /qn+ NONMSICONFNAME="C:\agent.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ā (tikai tie, kas norādīti iepriekš esošajā tabulā), tiks ierakstīti jaunizveidotajā aģents konfigurācijas failā. Lai saglabātu esošo aģents konfigurāciju, definējiet parametrus, kas jāsaglabā.

msiexec.exe /l*v "C:\package.log" /i "C:\zabbix_agent-8.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ģenta 2 ielādējamos spraudņus var instalēt operētājsistēmā Windows, izmantojot 64 bitu MSI instalēšanas pakotnes, kas ir pieejamas lejupielādei.

Minimālās OS prasības MSI instalēšanai ir Windows 10 (64 bitu) vai Windows Server 2016.

Pirms spraudņa instalēšanas, lūdzu, pārbaudiet tā README failu. Tajā var būt ietvertas īpašas prasības un instalēšanas norādījumi.

Līdzīgi kā Zabbix aģentu/aģentu2, ielādējamos spraudņus var instalēt, izmantojot iestatīšanas vedni vai komandrindu.

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ējamos spraudņus 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_agent2_plugins-8.0.0-windows-amd64.msi" /qn+

Zabbix aģents 2 ielādējamo spraudņu MSI instalētāja pakotnes atbalsta šādus parametrus.

Parametrs Apraksts
ADDDEFAULT Ar komatiem atdalīts komponentu saraksts, kas jāinstalē to noklusējuma konfigurācijā. Papildinformāciju skatiet ADDDEFAULT property.
Iespējamās vērtības: ALL, CephPlugin, EmberplusPlugin, MongodbPlugin, MssqlPlugin, NvidiagpuPlugin, PostgresqlPlugin
Piemērs: ADDDEFAULT=MongodbPlugin,PostgresqlPlugin
ADDLOCAL Ar komatiem atdalīts komponentu saraksts, kas jāinstalē lokāli. Papildinformāciju skatiet ADDLOCAL property.
Iespējamās vērtības: ALL, CephPlugin, EmberplusPlugin, MongodbPlugin, MssqlPlugin, NvidiagpuPlugin, PostgresqlPlugin
Piemērs: ADDLOCAL=MongodbPlugin,MssqlPlugin
INSTALLFOLDER Pilns ceļš uz mapi, kurā tiks instalēti Zabbix komponenti, bet to konfigurācijas faili tiks instalēti apakšmapē zabbix_agent2.d.
Piemērs: INSTALLFOLDER="C:\Program Files\Zabbix Agent 2"