github-mirrors/logstash
1
0
Fork 0
mirror of https://github.com/elastic/logstash.git synced 2025-04-23 22:27:21 -04:00
Code Issues Projects Releases Packages Wiki Activity

Add breaking changes doc (#5402)

Browse source 
* Add breaking changes doc for 5.0.0-alpha3
This commit is contained in:
Suyog Rao 2016-05-31 16:17:59 +02:00
parent 595658f512
commit ec627a1f40
1 changed files with 17 additions and 0 deletions
Download patch file Download diff file Expand all files Collapse all files

17
docs/static/breaking-changes.asciidoc vendored
View file

@ -2,6 +2,23 @@
== Breaking changes
**Breaking changes in 5.0**
Application Settings: Introduced a new way to configure application settings for Logstash through a settings.yml file. This file
is typically located in `LS_HOME/config`, or `/etc/logstash` when installed via packages. Logstash will not be able
to start without this file, so please make sure to pass in `--path.settings` if you are starting Logstash manually
after installing it via a package (RPM, DEB).
Release Packages: When Logstash is installed via DEB, RPM packages, it uses `/usr/share/logstash` and `/var/lib/logstash` to install binaries and config files
respectively. Previously it used to install in `/opt` directory. This change was done to make the user experience
consistent with other Elastic products. Full directory layout is described https://www.elastic.co/guide/en/logstash/5.0/dir-layout.html[here].
Command Line Interface: Most of the long form https://www.elastic.co/guide/en/logstash/5.0/command-line-flags.html[options] have been renamed
to adhere to the yml dot notation to be used in the settings file. Short form options have not been changed.
Plugin Developers: The Event class has a https://github.com/elastic/logstash/issues/5141[new API] to access its data. You will no longer be able to directly use
the Event class through the ruby hash paradigm. All the plugins packaged with Logstash has been updated
to use the new API and their versions bumped to the next major.
The command `bin/plugin` has been renamed to `bin/logstash-plugin`. `bin/plugin <plugin>`` which is the current
way of install packs/plugins is problematic because it pollutes the global namespace if it is put in the path.
This command can now install both plugins and "Packs" - a single zip that contains 0 or 1 plugin for each system