Download and Install the Infrastructure Agent on UNIX/Linux

apmsaas
The Infrastructure Agent is based on Java Service wrapper (Tanuki) that facilitates the installation of the Infrastructure Agent as a Linux daemon process. The agent includes and uses a local installation of the Java Runtime Environment (JRE). A single Infrastructure Agent can handle multiple Probe Agents. Usually at least one extension is used along with Infrastructure Agent.
Download the Infrastructure Agent
An agent package is a deployable set of agent binaries and configuration files in ZIP or TAR format. The Infrastructure Agent download package contains the Infrastructure Agent and the extensions that you can deploy to provide data about your infrastructure components. By default, the Infrastructure Agent contains the Agent Controller and is delivered as an agent extension. The Agent Controller manages agents running on the same host where the Agent Controller runs. You can add the Agent Controller extension to Java agents. During run time, the Agent Controller starts as a subprocess of the agent monitoring process.
The Infrastructure Agent download package enables you to deploy multiple infrastructure monitoring extensions at a time. Download as many agent packages for infrastructure monitoring as you need for comprehensive metric collection.
The following procedure explains the steps to download only the Infrastructure Agent for Unix or Linux.
Follow these steps:
  1. Log in to
    DX SaaS
    .
  2. Open the
    DX Application Performance Management
    tile.
  3. In the left navigation, under
    Settings
    , click
    Agents
    .
  4. In the
    Settings Agent
    page, click
    Download Agent
    .
    The
    Select Agent to Download
    dialog opens with the agents that each operating system supports.
  5. Select UNIX/Linux as the operating system.
  6. In the
    Infrastructure
    tab, click
    Infrastructure
    .
    The
    Configure Infrastructure
    dialog opens with
    Agent Controller
    selected.
    In this dialog, you can select any number of extensions to be downloaded. For some of the extensions, you can configure the properties and also save the configuration for future use. For more information, see the respective Agent Extension documentation.
  7. Click
    Download
    and Install
    .
    The Infrastructure Agent is downloaded.
Install the Infrastructure Agent
You can install the Infrastructure Agent on UNIX/Linx operating systems as a
root user or user with sudo access.
The Infrastructure Agent performs the necessary tasks to install and create a service.
Follow these steps:
  1. Navigate to the directory where the Infrastructure Agent is downloaded.
  2. Extract the downloaded file.
  3. Navigate to the
    apmia
    directory.
  4. Execute the script to install the agent. For other commands for a root user and a non-root user with sudo permissions, see the table in this section.
    ./APMIACtrl.sh install
    The installation takes a few minutes and a message is displayed when the installation is successful.
The following table lists all the commands for a root user and a non-root user with sudo permissions:
Task
Root User
Non-Root User with Sudo Permissions
Install Infrastructure Agent
./APMIACtrl.sh install
sudo ./APMIACtrl.sh install
Uninstall Infrastructure Agent
./APMIACtrl.sh uninstall
sudo ./APMIACtrl.sh uninstall
Start the Infrastructure Agent
./APMIACtrl.sh start
sudo ./APMIACtrl.sh start
sudo systemctl start apmia
Stop Infrastructure Agent
./APMIACtrl.sh stop
sudo ./APMIACtrl.sh stop
sudo systemctl stop apmia
Restart Infrastructure Agent
./APMIACtrl.sh restart
sudo ./APMIACtrl.sh restart
sudo systemctl restart apmia
Check Infrastructure Agent Status
./APMIACtrl.sh status
sudo ./APMIACtrl.sh status
sudo systemctl status apmia
Force Start Infrastructure Agent
Runs the Infrastructure Agent without installing it. Force_start starts the Infrastructure Agent. When the Infrastructure Agent is started using force_start, the agent does not restart after reboot.
./APMIACtrl.sh force_start
sudo ./APMIACtrl.sh force_start
Force Stop Infrastructure Agent
Stops the Infrastructure Agent instance that was initiated by force_start.
Ctrl+c
Ctrl+c
If you are running the Infrastructure Agent as nohup, then identify the process ID and kill the ID of the process of the Infrastructure Agent.
Log Files
The
apmia directory
includes the following log files:
  • APMIA_install.log
    : This file includes the details of the installation.
The
apmia/logs
directory includes the following log files:
  • APMIAgentConsole.log
  • AutoProbe
  • IntroscopeAgent
  • APMIAWrapper.log