Skip to content

check: use mariadb-client instead of mysql-client#2890

Merged
berendt merged 1 commit into
mainfrom
fix-galera-mariadb-client
May 15, 2026
Merged

check: use mariadb-client instead of mysql-client#2890
berendt merged 1 commit into
mainfrom
fix-galera-mariadb-client

Conversation

@ideaship
Copy link
Copy Markdown
Contributor

Summary

  • On Ubuntu, mysql-client resolves to the MySQL 8.0 client, which sends utf8mb4_0900_ai_ci in SQL query packets. MariaDB rejects that collation with ERROR 1273 (HY000) on versions before 11.4.5; kolla 2024.2 ships MariaDB 10.11.
  • The check_galera_cluster nagios plugin's first real SQL query fails silently, leaving wsrep_cluster_state_uuid empty and causing the plugin to report CRITICAL: node is not part of a cluster even when the cluster is healthy.
  • Replace the Ubuntu/Debian split (mysql-client / mariadb-client) with mariadb-client unconditionally. mariadb-client provides a mysql compatibility symlink, so the check_executable mysql check in the plugin continues to work. The package is available in Ubuntu universe on 20.04, 22.04, and 24.04.

Test plan

  • Deployed testbed at --version-manager 9.5.0 (so MANAGER_VERSION=9.5.0 in /opt/manager-vars.sh, which triggers the check_galera_cluster path in 200-infrastructure.sh rather than osism status database)
  • Post-upgrade check.sh ran check_galera_cluster with mariadb-client installed — returned OK: number of NODES = 3 with no collation error
  • Overall upgrade run status: success

🤖 Generated with Claude Code

On Ubuntu, mysql-client resolves to the MySQL 8.0 client, which sends
utf8mb4_0900_ai_ci during SQL queries. MariaDB rejects that collation
with ERROR 1273 (HY000) until 11.4.5; kolla 2024.2 ships MariaDB
10.11. The nagios plugin then reports CRITICAL even when the Galera
cluster is healthy.

mariadb-client provides a mysql compatibility symlink, so
check_executable mysql in the nagios plugin continues to work. The
package is available in Ubuntu universe on 20.04, 22.04, and 24.04.

The Ubuntu/Debian split was introduced in 30b9f52 to add Debian
support; Debian already used mariadb-client. Ubuntu should too since
the target server is always MariaDB.

AI-assisted: Claude Code
Signed-off-by: Roger Luethi <luethi@osism.tech>
@ideaship ideaship requested a review from berendt May 15, 2026 13:21
@berendt berendt merged commit 9ec646c into main May 15, 2026
3 checks passed
@berendt berendt deleted the fix-galera-mariadb-client branch May 15, 2026 13:49
@github-project-automation github-project-automation Bot moved this from Ready to Done in Human Board May 15, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

Status: Done

Development

Successfully merging this pull request may close these issues.

3 participants