Table of Contents
4 Instalación del agente de Windows desde MSI
Descripción general
El agente Zabbix puede instalarse 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 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 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 está totalmente soportada, 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 equipo | 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 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 | La cadena de valor 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 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 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 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 agente 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.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 MSI del agente Zabbix admiten los siguientes parámetros tanto para el agente Zabbix como para el agente Zabbix 2.
Los parámetros del agente/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 Agente Zabbix (Windows). Para el agente Zabbix 2, consulte la página Agente Zabbix 2 (Windows).
| 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: AgentProgram, GetProgram, SenderProgram, ALLEjemplo: ADDDEFAULT=AgentProgram,GetProgram |
| ADDLOCAL | Una lista de componentes separados por comas para instalar localmente. Para 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 agente 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 agente.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 plantilla para el agente Zabbix. Durante la instalación, este archivo se convertirá en el archivo de configuración del agente. El archivo debe contener al menos los parámetros Server y LogFile. Ejemplo: CONF="C:\full\path\to\example.conf" |
| ENABLEPATH | Utilice ENABLEPATH=1 para agregar la ubicación del agente Zabbix a la variable de sistema PATH. |
| ENABLEPERSISTENTBUFFER | Solo para agente Zabbix 2. Habilita el uso de almacenamiento persistente local para métricas activas. |
| HOSTINTERFACE | Parámetro opcional que define la interfaz del equipo. |
| HOSTMETADATA | Parámetro opcional que define los metadatos del equipo. |
| HOSTMETADATAITEM | Parámetro opcional que define una métrica utilizada para obtener los metadatos del equipo. |
| HOSTNAME | Parámetro opcional que define el nombre del equipo. |
| INCLUDE | Una lista de archivos individuales separados por punto y coma o todos los archivos en un directorio para incluir en el archivo de configuración del agente Zabbix. |
| INSTALLFOLDER | La ruta completa a una carpeta donde se instalarán los componentes de Zabbix y el archivo de configuración del agente Zabbix. Para el agente Zabbix 2, 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 agente debe escuchar. |
| LISTENPORT | El agente escuchará en este puerto las conexiones desde el servidor. |
| LOGFILE | El nombre del archivo de registro del agente Zabbix. |
| LOGTYPE | El tipo de salida del registro. |
| NONMSICONFNAME | La ruta completa a un archivo de configuración personalizado para el agente Zabbix. Durante la instalación, cualquier parámetro de configuración válido del agente presente en este archivo (limitado a los que se enumeran en esta tabla) se escribirá en el nuevo archivo de configuración del agente. El archivo debe contener al menos el parámetro Server. Ejemplo: NONMSICONFNAME="C:\full\path\to\example.conf" |
| PERSISTENTBUFFERFILE | Solo para agente Zabbix 2. El archivo donde el agente Zabbix 2 debe mantener la base de datos SQLite. |
| PERSISTENTBUFFERPERIOD | Solo para agente Zabbix 2. 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 separadas por comas, opcionalmente en notación CIDR, o nombres DNS de servidores Zabbix o proxies Zabbix. Este parámetro es obligatorio. |
| SERVERACTIVE | La dirección del servidor/proxy Zabbix o configuración de clúster desde la que obtener comprobaciones activas. |
| SKIP | Utilice SKIP=fw para evitar que el instalador MSI agregue una regla de excepción en el Firewall de Windows para el agente Zabbix. |
| STARTUPTYPE | Tipo de inicio del servicio del agente Zabbix. Valores posibles: automatic - inicia el servicio automáticamente al arrancar Windows; delayed - (por defecto) retrasa el inicio del servicio después de que los servicios iniciados automáticamente hayan completado el arranque (disponible en Windows Vista/Server 2008 y versiones posteriores); manual - inicia el servicio manualmente (por un usuario o aplicación); disabled - desactiva el servicio para que no pueda ser iniciado por un usuario o aplicación. Ejemplo: STARTUPTYPE=disabled |
| STATUSPORT | Solo para agente Zabbix 2. Si se establece, el agente 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 servidor Zabbix. |
| TLSACCEPT | Las conexiones entrantes a aceptar (utilizado 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 agente o la cadena de certificados. |
| TLSCONNECT | Cómo debe conectarse el agente al servidor o proxy Zabbix (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 agente Zabbix. |
| TLSPSKFILE | La ruta completa de un archivo que contiene la clave precompartida del agente 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 agente Zabbix (o el usuario que ejecuta el agente) 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 de certificado de servidor (proxy) permitido. |
| TLSSERVERCERTSUBJECT | El sujeto de certificado de servidor (proxy) permitido. |
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-8.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-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]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-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-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 descarga.
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 de Zabbix agent 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. Usar 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 pueden instalarse desde la línea de comandos ejecutando el instalador MSI con msiexec. Por ejemplo:
Los paquetes instaladores 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 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" |