按照以下说明将主机上的 GroundRunner 和 GroundRunnerMonitor 二进制文件替换为更新的版本。
重要规划说明
- GroundRunner 服务不支持正常关闭。服务停止后，所有飞行中操作立即终止。这些操作的结果将会丢失，需要重新运行命令。
- 由于停止服务会造成干扰，我们强烈建议您在执行更新之前与您的利益相关者协调部署窗口，并确保在维护期间没有关键作业正在运行或计划运行。
先决条件（所有平台）
- 请检查是否需要更新。当前版本（截至 2026 年 6 月 1 日）为 9.21.1。
请参阅 如何查看 GroundRunner 的版本？ 以了解您正在使用的 GroundRunner 版本。
如果您的 GroundRunner 版本过旧，则会显示以下横幅。 - 如果您的 GroundRunner 版本过旧，请记录 版本 字段中显示的版本号。
适用于 Windows 平台
- 从 Workiva 获取的 Windows
GroundRunner.zip。
（详情请参阅 安装和管理 GroundRunners 。） - 两者均需具备管理员权限：
- 安装 GroundRunner 的机器。
- 二进制文件安装目录。
- 允许停止和启动 GroundRunner 服务。
适用于 Linux 平台
- 从 Workiva 获取的 Windows
GroundRunner.zip。
（详情请参阅 安装和管理 GroundRunners 。） - 必须安装 Linux 实用程序
unzip(1)、tar(1)和gzip(1)（这些在大多数安装中都是标准配置）。 - 文件所有权权限（chown）。
- 两者均需具备管理员权限：
- 安装 GroundRunner 的机器。
- 二进制文件安装目录。
- 允许停止和启动 GroundRunner 服务。
Windows 安装
- 将 GroundRunner.zip
文件解压到临时目录。 - 打开服务控制台：按
Win + R，键入services.msc，然后按 Enter。 - 在列表中找到 GroundRunner ，右键单击它，然后选择 停止。
- 等待状态显示 已停止。
- 备份现有二进制文件。在
文件资源管理器中，导航到 GroundRunner 安装目录，并将GroundRunner.exe和GroundRunnerMonitor.exe以及任何配置文件复制到备份位置（例如，将它们重命名为GroundRunner.exe.bak和GroundRunnerMonitor.exe.bak） 。 - 将解压目录中的
GroundRunner.exe和GroundRunnerMonitor.exe复制到安装目录中，替换现有文件。 - 返回“服务”控制台，右键单击 GroundRunner 并选择 启动。
- 确认状态显示为 运行中。
Linux (systemd) 安装
这些说明适用于标准的非安全增强型 Linux 系统。如果您的主机运行 SELinux、AppArmor 或其他安全软件，请参阅本节末尾的 强制访问控制 (SELinux / AppArmor) 。
-
解压压缩文件中的文件。
注： 将 zip 文件解压到
/tmp/groundrunner-update仅用于示例目的。您可以根据组织策略，将压缩文件解压到最合适的位置。unzip GroundRunner.zip -d /tmp/groundrunner-update
-
停止正在运行的进程。如果使用 systemd，请使用以下命令：
sudo systemctl stop<service-name>
【重要提示】： 【如果您 尚未将 GroundRunner 配置为 systemd服务，请在执行 更新之前将其设置为 systemd服务。有关如何配置 systemd 服务的文档，请参阅您的 Linux 发行版文档。如果您使用的是非 systemd Linux 发行版，请查阅您的发行版文档。
-
备份 GroundRunner 目录中的二进制文件和配置文件：
cd /groundrunner安装目录 tar czvf groundrunner.bak.tar.gz GroundRunner* *config config* monitor.version
注意： 您可以备份整个安装目录（包括日志和其他文件夹/文件），但这可能会生成非常大的备份文件。
-
替换二进制文件：
cd /path_to_groundrunner_install_dir cp /tmp/groundrunner-update/GroundRunner . cp /tmp/groundrunner-update/GroundRunnerMonitor .
-
设置可执行权限：
chmod +x GroundRunner GroundRunnerMonitor
注意： 如果您的 GroundRunner 由特定系统用户运行，您可能需要
chown新的可执行文件。 -
启动服务：
sudo systemctl start<service-name>
-
检查服务状态，确保其运行正常：
sudo systemctl status<service-name>
-
清理：
rm -rf /tmp/groundrunner-update
强制访问控制（SELinux / AppArmor）
如果主机强制执行访问控制策略（SELinux、AppArmor 或类似策略），替换磁盘上的二进制文件可能会导致服务失败。
请参阅您的发行版文档，了解如何管理自定义服务的安全策略。
注： 其他安全软件（例如 FAPOLICYD、IMA/EVM 或自定义文件完整性监控）也可能阻止执行已替换的二进制文件。如果在更新后服务无法启动，并且您已排除 SELinux/AppArmor 的问题，请检查系统上的其他安全框架是否需要更新信任列表或文件签名。
确认
您可以按照 如何检查 GroundRunner 的状态中的说明来确认 GroundRunner 是否处于活动状态及其版本是否正确？
我们鼓励您创建并运行一个“试点链”，在 GroundRunner 上运行一组测试命令，以确保正确安装。
我们还建议您在更新和重启系统后立即监控系统和 GroundRunner 的活动。这样你就能确信它运行正常。您可以使用 CLI 命令来实时流式传输和查看新的日志条目。
适用于 Windows
要使用 PowerShell 查看日志文件的末尾，请输入以下命令：
Get-Content -Path "C:\path_to_\output.log" -Tail 10 -Wait
这样可以保持 PowerShell 窗口打开，并实时加载新的日志条目。` - tail 10` 命令会立即加载最后 10 行日志。
适用于 Linux
要查看日志文件的末尾并实时查看新条目，请输入以下命令：
tail -f /path_to/output.log
回滚
如果新版本无法正常工作，您可以按照以下步骤回滚到之前的版本：
- 按照上述步骤停止 GroundRunner 服务。
- 重命名已安装的
GroundRunner.exe和GroundRunnerMonitor.exe文件。 - 将备份位置的
GroundRunner.exe.bak和GroundRunnerMonitor.exe.bak复制到安装目录。 - 请删除这些文件的“.bak”扩展名，重新命名这些文件。
- 按照上述步骤重新启动 GroundRunner 服务。
注： 这些说明同样适用于 Linux GroundRunner，但您需要从备份压缩包中提取二进制文件。
笔记
- 请勿重命名二进制文件。自动升级机制依赖于默认可执行文件名称（Linux 系统上的
GroundRunner和GroundRunnerMonitor，以及 Windows 系统上的GroundRunner.exe和GroundRunnerMonitor.exe）来检测和应用未来的更新。重命名会破坏自动升级功能。 - macOS 仅用于开发目的。它不是一个受支持的生产平台。
- 其他服务管理器： 以上示例使用了 systemd（Linux）和 Windows 服务控制管理器。如果您的环境使用不同的服务管理器或进程管理器，请对您的配置执行相应的停止、替换和启动步骤。
- 默认情况下，GroundRunner 使用本地管理员帐户，无法访问共享驱动器等远程资源。要访问共享资源（例如 Windows UNC 路径），请使用具有足够权限访问该资源的用户帐户启动 GroundRunner。如果使用的用户帐户不是默认的本地系统管理员，请授予该帐户管理 GroundRunner 安装目录的权限，以启用自动更新。