Skip to content

Install PMM client manually using binaries

To install PMM client with binary package, do the following:

  1. Download the PMM Client package:

    wget https://downloads.percona.com/downloads/pmm2/3.0.0/binary/tarball/pmm2-client-3.0.0.tar.gz
    
  2. Download the PMM Client package checksum file:

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

    sha256sum -c pmm2-client-3.0.0.tar.gz.sha256sum
    
  4. Unpack the package and move into the directory.

    tar xfz pmm2-client-3.0.0.tar.gz && cd pmm2-client-3.0.0
    
  5. Choose one of these two commands (depends on your permissions):

    Without root permissions

    export PMM_DIR=YOURPATH
    
    where YOURPATH replace with you real path, where you have required access.

    With root permissions

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

    Root permissions (if you skipped step 5 for non root users)

    ./install_tarball
    
  7. Change the path.

    PATH=$PATH:$PMM_DIR/bin
    
  8. Set up the agent (pick the command for you depending on permissions)

    Root permissions

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

    Non root users

    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 check.

    pmm-admin status
    

Tips

  • Download tar.gz with pmm2-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, visit the community forum for comprehensive and free database knowledge, or contact our Percona Database Experts for professional support and services.