Install discovery agents to collect hardware and software inventory data from Windows, macOS, and Linux systems. Agents continuously scan host environments and send collected data to Configuration Management Database (CMDB), keeping it accurate and up to date.
Required Editions
| Available in: Lightning Experience |
| Available in: Enterprise, Performance, and Unlimited Editions with Agentforce IT Service that have Discovery enabled. |
| User Permissions Needed | |
|---|---|
| Manage Discovery Application | IT Service Asset Discovery |
Before you install the agent, allow communication over TCP ports 8190 and 8191 on both the Discovery Application host and the agent host, and verify that the hosts can communicate. The connection uses mutual TLS (mTLS), with both hosts presenting certificates.
Agents differ by operating system and can be installed using an installation wizard or through command line for macOS and Linux.
- From App Launcher, find and select CMDB and Service Graph.
- In the navigations pane, in Administration, select Discovery, and then Applications.
- From the list, select the discovery application where you want to install the agent.
- Click View from the record actions to open an application record.
-
In the Agents tab, copy the registration token.
The registration token links the discovery agent to your Salesforce CMDB and Service Graph environment. You must enter this token during the installation to register the agent with your organization.
-
Download the discovery agent based on the operating system where you want to install the
agent.
For macOS and Linux, the agent package includes command-line installation steps. The commands are shown in the Install Using Command Line section.
- On the host machine, open the downloaded installation file.
- In the installation wizard, accept the terms and conditions, and select Next.
- Enter the registration token you copied earlier, and select Next.
- Complete the installation and close the installation wizard.
The agent is installed on the host machine and begins running in the background. Asset data is automatically reported to CMDB by the agent based on the configured scan frequency.