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ģentu, gan uz Zabbix aģentu 2.
1. Veiciet dubultklikšķi uz lejupielādētā MSI faila, lai sāktu instalēšanu:

2. Piekrītiet galalietotāja licences līgumam:

3. Atlasiet instalējamos Zabbix komponentus (aģenta dēmonu, 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 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ā:
| Parametrs | Apraksts |
|---|---|
| Host name | Tās mašīnas hosts, kurā tiek instalēts Zabbix aģents. Iestata parametru Hostname. |
| Zabbix server IP/DNS | Ar komatiem atdalītu IP adrešu saraksts (pēc izvēles CIDR apzīmējumā) vai Zabbix serveru vai Zabbix starpniekserveru DNS nosaukumi. Šis parametrs ir obligāts. Iestata parametru Server. |
| Agent listen port | Aģents šajā portā gaidīs savienojumus 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. Parametriem TLSConnect un TLSAccept tiek iestatīta vērtība 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 atrasts esošs Zabbix aģents, tiks parādītas tā konfigurācijas faila parametru vērtības. Turklāt instalēšanas laikā esošais konfigurācijas fails tiks pārdēvēts un tiks izveidots jauns konfigurācijas fails.

5. Ja iepriekšējā darbībā atzīmējāt izvēles rūtiņu Enable PSK, konfigurējiet PSK parametrus. Šie parametri tiks iestatīti arī Zabbix aģenta konfigurācijas failā:
| Parametrs | Apraksts |
|---|---|
| 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, norādot atslēgas atrašanās vietu (noklusējums: C:\Program Files\Zabbix Agent\psk.key). 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 atliktu automātisko palaišanu (vai automātisko palaišanu Windows versijās, kas ir vecākas par Windows Vista/Server 2008).
Ja instalēšanas laikā darbojas cita Zabbix aģenta versija, jums tiks piedāvāts izvēlēties, vai aizvērt lietojumprogrammu un mēģināt to restartēt, vai atstāt to atvērtu; otrajā gadījumā būs nepieciešama 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-8.0.0-windows-amd64-openssl.msi" /qn+ SERVER=192.0.2.1
Šī metode ļauj veikt neuzraudzītu instalēšanu un izmantot pielāgotas konfigurācijas, izmantojot parametrus.
Atbalstītie parametri
Zabbix aģenta MSI instalēšanas pakotnes atbalsta tālāk norādītos parametrus gan Zabbix aģentam, gan Zabbix aģentam 2.
Zabbix aģenta/aģenta 2 parametri instalēšanas laikā tiek iestatīti konfigurācijas failā. Noklikšķiniet uz parametra nosaukuma, lai Zabbix aģenta (Windows) lapā skatītu tā detalizētu aprakstu un konfigurācijas piemērus: Zabbix agent (Windows). Informāciju par Zabbix aģentu 2 skatiet lapā Zabbix agent 2 (Windows).
| Parameter | Description |
|---|---|
| ADDDEFAULT | Ar komatiem atdalīts instalējamo komponentu saraksts, izmantojot to noklusējuma konfigurāciju. Papildinformāciju skatiet sadaļā ADDDEFAULT property. Iespējamās vērtības: AgentProgram, GetProgram, SenderProgram, ALLPiemērs: ADDDEFAULT=AgentProgram,GetProgram |
| ADDLOCAL | Ar komatiem atdalīts lokāli instalējamo komponentu saraksts. Papildinformāciju skatiet sadaļā 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ļvērsto slīpsvītru, lai aizsargātu atdalītāju (\;). Iestata parametrus AllowKey un DenyKey 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 veidnes konfigurācijas failu Zabbix aģentam. 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 MSI instalēšanas programma neuzsāktu 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 definē hosts saskarni. |
| HOSTMETADATA | Neobligāts parametrs, kas definē hosts metadatus. |
| HOSTMETADATAITEM | Neobligāts parametrs, kas definē vienumu, ko izmanto hosts metadatu iegūšanai. |
| HOSTNAME | Neobligāts parametrs, kas definē hosts nosaukumu. |
| HOSTNAMEITEM | Neobligāts parametrs, kas definē vienumu, ko izmanto hosts 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ā. |
| 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 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āieklausās. |
| LISTENPORT | Šajā portā aģents gaidīs savienojumus no servera. |
| LOGFILE | Zabbix aģenta žurnālfaila nosaukums. |
| LOGTYPE | Žurnāla izvades veids. |
| NONMSICONFNAME | Pilns ceļš uz pielāgotu konfigurācijas failu Zabbix aģentam. 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 | Laika periods, kurā dati jāglabā, ja nav savienojuma ar serveri vai starpniekserveri. |
| SERVER | Ar komatiem atdalīts IP adrešu saraksts (pēc izvēles CIDR apzīmējumā) 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 servera/starpniekservera adrese vai klastera konfigurācija, no kuras iegūt aktīvās pārbaudes. |
| SKIP | Izmantojiet SKIP=fw, lai MSI instalēšanas programma nepievienotu Windows ugunsmūra izņēmuma kārtulu Zabbix aģentam. |
| SOURCEIP | Avota IP adrese izejošajiem savienojumiem ar Zabbix serveri vai Zabbix starpniekserveri, kā arī savienojumu izveidei dažu vienumu izpildes laikā (web.page.get, net.tcp.port u. c.). |
| STARTAGENTS | Iepriekš izveidoto zabbix_agentd eksemplāru 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 veids. Iespējamās vērtības: automatic - automātiski palaist servisu, startējot Windows; delayed - (noklusējums) atlikt servisa palaišanu, līdz automātiski palaistie servisi ir pabeiguši startēšanu (pieejams operētājsistēmā Windows Vista/Server 2008 un jaunākās versijās); manual - palaist servisu manuāli (lietotājam vai lietojumprogrammai); disabled - atspējot servisu, lai lietotājs vai lietojumprogramma to nevarētu palaist. 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 (sekundēs) gaidīt savienojuma izveidi un datu apmaiņu ar Zabbix starpniekserveri vai serveri. |
| TLSACCEPT | Pieņemamie ienākošie savienojumi (izmanto pasīvajām pārbaudēm). Ja iestatīts uz psk, 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āts(-i) partnera sertifikāta pārbaudei. |
| TLSCERTFILE | Pilns ceļš uz failu, kurā ir aģenta sertifikāts vai sertifikātu ķēde. |
| TLSCONNECT | Kā aģentam izveidot savienojumu ar Zabbix serveri vai starpniekserveri (izmanto aktīvajām pārbaudēm). Ja iestatīts uz psk, 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, TLSPSKVALUE vērtība tiks ierakstīta TLSPSKFILE norādītajā failā. 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 TLSPSKFILE norādītajā failā. Piemērs: TLSPSKVALUE=1f87b595725ac58dd977beef14b97461a7c1045b9a1c963065002c5473194952 |
| TLSSERVERCERTISSUER | Atļautais servera (starpniekservera) sertifikāta izdevējs. |
| TLSSERVERCERTSUBJECT | Atļautais servera (starpniekservera) sertifikāta subjekts. |
| UNSAFEUSERPARAMETERS | Atļaut visu rakstzīmju nodošanu lietotāja definētu 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.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-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ā (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-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ģenta 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ācijas pakotnes, kas pieejamas lejupielādei.
Minimālās operētājsistēmas prasības MSI instalēšanai ir Windows 10 (64 bitu) vai Windows Server 2016.
Pirms spraudņa instalēšanas, lūdzu, izlasiet tā README failu. Tajā var būt norādītas īpašas prasības un instalēšanas instrukcijas.
Tāpat kā Zabbix aģentu/aģentu 2, ielādējamos spraudņus var instalēt, izmantojot iestatīšanas vedni vai komandrindu.
Instalēšana, izmantojot iestatīšanas vedni
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 aģenta 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ģenta 2 ielādējamie spraudņi tiks instalēti jūsu norādītajā atrašanās vietā (noklusējums: C:\Program Files\Zabbix Agent 2), bet 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ģenta 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ģenta 2 ielādējamo spraudņu MSI instalētāja pakotnes atbalsta tālāk norādītos parametrus.
| Parameter | Description |
|---|---|
| ADDDEFAULT | Ar komatiem atdalīts instalējamo komponentu saraksts, izmantojot to noklusējuma konfigurāciju. Papildinformāciju skatiet sadaļā ADDDEFAULT property. Iespējamās vērtības: ALL, CephPlugin, EmberplusPlugin, MongodbPlugin, MssqlPlugin, NvidiagpuPlugin, PostgresqlPluginPiemērs: ADDDEFAULT=MongodbPlugin,PostgresqlPlugin |
| ADDLOCAL | Ar komatiem atdalīts lokāli instalējamo komponentu saraksts. Papildinformāciju skatiet sadaļā ADDLOCAL property. Iespējamās vērtības: ALL, CephPlugin, EmberplusPlugin, MongodbPlugin, MssqlPlugin, NvidiagpuPlugin, PostgresqlPluginPiemē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" |