Skip to content

Commit cffb37b

Browse files
committed
Fix workaround steps
1 parent 7b96040 commit cffb37b

File tree

1 file changed

+44
-17
lines changed

1 file changed

+44
-17
lines changed

docs/en/ingest-management/release-notes/release-notes-8.12.asciidoc

+44-17
Original file line numberDiff line numberDiff line change
@@ -458,35 +458,62 @@ Note that according to our <<agent-policy-scaling-recommendations,policy scaling
458458
459459
An issue discovered in {fleet-server} prevents {agents} that have been upgraded to version 8.12.0 from being upgraded again, using the {fleet} UI, to version 8.12.1 or higher.
460460
461+
This issue is planned to be fixed in versions 8.12.2 and 8.13.0.
462+
461463
*Impact* +
462464
463-
As a workaround, we recommend you to use the {kib} {fleet} API to upgrade these agents using the `force` flag.
464-
465-
To upgrade a single {agent}:
465+
As a workaround, we recommend you to use the {kib} {fleet} API to update any documents in which `upgrade_details` is either `null` or not defined. Note that these steps must be run as a superuser.
466466
467467
[source,"shell"]
468468
----
469-
POST kbn:/api/fleet/agents/<agent_id>/upgrade
470-
{
471-
"version": "8.12.1",
472-
"force": true
473-
}
469+
POST _security/role/fleet_superuser
470+
{
471+
"indices": [
472+
{
473+
"names": [".fleet*",".kibana*"],
474+
"privileges": ["all"],
475+
"allow_restricted_indices": true
476+
}
477+
]
478+
}
474479
----
475480
476-
To bulk upgrade a set of {agents}:
477-
478481
[source,"shell"]
479482
----
480-
POST kbn:/api/fleet/agents/bulk_upgrade
481-
{
482-
"agents": "agent.version:8.12.0",
483-
"version": "8.12.1",
484-
"force": true
485-
}
483+
POST _security/user/fleet_superuser
484+
{
485+
"password": "password",
486+
"roles": ["superuser", "fleet_superuser"]
487+
}
486488
----
487489
488-
This issue is planned to be fixed in versions 8.12.2 and 8.13.0.
490+
[source,"shell"]
491+
----
492+
curl -sk -XPOST --user fleet_superuser:password -H 'content-type:application/json' \
493+
-H'x-elastic-product-origin:fleet' \
494+
http://localhost:9200/.fleet-agents/_update_by_query \
495+
-d '{
496+
"script": {
497+
"source": "ctx._source.remove(\"upgrade_details\")",
498+
"lang": "painless"
499+
},
500+
"query": {
501+
"bool": {
502+
"must_not": {
503+
"exists": {
504+
"field": "upgrade_details"
505+
}
506+
}
507+
}
508+
}
509+
}'
510+
----
489511
512+
[source,"shell"]
513+
----
514+
DELETE _security/user/fleet_superuser
515+
DELETE _security/role/fleet_superuser
516+
----
490517
====
491518

492519
[discrete]

0 commit comments

Comments
 (0)