Managing the cephadm agent

Enable, disable, and verify the cephadm agent that provides host metadata to the Ceph Manager.

Before you begin

Ensure that you have administrator access to run Ceph CLI commands.

About this task

Use the following commands to manage the cephadm agent. When enabled, the agent collects host metadata and sends updates to the Ceph Manager. For more information about how the agent works, see cephadm agent (Technology Preview).

Procedure

Enable the cephadm agent.

ceph config set mgr mgr/cephadm/use_agent true

Disable the cephadm agent.

ceph config set mgr mgr/cephadm/use_agent false

Verify whether the cephadm agent is enabled or disabled.
```
ceph config get mgr mgr/cephadm/use_agent
```
Verify that the cephadm agent is running on hosts.
```
ceph orch ps --daemon-type agent
```
View the cephadm agent logs on a host.
```
journalctl -u ceph-<fsid>@agent.<host>
```

Results

The cephadm agent is enabled or disabled based on the configuration. When enabled, the agent runs on each host and reports metadata to the Ceph Manager.