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.
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
Pour configurer votre système afin d’utiliser Elasticsearch ou OpenSearch :
-
Connectez-vous à l’administrateur en tant qu’administrateur.
-
Cliquez sur Stores > Settings > Configuration > Catalog > Catalog > Catalog Search.
-
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. -
Cliquez sur Test Connection.
Exemple de réponse :
Poursuivez par :
- Configuration d’Apache pour votre moteur de recherche
- Configuration de nginx pour votre moteur de recherche
ou vous voyez :
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-none `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 :
-
Dans l’administrateur, cliquez sur System > Cache Management.
-
Cochez la case en regard de Page Cache.
-
Dans la liste Actions en haut à droite, cliquez sur Actualiser.
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 :
-
Connectez-vous à votre serveur Commerce en tant que propriétaire du système de fichiers ou passez à cet emplacement.
-
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
-
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.