疑難排解AEM的安裝問題

上次更新: 2023-05-26
  • 主題:
  • Deploying
    檢視有關此主題的更多資訊
  • 建立對象:
  • Developer

本節包含可協助您進行疑難排解的記錄詳細資訊,也包含您可能在AEM中遇到的一些問題的資訊。

疑難排解作者效能

在編寫執行個體上分析緩慢的效能可能會變得複雜。 第一步是弄清楚效能下降的技術棧疊層次。

下列決策樹提供縮小瓶頸的指引。

chlimage_1-75

基本最佳化

chlimage_1-76

設定記錄檔和稽核記錄

AEM會記錄您可能想要設定以疑難排解安裝問題的詳細記錄。 如需詳細資訊,請參閱 使用稽核記錄和記錄檔 區段。

使用詳細選項

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

詳細資訊選項會在主控台上顯示一些「快速入門」記錄輸出,以便用於疑難排解。

常見安裝問題

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

連按兩下「快速入門jar」沒有任何效果,或使用其他程式(例如archive manager)開啟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設定為512 MB)。

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

如果您已將棧大小定義為512 MB,則建議您建立棧積傾印以進一步分析記憶體問題:

要在記憶體不足時自動建立棧積傾印,請使用以下命令:

java -Xmx256m -XX:+HeapDumpOnOutOfMemoryError -jar &ast;.jar

此方法會產生棧積傾印檔案(java_…hprof)只要處理序的記憶體用盡。 產生棧積傾印後,該程式可能會繼續執行。 通常,一個棧積傾印檔案就足以分析問題。

連按兩下AEM Quickstart後,瀏覽器中不會顯示AEM歡迎畫面

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

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

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

有時AEM WCM快速入門視窗會顯示訊息「AEM WCM在http://localhost:port/上執行」,且瀏覽器不會自動啟動。 在此情況下,請按一下AEM WCM Quickstart視窗中的URL (超連結)或在瀏覽器中手動輸入URL。

如果其他所有操作失敗,請檢視記錄檔以瞭解已發生的情況。

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

在Java™ 11上執行AEM 6.5有一個已知問題,網站可能無法載入或間歇性失敗。

如果發生此問題,請執行以下作業:

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

  2. 找到下列行:

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

  3. 以下列專案取代:

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

  4. 重新啟動執行個體。

應用程式伺服器的安裝疑難排解

請求geometrixx-outdoor頁面時傳回「找不到頁面」

適用於WebLogic 10.3.5和JBoss® 5.1

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

在中檢視 部署AEM Web應用程式 詳細資訊的步驟。

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

502錯誤可能表示網頁伺服器無法處理AEM HTTP回應標頭的大小。 AEM可產生包含大小超過4 KB之Cookie的HTTP回應標頭。 請確定您的servlet容器已設定為回應標頭大小上限可超過4 KB。

例如,在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上編譯®

如果您安裝或更新要Experience Manager在JBoss®上的JSP檔案,但未編譯對應的servlet,請確定JBoss® JSP編譯器已正確設定。 如需詳細資訊,請參閱
JBoss中的JSP編譯問題® 文章。

此頁面上的