疑難排解

注意

AEM 6.4已結束延伸支援，本檔案不再更新。 如需詳細資訊，請參閱 技術支援期. 尋找支援的版本 此處.

本節包含可協助您進行疑難排解之記錄的詳細資訊，也包含您可能遇到AEM部分問題的相關資訊。

疑難排解作者效能

在製作例項上分析緩慢的效能可能會變得相當複雜。 作為第一步，需要確定效能正在降低的技術堆棧的級別。

以下決策樹提供了縮小瓶頸的指導。

chlimage_1-75

基本最佳化

chlimage_1-76

配置日誌檔案和審核日誌

AEM會記錄您為疑難排解安裝問題而可能要設定的詳細記錄。 如需詳細資訊，請參閱 使用審核記錄和日誌檔案 區段。

使用詳細選項

啟動AEM WCM時，可以將 — v(verbose)選項添加到命令行，如下所示：java -jar cq-wcm-quickstart-<version>.jar -v。

詳細選項在控制台上顯示一些快速入門日誌輸出，以便用於故障排除。

常見安裝問題

以下章節說明一些安裝問題及其解決方案。

按兩下Quickstart Jar不會產生任何效果，或使用其他程式（例如，歸檔管理器）開啟jar檔案

這通常表示作業系統的案頭環境設定為開啟副檔名為.jar的檔案時出現問題。 也可能表示您尚未安裝Java，或您使用的Java版本不受支援。

由於jar檔案使用普遍的ZIP格式，因此某些存檔程式可能會自動配置案頭以將jar檔案作為存檔檔案開啟。

若要進行疑難排解，請執行下列動作：

  • 再次檢查您是否至少安裝了Java 1.6版。

  • 在AEM WCM快速入門中嘗試上下文菜單（通常按一下滑鼠右鍵），然後選擇「開啟……」."

  • 檢查是否列出了Java或Sun Java，並嘗試運行AEM WCM。 如果您已安裝多個Java版本，請選取支援的版本。

    如果此步驟成功，且您的作業系統提供一個選項，可始終使用所選程式運行.jar檔案，請選中該檔案。 從現在開始，按兩下應該就能運作。

  • 有時重新安裝支援的Java版本有助於恢復正確的關聯。

  • 您始終可以使用命令行或啟動/停止指令碼運行CRX，如本文檔前面所述。

我在CRX上執行的應用程式擲回記憶體不足錯誤

注意

另請參閱 分析記憶體問題.

CRX公司本身的記憶體佔用空間很小。 如果在CRX內運行的應用程式記憶體要求較高，或請求記憶體密集型操作（如大事務），則需要使用適當的記憶體設定來啟動CRX運行的JVM實例。

使用Java命令選項定義JVM的記憶體設定（例如，java -Xmx512m -jar crx*.jar可將heapsize設定為512MB）。

從命令列啟動AEM WCM時，指定記憶體設定選項。 管理AEM WCM啟動的AEM WCM啟動/停止指令碼或自訂指令碼也可修改，以定義所需的記憶體設定。

如果已將堆大小定義為512MB，則可能要通過建立堆轉儲進一步分析記憶體問題：

要在記憶體不足時自動建立堆轉儲，請使用以下命令：

java -Xmx256m -XX:+HeapDumpOnOutOfMemoryError -jar *.jar

這會生成堆轉儲檔案(java_…hprof)，而不是記憶體不足時。 生成堆轉儲後，該進程可繼續運行。 通常，一個堆轉儲檔案就足以分析問題。

按兩下「AEM快速入門」後，瀏覽器中不會顯示「AEM歡迎」畫面

在某些情況下，即使存放庫本身已成功執行，AEM WCM歡迎畫面也不會自動顯示。 這取決於作業系統設定、瀏覽器設定或類似因素。

常見的症狀是AEM WCM Quickstart窗口顯示「AEM WCM正在啟動，等待伺服器啟動……." 如果顯示該訊息的時間相對較長，請使用預設的4502埠或執行個體所在的埠，手動將AEM WCM URL輸入到瀏覽器視窗中：http://localhost:4502/。

此外，記錄檔可能會顯示瀏覽器未啟動的原因。

有時，AEM WCM Quickstart視窗會顯示訊息「AEM WCM running on http://localhost:port/」，而瀏覽器不會自動啟動。 在這種情況下，請按一下「 AEM WCM快速入門」窗口中的URL（它是超連結），或在瀏覽器中手動輸入URL。

如果其他所有項目都失敗，請查看記錄，了解發生的情況。

使用應用程式伺服器進行安裝故障排除

要求geometrixx-outdoor頁面時傳回Page Not Found

適用於WebLogic 10.3.5和JBoss 5.1

當geometrixx-outdoors/en頁面要求傳回404（找不到頁面）時，您可能會重新檢查是否已在這些特定應用程式伺服器所需的sling.properties檔案中設定其他sling屬性。

請參閱 部署AEM Web應用程式 詳細資訊的步驟。

回應標頭大小可以大於4Kb

502錯誤可能表示Web伺服器無法處理AEM HTTP回應標頭的大小。 AEM可產生包含大於4Kb Cookie的HTTP回應標題。 請確定已設定Servlet容器，讓最大回應標頭大小可超過4kb。

例如，對於Tomcat 7.0, HTTP連接器 控制標頭大小的限制。

解除安裝Adobe Experience Manager

由於AEM會安裝至單一目錄，因此不需要解除安裝公用程式。 卸載過程可能與刪除整個安裝目錄一樣簡單，不過卸載AEM的方式取決於您要實現什麼，以及您使用什麼持久儲存。

如果永久儲存嵌入安裝目錄（例如，在預設的TarPM安裝中），則刪除資料夾也會刪除資料。

注意

Adobe強烈建議您先備份儲存庫再刪除AEM。 如果您刪除 <cq-installation-directory>，您將刪除存放庫。 若要在刪除、移動或複製 <cq-installation-directory>/crx-quickstart/repository資料夾，再刪除其他資料夾。

如果安裝AEM時使用外部儲存（例如資料庫伺服器），則刪除資料夾不會自動刪除資料，但會刪除儲存配置，這會使JCR內容的還原變得困難。

JSP檔案未在JBoss上編譯

如果您安裝或更新JSP檔案以在JBoss上Experience Manager，且未編譯對應的servlet，請確保已正確配置JBoss JSP編譯器。 如需詳細資訊，請參閱
JBoss中JSP編譯問題 文章。

本頁內容