Workiva 支援中心

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

然後，您可以安裝 GroundRunner：

1. 在 Windows 命令視窗中，輸入

   c:\Program Files (x86)\wdata\installer.exe install

   並接受所有預設設定。
   • 為 init 系統選取「Windows」。
     

     您需要指定 GroundRunner 作為 Windows 服務運作，才能支援自動更新。GroundRunners 應僅當成服務執行，測試用途除外。

   • 對於路徑，請在新目錄
     內建立 Files 資料夾（例如 C:\Program Files (x86)\Wdata\Files）。
   • 對於授權主機名稱 (AUTH_HOST)：
     • 對於亞太地區，請輸入 h.apac.wdesk.com/s/chains-reaper。
     • 對於加拿大，請輸入 h.ca.wdesk.com/s/chains-reaper。
     • 對於 EMEA，請輸入 h.eu.wdesk.com/s/chains-reaper。
     • 對於美國、中美洲和南美洲，請輸入 h.app.wdesk.com/s/chains-reaper。
   • 輸入您的 公司代碼。
2. 從目錄中刪除 GroundRunner 可執行檔目錄以外的所有檔案。
3. 選取將 GroundRunner 當成服務或前景流程執行。
   • 如果以服務方式執行，請執行下列其中一項：
     • 在命令對話方塊中，輸入 sc start GroundRunner。
     • 在 Windows Service Manager 中，啟動 GroundRunner服務。
   • 如果當做前景流程執行，請在命令對話方塊中輸入：

     cd c:\Program Files (x86)\wdata GroundRunner.exe

您的 GroundRunner 現在已安裝完畢並可以啟動。

步驟 1. 安裝 GroundRunner

1. 將 GroundRunner 的安裝檔案下載到自己的目錄，
   例如： /home/user_name/wdata/。

   注意： 「/home/user_name/wdata」僅作為範例。請遵循組織的服務安裝位置政策。

2. 在命令對話方塊中，使用以下程式解壓縮安裝檔案：
   

   unzip GroundRunner.zip

3. 輸入 GroundRunner 的詳細資料。
   1. 輸入 ./installer install
   2. 對於授權主機名稱 (AUTH_HOST)：
      • 對於亞太地區，請輸入 h.apac.wdesk.com/s/chains-reaper。
      • 對於加拿大，請輸入 h.ca.wdesk.com/s/chains-reaper。
      • 對於 EMEA，請輸入 h.eu.wdesk.com/s/chains-reaper。
      • 對於美國、中美洲和南美洲，請輸入 h.app.wdesk.com/s/chains-reaper。
   3. 輸入您的 公司代碼。
4. 請從目錄中刪除所有檔案，但在安裝過程中建立的資料夾除外。

步驟 2. 將您的 GroundRunner 設定為 systemd 服務 (Linux)

為了確保 GroundRunner 自動更新正常運作，並為了讓 GroundRunner 保持良好狀態，需要將 GroundRunner 安裝為啟用、可重新啟動的 systemd 服務。請參閱作業系統的文件和組織政策，了解如何將 GroundRunner 作為 systemd 服務執行。

對於基本配置，為了使自動更新正常工作，我們有以下 systemd 單元檔案要求：

• 確保 ExecStart 可執行檔指向 GroundRunnerMonitor 二進製文件，而不是
  GroundRunner 二進製文件。
• 設定 Restart=always。
• 請勿設定 StartLimitBurst 或 StartLimitIntervalSec，否則可能會因為暫時性錯誤而導致 GroundRunner 無法重新啟動。如果您不希望 GroundRunner 進入快速重新啟動循環，您可以設定 RestartSec。
• 輸入 systemctl enable 以啟用 systemd GroundRunner 服務單位，以便 GroundRunner 在重新啟動後也能正常使用。

Workiva 不正式支援將 GroundRunner 當成前景流程執行。這對於測試設定可能很有用，但一旦設定 GroundRunner，就應將其設定為長期存在的後台流程。

在 macOS 上操作 GroundRunners（僅限測試）

Workiva 在 macOS 上支援 GroundRunners，僅用於測試目的。雖然 macOS GroundRunner 能夠執行與 Linux 和 Windows 版本相同的命令，但 Workiva 並未正式支援將 Launchd 作為有效的服務管理員。這是因為 Apple 在 2022 年中止了對其 macOS 伺服器軟體的支援。Apple 膝上型電腦和桌上型電腦不適合執行 GroundRunners。