Skip to content
Percona Software for MySQL Documentation

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

Get help from Percona

Percona Toolkit updates for 8.4

Percona Toolkit has been updated to support MySQL 8.4, addressing terminology, deprecations, and authentication improvements. If your automation or runbooks use these tools, plan updates alongside the database upgrade.

Terminology alignment

  • Toolkit commands and output now use SOURCE/REPLICA terminology consistent with MySQL 8.4.

Renamed tools

  • pt-slave-find → pt-replica-find
  • pt-slave-restart → pt-replica-restart

Aliases with the old names remain for a transition period; update scripts and runbooks to the new names.

Deprecated tool

  • pt-slave-delay is deprecated. MySQL 8.4 support was not added. Use built-in delayed replication features instead.

Authentication and SSL

  • Improved SSL handling and consistent support for caching_sha2_password and sha256_password authentication plugins.

What to change in your environment

  • Search automation and scripts for pt-slave-* and replace with pt-replica-*.
  • Remove dependencies on pt-slave-delay; use native delayed replication.
  • Validate Toolkit connectivity using your TLS settings and modern auth plugins.

Further reading