mirror of
https://github.com/elastic/logstash.git
synced 2025-04-25 07:07:54 -04:00
33 lines
1.7 KiB
Text
33 lines
1.7 KiB
Text
[[upgrading-logstash]]
|
|
== Upgrading Logstash
|
|
|
|
[IMPORTANT]
|
|
===========================================
|
|
Before upgrading Logstash:
|
|
|
|
* Consult the <<breaking-changes,breaking changes>> docs.
|
|
* Test upgrades in a development environment before upgrading your production cluster.
|
|
===========================================
|
|
|
|
=== Upgrading Using Package Managers
|
|
|
|
This procedure uses <<package-repositories,package managers>> to upgrade Logstash.
|
|
|
|
1. Shut down your Logstash pipeline, including any inputs that send events to Logstash.
|
|
2. Using the directions in the _Package Repositories_ section, update your repository links to point to the 2.0 repositories
|
|
instead of the previous version.
|
|
3. Run the `apt-get update logstash` or `yum update logstash` command as appropriate for your operating system.
|
|
4. Test your configuration file with the `logstash --configtest -f <configuration-file>` command. Configuration options for
|
|
some Logstash plugins have changed in the 2.0 release.
|
|
5. Restart your Logstash pipeline after updating your configuration file.
|
|
|
|
=== Upgrading Using a Direct Download
|
|
|
|
This procedure downloads the relevant Logstash binaries directly from Elastic.
|
|
|
|
1. Shut down your Logstash pipeline, including any inputs that send events to Logstash.
|
|
2. Download the https://www.elastic.co/downloads/logstash[Logstash installation file] that matches your host environment.
|
|
3. Unpack the installation file into your Logstash directory.
|
|
4. Test your configuration file with the `logstash --configtest -f <configuration-file>` command. Configuration options for
|
|
some Logstash plugins have changed in the 2.0 release.
|
|
5. Restart your Logstash pipeline after updating your configuration file.
|