疑難排解

本節包含可協助您疑難排解之記錄檔的詳細資訊,並包含有關您可能在AEM中遇到之部分問題的資訊。

疑難排解作者效能

分析編寫例項的效能變得相當複雜。 首先需要確定效能正在下降的技術堆疊級別。

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

chlimage_1-75

基本優化

chlimage_1-76

配置日誌檔案和審核日誌

AEM會記錄詳細記錄,您可能想要設定這些記錄,以疑難排解安裝問題。 有關資訊,請參閱使用審計記錄和日誌檔案部分。

使用詳細選項

當您啟動AEM WCM時,可將-v(verbose)選項新增至命令列,如:java -jar cq-wcm-quickstart-<version>.jar -v.

詳細選項顯示控制台上的一些快速啟動日誌輸出,以便用於故障排除。

常見安裝問題

下節將說明某些安裝問題及其解決方案。

按兩下快速啟動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&ast;.jar將heapsize設為512MB)。

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

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

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

java -Xmx256m -XX:+HeapDumpOnOutOfMemoryError -jar &ast;.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。

如果其他一切都失敗,請查看記錄,以瞭解發生了什麼。

使用Java 11時,網站不會載入或間歇性失敗

在Java 11上執行的AEM 6.5有已知問題,網站可能不會偶爾載入或失敗。

如果發生此情況,請遵循下列解決方法:

  1. 開啟crx-quickstart/conf/資料夾下的sling.properties檔案

  2. 找到以下行:

    org.osgi.framework.bootdelegation=sun.,com.sun.

  3. 以下列方式取代:

    org.osgi.framework.bootdelegation=sun.,com.sun.,jdk.internal.reflect,jdk.internal.reflect.*

  4. 重新啟動實例。

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

請求geometrixx-outdour頁面時傳回頁面找不到

適用於WebLogic 10.3.5和JBoss 5.1

當geometrixx-outdoors/en page的請求傳回404(Page Not Foun)時,您可重新檢查您是否已在這些特定Application Servers所需的sling.properties檔案中設定其他sling屬性。

如需詳細資訊,請參閱​部署AEM網頁應用程式​步驟。

響應報頭大小可以大於4Kb

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

例如,對於Tomcat 7.0,HTTP Connector的maxHttpHeaderSize屬性控制標題大小的限制。

解除安裝Adobe Experience Manager

由於AEM會安裝在單一目錄中,所以不需要解除安裝公用程式。 解除安裝可能就像刪除整個安裝目錄一樣簡單,不過解除安裝AEM的方式取決於您要達到的目的,以及您使用的永續儲存空間。

如果永久儲存嵌入安裝目錄(例如,在預設TarPM安裝中),則刪除資料夾也會刪除資料。

注意

Adobe強烈建議您在刪除AEM之前先備份儲存庫。 如果刪除整個<cq-installation-directory>,將刪除儲存庫。 要保留儲存庫資料,請在刪除其他資料夾之前,將<cq-installation-directory>/crx-quickstart/repository資料夾移動或複製到其他位置。

如果您的AEM安裝使用外部儲存(例如資料庫伺服器),移除資料夾並不會自動移除資料,但會移除儲存設定,因此很難還原JCR內容。

JSP檔案未在JBoss上編譯

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

本頁內容

Adobe Summit Banner

A virtual event April 27-28.

Expand your skills and get inspired.

Register for free
Adobe Summit Banner

A virtual event April 27-28.

Expand your skills and get inspired.

Register for free
Adobe Maker Awards Banner

Time to shine!

Apply now for the 2021 Adobe Experience Maker Awards.

Apply now
Adobe Maker Awards Banner

Time to shine!

Apply now for the 2021 Adobe Experience Maker Awards.

Apply now