Changes between Initial Version and Version 1 of MariaDB 설치

Timestamp:

Nov 11, 2025, 10:35:27 AM (4 weeks ago)

Author:

yongwoo

Comment:

—

MariaDB 설치

@@ +1 @@
+[[PageOutline]]
+= MariaDB 설치 =
+== 1. 배포판 패키지 ==
+=== 1.1. 기본 패키지 ===
+RHEL 8에 설치되는 mariadb 버전은 10.3이 디폴트다. RHEL 9에 설치되는 mariadb 버전은 10.5가 디폴트다. 디폴트 버전을 설치할 때는 바로 설치하면 된다.
+
+gssapi 로그인을 사용할 것이 아니라면 mariadb-gssapi-server 패키지는 지우는 것이 낫다.
+{{{
+# dnf install mariadb-server
+# rpm -e mariadb-gssapi-server
+}}}
+
+=== 1.2. Application Stream 패키지 ===
+기본 패키지가 아닌 Application Stream에서 지원하는 패키지를 설치하려면 먼저 해당 버전의 스트림을 활성화해야 한다.
+
+예를 들어 RHEL 8에서 10.5 버전을 설치하려면 먼저 mariadb:10.5 스트림을 활성화한다. mariadb:10.5 스트림은 RHEL 8.4부터 지원한다.
+{{{
+# dnf module enable mariadb:10.5
+}}}
+
+그러면 다음과 같이 mariadb:10.5 스트림이 활성화된 것을 확인할 수 있다.
+{{{
+# dnf module list mariadb
+Rocky Linux 8 - AppStream
+Name               Stream             Profiles                          Summary
+mariadb            10.3 [d]           client, galera, server [d]        MariaDB Module
+mariadb            10.5 [e]           client, galera, server [d]        MariaDB Module
+
+Hint: [d]efault, [e]nabled, [x]disabled, [i]nstalled
+}}}
+
+다음은 기본 패키지 설치과정과 동일하다. gssapi 로그인을 사용할 것이 아니라면 mariadb-gssapi-server 패키지는 지우는 것이 낫다.
+{{{
+# dnf install mariadb-server
+# rpm -e mariadb-gssapi-server
+}}}
+
+
+== 2. MariaDB 사이트 패키지 ==
+https://mariadb.com/kb/en/yum/
+
+배포판에서 기본으로 제공하는 기능이 아닌 다른 기능을 사용하려고 하면 mariadb.org의 패키지로 설치하는 편이 좋다.
+
+=== 2.1. repository 설정 ===
+==== 2.1.1. 최신 버전의 repository 설정 ====
+{{{
+$ wget https://downloads.mariadb.com/MariaDB/mariadb_repo_setup
+# bash mariadb_repo_setup
+}}}
+
+==== 2.1.2. 특정 버전의 repository 설정 ====
+
+RHEL 8 등에 최신 버전이 아닌 10.5 버전을 설치하고 싶다면 두 가지 방법으로 repository를 구성하면 된다.
+
+하나는 https://mariadb.com/kb/en/mariadb-package-repository-setup-and-usage/ 에서 제공하는 방법이다.
+{{{
+# curl -LsS https://r.mariadb.com/downloads/mariadb_repo_setup | bash -s -- --mariadb-server-version="mariadb-10.5"
+}}}
+
+다른 하나는 다음과 같다.
+
+[https://downloads.mariadb.org/mariadb/repositories/ MariaDB Repository Configuration Tool]에서 Redhat > Red Hat EL 8 (x86_64) > 10.3 을 차례로 선택하면 권장하는 repository 설정을 보여주는 데 이를 복사해서 /etc/yum.repos.d/MariadDB.repo 파일을 만들어준다.
+
+{{{
+# MariaDB 10.3 RedHat repository list - created 2021-05-06 03:02 UTC
+# http://downloads.mariadb.org/mariadb/repositories/
+[mariadb]
+name = MariaDB
+baseurl = http://yum.mariadb.org/10.3/rhel8-amd64
+module_hotfixes=1
+gpgkey=https://yum.mariadb.org/RPM-GPG-KEY-MariaDB
+gpgcheck=1
+}}}
+
+==== 2.1.3. 특정 마이너 릴리즈의 repository 설정 ====
+일반적인 경우는 아니나 소수점 둘째 자리(마이너 릴리즈)까지 버전을 특정해서 설치하고 싶은 경우에는 MariadDB.repo의 baseurl을 yum.maradb.org의 특정 마이너 릴리즈로 설정하면 된다.
+
+예를 들어 repository를 CentOS 7의 MariaDB 10.3.14에 고정하려는 경우 /etc/yum.repos.d/MariaDB.repo를 다음과 같이 지정한다.
+{{{
+[mariadb]
+name = MariaDB-10.3.14
+baseurl=http://yum.mariadb.org/10.3.14/centos7-amd64
+# alternative: baseurl=http://archive.mariadb.org/mariadb-10.3.14/yum/centos7-amd64
+gpgkey=https://yum.mariadb.org/RPM-GPG-KEY-MariaDB
+gpgcheck=1
+}}}
+
+yum.mariadb.org에서 원하는 마이너 릴리즈가 없다면 archive.mariadb.org에서 찾으면 된다.
+
+=== 2.2. MariaDB 설치 ===
+{{{
+dnf install MariaDB-server
+}}}
+
+=== 2.3. 설정 파일 수정 ===
+* /etc/my.cnf.d/mysql-clients.cnf
+* /etc/my.cnf.d/server.cnf
+* /etc/fail2ban/paths-fedora.local
+ - fail2ban가 찾는 기본 로그 파일 위치는 /var/log/mariadb/mariadb.log이다. 따라서 로그 파일 위치가 /var/log/mariadb/mariadb.log가 아니라면 적절하게 수정해준다.
+* /etc/logrotate.d/mysql
+ - logrotate가 찾는 기본 로그 파일 위치는 /var/lib/mysql/mysqld.log이다. 따라서 로그 파일 위치가 /var/lib/mysql/mysqld.log가 아니라면 적절하게 수정해준다.
+* /etc/my.cnf.d/server-tls.cnf
+ - MariaDB 접속을 암호화하려면 추가한다.
+
+=== 2.4. MariaDB 시작 ===
+{{{
+# systemctl enable --now mariadb
+}}}
+
+=== 2.5. 스키마 업데이트 ===
+기본 MariaDB에서 업그레이드 설치한 것이라면 스키마도 업데이트
+{{{
+# mysql_upgrade -u root -p
+}}}
+
+
+=== 2.6. 배포판 패키지와 차이점 ===
+||'''구분'''||'''배포판'''||'''MariaDB'''||
+||패키지 이름||mariadb-server||MariaDB-server||
+||서버 설정 파일||/etc/my.cnf.d/mariadb-server.cnf||/etc/my.cnf.d/server.cnf||
+||로그 디렉토리||/var/log/mariadb||없음|| 
+||로그 파일||/var/log/mariadb/mariadb.log||없음|| 
+||logrotate 설정 파일 위치||/etc/logrotate.d/mariadb||/etc/logrotate.d/mysql|| 
+||logrotate 설정의 로그 파일 위치||/var/log/mariadb/mariadb.log||/var/lib/mysql/mysqld.log|| 
+||PID 디렉토리||/run/mariadb||없음||
+||PID 파일||/run/mariadb/mariadb.pid||/var/lib/mysql/[hostname].pid||
+
+배포판 패키지와 MariaDB 사이트 패키지를 둘다 사용할 때는 관리의 편의를 위하여 다음과 같이 하는 것을 추천한다.
+- MariaDB 사이트 패키지의 서버 설정 파일을 /etc/my.cnf.d/mariadb-server.cnf로 변경한다.
+- MariaDB 사이트 패키지의 logrotate 설정 파일을 /etc/logrotate.d/mariadb로 변경한다.
+- MariaDB 사이트 패키지의 로그 디렉토리와 PID 디렉토리를 tmpfiles.d 를 이용해 /var/log/mariadb/, /run/mariadb/ 로 배포판과 동일하게 만든다.
+- 로그 파일과 PID 파일을 배포판과 동일하게 정해준다.
+{{{
+[mysqld]
+...
+log-error=/var/log/mariadb/mariadb.log
+pid-file=/run/mariadb/mariadb.pid
+}}}
+
+==== 2.6.1. tmpfiles.d ====
+mariadb repository에서 설치한 MariaDB의 pid 저장 위치를 RHEL 배포판의 저장 위치와 동일하게 변경하기 위해서 pid-file=/run/mariadb/mariadb.pid 로 지정하면 /run/mariadb 디렉토리가 재부팅할 때마다 자동으로 만들어지도록 설정해야 한다.
+
+이 때 사용하는 것이 tmpfiles.d 이다. 시스템 설정은 /usr/lib/tmpfiles.d 에, 사용자가 커스터마이징한 설정은 /etc/tmpfiles.d 에 저장한다. 따라서 /usr/lib/tmpfiles.d/mariadb.conf 파일을 /etc/tmpfiles.d/ 디렉토리에 복사하고 다음 내용을 추가하면 된다.
+{{{
+d /var/lib/mysql 0755 mysql mysql -
+# MariaDB의 pid 파일 위치를 RHEL 기본 설정인 /run/mariadb/로 바꾸려면
+# /run/mariadb 디렉토리가 만들어져 있어야 한다.
+# RHEL 배포판에서는 이미 지정되어 있으므로 따로 지정할 필요가 없다.
+# 추가한 이후에는 재부팅하거나 systemd-tmpfiles --create 명령을 내린다.
+# 자세한 내용은 tmpfiles.d man 페이지 참고.
+d /run/mariadb 0755 mysql mysql -
+d /var/log/mariadb 0750 mysql mysql -
+}}}
+
+==== 2.6.2. fail2ban ====
+fail2ban으로 MariaDB의 로그 파일을 검사하고 있다면, fail2ban 설정도 확인해야 한다.
+
+
+== 3. 윈도우즈 버전 ==
+윈도우 버전의 MariaDB는 다음 위치에서 순서대로 설정 파일을 찾는다. 이 순서는 mysqld --help 또는 mysqld --verbose --help 명령으로 알아볼 수 있다.
+
+1. MariaDB 서비스를 시작할 때 명령행에서 --defaults-file=# 옵션으로 지정한 파일. (리눅스도 마찬가지)
+1. %SYSTEMROOT%\my.ini (예) C:\WINDOWS\my.ini
+2. %SYSTEMROOT%\my.cnf  (예) C:\WINDOWS\my.cnf
+3. %SYSTEMDRIVE%\my.ini  (예) C:\my.ini
+4. %SYSTEMDRIVE%\my.cnf   (예) C:\my.cnf
+5. MariaDB 설치 폴더\my.ini (예) C:\Program Files\MariaDB 10.3\my.ini 
+6. MariaDB 설치 폴더\my.cnf (예) C:\Program Files\MariaDB 10.3\my.cnf 
+7. MariaDB 데이터 폴더\my.ini (예) C:\Program Files\MariaDB 10.3\data\my.ini 
+8. MariaDB 데이터 폴더\my.cnf (예) C:\Program Files\MariaDB 10.3\data\my.cnf
+
+<주의> MariaDB 서비스를 시작할 때 명령행에서 --defaults-extra-file=# 옵션으로 지정한 파일은 위 설정 파일을 읽은 후 추가로 읽는다.. (리눅스도 동일)
+
+윈도우 설치 프로그램이 MariaDB 데이터 폴더\my.ini 파일을 만들기 때문에 특별한 일이 없는한 MariaDB 데이터 폴더\my.ini 파일을 설정 파일로 사용하는 것을 권장한다.
+
+=== 3.1. 리눅스 설정과 달라지는 점 ===
+* socket
+ - 윈도우에서는 유닉스의 소켓 파일에 해당하는 네임드 파이프가 있으나 대부분 TCP/IP보다 느리다. 따라서 굳이 지정할 필요가 없다.
+* 로그 파일 위치는 권한 문제 때문에 MariaDB 데이터 폴더로 지정하는 것이 편하다. 
+{{{
+[mysqld]
+datadir=C:/Program Files/MariaDB 10.3/data
+log-error=C:/Program Files/MariaDB 10.3/data/mariadb.log
+pid-file=C:/Program Files/MariaDB 10.3/data/mariadb.pid
+}}}
+----
+[WikiStart 처음으로]
+