Dieser Blog liefert eine Übersicht der Empfehlungen für das Upgrade von Elasticsearch 1.x zu 2.x, das Ihnen den Prozess erleichtern soll.

<h2>Übersicht</h2>Im Betrieb einer Anwendung muss man oft Upgrades auf das neueste Release eines Produkts vornehmen: um Schritt zu halten mit neuen Funktionen und Fehlerbehebungen und um den Support zu gewährleisten. Mit Elasticsearch ist es nicht anders und mit dem Release von Version 2.0 wurden eine Reihe weitreichender Änderungen eingeführt, die eine vorhandene 1.x-Installation beim Upgrade beeinträchtigen können. Diese werden in der Dokumentation als <a href="https://www.elastic.co/guide/en/elasticsearch/reference/current/breaking-changes-2.0.html" target="_blank">Breaking changes</a> bezeichnet. Bitte beachten Sie, dass ein Neustart des GESAMTEN Clusters erforderlich ist.
<a href="https://www.elastic.co/webinars/upgrading-from-elasticsearch-1-x-to-2-x" target="_blank">Sehen Sie sich unser Video</a> zum Upgrade von Elasticsearch 1.x auf 2.x an.
<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>Wie nehme ich nun ein sauberes Upgrade auf Elasticsearch 2.x vor?</h2>Mit ein paar Tests außerhalb der Produktionsumgebung besteht nur eine geringe Wahrscheinlichkeit, dass ein Upgrade fehlschlägt oder Unstimmigkeiten in Ihren Daten verursacht. Dazu ist allerdings einiges an Planung notwendig – im Folgenden eine Zusammenfassung:
<ul>
	<li>Machen Sie sich mit der Liste der <a href="https://www.elastic.co/guide/en/elasticsearch/reference/current/breaking-changes-2.0.html" target="_blank">Breaking changes</a> vertraut, die im neuen Release enthalten sind. So passieren keine Überraschungen der Art „Hey, was ist mit der Funktion passiert, die wir vorher benutzt haben?“.</li>
	<li>Setzen Sie den <code>network.host</code> auf eine <a href="https://www.elastic.co/guide/en/elasticsearch/reference/current/modules-network.html">_non_loopback</a> Adresse in elasticsearch.yml. Bitte beachten Sie, dass es auch ein Interface sein könnte, das als „_[networkInterface]_“ konfiguriert ist, bspw. „_en0_“, „_ens160_“ oder „_eth0“.</li>
	<li>Laden Sie das <a href="https://github.com/elastic/elasticsearch-migration" target="_blank">Migrations-Plugin</a> herunter und installieren Sie es auf Ihrem Cluster, bevor Sie ein Upgrade versuchen. Bitte beachten Sie, dass das Plugin die Mappings, Indexeinstellungen und Segmente nur prüft (d. h. nicht korrigiert) und danach markiert, was vor Beginn des Migrationsprozesses korrigiert werden muss. Da es nicht nach Index Templates sucht, müssen Sie immer noch die gesamte Dokumentation der Breaking changes lesen, bevor Sie erforderliche Änderungen manuell vornehmen.</li>
	<li>Benutzen Sie die Funktion <a href="https://www.elastic.co/guide/en/elasticsearch/reference/current/modules-snapshots.html" target="_blank">Snapshot & Restore</a> (ein MUSS), um eine Kopie aller Produktionsdaten in einer Testumgebung zu erzeugen, mit denen Sie alle Upgrade-Migrationstests durchführen können. Beschädigen Sie lieber diese, als Ihren Produktions-Cluster zu gefährden.</li>
	<li>Das Upgrade über Major versions hinweg (1.x auf 2.x) erfordert <a href="https://www.elastic.co/guide/en/elasticsearch/reference/current/restart-upgrade.html" target="_blank">den vollständigen Neustart des Clusters</a>.</li>
	<li>Für Nicht-Systemd-Installationen empfehlen wir die Verwendung des aktuellsten elasticsearch init-Skripts von 1.x auf 2.x (es gibt ziemlich viele Unterschiede):</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>Nehmen Sie alle empfohlenen Modifikationen an Ihrer Cluster-Konfiguration und Ihrem Backend-/Frontend-Code vor, den Ihre Anwendung in diesem Zusammenhang nutzt, und berufen Sie sich dabei auf die Ergebnisse des Migrations-Plugins und dem Dokument zu <a href="https://www.elastic.co/guide/en/elasticsearch/reference/current/breaking-changes-2.0.html" target="_blank">Breaking changes</a>.</li>
	<li>Konsultieren Sie alle Upgrade-Dokumentationen für Plugins für Elasticsearch, um sicherzustellen, dass diese zum aktuellsten Release kompatibel sind.</li>
	<li>Achten Sie darauf, dass sowohl <a href="https://www.elastic.co/products/logstash" target="_blank">Logstash</a> als auch <a href="https://www.elastic.co/products/kibana" target="_blank">Kibana</a> ein Upgrade auf eine unterstützte Version erhalten, um die volle Kompatibilität zu Elasticsearch 2.x zu gewährleisten.</li>
	<li>Beachten Sie, dass für ein Kibana-Upgrade auch ein Upgrade des <a href="https://www.elastic.co/guide/en/marvel/2.0/installing-marvel.html" target="_blank">Marvel-Plugins und des Agenten</a> erforderlich ist, da die Benutzeroberfläche in Kibana integriert wurde.</li>
	<li><a href="https://www.elastic.co/guide/en/sense/current/installing.html" target="_blank">Sense</a> ist jetzt Open Source und ebenfalls ein Plugin für Kibana statt für Marvel, muss also nach dem Upgrade manuell installiert werden.</li>
	<li>Logstash 2.x nutzt das <a href="https://www.elastic.co/guide/en/logstash/2.0/breaking-changes.html#_elasticsearch_output_default" target="_blank">HTTP-Protokoll</a> jetzt standardmäßig und erfordert möglicherweise manuelle Änderungen in der Logstash-Konfiguration. Das Ausgabe-Plugin <a href="https://www.elastic.co/guide/en/logstash/2.0/plugins-outputs-elasticsearch_java.html" target="_blank">elasticsearch_java</a> kann bei Bedarf installiert werden.</li>
	<li>Achten Sie darauf, den richtigen <a href="https://www.elastic.co/guide/en/elasticsearch/reference/2.1/setup-upgrade.html" target="_blank">Upgrade-Pfad</a>zu nutzen.</li>
	<li>Der Upgrade-Prozess für die Indizes kann überwacht werden. Sehen Sie sich dafür den <a href="https://www.elastic.co/guide/en/elasticsearch/reference/current/indices-upgrade.html" target="_blank">API-Befehl ‚check upgrade status‘</a> an.</li>
</ul><h2>Mein Upgrade ist kaputt, Hilfe!</h2>Wenn die Upgrade-Gremlins auftauchen und Ihr Leben aufmischen wollen, obwohl Sie die vorigen Schritte genau befolgt haben, können Sie es noch auf folgenden Wegen versuchen:
<ul>
	<li>Stellen Sie der Community im <a href="https://discuss.elastic.co/c/elasticsearch" target="_blank">Diskussionsforum</a> eine Frage. Sie werden positiv überrascht sein von der Hilfsbereitschaft unserer Nutzer-Community.</li>
	<li>Schreiben Sie einen Fehlerbericht auf <a href="https://github.com/elastic/elasticsearch/issues" target="_blank">GitHub</a>, wenn Sie glauben, beim Upgrade-Prozess einen neuen Fehler entdeckt zu haben.</li>
	<li>Wenn Sie ein <a href="https://www.elastic.co/subscriptions" target="_blank">Kunde mit Subskription</a> sind, können Sie im Support-Portal ein Ticket erstellen, damit ein Experte von Elastic Ihnen bei der Behebung von Upgrade-Problemen hilft.</li>
</ul><h2>Sie suchen nach Möglichkeiten, Ihre Ausfallzeit zu minimieren oder das Wartungszeitfenster für einen vollständigen Cluster-Neustart zu reduzieren?</h2>Wenn Ihnen die Risiken zu groß oder der Upgrade-Berg zu gewaltig erscheinen, haben wir hier einige Optionen für Sie:
<ul>
	<li>Erstellen Sie einen neuen Cluster mit der neuen Version von Elasticsearch und den kompatiblen späteren Releases von Logstash, Kibana und anderen Plugins (falls erforderlich).</li>
	<li>Senden Sie Ihre Quellereignisdaten gleichzeitig an den alten und den neuen Cluster und schalten Sie den alten Cluster ab, sobald Ihre vorgeschriebene Speicherfrist abgelaufen ist. Diese Methode eignet sich besser für geringere Speicherfristen wie 7 Tage oder 1 Monat.</li>
	<li>Indexieren Sie Ihren gesamten Datensatz erneut von der Quelle zum neuen Cluster und schalten Sie danach den alten ab.</li>
</ul>Obwohl diese Methode zu Beginn mehr physische (oder virtuelle) Ressourcen verbraucht (obwohl eine Testumgebung für diese Funktion vorübergehend zu geringfügig höheren Zusatzkapazitätskosten umgestaltet werden könnte), dauert diese Phase nur kurz an. Sobald der neue Cluster die Daten des alten hat und alle erforderlichen Funktionen für Ihre Frontend-Anwendung bereitstellen kann, ist der vollständige Wechsel vielleicht die einfachere Alternative.
Achtung: Jeglicher Code, der zum Senden oder Empfangen von Daten von Elasticsearch geschrieben wurde und auf Mappings oder veränderten Funktionen basiert (siehe <a href="https://www.elastic.co/guide/en/elasticsearch/reference/current/breaking-changes-2.0.html" target="_blank">Breaking changes</a>), bedarf unabhängig vom gewählten Upgrade-Pfad immer noch manueller Modifikation.
<h2>Bekannte Probleme</h2>Im Folgenden finden Sie eine Liste der Probleme, die bereits beobachtet wurden und die Sie bei Ihrer Upgrade-Planung berücksichtigen sollten sowie Fehlerbehebungsvorschläge für fehlgeschlagene oder unvollständige Upgrades:
<ul>
	<li>Keine Einstellung für <code>network.host</code> (oder falsche Einstellung). Bevor Sie Elasticsearch 2.x starten, müssen Sie sich vergewissern, dass Sie den <code>network.host</code>:&nbsp;<a href="https://www.elastic.co/guide/en/elasticsearch/reference/current/modules-network.html" style="outline: 0px; line-height: 22.4px; background-color: rgb(255, 255, 255);">_non_loopback</a> in elasticsearch.yml einstellen.</li>
	<li>Das <a href="https://github.com/elastic/elasticsearch-migration" target="_blank">Migrations-Plugin</a>ist nur zur Elasticsearch-Version 1.x kompatibel und sollte (zusammen mit allen 1.x-Plugins) entfernt werden, sobald es bestätigt, dass vor dem Upgrade keine Änderungen erforderlich sind, d. h. vor dem eigentlichen Upgrade.</li>
	<li>Legen Sie ein Backup aller Konfigurationsdateien an, sodass diese im Rahmen eines Paket-Upgrades (DEB, RPM etc.) ersetzt werden können und Sie danach die neueren Konfigurationsdateien an Ihre benötigten Cluster-Einstellungen anpassen können.</li>
	<li>Prüfen Sie vor einem Upgrade-Versuch, ob ausreichend Laufwerksspeicher auf den jeweiligen Cluster-Nodes vorhanden ist. Dieses grundlegende Upgrade-Prinzip wird oft vernachlässigt.</li>
	<li>Möglicherweise nehmen Sie das Upgrade von einem sehr alten Relase vor (vor 0.90). Die Lucene-Version muss dabei zu Elasticsearch 2.x kompatibel sein. Konsultieren Sie also bitte die <a href="https://www.elastic.co/guide/en/elasticsearch/reference/current/indices-upgrade.html" target="_blank">„upgrade API“-Dokumentation</a>, um festzustellen, ob zuvor eine manuelle „upgrade API“-Anfrage durchgeführt werden muss.</li>
	<li>Plugins müssen auf dem neusten Stand gehalten werden, um die Kompatiblität zum neuesten Release von Elasticsearch zu gewährleisten. Wenn es eine neuere Plugin-Version gibt, die zur Elasticsearch 2.x-Version, auf die Sie upgraden wollen, kompatibel ist, müssen Sie das alte Plugin entfernen, das Upgrade vornehmen und danach das neuere Plugin installieren.<a href="https://github.com/elastic/elasticsearch/issues/13756" target="_blank">Ähnlich verhält es sich mit einem Plugin-Ordner mit einem ungültigen Plugin: Dann startet Elasticsearch nämlich nicht</a>.</li>
	<li>Der Marvel-Agent muss auf allen Nodes im Cluster installiert werden. Da das Marvel-Agenten-Plugin das Lizenz-Plugin benötigt, muss zuerst das Lizenz-Plugin auf allen Nodes installiert werden. Wenn Sie das nicht tun, kann es besonders bei der Nutzung des Java-Node-Clients zu Problemen kommen, wenn die .jar-Lizenzdatei nicht Teil des Projekts ist.</li>
	<li>Client-Nodes, auf denen der Marvel-Agent läuft, müssen aufgrund bekannter Probleme mit Version 2.0 mit diesem Node-Typ und der Marvel-Ausführung ein Upgrade auf mindestens Elasticsearch 2.1 erhalten.</li>
	<li>Sie werden keine Indizes mit <a href="https://www.elastic.co/blog/great-mapping-refactoring" target="_blank">sich widersprechenden Field-Mappings</a> auf Elasticsearch 2.x upgraden können (diese Indizes starten dann vielleicht gar nicht mehr!). Das bereits erwähnte Migrations-Plugin sollte diese erkennen.</li>
	<li>Wenn Sie bei geschlossenen Indizies und einem Filter im Migrations-Plugin letzteres nicht erfolgreich ausführen können, sehen Sie sich <a href="https://github.com/elastic/elasticsearch-migration/issues/39#issuecomment-155678151" target="_blank">diesen Workaround</a> an.</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">existiert nicht mehr</a> und Vorlagen werden nicht vom Migrations-Plugin geprüft, daher kann es zu Exceptions kommen. Sie müssen die alten Vorlagen manuell aktualisieren, um dieses Problem zu umgehen.</li>
	<li>Stellen Sie sicher, dass Ihre Kernel-Version aktuell ist, da ältere Releases <a href="https://discuss.elastic.co/t/elasticsearch-crashes-after-update-to-2-0/33437/5" target="_blank">Probleme mit dem neueren fsync haben</a>, das von Elasticsearch 2.x genutzt wird.</li>
	<li>Das Upgrade auf ein bedeutendes Release wie Elasticsearch 2.x <a href="https://github.com/elastic/elasticsearch/issues/14400" target="_blank">funktioniert nicht, wenn einige Nodes mit älteren Releases verbleiben</a>. Alle Nodes müssen im Rahmen der <a href="https://www.elastic.co/guide/en/elasticsearch/reference/current/restart-upgrade.html" target="_blank">Neustart-Upgrade-Schritte</a> ein Upgrade auf das neue Release erhalten.</li>
	<li>Ausführung inkompatibler Releases von <a href="https://www.elastic.co/guide/en/logstash/2.0/breaking-changes.html" target="_blank">Logstash</a> und <a href="https://www.elastic.co/guide/en/kibana/4.2/setup.html" target="_blank">Kibana</a> nach dem Upgrade auf 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

Wichtige Dinge, die Sie beim Upgrade von Elasticsearch 1.x auf 2.x wissen sollten

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

Durch das Absenden erklären Sie, dass Sie unsere <a href="/de/legal/elastic-cloud-account-terms" target="_self">Nutzungsbedingungen</a> gelesen haben und mit ihnen einverstanden sind und dass Sie Elastic erlauben, <a href="/de/legal/privacy-statement#how-we-use-the-information" target="_self">ausgewählte Nachrichten und Informationen</a> an die oben von Ihnen bereitgestellten Kontaktangaben zu senden. Weitere Informationen, darunter auch dazu, wie Sie Ihre Einwilligung zurückziehen können, finden Sie in der <a href="/de/legal/privacy-statement/" target="_self">Datenschutzerklärung von Elastic</a>.

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

Durch das Absenden erklären Sie, dass Sie unsere <a href="/de/legal/serverless-preview-terms" target="_self">Nutzungsbedingungen</a> gelesen haben und mit ihnen einverstanden sind und dass Sie Elastic erlauben, bezüglich unserer zugehörigen Produkte und Dienstleistungen und unter Nutzung der von Ihnen oben bereitgestellten Kontaktangaben <a href="/de/legal/privacy-statement#how-we-use-the-information" target="_self">mit Ihnen in Kontakt zu treten</a>. Weitere Informationen, darunter auch dazu, wie Sie Ihre Einwilligung zurückziehen können, finden Sie in der <a href="/de/legal/privacy-statement/" target="_self">Datenschutzerklärung von 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

Beim Absenden akzeptieren Sie die <a href="/de/agreements/global/cloud-services-monthly" rel="nofollow">Nutzungsbedingungen von Elastic Cloud</a>. Die Verarbeitung Ihrer personenbezogenen Daten unterliegt der <a href="/de/legal/privacy-statement">Datenschutzerklärung von 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

Durch das Absenden erklären Sie, dass Sie unsere <a href="/de/legal/terms-of-use" target="_self">Nutzungsbedingungen</a> gelesen haben und mit ihnen einverstanden sind und dass Sie Elastic erlauben, bezüglich unserer zugehörigen Produkte und Dienstleistungen und unter Nutzung der von Ihnen oben bereitgestellten Kontaktangaben <a href="/de/legal/privacy-statement#how-we-use-the-information" target="_self">mit Ihnen in Kontakt zu treten</a>. Weitere Informationen, darunter auch dazu, wie Sie Ihre Einwilligung zurückziehen können, finden Sie in der <a href="/de/legal/privacy-statement/" target="_self">Datenschutzerklärung von Elastic</a>.

Explore similar demos

Overview

Speakers

Close

See more insights

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.

Der Inhalt dieser Seite ist in der ausgewählten Sprache nicht verfügbar. Wir bei Elastic arbeiten daran, die bereitgestellten Inhalte in verschiedenen Sprachen anzubieten. Bis dahin bitten wir Sie um etwas Geduld und hoffen auf Ihr Verständnis!

Author

Watch now (no PT)

Watch now

See all top stories

All (no PT translation)

Contact information

Press Release

Share on Reddit

Articles by

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

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

Sie können nicht dabei sein? Registrieren Sie sich, damit wir Ihnen die Aufzeichnung zukommen lassen können. Außerdem erhalten Sie eine E‑Mail mit Begleitmaterial.

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

Learn More

Read less

You'll also receive an email with related content

Wir schicken Ihnen zudem relevante Informationen, die von Interesse sein könnten.

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

Vielen Dank für Ihre Registrierung. Sie erhalten in Kürze eine Bestätigungs-E‑Mail von uns.

Author

Articles by Miguel Bosin

Wichtige Dinge, die Sie beim Upgrade von Elasticsearch 1.x auf 2.x wissen sollten

Sign up for Elastic Cloud free trial