Installieren und Konfigurieren von Elastic Search unter Windows

7. Führen Sie elasticsearch.bat aus

   Wichtiger Hinweis: Elasticsearch konfiguriert das selbstsignierte SSL-Zertifikat während der Installation selbst so, dass es das HTTPS-Protokoll verwenden kann.

8. Während der Installation sollte so etwas erscheinen:

   

   Kopieren Sie den Inhalt der CMD-Fenster in einen Editor und speichern Sie ihn für die zukünftige Verwendung. Diese Ausgabe enthält das Kennwort für den Superuser und das Registrierungstoken , das beim Herstellen einer Verbindung mit Kibana verwendet wird.

9. Schließen Sie diese Eingabeaufforderung vorerst nicht, da sie den Elastic Search-Dienst ausführt. Wir werden Elastic Search as a Service installieren, nachdem wir Elastic Search mit KanBo verbunden haben.

2. Überprüfen, ob Elastic Search ausgeführt wird

Überprüfen Sie, ob Sie auf Elastic zugreifen können, indem Sie die folgende URL im Browser auf Ihrer VM-https://localhost:9200 öffnen. Es wird einen Fehler über ein ungültiges Zertifikat geben, aber Sie müssen sich darüber erst einmal keine Sorgen machen, da wir es später beheben werden.

3. Verbinden von Elastic Search mit Kibana

Kibana ist das visuelle Frontend für die elastische Suche. Im Moment benötigen wir Kibana, um die Suche einzurichten und einen Benutzer zu konfigurieren, der verwendet wird , um KanBo mit Elastic Search zu verbinden.

1. Öffnen Sie ein neues Eingabeaufforderungsfenster (ein zweites) und gehen Sie zum Ordner /bin von Kibana.

2. Führen Sie kibana.bat aus.
3. Nachdem diese Meldung angezeigt wird:

4. Wechseln Sie zu der URL, die in der Eingabeaufforderung angegeben ist, indem Sie Ihren Browser auf Ihrer VM verwenden.
5. Fügen Sie das Registrierungstoken aus Ihrem Notizblock in das Textfeld ein und klicken Sie auf "Elastic konfigurieren".

4. Erstellen eines Benutzers für KanBo

Inzwischen sollten Sie zwei Eingabeaufforderungsfenster geöffnet haben, eines, auf dem Kibana ausgeführt wird, und eines, auf dem Elastic Search ausgeführt wird. Bitte schließen Sie diese Eingabeaufforderungsfenster nicht während der Benutzerkonfiguration - Sie werden sie später benötigen.

Öffnen Sie Kibana in Ihrem Browser, indem Sie die URL aus "Connecting Elastic Search with Kibana" Schritt 3 eingeben und sich mit dem Benutzernamen "elastic" anmelden und das Passwort des in Elastic integrierten Superusers aus "Elastic Search und die Elastic Kibana-Komponente installieren" verwenden.

5. Wenn dieses Fenster erscheint, klicken Sie auf "Auf eigene Faust erkunden".
6. Suchen Sie in der Suchleiste oben auf der Website nach "Rollen" und wählen Sie es mit "Gehe zu" aus .

7. Klicken Sie auf "Rolle erstellen".

8. Geben Sie unter Rollenname "admin-KanBoSearch" ein.

9. Konfigurieren Sie diese Optionen dann auf die gleiche Weise, wie sie im Screenshot konfiguriert sind.
   Cluster-Berechtigungen: Verwalten manage_security
   Ausführen als-Berechtigungen: *
   Indizes: kanbosearch.*
   Privilegien: alle.
10. Nachdem Sie eine Rolle erstellt haben, suchen Sie in der oberen Leiste nach "Benutzer" und wählen Sie "Gehe zu".

11. Und erstellen Sie einen Benutzer auf diese Weise:

Es empfiehlt sich, denselben Benutzernamen wie den Rollennamen zu verwenden. Das Passwort wird nicht generiert und von Ihnen festgelegt.

12. Wählen Sie im Bereich "Rollen" die im vorherigen Schritt erstellte Rolle aus: "admin-KanBoSearch".
13. Speichern Sie von hier aus den Benutzernamen und das Passwort für später.

5. Ausführen von Elastic Search als Service

Nach der Konfiguration des Benutzers können wir die beiden Dienste: Kibana und dann Elastic Search , die in unseren 2 geöffneten Befehlszeilenfenstern ausgeführt werden, sicher stoppen, indem wir die Kombination von Strg + C in den Eingabeaufforderungsfenstern verwenden. Bitte beachten Sie, dass Kibana vor der Elastic Search gestoppt werden muss, um Probleme zu vermeiden.

Geben Sie dann Y ein und bestätigen Sie mit der Eingabetaste

Dies sollte dazu führen, dass die Eingabeaufforderungsfenster wie folgt aussehen.

Nachdem Sie beide Batchaufträge gestoppt haben:

1. Wechseln Sie in der Eingabeaufforderung zum Ordner Elastic Search /bin und führen Sie elasticsearch-service.bat install aus.

Sie verfügen nun über einen Elastic Search Service.

2. Um sicherzustellen, dass der Elastic Search-Dienst bei jedem Start des Computers ausgeführt wird, gehen Sie zu services.

Suchen Sie den Elastic Search-Dienst, klicken Sie mit der rechten Maustaste darauf und gehen Sie zu "Eigenschaften"...

... und wählen Sie den Typ Automatischer Start aus.

3. Wenden Sie die Einstellung an und starten Sie Ihren Elastic Search Service.

6. Ändern des Windows

Es empfiehlt sich, den Dienstnamen des Windows in einen klareren Namen zu ändern. So ändern Sie den Namen unseres Elastic Search Windows :

1. Klicken Sie mit der rechten Maustaste auf den Elastic Search-Service und gehen Sie zu Eigenschaften.

2. Kopieren Sie den Anzeigenamen

3. Öffnen Sie ein cmd-Fenster, geben Sie sc config "COPIED SERVICE NAME" displayname= "KanBo Elastic Search" ein und führen Sie den Befehl aus. Beispiel: sc config "elasticsearch-service-x64" displayname= "KanBo Elastic Search"

4. Ändern Sie nun die Beschreibung des Dienstes, indem Sie sc description "COPIED SERVICE NAME" "DESCRIPTION" ausführen. Beispiel: sc description "elasticsearch-service-x64" "Elasticsearch used in KanBo"

5. Gehen Sie zurück zu Dienste und klicken Sie auf die Schaltfläche Aktualisieren.

6. Jetzt werden Ihr Dienstname und Ihre Beschreibung aktualisiert.

7. Verbinden von KanBo mit Elastic Search

Öffnen Sie die appsettings.json Ihrer KanBo und fügen Sie diesen Code zum Abschnitt "Plugins" hinzu:

{
    "type": "elastic",
    "tenant": "kanbosearch",
	"connection": {
		"url": "https://ELASTIC-URL:9200",
		"login": "admin-KanBoSearch",
		"password": "USER-PASSWORD"
	}
   }

Ersetzen Sie die ELASTIC-URL durch die Adresse Ihrer Elastic Search-Maschine und ändern Sie USER-PASSWORD in das Passwort, das Sie für den Admin-KanBoSearch-Benutzer erstellt haben. Stellen Sie sicher, dass Sie https:// und :9200 in der URL Ihres Computers lassen.
Speichern Sie nach dem Einfügen des Codes die Änderungen, und starten Sie die KanBo neu. Ein Neustart der KanBo App ist erforderlich, damit KanBo in der geänderten Konfiguration geladen werden kann.
Gehen Sie zu KanBo Setup, zeigen Sie das erweiterte Setup an und klicken Sie auf Elastic.

Wenn die Option "Elastisch" nicht angezeigt wird, starten Sie das KanBo neu und versuchen Sie es erneut.

Indizieren Sie alle Ihre Daten, indem Sie im Abschnitt "Datenimport" die Option "Alle" auswählen. Aktivieren Sie das Kontrollkästchen "Reinigen" und klicken Sie auf "Ausführen".

Warten Sie, bis Elastic alles indiziert hat.

Ihr KanBo nutzt jetzt Elastic Search!

Optionale Schritte

Testen Sie die KanBo , indem Sie zu KanBo gehen, einen Space und eine Karte darin erstellen, dann auf das Zoom-Glas-Symbol in der rechten oberen Ecke klicken und nach dem Namen der Karte suchen. Wenn Sie Spaces und Karten haben, können Sie auch danach suchen, um zu testen, ob die Suche ordnungsgemäß funktioniert.

Fehlerbehebung

Verifizierung in Kibana erforderlich

Sie konfigurieren Kibana und dieses Popup wird angezeigt

Das bedeutet, dass Sie die Adresse ohne den ?code=123456-Teil geöffnet haben. Zur Überprüfung: Sie können den Code von der URL eingeben, die im 3^. Schritt des Kibana-Verbindungsprozesses vorhanden ist.

Fehler beim Registrieren der elastischen Verbindung: Fehler beim Elastic Ping.

Dieser Fehler tritt immer dann auf, wenn eine der Eingaben im Abschnitt "Verbindung" falsch ist (nicht nur die URL) oder wenn KanBo keine Verbindung zur angegebenen IP herstellen kann. Bitte stellen Sie sicher, dass:

1. Die URL beginnt mit https://, die Maschinen-IP ist korrekt und wird am Ende von ":9200" gefolgt .
2. Der Benutzername und das Passwort sind korrekt
3. Der Mandantenname enthält nicht den ".*"-Teil, der in den Indizes einer Rolle vorhanden war, die wir in Kibana erstellt haben
4. Falls der Elastic Search-Service nicht auf demselben Computer wie KanBo gehostet wird, stellen Sie sicher, dass diese URL vom KanBo aus zugänglich ist.

Offene Ports innerhalb des Geräts

Es ist möglich, dass der Port 9200 von der Firewall innerhalb des virtuellen Computers blockiert wird (und wenn Sie einen virtuellen Computer in Azure gehostet haben, wurde der Port möglicherweise auch nicht in der Netzwerkeinstellung des virtuellen Computers aktiviert. Weitere Informationen finden Sie im Artikel zum Vorbereiten des virtuellen Computers in Azure). So öffnen Sie Ports auf einer Windows :

1. Wechseln Windows erweiterten Einstellungen der Windows Defender-Firewall > .

2. Klicken Sie auf "Eingehende Regeln" und "Neue Regel".

3. Wählen Sie "Port" > Als nächstes > wählen Sie "TCP" und geben Sie unter "Spezifische lokale Ports" "9200" ein.

4. Lassen Sie die Verbindung zu.

5. Kreuzen Sie jedes Kästchen an und klicken Sie auf "Weiter".

6. Geben Sie den Namen der Regel ein und klicken Sie auf "Fertigstellen".

Überprüfen Sie, ob der Benutzer in Kibana ordnungsgemäß konfiguriert ist

1. Wenn diese Option gestoppt ist, starten Sie Kibana und melden Sie sich an.
2. Gehen Sie zu Rollen und klicken Sie auf die von Ihnen erstellte Rolle.

3. Stellen Sie sicher, dass die Clusterberechtigungen, Die Berechtigungen "Ausführen als", "Indizes" und "Berechtigungen" gemäß den vorherigen Schritten konfiguriert sind. Achten Sie auch darauf , dass Indizes mit ".*" enden.
4. Gehen Sie zu Benutzer und klicken Sie auf den Benutzer, den Sie erstellt haben.
5. Stellen Sie sicher, dass diesem Benutzer die richtige Rolle zugewiesen ist.
6. Wenn Sie sich über das Passwort nicht sicher sind, können Sie es zurücksetzen, indem Sie auf "Passwort ändern" klicken .

Herstellen einer Verbindung mit Elastic Search, die auf einem virtuellen Hyper-V-Computer gehostet wird

Wenn Sie sich entschieden haben, Ihre virtuelle Elastic Search-Maschine auf Hyper-V zu hosten, muss Ihre Hostmaschine den Datenverkehr an den Port der Maschine an den Port einer VM umleiten.

1. Öffnen Sie Routing und RAS.
2. Doppelklicken Sie auf "Ethernet".

3. Gehen Sie zu "Dienste und Häfen" und klicken Sie auf "Hinzufügen".

4. Fügen Sie eine Beschreibung hinzu (z. B. "ElasticSearch"), lassen Sie "Auf dieser Schnittstelle" und das Protokoll "TCP" ausgewählt. Geben Sie unter Eingehender Port den Port ein, den Sie für die Verbindung mit Elastic Search verwenden möchten, die auf Ihrer VM gehostet wird. Geben Sie unter private Adresse die IP-Adresse Ihrer VM ein, und geben Sie unter ausgehender Port 9200 (den Port, den Elastic Search verwendet) ein und klicken Sie auf OK.

5. Nachdem dies erledigt ist, klicken Sie auf "Übernehmen" und jetzt sollten Sie in der Lage sein, eine Verbindung zu Elastic Search herzustellen, die auf Ihrer virtuellen Hyper-V-Maschine gehostet wird.