4 从MSI安装Windows agent

4 从MSI安装Windows agent

概述

可以从Windows MSI安装包（32位或64位）安装Zabbix agent。download.

32位包不能安装在64位Windows中。

所有软件包都支持TLS，然而，配置TLS是可选的。

支持UI和命令行的安装。

安装步骤

请双击已下载的MSI文件进行安装。

接受许可证已进入下一步。

具体参数。

参数	描述
主机名	指定主机名。
Zabbix server IP/DNS	指定Zabbix server的IP/DNS。
Agent监听端口	指定agent 监听端口 (默认为10050)。
主动检查Server或Proxy	为激活agent主动检查指定Zabbix server/proxy的IP/DNS。
启用PSK	选中校验框，通过预共享密钥激活TLS支持。
将agent位置添加到PATH	将agent位置添加至PATH变量。

输入预共享密钥的标识和对应值。此步骤仅在上一步中选中 Enable PSK 之后才有用。

选择要安装的Zabbix组件- Zabbix agent daemon, Zabbix sender, Zabbix get.

Zabbix组件和配置文件将安装在程序文件 Zabbix Agent 文件夹中。 zabbix_agentd.exe 在Windows服务中将被设置为自动启动。

命令行安装

支持的参数

以下参数由创建的 MSI 支持。

参数	描述
ADDDEFAULT	要安装的程序的逗号分隔列表。可能的值：`AgentProgram`, `GetProgram`, `SenderProgram`, `ALL`。示例：`ADDDEFAULT=AgentProgram,GetProgram`
ADDLOCAL	要安装的程序的逗号分隔列表。可能的值：`AgentProgram`, `GetProgram`, `SenderProgram`, `ALL`。示例：`ADDLOCAL=AgentProgram,SenderProgram`
ALLOWDENYKEY	通过 `;` 分隔的 “AllowKey” 和 “DenyKey” 参数序列使用 `\;` 转义分隔符。示例：`ALLOWDENYKEY=”AllowKey=system.run[type c:\windows\system32\drivers\etc\hosts];DenyKey=system.run[*]”`
CONF	自定义配置文件的完整路径名。示例：`CONF=c:\full\path\to\user.conf`
ENABLEPATH	将agent 位置添加到 PATH 变量。
ENABLEPERSISTENTBUFFER	仅限 Zabbix agent 2。启用对主动项目使用本地持久存储。
HOSTINTERFACE	定义主机接口的可选参数。
HOSTMETADATA	定义主机元数据的可选参数。
HOSTMETADATAITEM	定义用于获取主机元数据的 Zabbix agent 监控项的可选参数。
HOSTNAME	定义主机名的可选参数。
INCLUDE	通过 `;` 分隔的包含序列
INSTALLFOLDER	Zabbix 组件及配置文件将被安装的文件夹的完整路径名。
LISTENIP	agent 应监听的逗号分隔 IP 地址列表。
LISTENPORT	agent 将在此端口上监听来自服务器的连接。
LOGFILE	日志文件的名称。
LOGTYPE	日志输出的类型。
PERSISTENTBUFFERFILE	仅限 Zabbix agent 2。Zabbix agent 2 应保留 SQLite 数据库的文件。
PERSISTENTBUFFERPERIOD	仅限 Zabbix agent 2。当没有连接到server 或proxy 时，数据应存储的时间周期。
SERVER	逗号分隔的 IP 地址列表，可选地使用 CIDR 表示法，或 Zabbix server 和 Zabbix proxy的 DNS 名称。
SERVERACTIVE	用于获取主动检查的 Zabbix server/proxy 地址或集群配置。
SKIP	`SKIP=fw` - 不要安装防火墙例外规则。
STARTUPTYPE	Zabbix Windows agent/agent2 服务的启动类型。可能的值： `automatic` - 在 Windows 启动时自动启动服务； `delayed` - (默认) 在自动启动服务启动完成后延迟启动服务（适用于 Windows Server 2008/Vista 及更高版本）； `manual` - 手动启动服务（由用户或应用程序）； `disabled` - 禁用服务，使其不能由用户或应用程序启动。示例：`STARTUPTYPE=disabled`
STATUSPORT	仅限 Zabbix agent 2。如果设置，agent 将在此端口上监听 HTTP 状态请求（http://localhost:<port>/status）。
TIMEOUT	指定通信的超时时间（以秒为单位）。
TLSACCEPT	接受哪种传入连接。
TLSCAFILE	包含顶层 CA 证书的文件的完整路径名，用于对等证书验证，用于 Zabbix 组件之间的加密通信。
TLSCERTFILE	包含agent 证书或证书链的文件的完整路径名，用于 Zabbix 组件之间的加密通信。
TLSCONNECT	agent 应如何连接到 Zabbix server 或proxy。
TLSCRLFILE	包含吊销证书的文件的完整路径名。此参数用于 Zabbix 组件之间的加密通信。
TLSKEYFILE	包含agent 私钥的文件的完整路径名，用于 Zabbix 组件之间的加密通信。
TLSPSKFILE	包含agent预共享密钥的文件的完整路径名，用于与 Zabbix 服务器的加密通信。
TLSPSKIDENTITY	预共享密钥身份字符串，用于与 Zabbix 服务器的加密通信。
TLSPSKVALUE	预共享密钥字符串值，用于与 Zabbix 服务器的加密通信。
TLSSERVERCERTISSUER	允许的server（proxy）证书颁发者。
TLSSERVERCERTSUBJECT	允许的server（proxy）证书主题。

请注意，方括号内的链接是示例链接，实际使用时应替换为正确的文档链接。

示例

要从命令行安装 Zabbix Windows agent，您可以运行以下命令，例如：

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]"

您也可以运行以下命令，例如：

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

如果同时传递了 TLSPSKFILE 和 TLSPSKVALUE，则会将 TLSPSKVALUE 写入 TLSPSKFILE。