github-mirrors/kibana
1
0
Fork 0
mirror of https://github.com/elastic/kibana.git synced 2025-04-23 17:28:26 -04:00
Code Issues Projects Releases Packages Wiki Activity

Backport PR #8753

Browse source 
---------

**Commit 1:**
Align better with ES doc structure

* Original sha: 48c3da71b9
* Authored by Matthew Bargar <mbargar@gmail.com> on 2016-10-18T22:22:53Z

**Commit 2:**
Improve formatting and details of breaking changes docs

* Original sha: 4a59a7c93c
* Authored by Matthew Bargar <mbargar@gmail.com> on 2016-10-19T16:55:06Z
This commit is contained in:
Elastic Jasper 2016-10-21 10:30:42 -04:00
parent 3a5095bd6e
commit a4efa8ada3
4 changed files with 54 additions and 13 deletions
Download patch file Download diff file Expand all files Collapse all files

12
docs/breaking-changes.asciidoc
View file

@ -1,12 +0,0 @@
[[breaking-changes]]
== Breaking Changes
This section discusses the changes that you need to be aware of when migrating
your application from one version of Kibana to another.
[[breaking-changes-5.0]]
=== Breaking changes in 5.0
* {k4pull}8013[Pull Request 8013]: Kibana binds to localhost by default
* {k4pull}7855[Pull Request 7855]: Markdown headers require a space between the final hash and title
* {k4pull}7308[Pull Request 7308]: Debian and rpm packages install assets to `/usr/share/kibana`, and configuration to `/etc/kibana`
* {k4pull}6402[Pull Request 6402]: The plugin installer now has its own executable, it can be found at `/bin/kibana-plugin`

2
docs/index.asciidoc
View file

@ -16,7 +16,7 @@ include::setup.asciidoc[]
include::getting-started.asciidoc[]
include::breaking-changes.asciidoc[]
include::migration/index.asciidoc[]
include::plugins.asciidoc[]

8
docs/migration/index.asciidoc Normal file
View file

@ -0,0 +1,8 @@
[[breaking-changes]]
== Breaking Changes
This section discusses the changes that you need to be aware of when migrating
your application from one version of Kibana to another.
include::migrate_5_0.asciidoc[]

45
docs/migration/migrate_5_0.asciidoc Normal file
View file

@ -0,0 +1,45 @@
[[breaking-changes-5.0]]
=== Breaking changes in 5.0
==== Kibana binds to localhost by default
{k4pull}8013[Pull Request 8013]
*Details:* Kibana (like Elasticsearch) now binds to localhost for security purposes instead of 0.0.0.0 (all addresses). Previous binding to 0.0.0.0 also caused issues for Windows users.
*Impact:* If you are running Kibana inside a container/environment that does not allow localhost binding, this will cause Kibana not to start up unless server.host is configured in the kibana.yml to a valid IP address/host, etc..
==== Markdown headers
{k4pull}7855[Pull Request 7855]
*Details:* As part of addressing the security issue https://www.elastic.co/community/security[ESA-2016-03] (CVE-2016-1000220) in the Kibana product, the markdown version has been bumped.
*Impact:* As a result of the fix to ESA-2016-03, there is a slight change in the markdown format for headers.
Previously, headers are defined using `###` followed by the title:
###Packetbeat:
[Dashboard](/#/dashboard/Packetbeat-Dashboard)
[Web transactions](/#/dashboard/HTTP)
It should now be defined as follows (with a space between ### and the title):
### Packetbeat:
[Dashboard](/#/dashboard/Packetbeat-Dashboard)
[Web transactions](/#/dashboard/HTTP)
==== Linux package install directories
{k4pull}7308[Pull Request 7308]
*Details:* To align with the Elasticsearch packages, Kibana now installs binaries under `/usr/share/kibana` and configuration files under `/etc/kibana`. Previously they were both located under `/opt/kibana`.
*Impact:* Apart from learning the new location of Kibana binaries and configuration files, you may have to update your automation scripts as needed.
==== The plugin installer now has its own executable
{k4pull}6402[Pull Request 6402]
*Details:* The new installer can be found at `/bin/kibana-plugin`. When installing/removing Kibana plugins, you will now call `kibana-plugin` instead of the main kibana script.
*Impact:* You may have to update your automation scripts.