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
-
- Version 2.6 eller senare
- Du behöver inte konfigurera mongor eller delningar
- Rekommendera starkt en replikuppsättning
- Kan köras på samma värd som AEM eller fjärrköras
-
-
Solr version 7.0
-
Solr kräver Java 1.7 eller senare
-
Ingen tjänst behövs
-
Val av körningslägen:
- Fristående läge
- SolrCloud-läge (rekommenderas för produktionsmiljöer)
-
Val av flerspråkig sökning (MLS):
-
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.
-
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:2181Ange kommaavgränsade
HOST:PORT
-värden för en ZooKeeper Ensemble, till exempel host1:2181,host2:2181Lä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
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:
-
Installera nya Solr-konfigurationsfiler
- För standard-MLS
- För avancerad MLS
-
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/
- Bläddra till
- 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 SRPhttp://localhost:4503/services/social/datastore/mongo/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.
- 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).
- Kopiera paketet till mappen"crx-quickstart/install" för en AEM instans.
- Starta om AEM.