arc/hesabixAPI/docs/APPLY_MYSQL_CONFIG.md

راهنمای اعمال تنظیمات MySQL - Phase 1

این راهنما نحوه اعمال تنظیمات بهینه‌سازی MySQL را روی MySQL نصب شده شرح می‌دهد.

---

📋 پیش‌نیازها

1. دسترسی Root یا Super User به MySQL
2. دسترسی Write به فایل کانفیگ MySQL (برای تنظیمات Persistent)
3. MySQL نسخه 5.7 یا بالاتر

---

🚀 روش 1: استفاده از اسکریپت Bash (پیشنهادی)

اجرای اسکریپت

cd /var/www/ark/hesabixAPI
chmod +x scripts/apply_mysql_config.sh

# روش 1: استفاده از Environment Variables
export DB_HOST=localhost
export DB_PORT=3306
export DB_USER=root
export DB_PASSWORD=your_password
./scripts/apply_mysql_config.sh

# روش 2: اجرای مستقیم (رمز عبور را وارد می‌کند)
./scripts/apply_mysql_config.sh

آنچه اسکریپت انجام می‌دهد:

1. ✅ تنظیمات Runtime (بدون نیاز به Restart):

   • افزایش max_connections به 2000
   • تنظیم wait_timeout و interactive_timeout
   • تنظیم innodb_lock_wait_timeout
   • فعال‌سازی Slow Query Log

2. ✅ ایجاد فایل کانفیگ Persistent:

   • پیدا کردن فایل کانفیگ MySQL
   • ایجاد Backup از فایل موجود
   • اضافه کردن تنظیمات Hesabix به فایل کانفیگ

3. ✅ نمایش تنظیمات اعمال شده:

   • بررسی و نمایش تمام تنظیمات جدید
   • نمایش وضعیت اتصالات فعلی

---

🗄️ روش 2: استفاده از فایل SQL

اگر می‌خواهید دستی تنظیمات را اعمال کنید:

# اجرای فایل SQL
mysql -u root -p < scripts/apply_mysql_config_sql.sql

# یا با مشخص کردن Host و Port
mysql -h localhost -P 3306 -u root -p < scripts/apply_mysql_config_sql.sql

محتوای فایل SQL:

• تنظیمات Connection (max_connections, timeouts)
• تنظیمات InnoDB
• فعال‌سازی Slow Query Log
• بررسی و نمایش تنظیمات

---

🔍 روش 3: بررسی تنظیمات فعلی

برای بررسی تنظیمات MySQL بدون اعمال تغییرات:

cd /var/www/ark/hesabixAPI
python3 scripts/check_mysql_config.py

یا به صورت مستقیم:

python3 -c "
import sys
sys.path.insert(0, '/var/www/ark/hesabixAPI')
from scripts.check_mysql_config import check_mysql_config
check_mysql_config()
"

---

📝 اعمال تنظیمات Persistent (دستی)

پیدا کردن فایل کانفیگ MySQL

# بررسی مسیرهای معمول
ls -la /etc/mysql/my.cnf
ls -la /etc/my.cnf
ls -la /usr/local/mysql/my.cnf

# یا پیدا کردن با دستور mysqld
mysqld --help --verbose | grep -A 1 "Default options"

اضافه کردن تنظیمات

1. کپی فایل mysql.conf:

cd /var/www/ark/hesabixAPI

# برای MySQL در Docker:
# (این قبلاً در docker-compose.yml تنظیم شده است)

# برای MySQL نصب شده روی سیستم:
sudo cp mysql.conf /etc/mysql/conf.d/hesabix-optimization.cnf

# یا اضافه کردن به فایل اصلی:
sudo nano /etc/mysql/my.cnf
# محتوای mysql.conf را اضافه کنید

2. تست فایل کانفیگ:

# تست Syntax
sudo mysqld --help --verbose | head -n 1

# یا در MySQL 8.0
mysql --validate-config

3. Restart MySQL:

# برای systemd:
sudo systemctl restart mysql

# یا برای service:
sudo service mysql restart

# برای Docker:
docker-compose restart db

---

⚙️ تنظیمات مهم

1. max_connections

-- بررسی مقدار فعلی
SHOW VARIABLES LIKE 'max_connections';

-- افزایش Runtime (بدون Restart)
SET GLOBAL max_connections = 2000;

-- بررسی جدید
SHOW VARIABLES LIKE 'max_connections';

برای Persistent (در my.cnf):

[mysqld]
max_connections = 2000

2. innodb_buffer_pool_size

این تنظیم حتماً نیاز به Restart دارد.

محاسبه مقدار مناسب:

70-80% از RAM سیستم
مثال: برای 32GB RAM = 22-25GB

# بررسی RAM سیستم
free -h

# محاسبه مقدار (مثال برای 32GB RAM)
# 32GB * 0.7 = 22.4GB = 22400M

تنظیم در my.cnf:

[mysqld]
innodb_buffer_pool_size = 22400M
innodb_buffer_pool_instances = 8

3. Slow Query Log

-- فعال‌سازی Runtime
SET GLOBAL slow_query_log = 'ON';
SET GLOBAL long_query_time = 2;

-- بررسی مسیر Log File
SHOW VARIABLES LIKE 'slow_query_log_file';

-- مشاهده Slow Queries
SELECT * FROM mysql.slow_log ORDER BY start_time DESC LIMIT 10;

---

🔍 بررسی تنظیمات اعمال شده

بررسی تنظیمات مهم:

-- Connection Settings
SHOW VARIABLES LIKE 'max_connections';
SHOW VARIABLES LIKE 'wait_timeout';
SHOW VARIABLES LIKE 'interactive_timeout';

-- InnoDB Settings
SHOW VARIABLES LIKE 'innodb_buffer_pool_size';
SHOW VARIABLES LIKE 'innodb_buffer_pool_instances';
SHOW VARIABLES LIKE 'innodb_lock_wait_timeout';

-- Query Logging
SHOW VARIABLES LIKE 'slow_query_log';
SHOW VARIABLES LIKE 'long_query_time';
SHOW VARIABLES LIKE 'slow_query_log_file';

-- Performance Schema
SHOW VARIABLES LIKE 'performance_schema';

بررسی وضعیت اتصالات:

-- تعداد اتصالات فعلی
SHOW STATUS LIKE 'Threads_connected';

-- تعداد اتصالات حداکثر
SHOW VARIABLES LIKE 'max_connections';

-- نمایش اتصالات فعال
SELECT 
    id,
    user,
    host,
    db,
    command,
    time,
    state,
    LEFT(info, 100) as query_preview
FROM information_schema.processlist
WHERE command != 'Sleep'
ORDER BY time DESC;

---

📊 مثال خروجی اسکریپت

🚀 شروع اعمال تنظیمات MySQL Phase 1...
✅ اتصال به MySQL برقرار شد
📊 بررسی نسخه MySQL...
   نسخه MySQL: 8.4.0

📋 تنظیمات فعلی MySQL:
   max_connections: 151
   innodb_buffer_pool_size: 134217728 (128MB)

🔧 اعمال تنظیمات Runtime (بدون نیاز به Restart)...
   افزایش max_connections از 151 به 2000...
   ✅ max_connections به 2000 افزایش یافت
   ✅ Timeouts تنظیم شد
   ✅ Slow Query Log فعال شد

📝 ایجاد فایل کانفیگ برای تنظیمات Persistent...
   فایل کانفیگ پیدا شد: /etc/mysql/my.cnf
   ✅ Backup ایجاد شد: /etc/mysql/my.cnf.backup.20250127_120000
   ✅ تنظیمات به فایل کانفیگ اضافه شد
   ⚠️  برای اعمال کامل تنظیمات، MySQL را Restart کنید

✅ بررسی تنظیمات اعمال شده:
   max_connections: 2000
   wait_timeout: 600
   slow_query_log: ON

✅ اعمال تنظیمات MySQL Phase 1 تکمیل شد!

---

⚠️ نکات مهم

1. Backup قبل از تغییرات

همیشه قبل از تغییر کانفیگ MySQL، Backup بگیرید:

# Backup فایل کانفیگ
sudo cp /etc/mysql/my.cnf /etc/mysql/my.cnf.backup.$(date +%Y%m%d)

# Backup Database
mysqldump -u root -p --all-databases > backup_$(date +%Y%m%d).sql

2. تست تنظیمات

بعد از اعمال تنظیمات:

1. ✅ بررسی MySQL Start می‌شود
2. ✅ بررسی Application به MySQL متصل می‌شود
3. ✅ بررسی Performance بهبود یافته است

3. Monitoring

بعد از اعمال تنظیمات، وضعیت را Monitor کنید:

# بررسی Health Check
curl http://localhost:8000/api/v1/health/database

# بررسی Logs
tail -f /var/log/mysql/slow-query.log

# بررسی Connection Pool
curl http://localhost:8000/api/v1/health | jq .data.connection_pool

---

🐳 برای MySQL در Docker

اگر از Docker استفاده می‌کنید:

روش 1: استفاده از Volume (پیشنهادی)

در docker-compose.yml:

services:
  db:
    volumes:
      - ./mysql.conf:/etc/mysql/conf.d/custom.cnf:ro

سپس:

docker-compose restart db

روش 2: اجرای دستورات در Container

# ورود به Container
docker exec -it hesabix-mysql bash

# اجرای دستورات SQL
mysql -u root -p < /path/to/apply_mysql_config_sql.sql

# یا به صورت مستقیم
docker exec -i hesabix-mysql mysql -u root -p < scripts/apply_mysql_config_sql.sql

---

❓ عیب‌یابی

مشکل 1: MySQL Start نمی‌شود

# بررسی Logs
sudo tail -f /var/log/mysql/error.log

# تست Syntax Config
sudo mysqld --help --verbose | head -n 1

# حذف تنظیمات مشکل‌دار از my.cnf

مشکل 2: تنظیمات اعمال نمی‌شوند

-- بررسی اینکه آیا تنظیمات از Config File خوانده می‌شوند
SHOW VARIABLES LIKE 'max_connections';

-- اگر مقدار تغییر نکرده، MySQL را Restart کنید

مشکل 3: دسترسی به MySQL

# بررسی اینکه MySQL در حال اجراست
sudo systemctl status mysql

# Restart MySQL
sudo systemctl restart mysql

---

📚 منابع بیشتر

• MySQL Documentation
• MySQL Performance Tuning
• Phase 1 Implementation Guide

---

موفق باشید! 🚀