Download and Install the Infrastructure Agent on UNIX/Linux
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:
- Log in toDX SaaS.
- Open theDX Application Performance Managementtile.
- In the left navigation, underSettings, clickAgents.
- In theSettings Agentpage, clickDownload Agent.TheSelect Agent to Downloaddialog opens with the agents that each operating system supports.
- Select UNIX/Linux as the operating system.
- In theInfrastructuretab, clickInfrastructure.TheConfigure Infrastructuredialog opens withAgent Controllerselected.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.
- ClickDownloadand 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:
- Navigate to the directory where the Infrastructure Agent is downloaded.
- Extract the downloaded file.
- Navigate to theapmiadirectory.
- 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 installThe 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:
Non-Root User with Sudo Permissions
Install Infrastructure Agent
sudo ./APMIACtrl.sh install
Uninstall Infrastructure Agent
sudo ./APMIACtrl.sh uninstall
Start the Infrastructure Agent
sudo ./APMIACtrl.sh start
sudo systemctl start apmia
Stop Infrastructure Agent
sudo ./APMIACtrl.sh stop
sudo systemctl stop apmia
Restart Infrastructure Agent
sudo ./APMIACtrl.sh restart
sudo systemctl restart apmia
Check Infrastructure Agent 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.
sudo ./APMIACtrl.sh force_start
Force Stop Infrastructure Agent
Stops the Infrastructure Agent instance that was initiated by force_start.
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.
apmia directoryincludes the following log files:
- APMIA_install.log: This file includes the details of the installation.
apmia/logsdirectory includes the following log files: