安裝與管理 GroundRunners

GroundRunner 讓鏈命令能夠與無法透過網路存取的本機系統或遠端資料來源進行互動。它們通常由 IT 專業人員或熟悉組織網路設定的人員安裝在專用伺服器上，例如託管連接的資料來源的伺服器。

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

要求

需要相容的作業系統，如果您的 GroundRunner 將存取共用資源，例如 Windows 通用命名約定 (UNC) 路徑，則還需要具有足夠權限的使用者帳戶。

Java 執行時期環境 (JRE) 根據 GPL v2 獲得許可，但受到類路徑異常的保護。

注意：若要在 Java 安裝中使用自訂證書，或乾脆不使用 Workiva 的共用程式庫，請參閱我們的在 GroundRunners 中使用自訂憑證文章。

目前，GroundRunners 可以安裝在以下作業系統系列上，無需外部程式庫依賴：

Windows 和 Windows 伺服器
macOS
Linux 發行版和衍生性商品
紅帽、Fedora、AmazonLinux
Debian/Ubuntu

Workiva 致力於支援上述列出的作業系統系列的所有現代版本。但是，我們無法支援任何已被供應商指定為「生命週期終止」的作業系統。這些較舊的作業系統有潛在的安全風險，應盡快更新至目前版本。詳細了解我們的報廢政策。

注意：每個作業系統的支援計劃均由各個供應商設定。例如，微軟對Windows 7的支援於2020年1月14日結束； Workiva 對 Windows 7 的支援也於同一天結束。

硬體需求

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

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

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

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

兩到四個處理器

注意：基於 ARM 的處理器與 GroundRunner 不相容。
8 GB 系統記憶體
固態硬碟 (SSD) 儲存裝置

此伺服器必須全天候 (24/7) 可用才能與 GroundRunner 進行通訊。

預設情況下，GroundRunners 使用本機管理帳戶，無法存取遠端資源（例如共用磁碟機）。

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

下載地面奔跑者

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

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

安裝地面跑步者

Microsoft 安裝程式 (MSI) 需要 .NET 3.5 或更高版本。如果您無法滿足此要求，請改為透過命令列介面安裝 GroundRunner。

安裝 GroundRunner：

解壓縮 windows_amd64_ground_runner.zip 檔。
執行 GroundRunner.msi 以啟動 GroundRunner 設定精靈。
按一下「繼續」(Next)。
查看並接受授權協議中的條款，然後按 [下一步]。
對於目標資料夾，輸入將安裝 GroundRunner 的路徑（例如 C:\Program Files\GroundRunner\），然後按一下 Next。
在 [平台公司代碼] 中，輸入您的公司代碼。
在 [平台授權主機] 中：
- 若在北美，請輸入 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，然後選擇 Start。

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

若要透過命令列介面安裝，您必須將 GroundRunner 的安裝下載至程式檔案中自己的目錄（例如 c:\Program Files (x86)\wdata）。然後您可以解壓縮安裝檔案並將其解壓縮到目錄的根目錄。

然後您可以安裝 GroundRunner ：

從 Windows CLI 中，執行指令 c:\Program Files (x86)\wdata\installer.exe install 並接受所有預設值。
- 對於路徑，在新目錄中建立 Files 資料夾（例如 C:\Program Files (x86)\Wdat\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
- 輸入您的公司令牌。
刪除該目錄中除 GroundRunner 執行檔目錄之外的所有檔案。
選取將 GroundRunner 當成服務或前景流程執行。
- 如果作為服務運行，請執行下列操作之一：
  - 在 CLI 中輸入指令 sc start GroundRunner
  - 在 Windows 服務管理員中，啟動 HostRunner 服務
- 如果作為前台進程運行，請在 CLI 中輸入以下命令：
```
cd c:\Program Files (x86)\wdata GroundRunner.exe
```

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

步驟 1. 安裝 GroundRunner

將 GroundRunner 的安裝檔案下載到專屬目錄，例如 /home/<username>/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
  - 若在亞太地區，請輸入 h.apac.wdesk.com/s/wdata/oc/app
- 輸入您的公司令牌。
從目錄中刪除 GroundRunner 可執行檔目錄以外的所有檔案。

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

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

後台服務

如果從預設作業系統 init 程式執行，您可以將其作為後台服務運行：

/home/[使用者名稱]/wdata/Contents/GroundRunnerMonitor

前台進程

若要將其作為前台進程運行並將日誌寫入控制台：

cd home/[使用者名稱]/wdata/目錄 sudo ./GroundRunner

要將其作為前台進程運行並將日誌寫入日誌檔案：

cd home/[使用者名稱]/wdata/目錄 sudo ./GroundRunnerMonitor

啟動地面奔跑者

安裝 GroundRunner 後，您必須在 Chain Builder 中啟動它。

在 Chain Builder 中，從側邊欄中選擇設定設定。
按一下頂端的 [執行器]。
在 Pending Registration下，輸入跑步者的簡短描述性名稱（例如 <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/<username>/groundrunner_upgrade/，然後解壓縮其中的檔案。
將 GroundRunner.exe 和 GroundRunnerMonitor.exe 複製並貼上到 GroundRunner 二進位檔案的安裝目錄。
若要重新啟動 GroundRunner 服務，請在 CLI 中輸入下列指令：
```
cd /home/<username> /wdata/目錄
./GroundRunner
```

解除安裝 GroundRunner

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

從 Windows 設定中，前往 應用程式和功能，選擇 GroundRunner (64 位元)，然後按卸載。

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

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

GroundRunner 組態設定與外寄網域

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

組態	設定
連接埠	0 到 65535。 GroundRunner 預設使用連接埠 8821 彼此通訊。但只在不同伺服器上的 GroundRunner 在網路內共用命令輸出時，才需要連接埠。
COMPANY_TOKEN	保留預設值，除非為不同的租戶配置了 GroundRunner。
LOG_LEVEL	資訊或調試
PROTOCOL	保留預設值。
HTTP_PROXY_URL	如果使用代理伺服器，請輸入其 URL 和連接埠（如有必要）。例如 `http://yourproxy:3000` 注意： GroundRunners 可以使用代理伺服器，但不能使用透過新技術 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結合使用。
DISABLE_WEBSOCKETS	運行轉換需要 Websocket。禁用後，任何使用轉換的命令都將完全跳過。

注意：您的自簽名憑證必須具有使用者備用名稱 (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 的命令的檔案輸出時，通常會發生這種情況。	對鏈中的所有命令使用相同的運行器。如果鏈的命令需要多個運行程序，請驗證沒有使用 GroundRunner 將檔案輸出傳遞給使用 CloudRunner 的命令的命令。
啟動命令時出現錯誤：exec: \"\\[connector].exe\": file does not exist" commandExecutorId=[ID]	惡意軟體或防毒應用程式錯誤辨識連接器，並攔截其與 GroundRunner 的通訊。	從應用程式的掃描中排除 GroundRunner 安裝目錄。
憑證錯誤	使用自我簽署憑證	在許多情況下，使用自我簽署憑證加密 GroundRunner 通訊很方便。如果您使用自簽名證書，請確保證書的公用名稱與可存取伺服器的 URL 相符。舉例來說，如果您的 GroundRunner 正在偵聽連接埠 8821，且您可以從網路 localhost 存取伺服器，則憑證的通用名稱會是 localhost。
間歇性鏈結失敗並顯示錯誤：「同儕重設連線」	在相同電腦上安裝多個執行器時，每個執行器都需有不重複的 GUID。如果使用相同 GUID，執行器可能會重複並進入更新循環，導致偶爾鏈結失敗。	建議完全重新安裝 GroundRunner。
命令在 GroundRunner 上被跳過，但在 CloudRunner 上成功	運行轉換需要 Websocket。當 websocket 被停用時，任何轉換都將被完全跳過。	開啟設定檔並設定 `DISABLE_WEBSOCKETS=false`。

其他資源

協助

社群

學習中心 (Learning Hub)

支援

要求

注意：若要在 Java 安裝中使用自訂證書，或乾脆不使用 Workiva 的共用程式庫，請參閱我們的在 GroundRunners 中使用自訂憑證文章。

注意：每個作業系統的支援計劃均由各個供應商設定。例如，微軟對Windows 7的支援於2020年1月14日結束； Workiva 對 Windows 7 的支援也於同一天結束。

硬體需求

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

注意：基於 ARM 的處理器與 GroundRunner 不相容。

下載地面奔跑者

安裝地面跑步者

步驟 1. 安裝 GroundRunner

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

啟動地面奔跑者

手動更新 GroundRunner

解除安裝 GroundRunner

GroundRunner 組態設定與外寄網域

注意： GroundRunners 可以使用代理伺服器，但不能使用透過新技術 LAN 管理器 (NTLM) 進行驗證的伺服器。相反，允許伺服器的 IP 位址。

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

安全性

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

疑難排解 GroundRunner 錯誤

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

其他資源

要求

注意：若要在 Java 安裝中使用自訂證書，或乾脆不使用 Workiva 的共用程式庫，請參閱我們的 在 GroundRunners 中使用自訂憑證 文章。

注意：每個作業系統的支援計劃均由各個供應商設定。例如，微軟對Windows 7的支援於2020年1月14日結束； Workiva 對 Windows 7 的支援也於同一天結束。

硬體需求

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

注意：基於 ARM 的處理器與 GroundRunner 不相容。

下載地面奔跑者

安裝地面跑步者

步驟 1. 安裝 GroundRunner

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

啟動地面奔跑者

手動更新 GroundRunner

解除安裝 GroundRunner

GroundRunner 組態設定與外寄網域

注意： GroundRunners 可以使用代理伺服器，但不能使用透過新技術 LAN 管理器 (NTLM) 進行驗證的伺服器。相反，允許伺服器的 IP 位址。

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

安全性

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

疑難排解 GroundRunner 錯誤

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

其他資源

注意：若要在 Java 安裝中使用自訂證書，或乾脆不使用 Workiva 的共用程式庫，請參閱我們的在 GroundRunners 中使用自訂憑證文章。

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

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