test

適用於 Microsoft Windows 的 Sun Java Enterprise System 5 安裝指南

第 8 章 疑難排解

本章提供有關如何解決 Sun Java Enterprise System (Java ES) 安裝和解除安裝問題的建議。

本章包含以下各節：

一般疑難排解方法

本節提供找出問題來源的一般指導。涉及以下主題：

網路連結

獨立機器上不支援安裝 Java ES。您必須有一台已經與網路連線的機器才能安裝 Java ES。

檢查 Directory Server 連結

如果您要安裝依賴 Directory Server 的元件，則問題可能是由以下其中一個狀況所導致：

在 [安裝後手動配置] 模式下，您需要確保在配置依賴 Directory Server 的產品之前，Directory Server 已在執行。

檢查安裝後配置

如果您在啟動元件時遇到問題，請驗證是否已正確執行第 5 章, 完成安裝後配置中所述的程序。

檢查資源和設定

以下主機層級問題會導致安裝問題：

請參閱系統需求以檢查是否已符合所有需求，之後再繼續安裝。

檢查發行媒體

如果您要使用 DVD 安裝，請檢查媒體是否弄髒或損壞。弄髒的磁碟會導致安裝問題。

檢查元件記錄檔

如果在啟動元件時發生問題，請檢查其記錄檔。許多元件記錄檔列於元件疑難排解資訊下。

檢查安裝記錄檔

如果在安裝或解除安裝期間發生問題，請查看 %TEMP%/SunJavaES.log 目錄中適當的記錄檔。

%TEMP% 是該系統上的使用者定義 TEMP 資料夾。

檢查解除安裝程式記錄檔和安裝程式記錄檔 (以及 Java ES 配置記錄) 有助於您找出問題來源。

Procedure檢查安裝記錄檔

  1. 檢閱安裝摘要檔案，該檔案提供所安裝和配置產品的高階說明。此檔案位於 JavaEs-install-dir\Summary.txt 中。若出現問題，請檢查導致問題的元件。如果發生多個問題，請將第一個問題分離出來。

  2. 檢閱詳細的記錄檔。

    1. 找出出現的第一個錯誤或警告並嘗試解決。有時，解決一個錯誤會同時解決其後發生的一些似乎毫不相關的錯誤。

    2. 找出導致問題的元件的名稱。

    3. 檢閱配置記錄。配置記錄位於元件安裝目錄中。請參閱 Summary.txt 找到元件記錄檔的準確位置。

    4. 檢閱安裝程式記錄檔，以找到安裝或解除安裝問題。請參閱配置記錄以找到與配置相關的問題。

移除檔案和目錄

若要防止覆寫自訂檔案 (例如編輯的配置檔案)，不能將 Java ES 5 元件安裝於其各自的包含檔案的安裝目錄中。

如果您要重新安裝 Java ES 5，請檢查安裝目錄以確保目錄為空。如果這些目錄不為空，請將檔案歸檔至其他目錄並重試安裝。

驗證密碼

安裝程式要求您為元件輸入一些密碼。如果您要在不同的主機上安裝不同的產品元件，請確保您在每台主機上都提供對應的密碼。

若要解決密碼問題，您可能需要解除安裝然後再重新安裝。如果解除安裝失敗，請參閱因解除安裝期間殘留的檔案而導致安裝失敗。

驗證元件相依性

許多元件在安裝期間都具有相依性。影響一個元件的問題也可能會影響其他元件。若要檢查是否有不符合的相依性，請先熟悉相依性檢查中的資訊。接著，執行以下動作：

安裝問題

本節陳述下列您在安裝期間可能會遇到的問題：

因解除安裝期間殘留的檔案而導致安裝失敗

如果解除安裝失敗，應該移除的元件會留在您的主機系統上。在此情況下，您必須先手動移除這些元件，然後再重新安裝 Java ES。

Procedure移除殘留檔案

若安裝失敗或取消配置失敗，那麼在重新安裝 Java ES 之前，必須先執行以下的清除步驟。

  1. 確定所有的 Java ES 服務均已停止，並已透過 [控制台] > [管理工具] > [服務] 功能表移除。

  2. 刪除任何先前安裝的 Sun 資料夾。如果您無法刪除資料夾，請重新啟動系統，然後再刪除資料夾。

  3. 檢查有無任何殘留的服務項目。如果服務中有任何殘留服務項目，則您需要透過移除這些項目來清除註冊檔。下表列出可能的項目。

    元件名稱 

    服務項目 

    Common Agent Container 

    Common Agent Container 2 (#CRC：預設) 

    HADB 

    HADB4.4MgmtAgent

    Message Queue 

    MQ3.7UR1_Broker

    Portal Server 

    sra.gateway. srainstance

    sra.netletproxy. srainstance

    sra.rewriterproxy. srainstance

    WebAdminServer 

    https-admserv70

    Web Console 

    Web Console 3.0.2 主控台 

    Web Proxy Server 

    Sun Java System Socks Server 4.0.4 (server1)

    Sun Java System Web Proxy Server 4.0.4 (proxy-server1)

    Sun Java System Web Proxy Server 4.0.4 Administration Server 

    Web Server 

    Sun Java System Web Server 7.0 (https-hostname.domainname)

    Sun Java System Web Server 7.0 Administration Server 

  4. 清除註冊檔。

    刪除 HKEY_LOCAL_MACHINE\Software\Sun Microsystems\Entsys5\Installer。

  5. 如果您執行以上任一步驟，請在開始安裝之前重新啟動系統。

Windows 安裝程式錯誤

安裝可能因為以下的 Windows 安裝程式錯誤而失敗。

無訊息安裝失敗

如果您已編輯回應檔案，則可能會遇到所述的錯誤。例如，請檢查以下內容：

解決問題並依建立回應檔案中所述重新產生回應檔案。

無訊息安裝失敗：「回應檔案不相容或已損壞」

如果您是在建立回應檔案的平台上使用該回應檔案，則該問題可能是由不明檔案毀壞錯誤引起的。嘗試產生新的回應檔案並重新安裝。

如需詳細資訊，請參閱建立回應檔案。

非預期的外部錯誤

外部錯誤的可用原因如下：

如果在安裝或配置過程中發生故障，則您可能已完成部份安裝。執行解除安裝程式。如果解除安裝程式失敗，請按照因解除安裝期間殘留的檔案而導致安裝失敗的指示執行。

Java DB 重新啟動後找不到入口網站資料庫

當您在執行預設的 Application Server 指令以重新啟動 Java DB (先使用 asadmin stop-databsse 然後使用 asadmin start-database ) 後，部署使用 Java DB 的 Application Server 範例時，就會發生此問題。再也無法存取 Portal Server 範例。

解決方法：使用以下其中一個解決方法：

元件疑難排解資訊

本節提供有關元件疑難排解的各種快速提示，以及有用文件的參照：

Access Manager 疑難排解提示

表 8–1 Access Manager 疑難排解提示

主題 

詳細資訊 

配置檔案 

AccessManager-base\Config\AMConfig.properties

記錄和除錯檔案 

記錄檔目錄： 

AccessManager-base\Logs

除錯檔案目錄： 

AccessManager-base\Debug

除錯模式 

請參閱「Sun Java System Access Manager Developer’s Guide」。

Application Server 疑難排解提示

表 8–2 Application Server 疑難排解提示

主題 

詳細資訊 

記錄檔 

記錄檔目錄： 

ApplicationServer-base\Setup\

Application Server 實例記錄目錄 (初始建立的實例之預設位置)： 

JaveES-install-dir\appserver\

訊息記錄檔名稱：server.log，用於每個伺服器實例。

配置檔案 

配置檔案目錄：ApplicationServer-base \Config。

疑難排解 

請參閱「Sun Java System Application Server Enterprise Edition Troubleshooting Guide」。

Directory Server 疑難排解提示

表 8–3 Directory Server 疑難排解提示

主題 

詳細資訊 

記錄檔 

可在 tmp 資料夾內找到安裝記錄檔。

配置記錄檔： 

  • DirectoryServer-base.Atimestamp

  • DirectoryServer-base.B timestamp

如需關於管理記錄檔的資訊，請參閱「 Sun Java System Directory Server 管理指南」。

疑難排解 

請參閱「Sun Java System Directory Server 管理指南」。

HADB 疑難排解提示

表 8–4 HADB 疑難排解提示

主題 

詳細資訊 

記錄檔 

  • HADB.properties

  • mgt.cfg

可執行檔位置 

JavaES-install-dir\Hadb\4.4.1-7\lib

疑難排解 

請參閱「High Availability Session Store Administrator’s Guide」。

Message Queue 疑難排解提示

表 8–5 Message Queue 疑難排解提示

主題 

詳細資訊 

記錄檔 

安裝記錄檔： 

MessageQueue-base\var\instances\ instance-name\log

請參閱「Sun Java System Message Queue 3.7 UR1 管理指南」。

疑難排解 

有關效能問題，請參閱「Sun Java System Message Queue 3.7 UR1 Administration Guide」中的第 11 章「Analyzing and Tuning a Message Service」。

有關 Message Queue 疑難排解的討論，請參閱「Sun Java System Message Queue 3.7 UR1 Administration Guide」中的第 12 章「Troubleshooting Problems」。或者，訪問 Message Queue 論壇，網址為：http://swforum.sun.com/jive/forum.jspa?forumID=24。

其他文章位於知識庫中，網址為 http://developers.sun.com/prodtech/msgqueue/reference/techart/index.html。

Monitoring Console 疑難排解提示

表 8–6 Monitoring Console 疑難排解提示

主題 

詳細資訊 

配置檔案 

對於 Monitoring Console： 

  • MonitoringConsole-base\WEB-INF\web.xml

對於 Monitoring Framework： 

  • JavaES-install-dir\share\mfwk\config\mfwk.properties

記錄檔 

對於 Monitoring Console： 

  • JavaES-install-dir\share\webconsole\console\console_config_log

對於 Monitoring Framework： 

  • JavaES-install-dir\share\mfwk\logs

疑難排解 

若您無法存取 Monitoring Console，請參閱「Sun Java Enterprise System 5 監視指南」中的「Monitoring Console 疑難排解」。如需對 Monitoring Console 進行疑難排解，請參閱「Sun Java Enterprise System 5 監視指南」中的「Monitoring Framework 疑難排解」。

Portal Server Secure Remote Access 疑難排解提示

表 8–7 Portal Server Secure Remote Access 疑難排解提示

主題 

詳細資訊 

除錯記錄 

入口網站閘道除錯記錄位於 PortalServer-base \debug 目錄中。

備註 –

當使用 Access Manager 管理主控台開啟記錄時，Portal Server 服務的記錄 (例如 NetFile) 位於 AccessManager-base\debug 目錄中。

Portal Server 疑難排解提示

表 8–8 Portal Server 疑難排解提示

主題 

詳細資訊 

記錄檔和除錯檔案 

Portal Server 記錄檔是： 

  • psadmin 記錄：PortalServer-base\data\admin

  • 配置記錄：PortalServer-base\data\config

  • Portal Server 實例記錄：PortalServer-base \data\portals\portal-id \logs\instance-id

Service Registry 疑難排解提示

表 8–9 Service Registry 疑難排解提示

主題 

詳細資訊 

記錄檔 

預設記錄檔：ServiceRegistry-base\domains\registry\logs\server.log

如需詳細資訊，請參閱「Service Registry 3.1 管理指南」。

疑難排解 

請參閱「Service Registry 3.1 管理指南」。

Web Proxy Server 疑難排解提示

表 8–10 Web Proxy Server 疑難排解提示

主題 

詳細資訊 

記錄檔 

預設記錄檔： 

  • JavaES-install-dir\ instance-name\config\logs\errors

  • JavaES-install-dir\ instance-name\config\logs\access

  • JavaES-install-dir\ admin-name\config\logs\errors

  • JavaES-install-dir\ admin-name\config\logs\access

如需詳細資訊，請參閱「Sun Java System Web Proxy Server 管理指南」。

疑難排解 

請參閱「Sun Java System Web Proxy Server 管理指南。

Web Server 疑難排解提示

表 8–11 Web Server 疑難排解提示

主題 

詳細資訊 

記錄檔 

errors 記錄檔和 access 記錄檔兩者均位於 WebServer-base\WebServer_Install.log 目錄中。

errors 記錄檔列出了伺服器遇到的所有錯誤。access 記錄檔記錄有關對伺服器的請求以及伺服器的回應之資訊。如需詳細資訊，請參閱「Sun Java System Web Server 7.0 管理員指南」。

疑難排解 

請參閱「Sun Java System Web Server 7.0 Troubleshooting Guide」。

配置檔案目錄 

WebServer-base\https-instance-name\config

其他疑難排解資訊

本指南中的以下額外資訊有助於進行疑難排解：