{{tag>software kibana installation}}

Plusieurs solutions possibles pour installer Kibana notamment:
  * paquetage de la distribution;
  * tarball;
  * clonage projet git;
  * docker.

<note>
Kibana doit avoir la même version majeure et révision qu' Elasticsearch ici on installe la 7.13 
</note>

====== Kibana: installation ======


===== Docker =====

Récupérer une image, la liste des tags(versions disponibles) est consultable via le navigateur à partie de l'URL https://hub.docker.com/_/kibana

<code bash>
docker pull kibana:7.12.1
</code>


Créer un dossier pour l'application il contiendra notamment le fichier de configuration qui sera monté (bind mount) dans le conteneur. La documentation complète des options de configuration est disponible à l'URL [[https://www.elastic.co/guide/en/kibana/7.16/settings.html]].

<code bash>
# creation d'un dossier
mkdir kibana

# démarre le service elasticsearch préexistant
docker-compose up -d esdb

# execution d'un conteneur temporaire pour extraire la configuration par défaut
docker run --rm --name tmp_kibana --detach --net webadmin_vnet -p 127.0.0.1:5601:5601 -e "ELASTICSEARCH_HOSTS=http://es01:9200" kibana:7.16.2

# Extraction du fichier de configuration présent dans le conteneur
docker cp tmp_kibana:/usr/share/kibana/config/kibana.yml kibana/
</code>

===== git =====

Il est possible de récupérer les sources du projet et de lancer un serveur web local facilement avec python3

clonage du dépot git:
<code bash>
git clone https://github.com/elastic/kibana.git
</code>

Servir Kibana avec un serveur web, ici Python3 et le module SimpleHTTPServer fera l'affaire pour tester l'application localement: lacer la commande depuis le répertoire de Kibana
<code python>
python -m SimpleHTTPServer
</code>

===== Installation standalone =====

Récupérer l'archive disponible à partir de l'URL https://www.elastic.co/fr/downloads/kibana

Décompresser l'application, ici dans /opt/kibana
<code bash>
tar --directory=/opt/kibana/ -xvf kibana-7.13.1-linux-x86_64.tar.gz 
</code>

Modifier le fichier de configuration ./config/kibana.yml et définir la variable ''elasticsearch.hosts''
<code bash>
cd /opt/kibana/kibana-7.13.1-linux-x86_64/
vim config/kibana.yml
</code>

Lancer l'application:
<code bash>
bin ./kibana
</code>

Par défaut le serveur écoute sur le port local 5601, les logs sont affichés sur la console.
<file>
...
 log   [14:03:05.931] [info][server][Kibana][http] http server running at http://localhost:5601
...
</file>

Presser <key>ctrl</key> + <key>c</key> pour arrêter.

Via le navigateur accéder à kibana en entrant l'URL http://localhost:5601

===== Références =====

  * https://hub.docker.com/_/kibana
  * https://www.elastic.co/guide/en/kibana/current/install.html
  * https://www.elastic.co/guide/en/kibana/current/docker.html