github-mirrors/kibana
1
0
Fork 0
mirror of https://github.com/elastic/kibana.git synced 2025-04-24 01:38:56 -04:00
Code Issues Projects Releases Packages Wiki Activity

Update failed migration roll back instructions (#135006) (#135419)

Browse source 
(cherry picked from commit d3756a10c1)

Co-authored-by: Rudolf Meijering <skaapgif@gmail.com>
This commit is contained in:
Kibana Machine 2022-06-29 09:03:07 -04:00 • committed by GitHub
parent 216c22c43f
commit ae21d54fff
No known key found for this signature in database
GPG key ID: 4AEE18F83AFDEB23
1 changed files with 13 additions and 8 deletions
Download patch file Download diff file Expand all files Collapse all files

21
docs/setup/upgrade/rollback-migration.asciidoc
View file

@ -10,26 +10,31 @@ WARNING: Before you roll back {kib}, ensure that the version you want to roll ba
your {es} cluster. If the version you want to roll back to is not compatible, you must also rollback {es}.
Any changes made after an upgrade are lost when you roll back to a previous version.
To roll back after a failed upgrade migration, you must also rollback the saved object indices to be compatible with the previous {kib} version.
To roll back after a failed upgrade migration, you must also roll back the {kib} feature state to be compatible with the previous {kib} version.
[float]
==== Roll back by restoring a backup snapshot
==== Roll back by restoring the {kib} feature state from a snapshot
. Before proceeding, {ref}/snapshots-take-snapshot.html[take a snapshot] that contains the `kibana` feature state.
By default, snapshots include the `kibana` feature state.
. To make sure no {kib} instances are performing an upgrade migration, shut down all {kib} instances.
. To delete all saved object indices, enter:
. {ref}/snapshots-restore-snapshot.html[Restore] the `kibana` feature state from a snapshot taken before the failed {kib} upgrade. The following {es} request will only restore the {kib} feature state
+
[source,sh]
--------------------------------------------
DELETE /.kibana*
POST _snapshot/my_repository/my_snapshot_2099.05.06/_restore
{
"indices": "-*", <1>
"feature_states": ["kibana"]
}
--------------------------------------------
. {ref}/snapshots-restore-snapshot.html[Restore] the `kibana` feature state from the snapshot.
<1> Exclude all indices and data streams from the restore operation to ensure that only the {kib} system indices included in the {kib} feature state will be restored.
. Start all {kib} instances on the older version you want to rollback to.
[float]
==== (Not recommended) Roll back without a backup snapshot
==== (Not supported) Roll back without a backup snapshot
WARNING: Rolling back without a backup snapshot is not supported and will be removed in a future version of {kib}.
. To make sure no {kib} instances are performing an upgrade migration, shut down all {kib} instances.
. {ref}/snapshots-take-snapshot.html[Take a snapshot] that includes the `kibana` feature state. By default, snapshots include the `kibana` feature state.
@ -58,7 +63,7 @@ POST /.kibana_3/_aliases/.kibana
+
[source,sh]
--------------------------------------------
PPUT /.kibana,.kibana_task_manager/_settings {"index.blocks.write": false}
PUT /.kibana,.kibana_task_manager/_settings {"index.blocks.write": false}
--------------------------------------------
. Start {kib} on the older version you want to roll back to.