排除 Lucent Sky AVM Web UI 錯誤

請注意：本文是以機器翻譯軟體翻譯而成，且可能由人工進行事後編修。同時，本文可能並非依照最新的英文版本翻譯而成。就翻譯內容之不正確或錯誤，或客戶因使用翻譯內容所產生的任何損害，Lucent Sky 不負擔任何責任。

症狀

在存取 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.0，Enable 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 上執行。不需要重新執行一次。