修订版清理

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

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

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

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

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

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

此外，请参阅的“脱机修订版清理后运行联机修订版清理”部分 本章.

只有AEM 6.3及更高版本才提供联机修订版清理。 此外，如果您使用的是较低版本的AEM，则需要迁移到新版本 Oak段Tar.

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

在线修订版清理期间持续监视磁盘空间。 如果可用磁盘空间下降到某个关键值以下，则将取消该过程。 该关键值是存储库当前磁盘占用空间的25%，并且不可配置。

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

在清理过程中，会持续监控可用栈空间。 如果可用栈空间下降到某个临界值以下，则该过程将取消。 通过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分钟，这意味着如果强制压缩未在1分钟内完成，则压缩过程将中止，以支持并发提交。

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

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

如何在备用实例上执行联机修订清理？

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

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

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

脱机修订版清理可以立即删除旧修订，而联机修订版清理需要考虑应用程序栈栈仍在引用的旧修订。 因此，前者可以比后者更积极地清除垃圾，其效果在几个垃圾收集周期内摊销。

此外，请参阅的“脱机修订版清理后运行联机修订版清理”部分 本章.

• 在Windows环境中，将始终强制进行常规文件访问，以便不使用内存映射访问。 作为一般建议，应将所有可用的RAM分配给栈，并增加segmentCache大小。 您可以通过将segmentCache.size选项添加到org.apache.jackrabbit.oak.segment.SegmentNodeStoreService.config(例如segmentCache.size=20480)来增加segmentCache。 切记不要为操作系统和其他进程留出一些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.

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

请注意，统计信息仅在上次系统启动后可用。 可以利用外部监控工具将数据保留在AEM正常运行时间以外。 参见 有关将运行状况检查附加到Nagios的AEM文档，作为外部监控工具的示例.

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

另外，请参见 基于错误消息的故障排除 部分。

在线修订版清理后不需要存储库完整性检查。

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

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

修订版清理运行状况检查是 操作功能板.

状态将为 绿色 在线修订清除维护任务的最后一次执行是否成功完成。

会是 黄色 如果联机修订版清理维护任务被取消一次。

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

另请注意，系统重新启动后，运行状况检查状态将被重置。 因此，新重新启动的实例在修订清理运行状况检查中将显示绿色状态。 可以利用外部监控工具将数据保留在AEM正常运行时间以外。 参见 有关将运行状况检查附加到Nagios的AEM文档，作为外部监控工具的示例.

如何在备用实例上监视自动清理？

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

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

请注意，统计信息仅在上次系统启动后可用。 可以利用外部监控工具将数据保留在AEM正常运行时间以外。 另请参阅 有关将运行状况检查附加到Nagios的AEM文档，作为外部监控工具的示例.

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

在自动清理待机实例期间需要监视哪些内容？

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

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

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

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

存储库大小和需要清理的修订数量决定了清理的持续时间。

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