AEM 6.4 heeft het einde van de uitgebreide ondersteuning bereikt en deze documentatie wordt niet meer bijgewerkt. Raadpleeg voor meer informatie onze technische ondersteuningsperioden. Ondersteunde versies zoeken hier.
De eiken-looppas steunt het indexeren gebruiksgevallen op de bevellijn zonder het moeten de uitvoering van deze gebruiksgevallen via AEM console JMX organiseren.
De overkoepelende voordelen van het gebruiken van de eak-looppas.jar de bevelbenadering van het indexbevel voor het beheren van indexen van het Eak zijn:
Secties hieronder bieden voorbeeldopdrachten. Indexopdrachten die worden uitgevoerd door een eikel, ondersteunen alle NodeStore- en BlobStore-instellingen. De voorbeelden hieronder zijn rond montages die FileDataStore en SegmentNodeStore hebben.
Dit is een gebruiksgeval met betrekking tot indexcorruptie. In sommige gevallen kon niet worden vastgesteld welke indexen corrupt zijn. Daarom heeft Adobe instrumenten verstrekt die:
Controleren op beschadigde indexen kan worden uitgevoerd via --index-consistency-check
bewerking:
java -jar oak-run*.jar index --fds-path=/path/to/datastore /path/to/segmentstore/ --index-consistency-check
Hiermee wordt een rapport gegenereerd in indexing-result/index-consistency-check-report.txt
. Zie hieronder voor een voorbeeldrapport:
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
Dit hulpmiddel kan nu door Steun en de Beheerder van het Systeem worden gebruikt om snel te bepalen welke indexen corrupt zijn en dan hen opnieuw te indexeren.
Voor het diagnostiseren van sommige gevallen rond de Adobe van vraagprestaties vereiste vaak bestaande indexdefinitie, op index betrekking hebbende statistieken van de klantenopstelling. Tot dusverre werd deze informatie verspreid over meerdere bronnen. Om het oplossen van problemen gemakkelijker te maken, heeft Adobe tooling gecreeerd die zal:
Alle indexdefinities in één JSON-bestand op het systeem dumpen.
Belangrijke statistieken uit bestaande indexen dumpen;
de inhoud van de pompindex voor offline analyse;
Wordt ook bruikbaar als AEM niet toegankelijk is
De bovenstaande bewerkingen kunnen nu worden uitgevoerd met de volgende opdrachten in de bewerkingsindex:
--index-info
- Verzamelt en dumpt diverse statistieken met betrekking tot indexen
--index-definitions
- Verzamelt en dumpt indexdefinities
--index-dump
- Dumpingindex-inhoud
Zie hieronder een voorbeeld van hoe de bevelen in de praktijk werken:
java -jar oak-run*.jar index --fds-path=/path/to/datastore /path/to/segmentstore/ --index-info --index-definitions --index-dump
De verslagen worden opgesteld in indexing-result/index-info.txt
en indexing-result/index-definitions.json
Bovendien worden de zelfde details verstrekt via de Console van het Web en zouden deel van de configuratie stortplaats zip uitmaken. Ze kunnen op de volgende locatie worden benaderd:
https://serverhost:serverport/system/console/status-oak-index-defn
Dit hulpmiddel laat het verzamelen van alle vereiste details met betrekking tot het indexeren of vraagkwesties toe snel en vermindert de tijd besteed in het halen van deze informatie.
Afhankelijk van de scenario'sIn sommige gevallen moet opnieuw worden gewerkt. Op dit moment wordt opnieuw indexeren uitgevoerd door het instellen van de optie reindex
markeren naar true
in de knoop van de indexdefinitie via CRXDE of via de gebruikersinterface van de Manager van de Index. Nadat de markering is ingesteld, wordt het opnieuw indexeren asynchroon uitgevoerd.
Enkele punten die u wilt opmerken bij het opnieuw indexeren:
Opnieuw indexeren gaat veel langzamer DocumentNodeStore
instellingen vergeleken met SegmentNodeStore
instellingen waar alle inhoud lokaal is;
Met het huidige ontwerp, terwijl het opnieuw indexeren gebeurt wordt de async indexeer geblokkeerd en alle andere async indexen worden verouderd en krijgen geen update voor de duur van het indexeren. Daarom kunnen gebruikers, als het systeem in gebruik is, geen bijgewerkte resultaten zien;
Bij de herindexering wordt de gehele gegevensopslagruimte doorkruist, wat een grote belasting kan betekenen voor de installatie van de AEM en zo van invloed kan zijn op de gebruikerservaring.
Voor een DocumentNodeStore
installatie waar herindexering veel tijd in beslag kan nemen, als de verbinding met de Mongo-database halverwege de bewerking mislukt, moet de indexering vanaf nul opnieuw worden opgestart;
In sommige gevallen kan het opnieuw indexeren veel tijd in beslag nemen door het extraheren van tekst. Dit is vooral specifiek voor instellingen met veel PDF-bestanden, waar de tijd die aan tekstextractie wordt besteed invloed kan hebben op de indexatietijd.
Om deze doelstellingen te bereiken, ondersteunt de werkset Indexering volgens het eikenstel verschillende modi voor herindexering die naar wens kunnen worden gebruikt. De opdracht voor indexeren met eikenuitvoering biedt de volgende voordelen:
out-of-band herindexering - het opnieuw omdraaien van de eik kan los van de AEM worden uitgevoerd, zodat de gevolgen voor de AEM in gebruik tot een minimum worden beperkt;
rennen buiten de rijstrook - De indexering vindt plaats zonder dat dit gevolgen heeft voor indexeringsbewerkingen. Dit betekent dat de asynchrone indexeerder andere indexen kan blijven indexeren;
Vereenvoudigde herindex voor DocumentNodeStore-installaties - Voor DocumentNodeStore
installaties, herindexering kan worden uitgevoerd met één opdracht die ervoor zorgt dat herindexering op de meest optimale manier wordt uitgevoerd;
Ondersteunt het bijwerken van indexdefinities en het introduceren van nieuwe indexdefinities
Voor DocumentNodeStore
installaties die opnieuw worden gedexeerd, kunnen worden uitgevoerd via één enkele opdracht voor het uitvoeren van een eak:
java -jar oak-run*.jar index --reindex --index-paths=/oak:index/lucene --read-write --fds-path=/path/to/datastore mongodb://server:port/aem
Dit biedt de volgende voordelen
--index-definitions-file
optie.Voor SegmentNodeStore
installaties voor herkoppeling kunnen op een van de volgende manieren worden uitgevoerd :
Volg de gangbare manier waarop opnieuw indexeren wordt uitgevoerd via de instelling reindex
markering.
Voor SegmentNodeStore
installaties slechts één proces kan tot segmentdossiers op read-write wijze toegang hebben. Daarom moeten bij sommige bewerkingen in de indexering van eikels aanvullende handmatige stappen worden gezet.
Dit zou het volgende inhouden:
Staptekst
Verbind de oak-run
naar dezelfde gegevensopslagruimte die door AEM wordt gebruikt in de modus Alleen-lezen en indexeert. Een voorbeeld van hoe u dit kunt bereiken:
java -jar oak-run-1.7.6.jar index --fds-path=/Users/dhasler/dev/cq/quickstart/target/crx-quickstart/repository/datastore/ --checkpoint 26b7da38-a699-45b2-82fb-73aa2f9af0e2 --reindex --index-paths=/oak:index/lucene /Users/dhasler/dev/cq/quickstart/target/crx-quickstart/repository/segmentstore/
Importeer ten slotte de gemaakte indexbestanden via het dialoogvenster IndexerMBean#importIndex
bewerking vanaf het pad waar de indexeringsbestanden zijn opgeslagen nadat de bovenstaande opdracht is uitgevoerd.
In dit scenario hoeft u de AEM server niet te stoppen of een nieuwe instantie in te stellen. Als indexering echter gepaard gaat met een verplaatsing van de hele opslagplaats, zou de I/O-belasting van de installatie toenemen, wat negatieve gevolgen zou hebben voor de prestaties bij uitvoering.
Voor SegmentNodeStore
installaties die opnieuw worden gedexeerd, kunnen worden uitgevoerd via één enkele opdracht voor het uitvoeren van een eiken. De AEM instantie moet echter worden afgesloten.
U kunt het opnieuw indexeren met het volgende bevel teweegbrengen:
java -jar oak-run*.jar index --reindex --index-paths=/oak:index/lucene --read-write --fds-path=/path/to/datastore /path/to/segmentstore/
Het verschil tussen deze aanpak en de hierboven beschreven aanpak is dat het maken van controlepunten en het importeren van indexen automatisch worden uitgevoerd. Het nadeel is dat AEM tijdens het proces moet omlaag zijn.
In dit geval kunt u opnieuw indexeren op een gekloonde instelling om de invloed op de actieve AEM te minimaliseren:
Een controlepunt maken via een JMX-bewerking. Je kunt dit doen door naar de JMX-console en zoek naar CheckpointManager
. Klik vervolgens op de knop createCheckpoint(long p1) een bewerking waarbij een hoge waarde wordt gebruikt voor de vervaldatum in seconden (bijvoorbeeld 2592000).
Kopieer de crx-quickstart
naar een nieuwe computer
Herindexeren uitvoeren via de opdracht Index uitvoeren
De gegenereerde indexbestanden kopiëren naar AEM server
Importeer de indexbestanden via JMX.
In dit geval wordt aangenomen dat de Data Store toegankelijk is op een andere instantie die mogelijk niet mogelijk is FileDataStore
wordt geplaatst op een op wolken gebaseerde opslagoplossing zoals EBS. Dit sluit het scenario uit waarin FileDataStore
is ook gekloond. Als de indexdefinitie geen fullText indexeren uitvoert, dan toegang tot DataStore
is niet vereist.
Je kunt de indexdefinitiewijzigingen momenteel verzenden via ACS Verzeker Index pakket. Hierdoor kunnen de indexdefinities worden verzonden via een inhoudspakket, waarvoor later opnieuw indexering moet worden uitgevoerd via het instellen van de reindex
markeren naar true
.
Dit werkt goed voor kleinere installaties waar het opnieuw indexeren niet lang duurt. Voor zeer grote gegevensbanken zal het opnieuw indexeren echter in veel grotere tijd plaatsvinden. In dergelijke gevallen kunnen we nu de werkset voor indexen die op een eikel worden uitgevoerd, gebruiken.
Oak-looppas steunt nu het verstrekken van indexdefinities in formaat JSON en de verwezenlijking van index in out-of-band wijze waar geen veranderingen op een levende instantie worden uitgevoerd.
Het proces dat u voor dit gebruiksgeval moet overwegen is:
Een ontwikkelaar werkt de indexdefinities op een lokale instantie bij en genereert vervolgens een JSON-indexdefinitiebestand via het dialoogvenster --index-definitions
option
De bijgewerkte JSON wordt vervolgens aan de systeembeheerder gegeven
De Beheerder van het systeem volgt de out-of-band benadering en bereidt de index op een verschillende installatie voor
Zodra dit wordt voltooid, zullen de geproduceerde indexdossiers op een lopende AEM installatie worden ingevoerd.