Amazon Linux 2023에서 MariaDB 설치 및 실행 요약

Amazon Linux 2023에서 MariaDB 설치 및 실행 요약

1. 패키지 설치

sudo dnf update -y
sudo dnf install -y mariadb105-server

> mariadb105-server는 Amazon Linux 2023에서 제공하는 10.5 버전의 MariaDB 서버입니다.
mariadb105-common, mariadb105-libs 등은 자동으로 함께 설치됩니다.

2. 데이터 디렉터리 초기화 (필요시)

sudo mariadb-install-db --user=mysql --basedir=/usr --datadir=/var/lib/mysql

> /var/lib/mysql 폴더에 시스템 테이블이 생성됩니다.
이미 초기화되어 있으면 생략해도 됩니다.

3. 서비스 시작 및 자동 실행 설정

sudo systemctl enable --now mariadb

> 위 명령으로 서비스가 즉시 실행되고, 다음 부팅 시 자동으로 시작됩니다.

상태 확인:

systemctl status mariadb

> active (running) 이 표시되면 정상적으로 구동된 것입니다.

4. 보안 설정 (초기 설정)

sudo mysql_secure_installation

루트 비밀번호 설정

익명 사용자 제거

원격 루트 접속 차단

테스트 DB 삭제

권한 테이블 재로드


> 모두 “Y”로 응답하면 안전하게 설정됩니다.

5. 접속 테스트

sudo mysql -u root -p

> 비밀번호를 입력하면 MariaDB 콘솔에 접속됩니다.

버전 확인:

SELECT VERSION();

6. 자주 사용하는 명령어 모음

기능과 명령어

서비스 시작 sudo systemctl start mariadb
서비스 중지 sudo systemctl stop mariadb
재시작 sudo systemctl restart mariadb
상태 확인 systemctl status mariadb
자동 시작 설정 sudo systemctl enable mariadb
로그 확인 sudo journalctl -u mariadb -n 100

7. 접속 오류 해결

⚠️ 오류:

ERROR 2002 (HY000): Can't connect to local MySQL server through socket '/var/lib/mysql/mysql.sock'

원인: MariaDB 서비스가 실행되지 않았거나 소켓 파일이 없음
해결:

sudo systemctl start mariadb
sudo systemctl status mariadb

⚠️ 오류:

Unit mariadb.service not found

원인: 서버 패키지(mariadb105-server) 미설치
해결:

sudo dnf install -y mariadb105-server

8. 원격 접속 허용 (선택사항)

sudo vi /etc/my.cnf.d/server.cnf

[mysqld] 섹션 아래에 추가:

bind-address = 0.0.0.0

적용 후 재시작:

sudo systemctl restart mariadb

> AWS EC2의 보안 그룹에서 TCP 3306 포트를 허용해야 원격 접속이 가능합니다.

✅ 설치 확인 요약

mariadb --version
systemctl status mariadb --no-pager
sudo mysql -u root -e "SELECT VERSION();"

정상 출력 시, 설치 및 실행이 완료된 상태입니다.

이 절차를 따라 하시면

✔️ 서비스 유닛 누락
✔️ 소켓 에러
✔️ 접속 실패
같은 문제없이 MariaDB가 안정적으로 동작하게 됩니다.