Sidebar

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.

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

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.0.6-x86.msi /qn^
        SERVER=192.168.6.76^
        TLSCONNECT=psk^
        TLSACCEPT=psk^
        TLSPSKIDENTITY=MyPSKID^
        TLSPSKVALUE=1f87b595725ac58dd977beef14b97461a7c1045b9a1c963065002c5473194952