[MariaDB] Galera 클러스터 구축 8: 새로운 노드 추가 및 클러스터 확장

 이번 글에서는 기존에 구성된 Galera 클러스터(3노드)에 새로운 노드(mariadb4)를 추가하는 과정을 단계별로 설명합니다. 이 과정을 통해 클러스터의 가용성과 확장성을 높일 수 있으며, 실무 환경에서도 자주 활용되는 중요한 작업입니다.


1. 환경 정보

노드 이름 IP 주소
mariadb1 192.168.155.51
mariadb2 192.168.155.52
mariadb3 192.168.155.53
mariadb4 192.168.155.54


2. 신규 노드 초기 설정 (mariadb4)

IP설정 및 hostname 설정

# hostnamectl set-hostname mariadb4
# nmcli connection modify enp1s0 ipv4.addresses 192.168.155.54/24 ipv4.gateway 192.168.155.1 ipv4.dns 8.8.8.8 autoconnect on ipv4.method manual

방화벽 설정

새로운 노드에서 Galera 클러스터 통신을 위한 포트를 열어줍니다.

# firewall-cmd --add-port=3306/tcp --permanent   # MySQL/MariaDB 포트
# firewall-cmd --add-port=4567/tcp --permanent   # Galera 복제 트래픽
# firewall-cmd --add-port=4567/udp --permanent   # Galera 복제 트래픽 (UDP)
# firewall-cmd --add-port=4568/tcp --permanent   # IST (Incremental State Transfer)
# firewall-cmd --add-port=4444/tcp --permanent   # SST (State Snapshot Transfer)
# firewall-cmd --reload

호스트 파일 설정

모든 노드(기존 노드 포함)에서 새로운 노드의 호스트 정보를 추가합니다.

# vi /etc/hosts

# Galera Cluster Nodes
192.168.155.51 mariadb1
192.168.155.52 mariadb2
192.168.155.53 mariadb3
192.168.155.54 mariadb4

3. MariaDB 패키지 설치 (mariadb4)

MariaDB 저장소 설정

MariaDB 10.6 저장소를 설정합니다. 자세한 설정 방법은 MariaDB 공식 저장소 설정 가이드를 참고하세요.

  • /etc/yum.repos.d/MariaDB.repo 파일 생성
# vi /etc/yum.repos.d/MariaDB.repo
...
# MariaDB 10.6 RedHatEnterpriseLinux repository list - created 2025-06-11 14:02 UTC
# <https://mariadb.org/download/>
[mariadb]
name = MariaDB
# rpm.mariadb.org is a dynamic mirror if your preferred mirror goes offline. See <https://mariadb.org/mirrorbits/> for details.
# baseurl = <https://rpm.mariadb.org/10.6/rhel/$releasever/$basearch>
baseurl = <https://tw1.mirror.blendbyte.net/mariadb/yum/10.6/rhel/$releasever/$basearch>
module_hotfixes = 1
# gpgkey = <https://rpm.mariadb.org/RPM-GPG-KEY-MariaDB>
gpgkey = <https://tw1.mirror.blendbyte.net/mariadb/yum/RPM-GPG-KEY-MariaDB>
gpgcheck = 1

패키지 설치

[root@mariadb4 ~]# sudo yum install -y MariaDB-server MariaDB-client MariaDB-common

4. 클러스터 설정 파일 구성

기존 노드 설정 수정 (mariadb1~3)

기존 모든 노드의 /etc/my.cnf.d/server.cnf 파일에서 wsrep_cluster_address 설정을 업데이트합니다.

기존 노드의 [galera] 섹션에 아래와 같이 mariadb4의 IP를 추가합니다. 변경 후에는 반드시 MariaDB 서비스를 재시작해야 설정이 반영됩니다.

[galera]
wsrep_cluster_address=gcomm://192.168.155.51,192.168.155.52,192.168.155.53,192.168.155.54

신규 노드 설정 (mariadb4)

/etc/my.cnf.d/server.cnf 파일의 [galera] 섹션을 다음과 같이 구성합니다.

[galera]
# Galera 기본 설정
wsrep_on=ON                                           # Write-Set 복제 기능 활성화
wsrep_provider=/usr/lib64/galera-4/libgalera_smm.so   # WSREP 프로바이더 모듈 경로
wsrep_cluster_address=gcomm://192.168.155.51,192.168.155.52,192.168.155.53,192.168.155.54

# 복제 설정
binlog_format=row                                     # Row 기반 복제 (권장)
default_storage_engine=InnoDB                        # 기본 스토리지 엔진
innodb_autoinc_lock_mode=2                            # Auto increment 잠금 모드

# 네트워크 설정
bind-address=0.0.0.0                                  # 모든 인터페이스에서 접속 허용

# 클러스터 식별 정보
wsrep_cluster_name="galera-cluster"                   # 클러스터 이름
wsrep_node_address="192.168.155.54"                   # 현재 노드의 IP 주소
wsrep_node_name="mariadb4"                            # 현재 노드의 호스트명

# 상태 전송 방법
wsrep_sst_method=rsync                                # SST 방식 (rsync 권장)

5. 클러스터 재시작 및 노드 합류

기존 노드 재시작

기존 노드들을 순차적으로 재시작하여 새로운 클러스터 주소 설정을 적용합니다.

$ sudo systemctl restart mariadb

주의: 클러스터의 안정성을 위해 한 번에 하나씩 재시작하고, 각 노드가 정상적으로 클러스터에 재합류한 것을 확인한 후 다음 노드를 재시작하세요.

신규 노드 서비스 시작

새로운 노드에서 MariaDB 서비스를 시작합니다.

$ sudo systemctl start mariadb
$ sudo systemctl enable mariadb

클러스터 합류 확인

모든 노드에서 클러스터 크기를 확인합니다.

mysql> SHOW STATUS LIKE 'wsrep_cluster_size';
+--------------------+-------+
| Variable_name      | Value |
+--------------------+-------+
| wsrep_cluster_size | 4     |
+--------------------+-------+

모든 노드에서 위 값이 4로 표시되면, mariadb4가 클러스터에 정상적으로 합류한 것입니다.

추가 상태 확인

클러스터 상태를 더 자세히 확인하려면 다음 쿼리들을 사용할 수 있습니다.

-- 클러스터 상태 확인
MariaDB [inventory]> SHOW STATUS LIKE 'wsrep_cluster_status';
+----------------------+---------+
| Variable_name        | Value   |
+----------------------+---------+
| wsrep_cluster_status | Primary |
+----------------------+---------+
1 row in set (0.001 sec)

-- 노드 상태 확인
MariaDB [inventory]> SHOW STATUS LIKE 'wsrep_local_state_comment';
+---------------------------+--------+
| Variable_name             | Value  |
+---------------------------+--------+
| wsrep_local_state_comment | Synced |
+---------------------------+--------+
1 row in set (0.001 sec)

-- 연결된 노드 확인
MariaDB [inventory]> SHOW STATUS LIKE 'wsrep_incoming_addresses';
+--------------------------+---------------------------------------------------------------------+
| Variable_name            | Value                                                               |
+--------------------------+---------------------------------------------------------------------+
| wsrep_incoming_addresses | 192.168.155.51:0,192.168.155.52:0,192.168.155.53:0,192.168.155.54:0 |
+--------------------------+---------------------------------------------------------------------+
1 row in set (0.001 sec)

6. 데이터 복제 확인

새로운 노드에서 기존 데이터가 정상적으로 복제되었는지 확인합니다.

MariaDB [mysql]> use inventory;
Database change

MariaDB [inventory]> select * from products;
+------------+--------------+----------+
| product_id | product_name | quantity |
+------------+--------------+----------+
|          1 | Notebook     |       50 |
|          2 | Pen          |      200 |
|          3 | Monitor      |       30 |
|          4 | Keyboard     |       20 |
|          5 | Mouse        |       60 |
|          6 | Webcam       |       10 |
|          7 | Tablet       |       25 |
+------------+--------------+----------+
7 rows in set (0.001 sec)

mariadb1~4 모든 노드에서 동일한 결과가 나와야 정상입니다.

참고: 본 예제에서는 데이터량이 적어 빠르게 복제되지만, 대용량 데이터의 경우 SST(State Snapshot Transfer) 과정이 상당한 시간이 소요될 수 있습니다. 이 경우 클러스터 성능에 영향을 줄 수 있으므로 적절한 시간대에 작업을 진행하시기 바랍니다.


관련 포스팅

댓글

댓글 쓰기

이 블로그의 인기 게시물

[Linux] RHEL Local YUM Repository 구성

이미지
RHEL(Redhat Enterprise Linux)에 Local YUM Repository 구성하는 방법에 대하여 설명합니다. 레드햇 리눅스 같은 경우 기업환경의 인터넷이 되지 않는 환경에서 사용되는 경우가 많은데 Local YUM Repository를 구성하여 패키지를 쉽게 설치할 수 있습니다.   테스트 환경 • Red Hat Enterprise Linux (RHEL)   Local YUM Repository 구성 목적 Local YUM Repository를 구성하는 방법에 여러 가지가 있지만 가장 간단한 방법인 설치 CD를 이용해 구성하는 방법에 대해 소개합니다. 주로 이 방법은 OS 엔지니어가 RHEL을 설치 후 사용하며, local repo를 서버에 구성한 뒤 철수합니다. 그러면 애플리케이션 측에서 추가 패키지를 요청하여도 서버 관리자분들이 yum 명령어를 사용하여 쉽게 서버에 설치할 수 있습니다.   Local YUM Repository 설정 레드햇 설치 CD에는 기본 RHEL 서브스크립션에서 제공하는 RPM 패키지들이 모두 포함되어 있습니다. 따라서 RHEL을 설치한 버전과 동일한 ISO 파일 이 준비되어 있어야 하며, 이를 통해 로컬 저장소를 구성할 수 있습니다.   VMware Workstation을 기준으로 설명하자면, RHEL ISO 파일을 가상 머신에 마운트 하면 됩니다. ISO 파일이 마운트되면 시스템은 자동으로 /dev/sr0 장치를 생성하게 되며, 이는 udev 에 의해 처리됩니다.   CD가 삽입되면 시스템에서는 /dev/sr0 장치를 자동으로 생성합니다. 이 장치는 **광학 디스크 장치(CD/DVD)**로 인식되며, 이를 확인하는 가장 쉬운 방법은 lsblk 명령어를 사용하는 것입니다. # lsblk NAME MAJ:MIN RM SIZE RO TYPE MOUNTPOINTS sda 8:0 0 2G 0 disk └─mpatha ...
자세한 내용 보기

[Linux Command] sudo command 설명

이미지
  이번 글에서는 Linux 명령어 중 sudo 명령어에 대해 알아보겠습니다. 일반 사용자에게 "root" 권한을 부여하려면 보통 root 계정의 비밀번호를 제공해야 합니다. 이후 사용자는 su 명령어를 통해 root 계정으로 로그인할 수 있습니다. root 계정은 시스템 내 모든 명령을 실행할 수 있는 강력한 권한을 가지고 있기 때문에, 신중한 관리가 필요합니다. 리눅스에 익숙하지 않은 사용자가 root 권한을 사용할 경우, 시스템 운영에 필요한 핵심 파일이 삭제되거나 권한 설정이 변경되는 등의 사고가 발생할 수 있습니다. sudo 기능을 사용하면 root 전체 권한이 아닌 특정 명령어만 일반 사용자에게 허용할 수 있어 이러한 위험을 줄일 수 있습니다. 또한, 사용 권한은 부여하되 root 비밀번호를 공개하지 않아도 된다는 점도 sudo 의 중요한 장점 중 하나입니다.   환경 : Red Hat Enterprise Linux (RHEL)   sudo command 개념 명령어 사용법을 보기 전에, sudo 명령어로 어떤 작업이 가능한지 먼저 알아보겠습니다. 일반 사용자가 /etc/shadow 파일을 열려고 하면 권한 부족으로 인해 파일을 열 수 없습니다. 아래는 실제 출력 예시입니다. 일반유저로 shadow파일 오픈 실패 [user1@localhost ~]$ cat /etc/shadow cat: /etc/shadow: Permission denied 또한 mount 명령어도 일반 사용자 권한으로는 실행할 수 없습니다. 일반 유저로 mount 명령 실패 [user1@localhost sbin]$ mount /dev/sr0 /media mount: only root can do that 이제 일반 사용자에게 mount 명령어만 sudo 를 통해 root 권한으로 실행할 수 있도록 설정해보겠습니다. [user1@localhost ~]$ sudo mount /dev/...
자세한 내용 보기

[Ansible Modules] Fetch module 설명 및 활용

이미지
  Ansible modules 중 하나인 Fetch module에 대해 알아보겠습니다. Fetch는 관리 대상 노드에서 제어 노드로 파일을 복사해 오는 데 사용되는 모듈입니다 Fetch module 이란 Fetch는 영어로 "가져오다"라는 의미입니다. Ansible의 copy 모듈과 반대로 동작하는 기능으로, copy 가 제어 노드에서 관리 노드로 파일을 전송하는 데 사용된다면, fetch 는 그 반대 방향으로, 관리 대상 노드의 파일을 제어 노드로 복사해 오는 데 사용됩니다. 여기서 제어 노드(control node)는 Ansible을 실행하는 노드를, 관리 노드(managed node)는 Ansible로 관리되는 대상 시스템을 의미합니다. Ansible modules(fetch_module) Fetch module 옵션   fetch 모듈에서 주로 사용되는 주요 옵션은 다음과 같습니다: src : 관리 대상 노드에서 복사해 올 파일의 경로입니다. dest : 제어 노드에 파일을 저장할 경로입니다. flat (기본값: false ) false : {{ inventory_hostname }}/path/to/file 형태의 디렉토리 구조로 파일이 저장됩니다. 호스트별로 디렉토리가 생성되므로 여러 노드에서 같은 파일 경로를 가져올 때 유용합니다. true : 파일 경로 구조 없이 파일만 단순 복사됩니다. 이름이 같은 파일은 덮어써지기 때문에, 관리 노드가 하나이거나 파일명이 충돌하지 않는 경우에 적합합니다. 또한 디렉토리를 지정할 경우 dest 경로 끝에 슬래시( / )를 반드시 붙여야 합니다. Fetch module 사용 방법 예제에서는 다음과 같은 인벤토리 파일을 사용합니다. [test] rocky86.lab.example.com rocky84.lab.example.com   예제 1. 기본값( flat: false )으로 파일 가져오기 fetch  모듈을 이용해 관리 노드의...
자세한 내용 보기