Skip to content
PERCONA MONITORING AND MANAGEMENT DOCUMENTATION

For help, click the link below to get free database assistance or contact our experts for personalized support.

Get help from Percona

Install PMM Client with Package Manager

Percona Monitoring and Management (PMM) Client can be installed using standard Linux package managers. You can choose between automated repository setup or manual package download options.

Prerequisites

Complete these essential steps before installation:

  1. Check system requirements to ensure your environment meets the minimum criteria.

  2. Install and configure PMM Serveras you’ll its IP address or hostname to configure the Client.

  3. Set up firewall rules to allow communication between PMM Client and PMM Server.

  4. Create database monitoring users with appropriate permissions for the databases you plan to monitor.

  5. Check that you have root or sudo privileges to install PMM Client. Alternatively, use binary installation for non-root environments.

Supported architectures and platforms

PMM Client supports:

  • Architectures: x86_64 (AMD64) and ARM64 (aarch64)

  • Operating systems:

    • Red Hat/CentOS/Oracle Linux 8 and 9
    • Debian 11 (Bullseye) and 12 (Bookworm)
    • Ubuntu 22.04 (Jammy) and 24.04 (Noble)
    • Amazon Linux 2023

The package manager will automatically select the appropriate version for your system architecture.

Installation process

Step 1: Configure repositories

Choose your preferred method to configure the Percona repositories:

Use the percona-release utility to automatically configure repositories:

Tip

If you have used percona-release before, disable and re-enable the repository: 

percona-release disable all
percona-release enable pmm3-client


wget https://repo.percona.com/apt/percona-release_latest.generic_all.deb
sudo dpkg -i percona-release_latest.generic_all.deb
sudo percona-release enable pmm3-client

yum install -y https://repo.percona.com/yum/percona-release-latest.noarch.rpm
percona-release enable pmm3-client

Download packages directly without configuring repositories:

  1. Visit the PMM download page.
  2. Select PMM 3 and choose specific version (usually the latest).
  3. Under Select Platform, select the item matching your software platform and architecture (x86_64 or ARM64).
  4. Download the package file or copy the link and use wget to download it.

Step 2: Install PMM Client

Root permissions required

The installation commands below require root privileges. Use sudo if you’re not running as root.

sudo apt update
sudo apt install -y pmm-client

yum install -y pmm-client

sudo dpkg -i pmm-client_*.deb

sudo dnf localinstall pmm-client-*.rpm

Step 3: Verify installation

Check that PMM Client installed correctly:

pmm-admin --version

Step 4: Register the node

Register your nodes to be monitored by PMM Server using the PMM Client:

pmm-admin config --server-insecure-tls --server-url=https://admin:[email protected]:443

where:

  • X.X.X.X is the address of your PMM Server
  • 443 is the default port number
  • admin/admin is the default PMM username and password. This is the same account you use to log into the PMM user interface, which you had the option to change when first logging in.

HTTPS connection required

Nodes must be registered with the PMM Server using a secure HTTPS connection. If you try to use HTTP in your server URL, PMM will automatically attempt to establish an HTTPS connection on port 443. If a TLS connection cannot be established, you will receive an error message and must explicitly use HTTPS with the appropriate secure port.

Registration example

Register a node with IP address 192.168.33.23, type generic, and name mynode on a PMM Server with IP address 192.168.33.14:

pmm-admin config --server-insecure-tls --server-url=https://admin:[email protected]:443 192.168.33.23 generic mynode

Step 5: Verify the connection

Check that PMM Client is properly connected and registered:

pmm-admin status