mirror of
https://github.com/percona/percona-toolkit.git
synced 2025-09-01 18:25:59 +00:00
59 lines
2.0 KiB
ReStructuredText
59 lines
2.0 KiB
ReStructuredText
.. _install:
|
|
|
|
==========================
|
|
Installing Percona Toolkit
|
|
==========================
|
|
|
|
It is recommended to install Percona software from official repositories:
|
|
|
|
1. Configure Percona repositories as described in
|
|
`Percona Software Repositories Documentation
|
|
<https://docs.percona.com/percona-software-repositories/index.html>`_.
|
|
|
|
#. Install Percona Toolkit using the corresponding package manager:
|
|
|
|
* For Debian or Ubuntu::
|
|
|
|
sudo apt-get install percona-toolkit
|
|
|
|
* For RHEL or CentOS::
|
|
|
|
sudo yum install percona-toolkit
|
|
|
|
.. rubric:: Generating an instance UUID for statistics
|
|
|
|
During the installation process, the percona-toolkit installer records a unique
|
|
identifier specific to the given percona-toolkit instance. This ID is a the
|
|
product UUID stored in |product-uuid|. The installer copies the product_uuid to
|
|
|toolkit-uuid|.
|
|
|
|
This unique identifier is used when collecting statistics about the usage of
|
|
percona-toolkit. Note that no other information is gathered for this purpose.
|
|
|
|
In cases when the installer is not able to read the contents of
|
|
|product-uuid|, a random UUID is generated. A random UUID is
|
|
also generated if percona-toolkit is run from the binary in the *tar.gz* file.
|
|
|
|
Alternative Install Methods
|
|
===========================
|
|
|
|
You can also download the packages from the
|
|
`Percona web site <https://www.percona.com/downloads/percona-toolkit/>`_
|
|
and install it using tools like ``dpkg`` and ``rpm``,
|
|
depending on your system.
|
|
For example, to download the package for Debian 11 ("bullseye"),
|
|
run the following::
|
|
|
|
wget https://downloads.percona.com/downloads/percona-toolkit/3.5.1/binary/debian/bullseye/x86_64/percona-toolkit_3.5.1-2.bullseye_amd64.deb
|
|
|
|
If you want to download a specific tool, use the following address:
|
|
http://www.percona.com/get
|
|
|
|
For example, to download the ``pt-summary`` tool, run::
|
|
|
|
wget percona.com/get/pt-summary
|
|
|
|
|
|
.. |toolkit-uuid| replace:: :file:`/etc/percona-toolkit/.percona.toolkit.uuid`
|
|
.. |product-uuid| replace:: :file:`/sys/class/dmi/id/product_uuid`
|