Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Fix known issue for stuck upgrade in 8.12.1 release notes #918

Merged
merged 1 commit into from
Feb 14, 2024
Merged

Fix known issue for stuck upgrade in 8.12.1 release notes #918

Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
60 changes: 45 additions & 15 deletions docs/en/ingest-management/release-notes/release-notes-8.12.asciidoc
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -147,32 +147,60 @@ An issue discovered in {fleet-server} prevents {agents} that have been upgraded

*Impact* +

As a workaround, we recommend you to use the {kib} {fleet} API to upgrade these agents using the `force` flag.
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.

To upgrade a single {agent}:
[source,"shell"]
----
POST _security/role/fleet_superuser
{
"indices": [
{
"names": [".fleet*",".kibana*"],
"privileges": ["all"],
"allow_restricted_indices": true
}
]
}
----

[source,"shell"]
----
POST kbn:/api/fleet/agents/<agent_id>/upgrade
{
"version": "8.12.1",
"force": true
}
POST _security/user/fleet_superuser
{
"password": "password",
"roles": ["superuser", "fleet_superuser"]
}
----

To bulk upgrade a set of {agents}:
[source,"shell"]
----
curl -sk -XPOST --user fleet_superuser:password -H 'content-type:application/json' \
-H'x-elastic-product-origin:fleet' \
http://localhost:9200/.fleet-agents/_update_by_query \
-d '{
"script": {
"source": "ctx._source.remove(\"upgrade_details\")",
"lang": "painless"
},
"query": {
"bool": {
"must_not": {
"exists": {
"field": "upgrade_details"
}
}
}
}
}'
----

[source,"shell"]
----
POST kbn:/api/fleet/agents/bulk_upgrade
{
"agents": "agent.version:8.12.0",
"version": "8.12.1",
"force": true
}
DELETE _security/user/fleet_superuser
DELETE _security/role/fleet_superuser
----

This issue is planned to be fixed in versions 8.12.2 and 8.13.0.
After running these API requests, wait at least 10 minutes, and then the agents should be upgradeable again.

====

Expand Down Expand Up @@ -514,6 +542,8 @@ curl -sk -XPOST --user fleet_superuser:password -H 'content-type:application/jso
DELETE _security/user/fleet_superuser
DELETE _security/role/fleet_superuser
----

After running these API requests, wait at least 10 minutes, and then the agents should be upgradeable again.
====

[discrete]
Expand Down