Configuration du moteur de recherche

Cette section décrit les paramètres minimaux que vous devez choisir pour tester Elasticsearch ou OpenSearch avec les déploiements sur site d’Adobe Commerce.

TIP
Dans les versions 2.4.4 et 2.4.3-p2, tous les champs intitulés Elasticsearch s’appliquent également à OpenSearch.
Lorsque la prise en charge d’Elasticsearch 8.x a été introduite dans la version 2.4.6, de nouveaux libellés ont été créés pour faire la distinction entre les configurations Elasticsearch et OpenSearch.

Pour plus d’informations sur la configuration de votre moteur de recherche, consultez le Guide de l’utilisateur.

Configuration de votre moteur de recherche à partir de l’administrateur

TIP
Pour obtenir des instructions sur la mise à niveau vers une nouvelle version de moteur de recherche, reportez-vous à la section Conditions préalables à la mise à niveau.

Pour configurer votre système afin d’utiliser Elasticsearch ou OpenSearch :

  1. Connectez-vous à l’administrateur en tant qu’administrateur.

  2. Cliquez sur Stores > Settings > Configuration > Catalog > Catalog > Catalog Search.

  3. Dans la liste Search Engine, sélectionnez la version correspondante de votre moteur de recherche.

    Le tableau suivant répertorie les options requises pour configurer et tester la connexion à Commerce. Les valeurs par défaut doivent fonctionner, sauf si vous avez modifié les paramètres du serveur de votre moteur de recherche. Passez à l’étape suivante.

    table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 5-row-2
    Option Description
    Server Hostname Saisissez le nom d’hôte complet ou l’adresse IP de l’ordinateur exécutant l’Elasticsearch ou OpenSearch.
    Adobe Commerce sur l’infrastructure cloud : tirez cette valeur de votre système d’intégration.
    Server Port Saisissez le port proxy du serveur web. La valeur par défaut est 9200
    Adobe Commerce sur l’infrastructure cloud : récupérez cette valeur de votre système d’intégration.
    Index Prefix Saisissez le préfixe d’index du moteur de recherche. Si vous utilisez une instance unique pour plusieurs installations Commerce (environnements d’évaluation et de production), vous devez spécifier un préfixe unique pour chaque installation. Sinon, vous pouvez utiliser le préfixe magento2 par défaut.
    Enable HTTP Auth Cliquez sur Yes uniquement si vous avez activé l’authentification pour votre serveur de moteur de recherche. Si tel est le cas, indiquez un nom d’utilisateur et un mot de passe dans les champs fournis.
    Server Timeout Saisissez le temps d’attente (en secondes) lors de la tentative d’établissement d’une connexion au serveur Elasticsearch ou OpenSearch.
  4. Cliquez sur Test Connection.

    Exemple de réponse :

    success

    Poursuivez par :

    ou vous voyez :

    failed

Si tel est le cas, essayez les méthodes suivantes :

  • Vérifiez que le serveur du moteur de recherche est en cours d’exécution.

  • Si le serveur se trouve sur un autre hôte que Commerce, connectez-vous au serveur Commerce et envoyez un ping à l’hôte du moteur de recherche. Résolvez les problèmes de connectivité réseau et testez à nouveau la connexion.

  • Examinez la fenêtre de commande dans laquelle vous avez démarré Elasticsearch ou OpenSearch pour rechercher des arborescences et des arborescences de pile. Vous devez résoudre ceux-là avant de continuer. En particulier, assurez-vous que vous avez démarré votre moteur de recherche en tant qu’utilisateur disposant des privilèges root.

  • Assurez-vous que le pare-feu UNIX et SELinux sont désactivés ou configurez des règles pour permettre à votre moteur de recherche et à Commerce de communiquer entre eux.

  • Vérifiez la valeur du champ Server Hostname. Vérifiez que le serveur est disponible. Vous pouvez essayer plutôt l’adresse IP du serveur.

  • Utilisez la commande netstat -an | grep <listen-port> pour vérifier que le port spécifié dans le champ Server Port n’est pas utilisé par un autre processus.

    Par exemple, pour voir si votre moteur de recherche s’exécute sur son port par défaut, utilisez la commande suivante :

    code language-bash
    netstat -an | grep 9200
    

    S’il s’exécute sur le port 9200, il s’affiche comme suit :

    code language-terminal
    `tcp        0      0 :::9200            :::-         LISTEN`
    

Réindexer la recherche de catalogue et actualiser le cache de la page entière

Après avoir modifié la configuration du moteur de recherche, vous devez réindexer l’index de recherche du catalogue et actualiser le cache de page complet à l’aide de la ligne de commande ou de l’administrateur.

Pour actualiser le cache à l’aide de l’administrateur :

  1. Dans l’administrateur, cliquez sur System > Cache Management.

  2. Cochez la case en regard de Page Cache.

  3. Dans la liste Actions en haut à droite, cliquez sur Actualiser.

    Gestion du cache

Pour nettoyer le cache à l’aide de la ligne de commande : bin/magento cache:clean

Pour réindexer à l’aide de la ligne de commande :

  1. Connectez-vous à votre serveur Commerce en tant que propriétaire du système de fichiers ou passez à cet emplacement.

  2. Saisissez l’une des commandes suivantes :

    Saisissez la commande suivante pour réindexer uniquement l’index de recherche de catalogue :

    code language-bash
    bin/magento indexer:reindex catalogsearch_fulltext
    

    Saisissez la commande suivante pour réindexer tous les indexeurs :

    code language-bash
    bin/magento indexer:reindex
    
  3. Attendez que la réindexation soit terminée.

    note info
    INFO
    Contrairement au cache, les indexeurs sont mis à jour par une tâche cron. Vérifiez que cron est activé avant de commencer à utiliser votre moteur de recherche.
recommendation-more-help
386822bd-e32c-40a8-81c2-ed90ad1e198c