Casos de uso da indexação Oak-run.jar oak-run-jar-indexing-use-cases

O Oak-run oferece suporte à indexação de casos de uso na linha de comando sem precisar orquestrar a execução desses casos de uso por meio AEM console JMX.

Os benefícios abrangentes de usar a abordagem de comando de índice oak-run.jar para gerenciar índices Oak são:

As seções abaixo forneceriam comandos de amostra. o comando oak-run index suporta todas as configurações NodeStore e BlobStore. Os exemplos fornecidos abaixo são sobre configurações com FileDataStore e SegmentNodeStore.

Caso de uso 1 - Verificação de consistência do índice usercase1indexconsistencycheck

Este é um caso de uso relacionado à corrupção do índice. Em alguns casos, não foi possível determinar quais dos índices estão corrompidos. Portanto, o Adobe forneceu ferramentas que:

A verificação de índices corrompidos pode ser executada por meio de --index-consistency-check operação:

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

Isso gerará um relatório em indexing-result/index-consistency-check-report.txt. Veja abaixo um exemplo de relatório:

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

Benefícios uc1benefits

Essa ferramenta agora pode ser usada pelo Suporte e pelo Administrador do sistema para determinar rapidamente quais índices estão corrompidos e, em seguida, reindexá-los.

Caso de uso 2 - Estatísticas de índice usecase2indexstatistics

Para diagnosticar alguns dos casos em torno do Adobe de desempenho da consulta, geralmente exigia a definição de índice existente, as estatísticas relacionadas ao índice da configuração do cliente. Até agora, essa informação estava espalhada por vários recursos. Para facilitar a solução de problemas, o Adobe criou ferramentas que:

As operações acima agora podem ser feitas por meio dos seguintes comandos operation index:

Veja abaixo um exemplo de como os comandos funcionam na prática:

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

Os relatórios seriam gerados em indexing-result/index-info.txt e indexing-result/index-definitions.json

Além disso, os mesmos detalhes são fornecidos por meio do Console da Web e fazem parte do zip do despejo de configuração. Elas podem ser acessadas no seguinte local:

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

Benefícios uc2benefits

Essa ferramenta permite a coleta de todos os detalhes necessários relacionados a problemas de indexação ou consulta rapidamente e reduz o tempo gasto na extração dessas informações.

Caso de uso 3 - Reindexação usecase3reindexing

Dependendo do cenários, em alguns casos, a reindexação precisa ser executada. Atualmente, a reindexação é feita definindo a variável reindex sinalizador para true no nó de definição de índice por meio do CRXDE ou pela interface do usuário do Gerenciador de índice. Depois que o sinalizador é definido, a reindexação é feita de forma assíncrona.

Alguns pontos para observar sobre a reindexação:

Para atingir esses objetivos, a ferramenta de índice oak-run oferece suporte a diferentes modos para reindexação, que podem ser usados conforme necessário. O comando oak-run index oferece os seguintes benefícios:

Reindexar - DocumentNodeStore reindexdocumentnodestore

Para DocumentNodeStore a reindexação de instalações pode ser feita por meio de um único 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

Isso oferece os seguintes benefícios

Reindexar - SegmentNodeStore reindexsegmentnodestore

Para SegmentNodeStore a reindexação de instalações pode ser feita de uma das seguintes maneiras:

Reindexação online - SegmentNodeStore onlinereindexsegmentnodestore

Siga a forma estabelecida para a reindexação através da definição reindex sinalizador.

Reindexação online - SegmentNodeStore - A instância de AEM está em execução onlinereindexsegmentnodestoretheaeminstanceisrunning

Para SegmentNodeStore O instala somente um processo pode acessar arquivos de segmento no modo leitura-gravação. Devido a isso, algumas operações na indexação de oak-run exigem etapas manuais adicionais sendo executadas.

Isso envolveria o seguinte:

Nesse cenário, não é necessário interromper o servidor de AEM ou provisionar nenhuma nova instância. No entanto, como a indexação envolve a passagem de todo o repositório, ela aumentaria a carga de I/O na instalação, afetando negativamente o desempenho do tempo de execução.

Reindexação online - SegmentNodeStore - A instância AEM é desligada onlinereindexsegmentnodestoreaeminstanceisdown

Para SegmentNodeStore a reindexação de instalações pode ser feita por meio de um único comando oak-run. No entanto, a instância de AEM precisa ser encerrada.

Você pode acionar a reindexação com o seguinte comando:

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

A diferença entre essa abordagem e a explicada acima é que a criação do ponto de verificação e a importação do índice são feitas automaticamente. O lado negativo é que AEM precisa ficar inativo durante o processo.

Reindexação fora da banda - SegmentNodeStore outofbandreindexsegmentnodestore

Nesse caso de uso, é possível executar a reindexação em uma configuração clonada para minimizar o impacto na instância de AEM em execução:

Nesse caso de uso, presume-se que o Data Store esteja acessível em outra instância, o que pode não ser possível se FileDataStore é colocada em uma solução de armazenamento baseada em nuvem como EBS. Isso exclui o cenário em que FileDataStore também é clonado. Se a definição de índice não executar indexação de texto completo, então acesse DataStore não é obrigatório.

Caso de uso 4 - Atualização das definições do índice usecase4updatingindexdefinitions

Atualmente, é possível enviar alterações na definição do índice por meio de ACS - Garantia de índice pacote. Isso permite o envio das definições de índice por meio do pacote de conteúdo, que posteriormente requer a reindexação para ser executada por meio da configuração da variável reindex sinalizador para true.

Isso funciona bem em instalações menores, onde a reindexação não leva muito tempo. No entanto, para repositórios muito grandes, a reindexação será feita em um período consideravelmente maior. Para esses casos, agora podemos usar a ferramenta de índice oak-run.

O Oak-run agora oferece suporte para fornecer definições de índice no formato JSON e criação de índice no modo fora de banda, onde nenhuma alteração é executada em uma instância ativa.

O processo que você precisa considerar para este caso de uso é: