DocumentationAEM 6.5Guide de Communities

Configuration Solr pour SRP solr-configuration-for-srp

Last update: Sun Jul 14 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

Créé pour :

  • Administration

Solr pour AEM Platform solr-for-aem-platform

Une installation Apache Solr peut être partagée entre le magasin de noeuds (Oak) et le magasin commun (SRP) à l’aide de collections différentes.

Si les collections Oak et SRP 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 seule configuration Solr locale).

Conditions requises requirements

Téléchargez et installez Apache Solr :

Mode SolrCloud solrcloud-mode

Le mode SolrCloud est recommandé pour les environnements de production. Lors de l’exécution en mode SolrCloud, SolrCloud doit être installé et configuré avant d’installer la recherche multilingue (MLS).

Il est recommandé de suivre les instructions d’installation de SolrCloud :

  • 3 noeuds SolrCloud sur le même serveur.
  • Un ZooKeeper Apache externe.

Il est également recommandé de configurer JVM pour optimiser l’utilisation de la mémoire et le nettoyage de la mémoire.

Exemple de configuration JVM jvm-configuration-example

JVM_OPTS="-server -Xmx2048m -XX:+UseConcMarkSweepGC -XX:+CMSClassUnloadingEnabled -Xloggc:../logs/gc.log -XX:+PrintGCDetails -XX:+PrintGCDateStamps -Djava.awt.headless=true"

Commandes de configuration de SolrCloud solrcloud-setup-commands

Lors de l’exécution en mode SolrCloud, avant l’installation, l’utilisation et la connaissance des commandes de configuration de SolrCloud suivantes sont nécessaires.

1. Télécharger une configuration sur ZooKeeper upload-a-configuration-to-zookeeper

Référence :
https://solr.apache.org/guide/6_6/command-line-utilities.html

Utilisation :
sh ./scripts/cloud-scripts/zkcli.sh
-cmd upconfig
-zkhost server:port
-confname *myconfig-name *
-solrhome solr-home-path
-confdir config-dir

2. Créer une collection create-a-collection

Référence :
https://solr.apache.org/guide/6_6/solr-control-script-reference.html#SolrControlScriptReference-Create

Utilisation :
./bin/solr create
-c mycollection-name
-d config-dir
-n myconfig-name
-p port
-s nombre de éclats
-rf nombre-de-réplication

Liez une collection à une configuration déjà téléchargée sur ZooKeeper.

Référence :
https://solr.apache.org/guide/6_6/command-line-utilities.html

Utilisation :
sh ./scripts/cloud-scripts/zkcli.sh
-cmd linkconfig
-zkhost server:port
-collection mycollection-name
-confname myconfig-name

Comparaison des MLS standard et avancés comparison-of-standard-and-advanced-mls

La recherche multilingue (MLS) pour AEM Communities est conçue pour la plateforme Solr afin de fournir une recherche améliorée dans toutes les langues prises en charge, y compris l’anglais.

MLS pour AEM Communities est disponible en tant que MLS standard ou MLS avancé. Le MLS standard inclut uniquement les paramètres de configuration Solr et exclut tous les modules externes ou fichiers de ressources. Le MLS avancé est la solution la plus complète et inclut des paramètres de configuration Solr, des modules externes et des ressources associées.

Le MLS standard comprend des améliorations pour la recherche de contenu dans les langues suivantes :

  • Anglais : recherche de radical améliorée pour tenter de correspondre aux dérivations de mots.
  • Japonais : amélioration de la segmentation en jetons japonais pour les caractères à demi-largeur.

Le MLS avancé comprend des améliorations pour la recherche de contenu dans les langues suivantes :

  • Anglais : recteur remplacé par un lemmatizer.
  • Allemand : ajout d’un décompositeur.
  • Français : ajout de la gestion des élites.
  • Chinois (simplifié) : ajout d’un jeton plus intelligent.
  • Diverses langues : ajout d’un radical, d’une liste de mots vides et d’un normaliseur.

Au total, les 33 langues suivantes sont prises en charge dans Advanced MLS.

Arabe
Allemand
Norvégien
Bulgare
Grec
Polonais
Chinois (simplifié)
Créole haïtien
Portugais
Chinois (traditionnel)
Hébreu
Roumain
Tchèque
Hongrois
Russe
Danois
Indonésien
Slovaque
Néerlandais
Italien
Slovène
Anglais
Japonais
Espagnol
Estonien
Coréen
Suédois
Finnois
Lette
Thaïlandais
Français
Lituanien
Turc

Comparaison d’AEM 6.1 Solr search, Standard MLS et Advanced MLS comparison-of-aem-solr-search-standard-mls-and-advanced-mls

Remarque : AEM 6.1 fait référence à AEM 6.1 Communities FP3 et versions antérieures.

compare-solr-mls

Installation de MLS standard installing-standard-mls

Pour la collection SRP (MSRP ou DSRP), pour prendre en charge la recherche multilingue standard (MLS), il est nécessaire de modifier deux des fichiers de configuration de Solr :

  • schema.xml
  • solrconfig.xml

Fichiers MLS standard (schema.xml, solrconfig.xml) pour Solr 4.10.

Fichiers MLS standard (schema.xml, solrconfig.xml) pour Solr 5.x.

Les fichiers MLS standard sont stockés dans le référentiel AEM.

Remarque : Bien que les fichiers Solr soient stockés dans le dossier msrp/ , ils sont également destinés au DSRP (aucune modification n’est nécessaire).

Télécharger les instructions : remplacez solrX par solr4 ou solr5 selon les besoins.

  1. À l’aide de CRXDE|Lite, localisez :

    • /libs/social/config/datastore/msrp/solrX/schema.xml
    • /libs/social/config/datastore/msrp/solrX/solrconfig.xml

  2. Téléchargez-le sur le serveur local sur lequel Solr est déployé.

    • Recherchez la propriété jcr:data du noeud jcr:content.
    • Pour lancer le téléchargement, sélectionnez view.
    • Vérifiez que les fichiers sont enregistrés avec les noms et le codage appropriés (UTF8).

  3. Suivez les instructions d’installation pour le mode autonome ou SolrCloud .

Mode SolrCloud - MLS standard solrcloud-mode-standard-mls

  1. Installez et configurez Solr en mode SolrCloud.

  2. Préparez une nouvelle configuration :

    1. Créez new-config-dir* comme solr-install-dir*/myconfig/

    2. Copiez le contenu du répertoire de configuration Solr existant vers new-config-dir

      • Pour Solr4 : copie solr-install-dir/example/solr/collection1/conf/
      • Pour Solr5 : copie solr-install-dir/server/solr/configsets/data_driven_schema_configs/

    3. Copiez les fichiers schema.xml et solrconfig.xml téléchargés dans new-config-dir pour remplacer les fichiers existants.

  3. Téléchargez la nouvelle configuration vers ZooKeeper.

  4. Créez une collection spécifiant les paramètres nécessaires, tels que le nombre de partitions, le nombre de répliques et le nom de configuration.

  5. Si le nom de la configuration n’a pas été fourni lors de la création de la collection, liez cette nouvelle collection avec la configuration téléchargée sur ZooKeeper.

  6. Pour MSRP, exécutez MSRP Reindex Tool, sauf si cette installation est nouvelle.

Mode autonome - MLS standard standalone-mode-standard-mls

  1. Installez Solr en mode autonome.

  2. Si vous exécutez Solr5, créez une collection1 (semblable à Solr4) :

    • ./bin/solr start
    • ./bin/solr create_core -c collection1 -d sample_techproducts_configs

  3. Sauvegardez schema.xml et solrconfig.xml dans le répertoire de configuration Solr, par exemple :

    • Pour Solr4 : solr-install-dir/example/solr/collection1/conf/
    • Créé pour Solr5 : solr-install-dir/server/solr/collection1/conf/

  4. Copiez les fichiers schema.xml et solrconfig.xml téléchargés dans le même répertoire.

  5. Redémarrez Solr.

  6. Pour MSRP, exécutez MSRP Reindex Tool, sauf si cette installation est nouvelle.

Installation de MLS avancés installing-advanced-mls

Pour que la collection SRP (MSRP ou DSRP) prenne en charge les MLS avancés, de nouveaux modules externes Solr sont requis en plus d’un schéma personnalisé et d’une configuration Solr. Tous les éléments requis sont compressés dans un fichier ZIP téléchargeable. En outre, un script d’installation est inclus pour une utilisation lorsque Solr est déployé en mode autonome.

Pour obtenir le package MLS avancé, reportez-vous à la section AEM MLS avancé dans la section déploiement de la documentation.

Pour commencer l’installation pour SolrCloud ou le mode autonome :

  • Téléchargez l’archive zip AEM-SOLR-MLS sur le serveur hébergeant Solr.
  • Décompressez l’archive.

Mode SolrCloud - MLS avancé solrcloud-mode-advanced-mls

Instructions d’installation - Notez les quelques différences pour Solr4 et Solr5 :

  1. Installez et configurez Solr en mode SolrCloud.

  2. Extrayez le contenu du package MLS avancé sur le disque. Le contenu doit inclure :

    • schema.xml
    • solrconfig.xml
    • dossier stopwords/
    • Dossier profiles/
    • Dossier extra-libs/

  3. Préparez une nouvelle configuration :

    1. Créez un new-config-dir

      • Par exemple : solr-install-dir/myconfig/
      • Créer des sous-dossiers stopwords/ et lang/

    2. Copiez le contenu du répertoire de configuration Solr existant vers new-config-dir

      • Pour Solr4 : Copie solr-install-dir/example/solr/collection1/conf/
      • Pour Solr5 : Copie solr-install-dir/server/solr/configsets/data_driven_schema_configs/

    3. Copiez les fichiers schema.xml et solrconfig.xml extraits dans new-config-dir pour remplacer les fichiers existants.

    4. Pour Solr5 : Copiez solr_install_dir/server/solr/configsets/sample_techproducts_configs/conf/lang/*.txt vers new-config-dir/lang/

    5. Copiez le dossier stopwords/ extrait dans new-config-dir, ce qui entraîne l'extraction de new-config-dir/stopwords/*.txt

  4. Télécharger la nouvelle configuration vers ZooKeeper

  5. Copiez le nouveau dossier profiles/ …

    • Pour Solr4 : Copiez dans les ressources/dossiers de chaque noeud
    • Pour Solr5 : copiez dans chaque dossier/serveur/ressources/dossier d’installation Solr. Si tous les noeuds se trouvent dans le même répertoire d’installation Solr, cette étape est effectuée une seule fois.

  6. Créez un dossier lib/ dans le répertoire solr-home (contient solr.xml) de chaque noeud dans SolrCloud. Copiez les jars des emplacements suivants dans le nouveau dossier lib/ de chaque noeud :

    • extra-libs/ extrait du package MLS avancé
    • solr-install-dir/contrib/extraction/lib/.jar
    • solr-install-dir/dist/solr-cell.jar
    • solr-install-dir/contrib/clustering/lib/.jar
    • rép-installation-solr/dist/solr-clustering.jar
    • solr-install-dir/contrib/langid/lib/.jar
    • solr-install-dir/dist/solr-langid.jar
    • solr-install-dir/contrib/velocity/lib/.jar
    • solr-install-dir/dist/solr-velocity.jar
    • solr-install-dir/contrib/analysis-extras/lib/.jar
    • solr-install-dir/contrib/analysis-extras/lucene-libs/.jar

  7. Créez une collection spécifiant les paramètres nécessaires, tels que le nombre de partitions, le nombre de répliques et le nom de configuration.

  8. Si le nom de la configuration n’a pas été fourni lors de la création de la collection, liez cette nouvelle collectionavec la configuration téléchargée sur ZooKeeper.

  9. Pour MSRP, exécutez MSRP Reindex Tool, sauf si cette installation est nouvelle.

Mode autonome - MLS avancé standalone-mode-advanced-mls

Un script d’installation est inclus dans le package MLS avancé.

Une fois le contenu du package extrait sur le serveur hébergeant le serveur Solr autonome, exécutez le script d'installation pour installer les ressources et les fichiers de configuration nécessaires.

  • Installez Solr en mode autonome.

  • Si vous exécutez Solr5, créez une collection1 (semblable à Solr4) :

    • ./bin/solr start
    • ./bin/solr create_core -c collection1 -d sample_techproducts_configs

  • Exécutez le script d’installation : installez [-v 4|5] [-d solrhome] [-c collectionpath]
    où :

    • -d solrhome

      Répertoire d’installation Solr

    • -c collectionpath

      Chemin d’accès de la collection dans solitaire

    • –help

      Options de ligne de commande Imprimer

    • -v [4|5]

      Définition de la version pour solder

  • Exemple pour Solr 4.10.4 :

    • Install.bat -v 4 -d c:/solr-4.10.4 -c:/solr-4.10.4/example/solr/collection1

  • Exemple pour Solr 5.4.0 :

    • Install.sh -v 5 -d /tmp/solr-5.4.0 -c /tmp/solr-5.4.0/server/solr/collection1

Remarque  :

  • Le script d’installation sauvegarde schema.xml et solrconfig.xml avant d’installer de nouvelles versions en ajoutant ".orig"

A propos de solrconfig.xml about-solrconfig-xml

Le fichier solrconfig.xml contrôle l’intervalle de validation automatique et la visibilité de la recherche, et nécessite des tests et des réglages.

<autoCommit> : par défaut, l’intervalle AutoCommit, qui est une validation hard vers un stockage stable, est défini sur 15 secondes. La visibilité de la recherche utilise par défaut l’index de pré-validation.

Pour modifier la recherche afin d’utiliser un index mis à jour pour prendre en compte les modifications dues à la validation, remplacez le openSearcher contenu par true.

autoSoftCommit : une validation "soft" garantit que les modifications sont visibles (l’index est mis à jour), mais ne garantit pas que les modifications sont synchronisées avec un stockage stable (hard commit). Les performances s’en trouvent améliorées. Par défaut, autoSoftCommit est désactivé avec le maxTime contenu défini sur -1.

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