Skip to content

Commit 636772e

Browse files
authored
Merge pull request #133 from percona/patrickbirch-patch-1
Update index.md
2 parents 3e2d83a + 371b5d4 commit 636772e

File tree

1 file changed

+16
-29
lines changed

1 file changed

+16
-29
lines changed

docs/index.md

Lines changed: 16 additions & 29 deletions
Original file line numberDiff line numberDiff line change
@@ -4,35 +4,21 @@
44

55
This documentation is for the latest release: Percona ProxySQL admin tools {{release}} ([Release notes]({{release}}.md)).
66

7-
[ProxySQL](https://www.proxysql.com/) acts as a proxy between Percona XtraDB Cluster
8-
and your client application. It manages a connection pool, caching connections and
9-
keeping them open for future requests. ProxySQL runs continuously without needing a
10-
restart.
11-
12-
Without a connection pool, each SQL request opens a new connection to the remote
13-
node and closes it after completion. ProxySQL keeps certain connections open and
14-
reuses them or closes them if not reused within a specific time. You connect to the
15-
proxy, and it forwards your requests to the cluster.
16-
17-
ProxySQL operates as a daemon monitored by a process that can restart it in case of
18-
an unexpected exit, minimizing downtime. The daemon accepts traffic from MySQL
19-
clients and forwards it to backend MySQL servers.
20-
21-
Configuration options include runtime parameters, server grouping, and
22-
traffic-related parameters, many of which can be set at runtime using SQL-like
23-
queries.
24-
25-
The [ProxySQL 2 documentation](https://proxysql.com/documentation/) provides details
26-
on installation, running ProxySQL, and using the ProxySQL admin tools. The maintained releases are listed on
27-
[ProxySQL Installation](https://proxysql.com/documentation/installing-proxysql/).
7+
Percona distributes [ProxySQL](https://www.proxysql.com/) from the upstream project without code changes and provides additional tools like proxysql-admin for easier integration with Percona XtraDB Cluster. ProxySQL is a high-performance proxy that sits between client applications and Percona XtraDB Cluster. The proxy manages a connection pool by caching database connections and keeping those connections open for future use. This behavior reduces the overhead of repeatedly establishing and tearing down connections for each SQL request.
8+
9+
Without a connection pool, every SQL query would require a new connection to a cluster node, which would be closed after the query completed. ProxySQL maintains selected connections and reuses them as needed or closes unused connections after a defined idle time. Client applications connect to ProxySQL, which forwards database traffic to the XtraDB Cluster.
10+
11+
The ProxySQL service runs as a daemon and is monitored by a watchdog process capable of restarting it in case of unexpected termination, which helps minimize downtime. The daemon receives traffic from MySQL clients and forwards it to backend MySQL-compatible servers.
2812

29-
You can [download ProxySQL 2.x.x](https://www.percona.com/download-proxysql). Note that
30-
version 1 is no longer actively maintained.
13+
Configuration is handled using SQL-like statements, including runtime options, server grouping, and query routing rules. Most settings can be changed dynamically without restarting the proxy.
3114

32-
ProxySQL 2.x.x downloads include:
15+
The [ProxySQL 2 documentation](https://proxysql.com/documentation/) includes detailed guidance on installation, operation, and the use of supporting tools. The maintained releases are listed on
16+
[ProxySQL Installation](https://proxysql.com/documentation/installing-proxysql/).
17+
18+
[You can download Percona's build of ProxySQL 2.x.x](https://www.percona.com/download-proxysql). Note that
19+
Version 1 is no longer actively maintained. The ProxySQL 2. x. x downloads may include:
3320

34-
- [ProxySQL Admin (proxysql-admin)](proxysql-admin-tool-v2-config.md) simplifies
35-
the configuration of Percona XtraDB Cluster nodes with ProxySQL.
21+
- [ProxySQL Admin (proxysql-admin)](proxysql-admin-tool-v2-config.md) simplifies the configuration of Percona XtraDB Cluster nodes with ProxySQL.
3622

3723
- [pxc_scheduler_handler](build-psh.md) automatically performs failovers due to
3824
node failures, service degradation, or maintenance. Available from
@@ -41,8 +27,9 @@ ProxySQL 2.x.x downloads include:
4127
In a MySQL 8.4 or Percona Server for MySQL 8.4 environment, you may face these
4228
issues:
4329

44-
- ProxySQL contains counters that have not been updated to use the new terminology,
30+
* ProxySQL contains counters that have not been updated to use the new terminology,
4531
leading to unexpected results.
4632

47-
- The binlog reader errors out during initialization due to the use of old
48-
terminology, such as the the `SHOW MASTER STATUS` command
33+
* The binlog reader errors out during initialization due to the use of old
34+
terminology, such as the `SHOW MASTER STATUS` command
35+

0 commit comments

Comments
 (0)