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 by using one of the following ways:

Install Smart Agent on the Host Machine by Logging in to Each Machine

For Debian:

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

For Centos/RHEL:

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

The following table provides the variable details:

Install Smart Agent on Multiple Nodes from a Host Machine

./appd install smartagent -—install-agent-from {artifact_path} —inventory {hosts} —connection ssh —auto-start

To know more about managed nodes, see How to build your inventory.

Important

By default, the lightweight Python3 (PyPy) is bundled with AppDynamics Smart Agent CLI to run a few components. This lightweight Python is sufficient to carry tasks on the local host.  However, the remote installations at a larger scale require a full-featured Python.

Install CLI using the following commands if you are performing remote installations at scale:

[sudo] APPD_SMARTAGENT_PYTHON3=<path to python3 installed on the machine> apt install ./appdsmartagent-cli_<version>_amd64.deb
[sudo] APPD_SMARTAGENT_PYTHON3=/usr/local/bin/python3.11 apt install ./appdsmartagent-cli_<version>_amd64.deb

CODE

Python3 versions 3.9  to 3.11 are supported.

For information about Smart Agent CLI, See Smart Agent Command Line Utility.

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 of the Controller on which you establish the connection with the Smart Agent.
  • 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   = 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:

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 smartagent.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.