升级前维护任务

在开始升级之前，务必要遵循以下维护任务，以确保系统已准备就绪，并且在出现问题时可以回滚：

确保足够的磁盘空间

执行升级时，除了内容和代码升级活动之外，还需要执行存储库迁移。 迁移将以新的Tar区段格式创建存储库的副本。 因此，您需要足够的磁盘空间来保留第二个可能更大的存储库版本。

完全备份AEM

AEM应在开始升级之前完全备份。 确保备份您的存储库、应用程序安装、数据存储和Mongo实例（如果适用）。 有关备份和恢复AEM实例的更多信息，请参阅备份和恢复。

备份对/etc的更改

升级过程能够很好地从存储库的/apps和/libs路径下维护和合并现有内容和配置。 对/etc路径（包括Context Hub配置）所做的更改，通常需要在升级后重新应用这些更改。 虽然升级将生成任何无法在/var下合并的更改的备份副本，但我们建议在开始升级之前手动备份这些更改。

生成quickstart.properties文件

从jar文件启动AEM时，将在crx-quickstart/conf下生成一个quickstart.properties文件。 如果AEM过去只是使用启动脚本启动，则此文件将不存在，并且升级将失败。 确保检查此文件是否存在，如果不存在，请从jar文件中重新启动AEM。

配置工作流和审核日志清除

WorkflowPurgeTask和com.day.cq.audit.impl.AuditLogMaintenanceTask任务需要单独的OSGi配置，如果没有这些配置，它们将无法正常工作。 如果在升级前任务执行期间失败，则最可能的原因是缺少配置。 因此，如果您不希望运行这些任务，请确保为这些任务添加OSGi配置，或从升级前优化任务列表中完全删除它们。 有关配置工作流清除任务的文档，请访问管理工作流实例和审核日志维护任务配置，可在AEM 6🔗的审核日志维护中找到。

有关在CQ 5.6上清除工作流和审核日志以及在AEM 6.0上清除审核日志的信息，请参阅清除工作流和审核节点。

安装、配置和运行升级前任务

由于AEM允许的自定义级别，环境通常不遵循统一的升级方式。 这就使得创建标准化升级过程变得十分困难。

在以前的版本中，也很难对已停止或无法安全恢复的AEM升级进行升级。 这会导致需要重新启动完整升级过程，或执行了有缺陷的升级而未触发任何警告的情况。

为了解决这些问题，Adobe在升级过程中添加了多项增强功能，使其更具弹性且对用户更友好。 必须手动执行之前的升级前维护任务正在优化和自动执行。 此外，还增加了升级后报告，以便对该过程进行充分审查，希望更容易找到任何问题。

升级前维护任务当前分散在手动部分或完全执行的各种界面上。 AEM 6.3中引入的升级前维护优化使能够以统一的方式触发这些任务并能够按需检查其结果。

升级前优化步骤中包含的所有任务都与AEM 6.0以后的所有版本兼容。

如何设置

在AEM 6.3及更高版本中，快速入门Jar中包含升级前维护优化任务。 如果您从旧版AEM 6升级，则可通过单独的包获取这些包，您可以从包管理器中下载这些包。

您可以在以下位置找到包：

如何使用

PreUpgradeTasksMBean OSGI组件预配置了一系列升级前维护任务，这些任务可一次全部运行。 您可以按照以下过程配置任务：

  1. 通过浏览到https://serveraddress:serverport/system/console/configMgr，转到Web控制台

  2. 搜索“preupgradetasks”，然后单击第一个匹配的组件。 组件的全名为com.adobe.aem.upgrade.prechecks.mbean.impl.PreUpgradeTasksMBeanImpl

  3. 修改需要运行的维护任务列表，如下所示：

    1487758925984

任务列表因用于启动实例的运行模式而异。 以下是每个维护任务所针对的运行模式描述。

任务 运行模式 注释
TarIndexMergeTask crx2
DataStoreGarbageCollectionTask crx2 会进行标记和扫描。 对于共享数据存储，请删除此步骤，并在执行前手动或正确准备实例
。
ConsistencyCheckTask crx2
WorkflowPurgeTask crx2/crx3 必须先配置AdobeGranite工作流清除配置OSGi，然后才能运行。
GenerateBundlesListFileTask crx2/crx3
RevisionCleanupTask crx3 对于AEM 6.0到6.2上的TarMK实例，请手动运行离线修订版清理。
com.day.cq.audit.impl.AuditLogMaintenanceTask crx3 运行前必须配置审核日志清除计划程序OSGi配置。
注意

DataStoreGarbageCollectionTask 正在使用标记和扫描阶段调用数据存储垃圾收集操作（如果使用）。对于使用共享数据存储的部署，请确保重新配置或正确准备实例，以避免删除其他实例引用的项目。 这可能需要在触发此升级前任务之前，在所有实例上手动运行标记阶段。

升级前运行状况检查的默认配置

PreUpgradeTasksMBeanImpl OSGI组件预配置了一个在调用runAllPreUpgradeHealthChecks方法时要执行的升级前运行状况检查标记列表：

  • system - granite维护运行状况检查所使用的标记

  • 预升级 — 这是一个自定义标记，可添加到您设置为在升级前运行的所有运行状况检查中

该列表是可编辑的。 除了标记之外，您还可以使用加号​(+)​和减号​(-)​按钮来添加更多自定义标记，或删除默认的标记。

MBean方法

可使用JMX控制台访问受管Bean功能。

您可以通过以下方式访问MBean:

  1. 转到位于​https://serveraddress:serverport/system/console/jmx​的JMX控制台

  2. 搜索​PreUpgradeTasks​并单击结果

  3. 从​Operations​部分选择任何方法，然后在以下窗口中选择​Invoke。

以下是PreUpgradeTasksMBeanImpl公开的所有可用方法的列表：

方法名称 类型 描述
getAvailablePreUpgradeTasksNames() 信息 显示可用升级前维护任务名称的列表。
getAvailablePreUpgradeHealthChecksTagNames() 信息 显示升级前运行状况检查标记名称的列表。
runAllPreUpgradeTasks() 动作 运行列表中的所有升级前维护任务。
runPreUpgradeTask(preUpgradeTaskName) 动作 运行升级前维护任务，并将给定的名称作为参数。
isRunAllPreUpgradeTaskRunning() ACTION_INFO 检查runAllPreUpgradeTasksmaintenance任务当前是否正在运行。
getAnyPreUpgradeTaskRunning() ACTION_INFO 检查当前是否正在运行任何升级前维护任务，
返回一个包含当前正在运行任务名称的数组。
getPreUpgradeTaskLastRunTime(preUpgradeTaskName) 动作 显示升级前维护任务的确切运行时间，其名称为参数。
getPreUpgradeTaskLastRunState(preUpgradeTaskName) 动作 显示升级前维护任务的上次运行状态，其名称为参数。
runAllPreUpgradeHealthChecks(shutDownOnSuccess) 动作

运行所有升级前运行状况检查，并将其状态保存在sling主路径中名为preUpgradeHCStatus.properties的文件中。 如果将shutDownOnSuccess参数设置为true，则AEM实例将被关闭，但前提是所有升级前运行状况检查都处于“正常”状态。

属性文件将用作任何将来升级的先决条件
，如果升级前运行状况检查
执行失败，则升级过程将停止。 如果仍要忽略预升级
运行状况检查的结果并启动升级，则可以删除该文件。
detectUsageOfUnavailableAPI(aemVersion) 动作 列出在
升级到指定AEM版本时不再满足的所有导入包。 目标AEM版本必须
作为参数给定。
注意

MBean方法可通过以下方式调用：

  • JMX控制台
  • 连接到JMX的任何外部应用程序
  • cURL

禁用自定义登录模块

注意

仅当您从AEM 5版本升级时，才需要执行此步骤。 可以完全跳过该页面，以便从旧版AEM 6进行升级。

在Apache Oak中，自定义LoginModules的配置方式已发生根本性改变，可在存储库级别进行身份验证。

在使用CRX2配置的AEM版本中，将配置放置在repository.xml文件中，而从AEM 6开始，将通过Web控制台在Apache Felix JAAS配置工厂服务中进行配置。

因此，升级后必须禁用并为Apache Oak重新创建任何现有配置。

要禁用repository.xml的JAAS配置中定义的自定义模块，您需要修改配置以使用默认的LoginModule，如以下示例所示：

<Security >
             ....
          <!--
                 Use LoginModule authenticating against repository itself
                 -->
                 <LoginModule class = "com.day.crx.core.CRXLoginModule" >
                     <param name = "anonymousId" value = "anonymous" />
                     <param name = "adminId" value ="admin" />
                     <param name = "disableNTLMAuth" value = "true" />
                     <param name = "tokenExpiration" value = "43200000" />
                     <!-- param name="trust_credentials_attribute" value="d5b9167e95dad6e7d3b5d6fa8df48af8"/
                -->
                 </LoginModule >
         </ Security>
注意

有关更多信息，请参阅使用外部登录模块进行身份验证。

有关AEM 6中LoginModule配置的示例，请参阅使用AEM 6配置LDAP。

从/install目录中删除更新

注意

在关闭AEM实例后，仅从crx-quickstart/install目录中删除包。 在开始就地升级过程之前，这将是最后的步骤之一。

删除已通过本地文件系统上的crx-quickstart/install目录部署的所有Service Pack、功能包或修补程序。 这将防止在更新完成后，在新AEM版本之上意外安装旧修补程序和Service Pack。

停止任何冷备用实例

如果使用TarMK冷备用，请停止任何冷备用实例。 这将保证在升级中出现问题时，有效地恢复在线状态。 成功完成升级后，需要从已升级的主实例重建冷备用实例。

禁用自定义计划作业

禁用应用程序代码中包含的任何OSGi计划作业。

执行脱机修订版清理

注意

此步骤仅对于TarMK安装是必需的

如果使用TarMK，则应在升级前执行脱机修订版清理。 这将使存储库迁移步骤和后续升级任务的执行速度大大提高，并有助于确保在升级完成后能够成功执行在线修订版清理。 有关运行脱机修订版清理的信息，请参阅执行脱机修订版清理。

执行数据存储垃圾收集

注意

仅对于运行crx3的实例，此步骤是必需的

在CRX3实例上运行修订清理后，您应该运行数据存储垃圾收集以删除数据存储中任何未引用的Blob。 有关说明，请参阅数据存储垃圾收集文档。

删除可能阻碍升级的用户

注意

只有在以下情况下，才需要执行此升级前维护任务：

  • 您是从AEM 6.3以前的版本升级
  • 在升级过程中，您会遇到以下任何错误。

有些例外情况是，服务用户在旧版AEM中可能被错误地标记为常规用户。

如果发生这种情况，升级将失败，并出现如下消息：

ERROR [Apache Sling Repository Startup Thread] com.adobe.granite.repository.impl.SlingRepositoryManager Exception in a SlingRepositoryInitializer, SlingRepository service registration aborted
java.lang.RuntimeException: Unable to create service user [communities-utility-reader]:java.lang.RuntimeException: Existing user communities-utility-reader is not a service user.

要解决此问题，请确保执行以下操作：

要解决此问题，请确保执行以下操作：

  • 将实例与生产流量分离
  • 创建导致问题的用户的备份。 您可以通过包管理器执行此操作。 有关更多信息，请参阅如何使用包。
  • 删除导致问题的用户。 以下是可能属于此类别的用户列表：
    • dynamic-media-replication
    • communities-ugc-writer
    • communities-utility-reader
    • communities-user-admin
    • oauthservice
    • sling-scripting

如果需要，请升级数据库模式

通常，用于持久性的基础Apache Oak堆栈AEM将在需要时负责升级数据库架构。

但是，当架构无法自动升级时，可能会出现这些情况。 这些环境通常是高安全性环境，数据库在权限非常有限的用户下运行。 如果发生这种情况，AEM将继续使用旧架构。

为防止出现这种情况，您需要按照以下过程升级架构：

  1. 关闭需要升级的AEM实例。

  2. 升级数据库模式。 请查阅您的数据库类型的文档，以了解实现此目的所需使用的工具。

    有关Oak如何处理模式升级的更多信息，请参阅Apache网站🔗上的此页面。

  3. 继续升级AEM。

旋转日志文件

我们建议您在开始升级之前存档当前日志文件。 这样，在升级期间和升级后便可以更轻松地监视和扫描日志文件，以识别和解决可能出现的任何问题。

在此页面上