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

Added 'Upgrading Kibana' section

Browse source
This commit is contained in:
LeeDr 2016-07-22 13:25:11 -05:00
parent ebb9cd2972
commit 32ed1ceb4d
1 changed files with 29 additions and 6 deletions
Download patch file Download diff file Expand all files Collapse all files

35
docs/setup.asciidoc
View file

@ -1,10 +1,10 @@
[[setup]]
== Getting Kibana Up and Running
== Installing Kibana
You can set up Kibana and start exploring your Elasticsearch indices in minutes.
All you need is:
* Elasticsearch {esversion}
* A modern web browser - http://www.elastic.co/subscriptions/matrix#matrix_browsers[Supported Browsers].
* A modern web browser - https://www.elastic.co/support/matrix#show_browsers[Supported Browsers].
* Information about your Elasticsearch installation:
** URL of the Elasticsearch instance you want to connect to.
** Which Elasticsearch indices you want to search.
@ -12,22 +12,45 @@ All you need is:
NOTE: If your Elasticsearch installation is protected by http://www.elastic.co/overview/shield/[{scyld}], see
{shield}/kibana.html#using-kibana4-with-shield[{scyld} with Kibana] for additional setup instructions.
=== Upgrading Kibana
Your existing Kibana version is generally compatible with the next minor version release of Elasticsearch.
This means you should upgrade your Elasticsearch cluster(s) before or at the same time as Kibana.
We cannot guarantee compatibility between major version releases so in those cases both Elasticsearch and Kibana must be upgraded together.
. https://www.elastic.co/guide/en/elasticsearch/reference/current/modules-snapshots.html[snapshot] existing `.kibana` index in Elasticsearch
. save a backup copy of the existing `config/kibana.yml`
. take note of the Kibana plugins that are installed;
.. `/opt/kibana/bin/kibana plugin --list` on 4.x versions of Kibana.
.. `/usr/share/kibana/bin/kibana-plugin --list` on 5.x versions of Kibana.
. For Kibana installations using an extracted **archive file**;
.. extract the new version of Kibana into a different directory. See steps below.
.. migrate any custom configuration from your old kibana.yml to your new one
.. follow other steps below to complete the new installation
.. once the new version is fully configured and working with required plugins, remove the previous version of Kibana
. For Kibana installations using a Linux **package manager**;
.. uninstall the existing Kibana package `apt-get remove kibana` or `yum remove kibana`
.. install the new Kibana package. See steps below. (There have been some installer issues between various version of Kibana so the uninstall and install process is safer than an upgrade.)
[float]
[[install]]
=== Install and Start Kibana
=== Install and Start Kibana from archive file
To get Kibana up and running:
. Download the https://www.elastic.co/downloads/kibana[Kibana {version} binary package] for your platform.
. Extract the `.zip` or `tar.gz` archive file.
. After installing, run Kibana from the install directory: `bin/kibana` (Linux/MacOSX) or `bin\kibana.bat` (Windows).
. If upgrading, copy configuration changes from the previous kibana.yml to the new version.
. Optionally install Kibana plugins.
. Run Kibana from the install directory: `bin/kibana` (Linux/MacOSX) or `bin\kibana.bat` (Windows).
On Unix, you can instead run the package manager suited for your distribution.
////
[float]
include::kibana-repositories.asciidoc[]
////
That's it! Kibana is now running on port 5601.