Configuration du moteur de recherche
Cette section décrit les paramètres minimaux que vous devez choisir pour tester Elasticsearch ou OpenSearch avec des 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’Administration
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. À moins que vous n’ayez modifié les paramètres du serveur de votre moteur de recherche, les valeurs par défaut doivent fonctionner. 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 la machine exécutant Elasticsearch ou OpenSearch.
Adobe Commerce sur les infrastructures cloud : obtenez cette valeur de votre système d’intégration.Server Port Entrez le port proxy du serveur web. La valeur par défaut est de 9200
Adobe Commerce sur l’infrastructure cloud : obtenez cette valeur à partir de votre système d’intégration.Index Prefix Saisissez le préfixe d’index du moteur de recherche. Si vous utilisez une seule instance pour plusieurs installations de 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 par défaut magento2. Enable HTTP Auth Cliquez sur Yes uniquement si vous avez activé l’authentification pour le serveur de votre 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 la durée d’attente (en secondes) lors de la tentative de connexion au serveur Elasticsearch ou OpenSearch. -
Cliquez sur Test Connection.
Exemple de réponse :
Continuer avec :
- 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 hôte différent de Commerce, connectez-vous au serveur Commerce et envoyez une requête 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 à la recherche de traces de pile et d’exceptions. Vous devez résoudre ces problèmes avant de continuer. Veillez en particulier à démarrer votre moteur de recherche en tant qu’utilisateur disposant des privilèges
root. -
Assurez-vous que le pare-feu UNIX et SELinux sont tous deux 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 l’adresse IP du serveur à la place.
-
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 9200S’il s’exécute sur le port 9200, il se présente comme suit :
code language-none `tcp 0 0 :::9200 :::- LISTEN`
Réindexez la recherche catalogue et actualisez le cache de page complet.
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 l’Administration ou de la ligne de commande.
Pour actualiser le cache à l’aide de l’Administration :
-
Dans Admin, 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 effectuer la réindexation à l’aide de la ligne de commande :
-
Connectez-vous à votre serveur Commerce en tant que propriétaire du système de fichiers ou passez à ce dernier.
-
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_fulltextSaisissez la commande suivante pour réindexer tous les indexeurs :
code language-bash bin/magento indexer:reindex -
Patientez jusqu’à la fin de la réindexation.
note info INFO Contrairement au cache, les indexeurs sont mis à jour par une tâche cron. Assurez-vous que cron est activé avant de commencer à utiliser votre moteur de recherche.