Elasticsearch

Vorwort

Elasticsearch dient als Backend für die Erweiterte Suche von BlueSpice. Diese Dokumentation führt Sie durch die Installation.

Für den Betrieb der Elasticsearch ist die Java Runtime Environment Voraussetzung. Sollten Sie diese noch nicht installiert haben so folgen Sie dem eben genannten Link.

Vorbereitung

Da die Java Runtime Environment (JRE) ein sehr aggressives Update-Verhalten besitzt und dies aufgrund diverser Umstände die Elasticsearch unbrauchbar macht führen Sie bitte diesen Workaround durch:

Öffnen Sie ein Windows-Explorer-Fenster und wechseln in den Installationspfad Ihrer JRE-Installation (standardmäßig "C:\Program Files\Java") (1). Dort finden Sie den Unterordner Ihrer aktuellen JRE-Version (2):

Analog zur Installationsdokumentation für die JRE beachten Sie bitte, dass die hier gezeigte Version 1.8.0_191 beispielhaft ist und in Ihrem Fall anders lauten kann.

Kopieren Sie diesen ganzen Ordner (2) nach C:\bluespice\bin (1):

Diese Dokumentation geht von der von uns empfohlenen Ordnerstruktur aus. Aus diesem Grund wird an dieser Stelle der Ordner C:\bluespice\bin verwendet. Haben Sie individuelle Wünsche, so müssen Sie diesen Pfad nach eigenem Verständnis anpassen.

Legen Sie im nächsten Schritt die benötigte Umgebungsvariable in Windows an

Geben Sie die Tastenkombination Windows + R ein.

Im folgenden Dialog tragen Sie "SystemPropertiesAdvanced.exe" ein (1) und bestätigen mit OK (2):

Klicken Sie auf "Umgebungsvariablen":

Klicken Sie auf "Neu...":

Legen Sie als Name der Variablen "JAVA_HOME" (1) fest, als Wert der Variablen geben Sie das Verzeichnis Ihrer JRE-Installation an, die Sie soeben nach C:\bluespice\bin kopiert haben (2). Hier können Sie sich die Arbeit durch Benutzung des "Verzeichnis durchsuchen" Buttons (3) erleichern. Klicken Sie anschließend auf "OK" (4):

Schließen Sie alle soeben geöffneten Fenster nacheinander wieder mit Klick auf "OK".

Download von Elasticsearch

BlueSpice ist derzeit genau auf die Version 6.3.1 von Elastic abgestimmt.

Bitte laden Sie diese direkt unter diesem Link von der offiziellen Webseite des Herstellers herunter.

Folgen Sie dabei den Download-Anweisungen Ihres Browsers.

Beachten Sie bitte, dass der Download auf Ihrem Windows Server mit Internet Explorer nur dann funktioniert, wenn Sie die Erweiterten Sicherheitseinstellungen für Internet Explorer im Servermanager entsprechend konfiguriert haben. Beachten Sie hierzu die technische Dokumentation von Microsoft.

Entpacken von Elasticsearch

Entpacken Sie den Inhalt des soeben heruntergeladene ZIP-Archivs (2) in den Ordner "C:\bluespice\bin\elasticsearch-6.3.1" (1):

Installation des Elasticsearch Dienstes

Wechseln Sie in das Verzeichnis "C:\bluespice\bin\elasticsearch-6.3.1\bin" (1) und führen auf eine freie Fläche des Explorer-Fensters einen Rechtsklick mit gedrückter Shift-Taste aus. Klicken Sie dann auf "Eingabeaufforderung hier öffnen" (2):

Führen Sie dort den Befehl "elasticsearch-service.bat install" aus und warten Sie, bis der Prozess abgeschlossen ist:

Elasticsearch Dienst konfigurieren und starten

Geben Sie die Tastenkombination Windows + R ein.

Im folgenden Dialog tragen Sie "services.msc" ein (1) und bestätigen mit "OK" (2):

Suchen Sie den Service "Elasticsearch 6.3.1" und öffnen diesen mit einem Doppelklick:

Wählen Sie als Starttyp "Automatisch" (1) und starten Sie den Dienst (2). Nachdem der Dienst gestartet ist schließen das Fenster mit "OK" (3):

Nächster Schritt

Haben Sie alle Schritte erfolgreich abgeschlossen können Sie die zuvor heruntergeladenen Datei "elasticsearch-6.3.1.zip" von Ihrer Festplatte löschen und zum nächsten Schritt "Git" weiter gehen.