Agent Installation

Instructions for installing the mema-agent application using native OS package managers, including prerequisite steps for creating a local monitor user in MariaDB.

To install mema-agent, you need to set up MariaDB Enterprise Repository - "MariaDB Enterprise Tools".

The mema-agent is a small application that must be installed on every server you wish to monitor with MariaDB Enterprise Manager, including MariaDB Server nodes and MaxScale nodes.

This guide covers the recommended installation method using a package manager.

Prerequisite: Create the Local Monitor User

Before installing the agent on a MariaDB Server host, you must create a local user that the agent will use to connect to the database and collect metrics.

Log in to your MariaDB Server and run the following:

Create monitor user

CREATE USER 'monitor'@'localhost' IDENTIFIED BY '<password>';
GRANT SELECT, PROCESS, REPLICATION CLIENT, RELOAD, REPLICA MONITOR, REPLICATION MASTER ADMIN ON *.* TO 'monitor'@'localhost';

Replace <password> with a secure password. You will need these credentials later when linking the agent in the Enterprise Manager UI.

Installation via Package Manager (Recommended)

This method uses your OS's native package manager (dnf, apt, zypper) to install the agent from the MariaDB Enterprise repository.

Step 1: Configure the MariaDB Enterprise Repository

If you haven't already configured the MariaDB Enterprise repository on the server, follow these steps.

1

Get your Customer Download Token

• Navigate to the MariaDB Customer Portal and log in.

• Copy your Customer Download Token. You will need this for the script.

2

Download the repository setup script

In your server's terminal, download the official setup script:

curl -LsSO https://dlm.mariadb.com/enterprise-release-helpers/mariadb_es_repo_setup

3

Run the script

Make the script executable, then run it with your download token:

# Make script executable and run

chmod +x mariadb_es_repo_setup
sudo ./mariadb_es_repo_setup --token="YOUR_TOKEN_HERE" --apply

Replace YOUR_TOKEN_HERE with the token you copied from the Customer Portal.

Step 2: Install the Agent Package

Once the repository is configured, use your system's package manager to install the agent.

Red Hat / Rocky / CentOS

sudo dnf install mema-agent

Debian / Ubuntu

The agent is now installed and running as a service.

Next Steps: Linking the Agent 🔗

After the agent is installed, it is running but not yet configured or linked to your MariaDB Enterprise Manager server.

The final step is to link the agent, which is done from the Enterprise Manager UI. Please refer to the "Adding Databases to MariaDB Enterprise Manager" guide for the specific steps to generate the linking command.

_{This page is: Copyright © 2025 MariaDB. All rights reserved.}