Prérequis du moteur de recherche

Depuis Adobe Commerce 2.4, toutes les installations doivent être configurées pour utiliser Elasticsearch ou OpenSearch en tant que solution de recherche catalogue.

NOTE
La prise en charge d’OpenSearch a été ajoutée à la version 2.4.4. OpenSearch est un double compatible d’Elasticsearch. Toutes les instructions pour configurer Elasticsearch 7 s’appliquent à OpenSearch. Migration de l’Elasticsearch vers OpenSearch fournit des conseils sur le passage à OpenSearch.

Versions prises en charge

Vous devez installer et configurer Elasticsearch ou OpenSearch avant d’installer Adobe Commerce 2.4.4 et versions ultérieures.

Voir Configuration requise pour des informations de version spécifiques.

Configuration recommandée

Nous vous recommandons ce qui suit :

Emplacement d’installation

Les tâches suivantes supposent que vous avez configuré votre système selon le diagramme suivant :

Diagramme du moteur de recherche

Le diagramme qui précède affiche :

  • L’application Commerce et le moteur de recherche sont installés sur différents hôtes.

    L’exécution sur des hôtes distincts nécessite un proxy pour fonctionner. (La mise en grappe du moteur de recherche va au-delà de ce guide, mais vous trouverez plus d’informations dans la section Documentation sur la mise en grappe des Elasticsearch.)

  • Chaque hôte possède son propre serveur web ; les serveurs web ne doivent pas nécessairement être les mêmes.

    Par exemple, l’application Commerce peut exécuter Apache et le moteur de recherche peut exécuter nginx.

  • Les deux serveurs web utilisent TLS (Transport Layer Security).

    La configuration de TLS dépasse la portée de notre documentation.

Les requêtes de recherche sont traitées comme suit :

  1. Une requête de recherche d’un utilisateur est reçue par le serveur web Commerce, qui la transfère au serveur du moteur de recherche.

    Vous configurez le moteur de recherche pour qu’il se connecte à l’hôte et au port du proxy. Nous vous recommandons le port SSL du serveur web (par défaut, 443).

  2. Le serveur web du moteur de recherche (écoute sur le port 443) envoie une requête par proxy au serveur du moteur de recherche (par défaut, il écoute sur le port 9200).

  3. L’accès au moteur de recherche est protégé par l’authentification HTTP de base. Pour qu’une requête atteigne le moteur de recherche, il doit passer par SSL. et indiquez un nom d’utilisateur et un mot de passe valides.

  4. Le moteur de recherche traite la requête.

  5. La communication renvoie le même itinéraire, le serveur web Elasticsearch agissant comme un proxy inverse sécurisé.

Conditions préalables

Les tâches abordées dans cette section nécessitent les éléments suivants :

Pare-feu et SELinux

Les logiciels liés à la sécurité (iptables, SELinux, AppArmor) peuvent être configurés par défaut pour bloquer la communication entre les sous-systèmes. C'est peut-être une bonne idée de les vérifier s'il y a des problèmes.

Configuration de règles pour iptables et SELinux

Pour configurer des règles permettant la communication avec le pare-feu ou SELinux activé, consultez les ressources suivantes :

Installation du Java Software Development Kit

Pour déterminer si Java est déjà installé, saisissez la commande suivante :

java -version

Si le message java: command not found s’affiche, vous devez installer le SDK Java, comme décrit dans la section suivante.

Consultez l’une des sections suivantes :

Installation du JDK sur CentOS

Voir Tutoriel sur les océans numériques.

Assurez-vous d’installer le JDK et not JRE.

yum -y install java-1.8.0-openjdk
NOTE
Il se peut que la version 8 de Java ne soit pas disponible pour tous les systèmes d’exploitation. Par exemple, vous pouvez rechercher la liste des packages disponibles pour Ubuntu ;.

Installation du JDK sur Ubuntu

Pour installer JDK 1.8 sur Ubuntu, saisissez les commandes suivantes en tant qu’utilisateur avec root privilèges :

apt-get -y update
apt-get install -y openjdk-8-jdk

Pour connaître les autres options, voir Documentation Oracle.

Installation du moteur de recherche

Suivez Installation de l’Elasticsearch ou Installation et configuration d’OpenSearch pour les étapes spécifiques à votre plateforme.

Pour vérifier que l’Elasticsearch fonctionne, saisissez la commande suivante sur le serveur sur lequel il s’exécute :

curl -XGET '<host>:9200/_cat/health?v&pretty'

Un message similaire au suivant s’affiche :

epoch      timestamp cluster       status node.total node.data shards pri relo init unassign pending_tasks
1519701563 03:19:23  elasticsearch green           1         1      0   0    0    0        0             0

Pour vérifier que OpenSearch fonctionne, saisissez les commandes suivantes :

curl -XGET https://<host>:9200 -u 'admin:admin' --insecure
curl -XGET https://<host>:9200/_cat/plugins?v -u 'admin:admin' --insecure

Mise à niveau d’Elasticsearch

Voir Mise à niveau d’Elasticsearch pour obtenir des instructions complètes sur la sauvegarde de vos données, la détection des problèmes de migration potentiels et le test des mises à niveau avant le déploiement en production. Selon votre version actuelle d’Elasticsearch, un redémarrage complet de la grappe peut être nécessaire ou non.

Elasticsearch requiert JDK 1.8 ou version ultérieure. Voir Installation du Java Software Development Kit pour vérifier quelle version de JDK est installée.

Ressources supplémentaires

Voir Elasticsearch ou OpenSearch la documentation.

recommendation-more-help
0f8e7db5-0e9c-4002-a5b8-a0088077d995