修订版清理 revision-cleanup

TarMK的持久性格式随AEM 6.5而变化。这些更改不需要主动迁移步骤。 现有存储库会经历滚动迁移，这对于用户是透明的。 首次访问AEM 6.5（或相关工具）存储库时，将启动迁移过程。

迁移到AEM 6.5持久性格式后，存储库无法恢复为以前的AEM 6.3持久性格式。

在AEM 6.3中，需要对存储格式进行更改，特别是为了提高在线修订清理的性能和效率。 这些更改无法向后兼容，且必须迁移使用旧Oak区段(AEM 6.2及更低版本)创建的存储库。

更改存储格式的其他好处：

• 更好的可扩展性（优化的区段大小）。
• 更快的数据存储垃圾收集.
• 为未来的增强功能做基础工作。

脱机修订清理正在回收除最新一代以外的所有内容，而联机修订清理则使用最新两代。 如果存在新的存储库，则联机修订版清理在脱机修订版清理后首次执行时不会回收任何空间，因为没有足够旧的层代可以回收。

此外，请阅读本章的“脱机修订清理后运行联机修订清理”一节。

因素为：

• 存储库大小
• 在系统上加载（每分钟请求数，特别是写操作）
• 活动模式（读取与写入）
• 硬件规格（CPU性能、内存、IOPS）

在联机修订清理期间，会持续监视磁盘空间。 如果可用磁盘空间下降到临界值以下，则该过程将取消。 关键值是存储库当前磁盘占用空间的25%，无法对其进行配置。

Adobe建议磁盘大小至少比最初估计的存储库大小大两到三倍。

在清理过程中，会持续监控可用栈空间。 如果可用栈空间下降到临界值以下，则取消该进程。 临界值通过org.apache.jackrabbit.oak.segment.SegmentNodeStoreService#MEMORY_THRESHOLD配置。 默认值为15%。

Recommendations的最小压缩栈大小与AEM内存大小调整建议没有区分。 通常： 如果AEM实例的大小足以处理用例及其预期的有效负载，则清理过程将获得足够的内存。

• 确保每天执行该操作。
• 通过相应地配置操作仪表板中的维护窗口，确保在最小的存储库活动期间执行该操作。
• 扩展系统资源（CPU、内存、I/O）。

修订清理依赖估计阶段来确定是否有足够的垃圾要清理。 估算器将当前大小与上次压缩后的存储库大小进行比较。 如果大小超过配置的增量，则运行清理。 大小增量设置为1 GB。 这实际上意味着，如果自上次清理运行以来，存储库大小没有增加1 GB，则会跳过新的修订版清理迭代。

以下为估计阶段的相关日志条目：

• 修订GC运行： 大小增量为N%或N/N （N/N字节），因此正在运行压缩
• 修订GC 未 运行： 大小增量为N%或N/N （N/N字节），因此现在将跳过压缩

如果系统中存在写并发，联机修订版清理可能需要独占写入权限，才能在压缩周期结束时提交更改。 系统进入 forceCompact模式，如Oak文档中详述。 在强制压缩期间，获得排他性写锁定以最终提交更改，而不受任何并行写干扰。 要限制对响应时间的影响，可以定义超时值。 默认情况下，此值设置为1分钟，这意味着如果强制压缩未在一分钟内完成，则压缩过程将中止，以支持并发提交。

力压缩的持续时间取决于以下因素：

• 硬件：特定于IOPS。 持续时间会随着IOPS的增加而缩短。
• 区段存储大小：持续时间会随着区段存储的大小而增加。

在冷备用设置中，只有主实例必须配置为运行在线修订清理。 在备用实例上，无需特别计划联机修订版清理。

备用实例上的相应操作是“自动清理” — 这与“在线修订清理”的清理阶段相对应。 在主实例上执行联机修订版清理后，在备用实例上运行自动清理。

估算和压缩阶段不会在备用实例上运行。

脱机修订版清理可以立即删除旧修订，而联机修订版清理必须考虑应用程序栈栈仍在引用的旧修订。 因此，前者可以比后者更积极地去除垃圾，其效果在几个垃圾收集循环过程中被摊销。

此外，请阅读本章的“脱机修订清理后运行联机修订清理”一节。

• 在Windows环境 上，始终强制定期文件访问，因此不使用内存映射访问。 作为一般建议，应将所有可用的RAM分配给栈，并增加segmentCache大小。 您可以通过将segmentCache.size选项添加到org.apache.jackrabbit.oak.segment.SegmentNodeStoreService.config来增加segmentCache(例如，segmentCache.size=20480)。 切记不要为操作系统和其他进程留出一些RAM。
• 在非Windows环境中，增加物理内存的大小以改进存储库的内存映射。

• 启用“联机修订清理”后，应监视磁盘空间。 清理不会运行，或者在磁盘空间不足时提前终止。
• 检查联机修订版清理的完成时间日志。 此过程不应超过2个小时。
• 检查点数。 如果在压缩运行时有3个以上的检查点，建议清理检查点。

您可以通过检查日志来检查联机修订清理是否成功完成。

例如，“TarMK GC #{}: compaction completed in {} ({} ms), after {} cycles”表示压缩步骤成功完成，除非在之前显示消息“TarMK GC #{}: compaction gave up compacting concurrent commits after {} cycles”，这意味着并发负载过多。

相应地，出现一条消息“TarMK GC #{}: cleanup completed in {} ({} ms”，表示清理步骤成功完成。

通过JMX (SegmentRevisionGarbageCollection MBean)公开状态、进度和统计信息。 有关SegmentRevisionGarbageCollection MBean的更多详细信息，请阅读以下段落。

可以通过的EstimatedRevisionGCCompletion属性跟踪进度 SegmentRevisionGarbageCollection MBean.

您可以使用ObjectName org.apache.jackrabbit.oak:name="Segment node store revision garbage collection",type="SegmentRevisionGarbageCollection"获取MBean的引用。

统计信息仅在上次系统启动后可用。 外部监视工具可用于将数据保留在AEM正常运行时间之外。

• 联机修订清理已启动/停止
  • 在线修订清理由三个阶段组成：估算、压缩和清理。 如果存储库未包含足够的垃圾，则估算可能会强制跳过压缩和清理。 在最新版本的AEM中，消息“TarMK GC #{}: estimation started”标记估算的开头，“TarMK GC #{}: compaction started, strategy={}”标记压缩的开头，“TarMK GC #{}: cleanup started. Current repository size is {} ({} bytes”标记清理的开头。
• 通过修订清理获得的磁盘空间
  • 仅在清理阶段完成时才回收空间。 清理阶段的结束用日志消息“TarMK GC #{}: cleanup completed in {} ({} ms”标记。 Post清理大小为{} （{}字节），已回收空间{} （{}字节）。 压缩映射权重/深度为{}/{} （{}字节/{}）。
• 修订清理期间出现问题
  • 有许多故障情况，它们都标有WARN或ERROR日志消息，以“TarMK GC”开头。

另请参阅下面的基于错误消息的故障排除部分。

联机修订清理后不需要存储库完整性检查。

但是，您可以执行以下操作来检查清理后的存储库状态：

• 存储库遍历检查
• 在清理过程完成后使用oak-run工具检查是否存在不一致。 有关如何执行此操作的更多信息，请查看Apache文档。您无需关闭AEM即可运行该工具。

修订清理运行状况检查是操作仪表板.
的一部分

如果联机修订清理维护任务的最后一次执行已成功完成，则状态为 绿色。

如果联机修订清理维护任务被取消一次，则为 黄色。

如果连续三次取消联机修订清理维护任务，则为 红色。 在这种情况下，需要手动交互，否则联机修订清理可能会再次失败。 有关详细信息，请阅读下面的疑难解答部分。

此外，系统重新启动后，运行状况检查状态也会重置。 因此，新重新启动的实例在修订清理运行状况检查中显示绿色状态。 外部监视工具可用于将数据保留在AEM正常运行时间之外。

使用SegmentRevisionGarbageCollection MBean通过JMX公开状态、进度和统计信息。 另请参阅以下Oak文档。

您可以使用ObjectName org.apache.jackrabbit.oak:name="Segment node store revision garbage collection",type="SegmentRevisionGarbageCollection"获取MBean的引用。

统计信息仅自上次系统启动后可用。 外部监视工具可用于将数据保留在AEM正常运行时间之外。

日志文件还可用于检查自动清理的状态、进度和统计信息。

• 运行自动清理时应监视磁盘空间。
• 完成时间（通过日志）以确保不超过2小时。
• 运行自动清理后的区段存储大小。 备用实例上的段存储大小应该与主实例上的段存储大小大致相同。

您可以执行几个步骤来查找并修复问题：

• 首先，检查日志条目

• 根据日志中的信息，采取适当措施：

  • 如果日志显示错过了五个压缩周期并在forceCompact周期超时，请将维护时段安排在存储库写入量较少时的安静时间。 您可以在 https://serveraddress:serverport/libs/granite/operations/content/monitoring/page.html 上的存储库量度监视工具中检查存储库写入
  • 如果清理在维护时段结束时停止，请确保维护任务用户界面中维护时段的配置足够大
  • 如果可用的栈内存不足，请确保实例有足够的内存。
  • 如果反应较晚，则区段存储可能会增长太多，以致于线上修订清理无法在较长的维护时段内完成。 例如，如果上周未成功完成在线修订清理，则建议计划离线维护，并运行离线修订清理，以将区段存储恢复到可管理的大小。

TarMK在尝试访问其无法找到的存储单元（区段）时记录SegmentNotFoundException。 有三种情况可能会导致此问题：

1. 一种应用程序，可绕过建议的访问机制（如Sling和JCR API），使用较低级别的API/SPI访问存储库，然后超过区段的保留时间。 也就是说，它保留对实体的引用，保留时间超过在线修订版清理所允许的保留时间（默认为24小时）。 此案例是暂时性的，不会导致数据损坏。 要恢复，应使用oak-run工具确认异常的瞬态性质（oak-run检查不应报告任何错误）。 为此，实例必须离线并在之后重新启动。
2. 外部事件导致磁盘上的数据损坏。 这可以是磁盘故障、磁盘空间不足或意外修改所需的数据文件。 在这种情况下，实例必须离线并使用oak-run检查进行修复。 有关如何执行Oak-run检查的更多详细信息，请阅读以下Apache文档。
3. 通过Adobe客户关怀解决所有其他问题。

• Oak修订版： Oak在包含节点和属性的大型树层次结构中组织所有内容。 此内容树的每个快照或修订版本都是不可变的，对树所做的更改以一系列新修订版本表示。 通常，每次内容修改都会触发新的修订。 另请参阅关注链接。
• 页面版本： 版本控制可在特定时间点创建页面的“快照”。 通常，在激活页面时会创建新版本。 有关详细信息，请参阅使用页面版本。