|
1 | 1 | [[setup]] |
2 | | -== Getting Kibana Up and Running |
| 2 | +== Installing Kibana |
3 | 3 | You can set up Kibana and start exploring your Elasticsearch indices in minutes. |
4 | 4 | All you need is: |
5 | 5 |
|
6 | 6 | * Elasticsearch {esversion} |
7 | | -* A modern web browser - http://www.elastic.co/subscriptions/matrix#matrix_browsers[Supported Browsers]. |
| 7 | +* A modern web browser - https://www.elastic.co/support/matrix#show_browsers[Supported Browsers]. |
8 | 8 | * Information about your Elasticsearch installation: |
9 | 9 | ** URL of the Elasticsearch instance you want to connect to. |
10 | 10 | ** Which Elasticsearch indices you want to search. |
11 | 11 |
|
12 | 12 | NOTE: If your Elasticsearch installation is protected by http://www.elastic.co/overview/shield/[{scyld}], see |
13 | 13 | {shield}/kibana.html#using-kibana4-with-shield[{scyld} with Kibana] for additional setup instructions. |
14 | 14 |
|
| 15 | +=== Upgrading Kibana |
| 16 | + |
| 17 | +Your existing Kibana version is generally compatible with the next minor version release of Elasticsearch. |
| 18 | +This means you should upgrade your Elasticsearch cluster(s) before or at the same time as Kibana. |
| 19 | +We cannot guarantee compatibility between major version releases so in those cases both Elasticsearch and Kibana must be upgraded together. |
| 20 | + |
| 21 | +. https://www.elastic.co/guide/en/elasticsearch/reference/current/modules-snapshots.html[snapshot] existing `.kibana` index in Elasticsearch |
| 22 | +. save a backup copy of the existing `config/kibana.yml` |
| 23 | +. take note of the Kibana plugins that are installed; |
| 24 | +.. `/opt/kibana/bin/kibana plugin --list` on 4.x versions of Kibana. |
| 25 | +.. `/usr/share/kibana/bin/kibana-plugin --list` on 5.x versions of Kibana. |
| 26 | +. For Kibana installations using an extracted **archive file**; |
| 27 | +.. extract the new version of Kibana into a different directory. See steps below. |
| 28 | +.. migrate any custom configuration from your old kibana.yml to your new one |
| 29 | +.. follow other steps below to complete the new installation |
| 30 | +.. once the new version is fully configured and working with required plugins, remove the previous version of Kibana |
| 31 | +. For Kibana installations using a Linux **package manager**; |
| 32 | +.. uninstall the existing Kibana package `apt-get remove kibana` or `yum remove kibana` |
| 33 | +.. 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.) |
| 34 | + |
| 35 | + |
15 | 36 | [float] |
16 | 37 | [[install]] |
17 | | -=== Install and Start Kibana |
| 38 | +=== Install and Start Kibana from archive file |
18 | 39 |
|
19 | 40 | To get Kibana up and running: |
20 | 41 |
|
21 | 42 | . Download the https://www.elastic.co/downloads/kibana[Kibana {version} binary package] for your platform. |
22 | 43 | . Extract the `.zip` or `tar.gz` archive file. |
23 | | -. After installing, run Kibana from the install directory: `bin/kibana` (Linux/MacOSX) or `bin\kibana.bat` (Windows). |
| 44 | +. If upgrading, copy configuration changes from the previous kibana.yml to the new version. |
| 45 | +. Optionally install Kibana plugins. |
| 46 | +. Run Kibana from the install directory: `bin/kibana` (Linux/MacOSX) or `bin\kibana.bat` (Windows). |
24 | 47 |
|
25 | 48 | On Unix, you can instead run the package manager suited for your distribution. |
26 | 49 |
|
27 | | -//// |
| 50 | + |
28 | 51 | [float] |
29 | 52 | include::kibana-repositories.asciidoc[] |
30 | | -//// |
| 53 | + |
31 | 54 |
|
32 | 55 | That's it! Kibana is now running on port 5601. |
33 | 56 |
|
|
0 commit comments