Table of Contents

4 Instalación del agente Windows desde MSI

4 Instalación del agente Windows desde MSI

Descripción general

El agente Zabbix para Windows se puede instalar desde el instalador de paquetes MSI de Windows (32 bits o 64 bits) disponible para su descarga.

No se puede instalar un paquete de 32 bits en un Windows de 64 bits.

El requisito mínimo para la instalación de MSI es:

Windows XP 64-bit y Server 2003 para el agente Zabbix;
Windows 10 32-bit y Server 2016 para el agente Zabbix 2.

Las utilidades get y sender de Zabbix también se pueden instalar, ya sea junto con el agente/agente 2 de Zabbix o por separado.

Todos los paquetes vienen con soporte TLS; sin embargo, configurar TLS es opcional.

Se admite la instalación basada en la interfaz de usuario y en línea de comandos.

Aunque la instalación de Zabbix desde paquetes de instalación MSI es totalmente compatible, se recomienda instalar al menos Microsoft .NET Framework 2 para una gestión adecuada de los errores. Consulte Descarga de Microsoft .NET Framework.

Se recomienda utilizar rutas predeterminadas proporcionadas por el instalador, ya que el uso de rutas personalizadas sin los permisos adecuados podría comprometer la seguridad de la instalación.

Pasos de instalación

Para instalar, haga doble clic en el archivo MSI descargado.

Acepte la licencia para continuar con el siguiente paso.

Especifique los siguientes parámetros.

Parámetro	Descripción
Nombre de equipo	Especifique el nombre de equipo.
IP/DNS del servidor Zabbix	Especifique IP/DNS del servidor Zabbix.
Puerto de escucha del agente	Especifique el puerto de escucha del agente (10050 de forma predeterminada).
Servidor o Proxy para comprobaciones activas	Especifique IP/DNS del servidor/proxy de Zabbix para comprobaciones de agentes activos.
Habilitar PSK	Marque la casilla de verificación para habilitar la compatibilidad con TLS mediante claves precompartidas.
Agregar ubicación del agente a la RUTA	Agregar ubicación del agente a la variable PATH.

Introduzca la identidad y el valor de la clave previamente compartida. Este paso sólo está disponible si marcó Habilitar PSK en el paso anterior.

Seleccione los componentes de Zabbix a instalar - demonio de agente Zabbix, remitente Zabbix, Zabbix get.

Los componentes de Zabbix junto con el archivo de configuración se instalarán en una carpeta Zabbix Agent en Archivos de programa. zabbix_agentd.exe se configurará como servicio de Windows con inicio automático retrasado (o inicio automático en versiones de Windows anteriores a Windows Server 2008/Vista).

Instalación basada en línea de comandos

Parámetros admitidos

Los MSI creados admiten los siguientes parámetros.

Parámetro	Descripción
ADDDEFAULT	Una lista delimitada por comas de programas para instalar en su configuración predeterminada. Valores posibles: `AgentProgram`, `GetProgram`, `SenderProgram`, `ALL`. Ejemplo: `ADDDEFAULT=AgentProgram,GetProgram`
ADDLOCAL	Una lista delimitada por comas de programas para instalar localmente. Valores posibles: `AgentProgram`, `GetProgram`, `SenderProgram`, `ALL`. Ejemplo: `ADDLOCAL=AgentProgram,SenderProgram`
ALLOWDENYKEY	Secuencia de "AllowKey" y "DenyKey" parámetros separados por `;` Use `\\;` para escapar el delimitador. 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 personalizado. Ejemplo: `CONF=c:\full\path\to\user.conf`
ENABLEPATH	Agrega la ubicación del agente a la variable PATH.
ENABLEPERSISTENTBUFFER	Solo agente Zabbix 2. Habilita el uso de almacenamiento persistente local para elementos 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 elemento del agente Zabbix utilizado para obtener los metadatos del host.
HOSTNAME	Un parámetro opcional que define el nombre del equipo.
INCLUDE	Secuencia de includes separados por `;`
INSTALLFOLDER	La ruta completa de la carpeta en la que se instalarán los componentes de Zabbix junto con el archivo de configuración.
LISTENIP	Una lista de direcciones IP delimitadas por comas en las que el agente debe escuchar.
LISTENPORT	El agente escuchará en este puerto las conexiones del servidor.
LOGFILE	El nombre del archivo de registro.
LOGTYPE	El tipo de salida del registro.
PERSISTENTBUFFERFILE	Solo para el agente 2 de Zabbix. El archivo donde el agente 2 de Zabbix debe guardar la base de datos SQLite.
PERSISTENTBUFFERPERIOD	Solo para el agente 2 de Zabbix. 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 delimitadas por comas, opcionalmente en notación CIDR, o nombres DNS de servidores Zabbix y proxies Zabbix.
SERVERACTIVE	Dirección del servidor o proxy de Zabbix o configuración del clúster desde donde obtener las comprobaciones activas.
SKIP	`SKIP=fw` - no instalar la regla de excepción del firewall.
STARTUPTYPE	Tipo de inicio del servicio de agente de Windows/agente 2 de Zabbix. Valores posibles: `automatic` - iniciar el servicio automáticamente al iniciar Windows; `delayed` - (predeterminado) retrasar el inicio del servicio después de que los servicios iniciados automáticamente hayan completado el inicio (disponible en Windows Server 2008/Vista y versiones posteriores); `manual` - iniciar el servicio manualmente (por un usuario o aplicación); `disabled` - deshabilitar el servicio, de modo que no pueda ser iniciado por un usuario o aplicación. Ejemplo: `STARTUPTYPE=disabled`
STATUSPORT	Solo agente Zabbix 2. Si se configura, el agente escuchará en este puerto las solicitudes de estado HTTP (http://localhost:<port>/status).
TIMEOUT	Especifica el tiempo de espera para las comunicaciones (en segundos).
TLSACCEPT	Qué conexiones entrantes se aceptarán.
TLSCAFILE	La ruta completa de un archivo que contiene los certificados de CA de nivel superior para la verificación de certificados de pares, que se utiliza para las comunicaciones cifradas entre los componentes de Zabbix.
TLSCERTFILE	La ruta completa de un archivo que contiene el certificado del agente o la cadena de certificados, que se utiliza para comunicaciones cifradas entre componentes de Zabbix.
TLSCONNECT	Cómo debe conectarse el agente al servidor o proxy de Zabbix.
TLSCRLFILE	La ruta completa de un archivo que contiene certificados revocados. Este parámetro se utiliza para comunicaciones cifradas entre componentes de Zabbix.
TLSKEYFILE	La ruta completa de un archivo que contiene la clave privada del agente, que se utiliza para comunicaciones cifradas entre componentes de Zabbix.
TLSPSKFILE	La ruta completa de un archivo que contiene la clave precompartida del agente](/manual/encryption/using_pre_shared_keys), utilizada para comunicaciones cifradas con el servidor Zabbix.
TLSPSKIDENTITY	La cadena de identidad de la clave precompartida](/manual/encryption/using_pre_shared_keys), utilizada para comunicaciones cifradas con el servidor Zabbix.
TLSPSKVALUE	El valor de la cadena de la clave precompartida](/manual/encryption/using_pre_shared_keys), utilizada para comunicaciones cifradas con el servidor Zabbix.
TLSSERVERCERTISSUER	El emisor de certificado de servidor (proxy) permitido.
TLSSERVERCERTSUBJECT	El sujeto del certificado de servidor (proxy) permitido.

Ejemplos

Para instalar el agente Zabbix Windows desde la línea de comandos, puede ejecutar, por ejemplo:

SET INSTALLFOLDER=C:\Program Files\Zabbix Agent
       
       msiexec /l*v log.txt /i zabbix_agent-7.0.0-x86.msi /qn^
        LOGTYPE=file^
        LOGFILE="%INSTALLFOLDER%\zabbix_agentd.log"^
        SERVER=192.168.6.76^
        LISTENPORT=12345^
        SERVERACTIVE=::1^
        HOSTNAME=myHost^
        TLSCONNECT=psk^
        TLSACCEPT=psk^
        TLSPSKIDENTITY=MyPSKID^
        TLSPSKFILE="%INSTALLFOLDER%\mykey.psk"^
        TLSCAFILE="c:\temp\f.txt1"^
        TLSCRLFILE="c:\temp\f.txt2"^
        TLSSERVERCERTISSUER="My CA"^
        TLSSERVERCERTSUBJECT="My Cert"^
        TLSCERTFILE="c:\temp\f.txt5"^
        TLSKEYFILE="c:\temp\f.txt6"^
        ENABLEPATH=1^
        INSTALLFOLDER="%INSTALLFOLDER%"^
        SKIP=fw^
        ALLOWDENYKEY="DenyKey=vfs.file.contents[/etc/passwd]"

También puede ejecutar, por ejemplo:

msiexec /l*v log.txt /i zabbix_agent-7.0.0-x86.msi /qn^
        SERVER=192.168.6.76^
        TLSCONNECT=psk^
        TLSACCEPT=psk^
        TLSPSKIDENTITY=MyPSKID^
        TLSPSKVALUE=1f87b595725ac58dd977beef14b97461a7c1045b9a1c963065002c5473194952

Si se pasan TLSPSKFILE y TLSPSKVALUE, TLSPSKVALUE se escribirá en TLSPSKFILE.

Zabbix agent 2 loadable plugins

Zabbix agent 2 loadable plugins can be installed on Windows using 64-bit MSI installer packages, available for download.

Minimum OS requirements for MSI installation are Windows 10 (64-bit) or Windows Server 2016.

Packages include:

Packages do not include the Ember+ plugin, which is currently only available to be built from source (for both Unix and Windows).

Before installing a plugin, check its README file. It may contain additional requirements and installation instructions specific to the plugin.

Similarly to Zabbix agent/agent2, loadable plugins can be installed using the Setup Wizard or the command line.

Installation from Setup Wizard

1. Double-click the downloaded MSI file to start the installation.

2. Accept the End-User License Agreement.

3. Select the Zabbix agent 2 loadable plugins (MongoDB plugin, PostgreSQL plugin, MSSQL plugin) to be installed.

It is recommended to use the default installation location provided by the installer. Using a custom location without the necessary permissions may compromise the security of the installation.

4. Click Install to begin the installation.

All selected Zabbix agent 2 loadable plugins will be installed in your specified location (default: C:\Program Files\Zabbix Agent 2), with their configuration files installed in the zabbix_agent2.d subfolder.

5. Click the Finish button to exit the Setup Wizard.

Installation from command line

Zabbix agent 2 loadable plugins can be installed from the command line by running the MSI installer with msiexec. For example:

msiexec.exe /l*v "C:\package.log" /i "C:\zabbix_agent2_plugins-7.0.0-windows-amd64.msi" /qn+

Zabbix agent 2 loadable plugin MSI installer packages support the following parameters.

Parameter	Description
ADDDEFAULT	A list of comma-delimited components to install in their default configuration. For more information, see ADDDEFAULT property. Possible values: `MongodbPlugin`, `PostgresqlPlugin`, `MssqlPlugin`, `ALL` Example: `ADDDEFAULT=MongodbPlugin,PostgresqlPlugin`
ADDLOCAL	A list of comma-delimited components to install locally. For more information, see ADDLOCAL property. Possible values: `MongodbPlugin`, `PostgresqlPlugin`, `MssqlPlugin`, `ALL` Example: `ADDLOCAL=MongodbPlugin,MssqlPlugin`
INSTALLFOLDER	The full pathname to a folder where Zabbix components will be installed, with their configuration files installed in the `zabbix_agent2.d` subfolder. Example: `INSTALLFOLDER="C:\Program Files\Zabbix Agent 2"`

Documentation