Configurazione degli archivi dei nodi e dei dati in AEM 6 configuring-node-stores-and-data-stores-in-aem

Introduzione introduction

In Adobe Experience Manager (AEM), i dati binari possono essere memorizzati indipendentemente dai nodi di contenuto. I dati binari vengono memorizzati in un archivio dati, mentre i nodi di contenuto vengono memorizzati in un archivio nodi.

Utilizzando la configurazione OSGi è possibile configurare sia gli archivi dati che quelli dei nodi. Per ogni configurazione OSGi viene fatto riferimento utilizzando un identificatore persistente (PID).

Passaggi di configurazione configuration-steps

Per configurare sia l’archivio nodi che l’archivio dati, effettua le seguenti operazioni:

  1. Copiare il file JAR quickstart dell'AEM nella relativa directory di installazione.

  2. Creare una cartella crx-quickstart/install nella directory di installazione.

  3. Innanzitutto, configura l’archivio nodi creando un file di configurazione con il nome dell’opzione archivio nodi che desideri utilizzare nel crx-quickstart/install directory.

    Ad esempio, l’archivio dei nodi Document (che è la base per l’implementazione AEM MongoMK) utilizza il file org.apache.jackrabbit.oak.plugins.document.DocumentNodeStoreService.config.

  4. Modifica il file e imposta le opzioni di configurazione.

  5. Crea un file di configurazione con il PID dell’archivio dati che desideri utilizzare. Modificate il file per impostare le opzioni di configurazione.

    note note
    NOTE
    Consulta Configurazioni archivio nodi e Configurazioni archivio dati per le opzioni di configurazione.
  6. Avvia AEM.

Configurazioni archivio nodi node-store-configurations

CAUTION
Le versioni più recenti di Oak utilizzano un nuovo schema di denominazione e un nuovo formato per i file di configurazione OSGi. Il nuovo schema di denominazione richiede che il file di configurazione sia denominato .config e il nuovo formato richiede che i valori siano digitati ed è documentato qui.
Se esegui l’aggiornamento da una versione precedente di Oak, assicurati di effettuare un backup del crx-quickstart/installcartella. Dopo l’aggiornamento, ripristina il contenuto della cartella nell’installazione aggiornata e modifica l’estensione dei file di configurazione da .cfg a .config.
Nel caso in cui stai leggendo questo articolo in preparazione per un aggiornamento da un AEM 5.x dell'installazione, assicurarsi di consultare aggiornamento prima di tutto.

Archivio nodi segmento segment-node-store

L’archivio dei nodi di segmento è la base dell’implementazione TarMK di Adobe nell’AEM6. Utilizza il org.apache.jackrabbit.oak.segment.SegmentNodeStoreService PID per la configurazione.

CAUTION
Il PID per l’archivio dei nodi di segmento è stato modificato da org.apache.jackrabbit.oak.plugins.segment.SegmentNodeStoreService in previous versions di AEM da 6 a org.apache.jackrabbit.oak.segment.SegmentNodeStoreService AEM 6.3. Assicurati di apportare le regolazioni di configurazione necessarie per riflettere questa modifica.

Puoi configurare le seguenti opzioni:

  • repository.home: percorso della home del repository in cui vengono memorizzati i dati relativi al repository. Per impostazione predefinita, i file dei segmenti vengono memorizzati nel crx-quickstart/segmentstore directory.

  • tarmk.size: dimensione massima di un segmento in MB. Il valore massimo predefinito è 256 MB.

  • customBlobStore: valore booleano che indica che viene utilizzato un archivio dati personalizzato. Il valore predefinito è true per AEM 6.3 e versioni successive. Prima di AEM 6.3 il valore predefinito era falso.

Di seguito è riportato un esempio org.apache.jackrabbit.oak.segment.SegmentNodeStoreService.config file:

#Path to repo
repository.home="crx-quickstart/repository"

#Max segment size
tarmk.size=I"256"

#Custom data store
customBlobStore=B"true"

Archivio nodi documento document-node-store

L’archivio dei nodi dei documenti è la base dell’implementazione AEM MongoMK. Utilizza il org.apache.jackrabbit.oak.plugins.document.DocumentNodeStoreService* *PID Sono disponibili le seguenti opzioni di configurazione:

  • mongouri: Il MongoURI necessario per connettersi al database Mongo. Il valore predefinito è mongodb://localhost:27017

  • db: nome del database Mongo. Il valore predefinito è Oak . However, new AEM 6 installations use **aem-author** come nome di database predefinito.

  • cache: dimensione della cache in MB. Viene distribuito tra le varie cache utilizzate in DocumentNodeStore. Il valore predefinito è 256

  • changesSize: dimensione in MB della raccolta con limite utilizzata in Mongo per memorizzare in cache l’output di differenze. Il valore predefinito è 256

  • customBlobStore: valore booleano che indica che viene utilizzato un archivio dati personalizzato. Il valore predefinito è false.

Di seguito è riportato un esempio org.apache.jackrabbit.oak.plugins.document.DocumentNodeStoreService.config file:

#Mongo server details
mongouri="mongodb://localhost:27017"

#Name of Mongo database to use
db="aem-author"

#Store binaries in custom BlobStore
customBlobStore=B"false"

Configurazioni archivio dati data-store-configurations

Quando si tratta di un numero elevato di file binari, si consiglia di utilizzare un archivio dati esterno invece degli archivi nodi predefiniti per massimizzare le prestazioni.

Ad esempio, se il progetto richiede molte risorse multimediali, la loro memorizzazione nel file o nell’archivio dati S3 rende l’accesso più rapido rispetto alla loro memorizzazione direttamente in un MongoDB.

File Data Store offre prestazioni migliori rispetto a MongoDB e le operazioni di backup e ripristino di Mongo sono più lente con un numero elevato di risorse.

Di seguito sono descritti i dettagli relativi ai diversi archivi e configurazioni di dati.

NOTE
Per abilitare gli archivi dati personalizzati, è necessario assicurarsi che customBlobStore è impostato su true nel rispettivo file di configurazione dell’archivio nodi (archivio nodi segmento o archivio nodi documenti).

Archivio file di dati file-data-store

Questa è l'implementazione di FileArchivioDati presente in Jackrabbit 2. Fornisce un modo per memorizzare i dati binari come file normali sul file system. Utilizza il org.apache.jackrabbit.oak.plugins.blob.datastore.FileDataStore PID.

Sono disponibili le seguenti opzioni di configurazione:

  • repository.home: percorso della home del repository in cui vengono memorizzati i dati relativi a vari repository. Per impostazione predefinita, i file binari vengono memorizzati in crx-quickstart/repository/datastore directory

  • path: percorso della directory in cui memorizzare i file. Se specificato, ha la precedenza su repository.home valore

  • minRecordLength: dimensione minima in byte di un file archiviato nell’archivio dati. Il contenuto binario inferiore a questo valore viene allineato.

NOTE
Quando si utilizza un NAS per archiviare i file data store condivisi, assicurarsi di utilizzare solo dispositivi ad alte prestazioni per evitare problemi di prestazioni.

Archivio dati Amazon S3 amazon-s-data-store

L’AEM può essere configurato per memorizzare i dati nel servizio di archiviazione semplice (S3) di Amazon. Utilizza il org.apache.jackrabbit.oak.plugins.blob.datastore.S3DataStore.config PID per la configurazione.

NOTE
AEM 6.5 supporta la memorizzazione di dati in Amazon S3, tuttavia il supporto non è esteso alla memorizzazione di dati in altre piattaforme, i cui fornitori possono avere le proprie implementazioni delle API S3 di Amazon.

Per abilitare la funzionalità di archiviazione dati di S3, è necessario scaricare e installare un feature pack contenente il connettore S3 Datastore. Vai a Archivio Adobe e scarica la versione più recente dalle versioni 1.10.x del feature pack (ad esempio, com.adobe.granite.oak.s3connector-1.10.0.zip). È inoltre necessario scaricare e installare il service pack AEM più recente, come indicato nella Note sulla versione di AEM 6.5 pagina.

NOTE
Quando si utilizza l’AEM con TarMK, i dati binari vengono memorizzati per impostazione predefinita nel file FileDataStore. Per utilizzare TarMK con l’archivio dati S3, è necessario avviare AEM utilizzando crx3tar-nofds runmode, ad esempio:
java -jar <aem-jar-file>.jar -r crx3tar-nofds

Una volta scaricato, puoi installare e configurare il connettore S3 come segue:

  1. Estrai il contenuto del file zip del feature pack in una cartella temporanea.

  2. Vai alla cartella temporanea e passa alla seguente posizione:

    code language-xml
    jcr_root/libs/system/install
    

    Copia tutti i contenuti dalla posizione precedente in <aem-install>/crx-quickstart/install.

  3. Se l’AEM è già configurato per funzionare con lo storage Tar o MongoDB, rimuovi eventuali file di configurazione esistenti dal <aem-install>/crx-quickstart/installare prima di procedere. I file che devono essere rimossi sono:

    • For MongoMK: org.apache.jackrabbit.oak.plugins.document.DocumentNodeStoreService.config
    • For TarMK: org.apache.jackrabbit.oak.segment.SegmentNodeStoreService.config
  4. Tornate alla posizione temporanea in cui è stato estratto il feature pack e copiate il contenuto della cartella seguente:

    • jcr_root/libs/system/config

    in

    • <aem-install>/crx-quickstart/install

    Assicurati di copiare solo i file di configurazione necessari per la configurazione corrente. Per un archivio dati dedicato e per una configurazione dell’archivio dati condiviso, copia org.apache.jackrabbit.oak.plugins.blob.datastore.S3DataStore.config file.

    note note
    NOTE
    In una configurazione cluster, eseguire i passaggi precedenti su tutti i nodi del cluster uno alla volta. Inoltre, assicurati di utilizzare le stesse impostazioni S3 per tutti i nodi.
  5. Modifica il file e aggiungi le opzioni di configurazione richieste dalla configurazione.

  6. Avvia AEM.

Aggiornamento a una nuova versione del connettore 1.10.x S3 upgrading-to-a-new-version-of-the-s-connector

Per effettuare l’aggiornamento a una nuova versione del connettore 1.10.x S3 (ad esempio, da 1.10.0 a 1.10.4), effettua le seguenti operazioni:

  1. Arresta l’istanza AEM.

  2. Accedi a <aem-install>/crx-quickstart/install/15 nella cartella di installazione dell’AEM ed eseguirne una copia di backup del contenuto.

  3. Dopo il backup, elimina la versione precedente del connettore S3 e le relative dipendenze eliminando tutti i file jar in <aem-install>/crx-quickstart/install/15 ad esempio:

    • oak-blob-cloud-1.6.1.jar
    • aws-java-sdk-osgi-1.10.76.jar
    note note
    NOTE
    I nomi di file sopra indicati sono utilizzati solo a scopo illustrativo.
  4. Scarica la versione più recente del feature pack 1.10.x da Archivio Adobe.

  5. Decomprimi il contenuto in una cartella separata, quindi passa a jcr_root/libs/system/install/15.

  6. Copia i file jar in <aem-install>/crx-quickstart/install/15 nella cartella di installazione AEM.

  7. Avviare AEM e verificare la funzionalità del connettore.

Puoi utilizzare il file di configurazione con le opzioni descritte di seguito.

Opzioni del file di configurazione del connettore S3 s3-connector-configuration-file-options

NOTE
Il connettore S3 supporta sia l’autenticazione degli utenti IAM che l’autenticazione dei ruoli IAM. Per utilizzare l’autenticazione del ruolo IAM, ometti accessKey e secretKey valori dal file di configurazione. Il connettore S3 verrà quindi impostato come predefinito su Ruolo IAM assegnato all’istanza.
Chiave
Descrizione
Predefiniti
Obbligatorio
accessKey
ID chiave di accesso per l’utente IAM con accesso al bucket.
Sì, quando non si utilizzano i ruoli IAM.
secretKey
Chiave di accesso segreta per l’utente IAM con accesso al bucket.
Sì, quando non si utilizzano i ruoli IAM.
cacheSize
Dimensione (in byte) della cache locale.
64 GB
No.
connectionTimeout
Imposta il tempo di attesa (in millisecondi) prima del timeout durante la creazione iniziale di una connessione.
10000
No.
maxCachedBinarySize
I file binari con dimensione minore o uguale a questo valore (in byte) vengono memorizzati nella cache della memoria.
17408 (17 KB)
No.
maxConnections
Imposta il numero massimo di connessioni HTTP aperte consentite.
50
No.
maxErrorRetry
Imposta il numero massimo di tentativi per le richieste non riuscite (recuperabili).
3
No.
minRecordLength
Dimensione minima (in byte) di un oggetto da archiviare nell'archivio dati.
16384
No.
percorso
Percorso locale dell’archivio dati dell’AEM.
crx-quickstart/repository/datastore
No.
proxyHost
Impostare l'host proxy opzionale tramite cui il client si connette.
No.
proxyPort
Impostare la porta proxy opzionale attraverso la quale il client si connette.
No.
s3Bucket
Nome del bucket S3.
s3EndPoint
Endpoint API REST S3.
No.
s3Region
Area in cui risiede il bucket. Vedi questo pagina per ulteriori dettagli.
Area in cui è in esecuzione l’istanza di AWS.
No.
socketTimeout
Impostare la quantità di tempo di attesa (in millisecondi) per il trasferimento dei dati su una connessione aperta stabilita prima che la connessione venga interrotta per timeout e chiusa.
50000
No.
stagingPurgeInterval
Intervallo (in secondi) per la rimozione dei caricamenti completati dalla cache di staging.
300
No.
stagingRetryInterval
Intervallo (in secondi) tra i tentativi di caricamento non riusciti.
600
No.
stagingSplitPercentage
La percentuale di cacheSize da utilizzare per la gestione temporanea di caricamenti asincroni.
10
No.
uploadThreads
Il numero di thread di caricamento utilizzati per i caricamenti asincroni.
10
No.
writeThreads
Numero di thread simultanei utilizzati per la scrittura tramite Gestione trasferimenti S3.
10
No.

Memorizzazione in cache di DataStore data-store-caching

NOTE
Implementazioni DataStore di S3DataStore, CachingFileDataStore e AzureDataStore supporta il caching del file system locale. Il CachingFileDataStore L'implementazione è utile quando l'archivio dati si trova su NFS (Network File System).

Quando si esegue l’aggiornamento da un’implementazione della cache precedente (precedente a Oak 1.6), si riscontra una differenza nella struttura della directory della cache del file system locale. Nella vecchia struttura della cache, sia i file scaricati che quelli caricati venivano inseriti direttamente nel percorso della cache. La nuova struttura separa i download e i caricamenti e li memorizza in due directory denominate upload e download nel percorso della cache. Il processo di aggiornamento deve essere semplice e gli eventuali caricamenti in sospeso devono essere pianificati per il caricamento e tutti i file precedentemente scaricati nella cache vengono inseriti nella cache al momento dell’inizializzazione.

Puoi anche aggiornare la cache offline utilizzando datastorecacheupgrade comando di oak-run. Per informazioni dettagliate su come eseguire il comando, vedere leggimi per il modulo oak-run.

La cache ha un limite di dimensioni e può essere configurata utilizzando il parametro cacheSize.

Download downloads

La cache locale viene controllata per il record del file o del BLOB richiesto prima di accedervi dall'archivio dati. Quando la cache supera il limite configurato (vedi cacheSize ) durante l'aggiunta di un file nella cache, alcuni dei file vengono eliminati per recuperare spazio.

Caricamento asincrono async-upload

La cache supporta i caricamenti asincroni nel DataStore. I file vengono posizionati nell’area intermedia localmente, nella cache (sul file system), e viene avviato un processo asincrono per caricare il file. Il numero di caricamenti asincroni è limitato dalla dimensione della cache di staging. La dimensione della cache di staging viene configurata utilizzando stagingSplitPercentage parametro. Questo parametro definisce la percentuale di dimensione della cache da utilizzare per la cache di staging. Inoltre, la percentuale di cache disponibile per i download viene calcolata come (100 - stagingSplitPercentage) *cacheSize.

I caricamenti asincroni sono multithread e il numero di thread è configurato utilizzando uploadThreads parametro.

Al termine dei caricamenti, i file vengono spostati nella cache di download principale. Quando la dimensione della cache di gestione temporanea supera il limite, i file vengono caricati in modo sincrono nel DataStore fino al completamento dei caricamenti asincroni precedenti e fino a quando non viene nuovamente disponibile spazio nella cache di gestione temporanea. I file caricati vengono rimossi dall’area di gestione temporanea da un processo periodico il cui intervallo è configurato da stagingPurgeInterval parametro.

I caricamenti non riusciti (ad esempio, a causa di un’interruzione della rete) vengono inseriti in una coda di nuovi tentativi e ripetuti periodicamente. L'intervallo tra i tentativi è configurato utilizzando stagingRetryInterval parameter.

Configurazione della replica senza binari con Amazon S3 configuring-binaryless-replication-with-amazon-s

Per configurare la replica senza binari con S3, sono necessari i seguenti passaggi:

  1. Installa le istanze di authoring e pubblicazione e assicurati che vengano avviate correttamente.

  2. Vai alle impostazioni dell’agente di replica aprendo una pagina per https://localhost:4502/etc/replication/agents.author/publish.html.

  3. Premere il tasto Modifica pulsante in Impostazioni sezione.

  4. Modificare il Serializzazione digitare l'opzione per Senza binario.

  5. Aggiungi il parametro " binaryless= true" nell'uri di trasporto. Dopo la modifica, l’URI deve essere simile al seguente:

    https://localhost:4503/bin/receive?sling:authRequestLogin=1&binaryless=true

  6. Riavvia tutte le istanze di authoring e pubblicazione per rendere effettive le modifiche.

Creazione di un cluster tramite S3 e MongoDB creating-a-cluster-using-s-and-mongodb

  1. Decomprimi l’avvio rapido di CQ con il seguente comando:

    java -jar cq-quickstart.jar -unpack

  2. Dopo aver decompresso AEM, creare una cartella all'interno della directory di installazione crx-quickstart/installare.

  3. Crea questi due file all'interno del crx-quickstart cartella:

    • org.apache.jackrabbit.oak.plugins.document.DocumentNodeStoreService.config

    • org.apache.jackrabbit.oak.plugins.blob.datastore.S3DataStore.config

    Dopo aver creato i file, aggiungi le opzioni di configurazione necessarie.

  4. Installa i due bundle richiesti per l’archivio dati S3 come spiegato in precedenza.

  5. Assicurati che MongoDB sia installato e che un’istanza di mongod è in esecuzione.

  6. Avvia AEM con il seguente comando:

    java -Xmx1024m -jar cq-quickstart.jar -r crx3,crx3mongo

  7. Ripetere i passaggi da 1 a 4 per la seconda istanza di AEM.

  8. Avvia la seconda istanza di AEM.

Configurazione di un archivio dati condiviso configuring-a-shared-data-store

  1. Innanzitutto, crea il file di configurazione dell’archivio dati su ogni istanza necessaria per condividere l’archivio dati:

    • Se si utilizza un FileDataStore, crea un file denominato org.apache.jackrabbit.oak.plugins.blob.datastore.FileDataStore.config e inseriscilo nel <aem-install>/crx-quickstart/install cartella.

    • Se utilizzi S3 come archivio dati, crea un file denominato o rg.apache.jackrabbit.oak.plugins.blob.datastore.S3DataStore.config nel <aem-install>/crx-quickstart/install come sopra.

  2. Modifica i file di configurazione dell’archivio dati in ogni istanza in modo che puntino allo stesso archivio dati. Per ulteriori informazioni, consulta questo articolo.

  3. Se l'istanza è stata clonata da un server esistente, è necessario rimuovere clusterId della nuova istanza utilizzando l’ultimo strumento oak-run quando l’archivio è offline. Il comando da eseguire è:

    code language-xml
    java -jar oak-run.jar resetclusterid < repository path | Mongo URI >
    
    note note
    NOTE
    Se è configurato un archivio dei nodi di segmento, è necessario specificare il percorso dell’archivio. Per impostazione predefinita, il percorso è <aem-install-folder>/crx-quickstart/repository/segmentstore. Se è configurato un archivio dei nodi di un documento, è possibile utilizzare un URI stringa di connessione Mongo.
    note note
    NOTE
    Lo strumento Oak-run può essere scaricato da questa posizione:
    https://mvnrepository.com/artifact/org.apache.jackrabbit/oak-run/
    È necessario utilizzare versioni diverse dello strumento a seconda della versione Oak utilizzata con l’installazione dell’AEM. Prima di utilizzare lo strumento, controlla l’elenco dei requisiti delle versioni riportato di seguito:
    code language-none
    * Per le versioni Oak **1.2.x** utilizzare Oak-run **1.2.12 o successiva**
    * Per le versioni Oak **più recente di quanto sopra**, utilizza la versione di Oak-run che corrisponde al core Oak dell’installazione AEM.
    
  4. Infine, convalida la configurazione. Per eseguire la convalida, cerca un file univoco aggiunto all’archivio dati da ogni archivio che lo condivide. Il formato dei file è repository-[UUID], dove l’UUID è un identificatore univoco di ogni singolo archivio.

    Pertanto, una configurazione corretta deve avere un numero di file univoci pari al numero di archivi che condividono l’archivio dati.

    I file vengono memorizzati in modo diverso, a seconda dell’archivio dati:

    • Per FileDataStore i file vengono creati nel percorso principale della cartella dell’archivio dati.
    • Per S3DataStore i file vengono creati nel bucket S3 configurato sotto META cartella.

Archivio dati Azure azure-data-store

L’AEM può essere configurato per archiviare i dati nel servizio di archiviazione Azure di Microsoft®. Utilizza il org.apache.jackrabbit.oak.plugins.blob.datastore.AzureDataStore.config PID per la configurazione.

Per abilitare la funzionalità dell’archivio dati di Azure, è necessario scaricare e installare un feature pack contenente il connettore di Azure. Vai a Archivio Adobe e scarica la versione più recente dalle versioni 1.6.x del feature pack (ad esempio, com.adobe.granite.oak.azureblobconnector-1.6.3.zip).

NOTE
Quando si utilizza l’AEM con TarMK, i file binari vengono memorizzati per impostazione predefinita in FileDataStore. Per utilizzare TarMK con Azure DataStore, è necessario avviare AEM utilizzando crx3tar-nofds runmode, ad esempio:
java -jar <aem-jar-file>.jar -r crx3tar-nofds

Una volta scaricato, puoi installare e configurare il connettore Azure come segue:

  1. Estrai il contenuto del file zip del feature pack in una cartella temporanea.

  2. Vai alla cartella temporanea e copia il contenuto di jcr_root/libs/system/install al <aem-install>crx-quickstart/install cartella.

  3. Se l’AEM è già configurato per funzionare con l’archiviazione Tar o MongoDB, rimuovi eventuali file di configurazione esistenti da /crx-quickstart/install prima di procedere. I file che devono essere rimossi sono:

    Per MongoMK:

    org.apache.jackrabbit.oak.plugins.document.DocumentNodeStoreService.config

    Per TarMK:

    org.apache.jackrabbit.oak.segment.SegmentNodeStoreService.config

  4. Tornate alla posizione temporanea in cui è stato estratto il feature pack e copiate il contenuto di jcr_root/libs/system/config al <aem-install>/crx-quickstart/install cartella.

  5. Modifica il file di configurazione e aggiungi le opzioni di configurazione richieste dalla configurazione.

  6. Avvia AEM.

Puoi utilizzare il file di configurazione con le seguenti opzioni:

  • azureSas="": nella versione 1.6.3 del connettore è stato aggiunto il supporto per la firma di accesso condiviso di Azure. Se nel file di configurazione sono presenti sia le credenziali SAS che le credenziali di archiviazione, SAS ha la priorità. Per ulteriori informazioni sulle associazioni di protezione, vedere documentazione ufficiale. Assicurati che il carattere '=' sia di escape come '='.

  • azureBlobEndpoint="": l'endpoint BLOB di Azure. Ad esempio, https://<storage-account>.blob.core.windows.net.

  • accessKey="": nome dell'account di archiviazione. Per ulteriori dettagli sulle credenziali di autenticazione di Microsoft® Azure, vedere documentazione ufficiale.

  • secretKey="": la chiave di accesso all’archiviazione. Assicurati che il carattere '=' sia di escape come '='.

  • container="": nome del contenitore di archiviazione BLOB di Microsoft® Azure. Il contenitore è un raggruppamento di un insieme di BLOB. Per ulteriori dettagli, leggere documentazione ufficiale.

  • maxConnections="": il numero simultaneo di richieste simultanee per operazione. Il valore predefinito è 1.

  • maxErrorRetry="": numero di tentativi per richiesta. Il valore predefinito è 3.

  • socketTimeout="": intervallo di timeout, in millisecondi, utilizzato per la richiesta. Il valore predefinito è 5 minuti.

Oltre alle impostazioni precedenti, è possibile configurare anche le seguenti impostazioni:

  • path: percorso dell’archivio dati. Il valore predefinito è <aem-install>/repository/datastore.
  • RecordLength: dimensione minima di un oggetto che deve essere memorizzato nell'archivio dati. Il valore predefinito è 16 KB.
  • maxCachedBinarySize: i file binari con dimensioni inferiori o uguali a queste dimensioni vengono memorizzati nella cache della memoria. Dimensione in byte. Il valore predefinito è 17408 (17 KB).
  • cacheSize: dimensione della cache. Il valore è specificato in byte. Il valore predefinito è 64 GB.
  • secret: da utilizzare solo se si utilizza la replica senza dati binari per la configurazione dell’archivio dati condiviso.
  • stagingSplitPercentage: percentuale della dimensione della cache configurata per l’utilizzo per la gestione temporanea di caricamenti asincroni. Il valore predefinito è 10.
  • uploadThreads: il numero di thread di upload utilizzati per i caricamenti asincroni. Il valore predefinito è 10.
  • stagingPurgeInterval: intervallo in secondi per la rimozione dei caricamenti completati dalla cache di staging. Il valore predefinito è 300 secondi (5 minuti).
  • stagingRetryInterval: intervallo tra i tentativi in secondi per i caricamenti non riusciti. Il valore predefinito è 600 secondi (10 minuti).
NOTE
Tutte le impostazioni devono essere inserite tra virgolette, ad esempio:
accessKey="ASDASDERFAERAER"
secretKey="28932hfjlkwdo8fufsdfas\=\="

Raccolta oggetti inattivi dell’archivio dati data-store-garbage-collection

Il processo di Garbage Collection dell’archivio dati viene utilizzato per rimuovere eventuali file inutilizzati nell’archivio dati, liberando così spazio su disco prezioso nel processo.

Per eseguire la raccolta di oggetti inattivi dell’archivio dati:

  1. Vai alla console JMX all’indirizzo https://<serveraddress:port>/system/console/jmx

  2. Ricerca Gestione archivio. Una volta individuato l’MBean di Repository Manager, fai clic su di esso per visualizzare le opzioni disponibili.

  3. Scorri fino alla fine della pagina e fai clic sul pulsante startDataStoreGC(markOnly booleano) collegamento.

  4. Nella finestra di dialogo seguente, immetti false per markOnly , quindi fai clic su Richiama:

    chlimage_1-9

    note note
    NOTE
    Il markOnly Il parametro indica se la fase di sweep della Garbage Collection viene eseguita o meno.

Raccolta oggetti inattivi dell’archivio dati per un archivio dati condiviso data-store-garbage-collection-for-a-shared-data-store

NOTE
Quando si esegue la raccolta di oggetti inattivi in un archivio dati condiviso o in cluster, l’impostazione (con Mongo o Segment Tar) del registro potrebbe visualizzare avvisi sull’impossibilità di eliminare determinati ID BLOB. Agli ID BLOB eliminati in una precedente raccolta di oggetti inattivi viene fatto erroneamente riferimento da altri cluster o nodi condivisi che non dispongono di informazioni sulle eliminazioni degli ID. Di conseguenza, quando viene eseguita la raccolta di oggetti inattivi, registra un avviso quando tenta di eliminare un ID che è già stato eliminato nell’ultima esecuzione. Questo comportamento non influisce sulle prestazioni o sulle funzionalità.
NOTE
Se utilizzi una configurazione dell’archivio dati condiviso e la raccolta di oggetti inattivi dell’archivio dati è disabilitata, l’esecuzione dell’attività di pulizia binaria di Lucene può improvvisamente aumentare lo spazio su disco utilizzato. Prova a disabilitare BlobTracker su tutte le istanze di authoring e pubblicazione effettuando le seguenti operazioni:
  1. Interrompi l’istanza AEM.
  2. Aggiungi il blobTrackSnapshotIntervalInSecs=L"0" parametro in crx-quickstart/install/org.apache.jackrabbit.oak.segment.SegmentNodeStoreService.config file. Questo parametro richiede Oak 1.12.0, 1.10.2 o versione successiva.
  3. Riavvia l’istanza AEM.

Con le versioni più recenti di AEM, la raccolta di oggetti inattivi dell’archivio dati può essere eseguita anche sugli archivi dati condivisi da più di un archivio. Per poter eseguire la raccolta di oggetti inattivi dell’archivio dati in un archivio dati condiviso, effettua le seguenti operazioni:

  1. Assicurati che tutte le attività di manutenzione configurate per la raccolta di oggetti inattivi dell’archivio dati siano disabilitate in tutte le istanze dell’archivio che condividono l’archivio dati.

  2. Esegui i passaggi indicati in Raccolta oggetti inattivi binaria singolarmente il tutto istanze del repository che condividono l’archivio dati. Tuttavia, assicurati di inserire true per markOnly prima di fare clic sul pulsante Richiama:

    chlimage_1-10

  3. Dopo aver completato la procedura precedente in tutte le istanze, esegui di nuovo l’archivio dati garbage collect da qualsiasi delle istanze:

    1. Vai alla console JMX e seleziona Repository Manager Mbean.
    2. Fai clic su Fare clic su startDataStoreGC(markOnly booleano) collegamento.
    3. Nella finestra di dialogo seguente, immetti false per markOnly di nuovo il parametro.

    Tutti i file trovati vengono fascicolati utilizzando la fase contrassegno utilizzata in precedenza ed eliminano gli altri file non utilizzati dall'archivio dati.

recommendation-more-help
19ffd973-7af2-44d0-84b5-d547b0dffee2