diff --git a/docs/installation.rst b/docs/installation.rst index c03718d9..30cb8cc9 100644 --- a/docs/installation.rst +++ b/docs/installation.rst @@ -35,6 +35,20 @@ It is recommended to install Percona software from official repositories: sudo yum install percona-toolkit +.. rubric:: Generating an instance UUID for statistics + +During the installating 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-uud|. 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 =========================== @@ -54,3 +68,6 @@ 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` diff --git a/docs/release_notes.rst b/docs/release_notes.rst index 972d199a..a365fe41 100644 --- a/docs/release_notes.rst +++ b/docs/release_notes.rst @@ -6,15 +6,15 @@ v3.0.7 released New Features -* :jirabug: PT-633 : Added --mysql-only option to pt-stalk for RDS +* :jirabug:`PT-633`: Added --mysql-only option to ``pt-stalk`` for RDS Bug Fixes -* :jirabug: PT-244 : pt-online-schema-change --data-dir option broken for partitioned table -* :jirabug: PT-1256 : pt-table-sync does not use the character set for the table it is synchronizing -* :jirabug: PT-1455 : pt-osc is stuck when the table that is being altered is filtered out in the slave -* :jirabug: PT-1485 : pt-mysql-summary has broken Security section in versions bigger then 5.6 -* :jirabug: PMM-1905: Explain fails if encounters negative "ntoreturn" +* :jirabug:`PT-244`: The ``--data-dir`` option of ``pt-online-schema-change`` is broken for partitioned table +* :jirabug:`PT-1256`: ``pt-table-sync`` does not use the character set for the table it is synchronizing +* :jirabug:`PT-1455`: ``pt-osc`` is stuck when filtering out on the slave the table that is being altered +* :jirabug:`PT-1485`: The *Security* section of ``pt-mysql-summary`` is broken in versions bigger than 5.6 +* :jirabug:`PMM-1905`: ``Explain`` fails if it encounters a negative ``ntoreturn`` Known Issues: