修订版清理 revision-cleanup

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

迁移到AEM 6.4持久性格式后，存储库将无法还原为之前的AEM 6.3持久性格式。

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

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

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

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

此外，请阅读 本章.

因素包括：

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

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

建议将磁盘的大小至少比最初估计的存储库大小大2或3倍。

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

Recommendations用于最小压缩堆大小调整建议与AEM内存大小调整建议之间没有分隔。 一般规则是： 如果AEM实例的大小足以处理用例及其预期有效负载，则清理过程将获得足够的内存。

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

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

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

• 版本GC将运行： 大小增量为N%或N/N（N/N字节），因此运行压缩
• 修订GC将 not 运行： 大小增量为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.

您可以使用 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”开头。

另外，请参阅 根据错误消息进行故障诊断 部分。

在联机修订清理之后，无需检查存储库完整性。

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

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

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

状态将为 绿色 如果上次在线修订清理维护任务执行成功完成。

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

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

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

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

您可以使用 ObjectName org.apache.jackrabbit.oak:name="Segment node store revision garbage collection",type="SegmentRevisionGarbageCollection”.

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

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

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

您可以采取多个步骤来查找并修复问题：

• 首先，检查日志条目

• 根据日志中的信息，采取相应的操作：

  • 如果日志显示五个缺少的紧凑周期，则 forceCompact 周期，将维护窗口安排在存储库写入量较低时的安静时间。 您可以在位于 https://serveraddress:serverport/libs/granite/operations/content/monitoring/page.html
  • 如果清理在维护窗口的末尾停止，请确保维护任务用户界面中维护窗口的配置足够大
  • 如果可用堆内存不足，请确保实例具有足够的内存。
  • 如果反应迟钝，则segmentstore可能会增长过多，以致于在线修订清理无法在较长的维护时间范围内完成。 例如，如果上周未成功完成在线修订清理，则建议规划离线维护并执行离线修订清理，以便将区段存储恢复到可管理的大小。

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

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

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