Installation des Windows-Agenten 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 mit dem 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 aus (Agent-Daemon, Zabbix sender, Zabbix get):

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. Konfigurieren Sie die folgenden Parameter. Ihre Werte werden in der Zabbix-Agent-Konfigurationsdatei festgelegt:

Parameter Beschreibung
Host name Der Hostname des Rechners, 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-Proxys. Dieser Parameter ist verpflichtend. 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 Cluster-Konfiguration, von der aktive Prüfungen abgerufen werden. Die Server-/Proxy-Adresse ist eine IP-Adresse oder ein DNS-Name mit optionalem, durch Doppelpunkt getrenntem Port. Setzt den Parameter ServerActive.
Enable PSK Aktivieren Sie das Kontrollkästchen, um TLS-Unterstützung mit vorinstallierten 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 Installationspfad von Zabbix Agent zur Systemvariablen PATH hinzuzufügen.

Wenn ein vorhandener Zabbix Agent erkannt wird, werden die Parameterwerte aus dessen Konfigurationsdatei angezeigt. Außerdem wird die vorhandene Konfigurationsdatei während der Installation umbenannt und eine neue Konfigurationsdatei 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 Zabbix-Agent-Konfigurationsdatei festgelegt:

Parameter Beschreibung
Pre-shared key identity Die Identitätszeichenfolge des vorinstallierten Schlüssels. Setzt den Parameter TLSPSKIdentity.
Pre-shared key value Der Zeichenfolgenwert des vorinstallierten 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 vorinstallierten Schlüssel durch Anpassen der Sicherheitseinstellungen der Datei einzuschränken, sodass 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 starten.

Alle ausgewählten Zabbix-Komponenten und die Zabbix-Agent-Konfigurationsdatei werden an dem von Ihnen angegebenen Speicherort installiert (Standard: C:\Program Files\Zabbix Agent). Dasselbe gilt für Zabbix Agent 2, mit der Ausnahme, dass zusätzliche Konfigurationsdateien für seine 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 Neustart zu versuchen oder sie geöffnet zu lassen; in diesem Fall ist ein Neustart des Systems 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-8.0.0-windows-amd64-openssl.msi" /qn+ SERVER=192.0.2.0

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

Unterstützte Parameter

Die MSI-Installer-Pakete des Zabbix Agent 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 gesetzt. Klicken Sie auf einen Parameternamen, um seine detaillierte 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 mit 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, um Zabbix-Agent-Prüfungen einzuschränken. Falls erforderlich, verwenden Sie einen Backslash, um das Trennzeichen zu maskieren (\;). Setzt die Parameter AllowKey und DenyKey in der Konfigurationsdatei des Agent.
Beispiel: ALLOWDENYKEY="AllowKey=system.run[more C:\Windows\System32\drivers\etc\hosts\\; echo 'File read complete'];DenyKey=system.run[*]"
CONF Der vollständige Pfadname zu einer Vorlagen-Konfigurationsdatei für Zabbix Agent. Während der Installation wird diese Datei zur Konfigurationsdatei des Agent. 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 der MSI-Installer den Zabbix-Agent-Dienst startet.
ENABLEPATH Verwenden Sie ENABLEPATH=1, um den Speicherort von Zabbix Agent zur Systemvariablen PATH hinzuzufügen.
ENABLEPERSISTENTBUFFER Nur Zabbix Agent 2. Aktiviert die Verwendung eines 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 definiert, der zum Abrufen der Host-Metadaten verwendet wird.
HOSTNAME Ein optionaler Parameter, der den Hostnamen definiert.
HOSTNAMEITEM Ein optionaler Parameter, der einen Datenpunkt definiert, der zum Abrufen des Hostnamens verwendet wird.
INCLUDE Eine durch Semikolons getrennte Liste einzelner Dateien oder aller Dateien in einem Verzeichnis, die in die Konfigurationsdatei des Zabbix Agent aufgenommen werden sollen.
INSTALLFOLDER Der vollständige Pfadname zu einem Ordner, in dem Zabbix-Komponenten und die Konfigurationsdatei des 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 durch Kommas getrennte Liste von IP-Adressen, auf denen der Agent lauschen soll.
LISTENPORT Der Agent lauscht auf diesem Port auf Verbindungen vom Server.
LOGFILE Der Name der Protokolldatei des Zabbix Agent.
LOGTYPE Der Typ der Protokollausgabe.
NONMSICONFNAME Der vollständige Pfadname 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 Konfigurationsdatei des Agent 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 durch Kommas getrennte Liste von IP-Adressen, optional in CIDR-Notation, oder DNS-Namen von Zabbix-Servern oder Zabbix-Proxys. Dieser Parameter ist verpflichtend, außer wenn STARTAGENTS auf 0 gesetzt ist.
SERVERACTIVE Die Adresse des Zabbix Server/Proxy oder die Cluster-Konfiguration, von der aktive Prüfungen abgerufen werden.
SKIP Verwenden Sie SKIP=fw, um zu verhindern, dass der MSI-Installer eine Ausnahmeregel in der Windows-Firewall 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, die bei der Ausführung einiger Datenpunkte hergestellt werden (web.page.get, net.tcp.port usw.).
STARTAGENTS Die Anzahl der vorab geforkten 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.
STARTUPTYPE Starttyp des Zabbix-Agent-Dienstes. Mögliche Werte:
automatic - den Dienst beim Windows-Start automatisch starten;
delayed - (Standard) den Start des Dienstes verzögern, bis die automatisch gestarteten Dienste vollständig gestartet wurden (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 zu akzeptierenden eingehenden Verbindungen (verwendet für passive Prüfungen). Wenn auf psk gesetzt, wird TLSCONNECT ebenfalls auf psk gesetzt (sofern nicht anders angegeben).
TLSCAFILE Der vollständige Pfadname einer Datei, die die Zertifikate der obersten CA(s) zur Verifizierung des Zertifikats der Gegenstelle enthält.
TLSCERTFILE Der vollständige Pfadname einer Datei, die das Zertifikat oder die Zertifikatskette des Agent enthält.
TLSCONNECT Wie sich der Agent mit Zabbix Server oder Proxy verbinden soll (verwendet für aktive Prüfungen). Wenn auf psk gesetzt, wird TLSACCEPT ebenfalls auf psk gesetzt (sofern nicht anders angegeben).
TLSCRLFILE Der vollständige Pfadname einer Datei, die widerrufene Zertifikate enthält.
TLSKEYFILE Der vollständige Pfadname einer Datei, die den privaten Schlüssel des Zabbix Agent enthält.
TLSPSKFILE Der vollständige Pfadname einer Datei, die den Pre-Shared Key des Zabbix Agent enthält. 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 Pre-Shared-Key-Datei durch Anpassen der Sicherheitseinstellungen der Datei einzuschränken, sodass nur Zabbix Agent (oder der Benutzer, der den Agent ausführt) sie lesen kann.
TLSPSKIDENTITY Die Identitätszeichenfolge des Pre-Shared Key.
TLSPSKVALUE Der Zeichenfolgenwert des Pre-Shared Key. 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 Server-(Proxy-)Zertifikats.
TLSSERVERCERTSUBJECT Der zulässige Betreff des Server-(Proxy-)Zertifikats.
UNSAFEUSERPARAMETERS Erlaubt, alle Zeichen in Argumenten für benutzerdefinierte Parameter zu übergeben.
Beispiele

Das folgende Beispiel installiert den Zabbix Agent mit benutzerdefinierter Konfiguration. Es aktiviert außerdem die TLS-Unterstützung mithilfe von Pre-Shared Keys.

mkdir "C:\Program Files\Zabbix Agent" 2>nul
msiexec.exe /l*v "C:\package.log" /i "C:\zabbix_agent-8.0.0-windows-amd64-openssl.msi" /qn+^
 SERVER=192.0.2.0^
 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 Vorlagen-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 Parameter-Platzhalter (z. B. [AllowDenyKey]).

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

# Beispiel für agent-template.conf:
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 Agent-Konfigurationsparameter, 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 Agent-Konfiguration beizubehalten, definieren Sie die Parameter, die beibehalten werden sollen.

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

# Beispiel für agent-custom.conf:
Server=192.0.2.8
Hostname=DESKTOP-X9F4A2B

Zabbix Agent 2 ladbare Plugins

Ladbare Plugins für Zabbix Agent 2 loadable plugins können unter Windows mit 64-Bit-MSI-Installer-Paketen 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.

Bitte prüfen Sie vor der Installation eines Plugins dessen README-Datei. Sie kann spezifische Anforderungen und Installationsanweisungen enthalten.

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

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

Ladbare Plugins für Zabbix Agent 2 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-8.0.0-windows-amd64.msi" /qn+

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