MSRP - lagringsresursprovider för MongoDB msrp-mongodb-storage-resource-provider

Om MSRP about-msrp

När AEM Communities har konfigurerats att använda MSRP som gemensam lagringsplats är användargenererat innehåll (UGC) tillgängligt från alla författare- och publiceringsinstanser utan behov av synkronisering eller replikering.

Se även Egenskaper för SRP-alternativ och Rekommenderade topologier.

Krav requirements

MongoDB-konfiguration mongodb-configuration

Välj MSRP select-msrp

Konsolen Lagringskonfiguration tillåter val av standardlagringskonfiguration, som identifierar vilken implementering av SRP som ska användas.

På författaren, för att komma åt lagringskonsolen:

  • Välj Tools > Communities > Storage Configuration från global navigering.

msrp

  • Välj MongoDB Storage Resource Provider (MSRP)

  • mongoDB Configuration

    • mongoDB URI

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

    • mongoDB Database

      standard: communities

    • mongoDB UGC Collection

      standard: innehåll

    • mongoDB Attachment Collection

      standard: bilagor

  • SolrConfiguration

    • Zookeeper Host

      När du kör i SolrCloud-läge med en extern ZooKeeper anger du det här värdet till HOST:PORT för ZooKeeper, till exempel my.server.com:2181

      Ange kommaavgränsade HOST:PORT-värden för en ZooKeeper Ensemble, till exempel host1:2181,host2:2181

      Lämna tomt om du kör Solr i fristående läge med den interna ZooKeeper.
      Standard: <blank>

      • Solr URL
        Den URL som används för att kommunicera med Solr i fristående läge.
        Lämna tomt om du kör i SolrCloud-läge.
        Standard: https://127.0.0.1:8983/solr/

      • Solr Collection
        Solr-samlingens namn.
        Standard: samling1

  • Välj Submit

NOTE
MongoDB-databasen, som har standardvärdet communities, ska inte anges till namnet på en databas som används för nodarkiv eller datalager (binära). Se även Lagringselement i AEM 6.5.

MongoDB-replikuppsättning mongodb-replica-set

För produktionsmiljön rekommenderar vi starkt att du skapar en replikuppsättning, ett kluster av MongoDB-servrar som implementerar primär-sekundär replikering och automatiserad failover.

Mer information om replikuppsättningar finns i MongoDB:s Replication -dokumentation.

Om du vill arbeta med replikuppsättningar och lära dig hur du definierar anslutningar mellan program och MongoDB-instanser går du till dokumentationen för anslutningssträngens URI-format för MongoDB.

Exempel-URL för anslutning till en replikuppsättning example-url-for-connecting-to-a-replica-set

# 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

Solr-konfiguration solr-configuration

En Solr-installation kan delas mellan nodbutiken (Oak) och den gemensamma lagringsplatsen (MSRP) med hjälp av olika samlingar.

Om både Oak- och MSRP-samlingarna används intensivt kan en andra Solr installeras av prestandaskäl.

I produktionsmiljöer ger SolrCloud-läget bättre prestanda jämfört med fristående läge (en enda lokal Solr-inställning).

Mer konfigurationsinformation finns i Solr Configuration for SRP.

Uppgraderar upgrading

Om du uppgraderar från en tidigare version som konfigurerats med MSRP måste du:

  1. Utför uppgraderingen till AEM Communities

  2. Installera nya Solr-konfigurationsfiler

  3. Indexera om MSRP
    Se avsnittet MSRP Reindex Tool

Publicera konfigurationen publishing-the-configuration

MSRP måste identifieras som det gemensamma arkivet på alla författar- och publiceringsinstanser.

Om du vill göra den identiska konfigurationen tillgänglig i publiceringsmiljön loggar du in på författarinstansen och följer stegen:

  • Navigera från huvudmenyn till Tools > Operations > Replication.
  • Välj Activate Tree
  • Start Path:
    • Bläddra till /etc/socialconfig/srpc/
  • Välj Activate

Hantera användardata managing-user-data

Mer information om användare, användarprofiler och användargrupper som ofta anges i publiceringsmiljön finns på

MSRP Reindex Tool msrp-reindex-tool

Det finns en HTTP-slutpunkt för omindexering av Solr för MSRP när nya konfigurationsfiler installeras eller när ett skadat Solr-index repareras.

Med det här verktyget är MongoDB källan till sanningen för MSRP. Säkerhetskopieringar behöver bara göras för MongoDB.

Hela UGC-trädet kan indexeras om, eller endast ett visst underträd, enligt parametern *path *data.

Det här verktyget kan köras från kommandoraden med cURL eller något annat HTTP-verktyg.

Vid omindexering sker en kompromiss mellan minne och prestanda som styrs av parametern *batchSize *data, som anger hur många UGC-poster som omindexeras per batch.

Ett rimligt standardvärde är 5000:

  • Om det är problem med minnet anger du ett mindre tal
  • Om hastigheten är ett problem anger du ett större tal för att öka hastigheten

Kör MSRP-omindexeringsverktyget med kommandot cURL running-msrp-reindex-tool-using-curl-command

Följande cURL-kommando visar vad som krävs för att en HTTP-begäran ska kunna indexera om UGC som lagras i MSRP.

Grundformatet är:

cURL -u signin -d data reindex-url

inloggning = administrator-id:password
Till exempel: admin:admin

data = "batchSize=size&path=path"

size = hur många UGC-poster som ska indexeras om per åtgärd
/content/usergenerated/asi/mongo/

sökväg = rotplatsen för UGC-trädet som ska indexeras om

  • Om du vill indexera om all UGC anger du värdet för egenskapen asipath för
    /etc/socialconfig/srpc/defaultconfiguration
  • Om du vill begränsa indexvärdet till en del UGC anger du ett underträd av asipath

reindex-url = slutpunkten för omindexering av SRP
http://localhost:4503/services/social/datastore/mongo/reindex

NOTE
Om du omindexerar DSRP-servernär URL:en /services/social/datastore/rdb/reindex

Exempel på omindexering av MSRP msrp-reindex-example

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

Demo av MSRP how-to-demo-msrp

Information om hur du konfigurerar MSRP för en demonstration- eller utvecklingsmiljö finns i Så här konfigurerar du MongoDB för demo.

Felsökning troubleshooting

UGC är inte synlig i MongoDB ugc-not-visible-in-mongodb

Kontrollera att MSRP har konfigurerats som standardprovider genom att kontrollera konfigurationen av lagringsalternativet. Som standard är lagringsresursprovidern JSRP.

Gå till Konsolen för lagringskonfiguration eller kontrollera den AEM databasen på alla författare och publicerade AEM:

  • I JCR, om /etc/socialconfig

    • Innehåller ingen srpc-nod, vilket betyder att lagringsprovidern är JSRP.
    • Om srpc-noden finns och innehåller noden defaultconfiguration, ska standardkonfigurationens egenskaper definiera MSRP som standardprovider.

UGC försvinner efter uppgradering ugc-disappears-after-upgrade

Om du uppgraderar från en befintlig AEM Communities 6.0-plats måste eventuell befintlig UGC konverteras så att den överensstämmer med den struktur som krävs för SRP API efter uppgradering till AEM Communities 6.3.

Det finns ett verktyg med öppen källkod tillgängligt på GitHub för detta ändamål:

Migreringsverktyget kan anpassas för att exportera UGC från tidigare versioner av AEM sociala communities för import till AEM Communities 6.1 eller senare.

Fel - odefinierad fältprovider_id error-undefined-field-provider-id

Om följande fel visas i loggarna anger det att Solr-schemafilen inte är korrekt konfigurerad.

JsonMappingException: odefinierad fältprovider_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 du vill åtgärda felet måste du kontrollera följande när du följer instruktionerna för Installera standard-MLS:

  • XML-konfigurationsfilerna kopierades till rätt Solr-plats.
  • Solr startades om efter att de nya konfigurationsfilerna ersatt de befintliga.

Säker anslutning till MongoDB misslyckas secure-connection-to-mongodb-fails

Om ett försök att skapa en säker anslutning till MongoDB-servern misslyckas på grund av att en klassdefinition saknas, är det nödvändigt att uppdatera MongoDB-drivrutinspaketet, mongo-java-driver, som är tillgängligt från den offentliga maven-databasen.

  1. Hämta drivrutinen från https://search.maven.org/#artifactdetails%7Corg.mongodb%7Cmongo-java-driver%7C2.13.2%7Cjar (version 2.13.2 eller senare).
  2. Kopiera paketet till mappen"crx-quickstart/install" för en AEM instans.
  3. Starta om AEM.

Resurser resources

recommendation-more-help
81e2cd9d-0789-409d-b87c-2a8ce4f28791