Skip to content

Commit 274355f

Browse files
vishaangelovavishaangelova
authored
[8.18] Add a known issue for Elastic Agents getting stuck in an upgrade scheduled state (#1842)
* Add a known issue for agents getting stuck in a scheduled state
1 parent 626fbe9 commit 274355f

File tree

1 file changed

+193
-0
lines changed

1 file changed

+193
-0
lines changed

‎docs/en/ingest-management/release-notes/release-notes-8.18.asciidoc‎

Lines changed: 193 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -32,6 +32,47 @@ Also see:
3232

3333
Review important information about the 8.18.4 release.
3434

35+
[discrete]
36+
[[known-issues-8.18.4]]
37+
=== Known issues
38+
39+
[[known-issue-2285-8.18.4]]
40+
.{agents} remain in an "Upgrade scheduled" state
41+
[%collapsible]
42+
====
43+
44+
*Details* +
45+
46+
There is a known issue where {agent} remains in an `Upgrade scheduled` state when a scheduled {agent} upgrade is cancelled. Attempting to restart the upgrade on the UI returns an error: `The selected agent is not upgradeable: agent is already being upgraded.`.
47+
48+
*Impact* +
49+
50+
Until this issue is fixed in a later patch version, you can call the https://www.elastic.co/docs/api/doc/kibana/operation/operation-post-fleet-agents-agentid-upgrade[Upgrade an agent] endpoint of the Kibana Fleet API with the `force` parameter set to `true` to force-upgrade the {agent}:
51+
52+
[source,shell]
53+
----
54+
curl --request POST \
55+
--url https://<KIBANA_HOST>/api/fleet/agents/<AGENT_ID>/upgrade \
56+
--user "<SUPERUSER_NAME>:<SUPERUSER_PASSWORD>" \
57+
--header 'Content-Type: application/json' \
58+
--header 'kbn-xsrf: true' \
59+
--data '{"version": "<VERSION>","force": true}'
60+
----
61+
62+
To force-upgrade multiple {agents}, call the https://www.elastic.co/docs/api/doc/kibana/operation/operation-post-fleet-agents-bulk-upgrade[Bulk upgrade agents] endpoint of the Kibana Fleet API with the `force` parameter set to `true`:
63+
64+
[source,shell]
65+
----
66+
curl --request POST \
67+
--url https://<KIBANA_HOST>/api/fleet/agents/bulk_upgrade \
68+
--user "<SUPERUSER_NAME>:<SUPERUSER_PASSWORD>" \
69+
--header 'Content-Type: application/json' \
70+
--header 'kbn-xsrf: true' \
71+
--data '{"version": "<VERSION>","force": true,"agents":["<AGENT_IDS>"]}'
72+
----
73+
74+
====
75+
3576
[discrete]
3677
[[bug-fixes-8.18.4]]
3778
=== Bug fixes
@@ -56,6 +97,47 @@ Fleet::
5697

5798
Review important information about the {fleet} and {agent} 8.18.3 release.
5899

100+
[discrete]
101+
[[known-issues-8.18.3]]
102+
=== Known issues
103+
104+
[[known-issue-2285-8.18.3]]
105+
.{agents} remain in an "Upgrade scheduled" state
106+
[%collapsible]
107+
====
108+
109+
*Details* +
110+
111+
There is a known issue where {agent} remains in an `Upgrade scheduled` state when a scheduled {agent} upgrade is cancelled. Attempting to restart the upgrade on the UI returns an error: `The selected agent is not upgradeable: agent is already being upgraded.`.
112+
113+
*Impact* +
114+
115+
Until this issue is fixed in a later patch version, you can call the https://www.elastic.co/docs/api/doc/kibana/operation/operation-post-fleet-agents-agentid-upgrade[Upgrade an agent] endpoint of the Kibana Fleet API with the `force` parameter set to `true` to force-upgrade the {agent}:
116+
117+
[source,shell]
118+
----
119+
curl --request POST \
120+
--url https://<KIBANA_HOST>/api/fleet/agents/<AGENT_ID>/upgrade \
121+
--user "<SUPERUSER_NAME>:<SUPERUSER_PASSWORD>" \
122+
--header 'Content-Type: application/json' \
123+
--header 'kbn-xsrf: true' \
124+
--data '{"version": "<VERSION>","force": true}'
125+
----
126+
127+
To force-upgrade multiple {agents}, call the https://www.elastic.co/docs/api/doc/kibana/operation/operation-post-fleet-agents-bulk-upgrade[Bulk upgrade agents] endpoint of the Kibana Fleet API with the `force` parameter set to `true`:
128+
129+
[source,shell]
130+
----
131+
curl --request POST \
132+
--url https://<KIBANA_HOST>/api/fleet/agents/bulk_upgrade \
133+
--user "<SUPERUSER_NAME>:<SUPERUSER_PASSWORD>" \
134+
--header 'Content-Type: application/json' \
135+
--header 'kbn-xsrf: true' \
136+
--data '{"version": "<VERSION>","force": true,"agents":["<AGENT_IDS>"]}'
137+
----
138+
139+
====
140+
59141
[discrete]
60142
[[new-features-8.18.3]]
61143
=== New features
@@ -129,6 +211,43 @@ After the output confirms all files were successfully processed, run the `enroll
129211
130212
====
131213

214+
[[known-issue-2285-8.18.2]]
215+
.{agents} remain in an "Upgrade scheduled" state
216+
[%collapsible]
217+
====
218+
219+
*Details* +
220+
221+
There is a known issue where {agent} remains in an `Upgrade scheduled` state when a scheduled {agent} upgrade is cancelled. Attempting to restart the upgrade on the UI returns an error: `The selected agent is not upgradeable: agent is already being upgraded.`.
222+
223+
*Impact* +
224+
225+
Until this issue is fixed in a later patch version, you can call the https://www.elastic.co/docs/api/doc/kibana/operation/operation-post-fleet-agents-agentid-upgrade[Upgrade an agent] endpoint of the Kibana Fleet API with the `force` parameter set to `true` to force-upgrade the {agent}:
226+
227+
[source,shell]
228+
----
229+
curl --request POST \
230+
--url https://<KIBANA_HOST>/api/fleet/agents/<AGENT_ID>/upgrade \
231+
--user "<SUPERUSER_NAME>:<SUPERUSER_PASSWORD>" \
232+
--header 'Content-Type: application/json' \
233+
--header 'kbn-xsrf: true' \
234+
--data '{"version": "<VERSION>","force": true}'
235+
----
236+
237+
To force-upgrade multiple {agents}, call the https://www.elastic.co/docs/api/doc/kibana/operation/operation-post-fleet-agents-bulk-upgrade[Bulk upgrade agents] endpoint of the Kibana Fleet API with the `force` parameter set to `true`:
238+
239+
[source,shell]
240+
----
241+
curl --request POST \
242+
--url https://<KIBANA_HOST>/api/fleet/agents/bulk_upgrade \
243+
--user "<SUPERUSER_NAME>:<SUPERUSER_PASSWORD>" \
244+
--header 'Content-Type: application/json' \
245+
--header 'kbn-xsrf: true' \
246+
--data '{"version": "<VERSION>","force": true,"agents":["<AGENT_IDS>"]}'
247+
----
248+
249+
====
250+
132251
// end 8.18.2 relnotes
133252

134253
// begin 8.18.1 relnotes
@@ -167,6 +286,43 @@ After the output confirms all files were successfully processed, run the `enroll
167286
168287
====
169288

289+
[[known-issue-2285-8.18.1]]
290+
.{agents} remain in an "Upgrade scheduled" state
291+
[%collapsible]
292+
====
293+
294+
*Details* +
295+
296+
There is a known issue where {agent} remains in an `Upgrade scheduled` state when a scheduled {agent} upgrade is cancelled. Attempting to restart the upgrade on the UI returns an error: `The selected agent is not upgradeable: agent is already being upgraded.`.
297+
298+
*Impact* +
299+
300+
Until this issue is fixed in a later patch version, you can call the https://www.elastic.co/docs/api/doc/kibana/operation/operation-post-fleet-agents-agentid-upgrade[Upgrade an agent] endpoint of the Kibana Fleet API with the `force` parameter set to `true` to force-upgrade the {agent}:
301+
302+
[source,shell]
303+
----
304+
curl --request POST \
305+
--url https://<KIBANA_HOST>/api/fleet/agents/<AGENT_ID>/upgrade \
306+
--user "<SUPERUSER_NAME>:<SUPERUSER_PASSWORD>" \
307+
--header 'Content-Type: application/json' \
308+
--header 'kbn-xsrf: true' \
309+
--data '{"version": "<VERSION>","force": true}'
310+
----
311+
312+
To force-upgrade multiple {agents}, call the https://www.elastic.co/docs/api/doc/kibana/operation/operation-post-fleet-agents-bulk-upgrade[Bulk upgrade agents] endpoint of the Kibana Fleet API with the `force` parameter set to `true`:
313+
314+
[source,shell]
315+
----
316+
curl --request POST \
317+
--url https://<KIBANA_HOST>/api/fleet/agents/bulk_upgrade \
318+
--user "<SUPERUSER_NAME>:<SUPERUSER_PASSWORD>" \
319+
--header 'Content-Type: application/json' \
320+
--header 'kbn-xsrf: true' \
321+
--data '{"version": "<VERSION>","force": true,"agents":["<AGENT_IDS>"]}'
322+
----
323+
324+
====
325+
170326
[discrete]
171327
[[bug-fixes-8.18.1]]
172328
=== Bug fixes
@@ -235,6 +391,43 @@ After the output confirms all files were successfully processed, run the `enroll
235391
236392
====
237393

394+
[[known-issue-2285-8.18.0]]
395+
.{agents} remain in an "Upgrade scheduled" state
396+
[%collapsible]
397+
====
398+
399+
*Details* +
400+
401+
There is a known issue where {agent} remains in an `Upgrade scheduled` state when a scheduled {agent} upgrade is cancelled. Attempting to restart the upgrade on the UI returns an error: `The selected agent is not upgradeable: agent is already being upgraded.`.
402+
403+
*Impact* +
404+
405+
Until this issue is fixed in a later patch version, you can call the https://www.elastic.co/docs/api/doc/kibana/operation/operation-post-fleet-agents-agentid-upgrade[Upgrade an agent] endpoint of the Kibana Fleet API with the `force` parameter set to `true` to force-upgrade the {agent}:
406+
407+
[source,shell]
408+
----
409+
curl --request POST \
410+
--url https://<KIBANA_HOST>/api/fleet/agents/<AGENT_ID>/upgrade \
411+
--user "<SUPERUSER_NAME>:<SUPERUSER_PASSWORD>" \
412+
--header 'Content-Type: application/json' \
413+
--header 'kbn-xsrf: true' \
414+
--data '{"version": "<VERSION>","force": true}'
415+
----
416+
417+
To force-upgrade multiple {agents}, call the https://www.elastic.co/docs/api/doc/kibana/operation/operation-post-fleet-agents-bulk-upgrade[Bulk upgrade agents] endpoint of the Kibana Fleet API with the `force` parameter set to `true`:
418+
419+
[source,shell]
420+
----
421+
curl --request POST \
422+
--url https://<KIBANA_HOST>/api/fleet/agents/bulk_upgrade \
423+
--user "<SUPERUSER_NAME>:<SUPERUSER_PASSWORD>" \
424+
--header 'Content-Type: application/json' \
425+
--header 'kbn-xsrf: true' \
426+
--data '{"version": "<VERSION>","force": true,"agents":["<AGENT_IDS>"]}'
427+
----
428+
429+
====
430+
238431
[discrete]
239432
[[new-features-8.18.0]]
240433
=== New features

0 commit comments

Comments
 (0)