War Story: Removing Offensive Language from Percona Toolkit

War story
Removing offensive language
from Percona Toolkit
Sveta Smirnova
Percona
March 27, 2025
Sveta Smirnova (Percona) War story: removing offensive language March 27, 2025 1 / 22

Percona Toolkit in Past
Maatkit, Aspersa by Baron Schwartz
Percona Toolkit
▶ Baron Schwartz
2008-2016 Daniel Nichter
-2016 Frank Cizmich
2016-2022 Carlos Salguero
2022- Sveta Smirnova

Percona Toolkit Today
pt-align
pt-archiver
pt-config-diff
pt-deadlock-logger
pt-diskstats
pt-duplicate-key-checker
pt-eustack-resolver
pt-fifo-split
pt-find
pt-fingerprint
pt-fk-error-logger
pt-galera-log-explainer
pt-heartbeat
pt-index-usage
pt-ioprofile
pt-k8s-debug-collector
pt-kill
pt-mext
pt-mongodb-index-check
pt-mongodb-query-digest
pt-mongodb-summary
pt-mysql-summary
pt-online-schema-change
pt-pg-summary
pt-pmp
pt-query-digest
pt-replica-find
pt-replica-restart
pt-secure-collect
pt-show-grants
pt-sift
pt-slave-delay
pt-slave-find
pt-slave-restart
pt-stalk
pt-summary
pt-table-checksum
pt-table-sync
pt-table-usage
pt-upgrade
pt-variable-advisor
pt-visual-explain

Percona Toolkit Today: The Most Popular Customer Tools
pt-align
pt-archiver
pt-config-diff
pt-deadlock-logger
pt-diskstats
pt-eustack-resolver
pt-fifo-split
pt-find
pt-fingerprint
pt-fk-error-logger
pt-heartbeat
pt-index-usage
pt-ioprofile
pt-kill
pt-mext
pt-mongodb-summary
pt-mysql-summary
pt-pg-summary
pt-pmp
pt-query-digest
pt-replica-find
pt-replica-restart
pt-secure-collect
pt-show-grants
pt-sift
pt-slave-delay
pt-slave-find
pt-slave-restart
pt-stalk
pt-summary
pt-table-checksum
pt-table-sync
pt-table-usage
pt-upgrade
pt-variable-advisor
pt-visual-explain

Percona Toolkit Today: Part of Other Percona Products
pt-align
pt-archiver
pt-config-diff
pt-deadlock-logger
pt-diskstats
pt-eustack-resolver
pt-fifo-split
pt-find
pt-fingerprint
pt-fk-error-logger
pt-heartbeat
pt-index-usage
pt-ioprofile
pt-kill
pt-mext
pt-mongodb-summary
pt-mysql-summary
pt-pg-summary
pt-pmp
pt-query-digest
pt-replica-find
pt-replica-restart
pt-secure-collect
pt-show-grants
pt-sift
pt-slave-delay
pt-slave-find
pt-slave-restart
pt-stalk
pt-summary
pt-table-checksum
pt-table-sync
pt-table-usage
pt-upgrade
pt-variable-advisor
pt-visual-explain

Percona Toolkit Today: The Most Popular Support Tools
pt-align
pt-archiver
pt-config-diff
pt-deadlock-logger
pt-diskstats
pt-eustack-resolver
pt-fifo-split
pt-find
pt-fingerprint
pt-fk-error-logger
pt-heartbeat
pt-index-usage
pt-ioprofile
pt-kill
pt-mext
pt-mongodb-summary
pt-mysql-summary
pt-pg-summary
pt-pmp
pt-query-digest
pt-replica-find
pt-replica-restart
pt-secure-collect
pt-show-grants
pt-sift
pt-slave-delay
pt-slave-find
pt-slave-restart
pt-stalk
pt-summary
pt-table-checksum
pt-table-sync
pt-table-usage
pt-upgrade
pt-variable-advisor
pt-visual-explain

Percona Toolkit Today: Helper Tools
pt-align
pt-archiver
pt-config-diff
pt-deadlock-logger
pt-diskstats
pt-eustack-resolver
pt-fifo-split
pt-find
pt-fingerprint
pt-fk-error-logger
pt-heartbeat
pt-index-usage
pt-ioprofile
pt-kill
pt-mext
pt-mongodb-summary
pt-mysql-summary
pt-pg-summary
pt-pmp
pt-query-digest
pt-replica-find
pt-replica-restart
pt-secure-collect
pt-show-grants
pt-sift
pt-slave-delay
pt-slave-find
pt-slave-restart
pt-stalk
pt-summary
pt-table-checksum
pt-table-sync
pt-table-usage
pt-upgrade
pt-variable-advisor
pt-visual-explain

Percona Toolkit Today: Written in Perl, Bash, and Go
pt-align
pt-archiver
pt-config-diff
pt-deadlock-logger
pt-diskstats
pt-eustack-resolver
pt-fifo-split
pt-find
pt-fingerprint
pt-fk-error-logger
pt-heartbeat
pt-index-usage
pt-ioprofile
pt-kill
pt-mext
pt-mongodb-summary
pt-mysql-summary
pt-pg-summary
pt-pmp
pt-query-digest
pt-replica-find
pt-replica-restart
pt-secure-collect
pt-show-grants
pt-sift
pt-slave-delay
pt-slave-find
pt-slave-restart
pt-stalk
pt-summary
pt-table-checksum
pt-table-sync
pt-table-usage
pt-upgrade
pt-variable-advisor
pt-visual-explain

Percona Toolkit Today: Tools that Work Directly with MySQL
pt-align
✓ pt-archiver
✓ pt-config-diff
✓ pt-deadlock-logger
pt-diskstats
✓ pt-duplicate-key-checker
pt-eustack-resolver
pt-fifo-split
✓ pt-find
pt-fingerprint
✓ pt-fk-error-logger
✓ pt-heartbeat
✓ pt-index-usage
pt-ioprofile
✓ pt-kill
pt-mext
pt-mongodb-summary
✓ pt-mysql-summary
✓ pt-online-schema-change
pt-pg-summary
pt-pmp
✓ pt-query-digest
✓ pt-replica-find
✓ pt-replica-restart
pt-secure-collect
✓ pt-show-grants
pt-sift
✓ pt-slave-delay
✓ pt-slave-find
✓ pt-slave-restart
✓ pt-stalk
pt-summary
✓ pt-table-checksum
✓ pt-table-sync
✓ pt-table-usage
✓ pt-upgrade
✓ pt-variable-advisor
✓ pt-visual-explain

MySQL 8.4 New and Legacy Syntax
Legacy Syntax New Syntax First Introduced
SHOW SLAVE HOSTS SHOW REPLICAS 8.0.23
CHANGE MASTER CHANGE REPLICATION SOURCE 8.0.23
SHOW MASTER STATUS SHOW BINARY LOG STATUS 8.1
RESET MASTER RESET BINARY LOGS[ AND GTIDS] 8.1
SLAVE in other commands REPLICA 8.0.23, 8.1
MASTER in other commands SOURCE 8.0.23, 8.1

MySQL 8.4 Legacy Left Overs
Privileges
▶ REPLICATION SLAVE
Tables in mysql schema
▶ slave master info
▶ slave relay log info
▶ slave worker info

Solution 1: sed
Easy to implement:
sed ’s/master/source/g’ *
sed ’s/slave/replica/g’ *

Solution 1: sed
Easy to implement:
We have to support old versions

Solution 1: sed
Easy to implement:
We have to support old versions
Rejected!

Complicated solution
Syntax, depending on version
Split at MySQL 8.1
Queries to MariaDB use old syntax
▶ May change in the future

Percona Toolkit Code Layout
/
bin/
pt-align
pt-archiver
...
lib/
Advisor.pm
AdvisorRules.pm
bash/
alt_cmds.sh
collect_mysql_info.sh
...
BinaryLogParser.pm
...
...
src/
go/
...
sandbox/
t/
lib
pt-align
pt-archiver
...
Changelog
...

Starting the Change
Tests first

Starting the Change
Tests first
Libraries code
▶ Perl
▶ Bash

Starting the Change
Tests first
Libraries code
▶ Perl
▶ Bash
Added use VersionParser into tests

Starting the Change
Tests first
Libraries code
▶ Perl
▶ Bash
Added use VersionParser into tests
Tools one-by-one

SSL Support
Percona Toolkit does not have full SSL support
MySQL 8.4 does not∗ run without SSL

SSL Support
Added basic SSL support for SHA256 plugins and replication
Implemented SSL tests for MySQL 8.4
Disabled SSL tests for earlier versions

SSL Support
Added basic SSL support for SHA256 plugins and replication
Implemented SSL tests for MySQL 8.4
Disabled SSL tests for earlier versions
Full SSL support is upcoming

Deprecation
pt-slave-delay: deprecated
pt-slave-find: − > pt-replica-find
pt-slave-restart: − > pt-replica-restart

Fine Tuning
Fixed broken staff for 8.0
Reverted rename of COM REGISTER SLAVE to COM REGISTER REPLICA
▶ The constant still named COM REGISTER SLAVE in 8.4 and 9.2
Implemented functions get replica name and get source name in
lib/MasterSlave.pm
Removed practically not supported options --replica-user and --replica-password
from pt-archiver, pt-kill, pt-query-digest
Adjusted pt-variable-advisor, so it reflects current defaults
▶ Still not recommended to use!

Smooth Migration for Percona Toolkit Users
Legacy and new DDL support for checksum and heartbeat tables
Support for legacy slave-* and master-* options together with new replica-* and
source-* variants
Updated documentation

Was it Worth?
A lot of work
For young people new syntax is certainly clearer
Found legacy options that do not work
Found legacy tools that should be removed
Legacy code, not related to the new syntax, was updated
Done for good

References
https://github.com/percona/percona-toolkit/pull/871/commits
https://www.researchgate.net/publication/236752849_Broken_Metaphor_The_
Master-Slave_Analogy_in_Technical_Literature
https://en.wikipedia.org/wiki/Slave_clock
Picture on the Title page
▶ Transfer of master clock network technology to Czechoslovakia: Elektročas or Elektrozeit?
German roots of Czechoslovak post-war timepieces 1923–1990 - Scientific Figure on
ResearchGate.
▶ Available from https://www.researchgate.net/figure/
Presentation-of-product-variety-of-Pragotron-company_fig2_382205982

Thank You!
https://x.com/svetsmirnova
https://github.com/svetasmirnova
https://www.linkedin.com/in/svetsmirnova/
https://www.slideshare.net/SvetaSmirnova/

War Story: Removing Offensive Language from Percona Toolkit

More Related Content

Similar to War Story: Removing Offensive Language from Percona Toolkit

More from Sveta Smirnova

Recently uploaded

War Story: Removing Offensive Language from Percona Toolkit