Dan HeathandRobin Beck
5ce6515156
* docs: IA reorganization * docs: Updates * docs: Updates * docs: Fix links * docs: Updates * docs: Fix a typo * docs: Fix client agent topic * docs: Update Client Agent nav * docs: Fix conflict * docs: Fix a typo in Client Agent docs (#5853) * docs: Fix client agent topic * docs: Updates * docs: Updates * docs: Updates * docs: Updates * docs: Fixes get started and operations links * docs: Update nav * docs: Partials * docs: Unix partials * docs: Worker partials * docs: Updates * docs: Update workers and targets * docs: Updates * docs: Updates * docs: Fixes link * docs: Updates after sync review * docs: Updates from review feedback * docs: Move worker filter examples * docs: Fix links * docs: Updates for filters based on working session * docs: Fixes broken links * docs: Add links to other filter topics * docs: Update list intro * docs: Adds link * docs: Fixes redirects * docs: Fixes redirects * docs: Deleted mysql page from TOC * docs: Add versioned redirect * docs: Adds versioned redirects * docs: Adds versioned redirects * docs: Update redirects * docs: Update redirects * docs: Redirect fixes * docs: Update redirect format * docs: Fix a typo * docs: Fixes redirects * docs: Fixes redirect * docs: Adds links out to client agent troubleshooting * uses /etc/boundary.d/ as recommended installation directory (#6003) * docs: Updates legacy io links * docs: Fixes redirects * docs: Fix redirect * docs: Restoring deleted file --------- Co-authored-by: Robin Beck <stellarsquall@users.noreply.github.com>
75 lines
2.3 KiB
Plaintext
75 lines
2.3 KiB
Plaintext
---
|
|
layout: docs
|
|
page_title: Manage the Client Agent
|
|
description: >-
|
|
Learn how to manage the Boundary Client Agent to intercept DNS requests, allowing Boundary to proxy connections transparently.
|
|
---
|
|
|
|
# Manage the Client Agent
|
|
|
|
Refer to the following sections for more information about managing the Client Agent.
|
|
You can monitor the Client Agent's status and retrieve information about any transparent sessions.
|
|
If you want to temporarily defer DNS resolution to any previously configured DNS resolvers, you can pause the Client Agent.
|
|
You can also disable the Client Agent, if you no longer want to use it for DNS resolution.
|
|
|
|
## Monitor status and sessions
|
|
|
|
You can check the status of the Client Agent to ensure it is running.
|
|
Use the following command to check the Client Agent's status:
|
|
|
|
```shell-session
|
|
$ boundary client-agent status
|
|
```
|
|
|
|
You can retrieve information about the sessions that the Client Agent is managing.
|
|
Use the following command to list any sessions currently being managed by the Client Agent, as well as any brokered credentials for those sessions:
|
|
|
|
```shell-session
|
|
$ boundary client-agent sessions
|
|
```
|
|
|
|
Note that this command does not list sessions that are not managed by the Client Agent. Use `boundary sessions list -recursive` to see all sessions.
|
|
|
|
## Pause the Client Agent
|
|
|
|
You can temporarily disable the Boundary Client Agent by pausing it with the following command:
|
|
|
|
```shell-session
|
|
$ boundary client-agent pause
|
|
```
|
|
|
|
When the Client Agent is paused, it does not intercept any DNS requests, and you are unable to use transparent sessions.
|
|
|
|
To resume the Client Agent, use the following command:
|
|
|
|
```shell-session
|
|
$ boundary client-agent resume
|
|
```
|
|
|
|
## Disable the Client Agent
|
|
|
|
If you want to disable the Boundary Client Agent, you can stop it with the following commands:
|
|
|
|
<Tabs>
|
|
<Tab heading="MacOS" group="macos">
|
|
|
|
```shell-session
|
|
$ sudo launchctl unload -w /Library/LaunchDaemons/com.hashicorp.boundary.boundary-client-agent.plist
|
|
```
|
|
|
|
Unloading the Boundary Client Agent removes its launch daemon configuration. To restart the Client Agent, use:
|
|
|
|
```shell-session
|
|
$ sudo launchctl load -w /Library/LaunchDaemons/com.hashicorp.boundary.boundary-client-agent.plist
|
|
```
|
|
|
|
</Tab>
|
|
<Tab heading="Windows" group="windows">
|
|
|
|
```shell-session
|
|
net stop BoundaryClientAgent
|
|
```
|
|
|
|
</Tab>
|
|
</Tabs>
|