1 Installation de l'agent Windows à partir du 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 depuis 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 lancer 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 l'installateur. 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 :

Parameter Description
Host name Le nom d'hôte de la machine sur laquelle Zabbix agent est en cours d'installation. 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 des 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 de 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 la case pour activer la prise en charge 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 la case pour ajouter l'emplacement de Zabbix agent à la variable PATH du système.

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 :

Parameter 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 la 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 et le fichier de configuration de Zabbix agent seront installés à l'emplacement spécifié (par défaut : C:\Program Files\Zabbix Agent). Il en va de même pour Zabbix agent 2, à l'exception des fichiers de configuration supplémentaires pour ses plugins intégrés, qui seront installés dans le sous-dossier zabbix_agent2.d\plugins.d.

De plus, zabbix_agentd.exe (ou zabbix_agent2.exe) sera configuré comme 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-7.4.0-windows-amd64-openssl.msi" /qn+ SERVER=192.0.2.1

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

Paramètres pris en charge

Les packages d'installation MSI de Zabbix agent 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, consultez 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, consultez la 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, consultez la 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 vérifications de Zabbix agent. 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 de modèle pour Zabbix agent. Pendant l'installation, ce fichier deviendra le fichier de configuration de l'agent. Le fichier doit contenir au moins 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.
Pris en charge dans les packages d'installation MSI depuis Zabbix 7.4.6.
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.
Pris en charge dans les packages d'installation MSI depuis Zabbix 7.4.6.
INCLUDE Une liste de fichiers individuels ou de tous les fichiers d'un répertoire, séparés par des points-virgules, à 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 valides de l'agent présents dans ce fichier (limités à ceux répertoriés dans ce tableau) seront écrits dans le nouveau fichier de configuration de l'agent créé. Le fichier doit contenir au moins 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 stocké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 proxies Zabbix. Ce paramètre est obligatoire, sauf lorsque STARTAGENTS est défini sur 0.
SERVERACTIVE L'adresse du serveur Zabbix/proxy ou la configuration de cluster à partir de laquelle obtenir les vérifications actives.
SKIP Utilisez SKIP=fw pour empêcher le programme d'installation MSI d'ajouter une règle d'exception au 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.).
Pris en charge dans les packages d'installation MSI depuis Zabbix 7.4.6.
STARTAGENTS Le nombre d'instances pré-forkées de zabbix_agentd qui traitent les vérifications passives.
Si la valeur est 0, les vérifications passives sont désactivées et l'agent n'écoutera sur aucun port TCP.
Pris en charge dans les packages d'installation MSI depuis Zabbix 7.4.6.
STARTUPTYPE Type de démarrage du service Zabbix agent. Valeurs possibles:
automatic - démarre le service automatiquement au démarrage de Windows;
delayed - (par défaut) retarde le démarrage du service après la fin du démarrage des services lancés automatiquement (disponible sur Windows Vista/Server 2008 et versions ultérieures);
manual - démarre le service manuellement (par un utilisateur ou une application);
disabled - désactive 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 la connexion et échanger des données avec le proxy ou le serveur Zabbix.
TLSACCEPT Les connexions entrantes à accepter (utilisé pour les vérifications passives). Si défini sur psk, alors TLSCONNECT sera également défini sur psk (sauf indication contraire).
TLSCAFILE Le chemin complet vers un fichier contenant les certificats des autorités de certification de niveau supérieur pour la vérification du certificat du pair.
TLSCERTFILE Le chemin complet vers un fichier contenant le certificat de l'agent ou la chaîne de certificats.
TLSCONNECT La manière dont l'agent doit se connecter au serveur Zabbix ou au proxy (utilisé pour les vérifications actives). Si défini sur psk, alors TLSACCEPT sera également défini sur psk (sauf indication contraire).
TLSCRLFILE Le chemin complet vers un fichier contenant les certificats révoqués.
TLSKEYFILE Le chemin complet vers un fichier contenant la clé privée de Zabbix agent.
TLSPSKFILE Le chemin complet vers 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é par 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 la 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é par TLSPSKFILE.
Exemple: TLSPSKVALUE=1f87b595725ac58dd977beef14b97461a7c1045b9a1c963065002c5473194952
TLSSERVERCERTISSUER L'émetteur du certificat du serveur (proxy) autorisé.
TLSSERVERCERTSUBJECT Le sujet du certificat du serveur (proxy) autorisé.
UNSAFEUSERPARAMETERS Autorise le passage de tous les caractères dans les arguments des paramètres définis par l'utilisateur.
Pris en charge dans les packages d'installation MSI depuis Zabbix 7.4.6.
Exemples

L'exemple suivant installe agent Zabbix avec une configuration personnalisée. Il active également la prise en charge 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-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[*]"

L'exemple suivant installe une version plus récente de agent Zabbix et utilise un fichier de configuration de modèle (CONF="C:\agent-template.conf"). Pendant l'installation, ce fichier deviendra le fichier de configuration de 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-7.4.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]

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

msiexec.exe /l*v "C:\package.log" /i "C:\zabbix_agent-7.4.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 sur Windows à l'aide des packages d'installation MSI 64 bits, disponibles en téléchargement.

Les exigences minimales du système d'exploitation pour l'installation MSI sont Windows 10 (64 bits) ou Windows Server 2016.

De la même manière que pour Zabbix agent/agent2, les plugins chargeables peuvent être installés à l'aide de l'assistant d'installation ou de la ligne de commande.

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

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-7.4.0-windows-amd64.msi" /qn+

Les packages 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 dans leur configuration par défaut. Pour plus d'informations, voir propriété ADDDEFAULT.
Valeurs possibles : ALL, 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 propriété ADDLOCAL.
Valeurs possibles : ALL, 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"