Skip to content

docs: Update MySQL Server Version#24517

Merged
smallinsky merged 2 commits intomasterfrom
smallinsky/proxy_mysql_engine_version_docs
May 11, 2023
Merged

docs: Update MySQL Server Version#24517
smallinsky merged 2 commits intomasterfrom
smallinsky/proxy_mysql_engine_version_docs

Conversation

@smallinsky
Copy link
Copy Markdown
Contributor

@smallinsky smallinsky commented Apr 13, 2023

What

@smallinsky smallinsky force-pushed the smallinsky/proxy_mysql_engine_version_docs branch 2 times, most recently from b306c81 to e7e338f Compare April 13, 2023 11:03
Comment thread docs/pages/database-access/reference/configuration.mdx Outdated
Comment thread docs/pages/database-access/troubleshooting.mdx Outdated
@smallinsky smallinsky force-pushed the smallinsky/proxy_mysql_engine_version_docs branch from e7e338f to 785f7bb Compare April 13, 2023 14:13
Comment thread docs/pages/database-access/troubleshooting.mdx Outdated
Comment thread docs/pages/database-access/reference/configuration.mdx Outdated
access see the [RBAC](../database-access/rbac.mdx) documentation.

## Connection to MySQL database results in "Unknown system variable 'query_cache_size'" error
When a Teleport Proxy is configured with Teleport Proxy Listener Mode (`proxy_listener_mode: separate`) by default MySQL client connections to the Teleport Proxy don't use the TLS Routing feature that allows propagating correct MySQL Server Version.
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I think the structure of this sentence pretty ambiguous. Does this mean that TLS Routing allows propagating the correct MySQL server version, or that, by not using TLS Routing, the Proxy Service can propagate the correct version?

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@ptgott
Yes, With TLS Routing enabled the MySQL Engine version propagation works correctly and this issue occurs only for setups where TLS Routing is disabled.

I have rephrased this sentence to:

When TLS Routing feature is disable by default, the Teleport Proxy Service returns 8.0.0-Teleport as the MySQL server version. In some cases, like connecting with a GUI Client, this can result in obtaining an Unknown system variable 'query_cache_size' error that indicates that MySQL capabilities were not properly negotiated between the MySQL client and server.

Comment thread docs/pages/database-access/troubleshooting.mdx Outdated
Comment thread docs/pages/database-access/troubleshooting.mdx Outdated
Comment thread docs/pages/database-access/troubleshooting.mdx Outdated
Comment thread docs/pages/database-access/troubleshooting.mdx Outdated
Comment thread docs/pages/database-access/troubleshooting.mdx Outdated
@smallinsky smallinsky force-pushed the smallinsky/proxy_mysql_engine_version_docs branch from be3bc57 to b3e7e23 Compare May 11, 2023 08:16
@smallinsky smallinsky added this pull request to the merge queue May 11, 2023
Merged via the queue into master with commit 51e0ab1 May 11, 2023
@smallinsky smallinsky deleted the smallinsky/proxy_mysql_engine_version_docs branch May 11, 2023 08:40
@public-teleport-github-review-bot
Copy link
Copy Markdown

@smallinsky See the table below for backport results.

Branch Result
branch/v13 Create PR

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

4 participants