疑难解答

本节包含可帮助您进行故障诊断的日志的详细信息,还包含有关您在AEM中可能遇到的一些问题的信息。

创作性能疑难解答

在创作实例上分析缓慢的性能可能会变得相当复杂。 第一步需要确定性能下降的技术堆栈级别。

以下决策树为缩小瓶颈提供了指导。

chlimage_1-75

基本优化

chlimage_1-76

配置日志文件和审核日志

AEM记录您可能需要配置的详细日志,以便对安装问题进行故障诊断。 有关信息,请参阅使用审核记录和日志文件一节。

使用详细选项

启动AEM WCM时,可以向命令行中添加 — v(verbose)选项,如下所示:java -jar cq-wcm-quickstart-<版本>.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正在http://localhost:port/上运行”,并且浏览器不会自动启动。 在这种情况下,单击AEM WCM快速入门窗口中的URL(它是超链接),或在浏览器中手动输入该URL。

如果其他所有操作都失败,请检查日志以了解发生了什么。

使用应用程序服务器进行安装故障排除

请求geometrixx-outdour页面时返回页面未找到

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

卸载Adobe Experience Manager

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

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

注意

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

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

JP文件未在JBoss上编译

如果安装或更新JSP文件以在JBoss上Experience Manager,并且未编译相应的Servlet,请确保正确配置了JBoss JSP编译器。 有关信息,请参阅
JBossarticle中的JSP编译 问题。

在此页面上