跳转到主要内容
偶爾你可能會遇到 Gorelo Agent 安裝問題。以下是一些需要考慮的事項。

支援的作業系統

Gorelo 僅支援其供應商(Microsoft 或 Apple)仍在支援的作業系統。

前置條件檢查

Gorelo 為 Windows 與 macOS 提供前置條件檢查。它會確認裝置符合需求且能連線到 Gorelo 的服務,最後顯示明確的 PASS 或 FAIL。 兩個指令稿都會要求你選擇 Gorelo 區域:USW(美國西部)或 AUE(澳洲東部)。接著,指令稿會檢查該區域對應的 Gorelo 伺服器、IoT Hub 與下載來源。以互動方式執行指令稿時,指令稿會提示你選擇區域。若要略過提示(例如無人值守執行),請事先將 GORELO_REGION 環境變數設為 USW 或 AUE。
  1. 在發生 agent 問題的電腦上開啟一個提升權限的 PowerShell 視窗。
  2. 複製下方完整指令稿,貼到視窗中並按 Enter:
gorelo-check-windows.ps1
  1. 出現提示時選擇你的區域(USW 或 AUE)。
  2. 使用下表解決任何失敗項目,並確保你的修復在 PowerShell 工作階段與重新開機後仍然存在。
指令稿也會檢查該區域 IoT Hub 的 DNS 解析(USW 為 gorelo.azure-devices.net,AUE 為 gorelo-aue.azure-devices.net)。如果 IoT Hub 無法解析,指令稿會顯示警告而非失敗。此警告不會阻止安裝程式檢查通過,但 agent 可能在安裝後無法連線,因此值得修復。

Agent 已安裝但資產顯示離線

Gorelo 中資產的上線或離線狀態來自 Gorelo Agent。Gorelo Connect 是獨立的遠端控制元件。即使 Gorelo Agent 無法連線到 Gorelo 雲端,Gorelo Connect 仍可執行,你也能啟動遠端工作階段。請參閱 Gorelo Agent vs. Gorelo Connect。 如果 Gorelo Agent 已安裝,但資產在資產清單中顯示離線:
  1. 在受影響的裝置上執行前置條件檢查。
  2. 檢視 Gorelo 閘道、API 與 hub 伺服器的 URL 檢查。失敗表示防火牆、Proxy 或 DNS 設定封鎖了 Gorelo Agent。
  3. 檢視 IoT Hub DNS 警告。如果裝置無法解析 gorelo.azure-devices.net(USW)或 gorelo-aue.azure-devices.net(AUE),即使其他網際網路流量與 Gorelo Connect 正常運作,Gorelo Agent 仍可能無法連線。
  4. 檢視時間同步檢查。修正任何時間不一致。
  5. 檢查 Gorelo Agent 記錄中的連線錯誤。如需 Windows 與 macOS 上 Agent 記錄的位置,請參閱記錄。

記錄

Gorelo 會將所有內容記錄到:
隨著安裝進行,安裝程式會在每個階段建立額外的資料夾並在其中放置記錄檔:InstallerHandler > Installer > Shell > Agent最常見的問題會出現在下列記錄中:
如果 Gorelo 支援團隊要求記錄檔,請將整個 LogFiles 資料夾以 .zip 寄出。

仍有問題?

如果你解決了 Gorelo Agent Check 中所有失敗項目後仍遇到安裝或連線問題,請直接聯絡 Gorelo 支援團隊。透過左下角選單的「?」圖示使用支援聊天。