DokumentationCommerceKonfigurationshandbuch

Konfiguration von Suchmaschinen

Last update: Wed Dec 18 2024 00:00:00 GMT+0000 (Coordinated Universal Time)
  • Themen:

Erstellt für:

  • Experte
  • Admin
  • Entwickler

In diesem Abschnitt werden die Mindesteinstellungen erläutert, die Sie auswählen müssen, um Elasticsearch oder OpenSearch mit lokalen Bereitstellungen von Adobe Commerce zu testen.

TIP
In den Versionen 2.4.4 und 2.4.3-p2 gelten alle Felder mit der Beschriftung Elasticsearch auch für OpenSearch.
Mit der Einführung der Unterstützung für Elasticsearch 8.x in Version 2.4.6 wurden neue Bezeichnungen erstellt, um zwischen Elasticsearch- und OpenSearch-Konfigurationen zu unterscheiden.

Weitere Informationen zum Konfigurieren Ihrer Suchmaschine finden Sie im Benutzerhandbuch.

Konfigurieren der Suchmaschine über den Administrator

TIP
Anleitungen für die Aktualisierung auf eine neue Suchmaschinenversion finden Sie unter Voraussetzungen für die Aktualisierung.

So konfigurieren Sie Ihr System für die Verwendung von Elasticsearch oder OpenSearch:

  1. Melden Sie sich bei Admin als Admin an.

  2. Klicken Sie auf Stores > Settings > Configuration > Catalog > Catalog > Catalog Search.

  3. 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. Die Standardeinstellungen sollten funktionieren, es sei denn, Sie haben die Server-Einstellungen Ihrer Suchmaschine geändert. Springen Sie zum nächsten Schritt.

    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 vollqualifizierten Hostnamen oder die IP-Adresse des Geräts ein, auf dem Elasticsearch oder OpenSearch ausgeführt wird.
    Adobe Commerce auf Cloud-Infrastruktur: Nutzen Sie diesen Wert aus Ihrem Integrationssystem.
    Server Port Geben Sie den Webserver-Proxy-Port ein. Der Standardwert ist 9200
    Adobe Commerce in der Cloud-Infrastruktur: Sie erhalten diesen Wert von Ihrem Integrationssystem.
    Index Prefix Geben Sie das Suchmaschinenindex-Präfix ein. Wenn Sie eine Instanz für mehr als eine Commerce-Installation (Staging- und Produktionsumgebungen) verwenden, müssen Sie für jede Installation ein eindeutiges Präfix angeben. Andernfalls können Sie das Standardprä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 einen Benutzernamen und ein Kennwort in die angegebenen Felder ein.
    Server Timeout Geben Sie die Zeit (in Sekunden) ein, die gewartet werden soll, wenn versucht wird, eine Verbindung zum Elasticsearch- oder OpenSearch-Server herzustellen.

  4. Klicken Sie auf Test Connection.

    Beispielantwort:

    Erfolg

    Weiter mit:

    Oder Sie sehen:

    fehlgeschlagen

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 Suchmaschinenhost. Beheben Sie Probleme mit der Netzwerkverbindung und testen Sie die Verbindung erneut.

  • Überprüfen Sie das Befehlsfenster, in dem Sie Elasticsearch oder OpenSearch gestartet haben, 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 UNIX-Firewall und SELinux beide deaktiviert sind, oder richten Sie Regeln ein, damit Ihre Suchmaschine und Commerce miteinander kommunizieren können.

  • Ü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 netstat -an | grep <listen-port>-Befehl, um zu überprüfen, ob der im Feld Server Port angegebene Port von einem anderen Prozess verwendet wird.

    Verwenden Sie beispielsweise den folgenden Befehl, um zu überprüfen, ob Ihre Suchmaschine auf ihrem Standard-Port ausgeführt wird:

    code language-bash 
    netstat -an | grep 9200

    Wenn es auf Port 9200 ausgeführt wird, wird es ähnlich wie folgt angezeigt:

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

Katalogsuche neu indizieren und den vollständigen Seitencache aktualisieren

Nachdem Sie die Suchmaschinenkonfiguration geändert haben, müssen Sie den Katalogsuchindex neu indizieren und den vollständigen Seitencache mithilfe von Admin oder der Befehlszeile aktualisieren.

So aktualisieren Sie den Cache mit der Admin:

  1. Klicken Sie im Admin auf System > Cache Management.

  2. Aktivieren Sie das Kontrollkästchen neben Page Cache.

  3. Klicken Sie in der Actions oben rechts auf Aktualisieren.

    Cache-Verwaltung

So bereinigen Sie den Cache mithilfe der Befehlszeile: bin/magento cache:clean

So indizieren Sie eine Neuindizierung über die Befehlszeile:

  1. Melden Sie sich bei Ihrem Commerce-Server als oder wechseln Sie zum Dateisystembesitzer.

  2. 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_fulltext

    Geben Sie den folgenden Befehl ein, um alle Indexer neu zu indizieren:

    code language-bash 
    bin/magento indexer:reindex

  3. 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 Nutzung Ihrer Suchmaschine beginnen.
recommendation-more-help
386822bd-e32c-40a8-81c2-ed90ad1e198c