---
title: AAPM Agent Installation in Linux Environments
slug: kronpam-how-to-guides/aapm-agent-installation-in-linux-environments
docTags: 
createdAt: 2025-03-18T12:30:27.445Z
---

The AAPM Agent installation package must be downloaded from the Kron Repository and transferred to the target Linux environment where the agent will operate. The repository also contains SDK files, which are required for integration but do not need to be installed on the same host as the agent. Additional details on using the SDKs are provided in [Using AAPM Agent SDKs.](docId\:PSSiFXSGLI3GSZ06crlOg)

![AAPM Agent for Linux Installation Files](https://app.archbee.com/api/optimize/g9cApVza9NIhSh0pjZYtA/hJ4CBQtt3S3TCl178lJOm-20251021-033605.png "AAPM Agent for Linux Installation Files")

### Installation Overview

The installation process is automated through a setup script that manages all necessary steps. This script includes:

- **install.jar** – The main installation package that performs the deployment. 
- **silent-install.properties** – A configuration file that defines the installation parameters. 

:::hint{type="warning"}
The AAPM Agent is a **Java-based application** and requires **OpenJDK 8 or later** to run.
:::

### Silent Installation Properties File

The silent-install.properties file contains key configuration parameters that must be customized before running the installation script. The parameters and description information in the configuration file are provided in the table below.

| **Parameter**    | **Description**                                              |
| ---------------- | ------------------------------------------------------------ |
| INSTALL\_PATH    | Target directory where the agent will be installed.          |
| sc.primaryIp     | IP Address of Kron PAM's Primary Node                        |
| sc.secondaryIp   | IP Address of Kron PAM's Secondary Node                      |
| sc.initialToken  | Registration token required during the initial installation. |
| sc.agentName     | Name assigned to the AAPM Agent instance.                    |
| sc.encryptionKey | Encryption key used for secure communication.                |
| grpc.port.loc    | Port number for communication between the agent and SDKs.    |

![Silent Installation Parameters](https://app.archbee.com/api/optimize/g9cApVza9NIhSh0pjZYtA/mHntACVXJsKBiwaItHgDR-20251021-034201.png "Silent Installation Parameters")

### Default Installation Path and Requirements

By default, the AAPM Agent is installed in:

:::BlockQuote
/opt/KronPAM/agent
:::

### Installation Procedure

Once the silent-install.properties file has been configured with the correct parameters, execute the install script as follows:

```linux
# ./install_aapm_agent.sh
```

The install\_aapm\_agent.sh script automatically: 

- Creates the necessary service definitions. 
- Configures agent user and permissions. 
- Starts the AAPM Agent service upon successful installation.

### Managing the AAPM Agent Service

After installation, the AAPM Agent runs as a system service. To verify the service status, use:

```linux
# systemctl status aapm-agent.service
```

![Checking AAPM Agent Service Status](https://app.archbee.com/api/optimize/g9cApVza9NIhSh0pjZYtA/vOud19bq29KLk5d4gjtWb-20251021-035044.png "Checking AAPM Agent Service Status")

### Viewing Logs 

Agent runtime logs can be monitored using the journalctl command:

```linux
# journalctl -fu aapm-agent.service

```

This command provides a live feed of the AAPM Agent’s logs for troubleshooting and monitoring purposes.

![AAPM Agent Logs](https://app.archbee.com/api/optimize/g9cApVza9NIhSh0pjZYtA/06NW9Bmc1gPelVktkPD6F-20251021-035208.png "AAPM Agent Logs")

:::hint{type="info"}
**Note:**Ensure that all commands are executed with appropriate privileges (e.g., root or sudo) and that network connectivity is available between the AAPM Agent and Kron PAM Nodes.
:::

### Uninstallation Procedure

To remove the AAPM Agent and all related files, use the provided uninstall script:

```linux
# ./uninstall_aapm_agent.sh
```

Executing this script completely removes the agent and its associated directories from the system.