Get Started

For the list of supported platforms, see Supported Platforms and for other Smart Agent requirements, see Smart Agent.

This document contains references to the Ansible® documentation. AppDynamics does not own any rights and assumes no responsibility for the accuracy or completeness of such third-party documentation.

This table outlines the steps to get started with Smart Agent:

1	Install Smart Agent
2	Configure Smart Agent
3	Start Smart Agent Process
4	Validate Smart Agent Installation

Install Smart Agent

You can install Smart Agent on the host machines by logging in to each machine. You can download the respective files from the Download Portal to the required host machine.

Agent Management provides Smart Agent CLI that you may use to automate installation of Smart Agent on multiple hosts.

Run the following command to install Smart Agent on the host machine:

For Debian

sudo env APPD_USER=<root-user> APPD_GROUP=root APPD_SMARTAGENT_PYTHON3=<path to python> apt install ./appdsmartagent_<version>_amd64.deb

CODE

For Centos/RHEL

sudo env APPD_USER=<root-user> APPD_GROUP=root APPD_SMARTAGENT_PYTHON3=<path to python> yum install ./appdsmartagent_<version>_amd64.rpm

CODE

The following table provides the variable details:

Variable Name	Description	Required	Default Value
`APPD_USER`	User with which Smart Agent Process should run	No	`root`
`APPD_GROUP`	Group with which Smart Agent Process should run	No	`root`
`APPD_SMARTAGENT_PYTHON3`	Python3 interpreter to be used by Smart Agent	No	`/opt/appdynamics/appdsmartagent/plugins/appenv`

Linux-zip

sudo ./install-script.sh

CODE

To install Smart Agent on multiple hosts, see Automate Smart Agent Installation on Multiple Nodes.

Configure Smart Agent

You require to configure Smart Agents to register with Controller. Edit the /opt/appdynamics/appdsmartagent/config.ini file for the required Smart Agent configuration. Ensure that you update the following parameters:

- ControllerURL: The URL of the Controller on which you want to establish the connection with the Smart Agent.
- FMServicePort: The port to which the Smart Agent connects to the FM service (Agent Management). It is 8090 for an on-premises Controller and 443 for a SaaS Controller.
- ControllerPort: The port of the Controller on which you establish the connection with the Smart Agent.
- AccountAccessKey: The account access key on the Controller.
- AccountName: The account name on the Controller to which the Smart Agent will report.
  config.ini
```
ControllerURL    = http://localhost 
ControllerPort	 = 443
FMServicePort    = 443
AgentType        =
AccountAccessKey =
AccountName      =

[CommonConfig]
ServiceName           =
ServiceNamespace      =
RequestTimeoutSeconds = 0
AgentName             =
PollingIntervalInSec  =

[Identity]
InstanceUID   =
InstalledTime =

[OAuth]
OAuthID      =
OAuthSecret  =
AuthEndpoint =
TenantID     =
Scopes       =

[HTTPClientSettings]
Timeout = 0

[TLSClientSetting]
Insecure = false

[TLSSetting]
CAFile   =
CertFile =
KeyFile  =
```
  YML

Start Smart Agent Process

Smart Agent is managed as Linux system service. Use the following command to start the Smart Agent service:

Restart Smart Agent

$ [sudo]systemctl start smartagent.service

Validate Smart Agent Installation

Ensure that Smart Agent installation is successful by validating the following steps:

Validate the status of Smart Agent service on the host machine.
Validate the status of Smart Agent registration on the Controller UI.

Status of Smart Agent Service on the Host

Run the following command from the host machine to check the status of Smart Agent service:

Validate

$ [sudo] systemctl status smartagent.service

Validate Status of the Smart Agent Registration on the UI

Navigate to Home > Agent Management > Manage Agents > Smart Agents
The smart agent entry for the host on which it is installed gets displayed in the table.