6.7 includes an to help you prepare for your upgrade to 7.0. To access the assistant, go to Management > 7.0 Upgrade Assistant.

    How the process works

    Saved objects are stored in an index named .kibana_N, where N is a number that increments over time as Kibana is upgraded. The index alias .kibana points to the latest up-to-date index for a given install.

    Prior to 6.5.0, saved objects were stored directly in an index named .kibana, so the first time you upgrade to Kibana version 6.5+, Kibana will migrate into .kibana_1 and set up as an index alias.

    When changes are necessary, a new incremental .kibana_N index is created with updated mappings, then the saved objects are loaded in batches from the existing index, transformed to whatever extent necessary, and added to this new index.

    Once the objects are migrated, the .kibana index alias is updated to point to the new index, and Kibana finishes starting up and serving HTTP traffic.

    Handling old .kibana indices

    After migrations have run, there will be multiple Kibana indices in Elasticsearch: (.kibana_1, .kibana_2, etc). Kibana only uses the index that the alias points to. The other Kibana indices can be safely deleted, but are left around as a matter of historical record, and to facilitate rolling Kibana back to a previous version.

    Handling errors during saved object migrations

    For example, if the .kibana alias is pointing to .kibana_4, and there is a .kibana_5 index in Elasticsearch, the .kibana_5 index will need to be deleted. Kibana will never attempt to overwrite an existing index.

    Support for multiple Kibana instances

    If you’re running multiple Kibana instances for a single index behind a load balancer, it’s important that you stop all instances before upgrading, so you do not have multiple different versions of Kibana trying to perform saved object migrations.

    The first instance that triggers saved object migrations will run the entire process. Any other instances started up while a migration is running will log a message and then wait until saved object migration has completed before they start serving HTTP traffic.

    Rolling back to a previous version of Kibana

    Rolling back to a previous Kibana version can result in saved object data loss if you had successfully upgraded and made changes to saved objects before rolling back.