diff --git a/docs/3.0.1.md b/docs/3.0.1.md new file mode 100644 index 0000000..c58fdf6 --- /dev/null +++ b/docs/3.0.1.md @@ -0,0 +1,38 @@ +# Percona build of ProxySQL 3.0.1 and ProxySQL admin tools (2025-06-12) + +--8<--- "rn-block-top.md" + + + +## Release highlights + +This release introduces the Percona build of ProxySQL 3.0.1, incorporating the latest upstream features and improvements. This version includes all enhancements and bug fixes from upstream [ProxySQL 3.0.1]. + +* Dual-password support: Enables use of two passwords for seamless rotation. + +* Enhanced logging (from v2.7.2): Real-time query/event logging using a circular buffer and SQLite. View logs in `stats_mysql_query_events`, `history_mysql_query_events`, and Prometheus. + +* Prepared statement logging (#4895, #4922): Logs actual parameter values. Supports binary and JSON. Controlled by `mysql-eventslog_stmt_parameters` (disabled by default). + +* New event: `PROXYSQL_METADATA` (#4922): Logged when a new binary log file is created. Includes version metadata. + +* DNS cache improvements (#4745): Spreads out resolution attempts to avoid bursts and queue congestion. + +!!! note + + [ProxySQL 3.0.1 contains a PostgreSQL module in beta.](https://github.com/sysown/proxysql/releases) The Percona build of ProxySQL is only tested with Percona Server for MySQL. + +## No changes + +The [ProxySQL Admin tool](proxysql-admin-tool-v2-config.md) and the [pxc_scheduler_handler tool](psh-overview.md) within Percona's Build of ProxySQL 3.0.1 have not been updated and are the same as in the previous Percona release. + +## Known issues + +--8<--- "note-8.4.md" + +## Additional resources +--8<--- "rn-ar.md" + + + +[ProxySQL 3.0.1]: https://github.com/sysown/proxysql/releases/tag/v3.0.1 \ No newline at end of file diff --git a/docs/release-notes.md b/docs/release-notes.md index 0e344c1..4f8e775 100644 --- a/docs/release-notes.md +++ b/docs/release-notes.md @@ -1,5 +1,7 @@ # ProxySQL, ProxySQL-admin, and percona-scheduler-admin release notes index +[ProxySQL 3.0.1 and ProxySQL admin tools (2025-06-12)](3.0.1.md) + [ProxySQL 2.7.3 and ProxySQL admin tools (2025-04-21)](2.7.3.md) [ProxySQL 2.7.1-1 and ProxySQL admin tools (2024-11-20)](2.7.1-1.md) diff --git a/mkdocs-base.yml b/mkdocs-base.yml index 1cd525c..53cf1b4 100644 --- a/mkdocs-base.yml +++ b/mkdocs-base.yml @@ -147,6 +147,8 @@ nav: - get-help.md - Release notes: - Release notes index: release-notes.md + + - 3.0.1.md - 2.7.3.md - 2.7.1-1.md - 2.7.1.md diff --git a/snippets/rn-block-top.md b/snippets/rn-block-top.md index 03934c3..a9e6ccb 100644 --- a/snippets/rn-block-top.md +++ b/snippets/rn-block-top.md @@ -6,6 +6,6 @@ You can [download the original ProxySQL from GitHub](https://github.com/sysown/proxysql/releases). The [ProxySQL documentation](https://proxysql.com/documentation/) provides information on installing and running ProxySQL. -The [ProxySQL Admin (proxysql-admin)](proxysql-admin-tool-v2-config.md) tool simplifies the configuration of Percona XtraDB Cluster nodes with ProxySQL. [ProxySQL Admin 2](proxysql-admin-tool-functions.md) supports Percona XtraDB Cluster without custom scripts. +The [ProxySQL Admin (proxysql-admin)](proxysql-admin-tool-v2-config.md) tool simplifies the configuration of Percona XtraDB Cluster nodes with ProxySQL. [ProxySQL Admin](proxysql-admin-tool-functions.md) supports Percona XtraDB Cluster without custom scripts. The [pxc_scheduler_handler](psh-overview.md) tool can automatically perform a failover due to node failures, service degradation, or maintenance. This tool has features and capabilities that differ from the ProxySQL admin tool, so you should not use options from one tool in the other, as that may cause unintended results. diff --git a/variables.yml b/variables.yml index ace39ab..7be367b 100644 --- a/variables.yml +++ b/variables.yml @@ -1,6 +1,6 @@ # variables for HTML output -release: "2.7.3" -version: "2.x.x" -release_date: "April , 2025" -title_date: "2025-04-" +release: "3.0.1" +version: "3.x" +release_date: "June 12, 2025" +title_date: "2025-06-"