Buy Percona ServicesBuy Now!

Installation

You can install Percona Toolkit 3.0.0 release candidate from the official Percona software repositories for your system.

Installing Percona Toolkit on Debian or Ubuntu

  1. Fetch the repository packages from Percona web:

    wget https://repo.percona.com/apt/percona-release_0.1-4.$(lsb_release -sc)_all.deb
    
  2. Install the downloaded package with dpkg by running the following command as root or with sudo:

    sudo dpkg -i percona-release_0.1-4.$(lsb_release -sc)_all.deb
    
  3. Once you install this package, the Percona repositories should be added. You can check the repository configuration in the /etc/apt/sources.list.d/percona-release.list file.

  4. Update the local cache:

    sudo apt-get update
    
  5. Install the percona-toolkit package:

    sudo apt-get install percona-toolkit
    

Testing and Experimental Repositories

Percona offers pre-release builds from the testing repo, and early-stage development builds from the experimental repo. To enable them, add either testing or experimental at the end of the Percona repository definition in your repository file (by default, /etc/apt/sources.list.d/percona-release.list).

For example, if you are running Debian 8 (“jessie”) and want to install the latest testing builds, the definitions should look like this:

deb http://repo.percona.com/apt jessie main testing
deb-src http://repo.percona.com/apt jessie main testing

If you are running Ubuntu 14.04 LTS (Trusty Tahr) and want to install the latest experimental builds, the definitions should look like this:

deb http://repo.percona.com/apt trusty main experimental
deb-src http://repo.percona.com/apt trusty main experimental

Pinning the Packages

If you want to pin your packages to avoid upgrades, create a new file /etc/apt/preferences.d/00percona.pref and add the following lines to it:

Package: *
Pin: release o=Percona Development Team
Pin-Priority: 1001

For more information about pinning, refer to the official Debian Wiki.

Installing Percona Toolkit on Red Hat or CentOS

  1. Install the Percona repository package:

    $ sudo yum install http://www.percona.com/downloads/percona-release/redhat/0.1-4/percona-release-0.1-4.noarch.rpm
    

    You should see the following if successful:

    Installed:
      percona-release.noarch 0:0.1-4
    
    Complete!
    
  2. Check that the packages are available:

    $ yum list | grep percona-toolkit
    

    You should see output similar to the following:

    percona-toolkit.noarch                     3.0.0-rc                    percona-release-noarch
    
  3. Install the |PSMDB| packages:

    $ sudo yum install percona-toolkit
    

Testing and Experimental Repositories

Percona offers pre-release builds from the testing repo, and early-stage development builds from the experimental repo. You can enable either one in the Percona repository configuration file /etc/yum.repos.d/percona-release.repo. There are three sections in this file, for configuring corresponding repositories:

  • stable release
  • testing
  • experimental

The latter two repositories are disabled by default.

If you want to install the latest testing builds, set enabled=1 for the following entries:

[percona-testing-$basearch]
[percona-testing-noarch]

If you want to install the latest experimental builds, set enabled=1 for the following entries:

[percona-experimental-$basearch]
[percona-experimental-noarch]

Note

As of version 3.0, Percona Toolkit is not available in the noarch repo. Make sure that you enable the basearch repo when installing or upgrading to Percona Toolkit 3.0 or later.

This documentation is developed in Launchpad as part of the Percona Toolkit 3.0.
If you spotted inaccuracies, errors, don't understood it or you think something is missing or should be improved, please file a bug.
Visit Percona Store


General Inquiries

For general inquiries, please send us your question and someone will contact you.