Table of Contents
3 Windows agent installation from MSI
Overview
Zabbix Windows agent can be installed from Windows MSI installer packages (32-bit or 64-bit) available for download.
The Zabbix get and sender utilities can also be installed, either together with Zabbix agent or separately.
32-bit package cannot be installed on a 64-bit Windows.
All packages come with TLS support, however, configuring TLS is optional.
Both UI and command-line based installation is supported.
Installation steps
To install, double-click the downloaded MSI file.
Accept the license to proceed to the next step.
Specify the following parameters.
| Parameter | Description |
|---|---|
| Host name | Specify host name. |
| Zabbix server IP/DNS | Specify IP/DNS of Zabbix server. |
| Agent listen port | Specify agent listen port (10050 by default). |
| Server or Proxy for active checks | Specify IP/DNS of Zabbix server/proxy for active agent checks. |
| Remote commands | Mark the checkbox to enable remote commands. |
| Enable PSK | Mark the checkbox to enable TLS support via pre-shared keys. |
| Add agent location to the PATH | Add agent location to the PATH variable. |
Enter pre-shared key identity and value. This step is only available if you checked Enable PSK in the previous step.
Select Zabbix components to install - Zabbix agent daemon, Zabbix sender, Zabbix get.
Zabbix components along with the configuration file will be installed in a Zabbix Agent folder in Program Files. zabbix_agentd.exe will be set up as Windows service with automatic startup.
Command-line based installation
Supported parameters
The following set of parameters is supported by created MSIs:
| Number | Parameter | Description |
|---|---|---|
| 1 | LOGTYPE | |
| 2 | LOGFILE | |
| 3 | ENABLEREMOTECOMMANDS | |
| 4 | SERVER | |
| 5 | LISTENPORT | |
| 6 | SERVERACTIVE | |
| 7 | HOSTNAME | |
| 8 | TIMEOUT | |
| 9 | TLSCONNECT | |
| 10 | TLSACCEPT | |
| 11 | TLSPSKIDENTITY | |
| 12 | TLSPSKFILE | |
| 13 | TLSPSKVALUE | |
| 14 | TLSCAFILE | |
| 15 | TLSCRLFILE | |
| 16 | TLSSERVERCERTISSUER | |
| 17 | TLSSERVERCERTSUBJECT | |
| 18 | TLSCERTFILE | |
| 19 | TLSKEYFILE | |
| 20 | INSTALLFOLDER | |
| 21 | ENABLEPATH | |
| 22 | SKIP | SKIP=fw - do not install firewall exception rule |
| 23 | ADDPROGRAM | A comma-delimited list of programs to install. Possible values: AgentProgram, GetProgram, SenderProgramE.g., ADDPROGRAM=AgentProgram,GetProgram |
| 24 | ADDLOCAL | A comma-delimited list of programs to install. Possible values: AgentProgram, GetProgram, SenderProgramE.g., ADDLOCAL=AgentProgram,SenderProgram |
| 25 | CONF | Specify path to custom configuration file, e.g., CONF=c:\full\path\to\user.conf |
To install you may run, for example:
SET INSTALLFOLDER=C:\Program Files\za
msiexec /l*v log.txt /i zabbix_agent-4.0.6-x86.msi /qn^
LOGTYPE=file^
LOGFILE="%INSTALLFOLDER%\za.log"^
ENABLEREMOTECOMMANDS=1^
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=fwor
msiexec /l*v log.txt /i zabbix_agent-4.0.6-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.