Documentation
Table of Contents
4 Instalación del agente Windows desde MSI
Descripción general
El agente Zabbix para Windows se puede instalar desde el instalador de paquetes MSI de Windows (32 bits o 64 bits) disponible para su descarga.
No se puede instalar un paquete de 32 bits en un Windows de 64 bits.
El requisito mínimo para la instalación de MSI es:
- Windows XP 64-bit y Server 2003 para el agente Zabbix;
- Windows 10 32-bit y Server 2016 para el agente Zabbix 2.
Las utilidades get y sender de Zabbix también se pueden instalar, ya sea junto con el agente/agente 2 de Zabbix o por separado.
Todos los paquetes vienen con soporte TLS; sin embargo, configurar TLS es opcional.
Se admite la instalación basada en la interfaz de usuario y en línea de comandos.
Aunque la instalación de Zabbix desde paquetes de instalación MSI es totalmente compatible, se recomienda instalar al menos Microsoft .NET Framework 2 para una gestión adecuada de los errores. Consulte Descarga de Microsoft .NET Framework.
Se recomienda utilizar rutas predeterminadas proporcionadas por el instalador, ya que el uso de rutas personalizadas sin los permisos adecuados podría comprometer la seguridad de la instalación.
Pasos de instalación
Para instalar, haga doble clic en el archivo MSI descargado.
Acepte la licencia para continuar con el siguiente paso.
Especifique los siguientes parámetros.
| Parámetro | Descripción |
|---|---|
| Nombre de equipo | Especifique el nombre de equipo. |
| IP/DNS del servidor Zabbix | Especifique IP/DNS del servidor Zabbix. |
| Puerto de escucha del agente | Especifique el puerto de escucha del agente (10050 de forma predeterminada). |
| Servidor o Proxy para comprobaciones activas | Especifique IP/DNS del servidor/proxy de Zabbix para comprobaciones de agentes activos. |
| Habilitar PSK | Marque la casilla de verificación para habilitar la compatibilidad con TLS mediante claves precompartidas. |
| Agregar ubicación del agente a la RUTA | Agregar ubicación del agente a la variable PATH. |
Introduzca la identidad y el valor de la clave previamente compartida. Este paso sólo está disponible si marcó Habilitar PSK en el paso anterior.
Seleccione los componentes de Zabbix a instalar - demonio de agente Zabbix, remitente Zabbix, Zabbix get.
Los componentes de Zabbix junto con el archivo de configuración se instalarán en una carpeta Zabbix Agent en Archivos de programa. zabbix_agentd.exe se configurará como servicio de Windows con inicio automático retrasado (o inicio automático en versiones de Windows anteriores a Windows Server 2008/Vista).
Instalación basada en línea de comandos
Parámetros admitidos
Los MSI creados admiten los siguientes parámetros.
| Parámetro | Descripción |
|---|---|
| ADDDEFAULT | Una lista delimitada por comas de programas para instalar en su configuración predeterminada. Valores posibles: AgentProgram, GetProgram, SenderProgram, ALL.Ejemplo: ADDDEFAULT=AgentProgram,GetProgram |
| ADDLOCAL | Una lista delimitada por comas de programas para instalar localmente. Valores posibles: AgentProgram, GetProgram, SenderProgram, ALL.Ejemplo: ADDLOCAL=AgentProgram,SenderProgram |
| ALLOWDENYKEY | Secuencia de "AllowKey" y "DenyKey" parámetros separados por ;Use \\; para escapar el delimitador.Ejemplo: ALLOWDENYKEY="AllowKey=system.run[type c:\windows\system32\drivers\etc\hosts];DenyKey=system.run[*]" |
| CONF | La ruta completa a un archivo de configuración personalizado. Ejemplo: CONF=c:\full\path\to\user.conf |
| ENABLEPATH | Agrega la ubicación del agente a la variable PATH. |
| ENABLEPERSISTENTBUFFER | Solo agente Zabbix 2. Habilita el uso de almacenamiento persistente local para elementos activos. |
| HOSTINTERFACE | Un parámetro opcional que define la interfaz del host. |
| HOSTMETADATA | Un parámetro opcional que define los metadatos del host. |
| HOSTMETADATAITEM | Un parámetro opcional que define un elemento del agente Zabbix utilizado para obtener los metadatos del host. |
| HOSTNAME | Un parámetro opcional que define el nombre del equipo. |
| INCLUDE | Secuencia de includes separados por ; |
| INSTALLFOLDER | La ruta completa de la carpeta en la que se instalarán los componentes de Zabbix junto con el archivo de configuración. |
| LISTENIP | Una lista de direcciones IP delimitadas por comas en las que el agente debe escuchar. |
| LISTENPORT | El agente escuchará en este puerto las conexiones del servidor. |
| LOGFILE | El nombre del archivo de registro. |
| LOGTYPE | El tipo de salida del registro. |
| PERSISTENTBUFFERFILE | Solo para el agente 2 de Zabbix. El archivo donde el agente 2 de Zabbix debe guardar la base de datos SQLite. |
| PERSISTENTBUFFERPERIOD | Solo para el agente 2 de Zabbix. El período de tiempo durante el cual se deben almacenar los datos cuando no hay conexión con el servidor o proxy. |
| SERVER | Una lista de direcciones IP delimitadas por comas, opcionalmente en notación CIDR, o nombres DNS de servidores Zabbix y proxies Zabbix. |
| SERVERACTIVE | Dirección del servidor o proxy de Zabbix o configuración del clúster desde donde obtener las comprobaciones activas. |
| SKIP | SKIP=fw - no instalar la regla de excepción del firewall. |
| STARTUPTYPE | Tipo de inicio del servicio de agente de Windows/agente 2 de Zabbix. Valores posibles:automatic - iniciar el servicio automáticamente al iniciar Windows;delayed - (predeterminado) retrasar el inicio del servicio después de que los servicios iniciados automáticamente hayan completado el inicio (disponible en Windows Server 2008/Vista y versiones posteriores);manual - iniciar el servicio manualmente (por un usuario o aplicación);disabled - deshabilitar el servicio, de modo que no pueda ser iniciado por un usuario o aplicación.Ejemplo: STARTUPTYPE=disabled |
| STATUSPORT | Solo agente Zabbix 2. Si se configura, el agente escuchará en este puerto las solicitudes de estado HTTP (http://localhost:<port>/status). |
| TIMEOUT | Especifica el tiempo de espera para las comunicaciones (en segundos). |
| TLSACCEPT | Qué conexiones entrantes se aceptarán. |
| TLSCAFILE | La ruta completa de un archivo que contiene los certificados de CA de nivel superior para la verificación de certificados de pares, que se utiliza para las comunicaciones cifradas entre los componentes de Zabbix. |
| TLSCERTFILE | La ruta completa de un archivo que contiene el certificado del agente o la cadena de certificados, que se utiliza para comunicaciones cifradas entre componentes de Zabbix. |
| TLSCONNECT | Cómo debe conectarse el agente al servidor o proxy de Zabbix. |
| TLSCRLFILE | La ruta completa de un archivo que contiene certificados revocados. Este parámetro se utiliza para comunicaciones cifradas entre componentes de Zabbix. |
| TLSKEYFILE | La ruta completa de un archivo que contiene la clave privada del agente, que se utiliza para comunicaciones cifradas entre componentes de Zabbix. |
| TLSPSKFILE | La ruta completa de un archivo que contiene la clave precompartida del agente](/manual/encryption/using_pre_shared_keys), utilizada para comunicaciones cifradas con el servidor Zabbix. |
| TLSPSKIDENTITY | La cadena de identidad de la clave precompartida](/manual/encryption/using_pre_shared_keys), utilizada para comunicaciones cifradas con el servidor Zabbix. |
| TLSPSKVALUE | El valor de la cadena de la clave precompartida](/manual/encryption/using_pre_shared_keys), utilizada para comunicaciones cifradas con el servidor Zabbix. |
| TLSSERVERCERTISSUER | El emisor de certificado de servidor (proxy) permitido. |
| TLSSERVERCERTSUBJECT | El sujeto del certificado de servidor (proxy) permitido. |
Ejemplos
Para instalar el agente Zabbix Windows desde la línea de comandos, puede ejecutar, por ejemplo:
SET INSTALLFOLDER=C:\Program Files\Zabbix Agent
msiexec /l*v log.txt /i zabbix_agent-7.0.0-x86.msi /qn^
LOGTYPE=file^
LOGFILE="%INSTALLFOLDER%\zabbix_agentd.log"^
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^
ALLOWDENYKEY="DenyKey=vfs.file.contents[/etc/passwd]"También puede ejecutar, por ejemplo:
msiexec /l*v log.txt /i zabbix_agent-7.0.0-x86.msi /qn^
SERVER=192.168.6.76^
TLSCONNECT=psk^
TLSACCEPT=psk^
TLSPSKIDENTITY=MyPSKID^
TLSPSKVALUE=1f87b595725ac58dd977beef14b97461a7c1045b9a1c963065002c5473194952Si se pasan TLSPSKFILE y TLSPSKVALUE, TLSPSKVALUE se escribirá en TLSPSKFILE.