从 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 Server 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选项添加到 install 命令。
升级
编辑可以通过 Fleet 升级 Elastic Agent 版本，但已注册的 MSI 版本将显示最初安装的版本（此缺陷将在以后的版本中解决）。尝试通过 MSI 在 Fleet 外部进行升级将需要卸载和重新安装过程才能升级。另请注意，此 MSI 实现依赖于 tar Elastic Agent 二进制文件来升级安装。因此，如果 Elastic Agent 安装在 air-gapped 环境中，您必须确保在发出升级请求之前 tar 映像可用。
安装到自定义位置
编辑从 8.13 版本开始，也可以通过从命令行运行 MSI 来覆盖默认安装文件夹，如下所示
elastic-agent-<VERSION>-windows-x86_64.msi INSTALLARGS="--url=<URL> --enrollment-token=<TOKEN>" INSTALLDIR="<path of custom folder>"