Documentation
Table of Contents
1 Instalación del agente de Windows desde MSI
Descripción general
El agente 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 con MSI son:
- Para el agente Zabbix: Windows XP (64 bits) o Windows Server 2003
- Para el agente Zabbix 2: 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 agente Zabbix/agente 2 o por separado)
Los paquetes del agente Zabbix 2 no incluyen plugins cargables (MongoDB, PostgreSQL, MSSQL), que deben descargarse e instalarse por separado.
La instalación puede realizarse utilizando el Asistente de instalació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 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 desde el Asistente de Configuración
Los siguientes pasos de instalación se aplican tanto al agente Zabbix como al agente Zabbix 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 agente, Zabbix sender, Zabbix get) 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. Configure los siguientes parámetros. Sus valores se establecerán en el archivo de configuración del agente Zabbix:
| Parámetro | Descripción |
|---|---|
| Nombre del host | El nombre del equipo donde se está instalando el agente Zabbix. Establece el parámetro Hostname. |
| IP/DNS del servidor Zabbix | Una lista de direcciones IP separadas por comas, opcionalmente en notación CIDR, o nombres DNS de servidores Zabbix o proxies Zabbix. Este parámetro es obligatorio. Establece el parámetro Server. |
| Puerto de escucha del agente | El agente escuchará en este puerto las conexiones desde el servidor. Establece el parámetro ListenPort. |
| Servidor o Proxy para comprobaciones activas | La dirección del servidor/proxy Zabbix o la configuración del clúster desde la que obtener comprobaciones activas. La dirección del servidor/proxy es una dirección IP o un nombre DNS y un puerto opcional separado por dos puntos. Establece el parámetro ServerActive. |
| Habilitar PSK | Marque la casilla para habilitar el soporte TLS usando claves precompartidas. Establece los parámetros TLSConnect y TLSAccept en psk. |
| Agregar la ubicación del agente al PATH | Marque la casilla para agregar la ubicación del agente Zabbix a la variable PATH del sistema. |
Si se detecta un agente Zabbix existente, se mostrarán los valores de los parámetros de su archivo de configuración. Además, el archivo de configuración existente se renombrará durante la instalación y se creará un nuevo archivo de configuración.
5. Configure los parámetros 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 del agente Zabbix:
| 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 (por defecto: C:\Program Files\Zabbix Agent\psk.key). Se recomienda restringir el acceso al archivo de clave precompartida ajustando la configuración de seguridad del archivo para que solo el agente Zabbix (o el usuario que ejecuta el agente) pueda leerlo. |
6. Haga clic en Instalar para comenzar la instalación.
Todos los componentes de Zabbix seleccionados y el archivo de configuración del agente Zabbix se instalarán en la ubicación especificada (por defecto: C:\Program Files\Zabbix Agent). Lo mismo se aplica al agente Zabbix 2, excepto que los archivos de configuración adicionales para sus complementos 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 se está ejecutando una versión diferente del agente Zabbix durante la instalación, se le pedirá que elija entre cerrar la aplicación e intentar reiniciarla o dejarla abierta, en cuyo caso será necesario reiniciar.
7. Haga clic en el botón Finalizar para salir del Asistente de Configuración.
Instalación desde la línea de comandos
El agente Zabbix puede instalarse 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-7.0.0-windows-amd64-openssl.msi" /qn+ SERVER=192.0.2.0Este método permite instalaciones desatendidas y configuraciones personalizadas mediante parámetros.
Parámetros soportados
Los paquetes de instalación MSI del agent de Zabbix admiten los siguientes parámetros tanto para el agent de Zabbix como para el agent 2 de Zabbix.
Los parámetros de agent/agent2 de Zabbix 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 el agent 2 de Zabbix, consulte la página Zabbix agent 2 (Windows).
| Parámetro | Descripción |
|---|---|
| ADDDEFAULT | Una lista de componentes separados por comas para instalar en 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 para instalar 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 del agent de Zabbix. Si es necesario, utilice 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[type C:\Windows\System32\drivers\etc\hosts];DenyKey=system.run[*]" |
| CONF | La ruta completa a un archivo de configuración de template para el agent de Zabbix. 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 evitar que el instalador MSI inicie el servicio del agent de Zabbix.Soportado en los paquetes de instalación MSI desde Zabbix 7.0.22. |
| ENABLEPATH | Utilice ENABLEPATH=1 para agregar la ubicación del agent de Zabbix a la variable PATH del sistema. |
| ENABLEPERSISTENTBUFFER | Solo para el agent 2 de Zabbix. Habilita el uso de almacenamiento persistente local para items 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 item utilizado para obtener los metadatos del host. |
| HOSTNAME | Un parámetro opcional que define el nombre del host. |
| HOSTNAMEITEM | Un parámetro opcional que define un item utilizado para obtener el nombre del host. Soportado en los paquetes de instalación MSI desde Zabbix 7.0.22. |
| INCLUDE | Una lista de archivos individuales separados por punto y coma o todos los archivos de un directorio para incluir en el archivo de configuración del agent de Zabbix. |
| INSTALLFOLDER | La ruta completa a una carpeta donde se instalarán los componentes de Zabbix y el archivo de configuración del agent de Zabbix. Para el agent 2 de Zabbix, los archivos de configuración adicionales para 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 del agent de Zabbix. |
| LOGTYPE | El tipo de salida del registro. |
| NONMSICONFNAME | La ruta completa a un archivo de configuración personalizado para el agent de Zabbix. Durante la instalación, cualquier parámetro de configuración válido del agent presente en este archivo (limitado a los que figuran en esta tabla) se escribirá en el nuevo archivo de configuración del agent. El archivo debe contener al menos el parámetro Server. Ejemplo: NONMSICONFNAME="C:\full\path\to\example.conf" |
| PERSISTENTBUFFERFILE | Solo para el agent 2 de Zabbix. El archivo donde el agent 2 de Zabbix debe mantener la base de datos SQLite. |
| PERSISTENTBUFFERPERIOD | Solo para el agent 2 de Zabbix. El período de tiempo durante el cual se deben almacenar los datos cuando no hay conexión con el server o el proxy. |
| SERVER | Una lista de direcciones IP separadas por comas, opcionalmente en notación CIDR, o nombres DNS de servers de Zabbix o proxys de Zabbix. Este parámetro es obligatorio, excepto cuando STARTAGENTS se establece en 0. |
| SERVERACTIVE | La dirección del server/proxy de Zabbix o la configuración del clúster desde la que obtener comprobaciones activas. |
| SKIP | Utilice SKIP=fw para evitar que el instalador MSI agregue una regla de excepción de Firewall de Windows para el agent de Zabbix. |
| SOURCEIP | La dirección IP de origen para conexiones salientes al server de Zabbix o al proxy de Zabbix, o para realizar conexiones al ejecutar algunos items (web.page.get, net.tcp.port, etc.). Soportado en los paquetes de instalación MSI desde Zabbix 7.0.22. |
| STARTAGENTS | El número de instancias pre-forked 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. Soportado en los paquetes de instalación MSI desde Zabbix 7.0.22. |
| STARTUPTYPE | Tipo de inicio del servicio del agent de Zabbix. Valores posibles: automatic - inicia el servicio automáticamente al iniciar Windows; delayed - (predeterminado) retrasa el inicio del servicio después de que los servicios iniciados automáticamente hayan completado el inicio (disponible en Windows Vista/Server 2008 y versiones posteriores); manual - inicia el servicio manualmente (por un usuario o una aplicación); disabled - desactiva el servicio para que no pueda ser iniciado por un usuario o una aplicación. Ejemplo: STARTUPTYPE=disabled |
| STATUSPORT | Solo para el agent 2 de Zabbix. 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 de Zabbix o el server. |
| TLSACCEPT | Las conexiones entrantes a aceptar (utilizadas 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 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 de Zabbix o al proxy (utilizado 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 del agent de Zabbix. |
| TLSPSKFILE | La ruta completa de un archivo que contiene la clave precompartida del agent de Zabbix. 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 el agent de Zabbix (o el usuario que ejecuta el agent) pueda leerlo. |
| TLSPSKIDENTITY | La cadena de identidad de la clave precompartida. |
| TLSPSKVALUE | El valor 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 de certificado de server (proxy) permitido. |
| TLSSERVERCERTSUBJECT | El sujeto de certificado de server (proxy) permitido. |
| UNSAFEUSERPARAMETERS | Permitir que todos los caracteres se pasen como argumentos a los parámetros definidos por el usuario. Soportado en los paquetes de instalación MSI desde Zabbix 7.0.22. |
Ejemplos
El siguiente ejemplo instala el agente Zabbix con una configuración personalizada. También habilita el soporte TLS usando claves precompartidas.
mkdir "C:\Program Files\Zabbix Agent" 2>nul
msiexec.exe /l*v "C:\package.log" /i "C:\zabbix_agent-7.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[*]"El siguiente ejemplo instala una versión más reciente del agente Zabbix y utiliza un archivo de configuración de plantilla (CONF="C:\agent-template.conf"). Durante la instalación, este archivo se convertirá en el archivo de configuración del agente. Para heredar parámetros del archivo de configuración anterior, utilice marcadores de posición de parámetros (por ejemplo, [AllowDenyKey]).
msiexec.exe /l*v "C:\package.log" /i "C:\zabbix_agent-7.0.1-windows-amd64-openssl.msi" /qn+ CONF="C:\agent-template.conf"
# Ejemplo de agent-template.conf:
LogFile=[LogFile]
[AllowDenyKey]
Server=192.0.2.8
Hostname=DESKTOP-X9F4A2B
[Include]
[TLSConnect]
[TLSAccept]
[TLSPSKIdentity]
[TLSPSKFile]Alternativamente, puede utilizar un archivo de configuración personalizado (NONMSICONFNAME="C:\agent-custom.conf"). Durante la instalación, cualquier parámetro de configuración válido del agente presente en este archivo (limitado a los listados en la tabla anterior) se escribirá en el nuevo archivo de configuración del agente. Para mantener la configuración existente del agente, defina los parámetros que se deben conservar.
msiexec.exe /l*v "C:\package.log" /i "C:\zabbix_agent-7.0.1-windows-amd64-openssl.msi" /qn+ NONMSICONFNAME="C:\agent-custom.conf"
# Ejemplo de agent-custom.conf:
Server=192.0.2.8
Hostname=DESKTOP-X9F4A2BPlugins cargables de Zabbix agent 2
Los plugins cargables de Zabbix agent 2 pueden instalarse en Windows utilizando paquetes de instalación MSI de 64 bits, disponibles para descargar.
Los requisitos mínimos del sistema operativo para la instalación MSI son Windows 10 (64 bits) o Windows Server 2016.
Los paquetes incluyen:
Los paquetes no incluyen el plugin Ember+, que actualmente solo está disponible para ser compilado desde el código fuente (tanto para Unix como para Windows).
Antes de instalar un plugin, revise su archivo README. Puede contener requisitos adicionales e instrucciones de instalación específicas para el plugin.
De manera similar a Zabbix agent/agent2, 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 del agente Zabbix 2 (plugin MongoDB, plugin PostgreSQL, plugin MSSQL) 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 del agente Zabbix 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 del agente Zabbix 2 pueden instalarse desde la línea de comandos ejecutando el instalador MSI con msiexec. Por ejemplo:
Los paquetes instaladores MSI de los plugins cargables del agente Zabbix 2 admiten los siguientes parámetros.
| Parámetro | Descripción |
|---|---|
| ADDDEFAULT | Una lista de componentes separados por comas para instalar en su configuración predeterminada. Para más información, consulte la propiedad ADDDEFAULT. Valores posibles: MongodbPlugin, PostgresqlPlugin, MssqlPlugin, ALLEjemplo: ADDDEFAULT=MongodbPlugin,PostgresqlPlugin |
| ADDLOCAL | Una lista de componentes separados por comas para instalar localmente. Para más información, consulte la propiedad ADDLOCAL. Valores posibles: MongodbPlugin, PostgresqlPlugin, MssqlPlugin, ALLEjemplo: 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" |