Suchmaschinenkonfiguration
In diesem Abschnitt werden die Mindesteinstellungen erläutert, die Sie zum Testen von Elasticsearch oder OpenSearch mit lokalen Implementierungen von Adobe Commerce auswählen müssen.
Als die Unterstützung für Elasticsearch 8.x in Version 2.4.6 eingeführt wurde, wurden neue Bezeichnungen erstellt, um zwischen Elasticsearch- und OpenSearch-Konfigurationen zu unterscheiden.
Weitere Informationen zum Konfigurieren der Suchmaschine finden Sie im Benutzerhandbuch.
Konfigurieren der Suchmaschine über den Administrator
So konfigurieren Sie Ihr System für die Verwendung von Elasticsearch oder OpenSearch:
-
Melden Sie sich bei Admin als Administrator an.
-
Klicken Sie auf Stores > Settings > Configuration > Catalog > Catalog > Catalog Search.
-
Wählen Sie in der Liste Search Engine die entsprechende Version Ihrer Suchmaschine aus.
In der folgenden Tabelle sind die erforderlichen Optionen zum Konfigurieren und Testen der Verbindung mit Commerce aufgeführt. Sofern Sie die Servereinstellungen Ihrer Suchmaschine nicht geändert haben, sollten die Standardeinstellungen funktionieren. Fahren Sie mit dem nächsten Schritt fort.
table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 5-row-2 Option Beschreibung Server Hostname Geben Sie den vollständig qualifizierten Hostnamen oder die IP-Adresse des Computers ein, auf dem Elasticsearch oder OpenSearch ausgeführt wird.
Adobe Commerce in der Cloud-Infrastruktur: Rufen Sie diesen Wert von Ihrem Integrationssystem ab.Server Port Geben Sie den Proxyanschluss des Webservers ein. Der Standardwert ist 9200
Adobe Commerce in der Cloud-Infrastruktur: Rufen Sie diesen Wert aus Ihrem Integrationssystem ab.Index Prefix Geben Sie das Suchmaschinen-Indexpräfix ein. Wenn Sie eine Instanz für mehr als eine Commerce-Installation verwenden (Staging- und Produktionsumgebungen), müssen Sie für jede Installation ein eindeutiges Präfix angeben. Andernfalls können Sie das standardmäßige Präfix magento2 verwenden. Enable HTTP Auth Klicken Sie nur dann auf Yes , wenn Sie die Authentifizierung für Ihren Suchmaschinenserver aktiviert haben. Wenn ja, geben Sie in den angegebenen Feldern einen Benutzernamen und ein Kennwort ein. Server Timeout Geben Sie die Wartezeit (in Sekunden) ein, wenn Sie versuchen, eine Verbindung zum Elasticsearch- oder OpenSearch-Server herzustellen. -
Klicken Sie auf Test Connection.
Beispielantwort:
Fahren Sie fort mit:
oder Sie sehen:
Wenn ja, versuchen Sie Folgendes:
-
Stellen Sie sicher, dass der Suchmaschinenserver ausgeführt wird.
-
Wenn sich der Server auf einem anderen Host als Commerce befindet, melden Sie sich beim Commerce-Server an und pingen Sie den Suchmaschinen-Host. Beheben Sie Probleme mit der Netzwerkverbindung und testen Sie die Verbindung erneut.
-
Überprüfen Sie das Befehlsfenster, in dem Sie Elasticsearch gestartet haben, oder OpenSearch auf Stacktraces und Ausnahmen. Sie müssen diese auflösen, bevor Sie fortfahren. Stellen Sie insbesondere sicher, dass Sie Ihre Suchmaschine als Benutzer mit
root-Berechtigungen gestartet haben. -
Stellen Sie sicher, dass sowohl die UNIX-Firewall als auch SELinux deaktiviert sind, oder legen Sie Regeln fest, die es Ihrer Suchmaschine und Commerce ermöglichen, miteinander zu kommunizieren.
-
Überprüfen Sie den Wert des Felds Server Hostname . Stellen Sie sicher, dass der Server verfügbar ist. Sie können stattdessen die IP-Adresse des Servers ausprobieren.
-
Verwenden Sie den Befehl
netstat -an | grep <listen-port>, um sicherzustellen, dass der im Feld Server Port angegebene Anschluss nicht von einem anderen Prozess verwendet wird.Um beispielsweise zu sehen, ob Ihre Suchmaschine an ihrem Standardanschluss ausgeführt wird, verwenden Sie den folgenden Befehl:
code language-bash netstat -an | grep 9200Wenn sie auf Port 9200 ausgeführt wird, wird sie in etwa wie folgt angezeigt:
code language-none `tcp 0 0 :::9200 :::- LISTEN`
Neuindizieren der Katalogsuche und Aktualisieren des gesamten Seiten-Cache
Nachdem Sie die Suchmaschinenkonfiguration geändert haben, müssen Sie den Katalogsuchindex neu indizieren und den gesamten Seiten-Cache mit der Admin- oder Befehlszeile aktualisieren.
So aktualisieren Sie den Cache mit dem Admin:
-
Klicken Sie im Admin auf System > Cache Management.
-
Aktivieren Sie das Kontrollkästchen neben Page Cache.
-
Klicken Sie in der Liste Actions oben rechts auf Aktualisieren.
So leeren Sie den Cache mit der Befehlszeile: bin/magento cache:clean
So fügen Sie eine Neuindizierung mithilfe der Befehlszeile ein:
-
Melden Sie sich bei Ihrem Commerce-Server als Dateisysteminhaber an oder wechseln Sie zu ihm.
-
Geben Sie einen der folgenden Befehle ein:
Geben Sie den folgenden Befehl ein, um nur den Katalogsuchindex neu zu indizieren:
code language-bash bin/magento indexer:reindex catalogsearch_fulltextGeben Sie den folgenden Befehl ein, um alle Indexer neu zu indizieren:
code language-bash bin/magento indexer:reindex -
Warten Sie, bis die Neuindizierung abgeschlossen ist.
note info INFO Im Gegensatz zum Cache werden Indexer durch einen Cron-Auftrag aktualisiert. Stellen Sie sicher, dass cron aktiviert ist, bevor Sie mit der Verwendung Ihrer Suchmaschine beginnen.