升级后检查和疑难解答

升级后检查

就地升级之后,应执行以下活动以完成升级。 假定AEM已从6.4 jar启动,并且已部署升级的代码库。

验证升级成功日志

upgrade.log

过去,检查实例的升级后状态需要仔细检查各种日志文件、存储库的部分和启动板。 生成升级后报告有助于在上线前检测有缺陷的升级。

此功能的主要目的是减少需要跨多个端点手动解释或复杂的解析逻辑才能确定升级成功与否。 该解决方案旨在为外部自动化系统提供明确的信息,以便对更新的成功或已识别的失败做出反应。

更具体地说,它确保:

  • 升级框架检测到的升级失败可以集中在单个升级报告中;
  • 升级报告包括关于必要手动干预的指标。

为了适应这种情况,已对upgrade.log文件中生成日志的方式进行了更改。

以下是示例报告,在升级过程中不显示错误:

1487887443006

以下是一个示例报告,其中显示了升级过程中未安装的捆绑包:

1487887532730

error.log

使用目标版本jar开始AEM期间和之后,应仔细查看error.log。 应查看任何警告或错误。 一般而言,最好在日志的开头查找问题。 日志后面出现的错误实际上可能是根源的副作用,而根源在文件早期被调用。 如果出现重复的错误和警告,请参见下面的分析升级问题

验证OSGi捆绑

导航到OSGi控制台/system/console/bundles并查看是否未启动任何捆绑包。 如果任何捆绑包处于安装状态,请咨询error.log以确定根问题。

验证Oak版本

升级后,您应看到Oak版本已更新为​1.8.2。 要验证Oak版本,请导航到OSGi控制台,并查看与Oak捆绑包相关的版本:Oak Core、Oak Commons、Oak Segment Tar。

InspectPreUpgradeBackup文件夹

在升级过程中,AEM将尝试备份自定义项并将它们存储在/var/upgrade/PreUpgradeBackup/<time-stamp-of-upgrade>下。 要以CRXDE Lite视图此文件夹,您可能需要临时启用CRXDE Lite

具有时间戳的文件夹应具有名为mergeStatus的属性,其值为COMPLETEDto-process​文件夹应为空,并且​被覆盖的​节点指示在升级过程中被覆盖的节点。 pecults​节点下的内容表示升级期间无法安全合并的内容。 如果您的实施依赖于任何子节点(并且升级的代码包尚未安装),则需要手动合并这些节点。

如果在“级”或“生产”CRXDE Lite上,则禁用本练习后的环境。

页面的初始验证

对AEM中的多个页面执行初始验证。 如果升级创作环境,请打开开始页和欢迎页(/aem/start.html, /libs/cq/core/content/welcome.html)。 在“作者”和“发布”环境上,打开几个应用程序页面并进行烟雾测试,它们可以正确呈现。 如果出现任何问题,请咨询error.log以进行疑难解答。

应用AEM Service Pack

应用任何相关的AEM 6.4 Service Pack(如果已发布)。

迁移AEM功能

AEM中的一些功能需要升级后执行其他步骤。 在升级代码和自定义页上可以找到在AEM 6.4中迁移这些功能和步骤的完整列表。

验证计划维护配置

启用数据存储垃圾收集

如果使用文件数据存储,请确保已启用“数据存储垃圾收集任务”并将其添加到“每周维护列表”。 此处列出说明

注意

对于S3自定义数据存储安装或使用共享数据存储时,不建议这样做。

启用联机修订清理

如果使用MongoMK或新的TarMK段格式,请确保启用修订清理任务并将其添加到每日维护列表。 此处列出的说明

执行测试计划

根据​测试过程​部分下定义的升级代码和自定义执行详细的测试计划。

启用复制代理

发布环境完全升级和验证后,在创作环境上启用复制代理。 验证代理是否能够连接到相应的发布实例。 有关事件顺序的更多详细信息,请参阅升级过程

启用自定义计划作业

此时,可以启用作为代码库一部分的任何计划作业。

分析升级的问题

本节包含升级到AEM 6.4过程中可能遇到的一些问题方案。

这些方案应有助于跟踪与升级相关问题的根本原因,并有助于确定项目或产品特定问题。

升级后重新创建Dynamic Media云配置

从早期版本升级到AEM 6.4后,早期设置中的Dynamic Media云配置可能无法从AEM 6.4 TouchUI访问。 要解决此问题,请使用CRXDE Lite删除之前的设置,然后创建新的Dynamic Media云配置。 另请参见AEM 6.4](/docs/experience-manager-64/sites-deploying/dynamicmedia-repository-restructuring-in-aem-6-4.html?lang=zh-Hans)中的[Dynamic Media存储库重组。

存储库迁移失败

从CRX2到Oak的文档迁移对于任何以基于CQ 5.4的源实例开始的情况都应可行。请确保准确遵循此中的升级说明(包括准备repository.xml),确保没有通过JAAS启动自定义身份验证器,并且在开始迁移之前已检查实例是否不一致。

如果迁移仍然失败,您可以通过检查upgrade.log ,找出根本原因。 如果问题尚未知,请向客户支持报告。

升级未运行

在开始准备步骤之前,请确保首先使用java -jar aem-quickstart.jar命令执行​source​实例。 这是必需的,以确保正确生成quickstart.properties文件。 如果缺少,则升级将不起作用。 或者,您也可以查看源实例安装文件夹中的crx-quickstart/conf下方,检查文件是否存在。 此外,启动AEM以启动升级时,必须使用java -jar aem-quickstart.jar命令执行该升级。 从开始脚本启动不会在升级模式下开始AEM。

包和包无法更新

如果升级期间无法安装包,则它们包含的包也不会更新。 此问题类别通常由数据存储配置错误引起。 它们还将在error.log中显示为​ERROR​和​WARN​消息。 由于大多数情况下默认登录可能无法工作,因此您可以直接使用CRXDE来检查和查找配置问题。

某些AEM捆绑包未切换到活动状态

如果捆绑包未启动,您应检查是否存在任何未满足的依赖关系。

如果存在此问题,但此问题基于包安装失败,导致包无法升级,则它们将被视为与新版本不兼容。 有关如何对此问题进行故障诊断的详细信息,请参阅上面的​包和包失败更新

还建议将最新AEM 6.4实例的捆绑列表与升级实例进行比较,以检测未升级的捆绑包。 这将提供error.log中要搜索内容的更近范围。

自定义捆绑不切换到活动状态

如果您的自定义捆绑包未切换到活动状态,则很可能有未导入更改API的代码。 这通常会导致不满足的依赖关系。

删除的API应在以前的某个版本中标记为已弃用。 您可以在此弃用通知中找到有关直接迁移代码的说明。 Adobe旨在尽可能实现语义版本控制,以便版本可以指示不断更改。

最好还检查导致问题的更改是否绝对必要,如果不必要,还可以还原。 另外,检查在严格的语义版本控制下,包导出的版本增加是否超出必要。

故障平台UI

如果升级后某些UI功能无法正常工作,您应首先检查界面的自定义叠加。 某些结构可能已更改,叠加可能需要更新或已过时。

然后,检查是否有任何Javascript错误,这些错误可以跟踪到已连接到客户端库的自定义添加的扩展。 同样,自定义CSS也可能会导致AEM布局出现问题。

最后,检查Javascript可能无法处理的配置错误。 通常情况下,不正确取消激活扩展。

自定义组件、模板或UI扩展功能出现故障

在大多数情况下,这些问题的根本原因与未启动的捆绑包或未安装包的根本原因相同,只与首次使用组件时发生的问题开始有所不同。

处理错误的自定义代码的方法是首先进行烟雾测试,以确定原因。 找到后,请查看文章[link]部分中的建议,了解修复建议的方法。

在etc下缺少自定义项

/apps 并且 /libs 升级处理得很好,但升级后 /etc 的更改可能需要手动 /var/upgrade/PreUpgradeBackup 恢复。确保检查此位置,以找到需要手动合并的任何内容。

分析error.log和upgrade.log

在大多数情况下,需要查阅日志以查找错误的原因。 但是,在进行升级时,也必须监视依赖关系问题,因为旧的捆绑包可能无法正确升级。

执行此操作的最佳方法是删除所有与您所面临的问题无关的消息,从而删除error.log。 您可以通过使用以下工具(如grep)执行此操作:

grep -v UnrelatedErrorString

某些错误消息可能不会立即解释。 在这种情况下,查看发生错误的上下文也有助于了解错误的创建位置。 您可以使用以下方法分隔错误:

  • grep -B 在错误前添加行;

  • grep -A 的双曲余切值。

在少数情况下,还可以找到WARN消息,因为可能存在导致此状态的有效案例,并且应用程序并不总是能够确定这是否为实际错误。 请确保也查阅这些邮件。

联系Adobe支持

如果您已经听取了本页中的建议,但仍然遇到问题,请联系Adobe支持。 要向处理您案例的支持工程师提供尽可能多的信息,请确保从升级中包含upgrade.log文件。

在此页面上