Skip to content

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

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/binary/tarball/pmm-client-3.0.0-x86_64.tar.gz
    
    wget https://downloads.percona.com/downloads/pmm/3.0.0/binary/tarball/pmm-client-3.0.0-aarch64.tar.gz
    
  2. Download the corresponding checksum file:

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

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

    tar xfz pmm-client-3.0.0-x86_64.tar.gz && cd pmm-client-3.0.0
    
    tar xfz pmm-client-3.0.0-aarch64.tar.gz && cd pmm-client-3.0.0
    
  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/binary/tarball/pmm-client-3.0.0-x86_64.tar.gz
    
    wget https://downloads.percona.com/downloads/pmm/3.0.0/binary/tarball/pmm-client-3.0.0-aarch64.tar.gz
    
  2. Download the corresponding checksum file:

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

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

    tar xfz pmm-client-3.0.0-x86_64.tar.gz && cd pmm-client-3.0.0
    
    tar xfz pmm-client-3.0.0-aarch64.tar.gz && cd pmm-client-3.0.0
    
  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.