diff --git a/docs/setup/upgrade/resolving-migration-failures.asciidoc b/docs/setup/upgrade/resolving-migration-failures.asciidoc index e21368e5bc289..4d181c3e7ae39 100644 --- a/docs/setup/upgrade/resolving-migration-failures.asciidoc +++ b/docs/setup/upgrade/resolving-migration-failures.asciidoc @@ -62,6 +62,37 @@ Unable to migrate the corrupt saved object document with _id: 'marketing_space:d To delete the documents that cause migrations to fail, take the following steps: +. Create a role as follows: ++ +[source,sh] +-------------------------------------------- +PUT _security/role/grant_kibana_system_indices +{ + "indices": [ + { + "names": [ + ".kibana*" + ], + "privileges": [ + "all" + ], + "allow_restricted_indices": true + } + ] +} +-------------------------------------------- + +. Create a user with the role above and `superuser` built-in role: ++ +[source,sh] +-------------------------------------------- +POST /_security/user/temporarykibanasuperuser +{ + "password" : "l0ng-r4nd0m-p@ssw0rd", + "roles" : [ "superuser", "grant_kibana_system_indices" ] +} +-------------------------------------------- + . Remove the write block which the migration system has placed on the previous index: + [source,sh]