MSRP - Provider risorsa di archiviazione MongoDB

Informazioni su MSRP

Quando AEM Communities è configurato per utilizzare MSRP come archivio comune, i contenuti generati dagli utenti (UGC, User Generated Content) sono accessibili da tutte le istanze di authoring e pubblicazione senza la necessità di sincronizzazione o replica.

Vedi anche Caratteristiche delle opzioni SRP e Topologie consigliate.

Requisiti

• MongoDB:

  • Versione 2.6 o successiva
  • Non è necessario configurare i monghi o la condivisione
  • Si consiglia vivamente di utilizzare un set di repliche
  • Può essere eseguito sullo stesso host dell'AEM o in remoto

• Apache Solr:

  • Solr versione 7.0
  • Solr richiede Java 1.7 o versione successiva
  • Non è necessario alcun servizio
  • Scelta delle modalità di esecuzione:
    • Modalità autonoma
    • Modalità SolrCloud (consigliato per ambienti di produzione)
  • Scelta di ricerca multilingue (MLS):
    • Installazione di MLS standard
    • Installazione di Advanced MLS

Configurazione MongoDB

Seleziona MSRP

Il Console di configurazione archiviazione consente di selezionare la configurazione di archiviazione predefinita, che identifica l'implementazione di SRP da utilizzare.

Per accedere alla console Configurazione archiviazione, dall’autore:

• Dalla navigazione globale, seleziona Strumenti > Community > Configurazione archiviazione.

• Seleziona Provider risorsa di archiviazione 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: contenuto

  • Raccolta allegati mongoDB

    predefinito: allegati

• SolrConfiguration

  • 🔗Zookeeper Host

    Quando viene eseguito in Modalità SolrCloud con uno ZooKeeper esterno, impostare questo valore su HOST:PORT per ZooKeeper, ad esempio my.server.com:2181

    Per un ZooKeeper Ensemble, inserisci valori separati da virgola HOST:PORT valori, come host1:2181,host2:2181

    Lasciare vuoto se si esegue Solr in modalità standalone utilizzando lo ZooKeeper interno.
    Predefinito: <blank>

    • URL Solr
      URL utilizzato per comunicare con Solr in modalità autonoma.
      Lascia vuoto se l’esecuzione avviene in modalità SolrCloud.
      Predefinito: https://127.0.0.1:8983/solr/

    • Raccolta Solr
      Il nome della raccolta Solr.
      Predefinito: collection1

• Seleziona Invia

Set di replica MongoDB

Per l'ambiente di produzione, si consiglia vivamente di configurare 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, visitare il sito Web Replica documentazione.

Per lavorare con i set di repliche e imparare a definire le connessioni tra le applicazioni e le istanze di MongoDB, visita il sito Web Formato URI stringa di connessione documentazione.

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 l’archivio comune (MSRP) utilizzando raccolte diverse.

Se entrambe le raccolte Oak e MSRP vengono utilizzate in modo intensivo, è possibile installare un secondo Solr per motivi di prestazioni.

Per gli ambienti di produzione, Modalità SolrCloud offre prestazioni migliori rispetto alla modalità standalone (un'unica configurazione Solr locale).

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

Aggiornamento

Se si esegue l'aggiornamento da una versione precedente configurata con MSRP, sarà necessario:

1. Eseguire la effettuare l’aggiornamento ad AEM Communities
2. Installare nuovi file di configurazione Solr
   • Per MLS standard
   • Per MLS avanzato
3. Reindicizzare MSRP Vedere la sezione Strumento Reindicizzazione MSRP

Pubblicazione della configurazione

Il protocollo MSRP deve essere identificato come archivio comune in tutte le istanze di authoring e pubblicazione.

Per rendere disponibile la configurazione identica nell’ambiente di pubblicazione, accedi all’istanza di authoring e segui i passaggi seguenti:

• Passa dal menu principale a Strumenti > Operazioni > Replica.
• Seleziona Attiva albero
• Percorso iniziale:
  • Sfoglia per /etc/socialconfig/srpc/
• Seleziona Attiva

Gestione dei dati utente

Per informazioni su utenti, profili utente e gruppi di utenti, spesso immesso nell’ambiente di pubblicazione, visita

• Sincronizzazione utente
• Gestione di utenti e gruppi di utenti

Strumento Reindicizzazione MSRP

Esiste un endpoint HTTP per la reindicizzazione di Solr per MSRP durante l'installazione di nuovi file di configurazione o il ripristino di un indice Solr danneggiato.

Con questo strumento, MongoDB è la sorgente 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 la memoria e le prestazioni controllate dal parametro di dati *batchSize *, che specifica quanti record UGC vengono reindicizzati per batch.

Un valore di default ragionevole è 5000:

• Se la memoria è un problema, specificare un numero inferiore
• Se la velocità è un problema, specifica un numero maggiore per aumentarla

Esecuzione dello strumento Reindicizzazione MSRP tramite il comando cURL

Il seguente comando cURL mostra ciò che è necessario affinché una richiesta HTTP reindicizzi i contenuti generati dagli utenti archiviati in MSRP.

Il formato di base è:

cURL -u accesso d dati reindex-url

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

dati = "batchSize=dimensione&path=path"

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

percorso = la posizione radice della struttura ad albero dell'UGC da reindicizzare

• Per reindicizzare tutti i contenuti generati dagli utenti, specifica il valore asipathproprietà di
  /etc/socialconfig/srpc/defaultconfiguration
• Per limitare l’indice ad alcuni UGC, specifica una sottostruttura di asipath

reindex-url = endpoint per la reindicizzazione dell'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 sviluppo, vedere Come impostare MongoDB per la demo.

Risoluzione dei problemi

UGC non visibile in MongoDB

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

Su tutte le istanze AEM di authoring e pubblicazione, rivedi il Console di configurazione archiviazione oppure controlla l’archivio AEM:

• In JCR, se /etc/socialconfig

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

UGC scompare dopo l’aggiornamento

In caso di aggiornamento da un sito AEM Communities 6.0 esistente, eventuali contenuti generati dagli utenti preesistenti devono essere convertiti in modo da essere conformi alla struttura richiesta per SRP dopo l’aggiornamento ad AEM Communities 6.3.

Su GitHub è disponibile uno strumento open source a tale scopo:

• Strumento di migrazione UGC per AEM Communities

Lo strumento di migrazione può essere personalizzato per esportare contenuti generati dagli utenti (UGC, User-Generated Content) di versioni precedenti delle social community AEM per l’importazione in AEM Communities 6.1 o versione successiva.

Errore - campo non definito provider_id

Se nei registri viene visualizzato il seguente errore, questo indica che il file di schema Solr non è configurato correttamente.

JsonMappingException: campo non definito provider_id

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, segui le istruzioni per Installazione di MLS standard, assicurano:

• I file di configurazione XML sono stati copiati nel percorso Solr corretto.
• Solr è stato riavviato dopo che i nuovi file di configurazione hanno sostituito quelli esistenti.

Connessione sicura a MongoDB non riuscita

Se un tentativo di stabilire una 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 maven pubblico.

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

Riferimenti

• AEM con MongoDB
• Documentazione di MongoDB