Casi d'uso dell'indicizzazione Oak-run.jar oak-run-jar-indexing-use-cases

Oak-run supporta i casi di utilizzo dell’indicizzazione sulla riga di comando senza dover orchestrare l’esecuzione di questi casi d’uso tramite AEM console JMX.

I vantaggi principali dell'utilizzo dell'approccio del comando oak-run.jar index per la gestione degli indici Oak sono i seguenti:

Le sezioni seguenti forniscono comandi di esempio. Il comando oak-run index supporta tutte le impostazioni NodeStore e BlobStore. Gli esempi forniti di seguito sono intorno alle configurazioni con FileDataStore e SegmentNodeStore.

Caso d’uso 1 - Controllo di coerenza dell’indice usercase1indexconsistencycheck

Questo è un caso d'uso relativo alla corruzione dell'indice. In alcuni casi non è stato possibile determinare quale degli indici è corrotto. Pertanto, l’Adobe ha fornito strumenti che:

La verifica degli indici corrotti può essere eseguita tramite --index-consistency-check funzionamento:

java -jar oak-run*.jar index --fds-path=/path/to/datastore  /path/to/segmentstore/ --index-consistency-check

Verrà generato un rapporto in indexing-result/index-consistency-check-report.txt. Di seguito è riportato un esempio di rapporto:

Valid indexes :
        - /content/oak:index/enablementResourceName
        - /oak:index/cqProjectLucene
        - /oak:index/cqTagLucene
        - /oak:index/lucene
        - /oak:index/ntBaseLucene
        - /oak:index/socialLucene
    Invalid indexes :
        - /oak:index/atDamIndex
        - /oak:index/atIndex
        - /oak:index/cqPageLucene
        - /oak:index/damAssetLucene
        - /oak:index/groups
        - /oak:index/slingeventJob
        - /oak:index/users
        - /oak:index/workflowDataLucene
    Ignored indexes as these are not of type lucene:
        - /oak:index/acPrincipalName
        - /oak:index/active

Vantaggi uc1benefits

Il supporto e l'amministratore di sistema possono ora utilizzare questo strumento per determinare rapidamente quali indici sono corrotti e quindi reindicizzarli.

Caso d'uso 2 - Statistiche dell'indice usecase2indexstatistics

Per diagnosticare alcuni dei casi relativi all'Adobe delle prestazioni della query spesso richiedeva la definizione di indice esistente, le statistiche relative all'indice dalla configurazione del cliente. Finora queste informazioni sono state sparse tra più risorse. Per semplificare la risoluzione dei problemi, Adobe ha creato strumenti che consentono di:

Le operazioni di cui sopra possono ora essere eseguite tramite i seguenti comandi dell'indice delle operazioni:

Di seguito è riportato un esempio di funzionamento pratico dei comandi:

java -jar oak-run*.jar index --fds-path=/path/to/datastore  /path/to/segmentstore/ --index-info --index-definitions --index-dump

I rapporti vengono generati in indexing-result/index-info.txt e indexing-result/index-definitions.json

Inoltre, gli stessi dettagli vengono forniti tramite la console Web e faranno parte dello zip di dump della configurazione. È possibile accedervi nel seguente percorso:

https://serverhost:serverport/system/console/status-oak-index-defn

Vantaggi uc2benefits

Questo strumento consente di raccogliere rapidamente tutti i dettagli richiesti relativi all’indicizzazione o ai problemi di query e di ridurre il tempo impiegato per l’estrazione di tali informazioni.

Caso d'uso 3 - Reindicizzazione usecase3reindexing

A seconda del scenari, in alcuni casi è necessario eseguire la reindicizzazione. Attualmente la reindicizzazione viene effettuata impostando il reindex flag to true nel nodo di definizione dell'indice tramite CRXDE o tramite l'interfaccia utente di Index Manager. Una volta impostato il flag, la reindicizzazione viene eseguita in modo asincrono.

Alcuni punti da notare sulla reindicizzazione:

Per raggiungere questi obiettivi, gli strumenti dell'indice oak-run supportano diverse modalità di reindicizzazione che possono essere utilizzate come richiesto. Il comando oak-run index fornisce i seguenti vantaggi:

Reindex - DocumentNodeStore reindexdocumentnodestore

Per DocumentNodeStore le installazioni di reindicizzazione possono essere effettuate tramite un singolo comando oak-run:

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

Ciò offre i seguenti vantaggi

Reindicizzazione - SegmentNodeStore reindexsegmentnodestore

Per SegmentNodeStore le installazioni di reindicizzazione possono essere eseguite in uno dei seguenti modi:

Reindicizzazione online - SegmentNodeStore onlinereindexsegmentnodestore

Seguire il modo stabilito in cui viene fatta la reindicizzazione tramite l'impostazione reindex bandiera.

Reindicizzazione online - SegmentNodeStore - L'istanza AEM è in esecuzione onlinereindexsegmentnodestoretheaeminstanceisrunning

Per SegmentNodeStore installa un solo processo che può accedere ai file dei segmenti in modalità di lettura-scrittura. A causa di questo alcune operazioni nell'indicizzazione oak-run richiedono ulteriori passaggi manuali.

Ciò implica quanto segue:

In questo scenario non è necessario arrestare il server AEM o eseguire il provisioning di una nuova istanza. Tuttavia, poiché l’indicizzazione comporta l’attraversamento dell’intero archivio, aumenterebbe il carico di I/O sull’installazione, influendo negativamente sulle prestazioni di runtime.

Reindicizzazione online - SegmentNodeStore - L'istanza AEM è chiusa onlinereindexsegmentnodestoreaeminstanceisdown

Per SegmentNodeStore le installazioni di reindicizzazione possono essere effettuate tramite un singolo comando oak-run. Tuttavia, l'istanza AEM deve essere chiusa.

Puoi attivare la reindicizzazione con il seguente comando:

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

La differenza tra questo approccio e quello illustrato sopra è che la creazione di punti di controllo e l'importazione di indici vengono eseguite automaticamente. Il rovescio della medaglia è che AEM essere fuori servizio durante il processo.

Reindice fuori banda - SegmentNodeStore outofbandreindexsegmentnodestore

In questo caso d’uso, puoi eseguire la reindicizzazione su una configurazione clonata per ridurre al minimo l’impatto sull’istanza AEM in esecuzione:

In questo caso d’uso, si presume che l’archivio dati sia accessibile in un’altra istanza che potrebbe non essere possibile se FileDataStore è posizionato su una soluzione di storage basata su cloud come EBS. Questo esclude lo scenario in cui FileDataStore è anche clonato. Se la definizione dell'indice non esegue l'indicizzazione full-text, accedi a DataStore non è obbligatorio.

Caso d'uso 4 - Aggiornamento delle definizioni degli indici usecase4updatingindexdefinitions

Attualmente, puoi inviare le modifiche alla definizione dell'indice tramite ACS Assicurare l'indice pacchetto. Questo consente la spedizione delle definizioni dell'indice tramite il pacchetto di contenuti che successivamente richiede la reindicizzazione tramite l'impostazione del reindex flag to true.

Questo funziona bene per installazioni più piccole in cui la reindicizzazione non richiede molto tempo. Tuttavia, per archivi molto grandi, la reindicizzazione sarà fatta in un periodo di tempo molto più ampio. Per questi casi ora possiamo utilizzare gli strumenti dell'indice oak-run.

Oak-run ora supporta la fornitura di definizioni di indice in formato JSON e la creazione di indici in modalità fuori banda in cui non vengono eseguite modifiche su un'istanza live.

Il processo da considerare per questo caso d’uso è il seguente: