从 MSI 包安装 Elastic Agent
编辑从 MSI 包安装 Elastic Agent
编辑MSI 是Windows Installer 的文件格式和命令行实用程序。Windows Installer（以前称为 Microsoft Installer）是 Microsoft Windows 的一个接口，用于在 Windows 系统上安装和管理软件。本节介绍通过 MSI 包存储库安装 Elastic Agent 的方法。
必须使用管理员帐户运行 MSI 包安装程序。没有 Windows 管理员权限，安装程序将无法启动。
安装 Elastic Agent
编辑- 从Elastic Agent 下载页面下载最新的 Elastic Agent MSI 二进制文件。
-
运行安装程序
elastic-agent-<VERSION>-windows-x86_64.msi INSTALLARGS="--url=<URL> --enrollment-token=<TOKEN>"
其中
-
VERSION是您正在安装的 Elastic Stack 版本，在 MSI 包名称中指示。例如，8.13.2。 -
URL是用于将 Elastic Agent 注册到 Fleet 的 Fleet 服务器 URL。您可以在 Kibana 中的 Fleet 设置 选项卡中找到它。 -
TOKEN是用于将 Elastic Agent 注册到 Fleet 的身份验证令牌。您可以在 Fleet 注册令牌 选项卡中找到它。
运行命令时，为
INSTALLARGS设置的值将逐字传递到elastic-agent install命令。 -
-
如果需要进行故障排除，可以使用
msiexec和-L*V "log.txt"选项安装以创建安装日志。msiexec -i elastic-agent-<VERSION>-windows-x86_64.msi INSTALLARGS="--url=<URL> --enrollment-token=<TOKEN>" -L*V "log.txt"
安装说明
编辑使用 MSI 包安装具有以下行为
- 如果未提供
INSTALLARGS，则 MSI 将文件复制到临时文件夹并完成。 - 如果提供了
INSTALLARGS，则 MSI 将文件复制到临时文件夹，然后使用提供的参数运行elastic-agent install命令。如果安装流程成功，则会删除临时文件夹。 - 如果提供了
INSTALLARGS但elastic-agent install命令失败，则不会删除顶级文件夹，以便进行进一步的故障排除。 - 如果
elastic-agent install命令由于任何原因失败，则 MSI 将回滚所有更改。 - 如果 Elastic Agent 注册失败，安装也会失败。为避免此行为，您可以将
--delay-enroll选项添加到安装命令。
升级
编辑可以通过 Fleet 升级 Elastic Agent 版本，但注册的 MSI 版本将显示最初安装的版本（此缺点将在未来的版本中解决）。尝试通过 MSI 在 Fleet 外进行升级将需要卸载和重新安装过程才能升级。另请注意，此 MSI 实施依赖于 tar Elastic Agent 二进制文件来升级安装。因此，如果 Elastic Agent 安装在隔离环境中，则必须确保在发出升级请求之前 tar 镜像可用。
在自定义位置安装
编辑从 8.13 版本开始，还可以通过从命令行运行 MSI 来覆盖默认安装文件夹，如下所示
elastic-agent-<VERSION>-windows-x86_64.msi INSTALLARGS="--url=<URL> --enrollment-token=<TOKEN>" INSTALLDIR="<path of custom folder>"