Documentation
Table of Contents
4 Instal·lació de l'agent Windows des d'MSI
Vista general
L'agent Zabbix Windows es pot instal·lar des dels paquets d'instal·lació de Windows MSI (32 o 64 bits) disponibles per a descarregar.
El requisit mínim per a una instal·lació MSI és:
- Windows XP de 64 bits o Server 2003 per l'agent de Zabbix;
- Windows 10 de 32 bits o Server 2016 per l'agent 2 de Zabbix.
Els paquets de 32 bits no es poden pas instal·lar a sistemes de 6 bits
Les utilitats get i sender de Zabbix també es poden instal·lar, ja sigui juntament amb l'agent/agent 2 de Zabbix o per separat.
Tots els paquets inclouen:
- Suport TLS (la configuració de TLS és opcional).
- Utilitats Zabbix get i Zabbix sender (es poden instal·lar juntament amb l'agent/agent 2 de Zabbix o per separat)
Els paquets Zabbix agent 2 no inclouen connectors carregables (MongoDB, PostgreSQL, MSSQL), que s'han de [descarregar i instal·lar] (#zabbix-agent-2-loadable-plugins) per separat.
La instal·lació es pot fer mitjançant l'assistent de configuració o la línia d'ordres.
Tot i que la instal·lació amb paquets MSI és totalment compatible, es recomana instal·lar almenys Microsoft .NET Framework 2 per a un tractament adequat dels errors.
Es recomana emprar camins predeterminats proporcionats per l'instal·lador, ja que l'ús de camins personalitzats sense els permisos adequats podria comprometre la seguretat de la instal·lació.
Instal·lació des de l'assistent de configuració
Les passes d'instal·lació següents s'apliquen tant a l'agent Zabbix com a l'agent Zabbix 2.
1. Feu doble clic al fitxer MSI descarregat per iniciar la instal·lació:
2. Accepteu l'acord de llicència d'usuari final:
3. Trieu els components Zabbix (dimoni de l'agent, Zabbix sender, Zabbix get) que voleu instal·lar:
Es recomana utilitzar la ubicació d'instal·lació per defecte proporcionada per l'instal·lador. L'ús d'una ubicació personalitzada sense els permisos necessaris pot comprometre la seguretat de la instal·lació.
4. Configureu els paràmetres següents. Els seus valors s'establiran al fitxer de configuració de l'agent Zabbix:
| Paràmetre | Descripció |
|---|---|
| Nom d'equip | El nom d'equip de la màquina on s'és instal·lant l'agent Zabbix. Estableix el paràmetre Nom d'equip. |
| IP/DNS del servidor Zabbix | Llistat d'adreces IP delimitades per comes, opcionalment en notació CIDR, o noms DNS de servidors Zabbix o proxys Zabbix. Aquest paràmetre és obligatori. Estableix el paràmetre Server. |
| Port d'escolta de l'agent | L'agent escoltarà en aquest port les connexions des del servidor. Estableix el paràmetre ListenPort. |
| Servidor o proxy per a comprovacions actives | L'adreça del proxy Zabbix o la configuració del clúster per obtenir comprovacions actives. L'adreça del servidor/proxy és una adreça IP o un nom DNS i un port opcional separats per dos punts. Estableix el paràmetre ServerActive. |
| Activa PSK | Marqueu la casella de selecció per habilitar el suport TLS mitjançant claus precompartides. Estableix els paràmetres TLSConnect i TLSAccept a psk. |
| Afegeix la ubicació de l'agent al PATH | Marqueu la casella de selecció per afegir la ubicació de l'agent Zabbix a la variable PATH del sistema. |
Si es troba un agent Zabbix existent, es mostraran els valors dels paràmetres del seu fitxer de configuració. A més, es canviarà el nom del fitxer de configuració existent durant la instal·lació i es crearà un nou fitxer de configuració.
5. Configureu els paràmetres de PSK si heu marcat la casella de selecció Activa PSK a la passa anterior. Aquests paràmetres també s'establiran al fitxer de configuració de l'agent Zabbix:
| Paràmetre | Descripció |
|---|---|
| Identitat de la clau prèviament compartida | La cadena d'identitat de la clau prèviament compartida. Estableix el paràmetre TLSPSKIdentity. |
| Valor de la clau prèviament compartida | El valor de la cadena de claus prèviament compartida. Crea el fitxer psk.key que conté la clau i estableix el paràmetre TLSPSKFile a la ubicació de la clau (per defecte: C:\Program Files\Zabbix Agent\psk.key). Es recomanat restringir l'accés al fitxer de claus compartides prèviament ajustant la configuració de seguretat del fitxer perquè només l'agent Zabbix (o l'usuari que executi l'agent) pugui llegir-lo. |
6. Feu clic a Instal·lar per començar la instal·lació.
Tots els components Zabbix seleccionats i el fitxer de configuració de l'agent Zabbix s'instal·laran a la vostra ubicació especificada (per defecte: C:\Program Files\Zabbix Agent). El mateix s'aplica a l'agent Zabbix 2, tret que els fitxers de configuració addicionals per als seus connectors integrats s'instal·laran a la subcarpeta zabbix_agent2.d\plugins.d.
A més, zabbix_agentd.exe (o zabbix_agent2.exe) es configurarà com a servei de Windows amb l'inici automàtic retardat (o l'inici automàtic a les versions de Windows anteriors a Windows Vista/Server 2008).
Si s'està executant una versió diferent de l'agent Zabbix durant la instal·lació, se us demanarà que escolliu tancar l'aplicació i provar de reiniciar-la o deixar-la oberta, en aquest cas caldrà reiniciar-la.
7. Feu clic al botó Finalitzar per sortir de l'assistent de configuració.
Instal·lació des de la línia d'ordres
L'agent Zabbix es pot instal·lar des de la línia d'ordres executant l'instal·lador MSI amb msiexec. Per exemple:
msiexec.exe /l*v "C:\package.log" /i "C:\zabbix_agent-7.2.0-windows-amd64-openssl.msi" /qn+ SERVER=192.0.2.0Aquest mètode permet instal·lacions desateses i configuracions personalitzades mitjançant paràmetres.
Paràmetres admesos
Els paquets d'instal·lador MSI de l'agent Zabbix admeten els paràmetres següents tant per a l'agent Zabbix com per a l'agent Zabbix 2.
Els paràmetres de l'agent/agent2 de Zabbix s'estableixen al fitxer de configuració durant la instal·lació. Feu clic al nom del paràmetre per veure'n la descripció detallada i els exemples de configuració a l'[agent Zabbix (Windows)](/manual/appendix/appendix/agent, per a la pàgina de l'agent Zabbix, consulteu Zabbix2 la pàgina Zabbix agent 2 (Windows).
| Paràmetre | Descripció |
|---|---|
| ADDDEFAULT | Un llistat delimitada per comes de programes per instal·lar a la ubicació per defecte. Valors possibles: AgentProgram, GetProgram, SenderProgram, ALL.Exemple: ADDDEFAULT=AgentProgram, GetProgram |
| ADDLOCAL | Un llistat delimitada per comes de programes per instal·lar localment. Valors possibles: AgentProgram, GetProgram, SenderProgram, ALL.Exemple: ADDLOCAL=AgentProgram, SenderProgram |
| ALLOWDENYKEY | Seqüència de [paràmetres] "AllowKey" i "DenyKey" (/manual/config/items/restrict_checks) separats per ;Empreu \; per escapar del delimitador.Exemple: ALLOWDENYKEY="AllowKey=system.run[tipus c:\windows\system32\drivers\etc\hosts];DenyKey=system.run[*]" |
| CONF | La ruta completa a un fitxer de configuració personalitzat. Exemple: CONF=c:\full\path\to\user.conf |
| ENABLEPATH | Afegiu la ubicació de l'agent a la variable PATH. |
| ENABLEPERSISTENTBUFFER | Només l'agent Zabbix 2. Habiliteu l'ús de l'emmagatzematge local persistent per als elements actius. |
| HOSTINTERFACE | Un paràmetre opcional que defineix la interfície de l'equip. |
| HOSTMETADATA | Un paràmetre opcional que defineix les metadades de l'equip. |
| HOSTMETADATAITEM | Un paràmetre opcional que defineix un element d'agent Zabbix emprat per obtindre les metadades de l'equip. |
| HOSTNAME | Un paràmetre opcional que defineix el nom de l'equip. |
| INCLUDE | Seqüència inclou separats per ; |
| INSTALLFOLDER | La ruta completa de la carpeta on s'instal·laran els components de Zabbix juntament amb el fitxer de configuració. |
| LISTENIP | Un llistat d'adreces IP delimitades per comes que l'agent hauria d'escoltar. |
| LISTENPORT | L'agent escoltarà en aquest port les connexions des del servidor. |
| LOGFILE | El nom del fitxer de registre. |
| LOGTYPE | El tipus de sortida del registre. |
| NONMSICONFNAME | La ruta completa a un fitxer de configuració personalitzat per a l'agent Zabbix. Durant la instal·lació, qualsevol paràmetre de configuració de l'agent vàlid present en aquest fitxer (limitat als enumerats en aquesta taula) substituirà els paràmetres corresponents al fitxer de configuració de l'agent nou o existent. El fitxer ha de contindre almenys el paràmetre Server. Exemple: NONMSICONFNAME="C:\full\path\to\example.conf" |
| PERSISTENTBUFFERFILE | Només l'agent Zabbix 2. El fitxer on l'agent Zabbix 2 hauria de mantindre la base de dades SQLite. |
| PERSISTENTBUFFERPERIOD | Només l'agent Zabbix 2. El període de temps durant el qual s'han d'emmagatzemar les dades quan no hi ha connexió amb el servidor o proxy. |
| SERVIDOR | Un llistat d'adreces IP delimitades per comes, opcionalment en notació CIDR, o noms DNS de servidors Zabbix i proxys Zabbix. |
| SERVERACTIVE | L'adreça del proxy/proxy de Zabbix o la configuració del clúster per obtindre comprovacions actives. |
| SKIP | SKIP=fw - no instal·leu la regla d'excepció del tallafoc. |
| STARTUPTYPE | Tipus d'inici del servei agent/agent 2 de Zabbix Windows. Valors possibles:automatic - engega el servei automàticament a l'inici de Windows;delayed - (per defecte) endarrereix l'inici del servei després que els serveis iniciats automàticament s'hagin engegat (disponible a Windows Server 2008/Vista) i versions posteriors);manual - engega el servei manualment (per un usuari o aplicació);disabled - desactiva el servei, de manera que un usuari o una aplicació no pugui engegar-lo.Exemple: STARTUPTYPE=disabled |
| STATUSPORT | Només l'agent Zabbix 2. Si s'estableix, l'agent escoltarà en aquest port les peticions d'estat HTTP (http://localhost:<port>/status). |
| TIMEOUT | No gasteu més de segons Timeout en el processament. |
| TLSACCEPT | Quines connexions entrants acceptar. |
| TLSCAFILE | El nom d'accés complet d'un fitxer que conté els certificats de CA(s) de nivell superior per a la verificació de certificats entre iguals, emprat per a comunicacions xifrades entre components de Zabbix. |
| TLSCERTFILE | La ruta completa d'un fitxer que conté el certificat de l'agent o la cadena de certificats, emprat per a comunicacions xifrades entre components Zabbix. |
| TLSCONNECT | Com s'ha de connectar l'agent al servidor o proxy Zabbix. |
| TLSCRLFILE | La ruta completa d'un fitxer que conté certificats revocats. Aquest paràmetre s'empra per a comunicacions xifrades entre components Zabbix. |
| TLSKEYFILE | La ruta completa d'un fitxer que conté la clau privada de l'agent, emprada per a comunicacions xifrades entre components de Zabbix. |
| TLSPSKFILE | La ruta completa d'un fitxer que conté l'agent clau precompartida, emprat per a comunicacions xifrades amb el servidor Zabbix. |
| TLSPSKIDENTITY | La clau precompartida cadena d'identitat, emprada per a comunicacions xifrades amb el servidor Zabbix. |
| TLSPSKVALUE | El valor de cadena clau precompartida emprat per a comunicacions xifrades amb el servidor Zabbix. |
| TLSSERVERCERTISSUER | L'emissor del certificat del servidor (proxy) permès. |
| TLSSERVERCERTSUBJECT | L'assumpte del certificat del servidor (proxy) permès. |
Exemples
L'exemple següent instal·la l'agent Zabbix amb una configuració personalitzada. També permet el suport TLS utilitzant claus precompartides.
mkdir "C:\Program Files\Zabbix Agent" 2>nul
msiexec.exe /l*v "C:\package.log" /i "C:\zabbix_agent-7.2.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[*]"L'exemple següent instal·la una versió més nova de l'agent Zabbix i utilitza un fitxer de configuració personalitzat per substituir paràmetres específics (p. ex., Hostname=LAPTOP-IKP7S51S,DESKTOP-X9F4A2B) al fitxer de configuració de l'agent existent.
msiexec.exe /l*v "C:\package.log" /i "C:\zabbix_agent-7.2.4-windows-amd64-openssl.msi" /qn+ NONMSICONFNAME="C:\agent.conf"Plugins carregables de l'agent 2 de Zabbix
Els plugins carregables de l'agent de Zabbix 2 es poden instal·lar a Windows mitjançant paquets d'instal·lació MSI de 64 bits, disponibles per a descàrrega.
Els requisits mínims del sistema operatiu per a la instal·lació de MSI són Windows 10 (64 bits) o Windows Server 2016.
Els paquets inclouen:
Els paquets no inclouen el connector Ember+, que actualment només és disponible per ser compilat des del codi font (tant per a Unix com per a Windows).
Abans d'instal·lar un connector, comproveu el seu fitxer README. Pot contindre requisits addicionals i instruccions d'instal·lació específiques del connector.
De manera similar a l'agent/agent2 de Zabbix, els plugins carregables es poden instal·lar mitjançant l'assistent de configuració o la línia d'ordres.
Instal·lació des de l'assistent de configuració
1. Feu doble clic al fitxer MSI descarregat per iniciar la instal·lació.
2. Accepteu l'Acord de llicència d'usuari final.
3. Trieu els plugins carregables de l'agent 2 de Zabbix (plugin MongoDB, connector PostgreSQL, MSSQL plugin) per instal·lar.
Es recomana utilitzar la ubicació d'instal·lació per defecte proporcionada per l'instal·lador. L'ús d'una ubicació personalitzada sense els permisos necessaris pot comprometre la seguretat de la instal·lació.
4. Feu clic a Instal·lar per començar la instal·lació.
Tots els plugins carregables de Zabbix agent 2 s'instal·laran a la vostra ubicació especificada (per defecte: C:\Program Files\Zabbix Agent 2), amb els seus fitxers de configuració instal·lats a la subcarpeta zabbix_agent2.d.
5. Feu clic al botó Finalitzar per sortir de l'assistent de configuració.
Instal·lació des de la línia de comandes
Els plugins carregables de l'agent Zabbix 2 es poden instal·lar des de la línia d'ordres executant l'instal·lador MSI amb msiexec. Per exemple:
Els paquets d'instal·lació MSI del plugin carregable de l'agent Zabbix 2 admeten els paràmetres següents.
| Paràmetre | Descripció |
|---|---|
| ADDDEFAULT | Llistat de components delimitats per comes per instal·lar en la seva configuració predeterminada. Per obtenir més informació, vegeu propietat ADDDEFAULT. Valors possibles: MongodbPlugin, PostgresqlPlugin, MssqlPlugin, ALL, ALL:ADDDEFAULT=MongodbPlugin, PostgresqlPlugin |
| ADDLOCAL | Llistat de components delimitats per comes per instal·lar localment. Per obtenir més informació, consulteu la Propietat ADDLOCAL. Valors possibles: MongodbPlugin, PostgresqlPlugin, MssqlPlugin, ALLExemple: ADDLOCAL=MongodbPlugin, MssqlPlugin |
| INSTALLFOLDER | La ruta completa a una carpeta on s'instal·laran els components de Zabbix, amb els seus fitxers de configuració instal·lats a la subcarpeta zabbix_agent2.d.Exemple: INSTALLFOLDER="C:\Fitxers de programa\Zabbix Agent 2" |