Documentation
Table of Contents
4 Windows agent installatie van MSI
Overzicht
De Zabbix Windows-agent kan worden geïnstalleerd via de Windows MSI-installatiepakketten (32-bit of 64-bit) die beschikbaar zijn om te downloaden.
Een 32-bit pakket kan niet worden geïnstalleerd op een 64-bit Windows.
De minimale vereiste voor MSI-installatie is:
- Windows XP x64 en Server 2003 voor Zabbix-agent;
- Windows 7 x32 voor Zabbix-agent 2.
De Zabbix get en sender hulpprogramma's kunnen ook worden geïnstalleerd, samen met Zabbix agent/agent 2 of apart.
Alle pakketten worden geleverd met TLS-ondersteuning, maar het configureren van TLS is optioneel.
Zowel installatie via de UI als de opdrachtregel worden ondersteund.
Hoewel installatie van Zabbix via MSI-installatiepakketten volledig wordt ondersteund, wordt aanbevolen om ten minste Microsoft .NET Framework 2 te installeren voor juiste foutafhandeling. Zie Microsoft Download .NET Framework.
Het wordt aanbevolen om de standaardpaden te gebruiken die door de installateur worden aangeboden, omdat het gebruik van aangepaste paden zonder juiste machtigingen de beveiliging van de installatie kan compromitteren.
Installatiestappen
Om te installeren, dubbelklik op het gedownloade MSI-bestand.
Accepteer de licentie om door te gaan naar de volgende stap.
Specificeer de volgende parameters.
| Parameter | Beschrijving |
|---|---|
| Hostnaam | Specificeer de hostnaam. |
| Zabbix server IP/DNS | Specificeer het IP/DNS van de Zabbix-server. |
| Agent luisterpoort | Specificeer de luisterpoort van de agent (standaard 10050). |
| Server of Proxy voor actieve controles | Specificeer IP/DNS van Zabbix-server/proxy voor actieve agentcontroles. |
| PSK inschakelen | Vink het vakje aan om TLS-ondersteuning via vooraf gedeelde sleutels in te schakelen. |
| Agentlocatie toevoegen aan het PAD | Voeg de locatie van de agent toe aan de PAD-variabele. |
Voer de vooraf gedeelde sleutelidentiteit en -waarde in. Deze stap is alleen beschikbaar als je PSK inschakelen hebt aangevinkt in de vorige stap.
Selecteer de Zabbix-componenten die je wilt installeren - Zabbix-agentdaemon, Zabbix sender, Zabbix get.
Zabbix-componenten samen met het configuratiebestand worden geïnstalleerd in een Zabbix Agent-map in Program Files. zabbix_agentd.exe wordt ingesteld als Windows-service met automatische opstart.
Commando regel gebaseerde installatie
Ondersteunde parameters
De volgende parameters worden ondersteund door de gemaakte MSIs.
| Parameter | Beschrijving |
|---|---|
| ADDDEFAULT | Een door komma's gescheiden lijst van programma's om te installeren. Mogelijke waarden: AgentProgram, GetProgram, SenderProgram, ALL.Voorbeeld: ADDDEFAULT=AgentProgram,GetProgram |
| ADDLOCAL | Een door komma's gescheiden lijst van programma's om te installeren. Mogelijke waarden: AgentProgram, GetProgram, SenderProgram, ALL.Voorbeeld: ADDLOCAL=AgentProgram,SenderProgram |
| ALLOWDENYKEY | Een reeks "AllowKey" en "DenyKey" parameters gescheiden door ;Gebruik \\; om het scheidingsteken te escapen.Voorbeeld: ALLOWDENYKEY="AllowKey=system.run[type c:\windows\system32\drivers\etc\hosts];DenyKey=system.run[*]" |
| CONF | Het volledige pad naar een aangepast configuratiebestand. Voorbeeld: CONF=c:\volledig\pad\naar\user.conf |
| ENABLEPATH | Voeg de locatie van de agent toe aan de PAD-variabele. |
| ENABLEPERSISTENTBUFFER | Alleen Zabbix-agent 2. Schakel het gebruik van lokale persistente opslag in voor actieve items. |
| HOSTINTERFACE | Een optionele parameter die de hostinterface definieert. |
| HOSTMETADATA | Een optionele parameter die de hostmetadata definieert. |
| HOSTMETADATAITEM | Een optionele parameter die een Zabbix-agentitem definieert dat wordt gebruikt om de hostmetadata op te halen. |
| HOSTNAME | Een optionele parameter die de hostnaam definieert. |
| INCLUDE | Reeks inclusies gescheiden door ; |
| INSTALLFOLDER | Het volledige pad van de map waarin Zabbix-componenten samen met het configuratiebestand worden geïnstalleerd. |
| LISTENIP | Een lijst met door komma's gescheiden IP-adressen waarop de agent moet luisteren. |
| LISTENPORT | De agent zal op deze poort luisteren voor verbindingen van de server. |
| LOGFILE | De naam van het logbestand. |
| LOGTYPE | Het type loguitvoer. |
| PERSISTENTBUFFERFILE | Alleen Zabbix-agent 2. Het bestand waarin Zabbix-agent 2 de SQLite-database moet bewaren. |
| PERSISTENTBUFFERPERIOD | Alleen Zabbix-agent 2. De tijdsperiode waarvoor gegevens moeten worden opgeslagen wanneer er geen verbinding is met de server of proxy. |
| SERVER | Een lijst met door komma's gescheiden IP-adressen, optioneel in CIDR-notatie, of DNS-namen van Zabbix-servers en Zabbix-proxies. |
| SERVERACTIVE | Het Zabbix-server/proxy-adres of clusterconfiguratie om actieve controles van te krijgen. |
| SKIP | SKIP=fw - installeer de firewall-uitzonderingsregel niet. |
| STATUSPORT | Alleen Zabbix-agent 2. Als ingesteld, luistert de agent op deze poort voor HTTP-statusverzoeken (http://localhost:<poort>/status). |
| TIMEOUT | Besteed niet meer dan Timeout seconden aan verwerking. |
| TLSACCEPT | Welke binnenkomende verbindingen moeten worden geaccepteerd. |
| TLSCAFILE | Het volledige pad naar een bestand dat de CA-certificaten van het hoogste niveau bevat voor verificatie van het peer-certificaat, gebruikt voor versleutelde communicatie tussen Zabbix-componenten. |
| TLSCERTFILE | Het volledige pad naar een bestand dat het agentcertificaat of de certificaatketen bevat, gebruikt voor versleutelde communicatie tussen Zabbix-componenten. |
| TLSCONNECT | Hoe de agent verbinding moet maken met de Zabbix-server of proxy. |
| TLSCRLFILE | Het volledige pad naar een bestand dat ingetrokken certificaten bevat. Deze parameter wordt gebruikt voor versleutelde communicatie tussen Zabbix-componenten. |
| TLSKEYFILE | Het volledige pad naar een bestand dat de privésleutel van de agent bevat, gebruikt voor versleutelde communicatie tussen Zabbix-componenten. |
| TLSPSKFILE | Het volledige pad naar een bestand dat de pre-shared key van de agent bevat, gebruikt voor versleutelde communicatie met de Zabbix-server. |
| TLSPSKIDENTITY | De identiteitsreeks van de pre-shared key, gebruikt voor versleutelde communicatie met de Zabbix-server. |
| TLSPSKVALUE | De stringwaarde van de pre-shared key, gebruikt voor versleutelde communicatie met de Zabbix-server. |
| TLSSERVERCERTISSUER | De toegestane uitgever van het server (proxy) certificaat. |
| TLSSERVERCERTSUBJECT | Het toegestane onderwerp van het server (proxy) certificaat. |
Examples
To install Zabbix Windows agent from the command-line, you may run, for example:
SET INSTALLFOLDER=C:\Program Files\za
msiexec /l*v log.txt /i zabbix_agent-7.0.0-x86.msi /qn^
LOGTYPE=file^
LOGFILE="%INSTALLFOLDER%\za.log"^
SERVER=192.168.6.76^
LISTENPORT=12345^
SERVERACTIVE=::1^
HOSTNAME=myHost^
TLSCONNECT=psk^
TLSACCEPT=psk^
TLSPSKIDENTITY=MyPSKID^
TLSPSKFILE="%INSTALLFOLDER%\mykey.psk"^
TLSCAFILE="c:\temp\f.txt1"^
TLSCRLFILE="c:\temp\f.txt2"^
TLSSERVERCERTISSUER="My CA"^
TLSSERVERCERTSUBJECT="My Cert"^
TLSCERTFILE="c:\temp\f.txt5"^
TLSKEYFILE="c:\temp\f.txt6"^
ENABLEPATH=1^
INSTALLFOLDER="%INSTALLFOLDER%"^
SKIP=fw^
ALLOWDENYKEY="DenyKey=vfs.file.contents[/etc/passwd]"You may also run, for example:
msiexec /l*v log.txt /i zabbix_agent-7.0.0-x86.msi /qn^
SERVER=192.168.6.76^
TLSCONNECT=psk^
TLSACCEPT=psk^
TLSPSKIDENTITY=MyPSKID^
TLSPSKVALUE=1f87b595725ac58dd977beef14b97461a7c1045b9a1c963065002c5473194952If both TLSPSKFILE and TLSPSKVALUE are passed, then TLSPSKVALUE will be written to TLSPSKFILE.
Zabbix agent 2 loadable plugins
Zabbix agent 2 loadable plugins can be installed on Windows using 64-bit MSI installer packages, available for download.
Minimum OS requirements for MSI installation are Windows 10 (64-bit) or Windows Server 2016.
Packages include:
Packages do not include the Ember+ plugin, which is currently only available to be built from source (for both Unix and Windows).
Before installing a plugin, check its README file. It may contain additional requirements and installation instructions specific to the plugin.
Similarly to Zabbix agent/agent2, loadable plugins can be installed using the Setup Wizard or the command line.
Installation from Setup Wizard
1. Double-click the downloaded MSI file to start the installation.
2. Accept the End-User License Agreement.
3. Select the Zabbix agent 2 loadable plugins (MongoDB plugin, PostgreSQL plugin, MSSQL plugin) to be installed.
It is recommended to use the default installation location provided by the installer. Using a custom location without the necessary permissions may compromise the security of the installation.
4. Click Install to begin the installation.
All selected Zabbix agent 2 loadable plugins will be installed in your specified location (default: C:\Program Files\Zabbix Agent 2), with their configuration files installed in the zabbix_agent2.d subfolder.
5. Click the Finish button to exit the Setup Wizard.
Installation from command line
Zabbix agent 2 loadable plugins can be installed from the command line by running the MSI installer with msiexec. For example:
Zabbix agent 2 loadable plugin MSI installer packages support the following parameters.
| Parameter | Description |
|---|---|
| ADDDEFAULT | A list of comma-delimited components to install in their default configuration. For more information, see ADDDEFAULT property. Possible values: MongodbPlugin, PostgresqlPlugin, MssqlPlugin, ALLExample: ADDDEFAULT=MongodbPlugin,PostgresqlPlugin |
| ADDLOCAL | A list of comma-delimited components to install locally. For more information, see ADDLOCAL property. Possible values: MongodbPlugin, PostgresqlPlugin, MssqlPlugin, ALLExample: ADDLOCAL=MongodbPlugin,MssqlPlugin |
| INSTALLFOLDER | The full pathname to a folder where Zabbix components will be installed, with their configuration files installed in the zabbix_agent2.d subfolder.Example: INSTALLFOLDER="C:\Program Files\Zabbix Agent 2" |