Nous comprenons la difficulté que représente la mise à niveau d’Elasticsearch 1.x à 2.x. Dans cet article vous offrons des recommandations pour vous aider.

<h2>Présentation</h2>Dans tout cycle de vie d'un déploiement logiciel, on doit souvent faire face au besoin d'installer la dernière version d'un produit, à la fois pour bénéficier de nouvelles fonctionnalités et des correctifs mais aussi pour continuer à bénéficier du support. Elasticsearch n'échappe pas à la règle et la version 2.0 comprend des changements majeurs, qui pourraient altérer une installation 1.x existante au cours de la mise à niveau. Vous en retrouverez la liste complète dans la section <a href="https://www.elastic.co/guide/en/elasticsearch/reference/current/breaking-changes-2.0.html" target="_blank">changements majeurs</a>&nbsp;de la documentation. Notez qu'un redémarrage COMPLET du cluster est nécessaire.
<a href="https://www.elastic.co/webinars/upgrading-from-elasticsearch-1-x-to-2-x" target="_blank">Regardez notre vidéo</a> on&nbsp;sur la mise à niveau d'Elasticsearch 1.x à 2.x.
<img src="https://api.contentstack.io/v2/assets/575e4d0712798d8e381fea72/download?uid=bltc9a4353284ee7ef6?uid=bltc9a4353284ee7ef6" data-sys-asset-uid="blta55eb7dff751eaa7" alt="2014-08-29_15_20_20_-Upgrade_-_Maintain_Speed.JPG" style="max-width: 100%;"> 
<h2>Comment passer à Elasticsearch 2.x sans problème ?</h2>En effectuant des tests dans un environnement hors production, vous devriez éviter tout échec de mise à niveau ainsi que l'apparition d'incohérences dans vos données. Toutefois cette étape nécessite de la préparation qui pourrait être résumée comme suit :
<ul>
	<li>Prenez connaissance de la liste des <a href="https://www.elastic.co/guide/en/elasticsearch/reference/current/breaking-changes-2.0.html" target="_blank">changements majeurs</a>&nbsp;intégrés à la nouvelle version. Vous devriez ainsi éviter les mauvaises surprises si l'une des fonctionnalités que vous utilisiez a été modifiée ou supprimée.</li>
	<li>Paramétrez <code>network.host</code> sur une adresse <a href="https://www.elastic.co/guide/en/elasticsearch/reference/current/modules-network.html">_non_loopback</a>&nbsp;dans elasticsearch.yml. Notez qu'il peut aussi s'agir d'une interface configurée comme suit : "_[networkInterface]_"; p.ex., "_en0_", "_ens160_" or "_eth0".</li>
	<li>Téléchargez et installez le <a href="https://github.com/elastic/elasticsearch-migration" target="_blank">plugin de migration</a>&nbsp;sur votre cluster avant de lancer la mise à niveau. Vous n'avez pas besoin de redémarrer le nœud. Notez que ce plugin ne fait que vérifier (il ne corrige pas) les mappings, les paramètres des index et les segments, et surligne ensuite ce qui doit être corrigé avant de démarrer le processus de migration. Comme il ne vérifie pas&nbsp;les modèles d'index, vous devez tout de même consulter la documentation des changements majeurs avant de faire une modification manuelle.</li>
	<li>Utilisez la fonction <a href="https://www.elastic.co/guide/en/elasticsearch/reference/current/modules-snapshots.html" target="_blank">snapshot et restore</a>&nbsp;(un MUST) pour faire une copie de vos données de production dans un environnement de test, et pouvoir les utiliser pour tester la mise à niveau. Mieux vaut altérer cet environnement, le cas échéant, que votre cluster de production.</li>
	<li>Pour passer d'une version majeure à une autre (de 1.x à 2.x) vous devez <a href="https://www.elastic.co/guide/en/elasticsearch/reference/current/restart-upgrade.html" target="_blank">redémarrer entièrement le cluster</a>.</li>
	<li>Pour les installations non-systemd, nous vous conseillons fortement d'utiliser le tout dernier script init d'Elasticsearch de 1.x à 2.x (il existe de nombreuses différences) :</li>
</ul>&nbsp; &nbsp; &nbsp; &nbsp;&nbsp;<a href=" https://raw.githubusercontent.com/elastic/elasticsearch/2.1/distribution/deb/src/main/packaging/init.d/elasticsearch" target="_blank">2.1 DEB init </a>&nbsp; &nbsp; &nbsp; &nbsp;&nbsp;<a href="https://raw.githubusercontent.com/elastic/elasticsearch/2.1/distribution/rpm/src/main/packaging/init.d/elasticsearch" target="_blank">2.1 RPM init</a>
<ul>
	<li>Apportez toutes les modifications recommandées sur la configuration de votre cluster, ainsi qu'au code back/front-end utilisé par votre application en lien avec cette mise à niveau, d'après les résultats du plugin de migration et&nbsp;du document sur les <a href="https://www.elastic.co/guide/en/elasticsearch/reference/current/breaking-changes-2.0.html" target="_blank">changements majeurs</a>&nbsp;.</li>
	<li>Suivez toute la documentation sur la mise à niveau des plugins sur Elasticsearch, pour vous assurer qu'ils fonctionnent une fois la dernière version installée.</li>
	<li>Vérifiez que vous avez mis à jour&nbsp;<a href="https://www.elastic.co/products/logstash" target="_blank">Logstash</a>&nbsp;et&nbsp;<a href="https://www.elastic.co/products/kibana" target="_blank">Kibana</a>&nbsp;dans une version prise en charge, pour qu'ils soient entièrement compatibles avec Elasticsearch 2.x.</li>
	<li>Notez qu'une mise à niveau de Kibana nécessite aussi la mise à niveau du&nbsp;<a href="https://www.elastic.co/guide/en/marvel/2.0/installing-marvel.html" target="_blank">plugin et de l'agent Marvel</a>&nbsp;car l'interface utilisateur se trouve maintenant dans Kibana.</li>
	<li><a href="https://www.elastic.co/guide/en/sense/current/installing.html" target="_blank">Sense</a>&nbsp;est désormais open source et aussi un plugin de Kibana plutôt que Marvel, vous devez donc l'installer manuellement après la mise à niveau.</li>
	<li>Logstash 2.x utilise maintenant le <a href="https://www.elastic.co/guide/en/logstash/2.0/breaking-changes.html#_elasticsearch_output_default" target="_blank">protocole HTTP</a>&nbsp;par défaut. Vous devrez peut-être faire des changements manuels dans la configuration de Logstash. Le plugin de sortie&nbsp;<a href="https://www.elastic.co/guide/en/logstash/2.0/plugins-outputs-elasticsearch_java.html" target="_blank">elasticsearch_java</a>&nbsp;peut être installé si besoin.</li>
	<li>Assurez-vous de suivre la bonne <a href="https://www.elastic.co/guide/en/elasticsearch/reference/2.1/setup-upgrade.html" target="_blank">procédure de mise à niveau</a>.</li>
	<li>Le processus de mise à niveau des index peut être surveillé. Voir la <a href="https://www.elastic.co/guide/en/elasticsearch/reference/current/indices-upgrade.html" target="_blank">commande API « vérifier le statut de mise à niveau »</a>.</li>
</ul><h2>À l'aide, ma mise à niveau est défaillante !</h2>Si les démons de la mise à niveau tentaient de mettre le chaos dans votre vie, alors que vous aviez scrupuleusement suivi les étapes ci-dessus, tout n'est pas perdu ! Vous pouvez :
<ul>
	<li>Poser une question à la communauté sur le <a href="https://discuss.elastic.co/c/elasticsearch" target="_blank">forum</a>. Notre communauté d'utilisateurs vous surprendra par sa réactivité.</li>
	<li>Soumettre un rapport de bug sur <a href="https://github.com/elastic/elasticsearch/issues" target="_blank">GitHub</a>&nbsp; si vous pensez avoir rencontré un bug au cours du processus de mise à niveau.</li>
	<li>Si vous êtes un <a href="https://www.elastic.co/subscriptions" target="_blank">client abonné au support</a>, envoyez un ticket à partir du portail d'assistance. Un membre de l'équipe d'Elastic vous aidera tout au long du processus.</li>
</ul><h2>Vous cherchez à réduire au maximum la durée d'indisponibilité ou le créneau de maintenance nécessaire au redémarrage du cluster ?</h2>Si les risques vous paraissent trop importants ou la mise à niveau une montagne trop haute à gravir, envisagez plutôt les mesures suivantes :
<ul>
	<li>Créez un nouveau cluster sur la nouvelle version d'Elasticsearch, avec les futures versions compatibles de Logstash, Kibana et d'autres plugins (si nécessaire).</li>
	<li>Envoyez les données sources de vos événements à la fois sur l'ancien et le nouveau cluster, et désactivez l'ancien cluster une fois que la période de conservation requise est passée. Cette technique est évidemment plus aisée lorsque les périodes de conservation sont courtes, comme 7 jours ou 1 mois.</li>
	<li>Réindexez votre ensemble complet de données de la source vers le nouveau cluster, puis désactivez l'ancien.</li>
</ul>Bien que cette approche requière davantage de ressources physiques (ou virtuelles) au départ (bien qu'un environnement de test puisse être utilisé dans ce but temporairement sans trop de coûts supplémentaires), elle sera limitée dans le temps. Dès que le nouveau cluster contiendra les mêmes données que l'ancien, ainsi que toutes les fonctionnalités requises de votre application front-end, le passage d'un cluster à l'autre sera peut-être la solution la plus simple.
Attention : tout code écrit pour envoyer ou recevoir des données d'Elasticsearch basé sur des mappings ou des fonctions ayant été modifiés (voir les <a href="https://www.elastic.co/guide/en/elasticsearch/reference/current/breaking-changes-2.0.html" target="_blank">changements majeurs</a>), devra quand même être modifié manuellement quel que soit le type de mise à niveau choisi.
<h2>Problèmes connus</h2>Vous trouverez ci-dessous la liste des problèmes connus, ce qui peut être utile lorsque vous choisissez votre type de mise à niveau. Les solutions de dépannage pour les mises à niveau partielles ou ayant échoué, sont aussi fournies.
<ul>
	<li>Aucun paramétrage de <code>network.host</code> (ou mauvais paramétrage). Avant de lancer Elasticsearch 2.x, assurez-vous de définir <code>network.host</code>: <a href="https://www.elastic.co/guide/en/elasticsearch/reference/current/modules-network.html" target="_blank">_non_loopback_</a>&nbsp;dans&nbsp;elasticsearch.yml</li>
	<li>Le <a href="https://github.com/elastic/elasticsearch-migration" target="_blank">plugin de migration</a>&nbsp;est uniquement compatible avec Elasticsearch version 1.x et doit donc être supprimé (ainsi que tous les plugins 1.x) une fois qu'il a confirmé qu'aucun changement n'est requis avant la mise à niveau, avant&nbsp;que vous ne lanciez la mise à niveau.</li>
	<li>Gardez une sauvegarde de tous les fichiers de configuration et laissez la mise à niveau les remplacer (DEB, RPM etc). Modifiez ensuite les nouveaux fichiers de configuration pour qu'ils correspondent aux paramètres requis de votre cluster.</li>
	<li>Assurez-vous que tous les nœuds de votre cluster ont suffisamment d'espace disque avant de lancer la mise à niveau. Ce principe de base de la mise à niveau est trop souvent négligé.</li>
	<li>Vous faites peut-être la mise à niveau à partir d'une très ancienne version (avant 0.90). La version de Lucene doit être compatible avec Elasticsearch 2.x, aussi veuillez consulter la <a href="https://www.elastic.co/guide/en/elasticsearch/reference/current/indices-upgrade.html" target="_blank">documentation sur l'API de mise à niveau</a>&nbsp;pour savoir si vous devez auparavant faire une requête manuelle de l'API de mise à niveau.&nbsp;</li>
	<li>Les plugins doivent être à jour&nbsp;pour être compatibles avec la dernière version d'Elasticsearch. Si une nouvelle version d'un plugin est compatible avec la version Elasticsearch 2.x que vous souhaitez installer, vous devez&nbsp;supprimer l'ancien plugin, effectuer la mise à niveau puis installer le nouveau plugin. De même, <a href="https://github.com/elastic/elasticsearch/issues/13756" target="_blank">Elasticsearch ne démarrera pas s'il existe un dossier de plugin contenant un plugin non valide</a>.</li>
	<li>L'agent Marvel doit être installé sur tous les nœuds du cluster. Le plugin de l'agent Marvel a besoin du plugin de licence, aussi vous devez installer celui-ci sur tous les nœuds d'abord. Si cet ordre n'est pas respecté, des problèmes peuvent survenir particulièrement si vous utilisez le nœud client Java et si la librairie "licence" n'est pas déclarée dans votre projet.</li>
	<li>Les nœuds client qui exécutent l'agent Marvel doivent être mis à niveau vers la version Elasticsearch 2.1 ou ultérieure, car des problèmes sont connus avec la version 2.0 pour ce type de nœud avec Marvel.</li>
	<li>Vous ne pourrez pas mettre à niveau les index qui comportent des <a href="https://www.elastic.co/blog/great-mapping-refactoring" target="_blank">conflits dans les mappings de champs</a>&nbsp;vers Elasticsearch 2.x (les index ne démarreront peut-être même pas). Le plugin de migration mentionné plus haut devrait déceler ce problème.</li>
	<li>Si vous n'arrivez pas à exécuter le plugin de migration correctement lorsque des index sont fermés et que vous utilisez un filtre dans le plugin, essayez <a href="https://github.com/elastic/elasticsearch-migration/issues/39#issuecomment-155678151" target="_blank">cette solution</a>.</li>
	<li><code>index_analyzer</code> <a href="https://www.elastic.co/guide/en/elasticsearch/reference/current/breaking_20_mapping_changes.html#_analyzer_mappings" target="_blank">n'existe plus</a>&nbsp;et les modèles ne sont pas vérifiés par le plugin de migration. Vous pourriez obtenir des exceptions. Pour corriger cela, vous devez mettre à niveau les anciens modèles manuellement.</li>
	<li>Assurez-vous que la version de votre noyau est à jour, car les anciennes versions <a href="https://discuss.elastic.co/t/elasticsearch-crashes-after-update-to-2-0/33437/5" target="_blank">ont rencontré des problèmes avec la nouvelle fonction fsync</a>&nbsp;utilisée par Elasticsearch 2.x.</li>
	<li>La mise à niveau vers une version majeure comme Elasticsearch 2.x <a href="https://github.com/elastic/elasticsearch/issues/14400" target="_blank">ne fonctionnera pas si des nœuds se trouvent toujours sur d'anciennes versions</a>. Tous les nœuds doivent être mis à niveau vers la nouvelle version au cours du processus de <a href="https://www.elastic.co/guide/en/elasticsearch/reference/current/restart-upgrade.html" target="_blank">mise à jour du cluster</a>.</li>
	<li>Exécuter des versions incompatibles de <a href="https://www.elastic.co/guide/en/logstash/2.0/breaking-changes.html" target="_blank">Logstash</a> et <a href="https://www.elastic.co/guide/en/kibana/4.2/setup.html" target="_blank">Kibana</a>&nbsp;après la mise à niveau d'Elasticsearch 2.x.</li>
</ul>

technology-computer-chips-gigabyte.jpg

Maintain_Speed_small.JPG

Key points to be aware of when upgrading from Elasticsearch 1.x to 2.x

Points importants à prendre en compte lors de la mise à niveau d'Elasticsearch 1.x à 2.x

Start free trial

Blog Footer CTA

Sign up for Elastic Cloud free trial

Miguel Bosin

By submitting you acknowledge that you've read and agree to our <a href="/legal/elastic-cloud-account-terms" target="_self">Terms of Service</a>, and you agree to receive the <a href="/legal/privacy-statement#how-we-use-the-information" target="_self">selected communications</a> at the contact details you provided above. See <a href="/legal/privacy-statement/" target="_self">Elastic’s Privacy Statement</a> for more details or to opt-out at any time.

Communication Preferences - ONLY for /communication-preferences

En confirmant votre envoi, vous reconnaissez que vous avez lu et que vous acceptez nos <a href="/fr/legal/elastic-cloud-account-terms" target="_self">Conditions générales d'utilisation</a>, et vous acceptez de recevoir les <a href="/fr/legal/privacy-statement#how-we-use-the-information" target="_self">types de notification sélectionnés</a> à l'adresse que vous avez fournie plus haut. Pour en savoir plus ou pour revenir sur votre décision (possible à tout moment), consultez la <a href="/fr/legal/privacy-statement/" target="_self">Déclaration de confidentialité d'Elastic</a>.

By submitting you acknowledge that you've read and agree to our <a href="/legal/elastic-cloud-account-terms" target="_blank">Terms of Service</a>, and that Elastic may <a href="/legal/privacy-statement#how-we-use-the-information" target="_blank">contact you</a> about our related products and services, using the details you provide above. See <a href="/legal/privacy-statement/" target="_blank">Elastic’s Privacy Statement</a> for more details or to opt-out at any time.By submitting this form, I agree to Elastic sharing my contact information with Google Cloud. I also agree to Elastic giving my information to the vendor for the purpose of shipping my food package.

GDPR Text + Google Cloud

By submitting you acknowledge that you've read and agree to our <a href="/legal/serverless-preview-terms" target="_blank">Terms of Service</a>, and that Elastic may <a href="/legal/privacy-statement#how-we-use-the-information" target="_blank">contact you</a> about our related products and services, using the details you provide above. See <a href="/legal/privacy-statement/" target="_blank">Elastic’s Privacy Statement</a> for more details or to opt-out at any time.

Serverless GDPR Text

En confirmant votre envoi, vous reconnaissez que vous avez lu et que vous acceptez nos <a href="/fr/legal/serverless-preview-terms" target="_self">Conditions générales d'utilisation</a>, et vous permettez à Elastic de <a href="/fr/legal/privacy-statement#how-we-use-the-information" target="_self">vous contacter</a> à propos de produits et services similaires en utilisant les informations que vous avez fournies plus haut. Pour en savoir plus ou pour revenir sur votre décision (possible à tout moment), consultez la <a href="/fr/legal/privacy-statement/" target="_self">Déclaration de confidentialité d'Elastic</a>.

By submitting you agree to <a href="/agreements/global/cloud-services-monthly" rel="nofollow">Elastic Cloud Terms of Service</a>. Your personal data will be processed in accordance with <a href="/legal/privacy-statement">Elastic's Privacy Statement</a>.

Cloud Trial GDPR Text

En envoyant votre demande d'inscription, vous acceptez les <a href="/fr/agreements/global/cloud-services-monthly" rel="nofollow">conditions générales d'utilisation d'Elastic Cloud</a>. Vos données personnelles seront traitées conformément à la <a href="/fr/legal/privacy-statement">déclaration de confidentialité d'Elastic</a>.

By submitting you acknowledge that you've read and agree to our <a href="/legal/terms-of-use" target="_blank">Terms of Service</a>, and that Elastic may <a href="/legal/privacy-statement#how-we-use-the-information" target="_blank">contact you</a> about our related products and services, using the details you provide above. See <a href="/legal/privacy-statement/" target="_blank">Elastic’s Privacy Statement</a> for more details or to opt-out at any time.

Newsletter GDPR Text

En confirmant votre envoi, vous reconnaissez que vous avez lu et que vous acceptez nos <a href="/fr/legal/terms-of-use" target="_self">Conditions générales d'utilisation</a>, et vous permettez à Elastic de <a href="/fr/legal/privacy-statement#how-we-use-the-information" target="_self">vous contacter</a> à propos de produits et services similaires en utilisant les informations que vous avez fournies plus haut. Pour en savoir plus ou pour revenir sur votre décision (possible à tout moment), consultez la <a href="/fr/legal/privacy-statement/" target="_self">Déclaration de confidentialité d'Elastic</a>.

Explore similar demos

Overview

You'll also receive an email with related content.

You'll also receive an email with related content

Nous vous enverrons plus de contenu susceptible de vous intéresser.

Speakers

Close

The content on this page is not available in the selected language. As Elastic grows globally, we continue to support content in multiple languages.

The content on this page is not available in the selected language.

Le contenu de cette page n'est pas disponible dans la langue sélectionnée. Chez Elastic, nous mettons tout en œuvre pour vous proposer du contenu dans différentes langues. En attendant, nous vous remercions de votre patience !

See more insights

Articles by

Author

Learn more

Watch now (no PT)

Watch now

See all top stories

All (no PT translation)

Contact information

Press Release

Share on Reddit

Share this story

Share by Email

Thank you for your interest!

Contact Info

Follow us on Youtube

Load More

Share on LinkedIn

Follow us on LinkedIn

Search Integrations

All Solutions

Video for

Follow us on Twitter

See when this webinar starts in my time zone

Voir à quelle heure débute le webinar dans mon fuseau horaire

Register to Watch

Register now

See All Posts

Can't make it? Register and we'll send you the recording. You'll also receive an email with related content

Si vous ne pouvez pas vous libérer le jour J, inscrivez-vous et nous vous enverrons l'enregistrement. Vous recevrez aussi un e-mail contenant des ressources connexes.

Small image for

On-demand webinar

Featured webinar

Register to Attend

Share on Facebook

Reset all

Upcoming webinar

View more posts

Print

Hosted by

Sign In to Attend

View next

Follow us on Facebook

Share

Highlights

Read less

Thank you for registering. We will send you a confirmation email soon.

Nous vous remercions de votre inscription. Vous allez recevoir un e-mail de confirmation.

Author

Articles by Miguel Bosin

Points importants à prendre en compte lors de la mise à niveau d'Elasticsearch 1.x à 2.x

Sign up for Elastic Cloud free trial