Skip to content

Commit 702480f

Browse files
authoredMay 4, 2023
Add known issue for agent 8.6.2 about not migrating unencrypted config (#195)
* Add known issue for agent 8.6.x about not migrating unencrypted config
1 parent bd13c36 commit 702480f

File tree

1 file changed

+62
-0
lines changed

1 file changed

+62
-0
lines changed
 

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

+62
Original file line numberDiff line numberDiff line change
@@ -116,6 +116,26 @@ Custom yaml settings are silently ignored by {fleet}.
116116
Settings with input blocks, such as Max agents are still effective.
117117
====
118118

119+
[[known-issue-issue-2249-8.6.2]]
120+
.{agent} does not load {fleet} configuration when upgrading to {agent} version 8.6.x from version 8.2.x or earlier.
121+
[%collapsible]
122+
====
123+
*Details* +
124+
{agent} will not load `fleet.yml` information after upgrading to {agent} version 8.6.x from version 8.2.x or earlier
125+
This is due to the unencrypted config stored in `fleet.yml` not being migrated correctly to the encrypted config store `fleet.enc`.
126+
For a managed agent the symptom manifests as the inability to connect to {fleet} after upgrade with the following log:
127+
128+
[source,shell]
129+
----
130+
Error: fleet configuration is invalid: empty access token
131+
...
132+
----
133+
For more information refer to {agent-issue}2249[#2249].
134+
135+
*Impact* +
136+
{agent} loses the ability to connect back to {fleet} after upgrade.
137+
Fix for this issue is available in version 8.7.0 and higher, for version 8.6 a re-enroll is necessary for the agent to connect back to {fleet}
138+
====
119139

120140
[discrete]
121141
[[enhancements-8.6.2]]
@@ -305,6 +325,27 @@ Custom yaml settings are silently ignored by {fleet}.
305325
Settings with input blocks, such as Max agents are still effective.
306326
====
307327

328+
[[known-issue-issue-2249-8.6.1]]
329+
.{agent} does not load {fleet} configuration when upgrading to {agent} version 8.6.x from version 8.2.x or earlier.
330+
[%collapsible]
331+
====
332+
*Details* +
333+
{agent} will not load `fleet.yml` information after upgrading to {agent} version 8.6.x from version 8.2.x or earlier
334+
This is due to the unencrypted config stored in `fleet.yml` not being migrated correctly to the encrypted config store `fleet.enc`.
335+
For a managed agent the symptom manifests as the inability to connect to {fleet} after upgrade with the following log:
336+
337+
[source,shell]
338+
----
339+
Error: fleet configuration is invalid: empty access token
340+
...
341+
----
342+
For more information refer to {agent-issue}2249[#2249].
343+
344+
*Impact* +
345+
{agent} loses the ability to connect back to {fleet} after upgrade.
346+
Fix for this issue is available in version 8.7.0 and higher, for version 8.6 a re-enroll is necessary for the agent to connect back to {fleet}
347+
====
348+
308349
[discrete]
309350
[[bug-fixes-8.6.1]]
310351
=== Bug fixes
@@ -463,6 +504,27 @@ Custom yaml settings are silently ignored by {fleet}.
463504
Settings with input blocks, such as Max agents are still effective.
464505
====
465506

507+
[[known-issue-issue-2249-8.6.0]]
508+
.{agent} does not load {fleet} configuration when upgrading to {agent} version 8.6.x from version 8.2.x or earlier.
509+
[%collapsible]
510+
====
511+
*Details* +
512+
{agent} will not load `fleet.yml` information after upgrading to {agent} version 8.6.x from version 8.2.x or earlier
513+
This is due to the unencrypted config stored in `fleet.yml` not being migrated correctly to the encrypted config store `fleet.enc`.
514+
For a managed agent the symptom manifests as the inability to connect to {fleet} after upgrade with the following log:
515+
516+
[source,shell]
517+
----
518+
Error: fleet configuration is invalid: empty access token
519+
...
520+
----
521+
For more information refer to {agent-issue}2249[#2249].
522+
523+
*Impact* +
524+
{agent} loses the ability to connect back to {fleet} after upgrade.
525+
Fix for this issue is available in version 8.7.0 and higher, for version 8.6 a re-enroll is necessary for the agent to connect back to {fleet}
526+
====
527+
466528
[discrete]
467529
[[new-features-8.6.0]]
468530
=== New features

0 commit comments

Comments
 (0)