DocumentazioneAEMTutorial su AEMTutorial su AEM Foundation

Utilizzare oak-run.jar per gestire gli indici

Ultimo aggiornamento: 5 maggio 2025
  • Si applica a:
  • Experience Manager 6.4
  • Experience Manager 6.5
  • Argomenti:
  • Ricerca

Creato per:

  • Esperto
  • Sviluppatore

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 dei controlli 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

video poster
  • La versione di oak-run.jar utilizzata deve corrispondere alla versione di Oak utilizzata nell'istanza di 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

video poster
  • 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

video poster

https://video.tv.adobe.com/v/36883?quality=12&learn=on&captions=ita

  • 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 controllo di coerenza 1 e 2.

Indicizzazione TarMK Online con oak-run.jar

video poster

https://video.tv.adobe.com/v/36885?quality=12&learn=on&captions=ita

  • 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 sulle istanze di AEM al di fuori della finestra di manutenzione delle istanze di AEM.

Indicizzazione offline di TarMK con oak-run.jar

video poster

https://video.tv.adobe.com/v/36884?quality=12&learn=on&captions=ita

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

Indicizzazione fuori banda di TarMK con oak-run.jar

video poster

https://video.tv.adobe.com/v/340811?quality=12&learn=on&captions=ita

  • L'indicizzazione fuori banda su 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 di 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, in quanto 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

  • Scarica oak-run.jar
    • Verificare che la versione scaricata corrisponda alla versione di Oak installata in AEM come descritto in precedenza
  • Documentazione comando indice Apache Jackrabbit Oak oak-run.jar
recommendation-more-help
c92bdb17-1e49-4e76-bcdd-89e4f85f45e6