疑难解答

本节包括有关日志的详细信息,可帮助您进行故障排除,还包括有关您可能遇到的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快速启动窗口显示“AEM WCM正在启动,正在等待服务器启动……" 如果此消息显示时间较长,请使用默认的4502端口或运行实例的端口,手动将AEM WCM URL输入浏览器窗口:http://localhost:4502/。

此外,日志可能会显示浏览器未启动的原因。

有时,AEM WCM快速启动窗口会显示消息“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-outdoor页面时返回“找不到页面”

适用于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连接器的maxHttpHeaderSize属性控制标头大小的限制。

卸载Adobe Experience Manager

由于AEM安装在单个目录中,因此无需卸载实用程序。 卸载操作与删除整个安装目录一样简单,但卸载AEM的方式取决于您要实现的目标以及使用的永久存储。

如果永久存储嵌入到安装目录中,例如,在默认的TarPM安装中,删除文件夹也会删除数据。

注意

Adobe强烈建议您在删除AEM之前备份存储库。 如果删除整个<cq-installation-directory>,则将删除存储库。 要在删除之前保留存储库数据,请在删除其他文件夹之前,移动或复制<cq-installation-directory>/crx-quickstart/repository文件夹。

如果安装AEM时使用外部存储(例如,数据库服务器),删除文件夹不会自动删除数据,但会删除存储配置,这会使恢复JCR内容变得困难。

JSP文件未在JBoss上编译

如果安装或更新JSP文件以Experience ManagerJBoss,并且未编译相应的Servlet,请确保正确配置了JBoss JSP编译器。 有关信息,请参阅
JBoss](https://helpx.adobe.com/cn/experience-manager/kb/jsps-dont-compile-jboss.html)文章中的[ JSP编译问题。

在此页面上