Utilizzare oak-run.jar per gestire gli indici

Il comando index di oak-run.jar consolida una serie di funzionalità per la gestione degli indici Oak200 in AEM, dalla raccolta delle statistiche sugli indici, all'esecuzione di verifiche di coerenza degli indici e alla reindicizzazione degli stessi indici.

NOTE
In questo articolo e nei video i termini indicizzazione e reindicizzazione sono utilizzati in modo intercambiabile e vengono considerati come la stessa operazione.

Nozioni di base sui comandi dell'indice oak-run.jar

  • La versione di oak-run.jar utilizzata deve corrispondere alla versione di Oak utilizzata nell'istanza AEM.

  • La gestione degli indici tramite oak-run.jar sfrutta il comando index con vari flag per supportare diverse operazioni.

    • java -jar oak-run*.jar index ...

Statistiche indice

  • oak-run.jar esegue il dump di tutte le definizioni di indice, delle statistiche di indice importanti e del contenuto di indice per l'analisi offline.
  • La raccolta delle statistiche dell’indice è sicura per l’esecuzione sulle istanze AEM in uso.

Verifica coerenza indice

  • oak-run.jar determina rapidamente se gli indici Oak Lucene sono danneggiati.
  • La verifica di coerenza può essere eseguita in modo sicuro sull’istanza AEM in uso per i livelli di verifica di coerenza 1 e 2.

Indicizzazione TarMK Online con oak-run.jar tarmkonlineindexingwithoakrunjar

  • L'indicizzazione online di TarMK tramite oak-run.jar è più veloce dell'impostazione di reindex=true nel nodo oak:queryIndexDefinition. Nonostante questo aumento delle prestazioni, l'indicizzazione online con oak-run.jar richiede ancora una finestra di manutenzione per eseguire l'indicizzazione.

  • L'indicizzazione online di TarMK utilizzando oak-run.jar deve non essere eseguita su istanze AEM al di fuori della finestra di manutenzione delle istanze AEM.

Indicizzazione offline di TarMK con oak-run.jar

  • L'indicizzazione offline di TarMK tramite oak-run.jar è l'approccio di indicizzazione basato su oak-run.jar più semplice per TarMK in quanto richiede un singolo comando oak-run.jar, ma richiede la chiusura dell'istanza AEM.

Indicizzazione fuori banda di TarMK con oak-run.jar

  • L'indicizzazione fuori banda in TarMK con oak-run.jar riduce al minimo l'impatto dell'indicizzazione sulle istanze AEM in uso.
  • L’indicizzazione fuori banda è l’approccio consigliato per le installazioni AEM in cui il tempo di reindicizzazione supera le finestre di manutenzione disponibili.

Indicizzazione online di MongoMK con oak-run.jar

  • L'indice online con oak-run.jar in MongoMK e RDBMK è il metodo consigliato per la reindicizzazione di MongoMK (e RDBMK) installazioni AEM. Nessun altro metodo deve essere utilizzato per MongoMK o RDBMK.
  • Questa indicizzazione deve essere eseguita solo su una singola istanza AEM nel cluster.
  • L'indicizzazione online di MongoMK è sicura per un cluster AEM in esecuzione, poiché l'attraversamento dell'archivio si verifica solo su un singolo nodo MongoDB, consentendo agli altri di continuare a servire le richieste senza un impatto significativo sulle prestazioni.

Il comando oak-run.jar per l'indicizzazione in linea di MongoMK è uguale all'indicizzazione in linea di TarMK con oak-run.jar, con la differenza che il parametro dell'archivio segmenti punta all'istanza di MongoDB che contiene l'archivio nodi.

java -jar oak-run*.jar index
 --reindex
 --index-paths=/oak:index/lucene
 --read-write
 --fds-path=/path/to/datastore mongodb://server:port/aem

Materiali di supporto

recommendation-more-help
c92bdb17-1e49-4e76-bcdd-89e4f85f45e6