ElasticSearch Update 6.3.0

De EjnTricks
Révision de 17 septembre 2018 à 12:08 par Etienne (discussion | contributions)

(diff) ← Version précédente | Voir la version courante (diff) | Version suivante → (diff)

Cet article présente la mise à jour de ElasticSearch en version 6.3.0.

Dans le cadre de cet article, la mise à jour est effectuée manuellement avec le même principe que pour l'installation initiale. Théoriquement, la mise à jour est simple. Cependant il est nécessaire de n'oublier aucune étape.

Warning-icon.png Attention tous les produits de la suite ne sont pas forcément compatibles. Par exemple, il est nécessaire de mettre à jour Kibana dans la même version, soit 6.3.X, en même temps.


Hand-icon.png Votre avis

Nobody voted on this yet

 You need to enable JavaScript to vote


Download-icon.png Téléchargement

L'application est téléchargée dans le répertoire /var/opt/elasticsearch.


System-Install-icon.png Installation

L'application va être installée sous /var/opt/elasticsearch, avec modification de l'emplacement racine pour être 6.3.0.

#sudo tar --transform 's/^elasticsearch-6.3.0/6.3.0/' -C /var/opt/elasticsearch -xzvf /var/opt/elasticsearch/elasticsearch-6.3.0.tar.gz

Le fichier téléchargé peut être supprimé.

#sudo rm /var/opt/elasticsearch/elasticsearch-6.3.0.tar.gz


Icon File Owner.png Propriétaire fichiers

L'installation a été réalisée avec le compte root. Il est préférable de donner la propriété au compte de démarrage du serveur web, soit elasticsearch dans le cadre de cette installation.

#sudo chown -R elasticsearch:elasticsearch /var/opt/elasticsearch/6.3.0


Icon ACL.png Sécurisation

Les droits mis en place seront uniquement pour le compte d'exécution, soit elasticsearch.

#sudo chmod -R go-rwx /var/opt/elasticsearch/6.3.0


linnk= Arrêt

Dans le cadre de cette installation, l'instance est arrêté. Ceci ne serait pas nécessaire en utilisant un cluster. De plus pour éviter toute erreur potentielle, les applications périphériques, Logstash / Kibana / Beats, sont arrêtées.

#sudo systemctl stop elasticsearch


Share-icon.png Fichiers communs

Lors de l'installation, les fichiers de configuration ont été placés dans /var/opt/elasticsearch/common/config. Cependant, ceux-ci sont légèrement modifiés entre les deux versions. Il est donc nécessaire de refaire les modification. Les fichiers impactés sont les suivants.

  • jvm.options
  • log4j2.properties

Pour le fichier jvm.options, la nouvelle variable d'environnement -XX:ErrorFile est disponible pour spécifier l'emplacement du fichier des crash de la JVM. L'emplacement est modifié pour écrire au même emplacement que les traces, soit dans le répertoire /var/log/elasticsearch.

# specify an alternative path for JVM fatal error logs
#-XX:ErrorFile=logs/hs_err_pid%p.log
-XX:ErrorFile=/var/log/elasticsearch/hs_err_pid%p.log

Pour le fichier log4j2.properties, de nouvelles configurations de trace sont mises à disposition.


Plugin-icon.png Réinstallation Plugins

Il est nécessaire de refaire l'installation des plugins utilisés, voir documentation officielle. Pour cette instance, les plugins Ingest-GeoIP et Ingest-User-Agent sont réinstallés.

#sudo su elasticsearch -s /bin/bash -c 'export ES_PATH_CONF=/var/opt/elasticsearch/common/config;/var/opt/elasticsearch/6.3.2/bin/elasticsearch-plugin install ingest-geoip'
-> Downloading ingest-geoip from elastic
[=================================================] 100%  
@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@
@     WARNING: plugin requires additional permissions     @
@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@
* java.lang.RuntimePermission accessDeclaredMembers
* java.lang.reflect.ReflectPermission suppressAccessChecks
See http://docs.oracle.com/javase/8/docs/technotes/guides/security/permissions.html
for descriptions of what these permissions allow and the associated risks.

Continue with installation? [y/N]y
-> Installed ingest-geoip

#sudo su elasticsearch -s /bin/bash -c 'export ES_PATH_CONF=/var/opt/elasticsearch/common/config;/var/opt/elasticsearch/6.3.2/bin/elasticsearch-plugin install ingest-user-agent'
-> Downloading ingest-user-agent from elastic
[=================================================] 100%  
-> Installed ingest-user-agent

L'installation des plugins a été réalisée avec le compte root. Il faut donner la propriété au compte de démarrage de l'instance, soit elasticsearch dans le cadre de cette installation.

#sudo chown -R elasticsearch:elasticsearch /var/opt/elasticsearch/6.3.0/plugins/*

Après avoir modifié le propriétaire des fichiers, il est conseillé de positionner des droits restrictifs afin que seul le propriétaire puisse accéder à ceux-ci.

#sudo chmod -R go-rwx /var/opt/elasticsearch/6.3.0/plugins/*


Vues-icon.png Référencement version

Afin de faciliter les montées de versions, le lien /var/opt/elasticsearch/installed a été mis en place et doit être mis à jour.

#sudo rm /var/opt/elasticsearch/installed
#sudo ln -s /var/opt/elasticsearch/6.3.0 /var/opt/elasticsearch/installed
#sudo chown -h elasticsearch:elasticsearch /var/opt/elasticsearch/installed


Start-icon.png Redémarrage

L'instance peut être redémarrée.

#sudo systemctl start elasticsearch


Viewer icon.png Voir aussi

Documentation officielle: https://www.elastic.co/guide/en/elasticsearch/reference/6.3/setup-upgrade.html

https://www.elastic.co/guide/en/elasticsearch/reference/6.3/rolling-upgrades.html

https://www.elastic.co/guide/en/elasticsearch/plugins/6.3/listing-removing-updating.html

Release Notes: https://www.elastic.co/guide/en/elasticsearch/reference/6.3/release-notes-6.3.0.html