Hands On : LogStash, ElasticSearch, Kibana, et plus encore

Si votre ordinateur ne dispose pas au moins d'un OS 64 bits, de 8Go de RAM et d'un CPU suffisamment puissant type Core i5, vous pouvez suivre les étapes suivantes pour installer tout le nécessaire au tutoriel sans utiliser de machine virtuelle.

Pour tous les logiciels qui ne seront pas installés sous forme de package, il est conseillé de placer les binaires dans un même dossier. Dans la machine virtuelle, nous avons utilisé le dossier : /home/elk/atelier. Dans le tutoriel comme dans ce guide d'installation, lorsque les commandes mentionneront le dossier /home/elk/atelier, pensez à les adapter à votre cas.

Pour Windows, nous avons utilisé le dossier C:\atelier\.

Une fois tous les produits installés, vous pouvez retourner au tutoriel en cliquant ici.

Java 8

Linux (Ubuntu)	Windows
Contrôler la version de Java installée : $ java -version openjdk version "1.8.0_66-internal" Si la version est inférieure à 1.8 ou si la commande est inconnue, installer l'openJDK 8 : $ sudo apt-get install openjdk-8-jdk	Contrôler la version de Java installée : > java -version java version "1.8.0_66" Si la version est inférieure à 1.8, télécharger l'installeur pour Windows 64 bits à cette adresse. Lancer l'installation en conservant les options par défaut.

Linux (Ubuntu)

Windows

Contrôler la version de Java installée :

$ java -version
openjdk version "1.8.0_66-internal"

Si la version est inférieure à 1.8 ou si la commande est inconnue, installer l'openJDK 8 :

$ sudo apt-get install openjdk-8-jdk

Contrôler la version de Java installée :

> java -version
java version "1.8.0_66"

Si la version est inférieure à 1.8, télécharger l'installeur pour Windows 64 bits à cette adresse.

Lancer l'installation en conservant les options par défaut.

Vérifier que l'installation s'est bien passée en reprenant la commande de vérification.

LogStash

Nous utiliserons la version 2.1.0 de LogStash.

Télécharger le ZIP ou le TAR.GZ de la version 2.1.0 à cette adresse : https://www.elastic.co/downloads/logstash.
Décompresser l'archive dans /home/elk/atelier ou C:\atelier\.

Tester que LogStash se lance bien avec la commande :

Linux (Ubuntu)	Windows
$ /home/elk/atelier/logstash-2.1.0/bin/logstash version logstash 2.1.0	$ C:\atelier\logstash-2.1.0\bin\logstash version logstash 2.1.0

Si une erreur de la forme JAVA_HOME environment variable must be set! apparaît, ajouter la variable d'environnement système nommée JAVA_HOME en la faisant pointer vers le répertoire d'installation du JDK (sous Windows avec les paramètres par défaut : C:\Program Files\Java\jdk1.8.0_66).

ElasticSearch

Nous utiliserons la version 2.1.0 d'ElasticSearch.

Télécharger le ZIP ou le TAR de la version 2.1.0 à cette adresse : https://www.elastic.co/downloads/elasticsearch.
Décompresser l'archive dans /home/elk/atelier ou C:\atelier\.

Installer le plugin Head. Head est un plugin communautaire hébergé sur GitHub permettant de visualiser l'état et le contenu d'un cluster ElasticSearch. Lancer la commande :

$ /home/elk/atelier/elasticsearch-2.1.0/bin/plugin install mobz/elasticsearch-head
-> Installing mobz/elasticsearch-head...
Trying https://github.com/mobz/elasticsearch-head/archive/master.zip ...
Downloading ..............................................DONE
Verifying https://github.com/mobz/elasticsearch-head/archive/master.zip checksums if available ...
NOTE: Unable to verify checksum for downloaded plugin (unable to find .sha1 or .md5 file to verify)
Installed head into //home/elk/atelier/elasticsearch-2.1.0/plugins/head

Démarrer ElasticSearch avec la commande :

Linux (Ubuntu)	Windows
$ /home/elk/atelier/elasticsearch-2.1.0/bin/elasticsearch	$ C:\atelier\elasticsearch-2.1.0\bin\elasticsearch

Une fois la trace suivante reçue dans la console (Kirigi étant le nom du nœud, il change à chaque démarrage) :

[2015-11-28 14:03:28,178][INFO ][node                     ] [Kirigi] started

Contrôler à l'URL http://localhost:9200/ qu'il répond :

{
  "name" : "Kirigi",
  "cluster_name" : "elasticsearch",
  "version" : {
    "number" : "2.1.0",
    "build_hash" : "72cd1f1a3eee09505e036106146dc1949dc5dc87",
    "build_timestamp" : "2015-11-18T22:40:03Z",
    "build_snapshot" : false,
    "lucene_version" : "5.3.1"
  },
  "tagline" : "You Know, for Search"
}

cURL

cURL est utile pour soumettre des requêtes à ElasticSearch.

Linux (Ubuntu) Windows

Linux (Ubuntu)	Windows
$ sudo apt-get install curl	Télécharger le ZIP à cette adresse. L'extraire dans `C:\atelier\`. Il contient directement l'exécutable, sans installation.

$ sudo apt-get install curl

Télécharger le ZIP à cette adresse. L'extraire dans C:\atelier\. Il contient directement l'exécutable, sans installation.

Kibana

La version de Kibana compatible avec ElasticSearch 2.1.x est la version 4.3.0.

Télécharger la version correspondant à votre système à l'adresse: https://www.elastic.co/downloads/kibana.
Décompresser l'archive dans /home/elk/atelier ou C:\atelier\.

Lancer Kibana avec la commande :

Linux (Ubuntu)	Windows
$ /home/elk/atelier/kibana-4.3.0-linux-x64/bin/kibana	$ C:\atelier\kibana-4.3.0-windows\bin\kibana

Une fois la trace suivante obtenue dans la console :
```
  log   [14:11:46.405] [info][listening] Server running at http://0.0.0.0:5601
```
Vérifier que Kibana répond à l'URL http://localhost:5601/. On ne va rien configurer pour l'instant, cela fera partie de la suite du tutoriel.

RabbitMQ

Erlang est nécessaire au fonctionnement de RabbitMQ.

Linux (Ubuntu) Windows

Linux (Ubuntu)	Windows
Pour Ubuntu, installer le package fourni dans les dépots, il contient toutes les dépendances nécessaires : $ sudo apt-get install rabbitmq-server L'installation du paquet déclenche le démarrage du serveur. Contrôler cela via la commande : $ sudo rabbitmqctl status Status of node 'rabbit@claire-i5' ... [{pid,16510}, ... {uptime,248}] Pour les autres distributions, se reporter à la documentation de l'outil (peut nécessiter de compiler Erlang).	Télécharger le package Erlang pour Windows 64 bits à l'adresse : http://www.erlang.org/download.html. Exécuter l'installeur pour Windows en Administrateur en conservant les options par défaut. Télécharger l'installeur de RabbitMQ pour Windows à l'adresse https://www.rabbitmq.com/download.html. Exécuter l'installeur pour Windows en conservant les options par défaut. Une fois l'installation terminée, ouvrir le prompt RabbitMQ via `Menu Démarrer > Tous les programmes > RabbitMQ Server > RabbitMQ Command Prompt (sbin dir)`. Dans l'invite de commande qui s'ouvre, taper la commande : > rabbitmqctl.bat status Status of node 'rabbit@ITEM-87177' ... [{pid,6672}, ... {uptime,62}]

Pour Ubuntu, installer le package fourni dans les dépots, il contient toutes les dépendances nécessaires :

$ sudo apt-get install rabbitmq-server

L'installation du paquet déclenche le démarrage du serveur. Contrôler cela via la commande :

$ sudo rabbitmqctl status
Status of node 'rabbit@claire-i5' ...
[{pid,16510},
...
 {uptime,248}]

Pour les autres distributions, se reporter à la documentation de l'outil (peut nécessiter de compiler Erlang).

Télécharger le package Erlang pour Windows 64 bits à l'adresse : http://www.erlang.org/download.html.

Exécuter l'installeur pour Windows en Administrateur en conservant les options par défaut.

Télécharger l'installeur de RabbitMQ pour Windows à l'adresse https://www.rabbitmq.com/download.html.

Exécuter l'installeur pour Windows en conservant les options par défaut.

Une fois l'installation terminée, ouvrir le prompt RabbitMQ via Menu Démarrer > Tous les programmes > RabbitMQ Server > RabbitMQ Command Prompt (sbin dir). Dans l'invite de commande qui s'ouvre, taper la commande :

> rabbitmqctl.bat status
Status of node 'rabbit@ITEM-87177' ...
[{pid,6672},
...
 {uptime,62}]