From de55f8e785f7bf01f044cf148f1e090f6005f5ac Mon Sep 17 00:00:00 2001 From: Visha Angelova <91186315+vishaangelova@users.noreply.github.com> Date: Tue, 3 Jun 2025 23:08:40 +0200 Subject: [PATCH 1/2] Add known issue for Elastic Agent failing to enroll into Fleet (#1801) * Add known issue for Elastic Agent failing to enroll into Fleet --------- Co-authored-by: Colleen McGinnis (cherry picked from commit 26b645bb6cc516d24bf689e781d33e27e8f94cfd) # Conflicts: # docs/en/ingest-management/release-notes/release-notes-8.18.asciidoc --- .../release-notes/release-notes-8.17.asciidoc | 201 +++++++++- .../release-notes/release-notes-8.18.asciidoc | 375 ++++++++++++++++++ 2 files changed, 568 insertions(+), 8 deletions(-) create mode 100644 docs/en/ingest-management/release-notes/release-notes-8.18.asciidoc diff --git a/docs/en/ingest-management/release-notes/release-notes-8.17.asciidoc b/docs/en/ingest-management/release-notes/release-notes-8.17.asciidoc index 02b43adcb..1c3d670c3 100644 --- a/docs/en/ingest-management/release-notes/release-notes-8.17.asciidoc +++ b/docs/en/ingest-management/release-notes/release-notes-8.17.asciidoc @@ -14,6 +14,7 @@ This section summarizes the changes in each release. +* <> * <> * <> * <> @@ -40,6 +41,34 @@ Review important information about the 8.17.7 release. * Upgrade Go version to v1.24.3 in {{agent}}. {agent-pull}8109[https://github.com/elastic/elastic-agent/pull/8109] +[discrete] +[[known-issues-8.17.7]] +=== Known issues + +[[known-issue-1800-8-17-7]] +.On Windows, {agent} is unable to re-enroll into {fleet} +[%collapsible] +==== + +*Details* + +There is a known issue where an {agent} installed on Windows and previously enrolled into {fleet} is unable to re-enroll. Attempting to enroll the {agent} fails with the following error: + +[source,shell] +---- +Error: the command is executed as root but the program files are not owned by the root user. +---- + +*Impact* + +The issue affects {agent} installed on Windows. Until a bug fix is available in a later release, you can temporarily resolve the issue by changing the ownership of the {agent} directory: + +[source,shell] +---- +icacls "C:\Program Files\Elastic\Agent" /setowner "NT AUTHORITY\SYSTEM" /t /l +---- + +After the output confirms all files were successfully processed, run the `enroll` command again. + +==== [discrete] [[bug-fixes-8.17.7]] @@ -56,6 +85,35 @@ Review important information about the 8.17.7 release. Review important information about the 8.17.6 release. +[discrete] +[[known-issues-8.17.6]] +=== Known issues + +[[known-issue-1800-8-17-6]] +.On Windows, {agent} is unable to re-enroll into {fleet} +[%collapsible] +==== + +*Details* + +There is a known issue where an {agent} installed on Windows and previously enrolled into {fleet} is unable to re-enroll. Attempting to enroll the {agent} fails with the following error: + +[source,shell] +---- +Error: the command is executed as root but the program files are not owned by the root user. +---- + +*Impact* + +The issue affects {agent} installed on Windows. Until a bug fix is available in a later release, you can temporarily resolve the issue by changing the ownership of the {agent} directory: + +[source,shell] +---- +icacls "C:\Program Files\Elastic\Agent" /setowner "NT AUTHORITY\SYSTEM" /t /l +---- + +After the output confirms all files were successfully processed, run the `enroll` command again. + +==== + [discrete] [[enhancements-8.17.6]] === Enhancements @@ -65,9 +123,6 @@ Review important information about the 8.17.6 release. // end 8.17.6 relnotes - - - // begin 8.17.5 relnotes [[release-notes-8.17.5]] @@ -75,6 +130,35 @@ Review important information about the 8.17.6 release. Review important information about the 8.17.5 release. +[discrete] +[[known-issues-8.17.5]] +=== Known issues + +[[known-issue-1800-8-17-5]] +.On Windows, {agent} is unable to re-enroll into {fleet} +[%collapsible] +==== + +*Details* + +There is a known issue where an {agent} installed on Windows and previously enrolled into {fleet} is unable to re-enroll. Attempting to enroll the {agent} fails with the following error: + +[source,shell] +---- +Error: the command is executed as root but the program files are not owned by the root user. +---- + +*Impact* + +The issue affects {agent} installed on Windows. Until a bug fix is available in a later release, you can temporarily resolve the issue by changing the ownership of the {agent} directory: + +[source,shell] +---- +icacls "C:\Program Files\Elastic\Agent" /setowner "NT AUTHORITY\SYSTEM" /t /l +---- + +After the output confirms all files were successfully processed, run the `enroll` command again. + +==== + [discrete] [[enhancements-8.17.5]] === Enhancements @@ -102,8 +186,6 @@ Review important information about the 8.17.5 release. // end 8.17.5 relnotes - - // begin 8.17.4 relnotes [[release-notes-8.17.4]] @@ -138,6 +220,31 @@ In the 9.x releases, the option that appears in the UI for an upgrade across a m ==== +[[known-issue-1800-8-17-4]] +.On Windows, {agent} is unable to re-enroll into {fleet} +[%collapsible] +==== + +*Details* + +There is a known issue where an {agent} installed on Windows and previously enrolled into {fleet} is unable to re-enroll. Attempting to enroll the {agent} fails with the following error: + +[source,shell] +---- +Error: the command is executed as root but the program files are not owned by the root user. +---- + +*Impact* + +The issue affects {agent} installed on Windows. Until a bug fix is available in a later release, you can temporarily resolve the issue by changing the ownership of the {agent} directory: + +[source,shell] +---- +icacls "C:\Program Files\Elastic\Agent" /setowner "NT AUTHORITY\SYSTEM" /t /l +---- + +After the output confirms all files were successfully processed, run the `enroll` command again. + +==== + [discrete] [[new-features-8.17.4]] === New features @@ -209,6 +316,31 @@ In the 9.x releases, the option that appears in the UI for an upgrade across a m ==== +[[known-issue-1800-8-17-3]] +.On Windows, {agent} is unable to re-enroll into {fleet} +[%collapsible] +==== + +*Details* + +There is a known issue where an {agent} installed on Windows and previously enrolled into {fleet} is unable to re-enroll. Attempting to enroll the {agent} fails with the following error: + +[source,shell] +---- +Error: the command is executed as root but the program files are not owned by the root user. +---- + +*Impact* + +The issue affects {agent} installed on Windows. Until a bug fix is available in a later release, you can temporarily resolve the issue by changing the ownership of the {agent} directory: + +[source,shell] +---- +icacls "C:\Program Files\Elastic\Agent" /setowner "NT AUTHORITY\SYSTEM" /t /l +---- + +After the output confirms all files were successfully processed, run the `enroll` command again. + +==== + [discrete] [[enhancements-8.17.3]] === Enhancements @@ -240,6 +372,34 @@ Review important information about the {fleet} and {agent} 8.17.2 release. {fleet-server}:: * Upgrade `golang.org/x/net` to v0.34.0 and `golang.org/x/crypto` to v0.32.0. {fleet-server-pull}4405[#4405] +[discrete] +[[known-issues-8.17.2]] +=== Known issues + +[[known-issue-1800-8-17-2]] +.On Windows, {agent} is unable to re-enroll into {fleet} +[%collapsible] +==== + +*Details* + +There is a known issue where an {agent} installed on Windows and previously enrolled into {fleet} is unable to re-enroll. Attempting to enroll the {agent} fails with the following error: + +[source,shell] +---- +Error: the command is executed as root but the program files are not owned by the root user. +---- + +*Impact* + +The issue affects {agent} installed on Windows. Until a bug fix is available in a later release, you can temporarily resolve the issue by changing the ownership of the {agent} directory: + +[source,shell] +---- +icacls "C:\Program Files\Elastic\Agent" /setowner "NT AUTHORITY\SYSTEM" /t /l +---- + +After the output confirms all files were successfully processed, run the `enroll` command again. + +==== [discrete] [[enhancements-8.17.2]] @@ -296,6 +456,31 @@ As a workaround, you can upgrade your deployment to 8.17.1 in which this issue h ==== +[[known-issue-1800-8-17-1]] +.On Windows, {agent} is unable to re-enroll into {fleet} +[%collapsible] +==== + +*Details* + +There is a known issue where an {agent} installed on Windows and previously enrolled into {fleet} is unable to re-enroll. Attempting to enroll the {agent} fails with the following error: + +[source,shell] +---- +Error: the command is executed as root but the program files are not owned by the root user. +---- + +*Impact* + +The issue affects {agent} installed on Windows. Until a bug fix is available in a later release, you can temporarily resolve the issue by changing the ownership of the {agent} directory: + +[source,shell] +---- +icacls "C:\Program Files\Elastic\Agent" /setowner "NT AUTHORITY\SYSTEM" /t /l +---- + +After the output confirms all files were successfully processed, run the `enroll` command again. + +==== + [discrete] [[new-features-8.17.1]] === New features @@ -320,7 +505,7 @@ The 8.17.1 release added the following new and notable features. {fleet-server}:: * Do not set the `unenrolled_at` attribute when the audit/unenroll API is called. {fleet-server-pull}4221[#4221] {agent-issue}6213[#6213] -* Remove PGP endpoint auth requirement so that air-gapped {agents} can retreive a PGP key from {fleet-server}. {fleet-server-pull}4256[#4256] {fleet-server-issue}4255[#4255] +* Remove PGP endpoint auth requirement so that air-gapped {agents} can retrieve a PGP key from {fleet-server}. {fleet-server-pull}4256[#4256] {fleet-server-issue}4255[#4255] {agent}:: * During uninstall, call the audit or unenroll API before components are stopped, if {agent} is running a {fleet-server} instance. {agent-pull}6085[#6085] {agent-issue}5752[#5752] @@ -357,12 +542,12 @@ impact to your application. [%collapsible] ==== *Details* + -A known issue in the {agent} may prevent it from being targetted with an upgrade action for a future release. +A known issue in the {agent} may prevent it from being targeted with an upgrade action for a future release. This may occur if the Defend integration is used and the agent is stopped on a running instance for too long. An agent may be stopped as part of an upgrade process. *Impact* + -A bug fix is present in the 8.17.1 release of {fleet} that will prevent this from occuring. +A bug fix is present in the 8.17.1 release of {fleet} that will prevent this from occurring. If you have agents that are affected, the workaround is as follows: [source,shell] diff --git a/docs/en/ingest-management/release-notes/release-notes-8.18.asciidoc b/docs/en/ingest-management/release-notes/release-notes-8.18.asciidoc new file mode 100644 index 000000000..3a9503f53 --- /dev/null +++ b/docs/en/ingest-management/release-notes/release-notes-8.18.asciidoc @@ -0,0 +1,375 @@ +// Use these for links to issue and pulls. +:kibana-issue: https://github.com/elastic/kibana/issues/ +:kibana-pull: https://github.com/elastic/kibana/pull/ +:beats-issue: https://github.com/elastic/beats/issues/ +:beats-pull: https://github.com/elastic/beats/pull/ +:agent-libs-pull: https://github.com/elastic/elastic-agent-libs/pull/ +:agent-issue: https://github.com/elastic/elastic-agent/issues/ +:agent-pull: https://github.com/elastic/elastic-agent/pull/ +:fleet-server-issue: https://github.com/elastic/fleet-server/issues/ +:fleet-server-pull: https://github.com/elastic/fleet-server/pull/ + +[[release-notes]] += Release notes + +This section summarizes the changes in each release. + +* <> +* <> +* <> + +Also see: + +* {kibana-ref}/release-notes.html[{kib} release notes] +* {beats-ref}/release-notes.html[{beats} release notes] + +// begin 8.18.2 relnotes + +[[release-notes-8.18.2]] +== {fleet} and {agent} 8.18.2 + +Review important information about the 8.18.2 release. + +[discrete] +[[security-updates-8.18.2]] +=== Security updates + +{agent}:: +* Update Go version to v1.24.3 {agent-pull}8109[#8109] + +{fleet}:: +* Update Go version to v1.24.3 {fleet-server-pull}4891[#4891] + +[discrete] +[[known-issues-8.18.2]] +=== Known issues + +[[known-issue-1800-8-18-2]] +.On Windows, {agent} is unable to re-enroll into {fleet} +[%collapsible] +==== + +*Details* + +There is a known issue where an {agent} installed on Windows and previously enrolled into {fleet} is unable to re-enroll. Attempting to enroll the {agent} fails with the following error: + +[source,shell] +---- +Error: the command is executed as root but the program files are not owned by the root user. +---- + +*Impact* + +The issue affects {agent} installed on Windows. Until a bug fix is available in a later release, you can temporarily resolve the issue by changing the ownership of the {agent} directory: + +[source,shell] +---- +icacls "C:\Program Files\Elastic\Agent" /setowner "NT AUTHORITY\SYSTEM" /t /l +---- + +After the output confirms all files were successfully processed, run the `enroll` command again. + +==== + +// end 8.18.2 relnotes + +// begin 8.18.1 relnotes + +[[release-notes-8.18.1]] +== {fleet} and {agent} 8.18.1 + +Review important information about the {fleet} and {agent} 8.18.1 release. + +[discrete] +[[known-issues-8.18.1]] +=== Known issues + +[[known-issue-1800-8-18-1]] +.On Windows, {agent} is unable to re-enroll into {fleet} +[%collapsible] +==== + +*Details* + +There is a known issue where an {agent} installed on Windows and previously enrolled into {fleet} is unable to re-enroll. Attempting to enroll the {agent} fails with the following error: + +[source,shell] +---- +Error: the command is executed as root but the program files are not owned by the root user. +---- + +*Impact* + +The issue affects {agent} installed on Windows. Until a bug fix is available in a later release, you can temporarily resolve the issue by changing the ownership of the {agent} directory: + +[source,shell] +---- +icacls "C:\Program Files\Elastic\Agent" /setowner "NT AUTHORITY\SYSTEM" /t /l +---- + +After the output confirms all files were successfully processed, run the `enroll` command again. + +==== + +[discrete] +[[bug-fixes-8.18.1]] +=== Bug fixes + +{fleet-server}:: +* Add `grpcnotrace` build tags and ensure DCE (dead code elimination) is enabled. Reduce binary size by 34%. {fleet-server-pull}4784[#4784] + +// end 8.18.1 relnotes + +// begin 8.18.0 relnotes + +[[release-notes-8.18.0]] +== {fleet} and {agent} 8.18.0 + +Review important information about the {fleet} and {agent} 8.18.0 release. + +[discrete] +[[known-issues-8.18.0]] +=== Known issues + +[[known-issue-1749-8-18]] +.Inaccurate option to upgrade across major releases appears in {fleet} UI +[%collapsible] +==== + +*Details* + +In late 8.x releases, there's a bug in the {fleet} UI that causes `9.0.0` to appear as an option for {agent} upgrades. This option results in an error when selected, as upgrades across major releases are not supported for {agent}. For example, an agent can't be upgraded to version 9.0 while {kib} and {fleet-server} are on version 8.x. + +The {agent} upgrade is not selectable: + +image::images/upgrade-agent-not-selectable.png[{agent} upgrade is not selectable] + +The {fleet-server} upgrade is selectable, with an inconsistent UI state and error on submit: + +image::images/upgrade-fleet-server-inconsistent-state.png[{fleet-server} inconsistent UI state] + +*Impact* + + +In the 9.x releases, the option that appears in the UI for an upgrade across a major release should be ignored. + +==== + +[[known-issue-1800-8-18-0]] +.On Windows, {agent} is unable to re-enroll into {fleet} +[%collapsible] +==== + +*Details* + +There is a known issue where an {agent} installed on Windows and previously enrolled into {fleet} is unable to re-enroll. Attempting to enroll the {agent} fails with the following error: + +[source,shell] +---- +Error: the command is executed as root but the program files are not owned by the root user. +---- + +*Impact* + +The issue affects {agent} installed on Windows. Until a bug fix is available in a later release, you can temporarily resolve the issue by changing the ownership of the {agent} directory: + +[source,shell] +---- +icacls "C:\Program Files\Elastic\Agent" /setowner "NT AUTHORITY\SYSTEM" /t /l +---- + +After the output confirms all files were successfully processed, run the `enroll` command again. + +==== + +[discrete] +[[new-features-8.18.0]] +=== New features + +The 8.18.0 release Added the following new and notable features. + +{fleet}:: +* Add next steps and actions to the agentless integrations flyout. ({kibana-pull}203824[#203824]) +* Add support for selecting columns when exporting agents to CSV. ({kibana-pull}203103[#203103]) +* Add status tracking for agentless integrations. ({kibana-pull}199567[#199567]) + +{agent}:: +* Add ability to run the Elastic Distribution of OTel Collector at the same time as other inputs. This feature is in technical preview. {agent-pull}5767[#5767] {agent-issue}5796[#5796] +* Add a sample configuration to be used when deploying the link:https://github.com/open-telemetry/opentelemetry-helm-charts/tree/main/charts/opentelemetry-kube-stack[OpenTelemetry Kube Stack Helm Chart]. {agent-pull}5822[#5822] +* Add the GeoIP OpenTelemetry processor to {agent}. {agent-pull}6134[#6134] +* Add the link:https://github.com/open-telemetry/opentelemetry-collector-contrib/tree/main/connector/routingconnector[OpenTelemetry routing connector] to the Elastic Distribution of OTel Collector. {agent-pull}6210[#6210] +* Add support for the link:https://github.com/open-telemetry/opentelemetry-collector-contrib/tree/main/exporter/loadbalancingexporter[OTel loadbalancing exporter] to {agent}. {agent-pull}6315[#6315] +* Add a new Kubernetes deployment of the Elastic Distribution of OTel Collector named "gateway", to simplify the daemonset collector configuration and unify managed/self-managed scenarios. {agent-pull}6444[#6444] +* Add the `components` command for {agent} in OTel mode, to list the supported components the the Elastic Distribution of OTel Collector includes. {agent-pull}6539[#6539] +* Add the `receivercreator` and `k8sobserver` components to the Elastic Distribution of OTel Collector to help cover autodiscovery scenarios in Kubernetes. {agent-pull}6561[#6561] +* Add the `kafkaexporter` and `kafkareceiver` the Elastic Distribution of OTel Collector to help prepare support for a Kafka output. {agent-pull}6593[#6593] {agent-issue}6562[#6562] +* Add the nopreceiver to the Elastic Distribution of OTel Collector. {agent-pull}6603[#6603] +* Change the default gRPC port to 0 when {agent} is run in a container. {agent-pull}6585[#6585] + +[discrete] +[[enhancements-8.18.0]] +=== Enhancements + +{fleet}:: +* Enable sub-feature privileges for {fleet}. ({kibana-pull}203182[#203182]) + +{fleet-server}:: +* Validate user pbkdf2 settings for FIPS compliance. {fleet-server-pull}4542[#4542] +* Update {fleet-server} Go version to 1.24.0. {fleet-server-pull}4543[#4543] + +{agent}:: +* Re-enable the OTel subcommand on Windows. {agent-pull}6068[#6068] {agent-issue}4976[#4976] {agent-issue}5710[#5710] +* Update the {agent} to only run composable providers if they are referenced in the agent policy. {agent-pull}6169[#6169] {agent-issue}3609[#3609] {agent-issue}4648[#4648] +* Add a flag to skip {fleet} audit or unenroll when uninstalling {agent}. {agent-pull}6206[#6206] {agent-issue}5757[#5757] +* Embed hints-based inputs in the {agent} Kubernetes container image. {agent-pull}6381[#6381] {agent-issue}5661[#5661] +* Add an error to the Windows Application Event Log if the `install`, `uninstall`, or `enroll` commands fail. {agent-pull}6410[#6410] {agent-issue}6338[#6338] +* Add a logger to print the status and code when an {agent} enrollment call to {fleet} fails. {agent-pull}6477[#6477] {agent-issue}6287[#6287] +* Update {agent} Go version to 1.24.0. {agent-pull}6932[#6932] +* Update OTel components to v0.120.x. {agent-pull}7443[#7443] + +[discrete] +[[bug-fixes-8.18.0]] +=== Bug fixes + +{fleet}:: +* Support `is_default` on integration deployment modes. ({kibana-pull}208284[#208284]) +* Fix a UI error caused when an agent becomes orphaned. ({kibana-pull}207746[#207746]) +* Restrict non-local {es} output types for agentless integrations and policies. ({kibana-pull}207296[#207296]) +* Fix API code to prevent bulk actions from timing out. ({kibana-pull}205735[#205735]) +* Fix generation of dynamic mapping for objects with specific subfields. ({kibana-pull}204104[#204104]) +* Fix logic to ensure that agents are only considered stuck in updating when an upgrade fails. ({kibana-pull}202126[#202126]) + +{fleet-server}:: +* Return a 429 error when the {fleet-server} connection limit is reached instead of silently closing connections. {fleet-server-pull}4402[#4402] + +{agent}:: +* Prevent installation of {elastic-defend} in emulated environment, in which it's not supported. {agent-pull}6095[#6095] {agent-issue}6082[#6082] +* Re-enable notifying {fleet} when [agent] is uninstalled on Windows. {agent-pull}6257[#6257] {agent-issue}5952[#5952] +* Log a warning on same version upgrade attempts and prevent the agent from reporting a failed upgrade state. {agent-pull}6273[#6273] {agent-issue}6186[#6186] +* Add retries for requesting download verifiers when upgrading an agent. {agent-pull}6276[#6276] {agent-issue}5163[#5163] +* Replace `list` with `items` from from `kibanaFetchToken` as `list` is deprecated in the API response and will be removed. {agent-pull}6437[#6437] {agent-issue}6023[#6023] +* Restore `cloud-defend` as an expected binary after it was accidentally removed from containers in 8.17.0 and later versions. {agent-pull}6470[#6470] {agent-issue}6469[#6469] +* Restore the `maintainer` label for container images rather than the default inherited from a base image. {agent-pull}6512[#6512] +* Fix enrollment for containerized {agent} when the enrollment token changes or the agent is unenrolled. {agent-pull}6568[#6568] {agent-issue}3586[#3586] +* Change how Windows process handles are obtained when assigning sub-processes to Job objects. {agent-pull}6825[#6825] + +// end 8.18.0 relnotes + +// --------------------- +//TEMPLATE +//Use the following text as a template. Remember to replace the version info. + +// begin 8.7.x relnotes + +//[[release-notes-8.7.x]] +//== {fleet} and {agent} 8.7.x + +//Review important information about the {fleet} and {agent} 8.7.x release. + +//[discrete] +//[[security-updates-8.7.x]] +//=== Security updates + +//{fleet}:: +//* add info + +//{agent}:: +//* add info + +//[discrete] +//[[breaking-changes-8.7.x]] +//=== Breaking changes + +//Breaking changes can prevent your application from optimal operation and +//performance. Before you upgrade, review the breaking changes, then mitigate the +//impact to your application. + +//[discrete] +//[[breaking-PR#]] +//.Short description +//[%collapsible] +//==== +//*Details* + +// For more information, refer to {kibana-pull}PR[#PR]. + +//*Impact* + +// For more information, refer to {fleet-guide}/fleet-server.html[Fleet Server]. +//==== + +//[discrete] +//[[notable-changes-8.13.0]] +//=== Notable changes + +//The following are notable, non-breaking updates to be aware of: + +//* Changes to features that are in Technical Preview. +//* Changes to log formats. +//* Changes to non-public APIs. +//* Behaviour changes that repair critical bugs. + +//{fleet}:: +//* add info + +//{agent}:: +//* add info + +//[discrete] +//[[known-issues-8.7.x]] +//=== Known issues + +//[[known-issue-issue#]] +//.Short description +//[%collapsible] +//==== + +//*Details* + + +// + +//*Impact* + + +// + +//==== + +//[discrete] +//[[deprecations-8.7.x]] +//=== Deprecations + +//The following functionality is deprecated in 8.7.x, and will be removed in +//8.7.x. Deprecated functionality does not have an immediate impact on your +//application, but we strongly recommend you make the necessary updates after you +//upgrade to 8.7.x. + +//{fleet}:: +//* add info + +//{agent}:: +//* add info + +//[discrete] +//[[new-features-8.7.x]] +//=== New features + +//The 8.7.x release Added the following new and notable features. + +//{fleet}:: +//* add info + +//{agent}:: +//* add info + +//[discrete] +//[[enhancements-8.7.x]] +//=== Enhancements + +//{fleet}:: +//* add info + +//{agent}:: +//* add info + +//[discrete] +//[[bug-fixes-8.7.x]] +//=== Bug fixes + +//{fleet}:: +//* add info + +//{agent}:: +//* add info + +// end 8.7.x relnotes From 5eed9fb85c35016fdcfce92544970c75f17d503b Mon Sep 17 00:00:00 2001 From: Colleen McGinnis Date: Tue, 3 Jun 2025 16:24:24 -0500 Subject: [PATCH 2/2] delete 8.18 release notes file --- .../release-notes/release-notes-8.18.asciidoc | 375 ------------------ 1 file changed, 375 deletions(-) delete mode 100644 docs/en/ingest-management/release-notes/release-notes-8.18.asciidoc diff --git a/docs/en/ingest-management/release-notes/release-notes-8.18.asciidoc b/docs/en/ingest-management/release-notes/release-notes-8.18.asciidoc deleted file mode 100644 index 3a9503f53..000000000 --- a/docs/en/ingest-management/release-notes/release-notes-8.18.asciidoc +++ /dev/null @@ -1,375 +0,0 @@ -// Use these for links to issue and pulls. -:kibana-issue: https://github.com/elastic/kibana/issues/ -:kibana-pull: https://github.com/elastic/kibana/pull/ -:beats-issue: https://github.com/elastic/beats/issues/ -:beats-pull: https://github.com/elastic/beats/pull/ -:agent-libs-pull: https://github.com/elastic/elastic-agent-libs/pull/ -:agent-issue: https://github.com/elastic/elastic-agent/issues/ -:agent-pull: https://github.com/elastic/elastic-agent/pull/ -:fleet-server-issue: https://github.com/elastic/fleet-server/issues/ -:fleet-server-pull: https://github.com/elastic/fleet-server/pull/ - -[[release-notes]] -= Release notes - -This section summarizes the changes in each release. - -* <> -* <> -* <> - -Also see: - -* {kibana-ref}/release-notes.html[{kib} release notes] -* {beats-ref}/release-notes.html[{beats} release notes] - -// begin 8.18.2 relnotes - -[[release-notes-8.18.2]] -== {fleet} and {agent} 8.18.2 - -Review important information about the 8.18.2 release. - -[discrete] -[[security-updates-8.18.2]] -=== Security updates - -{agent}:: -* Update Go version to v1.24.3 {agent-pull}8109[#8109] - -{fleet}:: -* Update Go version to v1.24.3 {fleet-server-pull}4891[#4891] - -[discrete] -[[known-issues-8.18.2]] -=== Known issues - -[[known-issue-1800-8-18-2]] -.On Windows, {agent} is unable to re-enroll into {fleet} -[%collapsible] -==== - -*Details* + -There is a known issue where an {agent} installed on Windows and previously enrolled into {fleet} is unable to re-enroll. Attempting to enroll the {agent} fails with the following error: - -[source,shell] ----- -Error: the command is executed as root but the program files are not owned by the root user. ----- - -*Impact* + -The issue affects {agent} installed on Windows. Until a bug fix is available in a later release, you can temporarily resolve the issue by changing the ownership of the {agent} directory: - -[source,shell] ----- -icacls "C:\Program Files\Elastic\Agent" /setowner "NT AUTHORITY\SYSTEM" /t /l ----- - -After the output confirms all files were successfully processed, run the `enroll` command again. - -==== - -// end 8.18.2 relnotes - -// begin 8.18.1 relnotes - -[[release-notes-8.18.1]] -== {fleet} and {agent} 8.18.1 - -Review important information about the {fleet} and {agent} 8.18.1 release. - -[discrete] -[[known-issues-8.18.1]] -=== Known issues - -[[known-issue-1800-8-18-1]] -.On Windows, {agent} is unable to re-enroll into {fleet} -[%collapsible] -==== - -*Details* + -There is a known issue where an {agent} installed on Windows and previously enrolled into {fleet} is unable to re-enroll. Attempting to enroll the {agent} fails with the following error: - -[source,shell] ----- -Error: the command is executed as root but the program files are not owned by the root user. ----- - -*Impact* + -The issue affects {agent} installed on Windows. Until a bug fix is available in a later release, you can temporarily resolve the issue by changing the ownership of the {agent} directory: - -[source,shell] ----- -icacls "C:\Program Files\Elastic\Agent" /setowner "NT AUTHORITY\SYSTEM" /t /l ----- - -After the output confirms all files were successfully processed, run the `enroll` command again. - -==== - -[discrete] -[[bug-fixes-8.18.1]] -=== Bug fixes - -{fleet-server}:: -* Add `grpcnotrace` build tags and ensure DCE (dead code elimination) is enabled. Reduce binary size by 34%. {fleet-server-pull}4784[#4784] - -// end 8.18.1 relnotes - -// begin 8.18.0 relnotes - -[[release-notes-8.18.0]] -== {fleet} and {agent} 8.18.0 - -Review important information about the {fleet} and {agent} 8.18.0 release. - -[discrete] -[[known-issues-8.18.0]] -=== Known issues - -[[known-issue-1749-8-18]] -.Inaccurate option to upgrade across major releases appears in {fleet} UI -[%collapsible] -==== - -*Details* - -In late 8.x releases, there's a bug in the {fleet} UI that causes `9.0.0` to appear as an option for {agent} upgrades. This option results in an error when selected, as upgrades across major releases are not supported for {agent}. For example, an agent can't be upgraded to version 9.0 while {kib} and {fleet-server} are on version 8.x. - -The {agent} upgrade is not selectable: - -image::images/upgrade-agent-not-selectable.png[{agent} upgrade is not selectable] - -The {fleet-server} upgrade is selectable, with an inconsistent UI state and error on submit: - -image::images/upgrade-fleet-server-inconsistent-state.png[{fleet-server} inconsistent UI state] - -*Impact* + - -In the 9.x releases, the option that appears in the UI for an upgrade across a major release should be ignored. - -==== - -[[known-issue-1800-8-18-0]] -.On Windows, {agent} is unable to re-enroll into {fleet} -[%collapsible] -==== - -*Details* + -There is a known issue where an {agent} installed on Windows and previously enrolled into {fleet} is unable to re-enroll. Attempting to enroll the {agent} fails with the following error: - -[source,shell] ----- -Error: the command is executed as root but the program files are not owned by the root user. ----- - -*Impact* + -The issue affects {agent} installed on Windows. Until a bug fix is available in a later release, you can temporarily resolve the issue by changing the ownership of the {agent} directory: - -[source,shell] ----- -icacls "C:\Program Files\Elastic\Agent" /setowner "NT AUTHORITY\SYSTEM" /t /l ----- - -After the output confirms all files were successfully processed, run the `enroll` command again. - -==== - -[discrete] -[[new-features-8.18.0]] -=== New features - -The 8.18.0 release Added the following new and notable features. - -{fleet}:: -* Add next steps and actions to the agentless integrations flyout. ({kibana-pull}203824[#203824]) -* Add support for selecting columns when exporting agents to CSV. ({kibana-pull}203103[#203103]) -* Add status tracking for agentless integrations. ({kibana-pull}199567[#199567]) - -{agent}:: -* Add ability to run the Elastic Distribution of OTel Collector at the same time as other inputs. This feature is in technical preview. {agent-pull}5767[#5767] {agent-issue}5796[#5796] -* Add a sample configuration to be used when deploying the link:https://github.com/open-telemetry/opentelemetry-helm-charts/tree/main/charts/opentelemetry-kube-stack[OpenTelemetry Kube Stack Helm Chart]. {agent-pull}5822[#5822] -* Add the GeoIP OpenTelemetry processor to {agent}. {agent-pull}6134[#6134] -* Add the link:https://github.com/open-telemetry/opentelemetry-collector-contrib/tree/main/connector/routingconnector[OpenTelemetry routing connector] to the Elastic Distribution of OTel Collector. {agent-pull}6210[#6210] -* Add support for the link:https://github.com/open-telemetry/opentelemetry-collector-contrib/tree/main/exporter/loadbalancingexporter[OTel loadbalancing exporter] to {agent}. {agent-pull}6315[#6315] -* Add a new Kubernetes deployment of the Elastic Distribution of OTel Collector named "gateway", to simplify the daemonset collector configuration and unify managed/self-managed scenarios. {agent-pull}6444[#6444] -* Add the `components` command for {agent} in OTel mode, to list the supported components the the Elastic Distribution of OTel Collector includes. {agent-pull}6539[#6539] -* Add the `receivercreator` and `k8sobserver` components to the Elastic Distribution of OTel Collector to help cover autodiscovery scenarios in Kubernetes. {agent-pull}6561[#6561] -* Add the `kafkaexporter` and `kafkareceiver` the Elastic Distribution of OTel Collector to help prepare support for a Kafka output. {agent-pull}6593[#6593] {agent-issue}6562[#6562] -* Add the nopreceiver to the Elastic Distribution of OTel Collector. {agent-pull}6603[#6603] -* Change the default gRPC port to 0 when {agent} is run in a container. {agent-pull}6585[#6585] - -[discrete] -[[enhancements-8.18.0]] -=== Enhancements - -{fleet}:: -* Enable sub-feature privileges for {fleet}. ({kibana-pull}203182[#203182]) - -{fleet-server}:: -* Validate user pbkdf2 settings for FIPS compliance. {fleet-server-pull}4542[#4542] -* Update {fleet-server} Go version to 1.24.0. {fleet-server-pull}4543[#4543] - -{agent}:: -* Re-enable the OTel subcommand on Windows. {agent-pull}6068[#6068] {agent-issue}4976[#4976] {agent-issue}5710[#5710] -* Update the {agent} to only run composable providers if they are referenced in the agent policy. {agent-pull}6169[#6169] {agent-issue}3609[#3609] {agent-issue}4648[#4648] -* Add a flag to skip {fleet} audit or unenroll when uninstalling {agent}. {agent-pull}6206[#6206] {agent-issue}5757[#5757] -* Embed hints-based inputs in the {agent} Kubernetes container image. {agent-pull}6381[#6381] {agent-issue}5661[#5661] -* Add an error to the Windows Application Event Log if the `install`, `uninstall`, or `enroll` commands fail. {agent-pull}6410[#6410] {agent-issue}6338[#6338] -* Add a logger to print the status and code when an {agent} enrollment call to {fleet} fails. {agent-pull}6477[#6477] {agent-issue}6287[#6287] -* Update {agent} Go version to 1.24.0. {agent-pull}6932[#6932] -* Update OTel components to v0.120.x. {agent-pull}7443[#7443] - -[discrete] -[[bug-fixes-8.18.0]] -=== Bug fixes - -{fleet}:: -* Support `is_default` on integration deployment modes. ({kibana-pull}208284[#208284]) -* Fix a UI error caused when an agent becomes orphaned. ({kibana-pull}207746[#207746]) -* Restrict non-local {es} output types for agentless integrations and policies. ({kibana-pull}207296[#207296]) -* Fix API code to prevent bulk actions from timing out. ({kibana-pull}205735[#205735]) -* Fix generation of dynamic mapping for objects with specific subfields. ({kibana-pull}204104[#204104]) -* Fix logic to ensure that agents are only considered stuck in updating when an upgrade fails. ({kibana-pull}202126[#202126]) - -{fleet-server}:: -* Return a 429 error when the {fleet-server} connection limit is reached instead of silently closing connections. {fleet-server-pull}4402[#4402] - -{agent}:: -* Prevent installation of {elastic-defend} in emulated environment, in which it's not supported. {agent-pull}6095[#6095] {agent-issue}6082[#6082] -* Re-enable notifying {fleet} when [agent] is uninstalled on Windows. {agent-pull}6257[#6257] {agent-issue}5952[#5952] -* Log a warning on same version upgrade attempts and prevent the agent from reporting a failed upgrade state. {agent-pull}6273[#6273] {agent-issue}6186[#6186] -* Add retries for requesting download verifiers when upgrading an agent. {agent-pull}6276[#6276] {agent-issue}5163[#5163] -* Replace `list` with `items` from from `kibanaFetchToken` as `list` is deprecated in the API response and will be removed. {agent-pull}6437[#6437] {agent-issue}6023[#6023] -* Restore `cloud-defend` as an expected binary after it was accidentally removed from containers in 8.17.0 and later versions. {agent-pull}6470[#6470] {agent-issue}6469[#6469] -* Restore the `maintainer` label for container images rather than the default inherited from a base image. {agent-pull}6512[#6512] -* Fix enrollment for containerized {agent} when the enrollment token changes or the agent is unenrolled. {agent-pull}6568[#6568] {agent-issue}3586[#3586] -* Change how Windows process handles are obtained when assigning sub-processes to Job objects. {agent-pull}6825[#6825] - -// end 8.18.0 relnotes - -// --------------------- -//TEMPLATE -//Use the following text as a template. Remember to replace the version info. - -// begin 8.7.x relnotes - -//[[release-notes-8.7.x]] -//== {fleet} and {agent} 8.7.x - -//Review important information about the {fleet} and {agent} 8.7.x release. - -//[discrete] -//[[security-updates-8.7.x]] -//=== Security updates - -//{fleet}:: -//* add info - -//{agent}:: -//* add info - -//[discrete] -//[[breaking-changes-8.7.x]] -//=== Breaking changes - -//Breaking changes can prevent your application from optimal operation and -//performance. Before you upgrade, review the breaking changes, then mitigate the -//impact to your application. - -//[discrete] -//[[breaking-PR#]] -//.Short description -//[%collapsible] -//==== -//*Details* + -// For more information, refer to {kibana-pull}PR[#PR]. - -//*Impact* + -// For more information, refer to {fleet-guide}/fleet-server.html[Fleet Server]. -//==== - -//[discrete] -//[[notable-changes-8.13.0]] -//=== Notable changes - -//The following are notable, non-breaking updates to be aware of: - -//* Changes to features that are in Technical Preview. -//* Changes to log formats. -//* Changes to non-public APIs. -//* Behaviour changes that repair critical bugs. - -//{fleet}:: -//* add info - -//{agent}:: -//* add info - -//[discrete] -//[[known-issues-8.7.x]] -//=== Known issues - -//[[known-issue-issue#]] -//.Short description -//[%collapsible] -//==== - -//*Details* + - -// - -//*Impact* + - -// - -//==== - -//[discrete] -//[[deprecations-8.7.x]] -//=== Deprecations - -//The following functionality is deprecated in 8.7.x, and will be removed in -//8.7.x. Deprecated functionality does not have an immediate impact on your -//application, but we strongly recommend you make the necessary updates after you -//upgrade to 8.7.x. - -//{fleet}:: -//* add info - -//{agent}:: -//* add info - -//[discrete] -//[[new-features-8.7.x]] -//=== New features - -//The 8.7.x release Added the following new and notable features. - -//{fleet}:: -//* add info - -//{agent}:: -//* add info - -//[discrete] -//[[enhancements-8.7.x]] -//=== Enhancements - -//{fleet}:: -//* add info - -//{agent}:: -//* add info - -//[discrete] -//[[bug-fixes-8.7.x]] -//=== Bug fixes - -//{fleet}:: -//* add info - -//{agent}:: -//* add info - -// end 8.7.x relnotes