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 (daemon 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 comprometer 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 proxys 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. |
| Activar PSK | Marque la casilla para activar 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 archivo de configuración nuevo.

5. Configure los parámetros de PSK si marcó la casilla Activar 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 para 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 este último 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
El agent de Zabbix 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.2.0-windows-amd64-openssl.msi" /qn+ SERVER=192.0.2.1
Este método permite realizar instalaciones desatendidas y configuraciones personalizadas mediante parámetros.
Parámetros compatibles
Los paquetes del instalador 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 consultar 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).
| Parámetro | Descripción |
|---|---|
| ADDDEFAULT | Una lista de componentes, separados por comas, que se instalarán con su configuración predeterminada. Para obtener más información, consulte la propiedad ADDDEFAULT. Valores posibles: AgentProgram, GetProgram, SenderProgram, ALLEjemplo: ADDDEFAULT=AgentProgram,GetProgram |
| ADDLOCAL | Una lista de componentes, separados por comas, que se instalarán localmente. Para obtener más información, consulte la propiedad ADDLOCAL. Valores posibles: AgentProgram, GetProgram, SenderProgram, ALLEjemplo: 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, utilice una barra inversa 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 | Utilice DONOTSTART=1 para impedir que el instalador MSI inicie el servicio de Zabbix agent. |
| ENABLEPATH | Utilice ENABLEPATH=1 para añadir la ubicación de Zabbix agent a la variable PATH del sistema. |
| ENABLEPERSISTENTBUFFER | Solo para 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 utilizado para obtener los metadatos del host. |
| HOSTNAME | Parámetro opcional que define el nombre del host. |
| HOSTNAMEITEM | Parámetro opcional que define un item utilizado para obtener el nombre del host. |
| INCLUDE | Una lista de archivos individuales, separados por punto y coma, o de todos los archivos de un directorio que se incluirán en el archivo de configuración de Zabbix agent. |
| IGNOREALREADYEXISTSFOLDER | Para instalaciones nuevas, utilice 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 dicha carpeta de destino ya existe. |
| 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 de 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 del 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, todos los parámetros de configuración válidos del agent presentes en este archivo (limitados a los enumerados en esta tabla) se escribirán en el archivo de configuración del agent recién creado. El archivo debe contener al menos el parámetro Server. Ejemplo: NONMSICONFNAME="C:\full\path\to\example.conf" |
| PERSISTENTBUFFERFILE | Solo para Zabbix agent 2. El archivo donde Zabbix agent 2 debe almacenar la base de datos SQLite. |
| PERSISTENTBUFFERPERIOD | Solo para Zabbix agent 2. El período durante el cual deben almacenarse los datos cuando no hay conexión con el server o el proxy. |
| SERVER | Una lista de direcciones IP, separadas por comas y opcionalmente en notación CIDR, o nombres DNS de servers o proxies de Zabbix. Este parámetro es obligatorio, excepto cuando STARTAGENTS está establecido en 0. |
| SERVERACTIVE | La dirección del server/proxy de Zabbix o la configuración del clúster desde la que se obtienen los checks activos. |
| SKIP | Utilice SKIP=fw para impedir que el instalador MSI añada una regla de excepción del Firewall de Windows para Zabbix agent. |
| SOURCEIP | La dirección IP de origen para las conexiones salientes al server o proxy de Zabbix, o para establecer conexiones al ejecutar determinados items (web.page.get, net.tcp.port, etc.). |
| STARTAGENTS | El número de instancias precreadas de zabbix_agentd que procesan checks pasivos. Si se establece en 0, los checks pasivos 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 iniciar Windows; delayed: (predeterminado) retrasa el inicio del servicio hasta que hayan terminado de iniciarse los servicios iniciados automáticamente (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 para Zabbix agent 2. Si se establece, el agent escuchará en este puerto las solicitudes de estado HTTP (http://localhost:<port>/status). |
| TIMEOUT | Especifica cuánto tiempo esperar (en segundos) para establecer la conexión e intercambiar datos con el proxy o server de Zabbix. |
| TLSACCEPT | Las conexiones entrantes que se aceptarán (se utiliza para checks pasivos). Si se establece en psk, 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 al server o proxy de Zabbix (se utiliza para checks activos). Si se establece en psk, 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 TLSPSKFILE y TLSPSKVALUE, el valor de TLSPSKVALUE se escribirá en el archivo especificado en TLSPSKFILE. 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. |
| TLSPSKIDENTITY | La cadena de identidad de la clave precompartida. |
| TLSPSKVALUE | El valor de la cadena de la clave precompartida. Si se establecen TLSPSKFILE y TLSPSKVALUE, el valor de TLSPSKVALUE se escribirá en el archivo especificado en TLSPSKFILE. Ejemplo: TLSPSKVALUE=1f87b595725ac58dd977beef14b97461a7c1045b9a1c963065002c5473194952 |
| TLSSERVERCERTISSUER | El emisor de certificado permitido del server (proxy). |
| TLSSERVERCERTSUBJECT | El asunto de certificado permitido del server (proxy). |
| UNSAFEUSERPARAMETERS | Permite pasar todos los caracteres 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.2.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 utiliza 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 antiguo, utilice marcadores de posición de parámetros (por ejemplo, [AllowDenyKey]).
msiexec.exe /l*v "C:\package.log" /i "C:\zabbix_agent-8.2.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 utilizar un archivo de configuración personalizado (NONMSICONFNAME="C:\agent-custom.conf").
Durante la instalación, todos los parámetros de configuración válidos del agent presentes en este archivo (limitados a los indicados en la tabla anterior) se escribirán en el archivo de configuración del agent recién creado.
Para conservar la configuración existente del agent, defina los parámetros que desea conservar.
msiexec.exe /l*v "C:\package.log" /i "C:\zabbix_agent-8.2.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 de Zabbix agent 2
Los plugins cargables de Zabbix agent 2 se pueden instalar en Windows mediante paquetes de instalación MSI de 64 bits, disponibles para descargar.
Los requisitos mínimos del sistema operativo para la instalación mediante MSI son Windows 10 (64 bits) o Windows Server 2016.
Antes de instalar un plugin, consulte su archivo README. Puede contener requisitos específicos e instrucciones de instalación.
Al igual que Zabbix agent/agent2, los plugins cargables se pueden instalar mediante el asistente de instalació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 complementos cargables de Zabbix agent 2 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.
4. Haga clic en Instalar para iniciar la instalación.
Todos los complementos cargables de Zabbix agent 2 seleccionados se instalarán en la ubicación especificada (de forma predeterminada: C:\Program Files\Zabbix Agent 2), y sus archivos de configuración se instalarán 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.2.0-windows-amd64.msi" /qn+
Los paquetes del instalador MSI de plugins cargables de Zabbix agent 2 admiten los siguientes parámetros.
| Parámetro | Descripción |
|---|---|
| ADDDEFAULT | Una lista de componentes separados por comas que se instalarán con su configuración predeterminada. Para obtener más información, consulte ADDDEFAULT property. Valores posibles: ALL, CephPlugin, EmberplusPlugin, MongodbPlugin, MssqlPlugin, NvidiagpuPlugin, PostgresqlPluginEjemplo: ADDDEFAULT=MongodbPlugin,PostgresqlPlugin |
| ADDLOCAL | Una lista de componentes separados por comas que se instalarán localmente. Para obtener más información, consulte ADDLOCAL property. Valores posibles: ALL, CephPlugin, EmberplusPlugin, MongodbPlugin, MssqlPlugin, NvidiagpuPlugin, PostgresqlPluginEjemplo: ADDLOCAL=MongodbPlugin,MssqlPlugin |
| INSTALLFOLDER | La ruta completa de la 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" |