Section sur les plugins

HowtoElasticsearch.md

@@ -366,6 +366,43 @@ Si l'on coupe le master, un autre est élu :
 [INFO ][o.e.c.r.a.AllocationService] [bar2] Cluster health status changed from [YELLOW] to [GREEN] (reason: [shards started [[.monitoring-es-2-2016.11.06][0]] ...]).
 ~~~
 
+## Plugins
+
+Elasticsearch dispose d'un système de plugins, certains officiels et d'autres communautaires.
+
+On peut gérer les plugins à partir de la commande /usr/share/elasticsearch/bin/elasticsearch-plugin
+
+### Installation, suppression
+
+Les plugins officiels peuvent être installés en indiquant simplement leur nom. Exemple avec "analysis-phonetic" :
+
+~~~
+# /usr/share/elasticsearch/bin/elasticsearch-plugin install analysis-phonetic
+~~~
+
+Pour installer une nouvelle version d'un plugin, il faut d'abord le supprimer :
+
+~~~
+# /usr/share/elasticsearch/bin/elasticsearch-plugin remove analysis-phonetic
+~~~
+
+### Liste
+
+~~~
+# /usr/share/elasticsearch/bin/elasticsearch-plugin list
+analysis-phonetic
+~~~
+
+### Bloquage suite à mise à jour
+
+**Attention** : certains plugins (ex. : _analysis-icu_ et _analysis-phonetic_) sont étroitement liés à une version d'Elasticsearch et peuvent bloquer son démarrage en cas d'incohérence. On aura alors une erreur de ce type dans les logs du cluster :
+
+~~~
+[2017-10-30T09:51:46,918][ERROR][o.e.b.Bootstrap          ] Exception
+java.lang.IllegalArgumentException: plugin [analysis-phonetic] is incompatible with version [5.6.3]; was designed for version [5.6.2]
+~~~
+
+
 ## Principe de fonctionnement d'Elasticsearch
 
 _Basé sur le livre <http://exploringelasticsearch.com/book>_