Installing the EDB Postgres AI agent

Install the EDB Postgres AI agent (formerly called HM or beacon agent), your go-to tool for database monitoring, usage reporting, and migration assessment. Explore its full capabilities in Agent. Before installing, check the compatibility matrix to confirm which EDB Postgres AI agent version is supported for your HM release.

To install the EDB Postgres AI 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're planning on running the EDB Postgres AI 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

Supported HM versions for the EDB Postgres AI agent

The following table lists each Hybrid Manager (HM) release and its compatible beacon-agent version.

Install the EDB Postgres AI 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 EDB Postgres AI 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.