MSRP - Fournisseur de ressources de stockage MongoDB msrp-mongodb-storage-resource-provider
A 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 d’auteur et de publication sans avoir besoin de synchronisation ni de réplication.
Voir aussi Caractéristiques des options SRP et Topologies recommandées.
Conditions requises requirements
-
- Version 2.6 ou ultérieure
- Pas besoin de configurer des mongos ou des partages
- Il est vivement recommandé d’utiliser un ensemble de réplications
- Peut s’exécuter sur le même hôte que AEM ou à distance
-
-
Version 4.10 ou version 5
-
Solr nécessite Java 1.7 ou version ultérieure
-
Aucun service requis
-
Choix des modes d’exécution :
- Mode autonome
- Mode SolrCloud (recommandé pour les environnements de production)
-
Choix de la recherche multilingue (MLS)
-
Configuration de MongoDB mongodb-configuration
Sélectionner MSRP select-msrp
Le Console de configuration de stockage permet de sélectionner la configuration de stockage par défaut, qui identifie l’implémentation de la SRP à utiliser.
À l’auteur, pour accéder à la console Configuration de stockage :
- À partir de la navigation globale : Outils > Communautés > Configuration de stockage
-
Sélectionner MongoDB Storage Resource Provider (MSRP)
-
Configuration de mongoDB
-
URI de mongoDB
default: mongodb://localhost/?maxPoolSize=10&waitQueueMultiple=5&readPreference=secondaryPreferred
-
Base de données mongoDB
default: communities
-
Collection UGC mongoDB
default: content
-
Collection de pièces jointes mongoDB
default: attachments
-
-
SolrConfiguration
-
🔗Hôte Zookeeper
Lors de l’exécution de Mode SolrCloud avec un ZooKeeper externe, définissez cette valeur sur la variable
HOST:PORT
pour le ZooKeeper, par exemple my.server.com:2181
Pour un ensemble ZooKeeper, saisissez des valeurs séparées par des virgules.HOST:PORT
des valeurs, telles que host1:2181,host2:2181
Laissez vide si Solr est exécuté en mode autonome à l’aide du ZooKeeper interne.
Par défaut: <blank> -
URL Solr
URL utilisée pour communiquer avec Solr en mode autonome.
Laissez vide si vous exécutez en mode SolrCloud.
Par défaut: https://127.0.0.1:8983/solr/ -
Collection Solr
Nom de la collection Solr.
Par défaut: collection1
-
-
Sélectionnez Envoyer
communities
, ne doit pas être défini sur le nom d’une base de données utilisée pour Noeuds ou magasins de données (binaires). Voir aussi Éléments de stockage dans AEM 6.Jeu de Secondaires MongoDB mongodb-replica-set
Pour l’environnement de production, il est vivement recommandé de configurer un ensemble de réplications, un groupe de serveurs MongoDB qui implémente la réplication Principale-secondaire et le basculement automatisé.
Pour en savoir plus sur les jeux de réplications, consultez les Réplication documentation.
Pour utiliser des jeux de réplications et apprendre à définir des connexions entre les applications et les instances MongoDB, consultez les Format URI de chaîne de connexion documentation.
Exemple d’URL pour la connexion à un jeu de Secondaires 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/fr/support/programs/eol-matrix.html). Find the supported versions [here](https://experienceleague.adobe.com/docs/?lang=fr).
# 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/fr/support/programs/eol-matrix.html). Find the supported versions [here](https://experienceleague.adobe.com/docs/?lang=fr).
# 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/fr/support/programs/eol-matrix.html). Find the supported versions [here](https://experienceleague.adobe.com/docs/?lang=fr).
# 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/fr/support/programs/eol-matrix.html). Find the supported versions [here](https://experienceleague.adobe.com/docs/?lang=fr).
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 noeuds (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, Mode SolrCloud offre de meilleures performances par rapport au mode autonome (une seule configuration Solr locale).
Pour plus d’informations sur la configuration, voir Configuration Solr pour SRP.
Mise à niveau upgrading
Si vous effectuez une mise à niveau à partir d’une version antérieure configurée avec MSRP, il est nécessaire de
-
Effectuez les opérations suivantes : Mise à niveau vers AEM Communities
-
Installation de nouveaux fichiers de configuration Solr
- Pour MLS standard
- Pour MLS avancé
-
Réindexation MSRP Voir section Outil de réindexation MSRP
Publication de la configuration publishing-the-configuration
MSRP doit être identifié comme le magasin commun sur toutes les instances d’auteur et de publication.
Pour rendre la configuration identique disponible dans l’environnement de publication :
-
Sur l’auteur :
- Accédez à à partir du menu principal Outils > Opérations > Réplication
- Sélectionner Activer l’arborescence
- Chemin de début:
- Accédez à
/etc/socialconfig/srpc/
- Accédez à
- Sélectionner Activer
Gestion des données utilisateur managing-user-data
Pour plus d’informations sur utilisateurs, profils utilisateur et groupes d’utilisateurs, souvent entrées 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 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 de MongoDB.
L’arborescence UGC entière peut être réindexée, ou seulement une sous-arborescence spécifique, comme spécifié par le paramètre *path *data .
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 5000 :
- Si la mémoire pose problème, indiquez un nombre plus petit.
- Si la vitesse est un problème, spécifiez un nombre plus grand pour augmenter la vitesse.
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 une requête HTTP de réindexation du contenu généré par l’utilisateur stocké dans MSRP.
Le format de base est le suivant :
cURL -u signature -d data reindex-url
signature = 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 généré par l’utilisateur à réindexer.
- Pour réindexer tout le contenu généré par l’utilisateur, spécifiez la valeur de la variable
asipath
de/etc/socialconfig/srpc/defaultconfiguration
- Pour limiter l’index à un contenu généré par l’utilisateur, spécifiez une sous-arborescence de
asipath
reindex-url = point de terminaison de la réindexation de la SRPhttp://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
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
UGC invisible dans MongoDB ugc-not-visible-in-mongodb
Vérifiez que MSRP a été configuré comme 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, consultez à nouveau la Console de configuration de stockage ou vérifiez le référentiel AEM :
-
Dans JCR, si /etc/socialconfig
- Ne contient pas d’objet srpc , cela signifie que le fournisseur de stockage est JSRP.
- Si le noeud srpc existe et contient le noeud defaultconfiguration, les propriétés de la configuration par défaut doivent définir MSRP comme fournisseur par défaut.
Le contenu généré par l’utilisateur 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 généré par l’utilisateur préexistant doit être converti pour être conforme à la structure requise pour la variable SRP API 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 le contenu créé par l’utilisateur à partir de versions antérieures d’AEM communautés sociales pour l’importer dans AEM Communities 6.1 ou une version ultérieure.
Error - champ non défini provider_id error-undefined-field-provider-id
Si l’erreur suivante s’affiche dans les journaux, elle indique que le fichier de schéma Solr n’est pas correctement configuré.
JsonMappingException : provider_id de champ 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, en suivant les instructions de la rubrique Installation de MLS standard, assurez
- Les fichiers de configuration XML ont été copiés à l’emplacement Solr correct.
- Solr a été redémarré après que les nouveaux fichiers de configuration ont remplacé les fichiers existants.
Échec de la connexion sécurisée à MongoDB secure-connection-to-mongodb-fails
Si une tentative d’établissement d’une 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 du pilote MongoDB, mongo-java-driver
, disponible à partir du référentiel Maven public.
- Téléchargez le pilote à partir de https://search.maven.org/#artifactdetails%7Corg.mongodb%7Cmongo-java-driver%7C2.13.2%7Cjar (version 2.13.2 ou ultérieure)
- Copiez le lot dans le dossier "crx-quickstart/install" pour une instance AEM
- Redémarrez l’instance AEM