重新启动 GroundRunner

如果 GroundRunner 停止运行，请按照以下步骤重新启动它。

重要提示：在本文档中，“GroundRunner”指的是启动“GroundRunnerMonitor”进程（在 Linux 上是“GroundRunnerMonitor”，在 Windows 上是“GroundRunnerMonitor.exe”）。
不要直接启动 GroundRunner（Linux）或 GroundRunner.exe（Windows）——监视器负责管理其运行。

先决条件

需要访问安装了 GroundRunner 的主机。
安装目录，二进制文件就位于该目录中。
允许在机器上启动服务或进程。

验证二进制文件

在尝试启动 GroundRunner 之前，请使用以下命令确认二进制文件仍然存在于安装目录中。您的安装目录可能有所不同。

适用于 Linux

ls /path/to/groundrunner/installation/GroundRunner ls /path/to/groundrunner/installation/GroundRunnerMonitor

适用于 Windows

dir C:\path\to\groundrunner\install\GroundRunner.exe dir C:\path\to\groundrunner\install\GroundRunnerMonitor.exe

如果缺少任一二进制文件，则必须先从备份中恢复该二进制文件，或者重新安装该二进制文件，然后再继续。

Linux

注：以下说明适用于基于 systemd 的 Linux 发行版。如果您的系统使用不同的初始化系统或进程管理器，请查阅您的发行版文档以获取等效的服务管理命令。

如果您不知道服务名称，可以使用以下命令搜索：
sudo systemctl list-units | grep -i groundrunner

如果无法识别或找不到该服务，则 GroundRunnerMonitor 可能尚未注册为 systemd 服务。请参阅如果您没有将 GroundRunner 作为受监控的服务运行下面的说明。

启动 systemd 服务

如果 GroundRunnerMonitor 配置为 systemd 服务，请使用以下命令启动它。请注意，您的服务名称可能因配置方式而异。
sudo systemctl start<service-name>
验证它是否正在运行：
sudo systemctl status<service-name>
（可选，但推荐）启用该服务，使其在系统重启后自动启动：
sudo systemctl enable<service-name>

视窗

使用服务控制台

打开服务控制台：
1. 按 Win+R。
2. 输入 services.msc
3. 按回车。
在列表中找到 GroundRunner 服务，右键单击它并选择启动。

状态 列应更新为 “运行中”。

如果您没有看到“GroundRunner”服务，则 GroundRunnerMonitor.exe 可能已被设置为前台进程。

使用命令行

或者，您也可以使用命令行。如果您不知道该服务的名称：

按 Win+R。
输入 cmd。
输入 sc query 获取所有服务的列表。
找到您的服务名称。
输入 sc 开始<service-name。
输入 sc 查询<service-name 以验证它是否正在运行。
“STATE”字段值应为“RUNNING”。
（可选但推荐）配置服务在系统重启后自动启动。
- 使用命令行
  1. 按 Win+R。
  2. 输入 cmd。
  3. 按回车。
  4. 输入 sc 配置<service-name>在命令窗口中输入 start=auto ，然后按 Enter。
- 使用服务控制台
  1. 按 Win+R。
  2. 输入 services.msc。
  3. 按回车。
  4. 在“服务”控制台中：
    1. 右键单击 GroundRunner 服务。
    2. 点击属性。
    3. 将 启动类型 设置为“自动”。
    4. 点击确定。

确认

启动 GroundRunner 后，请验证 Workiva Chains 应用程序中是否报告了预期版本 (9.21.1)，并且显示为“正在运行”。

笔记

始终运行 GroundRunnerMonitor，而不是直接运行 GroundRunner —GroundRunnerMonitor 进程负责管理 GroundRunner 的生命周期，包括应用自动更新。直接运行 GroundRunner 二进制文件会绕过此管理机制，导致错过更新和出现意外行为。
自定义配置 — 如果您的环境使用 systemd 或 Windows 服务控制管理器以外的服务管理器，请对您的配置执行等效的启动和状态检查。
不要重命名二进制文件 —自动升级机制依赖于默认可执行文件名称（GroundRunner、 GroundRunnerMonitor 和 GroundRunner.exe、 GroundRunnerMonitor.exe）来检测和应用未来的更新。
API 授权重新生成 —重启 GroundRunner 服务器后，无需重新生成 API 授权。只要 GroundRunner 服务在重启后能够正确重启并重新连接到 Workiva，现有的 API 授权仍然有效。
防病毒扫描和 GroundRunner —我们认为最佳实践是将整个 GroundRunner 安装目录及其 tmp 子文件夹从防病毒扫描中排除，而不是排除单个 .exe 文件。这样可以防止对其他插件可执行文件造成类似的阻塞。

将 GroundRunner 配置为受监控服务

Linux（systemd）

将 GroundRunnerMonitor 配置为 systemd 服务。如果 GroundRunnerMonitor 的单元文件尚不存在，则需要创建一个。SUSE 的 systemd 服务设置指南是此过程的有用参考，尽管它是第三方资源，您的特定环境可能需要调整。

在您的 systemd 单元文件中，确保 [Service] 下存在以下设置，以便进程在退出或失败时自动重启：

[服务] 重启=始终 重启秒数=10

创建或更新单元文件后，使用以下命令重新加载 systemd 并启用该服务：

sudo systemctl daemon-reload sudo systemctl enable<service-name> sudo systemctl start

视窗

将 GroundRunnerMonitor 注册为 Windows 服务。注册完成后，配置服务在失败时重新启动。任何一个：

使用服务控制台

按 Win+R。
输入 services.msc。
按回车。
在“服务”控制台中，右键单击 GroundRunner 服务。
点击属性。
选择 “恢复 ”选项卡。
将 第一次失败、 第二次失败和 后续失败 的值设置为“重新启动服务”。
点击确定。

使用命令行

按 Win+R。
输入 cmd。
按回车。
输入以下命令并按 Enter:
sc 失败<service-name>reset=0 actions=restart/10000/restart/10000/restart/10000
这告诉 Windows 在每次故障后 10 秒重启服务。

如果您没有将 GroundRunner 作为受监控服务运行

我们建议将 GroundRunnerMonitor 作为主机操作系统上的可重启服务运行，而不是作为前台进程运行，因为前台进程无法在终端断开连接、机器重启或自动更新后继续运行——任何此类情况都需要手动干预才能使 GroundRunner 再次运行。有关安装 GroundRunners 的信息，请参阅 Workiva 支持页面：安装和管理 GroundRunners。

视频演示

这些视频演示了上述过程。

适用于 Linux

适用于 Windows

支持

社区

Workiva支持中心