|
|
Linia 1: |
Linia 1: |
− | ''Elasticsearch'' to rozproszony silnik wyszukiwania oraz analizy danych. Niniejszy poradnik przedstawia podstawową konfigurację niezbędną do momentu uruchomienia aplikacji.
| + | [hide] |
− | | |
− | === Wstępna konfiguracja ===
| |
− | Przed przystąpieniem do dalszych kroków należy:
| |
− | * [[rezerwacja portów|Zarezerwować dwa porty]], pierwszy do udostępnienia API poprzez HTTP, drugi do komunikacji między węzłami.
| |
− | * Odblokować [[Binexec]].
| |
− | | |
− | === Instalacja ===
| |
− | Opis instalacji może różnić się w zależności od wersji aplikacji. Pobranie i rozpakowanie paczki wybranej wersji oprogramowania (do zmiany pod X):
| |
− | <pre>
| |
− | wget https://artifacts.elastic.co/downloads/elasticsearch/elasticsearch-X.tar.gz
| |
− | tar -xvf elasticsearch-X.tar.gz
| |
− | </pre>
| |
− | | |
− | Wskazanie w konfiguracji uprzednio zarezerwowanych portów, dla przykładu 9301 oraz 9201.
| |
− | <syntaxhighlight lang="bash">echo "transport.tcp.port: 9301" >> ~/elasticsearch-X/config/elasticsearch.yml</syntaxhighlight>
| |
− | | |
− | <syntaxhighlight lang="bash">echo "http.port: 9201" >> ~/elasticsearch-X/config/elasticsearch.yml</syntaxhighlight>
| |
− | | |
− | <syntaxhighlight lang="bash">echo "network.host: localhost" >> ~/elasticsearch-X/config/elasticsearch.yml</syntaxhighlight>
| |
− | | |
− | Aby móc korzystać z binarek bez podawania do nich pełnej ścieżki należy zmodyfikować .bash_profile poleceniem:
| |
− | | |
− | <syntaxhighlight lang="bash">echo 'export PATH=$HOME/elasticsearch-X/bin/:$PATH' >> $HOME/.bash_profile && source $HOME/.bash_profile</syntaxhighlight>
| |
− | przy założeniu, że paczka elasticsearch-X.tar.gz została rozpakowana bezpośrednio w katalogu domowym.
| |
− | | |
− | === Uruchamianie ===
| |
− | Aby uruchomić aplikację jednorazowo należy wydać polecenie:
| |
− | <code>
| |
− | elasticsearch
| |
− | </code>
| |
− | | |
− | Można również uruchomić aplikację w screen aby działała również po zamknięciu okna klienta SSH:
| |
− | | |
− | <code>screen elasticsearch</code>
| |
− | | |
− | Lub wykorzystać [[Cron]] by uruchomić usługę automatycznie po każdym restarcie serwera.
| |
− | | |
− | === Autoryzacja ===
| |
− | Instalacja mechanizmu autoryzacji X-Pack
| |
− | | |
− | <syntaxhighlight lang="bash">
| |
− | elasticsearch-plugin install https://download.elastic.co/elasticsearch/release/org/elasticsearch/plugin/license/2.4.6/license-2.4.6.zip
| |
− | </syntaxhighlight>
| |
− | | |
− | Potwierdzić pytania przy instalacji pluginu.
| |
− | | |
− | Wyłączyć Machine Learning, który jest niewspierany na FreeBSD:
| |
− | <syntaxhighlight lang="bash">echo "xpack.ml.enabled: false" >> ~/elasticsearch-X/config/elasticsearch.yml</syntaxhighlight>
| |
− | | |
− | Teraz należy uruchomić elasticsearch.
| |
− | | |
− | By zmienić domyślne hasło, które brzmi
| |
− | <code>changeme</code>
| |
− | należy wykonać polecenie:
| |
− | | |
− | <syntaxhighlight lang="bash">
| |
− | curl -XPUT -u elastic 'localhost:9201/_xpack/security/user/elastic/_password' -H "Content-Type: application/json" -d '{
| |
− | "password" : "miejscenahasło"
| |
− | }'
| |
− | </syntaxhighlight>
| |
− | | |
− | gdzie port podany po localhost to numer wcześniej wskazanego portu http.port.
| |
− | | |
− | Zostaniemy zapytani o dotychczasowe hasło, po jego wprowadzeniu zostanie zatwierdzone nowe hasło wysłane w
| |
− | komunikacie w formacie json.
| |
− | | |
− | W celu wyłączenia domyślnego hasła dla standardowych użytkowników X-pack należy w <code>elasticsearch.yaml</code> dodać linijkę <code>xpack.security.authc.accept_default_password: false</code> poleceniem:
| |
− | | |
− | <syntaxhighlight lang="bash">echo "xpack.security.authc.accept_default_password: false" >> ~/elasticsearch-X/config/elasticsearch.yml</syntaxhighlight>
| |
− | | |
− | Więcej informacji znajduje się w [https://www.elastic.co/guide/en/x-pack/current/xpack-security.html oficjalnej dokumentacji] projetktu Elasticsearch.
| |
− | | |
− | === Odnośniki zewnętrzne ===
| |
− | * [https://www.elastic.co/products/elasticsearch Strona projektu Elasticsearch]
| |
− | | |
− | [[Kategoria:Poradniki]]
| |