Documentation
Table of Contents
4 Instalación del agente 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 pueden instalarse 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 complementos 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 Zabbix agent como al 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 (Agent daemon, 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 Zabbix agent:
| Parámetro | Descripción |
|---|---|
| Host name | El nombre del host de la máquina donde se está instalando el Zabbix agent. Establece el parámetro Hostname. |
| Zabbix server IP/DNS | Una lista de direcciones IP separadas por comas, opcionalmente en notación CIDR, o nombres DNS de los Zabbix servers o Zabbix proxies. Este parámetro es obligatorio. Establece el parámetro Server. |
| Agent listen port | El agent escuchará en este puerto las conexiones desde el server. Establece el parámetro ListenPort. |
| Server or Proxy for active checks | La dirección del Zabbix server/proxy o la configuración del clúster desde la que obtener active checks. La dirección del server/proxy es una dirección IP o un nombre DNS y un puerto opcional separados por dos puntos. Establece el parámetro ServerActive. |
| Enable PSK | Marque la casilla para habilitar el soporte TLS usando claves precompartidas. Establece los parámetros TLSConnect y TLSAccept en psk. |
| Add agent location to the PATH | Marque la casilla para agregar la ubicación del 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 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 Enable PSK en el paso anterior. Estos parámetros también se establecerán en el archivo de configuración del Zabbix agent:
| Parámetro | Descripción |
|---|---|
| Pre-shared key identity | La cadena de identidad de la clave precompartida. Establece el parámetro TLSPSKIdentity. |
| Pre-shared key value | 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 Zabbix agent (o el usuario que ejecuta el agent) pueda leerlo. |
6. Haga clic en Install para comenzar la instalación.
Todos los componentes de Zabbix seleccionados y el archivo de configuración del Zabbix agent se instalarán en la ubicación especificada (por defecto: C:\Program Files\Zabbix Agent). Lo mismo se aplica al 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 se está ejecutando una versión diferente del Zabbix agent 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 Finish 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.4.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 del 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 plantilla 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.4.6. |
| 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.4.6. |
| 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 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 enumerados 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 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 o 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.4.6. |
| 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.4.6. |
| STARTUPTYPE | Tipo de inicio del servicio del agent de Zabbix. Valores posibles: automatic - inicia el servicio automáticamente al iniciar Windows; delayed - (por defecto) 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 aplicación); disabled - deshabilita el servicio para que no pueda ser iniciado por un usuario o 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 o server de Zabbix. |
| 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 o proxy de 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 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 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 server (proxy) permitido. |
| TLSSERVERCERTSUBJECT | El sujeto de certificado de server (proxy) permitido. |
| UNSAFEUSERPARAMETERS | Permitir que se pasen todos los caracteres en los argumentos a los parámetros definidos por el usuario. Soportado en los paquetes de instalación MSI desde Zabbix 7.4.6. |
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.4.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 personalizado para reemplazar parámetros específicos (por ejemplo, Hostname=LAPTOP-IKP7S51S,DESKTOP-X9F4A2B) en el archivo de configuración del agente existente.
msiexec.exe /l*v "C:\package.log" /i "C:\zabbix_agent-7.4.1-windows-amd64-openssl.msi" /qn+ NONMSICONFNAME="C:\agent.conf"Plugins 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.
De forma similar a Zabbix agent/agent2, los plugins cargables pueden instalarse utilizando el Asistente de Configuración o la línea de comandos.
Antes de instalar un plugin, por favor, revise su archivo README. Puede contener requisitos específicos e instrucciones de instalación.
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 pueden instalarse desde la línea de comandos ejecutando el instalador MSI con msiexec. Por ejemplo:
Los paquetes del instalador MSI de los 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: ALL, EmberplusPlugin, MongodbPlugin, MssqlPlugin, NvidiagpuPlugin, PostgresqlPluginEjemplo: 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: ALL, EmberplusPlugin, MongodbPlugin, MssqlPlugin, NvidiagpuPlugin, PostgresqlPluginEjemplo: 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" |