Setup:Installationsanleitung/Systemvorbereitung/Windows/Elasticsearch: Unterschied zwischen den Versionen

[freigegebene Version][freigegebene Version]
(Markierung: 2017-Quelltext-Bearbeitung)
(Markierung: 2017-Quelltext-Bearbeitung)
 
Vorwort[Bearbeiten | Quelltext bearbeiten]


icon optional.png
Elasticsearch
dient als Backend für die Erweiterte Suche von BlueSpice. Diese Dokumentation führt Sie durch die Installation
ist Voraussetzung für den Betrieb der Erweiterten Suche. Die hier aufgeführten Schritte sind deshalb optional und nur erforderlich, wenn Sie diese in Ihrer BlueSpice-Installation verwenden möchten.


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

VorbereitungDownload von Elasticsearch[Bearbeiten | Quelltext bearbeiten]

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):

Elasticsearch Java 01

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):
Elasticsearch Java 02

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):

Umgebungsvariablen 02

Klicken Sie auf "Umgebungsvariablen":

Umgebungsvariablen 03

Klicken Sie auf "Neu...":

Umgebungsvariablen 04

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):

Umgebungsvariablen 05

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

Download von Elasticsearch[Bearbeiten | Quelltext bearbeiten]

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 herunterBlueSpice ist derzeit mit Elasticsearch 6.x ab Version 6.8.21 kompatibel. Elasticsearch > 6.8.x wird derzeit nicht unterstützt.

Die jeweils aktuelle Version können Sie dieser Liste entnehmen. Daraus ergibt sich folgender direkter Download-Link: https://artifacts.elastic.co/downloads/elasticsearch/elasticsearch-<Versionsnummer>.zip also bspw. https://artifacts.elastic.co/downloads/elasticsearch/elasticsearch-6.8.21.zip.

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.


Im Folgenden wird die Elasticsearch-Version 6.8.21 verwendet und dient nur beispielhaft für die jeweils aktuellste Version der Versionsreihe 6.x, die Sie zum Zeitpunkt Ihrer Installation herunterladen können.

Entpacken von Elasticsearch[Bearbeiten | Quelltext bearbeiten]

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

Elasticsearch Installation 01Elasticsearch Installation 01

Installation des Elasticsearch DienstesPlugins ingest-attachment[Bearbeiten | Quelltext bearbeiten]

Wechseln Sie in das Verzeichnis "C:\bluespice\bin\elasticsearch-6.38.121\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):

Elasticsearch Installation 02Elasticsearch Installation 02

Führen Sie dort den Befehl "elasticsearch-plugin.bat install ingest-attachment" aus (1) und bestätigen Sie nach dem Download des Plugins die Abfrage nach der folgenden Installation mit "y" (2):

Elasticsearch Installation 03


Sollte Ihr Server über keine aktive Internetverbindung verfügen, so downloaden Sie das Plugin ingest-attachment als zip-Archiv und installieren es, wie direkt beim Hersteller dokumentiert.

Installation des Elasticsearch Dienstes[Bearbeiten | Quelltext bearbeiten]

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

Elasticsearch Installation 03Elasticsearch Installation 07

Elasticsearch Dienst konfigurieren und starten[Bearbeiten | Quelltext bearbeiten]

Geben Sie die Tastenkombination Windows + R ein.

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

Elasticsearch Installation 04Elasticsearch Installation 04

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

Elasticsearch Installation 05Elasticsearch Installation 05

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):

Elasticsearch Installation 06Elasticsearch Installation 06

Nächster Schritt[Bearbeiten | Quelltext bearbeiten]

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


Anhänge

Diskussionen