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:

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 and unzip the files at /opt/appdynamics/appdsmartagent.

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: 

Debian

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

Centos/RHEL:

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

Smart Agent is supported on RHEL >= 8.

The following table provides the variable details:

Linux zip

sudo ./install-script.sh

Windows 

1. Unzip the Windows zip file to C:\appdynamics\appdsmartagent.
2. Open Command Line as an administrator.

3. Run appdsmartagent-service.bat. The batch script creates appdsmartagent Windows service, and then runs it.
   After you run this script, the Smart Agent keeps running as a Windows service on the host machine.

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.
  • ControllerPort: The port to which the Smart Agent connects to the Controller. It is 8090 for an on-premises Controller and 443 for a SaaS Controller. 
  • FMServicePort: The port to which the Smart Agent connects to the FM service (Agent Management). It is 8030 for an on-premises Controller and 443 for a SaaS Controller. 
  • 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   = 8090
    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:

1. Validate the status of Smart Agent service on the host machine.
2. 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 appdsmartagent.service

Validate Status of the Smart Agent Registration on the UI

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