疑難排解Oak索引 troubleshooting-oak-indexes

開啟Web主控台，然後按一下JMX標籤或前往https://<host>：<port>/system/console/jmx (例如，http://localhost:4502/system/console/jmx)。

導覽至IndexStats Mbean。

開啟「async」和「fulltext-async」的IndexStats MBean。

針對這兩個MBean，檢查​ Done ​時間戳記和​ LastIndexTime ​時間戳記是否小於目前時間的45分鐘。

對於任一MBean，如果時間值（Done ​或​ LastIndexedTime）比目前時間大45分鐘，則索引工作會失敗或花費太長時間。 此問題會導致非同步索引過時。

首先，判斷AEM執行個體是否以強制方式關閉(AEM處理序已強制終止，或發生電源故障)，然後重新啟動。

• AEM記錄可為此目的檢閱。

如果發生強制關閉，在重新啟動時，AEM會自動暫停重新索引最多30分鐘。

請等候約45分鐘，讓AEM繼續正常的非同步索引作業。

定義新的獨立執行緒集區，以供Apache Sling排程器用於非同步索引：

• 在受影響的AEM執行個體上，導覽至AEM OSGi Web Console>OSGi>Configuration>Apache Sling Scheduler，或前往https://<host>：<port>/system/console/configMgr (例如，http://localhost:4502/system/console/configMgr)
• 將專案新增到「允許的執行緒集區」欄位，其值為「oak」。
• 若要儲存變更，請按一下右下角的​ 儲存。

確認新的Apache Sling排程器執行緒集區已註冊，並顯示在Apache Sling排程器狀態Web主控台中。

• 導覽至AEM OSGi Web主控台>「狀態」>「Sling排程器」，或前往https://<host>：<port>/system/console/status-slingscheduler (例如，http://localhost:4502/system/console/status-slingscheduler)

• 確認下列集區專案存在：

  • ApacheSlingoak
  • ApacheSlingdefault

前往Web主控台，然後按一下JMX標籤，或前往https://<host>：<port>/system/console/jmx (例如，http://localhost:4502/system/console/jmx)

開啟Oak存放庫統計MBean並判斷是否有任何ObservationQueueMaxLength值大於10,000。

• 在一般作業中，此最大值最終必須一律減少為零（尤其是在per second區段中），因此請確認ObservationQueueMaxLength的秒數量度是0。
• 如果值為10,000或更多，並且穩定增加，則表示至少一個（可能更多）佇列無法以新變更（認可）發生時的速度處理。
• 每個觀察佇列都有限制（預設為10,000），如果佇列點選該限制，其處理會降級。
• 使用MongoMK時，隨著佇列長度增加，內部Oak快取效能會降低。 在Consolidated Cache統計資料MBean中，DocChildren快取的增加missRate中可以看到此相互關聯。

為避免超過可接受的觀察佇列限制，建議：

• 降低認可固定速率。 認可中的短尖峰是可接受的，但固定速率應降低。
• 依照效能調整秘訣> Mongo儲存體調整>檔案快取大小中的說明增加DiffCache的大小。

若要找出索引卡住的原因，必須收集下列資訊：

• 收集5分鐘的執行緒傾印，每2秒收集一次執行緒傾印。

• 設定附加器的DEBUG層級和記錄。

  • org.apache.jackrabbit.oak.plugins.index.AsyncIndexUpdate
  • org.apache.jackrabbit.oak.plugins.index.IndexUpdate

• 從非同步IndexStats MBean收集資料：

  • 導覽至AEM OSGi Web Console>Main>JMX>IndexStat>async

    或前往http://localhost:4502/system/console/jmx/org.apache.jackrabbit.oak%3Aname%3Dasync%2Ctype%3DIndexStats

• 使用oak-run.jar的主控台模式來收集* /:async*節點下存在的詳細資訊。

• 使用CheckpointManager MBean收集存放庫查核點清單：

  • AEM OSGi Web Console>Main>JMX>CheckpointManager>listCheckpoints()

    或前往http://localhost:4502/system/console/jmx/org.apache.jackrabbit.oak%3Aname%3DSegment+node+store+checkpoint+management%2Ctype%3DCheckpointManager

收集步驟1中概述的所有資訊後，請重新啟動AEM。

• 重新啟動AEM可解決高並行負載（觀察佇列溢位或類似情況）時的問題。
• 如果重新啟動無法解決問題，請開啟Adobe客戶服務的問題，並提供在步驟1收集的所有資訊。

識別控制必須停止的重新索引通道的IndexStats MBean。

• 透過JMX主控台導覽至適當的IndexStats MBean，方法是前往AEM OSGi Web Console>Main>JMX或https://<host>：<port>/system/console/jmx (例如，http://localhost:4502/system/console/jmx)

• 根據您要停止的重新索引通道（async、async-reindex或fulltext-async）開啟IndexStats MBean

  • 若要識別適當的通道，並藉此識別IndexStats MBean執行個體，請檢視Oak索引「非同步」屬性。 「非同步」屬性包含通道名稱： async、async-reindex或fulltext-async。
  • 您也可以存取「非同步」欄中的AEM Index Manager來存取通道。 若要存取「索引管理員」，請瀏覽至「作業」>「診斷」>「索引管理員」。

在適當的IndexStats MBean上叫用abortAndPause()命令。

適當地標籤Oak索引定義，以防止在索引領域恢復時繼續重新索引。

• 重新索引​ 現有 ​索引時，將重新索引屬性設定為false

  • /oak:index/someExistingIndex@reindex=false

• 或者，對於​ 新 ​索引，可以：

  • 將type屬性設定為disabled

    • /oak:index/someNewIndex@type=disabled

  • 或完全移除索引定義

完成時將變更提交到存放庫。

最後，在中止的索引通道上恢復非同步索引。

• 在步驟2中發出abortAndPause()命令的IndexStats MBean中，呼叫resume()命令。