/getIntoElasticsearch

Elasticsearch self notes, my 'petit' reference ;)

getIntoElasticsearch

Installation

French version (English version is comming soon)

ElasticSearch est un projet open source développé en Java sous licence Apache2. Le projet a été présenté par son créateur, Shay Banon, comme le successeur du framework Compass (un framework de mapping objet/moteur de recherche partageant des similitudes avec Hibernate Search).

La première version a été mise à disposition du public en février 2010. Depuis, le projet tient un rythme soutenu de releases à raison d'une version tous les un ou deux mois.

Guide elasticsearch

Installation Elasticseach v 6.7.0

La configuration de mon système:

OS RAM Disque
Linux Ubuntu 18.04.1 LTS 2.5 Go 21.0 Go
  1. Vérifier la versions de Java

1

Si vous avez pas Java installé sur votre system, vous pouvez l'installer par la commande

sudo apt update
sudo apt install openjdk-8-jdk openjdk-8-jre
  1. Télecharger elasticsearch v6.7.0 (pour java 8) lien: https://artifacts.elastic.co/downloads/elasticsearch/elasticsearch-6.7.0.tar.gz

1

Si vous possedez une autre version de Java, vous devez installez la vesrion elasticsearch compatible:

  1. Décompresser le fichier tar.gz

1

  1. Ouvrire le fichier de coiguration/conig/elasticseach.yml avec le mode Root (administrateur)

1

  1. Ajouter la coniguration au fichier de coiguration /conig/elasticseach.yml

conf:

cluster.name: < nom du cluster pour l’ensemble des noeuds elastic >
node.name: <nom du noeud que vous souhaitez démarrer (doit être unique pour un cluster)>
path.data: <ou stocker les données ?>
path.logs: <les logs ?>
bootstrap.memory_lock: <verrouiller la mémoire ?>
network.host: localhost
http.port: <Port http (9200)>
! action.destructive_requires_name: true
index.number_of_shards: < nombre de serveurs (défaut 1)>
index.number_of_replicas: < de serveurs de réplication pour la tolérance aux pannes (défaut 0) >

exemple:

1

  1. Vérifier que vous avez ces fichier avant de continuer.

1

  1. Déplacer et renomer le respertoir vers /opt/elasticsearch.

1

  1. Ouvrire le fichier .profile.

1

  1. Ajouter les variables suivants.
export ES_HOME=/opt/elasticsearch
export PATH=$PATH:$ES_HOME/bin

1

  1. Charger le fichier .profile et tester par
echo $ES_HOME

Il faut que vous recevoire la valeure dèja citée dans .proile

1

  1. N'oubliez pas de créer les repertoires data/ et log/ dans /opt/elasticsearch

1

  1. Vériier les droits d'accès vers /opt/elasticsearch/elaticseach.keystore, et ajouter les droits de l'écriture et de l'éxecution.

1

  1. Lancez elasticsearch

1

  1. Verifier le lancement via jps

1

  1. Tester votre premier requête curl

1

Vous avez pas curl ? installez le, par

sudo apt install curl
  1. Ou bien tester la même requête dans votre navigateur.

1

Maintenant, Elasticsearch est bien installé. Pour pouvoir gérer le cluster, on va utiliser une interace graphique, elasticsearch-head.

Installation elasticsearch-head (Optionnel)

elasticsearch-head est 'front-end' (une interface) faite pour gérer, visualiser, et passer des requêtes à elasticsearch.

elasticsearch-head sur github

  1. Installez nodejs

1

  1. Installez npm

1

  1. Installez Verifier votre installation

1

  1. Faire clone via git du 'repository' : https://github.com/mobz/elasticsearch-head#running-with-built-in-server

1

  1. Vous deplacez vers le dossier elasticsearch-head, et executer npm install

1

  1. Lancez le serveur nodejs

1

  1. N'oubliez pas de lancer elasticsearch

1

  1. Visitez l'adresse http://localhost:9100/ sur votre navigateur.

1

  1. Vous pouvez observer que on peut pas connecter au cluster via 'elasticseach-head', on peut régler ce problème on ajoutant les propiétés suivantes au fichier elasticsearch.yml.
http.cors.enabled: true
http.cors.allow-origin: "*"

1

1

  1. Et voilà on est connecter à notre cluster

1

  1. Voici les inormations de notres cluster

1

==FIN installation==

Next Section: Elasticseach concepts ➡️