mysql-to-percona

Plan migrations from MySQL or MariaDB to Percona Server for MySQL.

1|1|Updated May 29, 2026

Search Tags:#compatibility #migration #mysql #upgrade #datadir #percona-server #cross-major

Ready to run

npx skills add https://github.com/Percona-Lab/skills --skill mysql-to-percona

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: mysql-to-percona
Source: https://github.com/Percona-Lab/skills/tree/main/mysql-to-percona
Command: npx skills add https://github.com/Percona-Lab/skills --skill mysql-to-percona

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill guides users through migrating from community MySQL or MariaDB to Percona Server for MySQL, including cross-major upgrades (8.0 to 8.4), ensuring a true binary drop-in replacement and awareness of 8.4 breaking changes.

Core Features & Use Cases

Provides a practical migration plan that preserves the datadir during same-major upgrades and explains when a dump/reload is necessary.
Highlights Percona-only features, plugins, and operational considerations that impact migration success.
Use Case: swapping a production MySQL 8.0/8.4 or MariaDB system to Percona Server with minimal downtime and verified compatibility.

Quick Start

Ask the agent to produce a cross-major upgrade plan from community MySQL or MariaDB to Percona Server for MySQL, covering 8.0 to 8.4 upgrade steps and breaking changes.

Frequently Asked Questions about mysql-to-percona

High-intent search queries and answers about installing and using this skill.

FAQPage Schema

How do I migrate MySQL to Percona Server while reusing the existing datadir?▼

To migrate MySQL to Percona Server while reusing the datadir, you can perform a package swap for same-major versions. This Skill provides a practical migration plan that preserves the datadir to minimize downtime during the transition.

What are the breaking changes when upgrading from MySQL 8.0 to 8.4?▼

Upgrading from MySQL 8.0 to 8.4 introduces breaking changes that require careful compatibility checks. This Skill guides you through the cross-major upgrade process, referencing official Percona Server 8.4 docs to address these breaking changes.

Can I swap MariaDB to Percona Server for MySQL as a direct binary drop-in replacement?▼

Swapping MariaDB to Percona Server for MySQL is supported as a binary drop-in replacement. This Skill helps you plan the migration by verifying compatibility and explaining when a dump and reload is necessary instead of a direct package swap.

When do I need a dump and reload instead of a package swap during a Percona Server migration?▼

A dump and reload is necessary during a Percona Server migration when performing cross-major upgrades that cannot preserve the datadir directly. This Skill identifies these scenarios to ensure data integrity and successful version transitions.

What Percona-only features and plugins should I consider after migrating from community MySQL?▼

After migrating from community MySQL, you can leverage Percona-only features, plugins, and operational enhancements. This Skill highlights these specific capabilities to optimize your database environment post-migration.

Does this migration process provide version guidance for Percona Server upgrades?▼

The migration process provides version guidance for Percona Server upgrades by referencing the percona-dk MCP. This ensures you receive accurate version-specific instructions and compatibility considerations for your target deployment.