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.

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

Add known issues for 'no agent found', Agent uninstall exception #1483

Merged
merged 7 commits into from
Dec 2, 2024

Conversation

kilfoyle
Copy link
Contributor

@kilfoyle kilfoyle commented Nov 18, 2024

This adds docs for the known issues:

  • "no agent found", described in Knowledge Center here.
  • Fleet-managed agent throws an exception on uninstall in Windows, described in Knowledge Center here.

Closes: #1481
Closes: #1482

I'll update the "Impact" section of the second issue as soon as we have a suggested workaround (Blake or Craig, if you can please let me know once we have that).


Screenshot 2024-11-19 at 10 47 19 AM

Copy link

A documentation preview will be available soon.

Request a new doc build by commenting
  • Rebuild this PR: run docs-build
  • Rebuild this PR and all Elastic docs: run docs-build rebuild

run docs-build is much faster than run docs-build rebuild. A rebuild should only be needed in rare situations.

If your PR continues to fail for an unknown reason, the doc build pipeline may be broken. Elastic employees can check the pipeline status here.

@kilfoyle kilfoyle changed the title Add known issue for 'no agent found' Add known issues for 'no agent found', Fleet exception Nov 18, 2024
@kilfoyle kilfoyle changed the title Add known issues for 'no agent found', Fleet exception Add known issues for 'no agent found', uninstall exception Nov 18, 2024
@kilfoyle kilfoyle changed the title Add known issues for 'no agent found', uninstall exception Add known issues for 'no agent found', Agent uninstall exception Nov 18, 2024
@kilfoyle kilfoyle marked this pull request as draft November 18, 2024 21:57
@kilfoyle kilfoyle marked this pull request as ready for review November 20, 2024 19:44
Comment on lines 114 to 117
As a workaround you can...

//* Upgrade your {stack}?
//* Force uninstall the agent using a command?
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@blakerouse does retrying the uninstall operation work when this happens?

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

For now, so that we can merge this and have customers able to see it, I've changed the "Impact" section to read: We're currently investigating the issue and will update this page when a workaround becomes available.

@blakerouse, @cmacknz Please let me know if the above is okay, and when we have a workaround if you let me know I'll be happy to update this section.

@lucabelluccini
Copy link
Contributor

👋 I've created a public kb on our support portal, but this one would likely have more audience.


This issue prevents {agent} from being uninstalled on Windows systems.

We're currently investigating the issue and will update this page when a workaround becomes available.
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Retrying the uninstall again seems like a reasonable work around until we get some evidence it doesn't work, it's not simple to create an agent in this state for me to test.

If that fails, we can post instructions on manually removing the agent service and deleting the files in the installation directory.

Copy link
Contributor Author

@kilfoyle kilfoyle Dec 2, 2024

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Sounds good. I've changed this to simply "As a workaround, we recommend trying again to uninstall the agent."

cmacknz
cmacknz previously approved these changes Dec 2, 2024
lcawl
lcawl previously approved these changes Dec 2, 2024
Copy link
Contributor

@lcawl lcawl left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

One possible typo otherwise LGTM

@kilfoyle kilfoyle merged commit 8b58e40 into elastic:main Dec 2, 2024
3 checks passed
mergify bot pushed a commit that referenced this pull request Dec 2, 2024
* Add known issue for 'no agent found'

* add agent uninstall issue

* Fixup

* Add 'Fleet-managed' to second issue

* Indicate that workaround is pending

* Update workaround

* fix Kibana attribute

(cherry picked from commit 8b58e40)
mergify bot pushed a commit that referenced this pull request Dec 2, 2024
* Add known issue for 'no agent found'

* add agent uninstall issue

* Fixup

* Add 'Fleet-managed' to second issue

* Indicate that workaround is pending

* Update workaround

* fix Kibana attribute

(cherry picked from commit 8b58e40)
mergify bot pushed a commit that referenced this pull request Dec 2, 2024
* Add known issue for 'no agent found'

* add agent uninstall issue

* Fixup

* Add 'Fleet-managed' to second issue

* Indicate that workaround is pending

* Update workaround

* fix Kibana attribute

(cherry picked from commit 8b58e40)
kilfoyle added a commit that referenced this pull request Dec 2, 2024
…) (#1517)

* Add known issue for 'no agent found'

* add agent uninstall issue

* Fixup

* Add 'Fleet-managed' to second issue

* Indicate that workaround is pending

* Update workaround

* fix Kibana attribute

(cherry picked from commit 8b58e40)

Co-authored-by: David Kilfoyle <[email protected]>
kilfoyle added a commit that referenced this pull request Dec 2, 2024
…) (#1516)

* Add known issue for 'no agent found'

* add agent uninstall issue

* Fixup

* Add 'Fleet-managed' to second issue

* Indicate that workaround is pending

* Update workaround

* fix Kibana attribute

(cherry picked from commit 8b58e40)

Co-authored-by: David Kilfoyle <[email protected]>
kilfoyle added a commit that referenced this pull request Dec 2, 2024
…) (#1515)

* Add known issue for 'no agent found'

* add agent uninstall issue

* Fixup

* Add 'Fleet-managed' to second issue

* Indicate that workaround is pending

* Update workaround

* fix Kibana attribute

(cherry picked from commit 8b58e40)

Co-authored-by: David Kilfoyle <[email protected]>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Projects
None yet
Development

Successfully merging this pull request may close these issues.

Add known issue in 8.16 for agent uninstall exception Add known issue in 8.16 for "no agent found"
4 participants