55 lines
2.3 KiB
Plaintext
55 lines
2.3 KiB
Plaintext
[[upgrade-standard]]
|
|
=== Standard Upgrade
|
|
|
|
A standard upgrade is the most straightforward way to upgrade Kibana, and it's
|
|
possible when you're upgrading from Kibana version 4.2 or higher.
|
|
|
|
If you haven't already, consult this <<upgrade,table>> to verify that standard
|
|
upgrade is supported for your version of Kibana.
|
|
|
|
NOTE: If you've saved and/or exported objects in Kibana that rely on the
|
|
<<search,Elasticsearch Query DSL>>, make sure to check the Elasticsearch
|
|
{ref}/breaking-changes.html[breaking changes] documentation and take the
|
|
necessary remediation steps as per those instructions.
|
|
|
|
[float]
|
|
==== Upgrading using a `deb` or `rpm` package
|
|
|
|
. Stop the existing Kibana process using the appropriate command for your
|
|
system.
|
|
. Use `rpm` or `dpkg` to install the new package. All files should be placed in
|
|
their proper locations and config files should not be overwritten.
|
|
+
|
|
[NOTE]
|
|
--
|
|
Kibana 4.x used a different config location than 5.0+, so if you're upgrading
|
|
from 4.x, you will need to copy the configurations from your old config
|
|
(`/opt/kibana/config/kibana.yml`) to your new config
|
|
(`/etc/kibana/kibana.yml`).
|
|
|
|
Make sure you remove or update any configurations
|
|
that are indicated in the <<breaking-changes,breaking changes>> documentation
|
|
otherwise Kibana will fail to start.
|
|
--
|
|
. Upgrade any plugins by removing the existing plugin and reinstalling the
|
|
appropriate version using the `kibana-plugin` script. Check out the
|
|
<<kibana-plugins,plugins>> documentation for more information.
|
|
. Start the new Kibana process using the appropriate command for your system.
|
|
|
|
[float]
|
|
==== Upgrading using a `zip` or `tar.gz` archive
|
|
|
|
. Extract the `zip` or `tar.gz` archive to a new directory to be sure that you
|
|
don't overwrite the `config` or `data` directories.
|
|
. Copy the files from the `config` directory from your old installation to your
|
|
new installation. Make sure you remove or update any configurations that are
|
|
indicated in the <<breaking-changes,breaking changes>> documentation
|
|
otherwise Kibana will fail to start.
|
|
. Copy the files from the `data` directory from your old installation to your
|
|
new installation.
|
|
. Install the appropriate versions of all your plugins for your new
|
|
installation using the `kibana-plugin` script. Check out the
|
|
<<kibana-plugins,plugins>> documentation for more information.
|
|
. Stop the old Kibana process.
|
|
. Start the new Kibana process.
|