从 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命令。 -
-
如果需要进行故障排除，可以使用带有
-L*V "log.txt"选项的msiexec进行安装，以创建安装日志。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选项添加到安装命令中。
升级编辑
不支持升级，并且 MSI 本身会阻止升级。您可以改为在 Fleet 中管理所有 Elastic Agent 升级。
安装在自定义位置编辑
从 8.13 版本开始，还可以通过从命令行运行 MSI 来覆盖默认安装文件夹，如下所示
elastic-agent-<VERSION>-windows-x86_64.msi INSTALLARGS="--url=<URL> --enrollment-token=<TOKEN>" INSTALLDIR="<path of custom folder>"