MSRP - Fournisseur de ressources d'Enregistrement MongoDB

A propos de MSRP

Lorsque 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 à effectuer de synchronisation ni de réplication.

Voir aussi Caractéristiques des options SRP et Topologies recommandées.

Conditions requises

  • MongoDB:

    • Version 2.6 ou ultérieure
    • Pas besoin de configurer les mongos ou le partage
    • Recommander fortement l'utilisation d'un jeu de réplicas
    • Peut s’exécuter sur le même hôte que AEM ou à distance
  • Apache Solr:

    • Version 4.10 ou version 5
    • Le serveur requiert 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)

MongoDB Configuration

Sélectionner MSRP

La console Configuration de l' Enregistrement permet de sélectionner la configuration d'enregistrement par défaut, qui identifie l'implémentation de SRP à utiliser.

Sur author, pour accéder à la console de configuration d’Enregistrement :

  • A partir de la navigation globale : Outils > Communautés > Configuration des Enregistrements

chlimage_1-28

  • Select MongoDB Storage Resource Provider (MSRP)

  • Configuration de mongoDB

    • URI de mongoDB

      par défaut: mongodb://localhost/?maxPoolSize=10&waitQueueMultiple=5&readPreference=secondaryPreferred

    • Base de données mongoDB

      par défaut: communautés

    • Collection UGC mongoDB

      par défaut: content

    • Collection de pièces jointes mongoDB

      par défaut: pièces jointes

  • SolrConfiguration

    • Hôte Zookeeper

      Lors de l’exécution en mode SolrCloud avec un ZooKeeper externe, définissez cette valeur sur HOST:PORT pour le ZooKeeper, par exemple my.server.com:2181 Pour un ZooKeeper Ensemble, entrez des HOST:PORT valeurs séparées par des virgules, telles que host1:218,host2:211118. 1Laissez vide si Solr est exécuté en mode autonome à l’aide du ZooKeeper interne.
      Par défaut: <blank>

    • URL​solaire 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

Remarque

La base de données mongoDB, dont le nom par défaut communitiesest le nom, ne doit pas être définie sur le nom d’une base de données utilisée pour les magasins de noeuds ou les magasins de données (binaires). Voir aussi Enregistrement Elements dans AEM 6.

Jeu de Secondaires MongoDB

Pour l’environnement de production, il est fortement recommandé de configurer un jeu de réplicas, un cluster de serveurs MongoDB qui implémente la réplication Principale-secondaire et le basculement automatisé.

Pour en savoir plus sur les jeux de réplicas, consultez la documentation sur la réplication de MongoDB.

Pour utiliser des jeux de réplicas et apprendre à définir des connexions entre les applications et les instances MongoDB, consultez la documentation sur le format URI de chaîne de connexion de MongoDB.

Exemple d’URL pour la connexion à un jeu de Secondaires

# 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

Une installation Solr peut être partagée entre le magasin de noeuds (Oak) et le magasin commun (MSRP) en utilisant différentes collections.

Si les deux collections Oak et MSRP sont utilisées de façon 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 seule configuration Solr locale).

Pour plus d'informations sur la configuration, reportez-vous à la section Configuration solaire pour SRP.

Mise à niveau

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

  1. Effectuer la mise à niveau vers AEM Communities
  2. Installer de nouveaux fichiers de configuration Solr
  3. Réindexer l'outil de réindexation de la section MSRP MSRP

Publication de la 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 au menu principal à Outils > Opérations > Réplication.
    • Sélectionner Activer l'arborescence
    • Chemin de début:
      • Naviguer jusqu’à /etc/socialconfig/srpc/
    • Sélectionner Activer

Gestion des données utilisateur

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

Outil de réindexation MSRP

Il existe un point de terminaison 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'arbre UGC entier peut être réindexé, 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.

La valeur par défaut raisonnable est 5000 :

  • Si la mémoire pose problème, indiquez un nombre inférieur.
  • Si la vitesse est un problème, indiquez un nombre plus élevé pour augmenter la vitesse.

Exécution de l’outil de réindexation MSRP à l’aide de la commande cURL

La commande cURL suivante indique ce qui est nécessaire pour qu’une requête HTTP puisse réindexer l’UGC stockée 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"

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

chemin = emplacement racine de l'arborescence de l'UGC à réindexer

  • Pour réindexer tous les fichiers UGC, spécifiez la valeur de la asipathpropriété de
    /etc/socialconfig/srpc/defaultconfiguration
  • Pour limiter l’index à certains UGC, spécifiez une sous-arborescence de asipath

reindex-url = point de terminaison de la réindexation de SRP
http://localhost:4503/services/social/datastore/mongo/reindex

Remarque

Si vous réindexez DSRP Solr, l’URL est /services/social/datastore/rdb/reindex.

Exemple de réindexation MSRP

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

Pour configurer MSRP pour une démonstration ou un environnement de développement, voir Procédure de configuration de MongoDB pour la démonstration.

Résolution des incidents

UGC invisible dans MongoDB

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

Sur toutes les instances d’AEM création et de publication, consultez de nouveau la console Configuration de l’ Enregistrement ou vérifiez le référentiel AEM :

  • Dans JCR, si /etc/socialconfig

    • Ne contient pas de noeud srpc , cela signifie que le fournisseur d’enregistrements est JSRP
    • Si le noeud srpc existe et contient la configuration pardéfaut du noeud, les propriétés de la configuration par défaut doivent définir MSRP comme fournisseur par défaut.

UGC disparaît après la mise à niveau

Si une mise à niveau à partir d’un site AEM Communities 6.0 existant, tout fichier UGC préexistant doit être converti en fonction de 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 l’UGC à partir de versions antérieures d’AEM communautés sociales en vue de son importation dans AEM Communities 6.1 ou version ultérieure.

Erreur - champ non défini provider_id

Si l'erreur suivante apparaît dans les journaux, cela indique que le fichier de schéma Solr n'est pas correctement configuré.

JsonMappingException : provider_id de champ non défini

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 d’ installation de MLSstandard, veillez à

  • Les fichiers de configuration XML ont été copiés à l’emplacement Solr approprié.
  • 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

Si une tentative d'établir 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 de pilotes MongoDB mongo-java-driver, disponible dans le référentiel public maven.

  1. 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)
  2. Copiez le lot dans le dossier "crx-quickstart/install" pour une instance AEM
  3. Redémarrez l’instance AEM

Ressources

Sur cette page