DocumentazioneAEM 6.5Guida utente

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

Last update: Thu Aug 15 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

Creato per:

  • Amministratore

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, configurare l'archivio nodi creando un file di configurazione con il nome dell'opzione dell'archivio nodi che si desidera utilizzare nella directory crx-quickstart/install.

    Ad esempio, l'archivio dei nodi Document (che è la base per l'implementazione di MongoMK da parte dell'AEM) 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 che il nuovo formato richieda la digitazione dei valori. Per informazioni dettagliate, vedere Modello di provisioning Apache Sling e Apache SlingStart - Formato configurazione predefinito.
Se esegui l'aggiornamento da una versione precedente di Oak, accertati di eseguire prima un backup della cartella crx-quickstart/install. Dopo l'aggiornamento, ripristinare il contenuto della cartella nell'installazione aggiornata e modificare l'estensione dei file di configurazione da .cfg a .config.

Archivio nodi segmento segment-node-store

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

CAUTION
Il PID per l'archivio dei nodi di segmento è cambiato da org.apache.jackrabbit.oak.plugins.segment.SegmentNodeStoreService in previous versions di AEM 6 a org.apache.jackrabbit.oak.segment.SegmentNodeStoreService nell'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 archiviati i dati relativi al repository. Per impostazione predefinita, i file dei segmenti vengono memorizzati nella directory crx-quickstart/segmentstore.

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

  • customBlobStore: valore booleano che indica l'utilizzo di 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 di file org.apache.jackrabbit.oak.segment.SegmentNodeStoreService.config:

#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 di documenti è la base dell’implementazione MongoMK dell’AEM. Utilizza il PID org.apache.jackrabbit.oak.plugins.document.DocumentNodeStoreService*. Sono disponibili le seguenti opzioni di configurazione:

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

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

  • 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 limitata utilizzata in Mongo per memorizzare nella cache l'output diff. Il valore predefinito è 256

  • customBlobStore: valore booleano che indica l'utilizzo di un archivio dati personalizzato. Il valore predefinito è false.

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

#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 sia impostato su true nel rispettivo file di configurazione dell'archivio nodi (archivio nodi segmenti o archivio nodi documenti).

Archivio file di dati file-data-store

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

Sono disponibili le seguenti opzioni di configurazione:

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

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

  • 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 PID org.apache.jackrabbit.oak.plugins.blob.datastore.S3DataStore.config 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, devi scaricare e installare il service pack AEM più recente come elencato nella pagina Note sulla versione di AEM 6.5.

NOTE
Quando si utilizza AEM con TarMK, i file binari verranno memorizzati per impostazione predefinita in FileDataStore. Per utilizzare TarMK con l'archivio dati S3, è necessario avviare AEM utilizzando la modalità di esecuzione crx3tar-nofds, 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 AEM è già configurato per funzionare con l'archivio Tar o MongoDB, rimuovi eventuali file di configurazione esistenti dalla cartella <aem-install>/crx-quickstart/install 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. Copiare il file org.apache.jackrabbit.oak.plugins.blob.datastore.S3DataStore.config sia per un archivio dati dedicato che per una configurazione dell'archivio dati condiviso.

    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. Passare a <aem-install>/crx-quickstart/install/15 nella cartella di installazione dell'AEM e creare un backup del contenuto.

  3. Dopo il backup, eliminare la versione precedente del connettore S3 e le relative dipendenze eliminando tutti i file jar nella cartella <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 dall'archivio Adobe.

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

  6. Copia i file jar in <aem-install>/crx-quickstart/install/15 nella cartella di installazione dell'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, omettere i valori accessKey e secretKey dal file di configurazione. Il connettore S3 verrà quindi assegnato per impostazione predefinita al 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.
Sì
s3EndPoint
Endpoint API REST S3.
No.
s3Region
Area in cui risiede il bucket. Vedi questa 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
Percentuale di cacheSize da utilizzare per la gestione temporanea dei 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
Le implementazioni DataStore di S3DataStore, CachingFileDataStore e AzureDataStore supportano il caching del file system locale. L'implementazione di CachingFileDataStore è utile quando l'archivio dati è su NFS (Network File System).

Quando si esegue l’aggiornamento da un’implementazione della cache precedente (precedente a Oak 1.6), vi è 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.

È inoltre possibile aggiornare la cache offline utilizzando il comando datastorecacheupgrade di oak-run. Per informazioni dettagliate su come eseguire il comando, controllare il file readme 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 (vedere il parametro cacheSize) durante l'aggiunta di un file nella cache, alcuni 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 gestione temporanea è configurata utilizzando il parametro stagingSplitPercentage. 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 è calcolata come (100 - stagingSplitPercentage) *cacheSize.

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

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 dal parametro stagingPurgeInterval.

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. Passare alle impostazioni dell'agente di replica aprendo una pagina a https://localhost:4502/etc/replication/agents.author/publish.html.

  3. Premi il pulsante Modifica nella sezione Impostazioni.

  4. Cambia l'opzione di tipo Serializzazione in Binary less.

  5. Aggiungere 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 nella directory di installazione crx-quickstart/install.

  3. Crea questi due file nella cartella crx-quickstart:

    • 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. Verificare che MongoDB sia installato e che un'istanza di mongod sia 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, creare un file denominato org.apache.jackrabbit.oak.plugins.blob.datastore.FileDataStore.config e inserirlo nella cartella <aem-install>/crx-quickstart/install.

    • Se si utilizza S3 come archivio dati, creare un file denominato o rg.apache.jackrabbit.oak.plugins.blob.datastore.S3DataStore.config nella cartella <aem-install>/crx-quickstart/install come indicato sopra.

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

  3. Se l'istanza è stata clonata da un server esistente, è necessario rimuovere clusterId della nuova istanza utilizzando l'ultimo strumento oak-run mentre 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 nodi Document, è possibile utilizzare un URI stringa di connessione Mongo.
    note note
    NOTE
    Lo strumento eseguito da Oak 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 di 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 di Oak **1.2.x** utilizza l'Oak-run **1.2.12 o successiva**
* Per le versioni di Oak **più recenti di quelle precedenti**, 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 radice della cartella dell'archivio dati.
    • Per S3DataStore i file vengono creati nel bucket S3 configurato nella cartella META.

Archivio dati Azure azure-data-store

L’AEM può essere configurato per archiviare i dati nel servizio di archiviazione Azure di Microsoft®. Utilizza il PID org.apache.jackrabbit.oak.plugins.blob.datastore.AzureDataStore.config 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 la modalità di esecuzione crx3tar-nofds, 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. Passare alla cartella temporanea e copiare il contenuto di jcr_root/libs/system/install nella cartella <aem-install>crx-quickstart/install.

  3. Se AEM è già configurato per l'utilizzo con l'archiviazione Tar o MongoDB, rimuovere tutti i file di configurazione esistenti dalla cartella /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. Tornare al percorso temporaneo in cui è stato estratto il feature pack e copiare il contenuto di jcr_root/libs/system/config nella cartella <aem-install>/crx-quickstart/install.

  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 la documentazione ufficiale. Assicurati che il carattere '=' sia di escape come '='.

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

  • accessKey="": nome dell'account di archiviazione. Per ulteriori dettagli sulle credenziali di autenticazione di Microsoft® Azure, vedere la 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, consulta la 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 di RepositoryManagement. Una volta trovato l'MBean di Repository Manager, fare clic su di esso per visualizzare le opzioni disponibili.

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

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

    chlimage_1-9

    note note
    NOTE
    Il parametro markOnly indica se la fase di sweep della raccolta di oggetti inattivi è in esecuzione 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 parametro blobTrackSnapshotIntervalInSecs=L"0" nel file crx-quickstart/install/org.apache.jackrabbit.oak.segment.SegmentNodeStoreService.config. 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 binari singolarmente in tutte le istanze dell'archivio che condividono l'archivio dati. Tuttavia, assicurarsi di immettere true per il parametro markOnly prima di fare clic sul pulsante Richiama:

    chlimage_1-10

  3. Dopo aver completato la procedura precedente in tutte le istanze, esegui nuovamente il garbage collect dell'archivio dati da qualsiasi delle istanze:

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

    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