MSRP - MongoDB Storage Resource Provider msrp-mongodb-storage-resource-provider

CAUTION
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.

Over MSRP about-msrp

Wanneer AEM Communities wordt gevormd om MSRP als zijn gemeenschappelijke opslag te gebruiken, is de gebruiker geproduceerde inhoud (UGC) toegankelijk van alle auteur en publiceer instanties zonder de behoefte aan synchronisatie of replicatie.

Zie ook Kenmerken van SRP-opties en Aanbevolen topologieën.

Vereisten requirements

  • MongoDB:

    • Versie 2.6 of hoger
    • Het is niet nodig om mongo's te configureren of te sharding
    • beveelt ten stelligste het gebruik van een replicaset
    • Kan op dezelfde host worden uitgevoerd als AEM of extern worden uitgevoerd
  • Apache Solr:

MongoDB-configuratie mongodb-configuration

Selecteer MSRP select-msrp

De Opslagconfiguratieconsole maakt het mogelijk de standaardopslagconfiguratie te selecteren, die aangeeft welke implementatie van SRP moet worden gebruikt.

Op auteur, om tot de console van de Configuratie van de Opslag toegang te hebben:

  • Vanuit globale navigatie: Tools > Communities > Storage Configuration

chlimage_1-28

  • Selecteer MongoDB Storage Resource Provider (MSRP)

  • mongoDB Configuration

    • mongoDB URI

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

    • mongoDB Database

      default: gemeenschappen

    • mongoDB UGC Collection

      default: content

    • mongoDB Attachment Collection

      default: bijlagen

  • SolrConfiguration

    • Zookeeper Host

      Wanneer u binnen SolrCloud-modus met een externe ZooKeeper, plaats deze waarde aan HOST:PORT voor de ZooKeeper, zoals my.server.com:2181
      Voer voor een ZooKeeper Ensemble door komma's gescheiden HOST:PORT waarden, zoals host1:2181,host2:2181
      Laat leeg als Solr in zelfstandige modus wordt uitgevoerd met de interne ZooKeeper.
      Standaard: <blank>

    • Solr URL
      De URL die wordt gebruikt om te communiceren met Solr in zelfstandige modus.
      Leeg laten als deze wordt uitgevoerd in de SolrCloud-modus.

      Standaard: https://127.0.0.1:8983/solr/

    • Solr Collection
      De naam van de Solr-verzameling.

      Standaard: verzameling1

  • Selecteer Submit

NOTE
De mongoDB-database, die standaard de naam heeft communities, mag niet worden ingesteld op de naam van een database die wordt gebruikt voor knooppuntsopslag of gegevens (binair) opslag. Zie ook Opslagelementen in AEM 6.

MongoDB Replica-set mongodb-replica-set

Voor het productiemilieu, wordt het sterk geadviseerd om een replicaset, een cluster van servers te installeren MongoDB die primaire-secundaire replicatie en geautomatiseerde failover uitvoert.

Ga voor meer informatie over replicasets naar MongoDB's Replicatie documentatie.

Als u met replicasets wilt werken en wilt leren hoe u verbindingen tussen toepassingen en MongoDB-instanties kunt definiëren, gaat u naar MongoDB URI-indeling verbindingstekenreeks documentatie.

Voorbeeld-URL voor verbinding maken met een replicaset example-url-for-connecting-to-a-replica-set

# Example url for:

>[!CAUTION]
>
>AEM 6.4 has reached the end of extended support and this documentation is no longer updated. For further details, see our [technical support periods](https://helpx.adobe.com/nl/support/programs/eol-matrix.html). Find the supported versions [here](https://experienceleague.adobe.com/docs/?lang=nl).
#     servers "mongoserver1", "mongoserver2", "mongoserver3"

>[!CAUTION]
>
>AEM 6.4 has reached the end of extended support and this documentation is no longer updated. For further details, see our [technical support periods](https://helpx.adobe.com/nl/support/programs/eol-matrix.html). Find the supported versions [here](https://experienceleague.adobe.com/docs/?lang=nl).
#     replica set 'rs0'

>[!CAUTION]
>
>AEM 6.4 has reached the end of extended support and this documentation is no longer updated. For further details, see our [technical support periods](https://helpx.adobe.com/nl/support/programs/eol-matrix.html). Find the supported versions [here](https://experienceleague.adobe.com/docs/?lang=nl).
# port numbers only necessary if not default port 27017

>[!CAUTION]
>
>AEM 6.4 has reached the end of extended support and this documentation is no longer updated. For further details, see our [technical support periods](https://helpx.adobe.com/nl/support/programs/eol-matrix.html). Find the supported versions [here](https://experienceleague.adobe.com/docs/?lang=nl).
mongodb://mongoserver1:<mongoport1>,mongoserver2:<mongoport2>,mongoserver3:<mongoport3>/?replicaSet=rs0&maxPoolSize=100&waitQueueMultiple=50&readPreference=secondaryPreferred

Solr-configuratie solr-configuration

Een installatie Solr kan tussen de knoopopslag (Eak) en gemeenschappelijke opslag (MSRP) worden gedeeld door verschillende inzamelingen te gebruiken.

Als zowel de Oak als de inzamelingen MSRP intensief worden gebruikt, kan tweede Solr om prestatiesredenen worden geïnstalleerd.

Voor productieomgevingen SolrCloud-modus biedt betere prestaties in vergelijking met de zelfstandige modus (één lokale Solr-instelling).

Voor configuratiedetails, zie Solr Configuratie voor SRP.

Bijwerken upgrading

Als bevordering van een vroegere die versie met MSRP wordt gevormd, zal het noodzakelijk zijn

  1. Voer het upgrade naar AEM Communities

  2. Nieuwe Solr-configuratiebestanden installeren

  3. MSRP opnieuw indexeren Zie sectie MSRP opnieuw indexeren

De configuratie publiceren publishing-the-configuration

MSRP moet als gemeenschappelijke opslag op alle auteur worden geïdentificeerd en instanties publiceren.

De identieke configuratie beschikbaar stellen in de publicatieomgeving:

  • Op auteur:

    • Navigeren van hoofdmenu naar Tools > Operations > Replication
    • Selecteer Activate Tree
    • Start Path:
      • Bladeren naar /etc/socialconfig/srpc/
    • Selecteer Activate

Gebruikersgegevens beheren managing-user-data

Voor informatie over gebruikers, gebruikersprofielen en gebruikersgroepen, die vaak in de publicatieomgeving worden ingevoerd, gaat u naar

MSRP opnieuw indexeren msrp-reindex-tool

Er is een eindpunt van HTTP voor het opnieuw indexeren van Solr voor MSRP wanneer het installeren van nieuwe configuratiedossiers of het herstellen van een beschadigde index van Solr.

Met dit gereedschap is MongoDB de bron van waarheid voor MSRP; Er hoeven alleen back-ups van MongoDB te worden gemaakt.

De volledige UGC-structuur kan opnieuw worden gedecodeerd, of alleen een specifieke substructuur, zoals opgegeven door de parameter *path *data.

Dit gereedschap kan vanaf de opdrachtregel worden uitgevoerd met cURL of een ander HTTP-gereedschap.

Wanneer het opnieuw indexeren, is er een compensatie tussen geheugen en prestaties die door de *batchSize *data parameter worden gecontroleerd, die specificeert hoeveel UGC- verslagen per partij opnieuw worden gedesdexeerd.

Een redelijke standaardwaarde is 5000:

  • Als het geheugen een probleem is, geeft u een kleiner getal op
  • Als snelheid een probleem is, geeft u een groter getal op om de snelheid te verhogen

Gereedschap MSRP opnieuw indexeren uitvoeren met cURL-opdracht running-msrp-reindex-tool-using-curl-command

Het volgende cURL bevel toont wat noodzakelijk voor een HTTP- verzoek is om UGC te herindexeren die in MSRP wordt opgeslagen.

De basisindeling is:

cURL -u handtekening -d data herdex-url

handtekening = administrator-id:password
Bijvoorbeeld: admin:admin

data = "batchSize=size&pad=pad"

size = hoeveel UGC-items opnieuw moeten worden geindexeerd per bewerking
/content/usergenerated/asi/mongo/

pad = de hoofdlocatie van de boomstructuur van UGC naar herdex

  • Als u alle UGC opnieuw wilt indexeren, geeft u de waarde van de optie asipatheigenschap van
    /etc/socialconfig/srpc/defaultconfiguration
  • Als u de index wilt beperken tot UGC, geeft u een substructuur op van asipath

herdex-url = het eindpunt voor herindexering van SRP
http://localhost:4503/services/social/datastore/mongo/reindex

NOTE
Als u opnieuw indexeren DSRP Solr, de URL is /services/social/datastore/rdb/rendex

Voorbeeld van MSRP-reindex msrp-reindex-example

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

Hoe te om MSRP te demo how-to-demo-msrp

Om MSRP voor een demonstratie of ontwikkelomgeving te plaatsen, zie MongoDB voor demo instellen.

Problemen oplossen troubleshooting

UGC niet zichtbaar in MongoDB ugc-not-visible-in-mongodb

Zorg ervoor MSRP is gevormd om de standaardleverancier te zijn door de configuratie van de opslagoptie te controleren. Standaard is de leverancier van de opslagbron JSRP.

Ga bij alle auteurs en publiceer AEM Opslagconfiguratieconsole of controleer de AEM opslagplaats:

  • In JCR, als /etc/socialconfig

    • Bevat geen srpc node, it means the storage provider is JSRP
    • Als het srpc-knooppunt bestaat en het knooppunt bevat standaardconfiguratie, zouden de eigenschappen van de standaardconfiguratie MSRP moeten bepalen om de standaardleverancier te zijn

UGC verdwijnt na upgrade ugc-disappears-after-upgrade

Als u een upgrade uitvoert vanaf een bestaande AEM Communities 6.0-site, moet een bestaande UGC worden omgezet om te voldoen aan de structuur die vereist is voor de SRP API na upgrade naar AEM Communities 6.3.

Er is een open bronhulpmiddel beschikbaar op GitHub voor dit doel:

Het migratiehulpmiddel kan worden aangepast om UGC uit vroegere versies van AEM sociale gemeenschappen voor invoer in AEM Communities 6.1 of later uit te voeren.

Fout: niet-gedefinieerde veldprovider_id error-undefined-field-provider-id

Als de volgende fout in de logboeken wordt gezien, wijst het erop het Solr schemadossier niet behoorlijk wordt gevormd.

JsonMappingException: undefined field provider_id jsonmappingexception-undefined-field-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

Om de fout op te lossen, wanneer het volgen van de instructies voor Standaard MLS installeren,

  • De de configuratiedossiers van XML werden gekopieerd aan de correcte Solr plaats
  • Solr werd opnieuw begonnen nadat de nieuwe configuratiedossiers bestaande degenen vervingen

Beveiligde verbinding met MongoDB mislukt secure-connection-to-mongodb-fails

Als een poging om een beveiligde verbinding te maken met de MongoDB-server mislukt als gevolg van een ontbrekende klassedefinitie, moet de MongoDB-stuurprogrammabundel worden bijgewerkt. mongo-java-driver, beschikbaar bij de openbare databank.

  1. Download het stuurprogramma van https://search.maven.org/#artifactdetails%7Corg.mongodb%7Cmongo-java-driver%7C2.13.2%7Cjar (versie 2.13.2 of hoger)
  2. Kopieer de bundel naar de map "crx-quickstart/install" voor een AEM-instantie
  3. De AEM opnieuw starten

Bronnen resources

recommendation-more-help
5d37d7b0-a330-461b-814d-068612705ff6