GroundRunners 使链命令能够与无法通过互联网访问的内部系统或远程数据源进行交互。它们通常由 IT 专业人员或熟悉您组织的网络设置的人员安装在专用服务器上,例如托管您连接的数据源的服务器。
在设置 GroundRunner 之前,我们建议您查看 Chain Builder 安全架构。
要求
需要兼容的操作系统,并且如果您的 GroundRunner 将访问共享资源(例如 Windows 通用命名约定 (UNC) 路径),那么也需要具有足够权限的用户帐户。
Java 运行时环境(JRE)根据 GPL v2 获得许可,但受到 类路径异常的约束。
注意:要将自定义证书与您的 Java 安装一起使用,或者根本不使用 Workiva 的共享库,请参阅我们的 使用自定义证书和 GroundRunners 文章。
下载 GroundRunner
要下载 GroundRunner 进行安装或手动更新:
- 在 Chain Builder 中,从侧边栏中选择 设置
。 - 点击顶部的 下载 。
- 找到适合您操作系统的 GroundRunner,然后单击右侧的 下载 。
安装 GroundRunner
Microsoft 安装程序 (MSI) 需要 .NET 3.5 或更高版本。如果您无法满足此要求,请通过命令行界面安装 GroundRunner。
要安装 GroundRunner:
- 解压缩 windows_amd64_ground_runner.zip 文件。
- 运行 GroundRunner.msi 以启动GroundRunner 安装向导。
- 单击 下一步。
- 查看并接受许可协议中的条款,然后单击 下一步。
- 对于目标文件夹,输入 GroundRunner 的安装路径(例如
C:\Program Files\GroundRunner\
),然后单击 下一步。 - 在 平台公司令牌中,输入您的 公司令牌。
- 在 平台身份验证主机中:
- 如果在北美,请输入
h.app.wdesk.com/s/wdata/oc/app
- 如果在欧洲,请输入
h.eu.wdesk.com/s/wdata/oc/app
- 如果在亚太地区,请输入
h.apac.wdesk.com/s/wdata/oc/app
- 如果在北美,请输入
- 如果使用代理服务器,请在 代理主机中输入其 URL 和端口。(例如,http://yourproxy:3000。)
- 要绕过代理服务器,请在 无代理主机。下输 入以逗号分隔的主机列表
- 单击 下一步、 安装和 完成。
- 安装后,在 Windows 服务管理器中右键单击 GroundRunner 并选择 启动。
您的 GroundRunner 现已安装完毕并准备激活。
要通过命令行界面安装,您必须将 GroundRunner 的安装下载到程序文件中的自己的目录中(例如 c:\Program Files (x86)\wdata
)。然后您可以解压安装文件并将其提取到目录的根目录。
然后您可以安装 GroundRunner:
- 从 Windows CLI 运行命令
c:\Program Files (x86)\wdata\installer.exe install
并接受所有默认值。- 对于路径,在新目录中创建一个 Files 文件夹(例如
C:\Program Files (x86)\Wdata\Files
)。 - 对于授权主机名(AUTH_HOST):
- 如果在北美,请输入
h.app.wdesk.com/s/wdata/oc/app
- 如果在欧洲,请输入
h.eu.wdesk.com/s/wdata/oc/app
- 如果在亚太地区,请输入
h.apac.wdesk.com/s/wdata/oc/app
- 如果在北美,请输入
- 输入您的 公司令牌。
- 对于路径,在新目录中创建一个 Files 文件夹(例如
- 从目录中删除 GroundRunner 可执行目录以外的所有文件。
- 选择是否将 GroundRunner 作为服务或前台进程运行。
- 如果作为服务运行,请执行以下操作之一:
- 在 CLI 中,输入命令
sc start GroundRunner
- 在 Windows 服务管理器中,启动 HostRunner 服务
- 在 CLI 中,输入命令
- 如果作为前台进程运行,请在 CLI 中输入以下命令:
cd c:\Program Files (x86)\wdata GroundRunner.exe
- 如果作为服务运行,请执行以下操作之一:
步骤 1. 安装 GroundRunner
- 将 GroundRunner 的安装文件下载到其自己的目录中,例如
/home/<username> /wdata/
. - 在 CLI 中,解压缩安装文件:
- 对于 Linux,使用命令
unzip linux_amd64_ground_runner.zip
- 对于 macOS,使用命令
unzip GroundRunner.zip
- 对于 Linux,使用命令
- 输入 GroundRunner 的详细信息。
- 对于 Linux 和 Mac OS,使用命令
<!--sudo -->./installer install
- 对于授权主机名(AUTH_HOST):
- 如果在北美,请输入
h.app.wdesk.com/s/wdata/oc/app
- 如果在欧洲,请输入
h.eu.wdesk.com/s/wdata/oc/app
- 如果在亚太地区,请输入
h.apac.wdesk.com/s/wdata/oc/app
- 如果在北美,请输入
- 输入您的 公司令牌。
- 对于 Linux 和 Mac OS,使用命令
- 从目录中删除除 GroundRunner 可执行目录之外的所有文件。
第 2 步。选择作为服务还是前台进程运行
在 CLI 中,输入以下命令以将 GroundRunner 作为后台服务或前台进程运行。
后台服务
如果从默认操作系统初始化程序执行,则可以将其作为后台服务运行:
/home/[用户名]/wdata/Contents/GroundRunnerMonitor
前台进程
要将其作为前台进程运行并将日志写入控制台:
cd home/[用户名]/wdata/Contents sudo ./GroundRunner
要将其作为前台进程运行并将日志写入日志文件:
cd home/[用户名]/wdata/Contents sudo ./GroundRunnerMonitor
激活 GroundRunner
安装 GroundRunner 后,您必须在 Chain Builder 中激活它。
- 在 Chain Builder 中,从侧边栏中选择 设置
。 - 点击顶部的 跑步者 。
- 在 待注册下,为跑步者输入一个简短的描述性名称(例如 <datasource> -GroundRunner)。
- 点击 激活。
手动更新 GroundRunner
虽然很少见,但您可能需要手动升级 GroundRunner。
下载并安装最新的 MSI,并卸载任何以前下载的版本。
- 为您的操作系统下载最新的 GroundRunner。
- 在 Windows 服务管理器中, 停止 GroundRunner 服务。
- 将下载的 GroundRunner 安装文件移动到其自己的目录(例如
c:\groundrunner_upgrade
)并解压缩其文件。 - 将 GroundRunner.exe 和 GroundRunnerMonitor.exe 复制并粘贴到安装 GroundRunner 二进制文件的目录中。
- 在 Windows 服务管理器中, 重新启动 GroundRunner 服务。
- 为您的操作系统下载最新的 GroundRunner。
- 在托管 GroundRunner 的服务器上,转到服务运行的目录。
- 在 CLI 中, 停止 GroundRunner 服务。
- 将下载的 GroundRunner 安装文件移动到其自己的目录 - 例如
/home/<username> /groundrunner_upgrade/
—并解压缩其文件。 - 将 GroundRunner.exe 和 GroundRunnerMonitor.exe 复制并粘贴到安装 GroundRunner 二进制文件的目录中。
- 要重新启动 GroundRunner 服务,请在 CLI 中输入以下命令:
cd /home/<username> /wdata/内容
./GroundRunner
卸载 GroundRunner
如果您不再需要 GroundRunner,您可以将其卸载。
- 停止 GroundRunner 服务。
- 如果作为服务运行,请使用 Windows 服务管理器或在 CLI 中输入命令
sc stop GroundRunner
。 - 如果作为前台进程运行,请按下按键序列 <ctrl><c>。
- 如果作为服务运行,请使用 Windows 服务管理器或在 CLI 中输入命令
- 在 CLI 中,以管理员身份输入命令
installer.exe uninstall
。 - 删除
GroundRunner
可执行目录。
在 CLI 中,停止 GroundRunner 服务并删除其可执行目录(例如 /home/<username>请参阅 /wdata/Contents
)。
GroundRunner 配置设置和出站域
为了能够与其数据源进行通信,您可能需要在安装 GroundRunner 的服务器上打开防火墙端口。要更改某些 GroundRunners 的配置设置,您可以编辑安装二进制文件的目 录中的 GroundRunner.config 文件。
配置 | 设置 |
---|---|
港口 |
0 至 65535。 默认情况下,GroundRunners 使用端口 8821 相互通信。但是,仅当不同服务器上的 GroundRunners 在您的网络内共享命令输出时才需要端口。 |
公司代币 | 保留默认值,除非 GroundRunner 为不同的租户配置。 |
日志级别 | 信息 或 调试 |
协议 | 保留默认设置。 |
HTTP_PROXY_URL |
如果使用代理服务器,请输入其 URL 和端口(如有必要)。例如, 注意: GroundRunners 可以使用代理服务器,但不能使用通过新技术 LAN 管理器 (NTLM) 进行身份验证的代理服务器。相反,允许服务器的 IP 地址。 |
长轮询 | 如果使用代理服务器,请设置为 true 以指示运行器使用长轮询来检索命令。为了确保性能,仅当代理服务器或防火墙不支持 Web 套接字时才使用长轮询。 |
无代理 | 要绕过代理服务器,请提供要直接访问的主机(以逗号分隔)列表。要根据常见模式包含多个主机,请使用 * 通配符。 |
GROUNDRUNNER_CERT |
如果使用多个 GroundRunner 并希望向第二个 GroundRunner 发送加密信息,则需要这样做。必须与 PORT结合使用。 激活运行器时,您还必须将 PROTOCOL 字段指定为 HTTPS。 |
GROUNDRUNNER_CERT_KEY | 如果使用多个 GroundRunner 并希望从第二个 GroundRunner 接收加密信息则需要。还必须与 PORT一起使用。 |
DISABLE_WEBSOCKETS | 运行转换需要 Websockets。当禁用时,任何使用转换的命令都将被完全跳过。 |
注意:您的自签名证书必须具有主题备用名称(SAN)。如果没有,当您的 GroundRunner 尝试下载文件时,它将显示一条引用缺少 SAN 的错误消息。
如果您的网络必须 允许出站域,则这些适用于 GroundRunners:
领域 | 目的 |
---|---|
|
常见 Workiva 服务的主要子域名,包括 Wdata。 |
*.wdesk.com |
生产 Workiva 平台的主要域。 |
*.*.wdesk.com |
Workiva 平台中支持组件的子域。 |
安全
GroundRunners 从不收集或汇总数据;他们仅在传输过程中保留数据。扩展验证 (EV) 证书始终通过 DigiCert® 加密并保护 GroundRunner 与其数据源之间的流量。
注意: 为了保护本地数据,CloudRunners 可以与 GroundRunners 共享输出,但 GroundRunners 不能与 CloudRunner 共享文件输出。
排除 GroundRunner 错误故障
如果在链运行时收到这些错误,请检查命令的 GroundRunners。
提示: 为了帮助简化故障排除,您可以创建一个链来 自动将 GroundRunner 的日志文件 下载到表中。
错误信息 | 原因 | 解决 |
---|---|---|
无法与代理通信——该命令未执行 |
该命令无法与其 GroundRunner 通信。 如果发生这种情况,则表示 GroundRunner 没有启动,或者 GroundRunner 和 Chain Builder 之间发生了网络中断。 |
核实:
|
无法下载与命令相关的资源。如果错误仍然存在,请联系支持。 |
与这些链的命令相关的运行器无法相互通信。 当命令使用不同的运行器并且 CloudRunner 尝试使用基于 GroundRunner 的命令的文件输出时,通常会发生这种情况。 |
对链中的所有命令使用相同的运行器。 如果链的命令需要多个运行器,请验证没有使用 GroundRunners 的命令将文件输出传递给使用 CloudRunner 的命令。 |
启动命令时出错:exec:\"\\[connector].exe\":文件不存在" commandExecutorId=[ID] | 恶意软件或防病毒应用程序错误地识别了连接器并拦截了其与 GroundRunner 的通信。 | 从应用程序的扫描中排除 GroundRunner 安装目录。 |
证书错误 | 使用自签名证书 |
在许多情况下,使用自签名证书加密 GroundRunner 通信会很方便。如果您使用的是自签名证书,请确保证书的 通用名称 与可访问服务器的 URL 相匹配。 例如,如果您的 GroundRunner 正在监听端口 8821 并且您可以从网络 localhost访问服务器,则证 书的 通用名称 将是 localhost。 |
间歇性链故障,错误: “对等方重置连接” |
当同一台机器上安装多个运行器时,每个运行器必须具有唯一的 GUID。 如果使用相同的 GUID,运行器可能会重叠并进入更新循环——导致偶尔的链故障。 |
我们建议完全重新安装 GroundRunner。
|
GroundRunner 上跳过了命令,但 CloudRunner 上成功了 | 运行转换需要 Websockets。当 websockets 被禁用时,任何转换都将被完全跳过。 |
打开您的配置文件并设置
|