You're viewing version 2.13 of the OpenSearch documentation. This version is no longer maintained. For the latest version, see the current documentation. For information about OpenSearch version maintenance, see Release Schedule and Maintenance Policy.
Migrating from Kibana OSS to OpenSearch Dashboards
Kibana OSS stores its visualizations and dashboards in one or more indexes (.kibana*
) on the Elasticsearch OSS cluster. As such, the most important step is to leave those indexes intact as you migrate from Elasticsearch OSS to OpenSearch.
Consider exporting all Kibana objects prior to starting the migration. In Kibana, choose Stack Management, Saved Objects, Export objects.
-
After you migrate your Elasticsearch OSS cluster to OpenSearch, stop Kibana.
-
For safety, make a backup copy of
<kibana-dir>/config/kibana.yml
. -
Extract the OpenSearch Dashboards tarball to a new directory.
-
Port your settings from
<kibana-dir>/config/kibana.yml
to<dashboards-dir>/config/opensearch_dashboards.yml
.In general, settings with
elasticsearch
in their names map toopensearch
(for example,elasticsearch.shardTimeout
andopensearch.shardTimeout
) and settings withkibana
in their names map toopensearchDashboards
(for example,kibana.defaultAppId
andopensearchDashboards.defaultAppId
). Most other settings use the same names.For a full list of OpenSearch Dashboards settings, see opensearch_dashboards.yml.
-
If your OpenSearch cluster uses the Security plugin, preserve and modify the default settings in
opensearch_dashboards.yml
, particularlyopensearch.username
andopensearch.password
.If you disabled the Security plugin on your OpenSearch cluster, remove or comment out all
opensearch_security
settings. Then runrm -rf plugins/security-dashboards/
to remove the Security plugin. -
Start OpenSearch Dashboards:
./bin/opensearch-dashboards
-
Log in, and verify that your saved searches, visualizations, and dashboards are present.