Installing the Agent

Install the Agent (also called HM Agent), your go-to tool for database monitoring, usage reporting, and migration assessment. Explore its full capabilities in Agent.

To install the HM Agent, use a combined approach:

1. Enable your system to download packages: Obtain your authentication token from the EDB repository and configure the repository settings on your system.

2. Install the agent package: Use your operating system's package manager to install the Agent.

   Note

   For the agent, installation instructions are provided exclusively in this documentation. Unlike other EDB products, the repositories contain the packages, but don't include the installation commands.

Enable your system to download packages

Enable the system where you are planning on running the agent to download packages from the EDB repositories for EDB Postgres AI.

Locate your EDB subscription token on the EnterpriseDB repos download page.

Using the retrieved subscription token, set an environmental variable (EDB_SUBSCRIPTION_TOKEN) to the token's value. Also set an environmental variable for your EDB subscription type (EDB_SUBSCRIPTION_TYPE) to one of standard or enterprise depending on which plan you are signed up to:

export EDB_SUBSCRIPTION_TOKEN=<your-repos-token>
export EDB_SUBSCRIPTION_TYPE=<your-subscription-type>

Depending on your operating system, run the following command to give your system the capacity to download packages from the EDB repositories:

curl -1sSLf "https://downloads.enterprisedb.com/$EDB_SUBSCRIPTION_TOKEN/$EDB_SUBSCRIPTION_TYPE/setup.rpm.sh" | sudo -E bash

curl -1sSLf "https://downloads.enterprisedb.com/$EDB_SUBSCRIPTION_TOKEN/$EDB_SUBSCRIPTION_TYPE/setup.rpm.sh" | sudo -E bash

curl -1sSLf "https://downloads.enterprisedb.com/$EDB_SUBSCRIPTION_TOKEN/$EDB_SUBSCRIPTION_TYPE/setup.deb.sh" | sudo -E bash

Install the Agent package

Install the beacon-agent package from EDB's repositories:

sudo dnf install beacon-agent

sudo yum install beacon-agent

sudo zypper install beacon-agent

sudo apt install beacon-agent

Install the Agent in air-gapped environments

Installing in air-gapped environments explains how to leverage local mirrors to make a product's packages and dependencies available in environments without internet access.