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 desde 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 (Agent daemon, Zabbix sender, Zabbix get) que se instalarán:
Se recomienda usar 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. Configure los siguientes parámetros. Sus valores se establecerán en el archivo de configuración de Zabbix agent:
| Parameter | Description |
|---|---|
| Host name | El nombre del host de la máquina donde se está instalando 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 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 de clúster desde la que obtener active checks. La dirección del server/proxy es una dirección IP o un nombre DNS, con un puerto opcional separado por dos puntos. Establece el parámetro ServerActive. |
| Enable PSK | Marque la casilla para habilitar la compatibilidad con TLS using pre-shared keys. Establece los parámetros TLSConnect y TLSAccept en psk. |
| Add agent location to the PATH | Marque la casilla para agregar 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 se 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 Enable PSK en el paso anterior. Estos parámetros también se establecerán en el archivo de configuración de Zabbix agent:
| Parameter | Description |
|---|---|
| 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 (predeterminado: 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 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 de Zabbix agent se instalarán en la ubicación especificada (predeterminado: C:\Program Files\Zabbix Agent).
Lo mismo aplica a Zabbix agent 2, excepto que los archivos de configuración adicionales para sus built-in plugins 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 diferido (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 pedirá que elija entre cerrar la aplicación e intentar reiniciarla o dejarla abierta, en cuyo caso será necesario reiniciar el equipo.
7. Haga clic en el botón Finish para salir del asistente de configuración.
Instalación desde la línea de comandos
Zabbix agent 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-8.0.0-windows-amd64-openssl.msi" /qn+ SERVER=192.0.2.1Este método permite realizar 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 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 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, use una barra invertida para escapar el delimitador (\;). Establece los parámetros AllowKey y DenyKey en el archivo de configuración de 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 de 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 de sistema PATH. |
| ENABLEPERSISTENTBUFFER | Solo Zabbix agent 2. Habilita el uso de almacenamiento local persistente para 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 separados por punto y coma o de todos los archivos de un directorio para incluir en el archivo de configuración de Zabbix agent. |
| 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 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 de agent presente en este archivo (limitado a los enumerados en esta tabla) se escribirá en el nuevo archivo de configuración de 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 server/proxy de Zabbix 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 de Windows Firewall 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 tanto TLSPSKFILE como TLSPSKVALUE están establecidos, el valor de TLSPSKVALUE se escribirá en el archivo especificado en TLSPSKFILE. Se recomienda restringir el acceso al archivo de la 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 tanto TLSPSKFILE como TLSPSKVALUE están establecidos, el valor de TLSPSKVALUE se escribirá en el archivo especificado en TLSPSKFILE. Ejemplo: TLSPSKVALUE=1f87b595725ac58dd977beef14b97461a7c1045b9a1c963065002c5473194952 |
| TLSSERVERCERTISSUER | El emisor permitido del certificado del server (proxy). |
| TLSSERVERCERTSUBJECT | El sujeto permitido del certificado del server (proxy). |
| UNSAFEUSERPARAMETERS | Permite que todos los caracteres se pasen en los argumentos a 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 válido de configuración del 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-X9F4A2BPlugins 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 pueden 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_agent2_plugins-8.0.0-windows-amd64.msi" /qn+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, CephPlugin, 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, CephPlugin, 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" |