Installation de l'agent Windows à partir d'un MSI

Aperçu

L'agent Zabbix peut être installé sur Windows à l'aide de packages d'installation MSI 32 bits ou 64 bits, disponibles au téléchargement.

La configuration minimale requise du système d'exploitation pour l'installation MSI est la suivante :

  • Pour l'agent Zabbix : Windows XP (64 bits) ou Windows Server 2003
  • Pour l'agent Zabbix 2 : Windows 10 (32 bits) ou Windows Server 2016

Les packages 32 bits ne peuvent pas être installés sur des systèmes 64 bits.

Les packages incluent :

  • la prise en charge de TLS (la configuration TLS est facultative)
  • les utilitaires Zabbix get et Zabbix sender (peuvent être installés avec l'agent Zabbix/l'agent 2 ou séparément)

Les packages de l'agent Zabbix 2 n'incluent pas les plugins chargeables (MongoDB, PostgreSQL, MSSQL), qui doivent être téléchargés et installés séparément.

L'installation peut être effectuée à l'aide de l'assistant d'installation ou de la ligne de commande.

Bien que l'installation à l'aide de packages MSI soit entièrement prise en charge, il est recommandé d'installer au minimum Microsoft .NET Framework 2 pour une gestion correcte des erreurs.

Il est recommandé d'utiliser l'emplacement d'installation par défaut fourni par le programme d'installation. L'utilisation d'un emplacement personnalisé sans les autorisations nécessaires peut compromettre la sécurité de l'installation.

Installation à partir de l’assistant d’installation

Les étapes d’installation suivantes s’appliquent à la fois à Zabbix agent et à Zabbix agent 2.

1. Double-cliquez sur le fichier MSI téléchargé pour démarrer l’installation :

2. Acceptez le contrat de licence utilisateur final :

3. Sélectionnez les composants Zabbix (Agent daemon, Zabbix sender, Zabbix get) à installer :

Il est recommandé d’utiliser l’emplacement d’installation par défaut fourni par le programme d’installation. L’utilisation d’un emplacement personnalisé sans les autorisations nécessaires peut compromettre la sécurité de l’installation.

4. Configurez les paramètres suivants. Leurs valeurs seront définies dans le fichier de configuration de Zabbix agent :

Paramètre Description
Host name Le nom d’hôte de la machine sur laquelle Zabbix agent est installé. Définit le paramètre Hostname.
Zabbix server IP/DNS Une liste d’adresses IP séparées par des virgules, éventuellement en notation CIDR, ou de noms DNS de serveurs Zabbix ou de proxies Zabbix. Ce paramètre est obligatoire. Définit le paramètre Server.
Agent listen port L’agent écoutera sur ce port les connexions provenant du serveur. Définit le paramètre ListenPort.
Server or Proxy for active checks L’adresse du serveur/proxy Zabbix ou la configuration du cluster à partir de laquelle obtenir les active checks. L’adresse du serveur/proxy est une adresse IP ou un nom DNS, avec un port facultatif séparé par deux-points. Définit le paramètre ServerActive.
Enable PSK Cochez cette case pour activer la prise en charge de TLS à l’aide de clés pré-partagées. Définit les paramètres TLSConnect et TLSAccept sur psk.
Add agent location to the PATH Cochez cette case pour ajouter l’emplacement de Zabbix agent à la variable système PATH.

Si un Zabbix agent existant est détecté, les valeurs des paramètres de son fichier de configuration seront affichées. De plus, le fichier de configuration existant sera renommé pendant l’installation, et un nouveau fichier de configuration sera créé.

5. Configurez les paramètres PSK si vous avez coché la case Enable PSK à l’étape précédente. Ces paramètres seront également définis dans le fichier de configuration de Zabbix agent :

Paramètre Description
Pre-shared key identity La chaîne d’identité de la clé pré-partagée. Définit le paramètre TLSPSKIdentity.
Pre-shared key value La valeur de chaîne de la clé pré-partagée. Crée le fichier psk.key contenant la clé et définit le paramètre TLSPSKFile sur l’emplacement de la clé (par défaut : C:\Program Files\Zabbix Agent\psk.key). Il est recommandé de restreindre l’accès au fichier de clé pré-partagée en ajustant les paramètres de sécurité du fichier afin que seul Zabbix agent (ou l’utilisateur exécutant l’agent) puisse le lire.

6. Cliquez sur Install pour commencer l’installation.

Tous les composants Zabbix sélectionnés ainsi que le fichier de configuration de Zabbix agent seront installés à l’emplacement que vous avez spécifié (par défaut : C:\Program Files\Zabbix Agent). Il en va de même pour Zabbix agent 2, sauf que des fichiers de configuration supplémentaires pour ses plugins intégrés seront installés dans le sous-dossier zabbix_agent2.d\plugins.d.

De plus, zabbix_agentd.exe (ou zabbix_agent2.exe) sera configuré comme un service Windows avec démarrage automatique différé (ou démarrage automatique sur les versions de Windows antérieures à Windows Vista/Server 2008).

Si une autre version de Zabbix agent est en cours d’exécution pendant l’installation, il vous sera demandé de choisir soit de fermer l’application et d’essayer de la redémarrer, soit de la laisser ouverte, auquel cas un redémarrage sera nécessaire.

7. Cliquez sur le bouton Finish pour quitter l’assistant d’installation.

Installation depuis la ligne de commande

L'agent Zabbix peut être installé depuis la ligne de commande en exécutant le programme d'installation MSI avec msiexec. Par exemple :

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

Cette méthode permet des installations sans assistance et des configurations personnalisées à l'aide de paramètres.

Paramètres pris en charge

Les packages d’installation MSI de l’agent Zabbix prennent en charge les paramètres suivants pour Zabbix agent et Zabbix agent 2.

Les paramètres de Zabbix agent/agent2 sont définis dans le fichier de configuration pendant l’installation. Cliquez sur le nom d’un paramètre pour afficher sa description détaillée et des exemples de configuration sur la page Zabbix agent (Windows). Pour Zabbix agent 2, reportez-vous à la page Zabbix agent 2 (Windows).

Parameter Description
ADDDEFAULT Une liste de composants, séparés par des virgules, à installer avec leur configuration par défaut. Pour plus d’informations, voir propriété ADDDEFAULT.
Valeurs possibles : AgentProgram, GetProgram, SenderProgram, ALL
Exemple : ADDDEFAULT=AgentProgram,GetProgram
ADDLOCAL Une liste de composants, séparés par des virgules, à installer localement. Pour plus d’informations, voir propriété ADDLOCAL.
Valeurs possibles : AgentProgram, GetProgram, SenderProgram, ALL
Exemple : ADDLOCAL=AgentProgram,SenderProgram
ALLOWDENYKEY Une liste de paramètres AllowKey ou DenyKey, séparés par des points-virgules, pour restreindre les contrôles de l’agent Zabbix. Si nécessaire, utilisez une barre oblique inverse pour échapper le délimiteur (\;). Définit les paramètres AllowKey et DenyKey dans le fichier de configuration de l’agent.
Exemple : ALLOWDENYKEY="AllowKey=system.run[more C:\Windows\System32\drivers\etc\hosts\\; echo 'File read complete'];DenyKey=system.run[*]"
CONF Le chemin complet vers un fichier de configuration modèle pour Zabbix agent. Pendant l’installation, ce fichier deviendra le fichier de configuration de l’agent. Le fichier doit contenir au minimum les paramètres Server et LogFile.
Exemple : CONF="C:\full\path\to\example.conf"
DONOTSTART Utilisez DONOTSTART=1 pour empêcher le programme d’installation MSI de démarrer le service Zabbix agent.
ENABLEPATH Utilisez ENABLEPATH=1 pour ajouter l’emplacement de Zabbix agent à la variable système PATH.
ENABLEPERSISTENTBUFFER Zabbix agent 2 uniquement. Active l’utilisation d’un stockage persistant local pour les éléments actifs.
HOSTINTERFACE Paramètre facultatif qui définit l’interface de l’hôte.
HOSTMETADATA Paramètre facultatif qui définit les métadonnées de l’hôte.
HOSTMETADATAITEM Paramètre facultatif qui définit un élément utilisé pour obtenir les métadonnées de l’hôte.
HOSTNAME Paramètre facultatif qui définit le nom d’hôte.
HOSTNAMEITEM Paramètre facultatif qui définit un élément utilisé pour obtenir le nom d’hôte.
INCLUDE Une liste, séparée par des points-virgules, de fichiers individuels ou de tous les fichiers d’un répertoire à inclure dans le fichier de configuration de Zabbix agent.
INSTALLFOLDER Le chemin complet vers un dossier dans lequel les composants Zabbix et le fichier de configuration de Zabbix agent seront installés. Pour Zabbix agent 2, des fichiers de configuration supplémentaires pour les plugins intégrés seront installés dans le sous-dossier zabbix_agent2.d\plugins.d.
Exemple : INSTALLFOLDER="C:\Program Files\Zabbix Agent"
LISTENIP Une liste d’adresses IP, séparées par des virgules, sur lesquelles l’agent doit écouter.
LISTENPORT L’agent écoutera sur ce port les connexions provenant du serveur.
LOGFILE Le nom du fichier journal de Zabbix agent.
LOGTYPE Le type de sortie du journal.
NONMSICONFNAME Le chemin complet vers un fichier de configuration personnalisé pour Zabbix agent. Pendant l’installation, tous les paramètres de configuration d’agent valides présents dans ce fichier (limités à ceux listés dans ce tableau) seront écrits dans le fichier de configuration de l’agent nouvellement créé. Le fichier doit contenir au minimum le paramètre Server.
Exemple : NONMSICONFNAME="C:\full\path\to\example.conf"
PERSISTENTBUFFERFILE Zabbix agent 2 uniquement. Le fichier dans lequel Zabbix agent 2 doit conserver la base de données SQLite.
PERSISTENTBUFFERPERIOD Zabbix agent 2 uniquement. La période pendant laquelle les données doivent être conservées lorsqu’il n’y a pas de connexion au serveur ou au proxy.
SERVER Une liste d’adresses IP, séparées par des virgules, éventuellement en notation CIDR, ou de noms DNS de serveurs Zabbix ou de proxys Zabbix. Ce paramètre est obligatoire, sauf lorsque STARTAGENTS est défini sur 0.
SERVERACTIVE L’adresse du serveur/proxy Zabbix ou la configuration du cluster à partir de laquelle obtenir les contrôles actifs.
SKIP Utilisez SKIP=fw pour empêcher le programme d’installation MSI d’ajouter une règle d’exception du Pare-feu Windows pour Zabbix agent.
SOURCEIP L’adresse IP source pour les connexions sortantes vers le serveur Zabbix ou le proxy Zabbix, ou pour établir des connexions lors de l’exécution de certains éléments (web.page.get, net.tcp.port, etc.).
STARTAGENTS Le nombre d’instances pré-forkées de zabbix_agentd qui traitent les contrôles passifs.
Si défini sur 0, les contrôles passifs sont désactivés et l’agent n’écoutera sur aucun port TCP.
STARTUPTYPE Type de démarrage du service Zabbix agent. Valeurs possibles :
automatic - démarrer le service automatiquement au démarrage de Windows ;
delayed - (par défaut) retarder le démarrage du service jusqu’à ce que les services démarrés automatiquement aient terminé leur démarrage (disponible sur Windows Vista/Server 2008 et versions ultérieures) ;
manual - démarrer le service manuellement (par un utilisateur ou une application) ;
disabled - désactiver le service afin qu’il ne puisse pas être démarré par un utilisateur ou une application.
Exemple : STARTUPTYPE=disabled
STATUSPORT Zabbix agent 2 uniquement. Si défini, l’agent écoutera sur ce port les requêtes d’état HTTP (http://localhost:<port>/status).
TIMEOUT Spécifie combien de temps attendre (en secondes) pour établir une connexion et échanger des données avec le proxy ou le serveur Zabbix.
TLSACCEPT Les connexions entrantes à accepter (utilisé pour les contrôles passifs). Si défini sur psk, alors TLSCONNECT sera également défini sur psk (sauf indication contraire).
TLSCAFILE Le chemin complet d’un fichier contenant les certificats de la ou des autorités de certification racines pour la vérification du certificat du pair.
TLSCERTFILE Le chemin complet d’un fichier contenant le certificat de l’agent ou la chaîne de certificats.
TLSCONNECT Comment l’agent doit se connecter au serveur ou au proxy Zabbix (utilisé pour les contrôles actifs). Si défini sur psk, alors TLSACCEPT sera également défini sur psk (sauf indication contraire).
TLSCRLFILE Le chemin complet d’un fichier contenant les certificats révoqués.
TLSKEYFILE Le chemin complet d’un fichier contenant la clé privée de Zabbix agent.
TLSPSKFILE Le chemin complet d’un fichier contenant la clé pré-partagée de Zabbix agent. Si TLSPSKFILE et TLSPSKVALUE sont tous deux définis, la valeur de TLSPSKVALUE sera écrite dans le fichier spécifié dans TLSPSKFILE. Il est recommandé de restreindre l’accès au fichier de clé pré-partagée en ajustant les paramètres de sécurité du fichier afin que seul Zabbix agent (ou l’utilisateur exécutant l’agent) puisse le lire.
TLSPSKIDENTITY La chaîne d’identité de la clé pré-partagée.
TLSPSKVALUE La valeur de chaîne de la clé pré-partagée. Si TLSPSKFILE et TLSPSKVALUE sont tous deux définis, la valeur de TLSPSKVALUE sera écrite dans le fichier spécifié dans TLSPSKFILE.
Exemple : TLSPSKVALUE=1f87b595725ac58dd977beef14b97461a7c1045b9a1c963065002c5473194952
TLSSERVERCERTISSUER L’émetteur de certificat autorisé du serveur (proxy).
TLSSERVERCERTSUBJECT Le sujet de certificat autorisé du serveur (proxy).
UNSAFEUSERPARAMETERS Autorise le passage de tous les caractères dans les arguments des paramètres définis par l’utilisateur.
Exemples

L'exemple suivant installe l'agent Zabbix avec une configuration personnalisée. Il active également la prise en charge de TLS à l'aide de clés pré-partagées.

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[*]"

L'exemple suivant installe une version plus récente de l'agent Zabbix et utilise un fichier de configuration modèle (CONF="C:\agent-template.conf"). Pendant l'installation, ce fichier deviendra le fichier de configuration de l'agent. Pour hériter des paramètres de l'ancien fichier de configuration, utilisez des espaces réservés de paramètres (par exemple, [AllowDenyKey]).

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

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

Vous pouvez également utiliser un fichier de configuration personnalisé (NONMSICONFNAME="C:\agent-custom.conf"). Pendant l'installation, tous les paramètres de configuration d'agent valides présents dans ce fichier (limités à ceux répertoriés dans le tableau ci-dessus) seront écrits dans le fichier de configuration de l'agent nouvellement créé. Pour conserver la configuration existante de l'agent, définissez les paramètres à préserver.

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

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

Plugins chargeables de Zabbix agent 2

Les plugins chargeables de Zabbix agent 2 peuvent être installés sous Windows à l’aide de packages d’installation MSI 64 bits, disponibles en téléchargement.

La configuration minimale requise du système d’exploitation pour une installation MSI est Windows 10 (64 bits) ou Windows Server 2016.

Avant d’installer un plugin, veuillez consulter son fichier README. Il peut contenir des exigences spécifiques ainsi que des instructions d’installation.

Comme pour Zabbix agent/agent2, les plugins chargeables peuvent être installés à l’aide de l’assistant d’installation ou de la ligne de commande.

Installation depuis l’assistant d’installation

1. Double-cliquez sur le fichier MSI téléchargé pour démarrer l’installation.

2. Acceptez le contrat de licence utilisateur final.

3. Sélectionnez les plugins chargeables de Zabbix agent 2 à installer.

Il est recommandé d’utiliser l’emplacement d’installation par défaut fourni par le programme d’installation. L’utilisation d’un emplacement personnalisé sans les autorisations nécessaires peut compromettre la sécurité de l’installation.

4. Cliquez sur Install pour lancer l’installation.

Tous les plugins chargeables sélectionnés de Zabbix agent 2 seront installés à l’emplacement spécifié (par défaut : C:\Program Files\Zabbix Agent 2), avec leurs fichiers de configuration installés dans le sous-dossier zabbix_agent2.d.

5. Cliquez sur le bouton Finish pour quitter l’assistant d’installation.

Installation depuis la ligne de commande

Les plugins chargeables de Zabbix agent 2 peuvent être installés depuis la ligne de commande en exécutant le programme d’installation MSI avec msiexec. Par exemple :

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

Les packages du programme d’installation MSI des plugins chargeables de Zabbix agent 2 prennent en charge les paramètres suivants.

Parameter Description
ADDDEFAULT Une liste de composants, séparés par des virgules, à installer avec leur configuration par défaut. Pour plus d’informations, voir ADDDEFAULT property.
Valeurs possibles : ALL, CephPlugin, EmberplusPlugin, MongodbPlugin, MssqlPlugin, NvidiagpuPlugin, PostgresqlPlugin
Exemple : ADDDEFAULT=MongodbPlugin,PostgresqlPlugin
ADDLOCAL Une liste de composants, séparés par des virgules, à installer localement. Pour plus d’informations, voir ADDLOCAL property.
Valeurs possibles : ALL, CephPlugin, EmberplusPlugin, MongodbPlugin, MssqlPlugin, NvidiagpuPlugin, PostgresqlPlugin
Exemple : ADDLOCAL=MongodbPlugin,MssqlPlugin
INSTALLFOLDER Le chemin complet vers un dossier dans lequel les composants Zabbix seront installés, avec leurs fichiers de configuration installés dans le sous-dossier zabbix_agent2.d.
Exemple : INSTALLFOLDER="C:\Program Files\Zabbix Agent 2"