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 in der 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.
-
Klicks Stores > Settings > Configuration > Catalog > Catalog > Catalog Search.
-
Aus dem Search Engine auswählen, wählen Sie 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 zur Cloud-Infrastruktur: Nutzen Sie diesen Wert aus Ihrem Integrationssystem.Server Port Geben Sie den Proxyanschluss des Webservers ein. Der Standardwert ist 9200.
Adobe Commerce zur Cloud-Infrastruktur: Nutzen Sie diesen Wert aus Ihrem Integrationssystem.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 Klicks Yes nur dann, 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. -
Klicks 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. -
Stellen Sie sicher, dass UNIX-Firewall und SELinux deaktiviert sind oder Regeln einrichten, mit denen Ihre Suchmaschine und Commerce miteinander kommunizieren können.
-
Überprüfen Sie den Wert der Server Hostname -Feld. Stellen Sie sicher, dass der Server verfügbar ist. Sie können stattdessen die IP-Adresse des Servers ausprobieren.
-
Verwenden Sie die
netstat -an | grep <listen-port>-Befehl, um zu überprüfen, ob der im Server Port 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-terminal `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.
-
Aus dem Actions Liste oben rechts, klicken Sie 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 an oder wechseln Sie zu dem Dateisysteminhaber.
-
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 cron ist aktiviert bevor Sie Ihre Suchmaschine verwenden.