升级前维护任务
在开始升级之前，请务必遵循这些维护任务，以确保系统已准备就绪，并且可以在出现问题时回滚：
确保有足够的磁盘空间
在执行升级时，除了内容和代码升级活动之外，还必须执行存储库迁移。 迁移过程会以新的Segment Tar格式创建存储库的副本。 因此，您需要足够的磁盘空间来保留存储库的第二个可能更大的版本。
完全备份AEM
在开始升级之前，应完全备份AEM。 确保备份存储库、应用程序安装、数据存储和Mongo实例（如果适用）。 有关备份和恢复AEM实例的详细信息，请参阅 备份和恢复.
将更改备份到/etc
升级过程很好地维护和合并了下的现有内容和配置 /apps 和 /libs 存储库中的路径。 对于所做的更改 /etc 路径（包括Context Hub配置），通常需要在升级后重新应用这些更改。 当升级时，会为其无法合并的任何更改创建备份副本 /var，Adobe建议您在开始升级之前手动备份这些更改。
生成快速入门.properties文件
从jar文件启动AEM时， quickstart.properties 文件生成于 crx-quickstart/conf. 如果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中包含升级前维护优化任务。
如何使用
此 PreUpgradeTasksMBean OSGI组件预配置了一个可以一次运行所有升级前维护任务的列表。 您可以按照以下步骤配置任务：
-
通过浏览至Web控制台 https://serveraddress:serverport/system/console/configMgr
-
搜索“”预升级任务“”，然后单击第一个匹配的组件。 组件的全名为
com.adobe.aem.upgrade.prechecks.mbean.impl.PreUpgradeTasksMBeanImpl -
修改必须运行的维护任务列表，如下所示：
根据用于启动实例的运行模式，任务列表会有所不同。 以下是对每个维护任务所针对的运行模式的描述。
| 任务 | 运行模式 | 注释 |
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 方法名为：
-
系统 - granite维护运行状况检查使用的标记
-
预升级 — 一个自定义标记，可添加到所有可设置为在升级前运行的运行状况检查中
该列表是可编辑的。 您可以使用加号 (+) 和减号 (-) 按钮以添加更多自定义标记，或删除默认标记。
MBean方法
可以使用访问受管Bean功能 JMX控制台.
可以通过以下方式访问MBean：
-
转到位于的JMX控制台 https://serveraddress:serverport/system/console/jmx
-
搜索 PreUpgradeTasks 并单击结果
-
从中选择任意方法 操作 部分并选择 调用 在下面的窗口中。
以下列出了 PreUpgradeTasksMBeanImpl 公开：
| 方法名称 | 类型 | 描述 |
getAvailablePreUpgradeTasksNames() |
信息 | 显示可用的升级前维护任务名称的列表。 |
getAvailablePreUpgradeHealthChecksTagNames() |
信息 | 显示升级前运行状况检查标记名称的列表。 |
runAllPreUpgradeTasks() |
动作 | 运行列表中的所有升级前维护任务。 |
runPreUpgradeTask(preUpgradeTaskName) |
动作 | 运行升级前维护任务，其名称作为参数给定。 |
isRunAllPreUpgradeTaskRunning() |
ACTION_INFO | 检查 runAllPreUpgradeTasksmaintenance 任务正在运行。 |
getAnyPreUpgradeTaskRunning() |
ACTION_INFO | 检查是否有任何升级前维护任务正在运行，并且 返回一个数组，其中包含当前正在运行的任务的名称。 |
getPreUpgradeTaskLastRunTime(preUpgradeTaskName) |
动作 | 显示升级前维护任务的确切运行时间，其名称作为参数给出。 |
getPreUpgradeTaskLastRunState(preUpgradeTaskName) |
动作 | 显示升级前维护任务的上次运行状态，其名称作为参数给出。 |
runAllPreUpgradeHealthChecks(shutDownOnSuccess) |
动作 | 运行所有升级前运行状况检查，并将其状态保存在名为的文件中 属性文件用作任何未来升级的先决条件 |
detectUsageOfUnavailableAPI(aemVersion) |
动作 | 列出在下列情况下不再满足的所有导入资源包 升级到指定的AEM版本。 目标AEM版本必须为 以参数形式给出。 |
可以通过以下方式调用MBean方法：
- JMX控制台
- 连接到JMX的任何外部应用程序
- cURL
禁用自定义登录模块
仅当从AEM 5版本升级时，才需要执行此步骤。 从旧版AEM 6升级时，可以完全跳过该步骤。
自定义方式 LoginModules 配置为在存储库级别进行身份验证，这在Apache Oak中发生了根本性变化。
在使用CRX2配置的AEM版本中，将放在 repository.xml 文件，而从AEM 6开始，它是通过Web控制台在Apache Felix JAAS Configuration Factory服务中完成的。
因此，在升级后，必须禁用任何现有配置并重新创建Apache Oak。
禁用的JAAS配置中定义的自定义模块 repository.xml，您必须编辑配置才能使用默认设置 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>
有关更多信息，请参阅 使用外部登录模块进行身份验证.
例如 LoginModule AEM 6中的配置，请参见 使用AEM 6配置LDAP.
从/install目录中删除更新
仅在关闭AEM实例后从crx-quickstart/install目录中删除包。 此步骤是开始就地升级过程之前的最后一个步骤。
删除通过部署的所有Service Pack、功能包或修补程序 crx-quickstart/install 目录。 这样做可防止在更新完成后在新AEM版本之上意外安装旧修补程序和Service Pack。
停止任何冷备用实例
如果使用TarMK冷备用，请停止任何冷备用实例。 这样做可以确保升级过程中出现问题时恢复在线的有效方式。 成功完成升级后，必须从升级的主实例重建冷备用实例。
禁用自定义计划作业
禁用应用程序代码中包含的任何OSGi计划作业。
执行脱机修订版清理
只有TarMK安装才需要此步骤
如果使用TarMK，则在升级之前应运行脱机修订版清理。 这样做可以大大加快存储库迁移步骤和后续升级任务的执行速度，并有助于确保在线修订版清理在升级完成后可以成功执行。 有关运行脱机修订版清理的信息，请参阅 正在执行脱机修订清理.
执行数据存储垃圾收集
只有运行crx3的实例才需要此步骤
在CRX3实例上运行修订清理后，您应该运行数据存储垃圾收藏集以删除数据存储中的任何未引用Blob。 有关说明，请参阅以下文档： 数据存储垃圾收集.
根据需要升级数据库模式
通常，如果需要，AEM用于持久性的基础Apache Oak栈栈会负责升级数据库架构。
但是，在架构无法自动升级时可能会出现这种情况。 此类情况大多是高安全性环境，其中数据库在权限有限的用户下运行。 如果发生这种情况，AEM将继续使用旧架构。
要防止发生这种情况，请执行以下操作来升级架构：
-
关闭必须升级的AEM实例。
-
升级数据库模式。 请参阅数据库类型的文档，了解获得结果所需的工具。
有关Oak如何处理模式升级的更多信息，请参阅 Apache网站上的此页面.
-
继续升级AEM。
删除可能妨碍升级的用户
只有在以下情况下，才需要执行此升级前维护任务：
- 您正在从AEM 6.3之前的AEM版本升级
- 在升级过程中，您会遇到以下提到的任何错误。
在极少数情况下，服务用户的最终版本较旧的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-replicationcommunities-ugc-writercommunities-utility-readercommunities-user-adminoauthservicesling-scripting
轮换日志文件
Adobe建议在开始升级之前存档当前的日志文件。 这样，在升级期间和升级后，可以更轻松地监视和扫描日志文件，以识别并解决可能出现的任何问题。
