1 Windows Agent-Installation aus MSI

Überblick

Der Zabbix Agent kann unter Windows mit 32-Bit- oder 64-Bit-MSI-Installer-Paketen installiert werden, die zum Download verfügbar sind.

Die Mindestanforderungen an das Betriebssystem für die MSI-Installation sind:

  • Für Zabbix Agent: Windows XP (64-Bit) oder Windows Server 2003
  • Für Zabbix Agent 2: Windows 10 (32-Bit) oder Windows Server 2016

32-Bit-Pakete können nicht auf 64-Bit-Systemen installiert werden.

Die Pakete enthalten:

  • TLS-Unterstützung (die TLS-Konfiguration ist optional)
  • Die Dienstprogramme Zabbix get und Zabbix sender (können zusammen mit Zabbix Agent/Agent 2 oder separat installiert werden)

Zabbix Agent 2-Pakete enthalten keine ladbaren Plugins (MongoDB, PostgreSQL, MSSQL); diese müssen separat heruntergeladen und installiert werden.

Die Installation kann mit dem Setup-Assistenten oder über die Befehlszeile durchgeführt werden.

Obwohl die Installation mit MSI-Paketen vollständig unterstützt wird, wird für eine ordnungsgemäße Fehlerbehandlung empfohlen, mindestens Microsoft .NET Framework 2 zu installieren.

Es wird empfohlen, den vom Installer vorgegebenen Standard-Installationspfad zu verwenden. Die Verwendung eines benutzerdefinierten Pfads ohne die erforderlichen Berechtigungen kann die Sicherheit der Installation beeinträchtigen.

Installation über den Setup-Assistenten

Die folgenden Installationsschritte gelten sowohl für Zabbix Agent als auch für Zabbix agent 2.

1. Doppelklicken Sie auf die heruntergeladene MSI-Datei, um die Installation zu starten:

2. Akzeptieren Sie die Endbenutzer-Lizenzvereinbarung:

3. Wählen Sie die zu installierenden Zabbix-Komponenten (Agent daemon, Zabbix sender, Zabbix get) aus:

Es wird empfohlen, den vom Installationsprogramm vorgeschlagenen Standardinstallationspfad zu verwenden. Die Verwendung eines benutzerdefinierten Speicherorts ohne die erforderlichen Berechtigungen kann die Sicherheit der Installation beeinträchtigen.

4. Konfigurieren Sie die folgenden Parameter. Ihre Werte werden in der Konfigurationsdatei des Zabbix Agent festgelegt:

Parameter Beschreibung
Host name Der Hostname des Computers, auf dem Zabbix Agent installiert wird. Setzt den Parameter Hostname.
Zabbix server IP/DNS Eine durch Kommas getrennte Liste von IP-Adressen, optional in CIDR-Notation, oder DNS-Namen von Zabbix Servern oder Zabbix Proxies. Dieser Parameter ist erforderlich. Setzt den Parameter Server.
Agent listen port Der Agent lauscht auf diesem Port auf Verbindungen vom Server. Setzt den Parameter ListenPort.
Server or Proxy for active checks Die Adresse des Zabbix Servers/Proxys oder die Clusterkonfiguration, von der aktive Prüfungen abgerufen werden. Die Server-/Proxy-Adresse ist eine IP-Adresse oder ein DNS-Name, optional mit durch Doppelpunkt getrenntem Port. Setzt den Parameter ServerActive.
Enable PSK Aktivieren Sie das Kontrollkästchen, um die TLS-Unterstützung mit vorab gemeinsam genutzten Schlüsseln zu aktivieren. Setzt die Parameter TLSConnect und TLSAccept auf psk.
Add agent location to the PATH Aktivieren Sie das Kontrollkästchen, um den Speicherort des Zabbix Agent zur systemweiten PATH-Variable hinzuzufügen.

Wenn ein vorhandener Zabbix Agent erkannt wird, werden die Parameterwerte aus seiner Konfigurationsdatei angezeigt. Zusätzlich wird die vorhandene Konfigurationsdatei während der Installation umbenannt, und eine neue Konfigurationsdatei wird erstellt.

5. Konfigurieren Sie die PSK-Parameter, wenn Sie im vorherigen Schritt das Kontrollkästchen Enable PSK aktiviert haben. Diese Parameter werden ebenfalls in der Konfigurationsdatei des Zabbix Agent festgelegt:

Parameter Beschreibung
Pre-shared key identity Die Identitätszeichenfolge des vorab gemeinsam genutzten Schlüssels. Setzt den Parameter TLSPSKIdentity.
Pre-shared key value Der Zeichenfolgenwert des vorab gemeinsam genutzten Schlüssels. Erstellt die Datei psk.key, die den Schlüssel enthält, und setzt den Parameter TLSPSKFile auf den Speicherort des Schlüssels (Standard: C:\Program Files\Zabbix Agent\psk.key). Es wird empfohlen, den Zugriff auf die Datei mit dem vorab gemeinsam genutzten Schlüssel durch Anpassung der Dateisicherheit so einzuschränken, dass nur Zabbix Agent (oder der Benutzer, unter dem der Agent ausgeführt wird) sie lesen kann.

6. Klicken Sie auf Install, um die Installation zu beginnen.

Alle ausgewählten Zabbix-Komponenten und die Konfigurationsdatei des Zabbix Agent werden im angegebenen Speicherort installiert (Standard: C:\Program Files\Zabbix Agent). Dasselbe gilt für Zabbix agent 2, mit dem Unterschied, dass zusätzliche Konfigurationsdateien für die integrierten Plugins im Unterordner zabbix_agent2.d\plugins.d installiert werden.

Zusätzlich wird zabbix_agentd.exe (oder zabbix_agent2.exe) als Windows-Dienst mit verzögertem automatischem Start eingerichtet (oder mit automatischem Start auf Windows-Versionen vor Windows Vista/Server 2008).

Wenn während der Installation eine andere Version von Zabbix Agent ausgeführt wird, werden Sie aufgefordert, entweder die Anwendung zu schließen und einen erneuten Start zu versuchen oder sie geöffnet zu lassen; in diesem Fall ist ein Neustart erforderlich.

7. Klicken Sie auf die Schaltfläche Finish, um den Setup-Assistenten zu beenden.

Installation über die Befehlszeile

Der Zabbix Agent kann über die Befehlszeile installiert werden, indem das MSI-Installationsprogramm mit msiexec ausgeführt wird. Zum Beispiel:

msiexec.exe /l*v "C:\package.log" /i "C:\zabbix_agent-7.4.0-windows-amd64-openssl.msi" /qn+ SERVER=192.0.2.1

Diese Methode ermöglicht unbeaufsichtigte Installationen und benutzerdefinierte Konfigurationen mithilfe von Parametern.

Unterstützte Parameter

Zabbix agent MSI-Installationspakete unterstützen die folgenden Parameter sowohl für Zabbix agent als auch für Zabbix agent 2.

Die Parameter von Zabbix agent/agent2 werden während der Installation in der Konfigurationsdatei festgelegt. Klicken Sie auf einen Parameternamen, um die ausführliche Beschreibung und Konfigurationsbeispiele auf der Seite Zabbix agent (Windows) anzuzeigen. Für Zabbix agent 2 siehe die Seite Zabbix agent 2 (Windows).

Parameter Beschreibung
ADDDEFAULT Eine durch Kommas getrennte Liste von Komponenten, die in ihrer Standardkonfiguration installiert werden sollen. Weitere Informationen finden Sie unter ADDDEFAULT property.
Mögliche Werte: AgentProgram, GetProgram, SenderProgram, ALL
Beispiel: ADDDEFAULT=AgentProgram,GetProgram
ADDLOCAL Eine durch Kommas getrennte Liste von Komponenten, die lokal installiert werden sollen. Weitere Informationen finden Sie unter ADDLOCAL property.
Mögliche Werte: AgentProgram, GetProgram, SenderProgram, ALL
Beispiel: ADDLOCAL=AgentProgram,SenderProgram
ALLOWDENYKEY Eine durch Semikolons getrennte Liste von AllowKey- oder DenyKey-Parametern zum Einschränken von Zabbix agent-Prüfungen. Falls erforderlich, verwenden Sie einen Backslash, um das Trennzeichen zu maskieren (\;). Setzt die Parameter AllowKey und DenyKey in der Konfigurationsdatei des Agenten.
Beispiel: ALLOWDENYKEY="AllowKey=system.run[more C:\Windows\System32\drivers\etc\hosts\\; echo 'File read complete'];DenyKey=system.run[*]"
CONF Der vollständige Pfad zu einer Vorlage für die Konfigurationsdatei für Zabbix agent. Während der Installation wird diese Datei zur Konfigurationsdatei des Agenten. Die Datei muss mindestens die Parameter Server und LogFile enthalten.
Beispiel: CONF="C:\full\path\to\example.conf"
DONOTSTART Verwenden Sie DONOTSTART=1, um zu verhindern, dass das MSI-Installationsprogramm den Dienst von Zabbix agent startet.
In MSI-Installationspaketen seit Zabbix 7.4.6 unterstützt.
ENABLEPATH Verwenden Sie ENABLEPATH=1, um den Speicherort von Zabbix agent zur System-PATH-Variable hinzuzufügen.
ENABLEPERSISTENTBUFFER Nur Zabbix agent 2. Aktiviert die Verwendung des lokalen persistenten Speichers für aktive Datenpunkte.
HOSTINTERFACE Ein optionaler Parameter, der die Host-Schnittstelle definiert.
HOSTMETADATA Ein optionaler Parameter, der die Host-Metadaten definiert.
HOSTMETADATAITEM Ein optionaler Parameter, der einen Datenpunkt zum Abrufen der Host-Metadaten definiert.
HOSTNAME Ein optionaler Parameter, der den Hostnamen definiert.
HOSTNAMEITEM Ein optionaler Parameter, der einen Datenpunkt zum Abrufen des Hostnamens definiert.
In MSI-Installationspaketen seit Zabbix 7.4.6 unterstützt.
INCLUDE Eine durch Semikolons getrennte Liste einzelner Dateien oder aller Dateien in einem Verzeichnis, die in die Konfigurationsdatei von Zabbix agent aufgenommen werden sollen.
INSTALLFOLDER Der vollständige Pfad zu einem Ordner, in dem Zabbix-Komponenten und die Konfigurationsdatei von Zabbix agent installiert werden. Für Zabbix agent 2 werden zusätzliche Konfigurationsdateien für integrierte Plugins im Unterordner zabbix_agent2.d\plugins.d installiert.
Beispiel: INSTALLFOLDER="C:\Program Files\Zabbix Agent"
LISTENIP Eine Liste von durch Kommas getrennten IP-Adressen, auf denen der Agent lauschen soll.
LISTENPORT Der Agent lauscht auf diesem Port auf Verbindungen vom Server.
LOGFILE Der Name der Protokolldatei von Zabbix agent.
LOGTYPE Der Typ der Protokollausgabe.
NONMSICONFNAME Der vollständige Pfad zu einer benutzerdefinierten Konfigurationsdatei für Zabbix agent. Während der Installation werden alle gültigen Agent-Konfigurationsparameter, die in dieser Datei vorhanden sind (beschränkt auf die in dieser Tabelle aufgeführten), in die neu erstellte Agent-Konfigurationsdatei geschrieben. Die Datei muss mindestens den Parameter Server enthalten.
Beispiel: NONMSICONFNAME="C:\full\path\to\example.conf"
PERSISTENTBUFFERFILE Nur Zabbix agent 2. Die Datei, in der Zabbix agent 2 die SQLite-Datenbank speichern soll.
PERSISTENTBUFFERPERIOD Nur Zabbix agent 2. Der Zeitraum, für den Daten gespeichert werden sollen, wenn keine Verbindung zum Server oder Proxy besteht.
SERVER Eine Liste von durch Kommas getrennten IP-Adressen, optional in CIDR-Notation, oder DNS-Namen von Zabbix-Servern oder Zabbix-Proxys. Dieser Parameter ist erforderlich, außer wenn STARTAGENTS auf 0 gesetzt ist.
SERVERACTIVE Die Adresse des Zabbix-Servers/Proxys oder die Clusterkonfiguration, von der aktive Prüfungen abgerufen werden.
SKIP Verwenden Sie SKIP=fw, um zu verhindern, dass das MSI-Installationsprogramm eine Windows-Firewall-Ausnahmeregel für Zabbix agent hinzufügt.
SOURCEIP Die Quell-IP-Adresse für ausgehende Verbindungen zum Zabbix-Server oder Zabbix-Proxy oder für Verbindungen beim Ausführen bestimmter Datenpunkte (web.page.get, net.tcp.port usw.).
In MSI-Installationspaketen seit Zabbix 7.4.6 unterstützt.
STARTAGENTS Die Anzahl der vorab erzeugten Instanzen von zabbix_agentd, die passive Prüfungen verarbeiten.
Wenn auf 0 gesetzt, sind passive Prüfungen deaktiviert und der Agent lauscht auf keinem TCP-Port.
In MSI-Installationspaketen seit Zabbix 7.4.6 unterstützt.
STARTUPTYPE Starttyp des Zabbix agent-Dienstes. Mögliche Werte:
automatic - den Dienst automatisch beim Windows-Start starten;
delayed - (Standard) den Start des Dienstes verzögern, nachdem die automatisch gestarteten Dienste ihren Start abgeschlossen haben (verfügbar unter Windows Vista/Server 2008 und neueren Versionen);
manual - den Dienst manuell starten (durch einen Benutzer oder eine Anwendung);
disabled - den Dienst deaktivieren, sodass er nicht durch einen Benutzer oder eine Anwendung gestartet werden kann.
Beispiel: STARTUPTYPE=disabled
STATUSPORT Nur Zabbix agent 2. Wenn gesetzt, lauscht der Agent auf diesem Port auf HTTP-Statusanfragen (http://localhost:<port>/status).
TIMEOUT Gibt an, wie lange (in Sekunden) auf den Verbindungsaufbau und den Datenaustausch mit Zabbix Proxy oder Server gewartet werden soll.
TLSACCEPT Die eingehenden Verbindungen, die akzeptiert werden sollen (für passive Prüfungen verwendet). Wenn auf psk gesetzt, wird auch TLSCONNECT auf psk gesetzt (sofern nicht anders angegeben).
TLSCAFILE Der vollständige Pfad zu einer Datei mit den Zertifikaten der obersten CA(s) zur Überprüfung von Peer-Zertifikaten.
TLSCERTFILE Der vollständige Pfad zu einer Datei mit dem Zertifikat oder der Zertifikatskette des Agenten.
TLSCONNECT Wie der Agent eine Verbindung zu Zabbix Server oder Proxy herstellen soll (für aktive Prüfungen verwendet). Wenn auf psk gesetzt, wird auch TLSACCEPT auf psk gesetzt (sofern nicht anders angegeben).
TLSCRLFILE Der vollständige Pfad zu einer Datei mit widerrufenen Zertifikaten.
TLSKEYFILE Der vollständige Pfad zu einer Datei mit dem privaten Schlüssel von Zabbix agent.
TLSPSKFILE Der vollständige Pfad zu einer Datei mit dem vorab gemeinsam genutzten Schlüssel von Zabbix agent. Wenn sowohl TLSPSKFILE als auch TLSPSKVALUE gesetzt sind, wird der Wert von TLSPSKVALUE in die in TLSPSKFILE angegebene Datei geschrieben. Es wird empfohlen, den Zugriff auf die Datei mit dem vorab gemeinsam genutzten Schlüssel durch Anpassung der Dateisicherheit so einzuschränken, dass nur Zabbix agent (oder der Benutzer, unter dem der Agent ausgeführt wird) sie lesen kann.
TLSPSKIDENTITY Die Identitätszeichenfolge des vorab gemeinsam genutzten Schlüssels.
TLSPSKVALUE Der Zeichenfolgenwert des vorab gemeinsam genutzten Schlüssels. Wenn sowohl TLSPSKFILE als auch TLSPSKVALUE gesetzt sind, wird der Wert von TLSPSKVALUE in die in TLSPSKFILE angegebene Datei geschrieben.
Beispiel: TLSPSKVALUE=1f87b595725ac58dd977beef14b97461a7c1045b9a1c963065002c5473194952
TLSSERVERCERTISSUER Der zulässige Aussteller des Serverzertifikats (Proxyzertifikats).
TLSSERVERCERTSUBJECT Der zulässige Betreff des Serverzertifikats (Proxyzertifikats).
UNSAFEUSERPARAMETERS Erlaubt, dass alle Zeichen in Argumenten an benutzerdefinierte Parameter übergeben werden.
In MSI-Installationspaketen seit Zabbix 7.4.6 unterstützt.
Beispiele

Das folgende Beispiel installiert den Zabbix Agent mit benutzerdefinierter Konfiguration. Außerdem wird die TLS-Unterstützung mithilfe vorab gemeinsam genutzter Schlüssel aktiviert.

mkdir "C:\Program Files\Zabbix Agent" 2>nul
msiexec.exe /l*v "C:\package.log" /i "C:\zabbix_agent-7.4.0-windows-amd64-openssl.msi" /qn+^
 SERVER=192.0.2.1^
 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[*]"

Das nächste Beispiel installiert eine neuere Version des Zabbix Agent und verwendet eine Vorlage-Konfigurationsdatei (CONF="C:\agent-template.conf"). Während der Installation wird diese Datei zur Konfigurationsdatei des Agent. Um Parameter aus der alten Konfigurationsdatei zu übernehmen, verwenden Sie Parameterplatzhalter (z. B. [AllowDenyKey]).

msiexec.exe /l*v "C:\package.log" /i "C:\zabbix_agent-7.4.1-windows-amd64-openssl.msi" /qn+ NONMSICONFNAME="C:\agent.conf"

# agent-template.conf example:
LogFile=[LogFile]
[AllowDenyKey]
Server=192.0.2.8
Hostname=DESKTOP-X9F4A2B
[Include]
[TLSConnect]
[TLSAccept]
[TLSPSKIdentity]
[TLSPSKFile]

Alternativ können Sie eine benutzerdefinierte Konfigurationsdatei (NONMSICONFNAME="C:\agent-custom.conf") verwenden. Während der Installation werden alle gültigen Konfigurationsparameter des Agent, die in dieser Datei vorhanden sind (beschränkt auf die in der obigen Tabelle aufgeführten), in die neu erstellte Konfigurationsdatei des Agent geschrieben. Um die bestehende Konfiguration des Agent beizubehalten, definieren Sie die zu erhaltenden Parameter.

msiexec.exe /l*v "C:\package.log" /i "C:\zabbix_agent-7.4.1-windows-amd64-openssl.msi" /qn+ NONMSICONFNAME="C:\agent-custom.conf"

# agent-custom.conf example:
Server=192.0.2.8
Hostname=DESKTOP-X9F4A2B

Ladbare Plugins für Zabbix Agent 2

Zabbix Agent 2 ladbare Plugins können unter Windows mit 64-Bit-MSI-Installationspaketen installiert werden, die zum Download verfügbar sind.

Die Mindestanforderungen an das Betriebssystem für die MSI-Installation sind Windows 10 (64-Bit) oder Windows Server 2016.

Ähnlich wie bei Zabbix Agent/Agent2 können ladbare Plugins über den Setup-Assistenten oder die Befehlszeile installiert werden.

Prüfen Sie vor der Installation eines Plugins bitte die README-Datei. Sie kann spezifische Anforderungen und Installationsanweisungen enthalten.

Installation über den Setup-Assistenten

1. Doppelklicken Sie auf die heruntergeladene MSI-Datei, um die Installation zu starten.

2. Akzeptieren Sie die Endbenutzer-Lizenzvereinbarung.

3. Wählen Sie die zu installierenden ladbaren Plugins für Zabbix Agent 2 aus.

Es wird empfohlen, den vom Installationsprogramm vorgegebenen Standard-Installationspfad zu verwenden. Die Verwendung eines benutzerdefinierten Pfads ohne die erforderlichen Berechtigungen kann die Sicherheit der Installation beeinträchtigen.

4. Klicken Sie auf Install, um die Installation zu beginnen.

Alle ausgewählten ladbaren Plugins für Zabbix Agent 2 werden an dem von Ihnen angegebenen Speicherort installiert (Standard: C:\Program Files\Zabbix Agent 2), wobei ihre Konfigurationsdateien im Unterordner zabbix_agent2.d installiert werden.

5. Klicken Sie auf die Schaltfläche Finish, um den Setup-Assistenten zu beenden.

Installation über die Befehlszeile

Zabbix Agent 2 ladbare Plugins können über die Befehlszeile installiert werden, indem das MSI-Installationsprogramm mit msiexec ausgeführt wird. Zum Beispiel:

msiexec.exe /l*v "C:\package.log" /i "C:\zabbix_agent2_plugins-7.4.0-windows-amd64.msi" /qn+

Die MSI-Installationspakete für ladbare Plugins von Zabbix Agent 2 unterstützen die folgenden Parameter.

Parameter Beschreibung
ADDDEFAULT Eine durch Kommas getrennte Liste von Komponenten, die in ihrer Standardkonfiguration installiert werden. Weitere Informationen finden Sie unter ADDDEFAULT property.
Mögliche Werte: ALL, EmberplusPlugin, MongodbPlugin, MssqlPlugin, NvidiagpuPlugin, PostgresqlPlugin
Beispiel: ADDDEFAULT=MongodbPlugin,PostgresqlPlugin
ADDLOCAL Eine durch Kommas getrennte Liste von Komponenten, die lokal installiert werden. Weitere Informationen finden Sie unter ADDLOCAL property.
Mögliche Werte: ALL, EmberplusPlugin, MongodbPlugin, MssqlPlugin, NvidiagpuPlugin, PostgresqlPlugin
Beispiel: ADDLOCAL=MongodbPlugin,MssqlPlugin
INSTALLFOLDER Der vollständige Pfad zu einem Ordner, in dem Zabbix-Komponenten installiert werden, wobei ihre Konfigurationsdateien im Unterordner zabbix_agent2.d installiert werden.
Beispiel: INSTALLFOLDER="C:\Program Files\Zabbix Agent 2"