github-mirrors/logstash
1
0
Fork 0
mirror of https://github.com/elastic/logstash.git synced 2025-04-24 06:37:19 -04:00
Code Issues Projects Releases Packages Wiki Activity

Adds upgrading logstash directions.

Browse source 
Fixes #4040
This commit is contained in:
Paul Echeverri 2015-10-14 17:36:41 -07:00 • committed by Jordan Sissel
parent 8180fd7574
commit b25c066fda
1 changed files with 34 additions and 0 deletions
Download patch file Download diff file Expand all files Collapse all files

34
docs/asciidoc/static/upgrading.asciidoc Normal file
View file

@ -0,0 +1,34 @@
[[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.
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.
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.