Instalación del agent de Windows desde MSI

Descripción general

El agent de Zabbix se puede instalar en Windows utilizando paquetes de instalación MSI de 32 o 64 bits, disponibles para descarga.

Los requisitos mínimos del sistema operativo para la instalación de MSI son:

  • Para el agent de Zabbix: Windows XP (64 bits) o Windows Server 2003
  • Para el agent 2 de Zabbix: Windows 10 (32 bits) o Windows Server 2016

Los paquetes de 32 bits no se pueden instalar en sistemas de 64 bits.

Los paquetes incluyen:

  • Soporte TLS (la configuración de TLS es opcional)
  • Utilidades Zabbix get y Zabbix sender (pueden instalarse junto con el agent/agent 2 de Zabbix o por separado)

Los paquetes del agent 2 de Zabbix no incluyen plugins cargables (MongoDB, PostgreSQL, MSSQL), que deben descargarse e instalarse por separado.

La instalación puede realizarse utilizando el Asistente de configuración o la línea de comandos.

Aunque la instalación mediante paquetes MSI es totalmente compatible, se recomienda instalar al menos Microsoft .NET Framework 2 para un manejo adecuado de los errores.

Se recomienda utilizar la ubicación de instalación predeterminada proporcionada por el instalador. El uso de una ubicación personalizada sin los permisos necesarios puede comprometer la seguridad de la instalación.

Instalación mediante el asistente de configuración

Los siguientes pasos de instalación se aplican tanto a Zabbix agent como a Zabbix agent 2.

1. Haga doble clic en el archivo MSI descargado para iniciar la instalación:

2. Acepte el Acuerdo de licencia de usuario final:

3. Seleccione los componentes de Zabbix (demonio del agent, Zabbix sender, Zabbix get) que desea instalar:

Se recomienda utilizar la ubicación de instalación predeterminada proporcionada por el instalador. El uso de una ubicación personalizada sin los permisos necesarios puede poner en riesgo la seguridad de la instalación.

Si se utiliza una ubicación personalizada fuera del directorio Program Files y la carpeta de destino ya existe, el instalador no modificará sus permisos. Durante una instalación nueva, se le solicitará que establezca manualmente los permisos adecuados o que continúe sin modificarlos.

4. Configure los siguientes parámetros. Sus valores se establecerán en el archivo de configuración del agent de Zabbix:

Parámetro Descripción
Nombre del host El nombre del host de la máquina donde se está instalando Zabbix agent. Establece el parámetro Hostname.
IP/DNS del server de Zabbix Una lista de direcciones IP separadas por comas, opcionalmente en notación CIDR, o nombres DNS de servers o proxies de Zabbix. Este parámetro es obligatorio. Establece el parámetro Server.
Puerto de escucha del agent El agent escuchará en este puerto las conexiones del server. Establece el parámetro ListenPort.
Server o proxy para las comprobaciones activas La dirección del server/proxy de Zabbix o la configuración del clúster desde la que se obtendrán las comprobaciones activas. La dirección del server/proxy es una dirección IP o un nombre DNS y, opcionalmente, un puerto separado por dos puntos. Establece el parámetro ServerActive.
Habilitar PSK Marque la casilla para habilitar la compatibilidad con TLS mediante claves precompartidas. Establece los parámetros TLSConnect y TLSAccept en psk.
Añadir la ubicación del agent al PATH Marque la casilla para añadir la ubicación de Zabbix agent a la variable PATH del sistema.

Si se detecta un Zabbix agent existente, se mostrarán los valores de los parámetros de su archivo de configuración. Además, el archivo de configuración existente cambiará de nombre durante la instalación y se creará un nuevo archivo de configuración.

5. Configure los parámetros de PSK si marcó la casilla Habilitar PSK en el paso anterior. Estos parámetros también se establecerán en el archivo de configuración de Zabbix agent:

Parámetro Descripción
Identidad de la clave precompartida La cadena de identidad de la clave precompartida. Establece el parámetro TLSPSKIdentity.
Valor de la clave precompartida El valor de la cadena de la clave precompartida. Crea el archivo psk.key que contiene la clave y establece el parámetro TLSPSKFile en la ubicación de la clave (predeterminada: C:\Program Files\Zabbix Agent\psk.key). Se recomienda restringir el acceso al archivo de la clave precompartida ajustando su configuración de seguridad para que solo Zabbix agent (o el usuario que ejecuta el agent) pueda leerlo.

6. Haga clic en Instalar para comenzar la instalación.

Todos los componentes de Zabbix seleccionados y el archivo de configuración de Zabbix agent se instalarán en la ubicación especificada (predeterminada: C:\Program Files\Zabbix Agent). Lo mismo se aplica a Zabbix agent 2, excepto que los archivos de configuración adicionales de sus plugins integrados se instalarán en la subcarpeta zabbix_agent2.d\plugins.d.

Además, zabbix_agentd.exe (o zabbix_agent2.exe) se configurará como un servicio de Windows con inicio automático retrasado (o inicio automático en versiones de Windows anteriores a Windows Vista/Server 2008).

Si durante la instalación se está ejecutando una versión diferente de Zabbix agent, se le solicitará que elija entre cerrar la aplicación e intentar reiniciarla, o dejarla abierta, en cuyo caso será necesario reiniciar el sistema.

7. Haga clic en el botón Finalizar para salir del asistente de configuración.

Instalación desde la línea de comandos

Zabbix agent se puede instalar desde la línea de comandos ejecutando el instalador MSI con msiexec. Por ejemplo:

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

Este método permite instalaciones desatendidas y configuraciones personalizadas mediante parámetros.

Parámetros compatibles

Los paquetes instaladores MSI de Zabbix agent admiten los siguientes parámetros tanto para Zabbix agent como para Zabbix agent 2.

Los parámetros de Zabbix agent/agent2 se establecen en el archivo de configuración durante la instalación. Haga clic en el nombre de un parámetro para ver su descripción detallada y ejemplos de configuración en la página Zabbix agent (Windows). Para Zabbix agent 2, consulte la página Zabbix agent 2 (Windows).

Parameter Description
ADDDEFAULT Una lista de componentes separados por comas para instalar con su configuración predeterminada. Para obtener más información, consulte ADDDEFAULT property.
Valores posibles: AgentProgram, GetProgram, SenderProgram, ALL
Ejemplo: ADDDEFAULT=AgentProgram,GetProgram
ADDLOCAL Una lista de componentes separados por comas para instalar localmente. Para obtener más información, consulte ADDLOCAL property.
Valores posibles: AgentProgram, GetProgram, SenderProgram, ALL
Ejemplo: ADDLOCAL=AgentProgram,SenderProgram
ALLOWDENYKEY Una lista de parámetros AllowKey o DenyKey separados por punto y coma para restringir las comprobaciones de Zabbix agent. Si es necesario, use una barra invertida para escapar el delimitador (\;). Establece los parámetros AllowKey y DenyKey en el archivo de configuración del agent.
Ejemplo: ALLOWDENYKEY="AllowKey=system.run[more C:\Windows\System32\drivers\etc\hosts\\; echo 'File read complete'];DenyKey=system.run[*]"
CONF La ruta completa a un archivo de configuración de template para Zabbix agent. Durante la instalación, este archivo se convertirá en el archivo de configuración del agent. El archivo debe contener al menos los parámetros Server y LogFile.
Ejemplo: CONF="C:\full\path\to\example.conf"
DONOTSTART Use DONOTSTART=1 para impedir que el instalador MSI inicie el servicio de Zabbix agent.
ENABLEPATH Use ENABLEPATH=1 para agregar la ubicación de Zabbix agent a la variable PATH del sistema.
ENABLEPERSISTENTBUFFER Solo Zabbix agent 2. Habilita el uso de almacenamiento persistente local para los items activos.
HOSTINTERFACE Parámetro opcional que define la interfaz del host.
HOSTMETADATA Parámetro opcional que define los metadatos del host.
HOSTMETADATAITEM Parámetro opcional que define un item usado para obtener los metadatos del host.
HOSTNAME Parámetro opcional que define el nombre del host.
HOSTNAMEITEM Parámetro opcional que define un item usado para obtener el nombre del host.
INCLUDE Una lista de archivos individuales o de todos los archivos de un directorio, separados por punto y coma, para incluir en el archivo de configuración de Zabbix agent.
IGNOREALREADYEXISTSFOLDER Para instalaciones nuevas, use IGNOREALREADYEXISTSFOLDER=1 para permitir la instalación en una carpeta de destino existente fuera del directorio Program Files. Si no se especifica este parámetro, la instalación falla cuando ya existe una carpeta de destino de este tipo.
INSTALLFOLDER La ruta completa a una carpeta donde se instalarán los componentes de Zabbix y el archivo de configuración de Zabbix agent. Para Zabbix agent 2, los archivos de configuración adicionales para los plugins integrados se instalarán en la subcarpeta zabbix_agent2.d\plugins.d.
Ejemplo: INSTALLFOLDER="C:\Program Files\Zabbix Agent"
LISTENIP Una lista de direcciones IP separadas por comas en las que el agent debe escuchar.
LISTENPORT El agent escuchará en este puerto las conexiones desde el server.
LOGFILE El nombre del archivo de registro de Zabbix agent.
LOGTYPE El tipo de salida del registro.
NONMSICONFNAME La ruta completa a un archivo de configuración personalizado para Zabbix agent. Durante la instalación, cualquier parámetro válido de configuración del agent presente en este archivo (limitado a los enumerados en esta tabla) se escribirá en el nuevo archivo de configuración del agent creado. El archivo debe contener al menos el parámetro Server.
Ejemplo: NONMSICONFNAME="C:\full\path\to\example.conf"
PERSISTENTBUFFERFILE Solo Zabbix agent 2. El archivo donde Zabbix agent 2 debe conservar la base de datos SQLite.
PERSISTENTBUFFERPERIOD Solo Zabbix agent 2. El período de tiempo durante el cual deben almacenarse los datos cuando no hay conexión con el server o proxy.
SERVER Una lista de direcciones IP separadas por comas, opcionalmente en notación CIDR, o nombres DNS de Zabbix servers o Zabbix proxies. Este parámetro es obligatorio, excepto cuando STARTAGENTS está establecido en 0.
SERVERACTIVE La dirección del Zabbix server/proxy o la configuración de clúster desde la que obtener comprobaciones activas.
SKIP Use SKIP=fw para impedir que el instalador MSI agregue una regla de excepción en el Firewall de Windows para Zabbix agent.
SOURCEIP La dirección IP de origen para las conexiones salientes a Zabbix server o Zabbix proxy, o para realizar conexiones al ejecutar algunos items (web.page.get, net.tcp.port, etc.).
STARTAGENTS El número de instancias pre-fork de zabbix_agentd que procesan comprobaciones pasivas.
Si se establece en 0, las comprobaciones pasivas se deshabilitan y el agent no escuchará en ningún puerto TCP.
STARTUPTYPE Tipo de inicio del servicio de Zabbix agent. Valores posibles:
automatic - inicia el servicio automáticamente al arrancar Windows;
delayed - (predeterminado) retrasa el inicio del servicio hasta que los servicios iniciados automáticamente hayan completado su arranque (disponible en Windows Vista/Server 2008 y versiones posteriores);
manual - inicia el servicio manualmente (por un usuario o una aplicación);
disabled - deshabilita el servicio para que no pueda ser iniciado por un usuario o una aplicación.
Ejemplo: STARTUPTYPE=disabled
STATUSPORT Solo Zabbix agent 2. Si se establece, el agent escuchará en este puerto las solicitudes HTTP de estado (http://localhost:<port>/status).
TIMEOUT Especifica cuánto tiempo esperar (en segundos) para establecer la conexión e intercambiar datos con Zabbix proxy o server.
TLSACCEPT Las conexiones entrantes que se aceptarán (se usa para comprobaciones pasivas). Si se establece en psk, entonces TLSCONNECT también se establecerá en psk (a menos que se especifique lo contrario).
TLSCAFILE La ruta completa de un archivo que contiene los certificados de la CA de nivel superior para la verificación del certificado del par.
TLSCERTFILE La ruta completa de un archivo que contiene el certificado del agent o la cadena de certificados.
TLSCONNECT Cómo debe conectarse el agent a Zabbix server o proxy (se usa para comprobaciones activas). Si se establece en psk, entonces TLSACCEPT también se establecerá en psk (a menos que se especifique lo contrario).
TLSCRLFILE La ruta completa de un archivo que contiene certificados revocados.
TLSKEYFILE La ruta completa de un archivo que contiene la clave privada de Zabbix agent.
TLSPSKFILE La ruta completa de un archivo que contiene la clave precompartida de Zabbix agent. Si se establecen tanto TLSPSKFILE como TLSPSKVALUE, el valor de TLSPSKVALUE se escribirá en el archivo especificado en TLSPSKFILE. Se recomienda restringir el acceso al archivo de clave precompartida ajustando la configuración de seguridad del archivo para que solo Zabbix agent (o el usuario que ejecuta el agent) pueda leerlo.
TLSPSKIDENTITY La cadena de identidad de la clave precompartida.
TLSPSKVALUE El valor de la cadena de la clave precompartida. Si se establecen tanto TLSPSKFILE como TLSPSKVALUE, el valor de TLSPSKVALUE se escribirá en el archivo especificado en TLSPSKFILE.
Ejemplo: TLSPSKVALUE=1f87b595725ac58dd977beef14b97461a7c1045b9a1c963065002c5473194952
TLSSERVERCERTISSUER El emisor del certificado del server (proxy) permitido.
TLSSERVERCERTSUBJECT El sujeto del certificado del server (proxy) permitido.
UNSAFEUSERPARAMETERS Permite que todos los caracteres se pasen en los argumentos de los parámetros definidos por el usuario.
Ejemplos

El siguiente ejemplo instala Zabbix agent con una configuración personalizada. También habilita la compatibilidad con TLS mediante claves precompartidas.

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

El siguiente ejemplo instala una versión más reciente de Zabbix agent y usa un archivo de configuración de template (CONF="C:\agent-template.conf"). Durante la instalación, este archivo se convertirá en el archivo de configuración del agent. Para heredar parámetros del archivo de configuración anterior, use marcadores de posición de parámetros (por ejemplo, [AllowDenyKey]).

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

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

Como alternativa, puede usar un archivo de configuración personalizado (NONMSICONFNAME="C:\agent-custom.conf"). Durante la instalación, cualquier parámetro de configuración válido de agent presente en este archivo (limitado a los enumerados en la tabla anterior) se escribirá en el nuevo archivo de configuración del agent creado. Para conservar la configuración existente del agent, defina los parámetros que deben preservarse.

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

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

Plugins cargables del agent 2 de Zabbix

Los plugins cargables del agent 2 de Zabbix pueden instalarse en Windows utilizando paquetes instaladores MSI de 64 bits, disponibles para descarga.

Los requisitos mínimos del sistema operativo para la instalación MSI son Windows 10 (64 bits) o Windows Server 2016.

Antes de instalar un plugin, por favor revise su archivo README. Puede contener requisitos específicos e instrucciones de instalación.

De manera similar al agent/agent2 de Zabbix, los plugins cargables pueden instalarse utilizando el Asistente de Configuración o la línea de comandos.

Instalación desde el Asistente de Configuración

1. Haga doble clic en el archivo MSI descargado para iniciar la instalación.

2. Acepte el Acuerdo de Licencia de Usuario Final.

3. Seleccione los plugins cargables de Zabbix agent 2 que se instalarán.

Se recomienda utilizar la ubicación de instalación predeterminada proporcionada por el instalador. El uso de una ubicación personalizada sin los permisos necesarios puede comprometer la seguridad de la instalación.

4. Haga clic en Instalar para comenzar la instalación.

Todos los plugins cargables de Zabbix agent 2 seleccionados se instalarán en la ubicación especificada (por defecto: C:\Program Files\Zabbix Agent 2), con sus archivos de configuración instalados en la subcarpeta zabbix_agent2.d.

5. Haga clic en el botón Finalizar para salir del Asistente de Configuración.

Instalación desde la línea de comandos

Los plugins cargables de Zabbix agent 2 se pueden instalar desde la línea de comandos ejecutando el instalador MSI con msiexec. Por ejemplo:

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

Los paquetes del instalador MSI de plugins cargables de Zabbix agent 2 admiten los siguientes parámetros.

Parameter Description
ADDDEFAULT Una lista de componentes separados por comas para instalar con su configuración predeterminada. Para más información, consulte ADDDEFAULT property.
Valores posibles: ALL, CephPlugin, EmberplusPlugin, MongodbPlugin, MssqlPlugin, NvidiagpuPlugin, PostgresqlPlugin
Ejemplo: ADDDEFAULT=MongodbPlugin,PostgresqlPlugin
ADDLOCAL Una lista de componentes separados por comas para instalar localmente. Para más información, consulte ADDLOCAL property.
Valores posibles: ALL, CephPlugin, EmberplusPlugin, MongodbPlugin, MssqlPlugin, NvidiagpuPlugin, PostgresqlPlugin
Ejemplo: ADDLOCAL=MongodbPlugin,MssqlPlugin
INSTALLFOLDER La ruta completa a una carpeta donde se instalarán los componentes de Zabbix, con sus archivos de configuración instalados en la subcarpeta zabbix_agent2.d.
Ejemplo: INSTALLFOLDER="C:\Program Files\Zabbix Agent 2"