안녕하세요. 제스트 정보기술 기술지원팀 입니다.

​

MariaDB의 설정 파일은 서버와 클라이언트의 동작을 제어하는 핵심 구성 요소입니다.

일반적으로 my.cnf로 알려져 있지만, 실제로는 여러 개의 .cnf 파일로 나뉘어 구성되며,

운영체제 종류나 설치 방식에 따라 구조와 위치가 달라질 수 있습니다.

​

이번 글에서는 Linux 환경에서 대표적인 Red Hat 계열과 Debian 계열을 예시로 들어,

MariaDB 설정 파일의 구조와 각 파일의 역할을 살펴보겠습니다.

​

먼저 설치 환경은 아래와 같습니다.

​

OS : Rocky Linux 9.5 & Ubuntu 24.04.2

DB : MariaDB 10.11

설치 방식 : yum, dnf, apt 등 패키지 관리자를 통한 설치 기준

​

​

1. MariaDB 주요 설정 파일 구조 비교

Red Hat / Debian MariaDB 기본 설정 구조

​

RedHat 계열 (RHEL, CentOS, Rocky Linux 등)

​

1. /etc/my.cnf

Red Hat 계열 Linux 배포판에서 MariaDB가 가장 먼저 읽는 기본 설정 파일

주로 !includedir /etc/my.cnf.d/ 지시어를 통해 하위 디렉토리의 파일들을 포함하며,

본 파일 내 변수(파라미터)를 선언하는 것도 가능합니다.

​

2. /etc/my.cnf.d/

추가적인 설정 파일들을 저장하는 디렉토리

.cnf 파일들은 사전순(알파벳, 숫자 포함) 으로 순차적으로 읽히며,

나중에 읽힌 설정이 앞선 설정을 덮어씌우게 됩니다.

따라서 동일한 파라미터를 여러 파일에서 중복 선언하지 않도록 주의해야 합니다.

​

2-1. 주요 설정 파일

- client.cnf ​-

MariaDB 클라이언트 도구(mysql, mysqldump 등) 전반의 설정을 담당

주요 항목 : port, socket, default-character-set 등 접속/인증과 관련

- mysql-clients.cnf -

client.cnf와 비슷하지만 mysqldump, mysqlbinlog 등 각 도구에 대한 개별 설정 파일

- mariadb-server.cnf -

MariaDB 서버 데몬(mariadbd 또는 mysqld)의 핵심 설정을 포함

MariaDB 서버 전체가 적용 대상이며, 데이터베이스 서버가 구동되기 위한 핵심 설정이 정의됩니다.

버퍼 설정, 접속자 수 제한, 로그 경로 등 성능과 안정성에 직결되는 항목을 포함하고 있으며

클러스터링, 복제 등 고급 옵션도 이 파일에서 설정합니다.

​

Debian 계열 (Debian, Ubuntu 등)

설정 구조는 Red Hat 계열과 유사하지만, 더 세분화된 디렉토리 구조를 사용합니다.

​

1. /etc/mysql/

MariaDB 설정 파일들이 모여있는 기본 설정 루트 경로이며, 대부분의 설정 파일들이 위치합니다.

​

2. /etc/mysql/mariadb.cnf

- 역할 -

레드햇 계열의 my.cnf와 유사하게, !includedir 지시어를 통해 mariadb.conf.d 등의 하위 디렉토리를 포함합니다.

일반적으로 서버 또는 클라이언트 설정을 개별 파일로 분리하기 위한 중간 허브 역할을 합니다.

- 특징 -

/etc/mysql/my.cnf -> /etc/alternatives/my.cnf -> /etc/mysql/mariadb.cnf 순서로 심볼릭 링크 연결됨

​

3. /etc/mysql/conf.d/

MySQL 호환을 위한 클라이언트 도구 설정 디렉토리

내부의 .cnf 파일 들이 레드햇 계열의 mysql-clients.cnf 와 유사한 역할을 수행합니다.

​

4. /etc/mysql/mariadb.conf.d/

MariaDB 서버 및 클라이언트의 상세 설정 디렉토리

파일 명 앞 숫자 순으로 읽어오며, Red Hat과 동일하게 중복 선언 주의 필요

​

4-1. 주요 설정 파일

- 50-client.cnf -

MariaDB 클라이언트 프로그램 설정 ( 예: mysql, mysqldump)

레드햇 계열의 client.cnf 역할을 합니다.

- 50-server.cnf -

MariaDB 서버 데몬(mariadbd 또는 mysqld)

레드햇 계열의 mariadb-server.cnf 역할을 합니다.

​

---

위와 같이 일반적으로 알고 계신 my.cnf 뿐만 아니라 다양한 설정 파일로 세분화하여 설정 관리가 가능합니다.

​

​

수동 설치 시 참고 사항

​

패키지 관리자를 통해 설치 할 경우 기본 구조가 자동으로 생성 되지만,

tar파일을 사용하여 수동으로 설치하는 경우에는 아래와 같은 방법을 사용 가능합니다.

​

1. 미리 my.cnf등 설정 파일을 작성하여 업로드

2. 설치 바이너리에서 제공되는 샘플(default_my.cnf) 사용

※ 해당 파일은 아래 경로에서 찾을 수 있습니다.

MariaDB 10.11 [mysql경로]/mysql-test/include/default_my.cnf

MariaDB 11.7 [mysql경로]/mariadb-test/include/default_my.cnf

​

현재 MariaDB가 어떤 설정을 읽어오는지 확인

​

## 경로와 순서 확인 가능 mysqld --verbose --help | grep -A1 "Default options"

​

다음 시간에는 my.cnf 파일 내 [client], [mysqld] 등 섹션에 대해서 알아보도록 하겠습니다.

 

출처 : https://xestinf.tistory.com/149