安裝和管理 GroundRunners

GroundRunners 使鏈式命令能夠與本地系統或無法通過 Internet 訪問的遠端數據源進行互動。它們通常由 IT 專業人員或熟悉組織網路設置的人員安裝在專用伺服器上，例如託管連接數據源的伺服器。

在設置 GroundRunner 之前，我們建議查看 Chain Builder 安全架構。

要求

GroundRunner 需要 Java 版本 8 和支援的作業系統。如果 GroundRunner 將存取共享資源（如 Windows 通用命名約定（UNC）路徑），則還需要具有足夠許可權的用戶帳戶。

GroundRunners 只能在 Java 版本 8 上運行。

Java 版本 8 可以直接從 Oracle® 或 OpenJDK 下載。下載后，將其安裝在PATH變數中，以在命令提示符下通過 java 啟用全域訪問。安裝 Java 或編輯其組態後，請將伺服器重新開機。

注意：安裝 Java 時，系統可能會詢問您是要安裝 Java Development Kit (JDK) 或 Java Runtime Environment (JRE)。GroundRunner 只需 JRE。

如果使用自簽章憑證或非由憑證頒發機構頒發的證書，請將其匯入 Java 金鑰庫以啟用 Java/SSL 安全性：

請與IT管理員聯繫，獲取用於保護網站的證書副本，或從瀏覽器中匯出該證書。
將憑證複製到您安裝的 GroundRunner 中。

在 CLI 中，將證書匯入 Java 金鑰庫。例如：

keytool -import -trustcacerts -keystore "C:\Program Files\Java\jre1.8.0_251\lib\security\cacerts" -storepass changeit -noprompt -alias [alias name] -file [path_to_exported_file]

GroundRunner 支援下列作業系統，不從屬外部檔案庫：

Microsoft Windows® Desktop 10，32 和 64 位元
Microsoft Windows® Server 2012、2012 R2、2016、2019 和 2022
Linux® Redhat 和 Ubuntu
macOS® Mojave 或更新版本

雖然 GroundRunner 需要的伺服器資源有限，但建議至少使用：

512 MB 可用隨機存取記憶體 (RAM)
100 GB 可用磁碟空間

注意：為了幫助計算所需的磁碟空間，請注意，包含五個命令的鏈，每個命令產生 10MB 的臨時輸出，需要 50MB 才能完成。

建議的主機組態包括採用下列項目配置的虛擬主機：

二到四個處理器
8 GB 系統記憶體
固態硬碟 (SSD) 儲存裝置

此伺服器必須 24/7 全天候可用才能與 GroundRunner 通信。

默認情況下，GroundRunner 使用本地管理帳戶，無法充分訪問遠端資源（如共用驅動器）。

若要存取共用資源 (如 Windows UNC 路徑)，請使用具有該資源足夠特權的使用者帳戶，啟動 GroundRunner。如果使用預設本地系統管理員以外的用戶帳戶，請授予其管理 GroundRunner 安裝目錄的許可權以啟用自動更新。

下載 GroundRunner

若要下載 GroundRunner 以安裝或手動更新：

在 Chain Builder 中，從側邊欄中選擇設置設置 。
按一下頂端的 [下載]。
找到適用於您作業系統的 GroundRunner，然後按一下右邊的 [下載]。

安裝 GroundRunner

Microsoft 安裝程式（MSI）需要 .NET 3.5 或更高版本。如果無法滿足此要求，請改為通過命令行介面安裝 GroundRunner。

要安裝 GroundRunner，請執行以下操作：

解壓縮 windows_amd64_ground_runner.zip 檔。
運行 GroundRunner.msi 以啟動 GroundRunner 安裝嚮導。
按一下「繼續」(Next)。
查看並接受授權協議中的條款，然後按 [下一步]。
對於目標資料夾，輸入 GroundRunner 的安裝路徑（例如 C：\Program Files\GroundRunner\），然後按下一步。
在 [平台公司代碼] 中，輸入您的公司代碼。
在 [平台授權主機] 中：
- 如果在北美，請輸入 h.app.wdesk.com/s/wdata/oc/app
- 如果在歐洲，請輸入 h.eu.wdesk.com/s/wdata/oc/app
- 如果在APAC中，請輸入 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
  - 如果在APAC中，請輸入 h.apac.wdesk.com/s/wdata/oc/app
- 輸入您的公司令牌。
從目錄中刪除除 GroundRunner 可執行文件目錄之外的所有檔。
選取將 GroundRunner 當成服務或前景流程執行。
- 如果作為服務運行，請執行下列操作之一：
  - 在 CLI 中，輸入命令 sc start GroundRunner
  - 在 Windows 服務管理器中，啟動 HostRunner 服務
- 如果作為前臺進程運行，請在 CLI 中輸入以下命令：
```
cd c：\Program Files （x86）\wdata GroundRunner.exe
```

您的 GroundRunner 現已安裝並準備好啟動。

步驟 1. 安裝 GroundRunner

將 GroundRunner 的安裝檔案下載到專屬目錄，例如 /home//wdata/。
在 CLI 中，解壓縮安裝檔：
- 對於 Linux，請使用命令 unzip linux_amd64_ground_runner.zip
- 對於macOS，請使用命令 unzip GroundRunner.zip
輸入 GroundRunner 的詳細資料。
- 對於 Linux 和 Mac OS，請使用命令 ./installer install
- 對於授權主機名稱 (AUTH_HOST)：
  - 如果在北美，請輸入 h.app.wdesk.com/s/wdata/oc/app
  - 如果在歐洲，請輸入 h.eu.wdesk.com/s/wdata/oc/app
  - 如果在APAC中，請輸入 h.apac.wdesk.com/s/wdata/oc/app
- 輸入您的公司令牌。
從目錄中刪除 GroundRunner 可執行檔目錄以外的所有檔案。

步驟 2. 選取要當成服務或前台流程執行

在 CLI 中，輸入以下命令以將 GroundRunner 作為後台服務或前台進程運行。

後台服務

如果從預設的 OS init 程式執行，則可以將其作為後台服務運行：

/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 Services Manager 中，停止 GroundRunner 服務。
將下載的 GroundRunner 安裝檔案移至專屬目錄，例如 c:\groundrunner_upgrade，然後解壓縮其中的檔案。
將 GroundRunner.exe 和 GroundRunnerMonitor.exe 複製並粘貼到安裝 GroundRunner 二進位文件的目錄。
在 Windows Services Manager 中，重新啟動 GroundRunner 服務。

下載適用於您作業系統的最新 GroundRunner。
在託管 GroundRunner 的伺服器上，轉到運行服務的目錄。
在 CLI 中，停止 GroundRunner 服務。
將下載的 GroundRunner 安裝檔案移至專屬目錄，例如 /home//groundrunner_upgrade/，然後解壓縮其中的檔案。
將 GroundRunner.exe 和 GroundRunnerMonitor.exe 複製並粘貼到安裝 GroundRunner 二進位文件的目錄。
要重新啟動 GroundRunner 服務，請在 CLI 中輸入以下命令：
```
cd /home/<username>/wdata/Contents
./GroundRunner
```

解除安裝 GroundRunner

如果您不再需要 GroundRunner，可以將其解除安裝。

在“Windows 設置”中，轉到“應用和功能”，選擇“GroundRunner（64 位）”，然後按兩下“卸載”。

停止 GroundRunner 服務。
- 如果作為服務運行，請使用 Windows 服務管理員或在 CLI 中輸入命令 sc stop GroundRunner。
- 如果當成前景流程執行，請按便捷鍵。
在 CLI 中，以系統管理員身分輸入命令 installer.exe uninstall。
刪除 GroundRunner 可執行檔目錄。

在 CLI 中，停止 GroundRunner 服務並刪除其可執行目錄（例如 /home/<username>/wdata/Contents）。

GroundRunner 組態設定與外寄網域

若要能與其資料來源通訊，您可能必須在安裝 GroundRunner 的伺服器上開啟防火牆連接埠。若要更改某些 GroundRunner 的配置設置，可以在二進位檔安裝目錄中編輯 GroundRunner.config 檔。

組態	設定
連接埠	0 到 65535。 GroundRunner 預設使用連接埠 8821 彼此通訊。但只在不同伺服器上的 GroundRunner 在網路內共用命令輸出時，才需要連接埠。
COMPANY_TOKEN	保留預設值，除非為其他租戶配置了 GroundRunner。
LOG_LEVEL	資訊或調試
PROTOCOL	保留為預設值。
HTTP_PROXY_URL	如果使用代理伺服器，請輸入其 URL 和埠（如有必要）。例如 `http://yourproxy:3000` 注意： GroundRunner 可以使用代理伺服器，但不能使用通過新技術 LAN 管理員（NTLM）進行身份驗證的伺服器。而是將伺服器的 IP 位址列入白名單。
LONG_POLL	如果使用 Proxy 伺服器，請設定為 true，指示執行器使用長輪詢來擷取命令。為了確保效能，請只在 Proxy 伺服器或防火牆不支援 Web 通訊端時，使用長輪詢。
NO_PROXY	若要略過 Proxy 伺服器，請改為提供以逗號分隔的主機清單，直接連線。若要根據通用模式加入多個主機，請使用 * 萬用字元。
GROUNDRUNNER_CERT	使用多個 GroundRunner，並希望將加密的資訊傳送給第二個 GroundRunner 時需要。必須與 PORT 結合使用。激活運行器時，還必須將 PROTOCOL 欄位指定為 HTTPS。
GROUNDRUNNER_CERT_KEY	使用多個 GroundRunner，並希望接收來自第二個 GroundRunner 的加密資訊時需要。還必須與 PORT 結合使用。

注意：您的自簽名證書必須具有使用者備用名稱（SAN）。如果沒有，GroundRunner 嘗試下載檔案時，會顯示一則錯誤訊息，指出遺漏 SAN。

如果您的網路必須允許外寄網域，下列網域適用於 GroundRunner：

網域	目的
`h.app.wdesk.com` `h.eu.wdesk.com` `h.apac.wdesk.com`	常見 Workiva 服務（包括 Wdata）的主要子域。
`*.wdesk.com`	生產Workiva平臺的主域。
`..wdesk.com`	Workiva 平臺中支援元件的子域。

安全性

GroundRunners 從不收集或匯總數據;它們僅在傳輸過程中保留數據。擴充功能驗證 (EV) 憑證一律透過 DigiCert®，加密和保護 GroundRunner 與其資料來源之間的流量。

注意：為了保護本地數據，CloudRunners 可以與 GroundRunners 共享輸出，但 GroundRunners 不能與 CloudRunner 共用文件輸出。

疑難排解 GroundRunner 錯誤

如果在鏈運行時收到這些錯誤，請檢查命令的 GroundRunners。

提示：為了協助簡化疑難排解，您可以建立鏈結，自動下載 GroundRunner 的記錄檔案至表格中。

錯誤訊息	原因	解決方法
與代理程式通訊失敗，未執行此命令	此命令無法與其 GroundRunner 通訊。如果發生這種情況，則 GroundRunner 未啟動，或者 GroundRunner 和 Chain Builder 之間發生網路中斷。	請確認： GroundRunner 的服務正在運作。 GroundRunner 的伺服器已連接到網路。
無法下載與命令相關聯的資源。如果仍發生錯誤，請聯絡支援人員。	與這些鏈的命令關聯的運行器無法相互通信。當命令使用不同的運行器並且 CloudRunner 嘗試使用基於 GroundRunner 的命令的文件輸出時，通常會發生這種情況。	對鏈中的所有命令使用相同的運行器。如果鏈的命令需要多個運行器，請驗證 GroundRunners 的命令不會將文件輸出傳遞給使用 CloudRunner 的命令。
啟動命令時出現錯誤：exec: \"\\[connector].exe\": file does not exist" commandExecutorId=[ID]	惡意軟體或防毒應用程式錯誤辨識連接器，並攔截其與 GroundRunner 的通訊。	從應用程式的掃描中排除 GroundRunner 安裝目錄。
憑證錯誤	使用自我簽署憑證	在許多情況下，使用自我簽署憑證加密 GroundRunner 通訊很方便。如果使用的是自簽名證書，請確保證書的公用名與可以訪問伺服器的URL匹配。舉例來說，如果您的 GroundRunner 正在偵聽連接埠 8821，且您可以從網路 localhost 存取伺服器，則憑證的通用名稱會是 localhost。
間歇性鏈結失敗並顯示錯誤：「同儕重設連線」	在相同電腦上安裝多個執行器時，每個執行器都需有不重複的 GUID。如果使用相同 GUID，執行器可能會重複並進入更新循環，導致偶爾鏈結失敗。	建議完全重新安裝 GroundRunner。

其他資源

說明

社群

學習中心 (Learning Hub)

支援

要求

注意：安裝 Java 時，系統可能會詢問您是要安裝 Java Development Kit (JDK) 或 Java Runtime Environment (JRE)。GroundRunner 只需 JRE。

注意：為了幫助計算所需的磁碟空間，請注意，包含五個命令的鏈，每個命令產生 10MB 的臨時輸出，需要 50MB 才能完成。

下載 GroundRunner

安裝 GroundRunner

步驟 1. 安裝 GroundRunner

步驟 2. 選取要當成服務或前台流程執行

啟動 GroundRunner

手動更新 GroundRunner

解除安裝 GroundRunner

GroundRunner 組態設定與外寄網域

注意： GroundRunner 可以使用代理伺服器，但不能使用通過新技術 LAN 管理員（NTLM）進行身份驗證的伺服器。而是將伺服器的 IP 位址列入白名單。

注意：您的自簽名證書必須具有使用者備用名稱（SAN）。如果沒有，GroundRunner 嘗試下載檔案時，會顯示一則錯誤訊息，指出遺漏 SAN。

安全性

注意：為了保護本地數據，CloudRunners 可以與 GroundRunners 共享輸出，但 GroundRunners 不能與 CloudRunner 共用文件輸出。

疑難排解 GroundRunner 錯誤

提示：為了協助簡化疑難排解，您可以建立鏈結，自動下載 GroundRunner 的記錄檔案至表格中。

其他資源

要求

注意：安裝 Java 時，系統可能會詢問您是要安裝 Java Development Kit (JDK) 或 Java Runtime Environment (JRE)。GroundRunner 只需 JRE。

注意： 為了幫助計算所需的磁碟空間，請注意，包含五個命令的鏈，每個命令產生 10MB 的臨時輸出，需要 50MB 才能完成。

下載 GroundRunner

安裝 GroundRunner

步驟 1. 安裝 GroundRunner

步驟 2. 選取要當成服務或前台流程執行

啟動 GroundRunner

手動更新 GroundRunner

解除安裝 GroundRunner

GroundRunner 組態設定與外寄網域

注意： GroundRunner 可以使用代理伺服器，但不能使用通過新技術 LAN 管理員 （NTLM） 進行身份驗證的伺服器。而是將伺服器的 IP 位址列入白名單。

注意：您的自簽名證書必須具有使用者備用名稱 （SAN）。如果沒有，GroundRunner 嘗試下載檔案時，會顯示一則錯誤訊息，指出遺漏 SAN。

安全性

注意： 為了保護本地數據，CloudRunners 可以與 GroundRunners 共享輸出，但 GroundRunners 不能與 CloudRunner 共用文件輸出。

疑難排解 GroundRunner 錯誤

提示：為了協助簡化疑難排解，您可以建立鏈結，自動下載 GroundRunner 的記錄檔案至表格中。

其他資源

注意：為了幫助計算所需的磁碟空間，請注意，包含五個命令的鏈，每個命令產生 10MB 的臨時輸出，需要 50MB 才能完成。

注意： GroundRunner 可以使用代理伺服器，但不能使用通過新技術 LAN 管理員（NTLM）進行身份驗證的伺服器。而是將伺服器的 IP 位址列入白名單。

注意：您的自簽名證書必須具有使用者備用名稱（SAN）。如果沒有，GroundRunner 嘗試下載檔案時，會顯示一則錯誤訊息，指出遺漏 SAN。

注意：為了保護本地數據，CloudRunners 可以與 GroundRunners 共享輸出，但 GroundRunners 不能與 CloudRunner 共用文件輸出。