Difference between revisions of "Setup:Installation Guide/System Preparation/Windows/Elasticsearch"
← Setup:Installation Guide/System Preparation/Windows/Elasticsearch
[quality revision] | [quality revision] |
(Tag: Visual edit) |
(Tag: 2017 source edit) |
Contents
Elasticsearch is a prerequisite for running Advanced Search. The steps listed here are optional and only required if you plan to use them in your BlueSpice installation. |
To run Elasticsearch, OpenJDK is required. If you have not installed it, install it now. |
Download Elasticsearch[edit | edit source]
BlueSpice is currently compatible with Elasticsearch 6.8.x as of version 6.8.21. Elasticsearch > 6.8.x is currently NOT supported!
The latest version can be found at this list. This results in the following direct download link: https://artifacts.elastic.co/downloads/elasticsearch/elasticsearch-<version number>.zip. For example, https://artifacts.elastic.co/downloads/elasticsearch/elasticsearch-6.8.21.zip.
Follow the download instructions of your browser.
Please note that the download on your Windows Server with Internet Explorer will only work if you have configured the Internet Explorer Advanced Security Settings in the Server Manager. Please refer to the technical documentation from Microsoft. |
In the following, Elasticsearch version 6.8.21 is used and is only an example of the latest version of the 6.8.x version, which you can download at the time of your installation. |
Unpacking Elasticsearch[edit | edit source]
Unpack the contents of the ZIP archive (2) just downloaded into the folder "C:\bluespice\bin\elasticsearch-6.8.21" (1):
zentriert|400x400px|Elasticsearch Installation 01
Installing the plugin ingest-attachment[edit | edit source]
Change to the directory "C:\bluespice\bin\elasticsearch-6.8.21\bin" (1) and right-click on a free area of the Explorer window with the Shift key pressed. Then click "Open Windows Powershell Here" (2):
Execute the command "elasticsearch-plugin.bat install ingest-attachment" (1) and after downloading the plugin, confirm the installation request with "y" (2):
If your server does not have an active internet connection, then download the plug-in ingest-attachment as zip archive and install it, as documented directly by the manufacturer. |
Installing the Elasticsearch service[edit | edit source]
Next, run the elasticsearch-service.bat install command and wait for the process to complete:
Configuring and starting the Elasticsearch service[edit | edit source]
Press the key combination Windows+R.
In the following dialog box, enter "services.msc" (1) und confirm with "OK" (2):
Search for the service "Elasticsearch 6.8.21" and open it with a double-click:
Select the startup type "Automatic" (1) and start the service (2). After the service is started, close the window with "OK" (3):
Next step[edit | edit source]
If you have completed all steps successfully, you can delete the previously downloaded file "elasticsearch-6.8.21.zip" from your hard disk and continue to the next step "Git".
{{DISPLAYTITLE:Elasticsearch on Windows}} __TOC__ {{Template:Optional|text=Elasticsearch is a prerequisite for running Advanced Search. The steps listed here are optional and only required if you plan to use them in your BlueSpice installation.}} {{Template:Hint|text=To run Elasticsearch, OpenJDK is required. If you have not installed it, [[Setup:Installation Guide/System Preparation/Windows/OpenJDK | install it now]].}} ==Download Elasticsearch== BlueSpice is currently compatible with Elasticsearch 6.8.x as of version 6.8.21. Elasticsearch > 6.8.x is currently '''NOT supported!''' The latest version can be found at [https://github.com/elastic/elasticsearch/releases this list]. This results in the following direct download link: <nowiki>https://artifacts.elastic.co/downloads/elasticsearch/elasticsearch-<version number>.zip</nowiki>. For example, https://artifacts.elastic.co/downloads/elasticsearch/elasticsearch-6.8.21.zip. Follow the download instructions of your browser. {{Template:Hint|text=Please note that the download on your Windows Server with Internet Explorer will only work if you have configured the Internet Explorer Advanced Security Settings in the Server Manager. Please refer to the technical documentation from Microsoft.}} {{Template:Hint|text=In the following, Elasticsearch version 6.8.21 is used and is only an example of the latest version of the 6.8.x version, which you can download at the time of your installation.}} ==Unpacking Elasticsearch== Unpack the contents of the ZIP archive (2) just downloaded into the folder "C:\bluespice\bin\elasticsearch-6.8.21" (1): [[FileDatei:Setup:es0Elasticsearch (1).png|centerzentriert|400x400px|Elasticsearch Installation 01]] ==Installing the plugin ingest-attachment== Change to the directory "C:\bluespice\bin\elasticsearch-6.8.21\bin" (1) and right-click on a free area of the Explorer window with the Shift key pressed. Then click "Open Windows Powershell Here" (2): [[File:Setup:es6.png|center|400x400px|Elasticsearch Installation 02]] Execute the command "elasticsearch-plugin.bat install ingest-attachment" (1) and after downloading the plugin, confirm the installation request with "y" (2): [[File:Setup:es1.png|center|400x400px|Elasticsearch Installation 03]] {{Template:Hint|text=If your server does not have an active internet connection, then [https://artifacts.elastic.co/downloads/elasticsearch-plugins/ingest-attachment/ingest-attachment-6.8.21.zip download the plug-in ingest-attachment as zip archive] and install it, as [https://www.elastic.co/guide/en/elasticsearch/plugins/current/plugin-management-custom-url.html documented directly by the manufacturer].}} ==Installing the Elasticsearch service== Next, run the elasticsearch-service.bat install command and wait for the process to complete: [[File:Setup:es2.png|center|400x400px|Elasticsearch Installation 07]] ==Configuring and starting the Elasticsearch service== Press the key combination Windows+R. In the following dialog box, enter "services.msc" (1) und confirm with "OK" (2): [[File:Setup:Elastic_Install_04.png|center|400px|Elasticsearch Installation 04]] Search for the service "Elasticsearch 6.8.21" and open it with a double-click: [[File:Setup:es3.png|center|400x400px|Elasticsearch Installation 05]] Select the startup type "Automatic" (1) and start the service (2). After the service is started, close the window with "OK" (3): [[File:Setup:es4.png|center|459x459px|Elasticsearch Installation 06]] ==Next step== If you have completed all steps successfully, you can delete the previously downloaded file "elasticsearch-6.8.21.zip" from your hard disk and continue to the next step "[[Setup: Installation Guide/System Preparation/Windows/Git |Git]]". [[en:{{FULLPAGENAME}}]] [[de:Setup:Installationsanleitung/Systemvorbereitung/Windows/Elasticsearch]]
Line 16: | Line 16: | ||
==Unpacking Elasticsearch== | ==Unpacking Elasticsearch== | ||
Unpack the contents of the ZIP archive (2) just downloaded into the folder "C:\bluespice\bin\elasticsearch-6.8.21" (1): | Unpack the contents of the ZIP archive (2) just downloaded into the folder "C:\bluespice\bin\elasticsearch-6.8.21" (1): | ||
− | [[ | + | [[Datei:Setup:Elasticsearch (1).png|zentriert|400x400px|Elasticsearch Installation 01]] |
==Installing the plugin ingest-attachment== | ==Installing the plugin ingest-attachment== |