5 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:
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 | LISTENIP | |
24 | HOSTINTERFACE | |
25 | HOSTMETADATA | |
26 | STATUSPORT | Supported for Zabbix agent 2 only. |
27 | ENABLEPERSISTENTBUFFER | Supported for Zabbix agent 2 only. |
28 | PERSISTENTBUFFERPERIOD | Supported for Zabbix agent 2 only. |
29 | PERSISTENTBUFFERFILE | Supported for Zabbix agent 2 only. |
For description of these parameters see Daemon configuration for Zabbix agent / Zabbix agent 2.
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=fw
or
msiexec /l*v log.txt /i zabbix_agent-4.4.0-x86.msi /qn^
SERVER=192.168.6.76^
TLSCONNECT=psk^
TLSACCEPT=psk^
TLSPSKIDENTITY=MyPSKID^
TLSPSKVALUE=1f87b595725ac58dd977beef14b97461a7c1045b9a1c963065002c5473194952