test

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

第 9 章 疑難排解

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

本章包含以下各節：

如何對問題進行疑難排解

本節提供對 Java ES 安裝和解除安裝期間出現的問題進行分析和確定問題來源的指導原則。

本節包含以下小節：

檢查安裝記錄檔

若在安裝或解除安裝期間出現問題，首先要在安裝記錄中尋找關於該問題的資訊。在使用者做出選擇、對套裝軟體進行處理、執行安裝或解除安裝步驟這類作業後，會顯示資訊性訊息、警告訊息或錯誤訊息。有關安裝、解除安裝及安裝期間配置的訊息都會收集到來源記錄檔中。為每條訊息顯示的資訊包括日期和時間、記錄層級、模組 ID 及訊息文字。資訊中一律不包括密碼。

記錄檔格式

擷取安裝或解除安裝資訊的記錄檔共有四種類型：

記錄訊息以稱為整合記錄格式 (ULF) 的 Sun 標準格式儲存。若您覺得 ULF 難以閱讀，可以使用 Java ES 記錄檢視器檢視記錄訊息。

可以使用文字編輯器編輯來源記錄檔。下表列出了來源記錄檔的格式。

表 9–1 記錄檔格式

已記錄的實體 

記錄檔名稱格式 

安裝程式 

Java_Enterprise_System_5_install.Atimestamp

Java_Enterprise_System_5_install.Btimestamp

JavaES_Install_log.timestamp

Java_Enterprise_System_5_Summary_Report_install. timestamp

解除安裝程式 

Java_Enterprise_System_5_uninstall.Atimestamp

Java_Enterprise_System_5_uninstall.Btimestamp

JavaES_UnInstall_log.timestamp

Java_Enterprise_System_5_Summary_Report_uninstall. timestamp

解除安裝後，解除安裝程式會移除安裝程式、記錄檢視器及其自身。然而，來源記錄檔不會被移除，它們儲存在以下位置：

Procedure若要使用記錄檔進行疑難排解

  1. 檢查摘要檔案。例如：

    Java_Enterprise_System5_Summary_Report_install. timestamp

    若出現問題，請確定導致問題的元件。確定是否發生了多個問題。您可能需要查看詳細資訊記錄之一，也可能兩個詳細資訊記錄都需要進行查看。

  2. 檢查詳細資訊記錄。例如：

    JavaES_Install_log timestamp

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

使用記錄檢視器

Java ES 記錄檢視器提供了用於檢視 JavaES_Install_log.timestamp 檔案或 JavaES_UnInstall_log.timestamp 檔案中 ULF 記錄訊息的圖形顯示。若要顯示記錄檔，請在記錄檢視器主頁面中選取 [檔案] 功能表中的 [開啟]。若您指定的檔案已存在或無法將其開啟以進行編寫，便會出現記錄檢視器錯誤，並返回記錄檢視器主頁面。此類檔案無法存在於安裝程式用來儲存來源記錄的目錄中。

當您按一下 [搜尋] 按鈕時，會在單一記錄表中顯示符合您篩選條件的訊息。顯示記錄表後，就可以選取記錄表中的個別列以進行詳細顯示，包括以多行格式進行顯示。

篩選的運作方式

若要自訂記錄輸出，可以在選取 ULF 記錄檔之後，在記錄檢視器主頁面上指定您的顯示喜好設定和搜尋條件。[顯示喜好設定] 表示您想要以何種語言顯示選取的內容，以及在顯示篩選的記錄時套用哪些限制。

有三種訊息篩選方式可以使所顯示的訊息具有足夠的重要性或受到足夠的關注：依記錄層級、依記錄程式及依內容。

以下是一些有代表性的搜尋條件：

Procedure執行記錄檢視器

因為記錄檢視器是在唯讀模式下運作，所以多位使用者可以同時執行記錄檢視器。

  1. 在指令行上，瀏覽至記錄檢視器的位置。

    • Solaris SPARC：/var/sadm/prod/SUNWentsys5i/Solaris_sparc

    • Solaris x86：/var/sadm/prod/SUNWentsys5i/Solaris_x86

    • Linux：/var/sadm/prod/sun-entsys5i/Linux_x86

    • HP-UX︰/var/sadm/prod/sun-entsys5i/HPUX_PA-RISC

  2. 啟動記錄檢視器。


    ./viewlog

    將顯示記錄檢視器主頁面。

  3. 在 [檔案] 功能表中，選取要顯示的記錄檔。

    若您選取的檔案不是 ULF，會看到一條訊息，指出所選的檔案不是 ULF，故無法選取。唯有 ULF 檔案才可以使用記錄檢視器來顯示。

    若沒有 ULF 記錄檔，則安裝或解除安裝可能尚未完成。請等待，然後再試一次。

  4. 選擇適用於您的情況的 [顯示喜好設定] 和 [搜尋條件]。

  5. 按一下 [搜尋]。

    記錄表會顯示符合篩選條件的記錄。

驗證產品相依性

許多產品元件都具有安裝時相依性。影響一個產品元件的問題也可能會影響其他產品元件。首先，您應該熟悉「Sun Java Enterprise System 5 安裝規劃指南」中的資訊。

除了產品元件相依性外，部份產品元件還依賴於 Solaris 套裝軟體的存在，而這些套裝軟體可能並未安裝在主機上。缺少這些套裝軟體可能會造成安裝失敗。請參閱版本說明中的「軟體需求」一節，以取得詳細資訊。

若啟動產品元件時出現問題，請檢查該產品元件的記錄檔。產品元件疑難排解提示中列出了許多產品元件記錄檔的位置。

檢查資源和設定

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

檢查安裝後配置

如果您在啟動產品元件時遇到問題，請驗證第 6 章, 完成安裝後配置中所述的程序得到了正確遵循。

檢查發行媒體

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

檢查 Directory Server 連結

如果您要安裝依賴 Directory Server 的產品元件，則問題可能是由以下問題之一所導致：

移除 Web Server 檔案和目錄

若要防止覆寫自訂檔案 (例如編輯的配置檔案)，Web Server 不能安裝至包含檔案的目錄。

如果您要重新安裝 Web Server，請檢查安裝目錄以確保它們為空。如果目錄不為空，請將檔案歸檔至其他目錄並重試安裝。

驗證密碼

安裝程式會要求您提供許多產品元件的密碼。如果您要在不同的主機上安裝不同的產品元件，請務必確保您在每台主機上都提供對應的密碼。

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

檢查已安裝或已解除安裝的產品元件

若您已安裝產品元件，但出現了問題，無法重新安裝或解除安裝，請使用以下指令檢查已安裝的元件套裝軟體：Solaris pkginfo 指令、Linux rpm 指令、HP-UX swlist 指令。將結果與「適用於 UNIX 的 Sun Java Enterprise System 5 安裝參照」中的第 5 章「可安裝的套裝軟體清單」中列出的 Java ES 套裝軟體進行比較。其他疑難排解資訊請參閱因為解除安裝期間殘留的檔案而導致安裝失敗。

提示 –

在 Solaris 9 和 Solaris 10 上還可以使用產品登錄 (prodreg 工具)，它提供的圖形化介面可以為元件及其套裝軟體建立索引，從而取代 pkg 公用程式。要呼叫產品登錄，請在指令提示符號中鍵入 prodreg。如需更多資訊，請參閱 prodreg(1) 線上手冊。

驗證管理員的解除安裝存取權限

解除安裝期間，您可能需要授予管理員存取解除安裝程式的權限，如授予解除安裝程式的管理員存取權所述。

解決安裝問題

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

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

解除安裝可能會遺留一些產品元件檔案或套裝軟體。在此情況下，在重新安裝 Java ES 前，您可能需要手動移除檔案或套裝軟體。即使您以為已移除產品元件，但安裝程式會報告該元件還在主機上。

可能發生下列情況：

Procedure清除部份安裝

  1. 使用以下指令確定是否有任何套裝軟體是部份安裝。

    Solaris 作業系統：pkginfo -p

    Linux：rpm -qa |grep —I ^sun | xargs rpm -V

    HP-UX︰swlist -l product sun-*

    指令輸出會列出所有部份安裝的套裝軟體。請利用傳回的套裝軟體名稱，並參閱「適用於 UNIX 的 Sun Java Enterprise System 5 安裝參照」中的第 5 章「可安裝的套裝軟體清單」，找出該套裝軟體所屬的產品元件。

  2. 移除元件或套裝軟體。

    • 在 Solaris 9 或 10 上，使用 prodreg 工具。

      prodreg 工具可管理主機上基於套裝軟體的元件。您可以檢視產品元件及其套裝軟體，以及包括相依性在內的完整資訊。您可以使用 prodreg 工具安全地將產品元件解除安裝及移除套裝軟體。使用 prodreg 工具移除產品元件後，您即可將其重新安裝。

    • 在 Linux 系統上，使用 rpm -e 指令。

      若要編輯產品註冊檔，請開啟檔案 /var/opt/sun/install/productregistry。該 XML 檔案會對每個產品元件進行說明。每個產品元件的說明都是以 <compid\> 標記開始，以 </compid\> 標記結束。刪除對應於該產品元件的整個項目。

    • 在 HP-UX 上，使用 swremove 指令。

      若要編輯產品註冊檔，請開啟檔案 /var/adm/swproductregistry。該 XML 檔案會對每個產品元件進行說明。每個產品元件的說明都是以 <compid\> 標記開始，以 </compid\> 標記結束。刪除對應於該產品元件的整個項目。

  3. 驗證下列目錄不包含 Java ES 產品元件或套裝軟體：

    /opt

    /etc/opt

    /var/opt

  4. 再次執行安裝程式。

因為解除安裝後在產品註冊檔中移除的共用元件而導致安裝失敗

從 Java ES 5 發行版本開始，安裝後共用元件將列示於產品登錄檔案中。

Java ES 解除安裝程式會從系統中移除產品元件，但不會移除共用元件。解除安裝後，產品註冊中仍包含共用元件的項目。解除安裝後，如果您以手動方式移除任何 Java ES 共用元件，這些元件將不會從產品註冊中移除。因此，下一次安裝 Java ES 5 時會失敗，因為安裝程式假設已手動刪除的共用元件仍存在 (因為產品登錄檔案中仍有其項目)。

提示 –

避免從您的系統中手動移除 Java ES 共用元件。

建議的修正方式。從產品註冊檔移除對應的項目，或移除產品註冊檔本身。從產品註冊檔中移除項目會造成檔案損壞，所以您可能希望移除整個產品註冊。開始執行此動作前，確認 Java ES 元件以外的產品並未使用產品註冊檔。

在 Linux 和 HP-UX 上，沒有與 Solaris 作業系統上的圖形化產品登錄對應的工具。若您在 Linux 或 HP-UX 上手動移除了檔案，就必須手動編輯產品登錄檔案來移除這些項目。

無法將 IBM WebSphere 配置為 Portal Server Web 容器

WebSphere 可能未執行，或者您可能已指定與 WebSphere 原生配置不相符的 WebSphere 值。有兩種解決此問題的方式。Solaris 作業系統上僅支援將 IBM WebSphere 做為 Web 容器。

檢查配置

一種方式是檢查您 WebSphere 實例的配置。

Procedure若要檢查 WebSphere 配置

  1. 確保 WebSphere 正在執行。

  2. 檢查以下安裝程式欄位的值：

    • WebSphere 虛擬主機 (狀態檔案中的 PS_IBM_VIRTUAL_HOST)

    • Application Server 名稱 (狀態檔案中的 PS_IBM_APPSERV_NAME)

  3. 使用 WebSphere 工具檢查配置，確保它與您要輸入的值相符。

  4. 然後再試一次。

建立新實例

另一種方法是建立新的 WebSphere 實體實例。

Procedure若要建立新的 WebSphere 實體實例

  1. 使用 adminclient.sh 啟動 WebSphere 主控台。

  2. 建立新的虛擬主機實例和新的 Application Server 實例名稱。

  3. 按一下節點 (通常為主機名稱) 下的項目，然後選取 [Regen WebServer 外掛程式]。

    該程序會將新項目儲存至 plugin 配置檔案，安裝程式會檢查其中是否存在合法名稱。

  4. 返回安裝程式並輸入您剛建立的值。

發生非預期的外部錯誤

可能發生電源故障或系統故障，或者您可能已輸入 CTRL/C 以停止安裝程式。

建議的修正方式。如果在安裝或配置過程中發生故障，則您可能會留下部份安裝。執行解除安裝程式。如果解除安裝程式失敗，請按照解除安裝失敗而殘留檔案下的說明執行

圖形化安裝程式似乎沒有回應

影像輸入就緒之前，安裝程式有時會在螢幕上建立該影像。您只能等待並重複按安裝精靈中的 [下一步]。

建議的修正方式。表示預設選擇的按鈕包括一個藍色矩形。有時此矩形在按鈕本身顯示之後才顯示。請在看到藍色矩形之後再按一下按鈕。

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

如果您是在建立狀態檔案的平台上使用該狀態檔案，則該問題可能是由不明檔案毀壞錯誤引起的。有兩種解決此問題的方式。

產生新的狀態檔案

建立與平台相應的新 ID

如果您建立狀態檔案的平台與執行無訊息安裝的平台不是同一平台，則可以透過為該檔案建立一個平台相應的新 ID 來解決該問題。如需有關如何建立 ID 的說明，請參閱建立與平台相應的狀態檔案 ID。

編輯狀態檔案後無訊息安裝失敗

如果您已編輯狀態檔案，則可能會遇到所述的錯誤。檢查以下各項並重新產生狀態檔案，如建立狀態檔案中所述。

建議的修正方式。解決問題並重新產生狀態檔案。

線上說明手冊未顯示

最有可能的原因是，您沒有正確地為您安裝的元件設定 MANPATH 環境變數。

建議的修正方式。更新 /etc/MANPATH 以使其指向新的線上手冊目錄。請參閱驗證線上手冊。

解決解除安裝問題

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

找不到解除安裝程式

Java ES 安裝程式將解除安裝程式放在系統中的以下位置：

如果解除安裝程式不在該目錄，可能是發生了以下其中一種情形：

建議的修正方式。手動清除系統，如解除安裝失敗而殘留檔案中所述。

解除安裝失敗而殘留檔案

如果因為解除安裝程式殘留檔案或程序而必須手動清除時，請執行以下程序來移除系統中的套裝軟體。

Procedure手動清除套裝軟體

  1. 確定您要移除哪些套裝軟體。

    將您系統上的套裝軟體與「適用於 UNIX 的 Sun Java Enterprise System 5 安裝參照」中的第 5 章「可安裝的套裝軟體清單」中列出的 Java ES 套裝軟體進行比較。(亦請參閱因為解除安裝期間殘留的檔案而導致安裝失敗。您可以使用下列指令來確定已安裝哪些套裝軟體：

    • Solaris 作業系統 pkginfo 或 prodreg 公用程式

    • Linux rpm 指令

    • HP-UX swlist 指令

  2. 停止 Java ES 產品元件所有正在執行的程序。

    第 6 章, 完成安裝後配置產品元件文件中包含有關停止程序的簡要說明。

  3. 備份您要在以後安裝時使用的所有自訂配置資料和使用者資料。

    檢閱 Java ES 產品元件的解除安裝運作方式提供了一些有關應備份的配置資料和使用者資料的資訊。如需更多資訊，請參閱各產品元件的文件。

  4. 使用 pkgrm、rpm -e 或 swremove 指令移除 Java ES 元件套裝軟體。

  5. 移除您不打算在以後安裝時使用的所有剩餘產品元件目錄及其內容。如果您想在日後使用這些目錄，請將它們移到他處。

  6. 更新產品註冊檔，該檔案位於以下位置：

    • Solaris 作業系統：/var/sadm/install/productregistry

    • Linux：/var/opt/sun/install/productregistry

    • HP-UX︰/var/adm/sw/productregistry

    解除安裝程式使用該登錄來確定主機上安裝的產品元件。在完成安裝或解除安裝時，安裝程式和解除安裝程式均會更新產品註冊檔。

    備註 –

    如果您手動移除套裝軟體，而不是使用解除安裝程式，則您必須編輯產品註冊，以便其正確地反映系統中已安裝的軟體。

  7. 清除系統的記錄檔，其位於：

    • Solaris 作業系統：/var/sadm/install/logs

    • Linux 及 HP-UX：/var/opt/sun/install/logs

    如果是手動移除套裝軟體，記錄檔可能不會正確地反映系統狀態。

產品註冊檔已經損壞

解除安裝期間，解除安裝程式會使用產品註冊檔，以確定需要解除安裝哪些內容：

解決 Common Agent Container 問題

本節陳述 common agent container 共用元件可能產生的相關問題：

連接埠號衝突

Java ES 附帶的 common agent container (V2.0) 依預設保留以下連接埠號：

若您要對 Sun Cluster 軟體安裝進行疑難排解，連接埠的指定會有差異，因為 Sun Cluster 軟體使用不同版本的 common agent container。在此情況下，預設連接埠如下：

若您的安裝已保留了上述連接埠號中的任何一個，請依下列程序中所述變更 common agent container 所使用的連接埠號。

檢查連接埠編號

如需 common agent container cacaoadm 指令的進一步資訊，請參閱 cacaoadm 線上說明手冊。如果您在指令行看不到線上說明手冊，請驗證您的 MANPATH 設定正確。請參閱驗證線上手冊。

Procedure在 Solaris 作業系統上驗證連接埠

  1. 以超級使用者身份停止 common agent container 管理常駐程式：


    /usr/sbin/cacaoadm stop

  2. 使用以下語法變更連接埠號：

    /usr/sbin/cacaoadm set-param param=value

    例如，若要將 SNMP 配接卡佔用的連接埠從預設的 11161 變更為 11165，請執行以下動作：

    備註 –

    對於 Sun Cluster 軟體，使用先前指定的連接埠。


    /usr/sbin/cacaoadm set-param snmp-adaptor-port=11165

  3. 重新啟動 common agent container 管理常駐程式：


    /usr/sbin/cacaoadm start

Procedure在 Linux 或 HP-UX 上驗證連接埠

  1. 以超級使用者身份停止 common agent container 管理常駐程式：


    /opt/sun/cacao/bin/cacaoadm stop

  2. 使用以下語法變更連接埠號：

    /opt/sun/cacao/bin/cacaoadm set-param param=value

    例如，若要將 SNMP 配接卡佔用的連接埠從 11161 變更為 11165，請執行以下動作：


    /opt/sun/cacao/bin/cacaoadm set-param snmp-adaptor-port=11165

  3. 重新啟動 common agent container 管理常駐程式：


    /opt/sun/cacao/bin/cacaoadm start

超級使用者密碼引發的安全性風險

可能需要在執行 Java ES 的主機上重新產生安全性金鑰。例如，如果超級使用者密碼有被公開或洩漏的風險，您應該重新產生安全性金鑰。common agent container 服務所使用的金鑰儲存在以下位置：

Solaris 作業系統：/etc/opt/SUNWcacao/security Linux 和 HP-UX： /etc/opt/sun/cacao/security

一般作業中，這些金鑰可以保留為預設配置。如果因金鑰可能被洩漏而需要重新產生金鑰，您可以使用以下程序重新產生安全性金鑰。

Procedure若要產生 Solaris 作業系統的金鑰

  1. 以超級使用者身份停止 common agent container 管理常駐程式。


    /usr/sbin/cacaoadm stop

  2. 重新產生金鑰。


    /usr/sbin/cacaoadm create-keys --force

  3. 重新啟動 common agent container 管理常駐程式。


    /usr/sbin/cacaoadm start
    備註 –

    對於 Sun Cluster 軟體，您必須將此變更傳遞到叢集中的所有節點。如需更多資訊，請參閱「Sun Cluster Software Installation Guide for Solaris OS」中的「How to Finish a Rolling Upgrade to Sun Cluster 3.1 8/05 Software」。

Procedure產生 Linux 和 HP-UX 的金鑰

  1. 以超級使用者身份停止 common agent container 管理常駐程式。


    /opt/sun/cacao/bin/cacaoadm stop

  2. 重新產生金鑰。


    /opt/sun/cacao/bin/cacaoadm create-keys --force

  3. 重新啟動 common agent container 管理常駐程式。


    /opt/sun/cacao/bin/cacaoadm start

    如需有關 cacaoadm(1M) 指令的更多資訊，請參閱 cacaoadm 線上說明手冊。

解決安裝後啟動/重新啟動的問題

此部份說明安裝後可能遭遇的各種問題。

監視規則停止運作 (狀態 [不明])

如果您已重新啟動 Application Server，Application Server 與 Monitoring Console 間的通訊便會中斷，且需要重新啟動。之前尚可運作的監視規則現已停止運作，且狀態為 [不明]。如果您已重新啟動 Application Server 主機上的 common agent container，問題還是會存在，因為還必須在 Monitoring Console 主機上重新啟動 common agent container。

Procedure重建 Application Server 與 Monitoring Console 間的通訊

  1. 以超級使用者身份，重新啟動安裝 Application Server 之主機上的 common agent container。例如：


    /usr/sbin/cacaoadm start

  2. 然後到安裝 Monitoring Console 的主機上，重新啟動 common agent container。例如：

    如果 common agent container 已在執行，請將其停止，然後以下列指令啟動它。

    在 Solaris 作業系統上：


    /usr/sbin/cacaoadm stop
/usr/sbin/cacaoadm start

    在 Linux 和 HP-UX 上：


    /opt/sun/cacao/bin/cacaoadm stop
/opt/suncacao/bin/cacaoadm start

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

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

建議的修正方式。有很多方法可解決此問題

  1. 不要停止 Java DB。

  2. 若停止了 Java DB ，請使用以下指令重新啟動 Java DB，以便能夠於替代位置建立 Application Server 資料庫。

    Solaris 作業系統：/asadmin start-database --dbhome /var/opt/SUNWportal/derby

    Linux 及 HP-UX：/asadmin start-database --dbhome /var/opt/sun/portal/derby

    如果您想將資料庫放置於預設位置，請使用非預設連接埠啟動 Java DB 的另一個實例，然後於 Application Server 範例 common.properties 檔案中指定正確的 Derby 連接埠。例如：asadmin start-database --dbport 1528

產品元件疑難排解提示

本節的表格中提供了關於產品元件問題疑難排解的各種快速提示，其中包括實用文件的參照。本節包含以下小節：

Access Manager 疑難排解提示

表 9–2 Access Manager 疑難排解提示

主題 

詳細資訊 

配置檔案

AMConfig.properties

  • Solaris 作業系統：/etc/opt/SUNWam/config

  • Linux 及 HP-UX：/etc/opt/sun/identity/config

記錄和除錯檔案

記錄檔目錄： 

  • Solaris 作業系統：/var/opt/SUNWam/logs

  • Linux 及 HP-UX：/var/opt/sun/identity/logs

除錯檔案目錄： 

  • Solaris 作業系統：/var/opt/SUNWam/debug

  • Linux 及 HP-UX：/var/opt/sun/identity/debug

除錯模式

請參閱「Sun Java System Access Manager 7.1 Developer’s Guide」中的「Auditing Features」一章。

Application Server 疑難排解提示

表 9–3 Application Server 疑難排解提示

主題 

詳細資訊 

記錄檔

記錄檔目錄： 

  • Solaris 作業系統：/var/sadm/install/logs/

  • Linux 及 HP-UX：/var/opt/sun/install/logs/

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

  • Solaris 作業系統：/var/opt/SUNWappserver/domains/domain1/logs

  • Linux 及 HP-UX：/var/opt/sun/appserver/domains/domain1/logs

訊息記錄檔名稱： 

server.log，用於每個伺服器實例

配置檔案

  • Solaris 作業系統：/opt/SUNWappserver/appserver/config/asenv.conf

  • Linux 及 HP-UX：/opt/sun/appserver/config/asenv.conf

疑難排解

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

Directory Server 疑難排解提示

表 9–4 Directory Server 疑難排解提示

主題 

詳細資訊 

記錄檔

安裝記錄檔： 

  • Solaris 作業系統：/var/sadm/install/logs

  • Linux 及 HP-UX：/var/opt/sun/install/logs

疑難排解

請參閱「Sun Java System Directory Server Enterprise Edition 6.0 Administration Guide」中的第 I部分「Directory Server Administration」。

請參閱「Sun Java System Directory Server Enterprise Edition 6.0 Administration Guide」中的第 II部分「Directory Proxy Server Administration」。

Message Queue 疑難排解提示

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

主題 

詳細資訊 

記錄檔

安裝記錄檔： 

  • 若為 Solaris 作業系統：/var/sadm/install/logs

  • 若為 Linux 和 HP-UX：/var/opt/sun/install/logs

代理程式記錄檔： 

  • 若為 Solaris 作業系統：/var/mq/instances/ instance-name/log

  • 若為 Linux 和 HP-UX：/var/opt/sun/mq/instances/ instance-name/log

疑難排解

請參閱「Sun Java System Message Queue 3 2005Q4 Administration Guide」的「排解疑難問題」一章。

有關效能問題，請參閱「Sun Java System Message Queue 3 2005Q4 Administration Guide」中的「分析與調校訊息服務」。

Monitoring Console 疑難排解提示

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

主題 

詳細資訊 

配置檔案

對於 Monitoring Console： 

  • 若為 Solaris 作業系統：/opt/SUNWjesmc/WEB-INF/web.xml

  • 若為 Linux 和 HP-UX：/opt/sun/jesmc/WEB-INF/web.xml

  • 若為 Solaris 作業系統：/etc/opt/SUNWmfwk/config/mfwk.properties

  • 若為 Linux 和 HP-UX：/etc/opt/sun/mfwk/config/mfwk.properties

  • 若為 Solaris 作業系統：/etc/opt/SUNWmfwk/config/masteragent.properties

  • 若為 Linux 和 HP-UX：/etc/opt/sun/mfwk/config/masteragent.properties

記錄檔

對於 Monitoring Console： 

  • /var/log/webconsole/console/console_config_log (所有平台)

  • /var/log/webconsole/console/console_debug_log (所有平台)

對於 Monitoring Framework： 

  • 若為 Solaris 作業系統：/var/opt/SUNWmfwk/logs

  • 若為 Linux 和 HP-UX：/var/opt/sun/mfwk/logs

疑難排解

若您無法存取 Monitoring Console，請參閱「Sun Java Enterprise System 5 監視指南」中的「Monitoring Console 疑難排解」。若您在 Monitoring Console 中看不到受監視的元件，請參閱「Sun Java Enterprise System 5 監視指南」中的「Monitoring Framework 疑難排解」。

Portal Server 疑難排解提示

Portal Server 使用與 Access Manager 相同的記錄檔和除錯檔案。

表 9–7 Portal Server 疑難排解提示

主題 

詳細資訊 

除錯檔案

Solaris 作業系統：/var/opt/SUNWam/debug

Linux 及 HP-UX：/var/opt/sun/identity/debug

Portal Server Desktop 除錯檔案： 

Solaris 作業系統：/var/opt/SUNWam/debug/desktop 和 /var/opt/SUNWam/debug/desktop.dpadmin.debug

Linux 及 HP-UX：/var/opt/sun/identity/debug/desktop 和 /var/opt/sun/identity/debug/desktop.dpadmin.debug

dpadmin、par、rdmgr 和 sendrdm Portal Server 指令行公用程式具有可以產生除錯訊息的選項。其說明詳見「Portal Server 管理指南」。

記錄檔

Solaris 作業系統：/var/opt/SUNWam/logs

Linux 及 HP-UX：/var/opt/sun/identity/logs

疑難排解

請參閱「Sun Java System Portal Server 7.1 Administration Guide」。

Portal Server Secure Remote Access 疑難排解提示

入口網站閘道除錯記錄位於以下目錄中：

備註 –

對於 Solaris 作業系統，若在 Access Manager 管理主控台中開啟了記錄，則 Portal Server 服務 (如 NetFile) 的記錄將位於 /var/opt/SUNWam/debug 。

Service Registry 疑難排解提示

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

主題 

詳細資訊 

記錄檔

實例記錄目錄： 

  • Solaris 作業系統：/var/opt/SUNWsrvc-registry/domains/registry/logs

  • Linux 及 HP-UX：/var/opt/sun/srvc-registry/domains/registry/logs

訊息記錄檔的名稱是 server.log。

配置檔案的位置

Solaris 作業系統：/opt/SUNWsrvc-registry/install/install.properties

Linux 及 HP-UX：/opt/sun/srvc-registry/install/install.properties

疑難排解

請參閱「Service Registry 3.1 Administration Guide」。

Sun Cluster 軟體疑難排解提示

備註 –

HP-UX 與 Linux 不支援 Sun Cluster 元件。

表 9–9 Sun Cluster 軟體疑難排解提示

主題 

詳細資訊 

記錄檔

預設記錄目錄：/var/cluster/logs/install

錯誤訊息：/var/adm/messages

疑難排解

請參閱「Sun Cluster Software Installation Guide for Solaris OS」。

Web Proxy Server 疑難排解提示

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

主題 

詳細資訊 

記錄檔

預設記錄位置：

  • Solaris 作業系統：/opt/SUNWproxy/proxy-instance-name /logs

  • Linux 及 HP-UX：/opt/sun/webproxyserver// proxy-instance-name/logs

錯誤記錄檔列出了伺服器遇到的所有錯誤。存取記錄檔記錄關於伺服器收到的請求及做出的回應之資訊。如需更多資訊，請參閱「Sun Java System Web Proxy Server 4.0.4 Administration Guide」。

配置檔案目錄

若為 Solaris 作業系統：/opt/SUNWproxy/proxy-instance-name /config

若為 Linux 和 HP-UX：/opt/sun/webserver/proxy-instance-name /config

除錯模式

您可以在 /server-root/proxy-instance-name /config/server.xml 檔案中，將 LOG 元素的 loglevel 屬性值設定為：info、fine、finer 或 finest。

Web Server 疑難排解提示

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

主題 

詳細資訊 

記錄檔

Web Server 記錄檔有兩種類型：errors 記錄檔和 access 記錄檔。errors 記錄檔列出伺服器遇到的所有錯誤。access 記錄檔記錄有關對伺服器的請求以及伺服器的回應之資訊。如需更多資訊，請參閱「Sun Java System Web Server 7.0 Administrator’s Guide」。

這些記錄位於以下目錄中： 

  • Solaris 作業系統：/var/opt/SUNWwbsvr7/https- instancename/logs

  • Linux 及 HP-UX：/var/opt/sun/webserver7/https- instancename/logs

若在進行 [立即配置] 安裝時對 Web Server 的配置失敗，請從以下記錄獲知更多資訊： 

  • Solaris 作業系統：/var/opt/SUNWwbsvr7/setup/WebServer_Install.log

  • Linux 及 HP-UX：/var/opt/sun/webserver7/setup/WebServer_Install.log

可在以下位置找到管理伺服器錯誤記錄： 

  • Solaris 作業系統：/var/opt/SUNWwbsvr7/admin-server/logs/errors

  • Linux 及 HP-UX：/var/opt/sun/webserver7/admin-server/logs/errors

配置檔案目錄

  • Solaris 作業系統：/var/opt/SUNWwbsvr7/https- instance-name/config

  • Linux 及 HP-UX：/var/opt/sun/webserver7/https- instance-name/config

其他疑難排解資訊

本書中的以下資訊有助於進行疑難排解：