ElasticSearch Update 6.3.0

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.

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.

Votre avis

Nobody voted on this yet  You need to enable JavaScript to vote

Tweet

Téléchargement

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

#sudo wget -P /var/opt/elasticsearch https://artifacts.elastic.co/downloads/elasticsearch/elasticsearch-6.3.0.tar.gz

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

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

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

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

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.

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/*

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

Redémarrage

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

#sudo systemctl start elasticsearch

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