Smart Agent allows you to manage the agent operations (install, upgrade, and rollback) for the supported agents by using the Controller user interface. It also provides Smart Agent CLI option for advanced configurations.
You can use the Controller UI to view all the installed agents with the inventory details. 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.
Before You Begin
Ensure you meet the following requirements to use Smart Agent:
Controller version >=23.11.0
Sufficient agent licenses
Required permissions. See Permissions to determine the user permissions required to run Smart Agent.
Required Memory: 10MB -15MB Idle and 500MB during install, upgrade, or rollback
Required Disk: 500 MB
Software Requirements
Python >=3.9
OpenSSL 1.1.1
Supported Platforms
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
Supported Agents and Platforms
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
Java
CentOS 8 and 9
RHEL 8 and 9
Ubuntu 22.04 and 20.04
Windows
Machine Agent
CentOS 8 and 9
RHEL 8 and 9
Ubuntu 22.04 and 20.04
Windows
Node.js
RHEL 8 and 9
Ubuntu 22.04 and 20.04
Debian 10, 11, and 12
PHP
Ubuntu 22.04 and 20.04
Python
CentOS 8 and 9
Ubuntu 22.04 and 20.04
Alpine
.NET MSI
Windows
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:
By default most linux package managers require the sudo access for installation of any RPM, DEB, or APK artifacts. Therefore, it is required for Smart Agent binary installation.
If you have access to install rpms and debs on machine without sudo you can install it without the sudo access. However, you should have following permissions:
install ( to modify yum, deb, and apk databases)
write to /etc/environment file
Zip
If you install agent manually using the zip file, you do not require any sudo access.
You require Internet to download the supporting packages for the Smart Agent installation with Linux Package Manager or Zip.
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:
