Smart Agent allows you to manage the agent operations (install, upgrade, and rollback) for the supported agents by using the Controller user interface.
You can use smartagentctl binary to install Smart Agent. This binary is bundled with Smart Agent.
You can view all the installed agents with the inventory details from the Controller UI. The Smart Agent inventory is also displayed along with other agent inventory details.
- You must install Smart Agent on each host where you want to use the Controller UI to perform the agent management.
- Internet is not mandatory to install or manage Smart Agent.
Before You Begin
Ensure you meet the following requirements to use Smart Agent:
- Controller version >=24.7.0
- Sufficient agent licenses
- Required permissions. See Permissions to determine the user permissions required to run Smart Agent.
- Required Memory:
10MB -15MB Idle and 100MB during install, upgrade, or rollback - Required Disk:
500 MB
Smart Agent is supported on the following platforms:
- CentOS Stream 8.x, 9.x
- RedHat 8.x, 9.x
- Ubuntu 20.04, 22.04, 23.10
Amazon Linux 2023
Oracle Linux 8.x, 9.x
The Smart Agent manages the following agents. It supports them on the following platforms:
Smart Agent is supported on all the platforms mentioned in the following table.
| Agents | Supported Platform |
|---|
Apache Web Server | - CentOS 8 and 9
- RHEL 8 and 9
- Ubuntu 22.04 and 20.04
|
Database Agent | - CentOS 8 and 9
- RHEL 8 and 9
- Ubuntu 22.04 and 20.04
|
Java | - CentOS 8 and 9
- RHEL 8 and 9
- Ubuntu 22.04 and 20.04
- Windows 2016, 2019, 2022
|
Machine Agent | - CentOS 8 and 9
- RHEL 8 and 9
- Ubuntu 22.04 and 20.04
- Windows 2016, 2019, 2022
|
Node.js | - RHEL 8 and 9
- Ubuntu 22.04 and 20.04
- Debian 10, 11, and 12
|
PHP | |
Python | - CentOS 8 and 9
- Ubuntu 22.04 and 20.04
- Alpine
|
.NET MSI | Windows 2016, 2019, 2022 |
- You cannot monitor the Machine Agent Extension through the UI. During an upgrade, existing extensions will get carried forward to the higher version.
- You cannot configure the Machine Agent Remediation script through the UI.
Permissions
You require the following permissions to use Smart Agent:
Installation Permissions
You require sudo, root, or admin access to run Smart Agent as a service. You can use non-root permissions to run Smart Agent as a process.
Smart Agent Service Permissions
The Smart Agent service can be configured to run with a given user and group during installation by setting APPD_USERand APPD_GROUP environment variables during installation. The values of user and group you want to use depends on the agents you want to manage. The following table lists the required user and group values for each agent:
| Agent Type | APPD_USER | APPD_GROUP |
|---|
| PHP | root | root |
| Apache | root | root |
| Java | anyUser | anyUser |
| Python | root | root |
| Nodejs | anyUser | anyUser |
| Machine | root | root |
Database | anyUser | anyUser |
You can install Machine Agent as non-root user. See custom configuration for Machine Agent on Install Agents.
Next Step
