排除 Lucent Sky AVM Web UI 錯誤

2023/6/20 |

症狀

在存取 Lucent Sky AVM WEb UI 時,你收到一個錯誤訊息。

原因

多種原因會導致 Web UI 回傳錯誤。這個文章描述了 Web UI 錯誤的常見原因及解決方式。

要深入了解關於上傳程式碼壓縮檔案後的 Web UI 錯誤,請參考 Lucent Sky 知識庫:
Troubleshoot source code archive upload errors

解決方式

  • 在存取 Web UI 時,你看到以下之一的錯誤訊息:

      An error has occurred.
    
      Server Error in '/' Application.
    

    當 Web UI 發生錯誤且 ASP.NET 自訂錯誤開啟時(預設的設定),將顯示此錯誤訊息而非實際的錯誤訊息。暫時將自訂錯誤關閉可讓 Web UI 顯示實際的錯誤訊息。

    依照以下步驟關閉自訂錯誤:

    1. 使用文字編輯器開啟 C:\Program Files\Lucent Sky\CLEAR Web\web.config
    2. 找出 web.config 中的 <system.web\\customErrors> 元素,並將 mode 屬性設為 Off

    詳細的錯誤訊息將被顯示。依照錯誤排除步驟來解決問題。

    當錯誤排除後,開啟自訂錯誤:

    1. 使用文字編輯器開啟 C:\Program Files\Lucent Sky\CLEAR Web\web.config
    2. 找出 web.config 中的 <system.web\\customErrors> 元素,並將 mode 屬性設為 On
  • 在存取 Web UI 時,你無法建立掃描且所有應用程式均顯示「載入中」。

    這個情況發生於瀏覽器的 JavaScript 被關閉。這個情況經常發生於使用 Windows Server 上的 Internet Explorer 存取 Web UI,因為 Windows Server 上的 Internet Explorer 以加強的受保護模式(EPM)執行。

    依照以下步驟解決這個問題:

    • 使用開啟加強的受保護模式的 Internet Explorer

      1. 在 Internet Explorer 中,將 Web UI 的網址(例如 https://clear.contoso.com/)加入信任的網站
    • 使用關閉加強的受保護模式的 Internet Explorer 或其他瀏覽器

      1. 在瀏覽器的設定中,確認 JavaScript 是開啟的。
      2. 如果有安裝 JavaScript 的安全擴充元件(例如 NoScript),將 Web UI 的網址加入其允許清單。
  • 在存取 Web UI 時,你看到以下的錯誤訊息:

      Could not load file or assembly … An attempt was made to load a program with an incorrect format.
    

    這個錯誤發生於 Web UI 在 32-位元的 IIS Server 上執行,或在 64-位元的 IIS Server 上以 32-位元模式執行。

    依照以下步驟解決這個問題:

    • Web UI 在 32-位元 IIS Server 上執行

      1. 將 Web UI 安裝於 64-位元 IIS Server 上。Web UI 不支援在 32-位元 IIS Server 上執行。
    • Web UI 在 64-位元的 IIS Server 上以 32-位元模式執行

      1. 開啟 Open IIS Manager,瀏覽至安裝 Web UI 的 IIS Server,再選取應用程式集區
      2. 右點擊 CLEAR Web 應用程式集區上,再選取進階設定…
      3. 確認 .NET CLR Version 設定為 4.0Enable 32-Bit Applications 設定為 False
  • 在存取 Web UI 時,你看到以下之一的錯誤訊息:

      ERROR_SERVICE_NOT_ACTIVE.
    
      The communication object, System.ServiceModel.Channels.ServiceChannel, cannot be used for communication because it is in the Faulted state.
    

    這個錯誤發生於 Web UI 無法連線到 CLEAR Engine 或是 Web UI 和 CLEAR Engine 間的通訊發生了錯誤。發生的原因可能是因為錯誤的 WCF 端點設定,或是 CLEAR Engine 未運行。

    依照以下步驟解決這個問題:

    • 確認 CLEAR Engine 正在運行

      1. 在 CLEAR Engine 實體上以管理員身分開啟 PowerShell,並輸入以下命令來啟動 CLEAR Engine 服務:
         Start-Service "CLEAR Engine"
        
    • 確認 WCF 端點設定

      1. 使用文字編輯器開啟 C:\Program Files\Lucent Sky\CLEAR Web\web.config 並確認 WCF 端點有被正確設定。
      2. 要深入了解關於安裝和設定 Lucent Sky AVM Web UI,請參考 Lucent Sky 知識庫:
        CLEAR Engine 和 Web UI 管理者指南
  • 在存取 Web UI 時,你看到以下之一的錯誤訊息:

      The resource cannot be found.
    
      HTTP Error 404.15 - Not Found 
    

    這個錯誤發生於要刪除的應用程式的 ID 超過了 Web UI 允許的 URL 長度。

    依照以下步驟解決這個問題:

    1. 使用文字編輯器開啟 C:\Program Files\Lucent Sky\CLEAR Web\web.config
    2. 找出 web.config 中的 <system.web\\httpRuntime> 元素,將 maxQueryStringLength 屬性設為 16384,並增加一個名為 maxUrlLength 的屬性並將其值設為 16384
    3. 找出 web.config 中的 <system.webServer\\security\\\\requestFiltering\\requestLimits> 元素,將 maxQueryString 屬性設為 16384,並增加一個名為 maxUrl 的屬性並將其值設為 16384`。
  • 在 Web UI 上執行需要長時間的動作,例如清除掃描,你看到以下的錯誤訊息:

      ERROR_SERVICE_REQUEST_TIMEOUT
    

    這個錯誤發生於 Web UI 和 CLEAR Engine 間的連現在動作完成前逾時了。

    動作會持續在 CLEAR Engine 上執行。不需要重新執行一次。