️ MySQL/MariaDB & Cluster

If you like this project, consider supporting me on Buy Me a Coffee ☕️

MySQL is the world's most popular open-source relational database, acquired by Oracle Corporation in 2010. MariaDB is a community-driven fork of MySQL created by the original developer Michael Widenius, offering enhanced performance and additional storage engines.

Common use cases / Типичные сценарии: Web applications (LAMP/LEMP stack), content management (WordPress, Drupal), e-commerce, SaaS platforms, embedded databases.

Status / Статус: Both MySQL (8.x/9.x) and MariaDB (11.x) are actively developed. MySQL remains the most widely deployed RDBMS. Modern alternatives for advanced workloads: PostgreSQL (advanced features, extensibility), CockroachDB (distributed SQL), TiDB (MySQL-compatible, distributed). MySQL Cluster (NDB) is for high-availability in-memory workloads.

Default port / Порт по умолчанию: 3306/tcp

📚 Table of Contents / Содержание

1. Installation & Configuration
2. MySQL Cluster Setup
3. Core Management
4. Sysadmin Operations
5. Security
6. Backup & Restore
7. Troubleshooting & Tools
8. Logrotate Configuration

Installation & Configuration / Установка и настройка

Package Installation / Установка пакетов

# Ubuntu/Debian
sudo apt update && sudo apt install -y mysql-server                      # Install MySQL / Установка MySQL
sudo apt install -y mariadb-server                                        # Install MariaDB / Установка MariaDB

# RHEL/AlmaLinux/Rocky
sudo dnf install -y mysql-server                                          # Install MySQL / Установка MySQL
sudo dnf install -y mariadb-server                                        # Install MariaDB / Установка MariaDB

Initial Setup / Первичная настройка

sudo mysql_secure_installation                                            # Secure installation wizard / Мастер безопасной установки

Configuration Files / Файлы конфигурации

Common Settings / Основные настройки

/etc/mysql/my.cnf or /etc/my.cnf

[mysqld]
bind-address = 127.0.0.1                    # Listen address / Адрес прослушивания
port = 3306                                 # Default port / Порт по умолчанию
max_connections = 200                       # Max connections / Максимум подключений
innodb_buffer_pool_size = 1G                # InnoDB buffer pool / Буфер InnoDB
slow_query_log = 1                          # Enable slow query log / Включить лог медленных запросов
slow_query_log_file = /var/log/mysql/slow.log
long_query_time = 2                         # Queries > 2s logged / Запросы > 2с логируются

Storage Engines Comparison / Сравнение движков хранилищ

MySQL Cluster Setup / Установка и настройка MySQL Cluster

MySQL Cluster — это высокодоступная база данных с синхронной репликацией и in-memory хранением данных.

Architecture Components / Компоненты архитектуры

• Management Node (MGM) – Controls cluster, configuration, and node status / Контролирует кластер и состояние нод.
• Data Node (NDBD) – Stores data, multiple nodes for replication / Хранит данные, репликация.
• SQL Node (mysqld) – Standard MySQL server for application connections / Обычный MySQL для приложений.

Proposed Architecture / Пример архитектуры

Installation / Установка

Ubuntu/Debian:

sudo apt update
sudo apt install mysql-cluster-community-management-server \
                 mysql-cluster-community-data-node \
                 mysql-client                                             # Install Cluster packages / Установка пакетов кластера

RHEL/CentOS/AlmaLinux:

sudo dnf install https://repo.mysql.com/mysql80-community-release-el9-3.noarch.rpm
sudo dnf module disable mysql
sudo dnf install mysql-cluster-community-management-server \
                 mysql-cluster-community-data-node \
                 mysql-cluster-community-client                           # Install Cluster packages / Установка пакетов кластера

Configuration: Management Node / Настройка Management Node

/var/lib/mysql-cluster/config.ini

[NDBD DEFAULT]
NoOfReplicas=2

[MYSQLD DEFAULT]
ServerPort=3306

[MANAGEMENT]
HostName=<IP_MGM>
NodeId=1

[NDBD]
HostName=<IP_DATA_1>
NodeId=2

[NDBD]
HostName=<IP_DATA_2>
NodeId=3

[MYSQLD]
HostName=<IP_SQL>
NodeId=4

Runbook: Starting the Cluster / Запуск кластера

1. Start Management Node / Запуск MGM:

   sudo ndb_mgmd -f /var/lib/mysql-cluster/config.ini --initial           # Initial start / Первый запуск
   sudo systemctl enable ndb_mgmd && sudo systemctl start ndb_mgmd       # Enable and start / Включить и запустить

2. Start Data Nodes (on , ) / Запуск Data нод: /etc/my.cnf

   [mysqld]
   ndbcluster
   [NDBD]
   connect-string=<IP_MGM>

   sudo ndbd                                                              # Start data node / Запуск data ноды

3. Start SQL Node / Запуск SQL ноды: /etc/my.cnf

   [mysqld]
   ndbcluster
   ndb-connectstring=<IP_MGM>                                             # Connect to MGM IP / Подключение к MGM

   sudo systemctl enable mysql && sudo systemctl start mysql             # Start MySQL / Запуск MySQL

Verify Status / Проверка статуса

ndb_mgm -e show                                                           # Show cluster status / Показать статус кластера

Core Management / Управление

Connection / Подключение

mysql -h <HOST> -u <USER> -p                                              # Connect to MySQL / Подключение к MySQL
mysql -h <HOST> -u <USER> -p<PASSWORD> <DB>                               # Connect to specific DB / Подключение к базе
mysql --socket=/var/run/mysqld/mysqld.sock -u <USER> -p                  # Connect via socket / Через сокет

Database & Table Operations / Операции с БД и таблицами

SHOW DATABASES;                                                           -- List databases / Список баз
CREATE DATABASE <DB_NAME>;                                                -- Create database / Создать базу
USE <DB_NAME>;                                                            -- Switch to database / Переключиться на базу
SHOW TABLES;                                                              -- List tables / Список таблиц
DESCRIBE <TABLE>;                                                         -- Table structure / Структура таблицы
SHOW CREATE TABLE <TABLE>;                                                -- CREATE statement / Показать SQL создания
DROP TABLE <TABLE>;                                                        -- Delete table / Удалить таблицу

Working with Cluster Tables / Работа с таблицами в кластере

[!IMPORTANT] All cluster tables must use ENGINE=NDBCLUSTER.

CREATE TABLE users (
    id INT NOT NULL PRIMARY KEY,
    name VARCHAR(50)
) ENGINE=NDBCLUSTER;                                                      -- Create cluster table / Создать таблицу в кластере

Sysadmin Operations / Операции сисадмина

Service Control / Управление сервисом

sudo systemctl start mysql                                                # Start service / Запустить сервис
sudo systemctl stop mysql                                                 # Stop service / Остановить сервис
sudo systemctl restart mysql                                              # Restart service / Перезапустить сервис
sudo systemctl status mysql                                               # Service status / Статус сервиса
sudo systemctl enable mysql                                               # Enable on boot / Включить автозапуск

Runbook: Emergency Restart / Экстренный перезапуск

[!CAUTION] Restarting in production can drop active connections. Always check load first.

# 1. Check current load / Проверить текущую нагрузку
mysqladmin -u <USER> -p status
# 2. Graceful restart / Обычный перезапуск
sudo systemctl restart mysql
# 3. If stuck, force kill (Extreme cases) / Если завис - принудительно (Экстрим)
sudo killall -9 mysqld
sudo systemctl start mysql

Logs & Paths / Логи и пути

Network & Firewall / Сеть и Файрвол

# Default Port: 3306 / Порт по умолчанию: 3306
sudo ufw allow 3306/tcp                                                   # UFW: allow MySQL / UFW: разрешить MySQL
sudo firewall-cmd --permanent --add-service=mysql && sudo firewall-cmd --reload # RHEL Firewall

Security / Безопасность

User Management / Управление пользователями

CREATE USER '<USER>'@'localhost' IDENTIFIED BY '<PASSWORD>';              -- Create local user / Создать локального пользователя
CREATE USER '<USER>'@'%' IDENTIFIED BY '<PASSWORD>';                      -- Remote user / Удаленный пользователь
GRANT ALL PRIVILEGES ON <DB>.* TO '<USER>'@'localhost';                   -- Grant access / Выдать права
REVOKE ALL PRIVILEGES ON <DB>.* FROM '<USER>'@'localhost';                -- Revoke access / Отозвать права
SHOW GRANTS FOR '<USER>'@'localhost';                                     -- Show grants / Показать права
FLUSH PRIVILEGES;                                                         -- Reload / Перезагрузить права

Runbook: Reset Root Password / Сброс пароля Root

# 1. Stop service / Остановить сервис
sudo systemctl stop mysql
# 2. Start in bypass mode / Запустить без проверки прав
sudo mysqld_safe --skip-grant-tables &
# 3. Connect and reset / Подключиться и сбросить
mysql -u root
# SQL commands:
# FLUSH PRIVILEGES;
# ALTER USER 'root'@'localhost' IDENTIFIED BY '<NEW_PASSWORD>';
# FLUSH PRIVILEGES;
# 4. Restart normally / Перезапустить нормально
sudo systemctl restart mysql # Note: may need to kill mysqld_safe process first

Backup & Restore / Бэкап и восстановление

Backup Methods Comparison / Сравнение методов бэкапа

mysqldump Samples / Примеры mysqldump

mysqldump -u <USER> -p <DB> > dump.sql                                    # Dump DB / Дамп одной базы
mysqldump -u <USER> -p --all-databases | gzip > all_dbs.sql.gz            # All DBs gzipped / Все базы сжатые

Restore / Восстановление

mysql -u <USER> -p <DB> < dump.sql                                        # Restore from SQL / Восстановить из SQL
gunzip < dump.sql.gz | mysql -u <USER> -p <DB>                            # Restore from gzip / Из gzip

Troubleshooting & Tools / Устранение проблем и инструменты

Monitoring / Мониторинг

SHOW FULL PROCESSLIST;                                                    -- View active queries / Просмотр активных запросов
KILL <PROCESS_ID>;                                                        -- Terminate query / Принудительно завершить запрос
SHOW STATUS;                                                              -- Global server status / Общий статус сервера
SHOW ENGINE INNODB STATUS\G                                               -- Detailed InnoDB status / Подробный статус InnoDB

Performance Analysis / Анализ производительности

sudo mysqldumpslow /var/log/mysql/slow.log                                # Analyze slow queries / Анализ медленных запросов

EXPLAIN SELECT * FROM users WHERE name = '<USER>';                        -- Query execution plan / План выполнения запроса
ANALYZE TABLE <TABLE>;                                                    -- Update statistics / Обновить статистику
OPTIMIZE TABLE <TABLE>;                                                   -- Rebuild table index / Перестроить индекс таблицы

Logrotate Configuration / Конфигурация Logrotate

/etc/logrotate.d/mysql

/var/log/mysql/*.log {
    daily
    rotate 14
    compress
    delaycompress
    missingok
    notifempty
    create 640 mysql adm
    sharedscripts
    postrotate
        /usr/bin/mysqladmin flush-logs > /dev/null 2>&1 || true
    endscript
}

[!TIP] Use mysqladmin flush-logs to rotate binary logs: mysqladmin -u root -p flush-logs