Skip to content

Install PMM Client manually using binaries

Choose your installation instructions based on whether you have root permissions:

To install PMM Client with binary package with root permissions:

  1. Download the PMM Client package for your architecture:

    wget https://downloads.percona.com/downloads/pmm/3.0.0 Beta/binary/tarball/pmm-client-3.0.0 Beta-aarch64.tar.gz
    
    wget https://downloads.percona.com/downloads/pmm/3.0.0 Beta/binary/tarball/pmm-client-3.0.0 Beta-x86_64.tar.gz
    
  2. Download the corresponding checksum file:

    wget https://downloads.percona.com/downloads/pmm/3.0.0 Beta/binary/tarball/pmm-client-3.0.0 Beta-aarch64.tar.gz.sha256sum
    
    wget https://downloads.percona.com/downloads/pmm/3.0.0 Beta/binary/tarball/pmm-client-3.0.0 Beta-x86_64.tar.gz.sha256sum
    
  3. Verify the download:

    sha256sum -c pmm-client-3.0.0 Beta-aarch64.tar.gz.sha256sum
    
    sha256sum -c pmm-client-3.0.0 Beta-x86_64.tar.gz.sha256sum
    
  4. Unpack the package and move into the directory:

    tar xfz pmm-client-3.0.0 Beta-aarch64.tar.gz && cd pmm-client-3.0.0 Beta
    
    tar xfz pmm-client-3.0.0 Beta-x86_64.tar.gz && cd pmm-client-3.0.0 Beta
    
  5. Set the installation directory:

    export PMM_DIR=/usr/local/percona/pmm
    
  6. Run the installer:

    ./install_tarball
    
  7. Update your PATH:

    PATH=$PATH:$PMM_DIR/bin
    
  8. Set up the agent:

    pmm-agent setup --config-file=/usr/local/percona/pmm/config/pmm-agent.yaml --server-address=192.168.1.123 --server-insecure-tls --server-username=admin --server-password=admin
    
  9. Run the agent:

    pmm-agent --config-file=${PMM_DIR}/config/pmm-agent.yaml
    
  10. Open a new terminal and verify the installation:

    pmm-admin status
    

To install PMM Client with binary package without root permissions:

  1. Download the PMM Client package for your architecture:

    wget https://downloads.percona.com/downloads/pmm/3.0.0 Beta/binary/tarball/pmm-client-3.0.0 Beta-aarch64.tar.gz
    
    wget https://downloads.percona.com/downloads/pmm/3.0.0 Beta/binary/tarball/pmm-client-3.0.0 Beta-x86_64.tar.gz
    
  2. Download the corresponding checksum file:

    wget https://downloads.percona.com/downloads/pmm/3.0.0 Beta/binary/tarball/pmm-client-3.0.0 Beta-aarch64.tar.gz.sha256sum
    
    wget https://downloads.percona.com/downloads/pmm/3.0.0 Beta/binary/tarball/pmm-client-3.0.0 Beta-x86_64.tar.gz.sha256sum
    
  3. Verify the download:

    sha256sum -c pmm-client-3.0.0 Beta-aarch64.tar.gz.sha256sum
    
    sha256sum -c pmm-client-3.0.0 Beta-x86_64.tar.gz.sha256sum
    
  4. Unpack the package and move into the directory:

    tar xfz pmm-client-3.0.0 Beta-aarch64.tar.gz && cd pmm-client-3.0.0 Beta
    
    tar xfz pmm-client-3.0.0 Beta-x86_64.tar.gz && cd pmm-client-3.0.0 Beta
    
  5. Set the installation directory:

    export PMM_DIR=YOURPATH
    

    Replace YOURPATH with a path where you have required access.

  6. Run the installer:

    ./install_tarball
    
  7. Update your PATH:

    PATH=$PATH:$PMM_DIR/bin
    
  8. Set up the agent:

    pmm-agent setup --config-file=${PMM_DIR}/config/pmm-agent.yaml --server-address=192.168.1.123 --server-insecure-tls --server-username=admin --server-password=admin --paths-tempdir=${PMM_DIR}/tmp --paths-base=${PMM_DIR}
    
  9. Run the agent:

    pmm-agent --config-file=${PMM_DIR}/config/pmm-agent.yaml
    
  10. Open a new terminal and verify the installation:

    pmm-admin status
    

Tips

  • Download tar.gz with pmm-client.
  • Extract it.
  • Run ./install_tarball scriptwith the -u flag.

The configuration file will be overwritten if you do not provide the -u flag while the pmm-agent is updated.

Get expert help

If you need assistance, you can find comprehensive and free database knowledge on our community forum or blog posts. For professional support and services, contact our Percona Database Experts.