請按照以下說明將主機上的 GroundRunner 和 GroundRunnerMonitor 二進位檔替換為較新版本。
重要規劃附註
- GroundRunner 服務不支援正常關機。服務停止後,任何進行中的作業都會立即終止。這些操作的結果將會遺失,並且需要重新執行命令。
- 因為停止服務會造成乾擾,我們強烈建議您在執行更新之前與利害關係人協調部署時段,並確保維護期間沒有正在執行或計劃執行的關鍵作業。
必要條件(所有平台)
- 檢查您是否需要更新。目前的版本(截至 2026 年 6 月 1 日)是 9.21.1。
請參閱 如何檢查 GroundRunner 的版本? 以了解您使用的 GroundRunner 版本。
如果您的 GroundRunner 已過期,將會顯示以下橫幅。 - 如果您的 GroundRunner 已過期,請記錄在 版本 欄位中顯示的版本號。
對於 Windows 平台
- Windows
GroundRunner.zip,取自 Workiva。
(有關詳細資訊,請參閱 安裝和管理 GroundRunners 。) - 兩者的系統管理員權限:
- 安裝 GroundRunner 的電腦。
- 二進位檔的安裝目錄。
- 停止和啟動 GroundRunner 服務的權限。
針對 Linux 平台
- Windows
GroundRunner.zip,取自 Workiva。
(有關詳細資訊,請參閱 安裝和管理 GroundRunners 。) - Linux 公用程式
unzip(1)、tar(1)和gzip(1)必須安裝(這些是大多數安裝的標準功能)。 - 檔案所有權權限 (chown)。
- 兩者的系統管理員權限:
- 安裝 GroundRunner 的電腦。
- 二進位檔的安裝目錄。
- 停止和啟動 GroundRunner 服務的權限。
Windows 安裝
- 將
GroundRunner.zip解壓縮到臨時目錄。 - 開啟 Services 主控台:按
Win + R,鍵入services.msc,然後按 Enter。 - 在清單中找到 GroundRunner 並以右鍵按一下,然後選取 Stop。
- 請等待狀態顯示 Stopped。
- 備份現有的二進位檔。
在檔案總管中,導覽至 GroundRunner 安裝目錄並將GroundRunner.exe和GroundRunnerMonitor.exe以及任何配置檔案複製到備份位置(例如將它們重新命名為GroundRunner.exe.bak]和GroundRunnerMonitor.exe.bak)。 - 透過將
GroundRunner.exe和GroundRunnerMonitor.exe從解壓縮後的目錄複製到安裝目錄中來取代二進位檔,覆寫現有檔案。 - 返回 Services 主控台,右鍵按一下 GroundRunner 並選取 Start。
- 驗證狀態是否顯示 正在執行。
Linux (systemd) 安裝
這些指示信息適用於標準的非安全性增強型 Linux 系統。如果您的主機執行 SELinux、AppArmor 或其他安全軟體,請參閱本部分結尾的 強制存取控制 (SELinux / AppArmor) 。
-
擷取 Zip 檔案中的人工製品。
注意: 將 zip 檔案解壓縮到
/tmp/groundrunner-update僅用於示範目的。您可以將 Zip 檔案擷取至最符合您組織政策的任何位置。unzip GroundRunner.zip -d /tmp/groundrunner-update
-
停止正在執行的流程。如果使用 systemd,請使用以下命令:
sudo systemctl stop<service-name>
重要注意事項: 如果您 未將 GroundRunner 設定為 systemd 服務,請在 [ 執行更新之前 將其設定為 systemd 服務。有關如何配置 systemd 服務的說明文件,請參閱您的 Linux 發行版本說明文件。如果您使用的是非 systemd 的 Linux 發行版,請參閱發行版的文件。
-
備份 GroundRunner 目錄中的二進位檔案和設定:
cd /path_to_groundrunner_install_dir tar czvf groundrunner.bak.tar.gz GroundRunner* *config config* Monitor.version
注意: 您可以備份整個安裝目錄(即包括日誌和其他資料夾/檔案)但這可能會建立非常大的備份檔案。
-
取代二進位檔:
cd /path_to_groundrunner_install_dir cp /tmp/groundrunner-update/GroundRunner . cp /tmp/groundrunner-update/GroundRunnerMonitor .
-
設定可執行權限:
chmod +x GroundRunner GroundRunnerMonitor
注意: 如果您的 GroundRunner 由特定的系統使用者執行,您可能需要
chown新的可執行檔。 -
啟動服務:
sudo systemctl start<service-name>
-
檢查服務的狀態以確保其正常:
sudo systemctl status<service-name>
-
清理:
rm -rf /tmp/groundrunner-update
強制存取控制 (SELinux / AppArmor)
如果主機強制實施強制存取控制政策(SELinux、AppArmor 或類似政策),取代磁碟上的二進位檔可能會導致服務失敗。
請參閱發行版本的文件,以管理與自訂服務相關的安全性原則。
注意: 其他安全軟體 — 例如 FAPOLICYD、IMA/EVM 或自訂檔案完整性監控 — 也可能會封鎖被取代的二進位檔的執行。如果服務在更新後無法啟動,且您已排除 SELinux/AppArmor,請檢查系統上是否有任何其他安全架構需要更新的信任清單或檔案簽名。
驗證
您可以按照 如何檢查 GroundRunner 的狀態中提供的說明確認 GroundRunner 是否處於使用中及其版本是否正確。
我們鼓勵您建立並執行「試驗鏈結」,在 GroundRunner 上執行一組測試命令,以確保正確安裝。
我們也建議您在更新並重新啟動系統後立即監控 GroundRunner 的活動。這可讓您確信它正在正確執行。您可以使用 CLI 命令即時串流並檢視新的記錄項目。
針對 Windows
若要使用 PowerShell 檢視記錄檔案的結尾,請輸入以下內容:
Get-Content -Path "C:\path_to_\output.log" -Tail 10 -Wait
這會讓 PowerShell 視窗保持開啟狀態,並即時串流新的記錄檔。 -tail 10 立即載入最後 10 行。
針對 Linux
要檢視記錄檔案的結尾並即時串流新項目,請輸入以下內容:
tail -f /path_to/output.log
復原
如果新版本無法正常運作,您可以按照以下步驟回滾到先前的版本:
- 如前所述停止 GroundRunner 服務。
- 將已安裝的
GroundRunner.exe和GroundRunnerMonitor.exe檔案重新命名。 - 將
GroundRunner.exe.bak和GroundRunnerMonitor.exe.bak從備份位置複製到安裝目錄。 - 透過移除「.bak」延伸檔名來重新命名這些檔案。
- 請按照上述適當步驟重新啟動 GroundRunner 服務。
注意: 這些相同的說明適用於 Linux GroundRunner,但您需要從備份的 tar 壓縮球中解壓縮二進位檔。
附註
- 不要重新命名這些二進位檔。自動升級機制依賴於預設的可執行文件名稱(在 Linux 上為
GroundRunner和GroundRunnerMonitor,在 Windows 上為GroundRunner.exe和GroundRunnerMonitor.exe)來偵測和套用 Future個更新。重新命名將中斷自動升級。 - macOS 僅受支援用於開發目的。它不是受支援的生產平台。
- 其他服務管理員: 上面的範例使用 systemd (Linux) 和 Windows 服務控制管理員。如果您的環境使用其他服務管理員或流程監督工具,請為您的配置執行相同的停止、取代和啟動步驟。
- 預設情況下,GroundRunners 使用本機管理帳戶,無法存取共用磁碟機等遠端資源。若要存取共用資源 (如 Windows UNC 路徑),請使用具有該資源足夠特權的使用者帳戶,啟動 GroundRunner。如果使用預設本機系統管理員以外的使用者帳戶,請授予其管理 GroundRunner 安裝目錄的權限以啟用自動更新。