MSRP - Fournisseur de ressources de stockage MongoDB msrp-mongodb-storage-resource-provider

À propos de MSRP about-msrp

Lorsqu’AEM Communities est configuré pour utiliser MSRP comme magasin commun, le contenu généré par l’utilisateur est accessible à partir de toutes les instances de création et de publication, sans avoir à effectuer de synchronisation ni de réplication.

Consultez également les sections Caractéristiques des options SRP et Topologies recommandées.

Exigences requirements

Configuration de MongoDB mongodb-configuration

Sélectionner un MSRP select-msrp

La console de configuration du stockage permet de sélectionner la configuration de stockage par défaut, qui identifie l’implémentation de SRP à utiliser.

En mode de création, pour accéder à la console de configuration du stockage :

Jeu de Secondaires MongoDB mongodb-replica-set

Pour l’environnement de production, il est vivement recommandé de configurer un ensemble de répliques, un cluster de serveurs MongoDB qui implémente la réplication primaire-secondaire et le basculement automatisé.

Pour en savoir plus sur les ensembles de répliques, consultez la documentation Réplication de MongoDB.

Pour utiliser des ensembles de répliques et apprendre à définir des connexions entre les applications et les instances de MongoDB, consultez la documentation Format d’URI de chaîne de connexion de MongoDB.

Exemple d’URL pour la connexion à un jeu de Secondaires 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

Configuration de Solr solr-configuration

Une installation Solr peut être partagée entre le magasin de nœuds (Oak) et le magasin commun (MSRP) à l’aide de différentes collections.

Si les collections Oak et MSRP sont utilisées de manière intensive, un second Solr peut être installé pour des raisons de performances.

Pour les environnements de production, le mode SolrCloud offre de meilleures performances par rapport au mode autonome (une configuration Solr unique et locale).

Pour plus d’informations sur la configuration, voir Configuration de Solr pour SRP.

Mise à niveau upgrading

Si vous effectuez une mise à niveau à partir d’une version antérieure configurée avec MSRP, il sera nécessaire de :

Publication de la configuration publishing-the-configuration

MSRP doit être identifié comme le magasin commun sur toutes les instances de création et de publication.

Pour rendre la configuration identique disponible dans l’environnement de publication, connectez-vous à votre instance de création et procédez comme suit :

Gestion des données utilisateur managing-user-data

Pour plus d’informations sur les utilisateurs, profils utilisateur et groupes d’utilisateurs, souvent saisis dans l’environnement de publication, consultez

Outil de réindexation MSRP msrp-reindex-tool

Il existe un point d’entrée HTTP pour la réindexation de Solr pour MSRP lors de l’installation de nouveaux fichiers de configuration ou de la réparation d’un index Solr endommagé.

Avec cet outil, MongoDB est la source de vérité pour MSRP ; les sauvegardes ne doivent être effectuées que sur MongoDB.

L’ensemble de l’arborescence du contenu créé par l’utilisateur peut être réindexé, ou seulement une sous-arborescence spécifique, comme spécifié par le paramètre de données path.

Cet outil peut être exécuté à partir de la ligne de commande à l’aide de cURL ou de tout autre outil HTTP.

Lors de la réindexation, il existe un compromis entre la mémoire et les performances contrôlées par le paramètre de données batchSize, qui spécifie le nombre d’enregistrements UGC réindexés par lot.

Une valeur par défaut raisonnable est de 5 000 :

Exécution de l’outil de réindexation MSRP à l’aide de la commande cURL running-msrp-reindex-tool-using-curl-command

La commande cURL suivante indique ce qui est nécessaire pour qu’une requête HTTP réindexe le contenu créé par l’utilisateur stocké dans MSRP.

Le format de base est :

cURL -u signin -d data reindex-url

signin = administrator-id:password
Par exemple : admin:admin

data = « batchSize=size&path=path »

size = nombre d’entrées UGC à réindexer par opération
/content/usergenerated/asi/mongo/

path = emplacement racine de l’arborescence du contenu créé par l’utilisateur à réindexer.

reindex-url = point d’entrée pour la réindexation du SRP
http://localhost:4503/services/social/datastore/mongo/reindex

Exemple de réindexation 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

Comment effectuer une démonstration de MSRP how-to-demo-msrp

Pour configurer MSRP pour un environnement de démonstration ou de développement, voir Comment configurer MongoDB pour la démonstration ​.

Résolution des problèmes troubleshooting

Contenu créé par l’utilisateur non visible dans MongoDB ugc-not-visible-in-mongodb

Assurez-vous que MSRP a été configuré pour être le fournisseur par défaut en vérifiant la configuration de l’option de stockage . Par défaut, le fournisseur de ressources de stockage est JSRP.

Sur toutes les instances d’AEM de création et de publication, revenez sur la console de configuration de stockage ou vérifiez le référentiel AEM :

UGC disparaît après la mise à niveau ugc-disappears-after-upgrade

Si vous effectuez une mise à niveau à partir d’un site AEM Communities 6.0 existant, tout contenu créé par l’utilisateur préexistant doit être converti conformément à la structure requise pour l’API SRP après la mise à niveau vers AEM Communities 6.3.

Un outil open source est disponible sur GitHub à cet effet :

L’outil de migration peut être personnalisé pour exporter du contenu créé par l’utilisateur à partir de versions antérieures des communautés sociales AEM en vue de l’importer dans AEM Communities 6.1 ou une version ultérieure.

Erreur - champ provider_id non défini error-undefined-field-provider-id

Si l’erreur suivante s’affiche dans les journaux, cela indique que le fichier de schéma Solr n’est pas correctement configuré.

JsonMappingException : champ provider_id non défini 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

Pour résoudre l’erreur, lorsque vous suivez les instructions de la section Installation de MLS standard, assurez-vous que :

Échec de la connexion sécurisée à MongoDB secure-connection-to-mongodb-fails

Si une tentative de connexion sécurisée au serveur MongoDB échoue en raison d’une définition de classe manquante, il est nécessaire de mettre à jour le lot de pilotes MongoDB, mongo-java-driver, disponible à partir du référentiel Maven public.

Ressources resources