MySQL에서 업그레이드하기

사전 요구 사항

• VillageSQL 바이너리: VillageSQL 바이너리를 준비하세요(소스에서 컴파일하거나 다운로드).
• MySQL 버전: VillageSQL은 MySQL 8.4 LTS를 기반으로 합니다. MySQL 8.4에서 업그레이드하는 것이 지원되는 경로입니다.

1단계: 데이터 백업

옵션 A: 논리 백업(mysqldump)

mysqldump -u root -p --all-databases --events --routines --triggers > full_backup.sql

옵션 B: 물리 백업(데이터 디렉터리)

# Stop the server first (see Step 2)
cp -r /var/lib/mysql /var/lib/mysql-backup

2단계: MySQL 서버 중지

sudo systemctl stop mysql
# OR
sudo systemctl stop mysqld

sudo service mysql stop

mysqladmin -u root -p shutdown

3단계: 바이너리 교체

방법 A: 설치 디렉터리 교체(권장)

1. VillageSQL을 압축 해제/설치하세요. 새 디렉터리에, 예를 들어 /usr/local/villagesql-8.4에 설치합니다.
2. 심볼릭 링크를 업데이트하세요:
   # Remove link to old MySQL
   sudo unlink /usr/local/mysql
   
   # Link to VillageSQL
   sudo ln -s /usr/local/villagesql-8.4 /usr/local/mysql
   
3. 권한을 확인하세요: 데이터베이스를 실행하는 사용자(보통 mysql)가 새 바이너리에 대한 실행 권한을 가지는지 확인합니다.

방법 B: 바이너리 덮어쓰기

# Assuming you are in the VillageSQL build directory
sudo make install

4단계: 구성 확인

[mysqld]
datadir=/var/lib/mysql  # Should point to your EXISTING data
socket=/var/run/mysqld/mysqld.sock

5단계: VillageSQL 시작

sudo systemctl start mysql

/usr/local/mysql/bin/mysqld_safe --user=mysql &

자동 업그레이드

6단계: 설치 확인

mysql -u root -p

SELECT @@version, @@version_comment;

문제 해결

• “Data Dictionary Upgrade Failed”: 서버가 시작을 거부하면, 다운그레이드(예: 8.4에서 8.0)를 시도하고 있거나 데이터 파일이 손상되었을 수 있습니다. 오류 로그를 확인하세요.
• 권한 오류: mysql OS 사용자가 datadir와 새 VillageSQL 설치 디렉터리를 소유하는지 확인하세요.
  sudo chown -R mysql:mysql /var/lib/mysql
  

함께 보기

• MySQL의 스키마 마이그레이션 — 업그레이드 후 안전한 DDL 변경 실행하기
• MySQL 백업 전략 — 업그레이드 전에 백업하기
• Docker에서 MySQL 실행하기 — 대신 컨테이너에서 MySQL이나 VillageSQL 실행하기
• 지원 종료 후 MySQL 8.0을 8.4로 업그레이드하기 — 아직 8.0이라면 먼저 8.4로 가기