发行说明：AEM 6.2 Oak 累积修复包

Oak 累积修复包

与标准的累积修复包类似，用于 Oak 存储库的修复是通过完全受支持的 Oak 累积修复包 (OCFP) 提供的。Oak 累积修复包是独立的（没有依存关系）。您无需担心查找/解决依存关系问题。

为了保持最新的部署，应安装适合您 AEM 版本的最新累积修复包。

如有必要，除了最新的 OCFP 之外，还可以出于验证的目的而生成一个内部诊断版本。前提条件是您正在运行最新的 OCFP。内部诊断版本只提供与热修补程序相同级别的质量保证，因此，它不能提供与累积修复包、Service Pack 或产品版本相同的质量保证。所有正式的 Oak 修复都是以 OCFP 的形式发布的，并且提供了完整支持。

有关 CFP 和其他版本类型的更多信息，请参阅 Maintenance Release Vehicle。

安装说明

Oak 1.4.8 及更高版本的预先部署规程

Oak 累积修复包 1.4.8（及更高版本）包含索引定义。部署 Oak 1.4.8+ CFP 之前，建议您 遵循 下面的预先部署规程，以便在维护窗口期准备相应的索引，因为索引可能是资源密集型的。这属于一次性规程（即，如果您已经在应用 Oak CFP 1.4.8 或更高版本时执行了相关步骤，则无需再次执行）。

重要信息：若要构建索引、Oak 设置，则应当设置一个较高的上限（例如，200000）。另外，这项操作也需要足够的堆空间。 

1. 安装索引定义包 NPR-14064，其中包含异步重新索引的索引定义（不应立即构建新索引）。
2. 对于 Mongo：停止除 1 以外的所有 AEM 实例。
3. 访问这个 url：
   
4. /system/console/jmx/org.apache.jackrabbit.oak%3Aname%3Dasync%2Ctype%3DPropertyIndexAsyncReindex
   
5. 调用 startPropertyIndexAsyncReindex() 以开始索引。
6. 监视日志文件，以查找这则日志消息：
   22.02.2017 11:34:32.602 *INFO* [aysnc-index-update-async-reindex] org.apache.jackrabbit.oak.plugins.index.AsyncIndexUpdate [async-reindex] Reindexing completed for indexes: [/oak:index/externalId*(0), /oak:index/externalPrincipalNames*(0), /oak:index/repMembers*(51)] in 1.085 s
   
7. 通过检查以下更新的属性，验证索引是否已成功构建
   • reindexCount=1
   • async="async-reindex" 将被删除（该索引将切换回同步索引）
8. 应当检查这 3 个索引（也可以检查下面的查询是否没有结果：//element(*, oak:QueryIndexDefinition)[@async = "async-reindex"]
   • /oak:index/repMembers
   • /oak:index/externalPrincipalNames
   • /oak:index/externalId
9. 注意：可以停止构建索引。请转到此 url：
   /system/console/jmx/org.apache.jackrabbit.oak%3Aname%3Dasync%2Ctype%3DIndexStats

异步重新索引期间，将创建存储库检查点。一旦索引任务完成，必须按照下面描述的步骤进行发布，以确保后续顺利回收修订垃圾：

1. 首先，打开 CheckpointManager MBean：
   MongoMK -
   /system/console/jmx/org.apache.jackrabbit.oak%3Aname%3DDocument+node+store+
   checkpoint+management%2Ctype%3DCheckpointManger
   
2. TarMK -
   /system/console/jmx/org.apache.jackrabbit.oak%3Aname%3DSegment+node+store+
   checkpoint+management%2Ctype%3DCheckpointManger
3. 调用 listCheckpoints() 操作，
4. 找到包含“name=async-reindex”属性的检查点行
5. 将其 ID 值复制到剪贴板
   在 MongoMK 中，它看起来类似于：r1234567aaaa-0-1
   在 TarMK 中，它类似于：6eac07d0-fe27-4d16-82f8-6d5da4cefd67
6. 然后打开 releaseCheckpoint() 操作，
7. 将复制的 ID 作为 p1 进行粘贴，然后单击“调用”，
8. 这一步将发布检查点。
   

安装 Oak 累积修复包

0. 确保您已备份数据 1. 前往“工具”，双击“包”以打开 CQ 包管理器 2. 上传并安装修补程序包 3. 重新启动 AEM   如果需要在升级到 AEM 6.2 的环境中部署此补丁，请执行以下步骤：
0. 确保您已备份数据 1. 根据记录的信息，准备源实例并关闭 2. 解压缩 AEM 6.2 快速入门 (java-jar quickstart.jar -unpack) 3. 将修补程序包解压缩到临时位置 4. 将 /jcr_root/libs/system/install/* 移至 /crx-quickstart/install 5. 将 /jcr_root/libs/system/install/crx3/* 移至 /crx-quickstart/install/15 6. 根据记录的信息，继续升级  

可用的 Oak 累积修复包

Oak 1.4.24

Oak 1.4.23

Oak 1.4.22

Oak 1.4.21

Oak 1.4.20

Oak 1.4.19

Oak 1.4.18

Oak 1.4.17

Oak 1.4.16

Oak 1.4.15

Oak 1.4.14

Oak 1.4.13

Oak 1.4.12

Oak 1.4.11

Oak 1.4.10

Oak 1.4.9

Oak 1.4.8

Oak 1.4.7

重要说明

Oak 1.4.7 在外部组（例如，来自 LDPA）成员资格的同步行为中引入了变化：

不再可以将外部组映射到现有的本地组。本地组需要由 IDP 同步进程创建，并且不能再与其他外部 IDP 共享。

这是为了确保划清本地建立的组成员资格与外部成员资格之间的界限，以及确保划清多个 IDP 之间的界限。

与 IDP 的绑定，是通过现在组和用户上完全受保护的 "rep: externalId" 属性来实现的。有关详细信息和迁移解决方案，请参阅：https://issues.apache.org/jira/browse/OAK-4397

Oak 1.4.6

已知问题

• 对于 Oak 1.4.5 之前的版本，由于已知问题（OAK-4538，已在 Oak 1.4.5 中解决），可能会出现 AEM 无法正常停止的情况，对于这种情况，需强制终止 jvm 进程。
• 如果您正在使用 Oak LDAP 集成，那么在应用了最新的 Oak 修补程序后，LDAP 用户同步将不再正常运行。要修复此问题，请转到 /system/console/configMgr，然后更新您的“LDPA 身份提供程序”配置的“自定义属性”属性。通过同步配置中使用的所有 LDAP 属性来更新该属性。例如，这些属性可能是：cn、sn、givenName、mail

有用的资源

• AEM 6.2 发行说明
• AEM 产品页面
• AEM 6.2 文档
• 订阅 Adobe 产品更新早知道