MSRP - Provider risorse di storage MongoDB

Informazioni su MSRP

Quando AEM Communities è configurato per utilizzare MSRP come store comune, il contenuto generato dall’utente (UGC) è accessibile da tutte le istanze di creazione e pubblicazione senza la necessità di eseguire la sincronizzazione e la replica.

Vedere anche Caratteristiche delle opzioni SRP e Topologie consigliate.

Requisiti

• MongoDB:

  • Versione 2.6 o successiva
  • Non è necessario configurare i logo o la condivisione
  • Consiglia vivamente l'uso di un set di repliche
  • Può essere eseguito sullo stesso host AEM o in remoto

• Apache Solr:

  • Versione 4.10 o 5
  • Solr richiede Java 1.7 o versione successiva
  • Nessun servizio necessario
  • Scelta delle modalità di esecuzione:
    • Modalità indipendente
    • Modalità SolrCloud (consigliato per ambienti di produzione)
  • Scelta della ricerca multilingue (MLS)
    • Installazione di MLS standard
    • Installazione di MLS avanzate

Configurazione MongoDB

Selezionare MSRP

La console di configurazione dell'archivio consente di selezionare la configurazione di storage predefinita, che identifica l'implementazione dell'SRP da utilizzare.

Per accedere alla console di configurazione dell'archivio, all'autore:

• Dalla navigazione globale: Strumenti > Community > Configurazione dell'archivio

• Selezionare Provider risorse di storage MongoDB (MSRP)

• Configurazione mongoDB

  • URI di mongoDB

    predefinito: mongodb://localhost/?maxPoolSize=10&waitQueueMultiple=5&readPreference=secondaryPreferred

  • Database di mongoDB

    predefinito: community

  • Raccolta UGC di mongoDB

    predefinito: content

  • Raccolta allegati mongoDB

    predefinito: allegati

• SolrConfiguration

  • Zookeeper Host

    In modalità SolrCloud con ZooKeeper esterno, imposta questo valore su HOST:PORT per ZooKeeper, ad esempio my.server.com:2181
    Per un Ensemble ZooKeeper, inserite valori HOST:PORT separati da virgola, ad esempio host1:2181,host2:2181
    Lasciate vuoto se eseguite Solr in modalità standalone utilizzando ZooKeeper interno.
    Predefinito: <blank>

  • Solr
    URLTl’URL utilizzato per comunicare con Solr in modalità standalone.
    Lasciate vuoto se eseguite in modalità SolrCloud.
    
    Predefinito: https://127.0.0.1:8983/solr/

  • Solr
    CollectionIl nome della raccolta Solr.
    
    Predefinito: collection1

• Seleziona Invia

Set di replica MongoDB

Per l'ambiente di produzione, si consiglia vivamente di impostare un set di repliche, un cluster di server MongoDB che implementa la replica primaria secondaria e il failover automatizzato.

Per ulteriori informazioni sui set di repliche, consultare la documentazione di MongoDB Replication.

Per utilizzare i set di repliche e definire le connessioni tra le applicazioni e le istanze MongoDB, consultare la documentazione di MongoDB Connection String URI Format.

Url di esempio per la connessione a un set di replica

# Example url for:
#     servers "mongoserver1", "mongoserver2", "mongoserver3" 
#     replica set 'rs0'
# port numbers only necessary if not default port 27017
mongodb://mongoserver1:<mongoport1>,mongoserver2:<mongoport2>,mongoserver3:<mongoport3>/?replicaSet=rs0&maxPoolSize=100&waitQueueMultiple=50&readPreference=secondaryPreferred

Configurazione Solr

Un'installazione Solr può essere condivisa tra l'archivio nodi (Oak) e lo store comune (MSRP) utilizzando raccolte diverse.

Se le raccolte Oak e MSRP vengono utilizzate intensamente, per motivi di prestazioni potrebbe essere installato un secondo Solr.

Per gli ambienti di produzione, la modalità SolrCloud offre prestazioni migliori rispetto alla modalità standalone (una singola configurazione Solr locale).

Per informazioni dettagliate sulla configurazione, vedere Configurazione Solr per SRP.

Aggiornamento

Se si esegue l'aggiornamento da una versione precedente configurata con MSRP, è necessario

1. Eseguire l'aggiornamento di AEM Communities
2. Installare nuovi file di configurazione Solr
   • Per MLS standard
   • Per MLS avanzate
3. Reindicizza MSRP
   Vedere la sezione MSRP Reindex Tool

Pubblicazione della configurazione

MSRP deve essere identificato come store comune in tutte le istanze di creazione e pubblicazione.

Per rendere disponibile la stessa configurazione nell’ambiente di pubblicazione:

• Per autore:
  • Passare dal menu principale a Strumenti > Operazioni > Replica
  • Selezionare Attiva albero
  • Percorso iniziale:
    • Passa a /etc/socialconfig/srpc/
  • Selezionare Activate

Gestione dei dati utente

Per informazioni su utenti, profili utente e gruppi di utenti, spesso inseriti nell'ambiente di pubblicazione, visita

• Sincronizzazione utente
• Gestione di utenti e gruppi di utenti

Strumento di reindicizzazione MSRP

Esiste un endpoint HTTP per la reindicizzazione Solr per MSRP quando si installano nuovi file di configurazione o si ripara un indice Solr danneggiato.

Con questo strumento, MongoDB è la fonte di verità per MSRP; i backup devono essere eseguiti solo da MongoDB.

L'intero albero UGC può essere reindicizzato, o solo un sottoalbero specifico, come specificato dal parametro *path *data.

Questo strumento può essere eseguito dalla riga di comando utilizzando cURL o qualsiasi altro strumento HTTP.

Durante la reindicizzazione, esiste un compromesso tra memoria e prestazioni controllato dal parametro *batchSize *data, che specifica quanti record UGC vengono reindicizzati per batch.

Un valore predefinito ragionevole è 5000:

• Se la memoria è un problema, specificate un numero più piccolo
• Se la velocità è un problema, specificate un numero maggiore per aumentare la velocità

Esecuzione dello strumento di reindicizzazione MSRP tramite il comando cURL

Il seguente comando cURL mostra ciò che è necessario per una richiesta HTTP per reindicizzare UGC memorizzato in MSRP.

Il formato di base è:

cURL -u signin -d data reindex-url

signin = administrator-id:password
Ad esempio: admin:admin

data = "batchSize=size&path=path"

size = quante voci UGC reindicizzare per operazione
/content/usergenerated/asi/mongo/

path = posizione radice della struttura ad albero di UGC da reindicizzare

• Per reindicizzare tutti gli UGC, specificate il valore della proprietà asipathdi
  /etc/socialconfig/srpc/defaultconfiguration
• Per limitare l'indice ad alcuni UGC, specificate una sottostruttura di asipath

reindex-url = l'endpoint per la reindicizzazione di SRP
http://localhost:4503/services/social/datastore/mongo/reindex

Esempio di reindicizzazione MSRP

curl -s -u admin:admin -d 'batchSize=10000&path=/content/usergenerated/asi/mongo/' http://localhost:4503/services/social/datastore/mongo/reindex

Come demo MSRP

Per impostare MSRP per un ambiente di dimostrazione o di sviluppo, vedere HowTo Setup MongoDB for Demo.

Risoluzione dei problemi

UGC non visibile in MongoDB

Verificate che MSRP sia stato configurato come provider predefinito, verificando la configurazione dell'opzione di archiviazione. Per impostazione predefinita, il provider delle risorse di storage è JSRP.

Per tutte le istanze di creazione e pubblicazione AEM, rivisitate la console di configurazione dell'archivio o verificate l'archivio AEM:

• In JCR, se /etc/socialconfig

  • Non contiene un nodo srpc, significa che il provider di archiviazione è JSRP
  • Se il nodo srpc esiste e contiene il nodo defaultconfiguration, le proprietà della configurazione predefinita devono definire MSRP come provider predefinito

UGC scompare dopo l'aggiornamento

Se si esegue l'aggiornamento da un sito AEM Communities 6.0 esistente , qualsiasi UGC preesistente deve essere convertito in modo da essere conforme alla struttura richiesta per l'API SRP dopo l'aggiornamento a AEM Communities 6.3.

È disponibile uno strumento open source su GitHub per questo scopo:

• AEM Communities UGC Migration Tool

Lo strumento di migrazione può essere personalizzato per esportare UGC da versioni precedenti di AEM social community da importare in AEM Communities 6.1 o versioni successive.

Errore: provider_id campo non definito

Se nei registri viene visualizzato il seguente errore, significa che il file dello schema Solr non è configurato correttamente.

JsonMappingException: provider_id campo non definito

Caused by: com.fasterxml.jackson.databind.JsonMappingException: undefined field provider_id
at com.fasterxml.jackson.databind.ser.DefaultSerializerProvider.serializeValue(DefaultSerializerProvider.java:129)
at com.fasterxml.jackson.databind.ObjectMapper.writeValue(ObjectMapper.java:1819)
at com.adobe.cq.social.scf.core.BaseSocialComponent.toJSONString(BaseSocialComponent.java:196)
... 124 common frames omitted

Per risolvere l'errore, quando si seguono le istruzioni per Installazione di MLS standard, assicurarsi

• I file di configurazione XML sono stati copiati nella posizione Solr corretta
• Solr è stato riavviato dopo che i nuovi file di configurazione hanno sostituito quelli esistenti

Connessione sicura a MongoDB non riuscita

Se un tentativo di connessione protetta al server MongoDB non riesce a causa di una definizione di classe mancante, è necessario aggiornare il bundle del driver MongoDB, mongo-java-driver, disponibile dall'archivio pubblico del server.

1. Scaricate il driver da https://search.maven.org/#artifactdetails%7Corg.mongodb%7Cmongo-java-driver%7C2.13.2%7Cjar (versione 2.13.2 o successiva)
2. Copiare il bundle nella cartella "crx-quickstart/install" per un'istanza AEM
3. Riavviare l'istanza AEM

Riferimenti

• AEM con MongoDB
• Documentazione MongoDB