LeJus

[RabbitMQ] 개념 및 사용법

LeJus — Thu, 24 Apr 2025 11:50:14 +0900

RabbitMQ란?

RabbitMQ는 AMQP(Advanced Message Queuing Protocol)를 구현한 오픈소스 메시지 브로커입니다.
Producer(생산자)가 보낸 메시지를 Queue에 저장한 뒤, Consumer(소비자)에게 전달해주는 비동기 메시징 시스템입니다.

AMQP와 함께 MQTT, STORMQ 등 여러 플러그인을 제공하여 다양한 프로토콜과의 결합도 가능하기 때문에 많이 사용합니다.

마이크로서비스, 이벤트 기반 시스템, 비동기 처리 등에서 널리 사용됩니다.

RabbitMQ 실습 환경 구성

실습에 사용되는 서버는 다음과 같습니다:

역할IP 주소OS 버전

RabbitMQ Broker	192.168.254.140	Ubuntu 24.04
Publisher (Producer)	192.168.254.144	Ubuntu 22.04
Subscriber (Consumer)	192.168.254.145	Ubuntu 22.04

RabbitMQ는 192.168.254.140 서버에 설치되어 있으며, 각 클라이언트는 네트워크를 통해 메시지를 송수신합니다.

RabbitMQ 설치 및 기본 설정

RabbitMQ를 설치합니다.

sudo apt install rabbitmq-server

설치가 완료되면 서비스가 정상적으로 실행중인지 확인합니다.

lejus@rbmq-1:~$ sudo service rabbitmq-server status
● rabbitmq-server.service - RabbitMQ Messaging Server
     Loaded: loaded (/lib/systemd/system/rabbitmq-server.service; enabled; vendor preset: enabled)
     Active: active (running) since Wed 2025-04-23 17:27:13 KST; 16h ago
   Main PID: 93430 (beam.smp)
      Tasks: 276 (limit: 4519)
     Memory: 177.5M
        CPU: 9min 21.254s
     CGroup: /system.slice/rabbitmq-server.service
             ├─93430 /usr/lib/erlang/erts-12.2.1/bin/beam.smp -W w -MBas ageffcbf -MHas ageffcbf -MBlmbcs 512 -MHlmbcs 512 -MMmcs 30 -P 1048576 -t 5000000 ->
             ├─93442 erl_child_setup 65536
             ├─93996 inet_gethost 4
             ├─93997 inet_gethost 4
             └─94010 /bin/sh -s rabbit_disk_monitor

Apr 23 17:27:08 rbmq-1 systemd[1]: Starting RabbitMQ Messaging Server...
Apr 23 17:27:13 rbmq-1 systemd[1]: Started RabbitMQ Messaging Server.
lejus@rbmq-1:~$ ss -anltp
State         Recv-Q        Send-Q               Local Address:Port                  Peer Address:Port        Process
LISTEN        0             128                        0.0.0.0:25672                      0.0.0.0:*
LISTEN        0             1024                       0.0.0.0:15672                      0.0.0.0:*
LISTEN        0             128                        0.0.0.0:22                         0.0.0.0:*
LISTEN        0             4096                     127.0.0.1:40379                      0.0.0.0:*
LISTEN        0             4096                       0.0.0.0:31311                      0.0.0.0:*
LISTEN        0             4096                 127.0.0.53%lo:53                         0.0.0.0:*
LISTEN        0             128                              *:5672                             *:*
LISTEN        0             128                              *:1883                             *:*
LISTEN        0             4096                             *:4222                             *:*            users:(("nats-server",pid=69840,fd=3))
LISTEN        0             128                           [::]:22                            [::]:*
LISTEN        0             4096                             *:4369                             *:*
LISTEN        0             4096                          [::]:31311                         [::]:*

서비스 Active가 active (running) 이고, TCP 포트 5672가 LISTEN 상태면 됩니다.

다음으로 계정을 생성합니다.

기본적으로 guest/guest 계정이 있지만 localhost 에서만 로그인되므로 신규 계정을 생성합니다.

sudo rabbitmqctl add_user <계정명> <비밀번호>

lejus@rbmq-1:~$ sudo rabbitmqctl add_user myuser password
Adding user "myuser" ...
Done. Don't forget to grant the user permissions to some virtual hosts! See 'rabbitmqctl help set_permissions' to learn more.
lejus@rbmq-1:~$

다음으로 권한을 부여합니다.

lejus@rbmq-1:~$ sudo rabbitmqctl set_permissions myuser ".*" ".*" ".*"
Setting permissions for user "myuser" in vhost "/" ...

myuser 계정으로 모든 권한을 허용 한다는 의미입니다.

다음으로 tag 설정을 해줍니다.

GUI와 같은 관리를 위해서는 관리자로 지정해주어야 합니다.

lejus@rbmq-1:~$ sudo rabbitmqctl set_user_tags myuser administrator
Setting tags for user "myuser" to [administrator] ...
lejus@rbmq-1:~$ sudo rabbitmqctl list_users
Listing users ...
user    tags
guest   [administrator]
myuser  [administrator]

다음으로 GUI Plugin을 활성화 합니다.

기본적으로 GUI 환경을 제공합니다.

lejus@rbmq-1:~$ sudo rabbitmq-plugins enable rabbitmq_management
Enabling plugins on node rabbit@rbmq-1:
rabbitmq_management
The following plugins have been configured:
  rabbitmq_management
  rabbitmq_management_agent
  rabbitmq_mqtt
  rabbitmq_web_dispatch
Applying plugin configuration to rabbit@rbmq-1...
The following plugins have been enabled:
  rabbitmq_management
  rabbitmq_management_agent
  rabbitmq_web_dispatch

started 3 plugins.

lejus@rbmq-1:~$ ss -anltp
State                             Recv-Q                            Send-Q                                                       Local Address:Port                                                          Peer Address:Port                            Process
LISTEN                            0                                 128                                                                0.0.0.0:25672                                                              0.0.0.0:*
LISTEN                            0                                 1024                                                               0.0.0.0:15672                                                              0.0.0.0:*
LISTEN                            0                                 128                                                                0.0.0.0:22                                                                 0.0.0.0:*
LISTEN                            0                                 4096                                                             127.0.0.1:40379                                                              0.0.0.0:*
LISTEN                            0                                 4096                                                               0.0.0.0:31311                                                              0.0.0.0:*
LISTEN                            0                                 4096                                                         127.0.0.53%lo:53                                                                 0.0.0.0:*
LISTEN                            0                                 128                                                                      *:5672                                                                     *:*
LISTEN                            0                                 128                                                                      *:1883                                                                     *:*
LISTEN                            0                                 4096                                                                     *:4222                                                                     *:*                                users:(("nats-server",pid=69840,fd=3))
LISTEN                            0                                 128                                                                   [::]:22                                                                    [::]:*
LISTEN                            0                                 4096                                                                     *:4369                                                                     *:*
LISTEN                            0                                 4096                                                                  [::]:31311                                                                 [::]:*

TCP 15672 포트가 GUI 포트입니다. LISTEN 상태로 되어있는지 확인합니다.

여기까지 설정이 완료되면 GUI 접속을 시도합니다.

http://192.168.254.140:15672로 접속하면 아래와 같은 화면이 출력됩니다.

위에서 생성한 계정으로 로그인이 되는지 확인합니다.

AMQP를 활용한 통신 예제

간단하게 파이썬을 활용해서 두 클라이언트(Publisher, Subscriber)간의 메시지 전송 예제를 확인합니다.

Python으로 AMQP 통신을 진행하려면 pika 모듈을 설치해야 합니다.

python -m pip install pika

Publisher 코드

import pika

credentials = pika.PlainCredentials('myuser', 'password')
parameters = pika.ConnectionParameters('192.168.254.140', 5672, '/', credentials)
connection = pika.BlockingConnection(parameters)
channel = connection.channel()

channel.basic_publish(exchange='',
                      routing_key='hello',
                      body='Hello RabbitMQ with login!')
print(" [x] Sent message with login")
connection.close()

RabbitMQ 서버에서 생성한 계정과 서버 접속 정보를 가지고 연결을 시도하며, hello라는 Queue에 메시지를 전송합니다.

기본적으로 exchange는 Direct로 되어있으며 body 부분에 전달할 정보를 입력합니다.

routing_key는 Direct Exhange 안의 Queue가 Binding될 때 사용한 Key값을 의미합니다.

지금 예제에서는 hello가 됩니다.

Subscriber 코드

import pika

credentials = pika.PlainCredentials('myuser', 'password')
parameters = pika.ConnectionParameters('192.168.254.140', 5672, '/', credentials)
connection = pika.BlockingConnection(parameters)
channel = connection.channel()

channel.queue_declare(queue='hello')

def callback(ch, method, properties, body):
    print(f" [x] Received: {body.decode()}")

channel.basic_consume(queue='hello',
                      on_message_callback=callback,
                      auto_ack=True)

print(' [*] Waiting for messages...')
channel.start_consuming()

Publisher와 마찬가지로 접속을 진행하며 hello라는 Queue를 구독(수신 대기) 합니다.

이후 Queue에 메시지가 등록되면 Subscriber는 해당 메시지를 수신하여 on_message_callback에 의해 처리하도록 합니다.

Callback Method 형식은 다음과 같습니다.

def on_message_callback(ch, method, properties, body):

ch	메시지를 소비하는 채널 객체입니다. 여기서 ack, nack, reject 등을 호출할 수 있습니다.
method	메시지의 전달 정보 (delivery tag, exchange, routing key 등)를 담고 있는 객체입니다.
properties	메시지 속성 (headers, content_type 등) 정보를 담은 객체입니다.
body	큐에서 받은 메시지 본문 (payload) 입니다. 일반적으로 bytes 타입입니다.

Subscriber를 실행한 후

(venv) lejus@subscriber:~$ vi consumer.py
(venv) lejus@subscriber:~$ python consumer.py
 [*] Waiting for messages...

GUI에서 Queues 탭을 확인하면

hello라는 Queue가 생성된 것을 확인할 수 있습니다.

그리고 Connections 탭에 이동하면

현재 연결 중인 호스트에 대한 정보를 확인할 수 있습니다.

그리고 Exchanges 탭으로 이동하면

(AMQP default) Name 옆에 Message rate in과 Message rate out에 값이 0.00/s 라는 값으로 확인되는데 아까 Python 코드에서 exchange가 빈 값이면 기본적으로 direct exchange를 사용한다고 했기 때문에 Type이 direct 기본 값이 선택됩니다.

그리고 Publisher 코드를 실행하면

(venv) lejus@publisher:~$ python publisher.py
 [x] Sent message with login

RabbitMQ 서버의 로그 파일에 다음과 같은 로그가 확인 됩니다.

lejus@rbmq-1:~$ sudo tail /var/log/rabbitmq/rabbit@rbmq-1.log
2025-04-24 10:28:28.908034+09:00 [info] <0.28624.0> accepting AMQP connection <0.28624.0> (192.168.254.144:60346 -> 192.168.254.140:5672)
2025-04-24 10:28:28.911648+09:00 [info] <0.28624.0> connection <0.28624.0> (192.168.254.144:60346 -> 192.168.254.140:5672): user 'myuser' authenticated and granted access to vhost '/'
2025-04-24 10:28:28.917865+09:00 [info] <0.28624.0> closing AMQP connection <0.28624.0> (192.168.254.144:60346 -> 192.168.254.140:5672, vhost: '/', user: 'myuser')

그리고 GUI의 Queues탭에서 hello Queue를 선택하면

이처럼 hello Queue에 메시지가 publish된 것을 확인할 수 있으며 그래프로 확인도 가능합니다.

이후 Subscriber를 확인하면

(venv) lejus@subscriber:~$ python consumer.py
 [*] Waiting for messages...
 [x] Received: Hello RabbitMQ with login!

정상적으로 메시지를 수신한 것을 확인할 수 있습니다.

이후 Subscriber의 코드를 중단하고 Publisher 코드를 여러 실행합니다.

(venv) lejus@subscriber:~$ python consumer.py
 [*] Waiting for messages...
 [x] Received: Hello RabbitMQ with login!
^CTraceback (most recent call last):
  File "/home/lejus/consumer.py", line 18, in <module>
    channel.start_consuming()
  File "/home/lejus/venv/lib/python3.10/site-packages/pika/adapters/blocking_connection.py", line 1883, in start_consuming
    self._process_data_events(time_limit=None)
  File "/home/lejus/venv/lib/python3.10/site-packages/pika/adapters/blocking_connection.py", line 2044, in _process_data_events
    self.connection.process_data_events(time_limit=time_limit)
  File "/home/lejus/venv/lib/python3.10/site-packages/pika/adapters/blocking_connection.py", line 842, in process_data_events
    self._flush_output(common_terminator)
  File "/home/lejus/venv/lib/python3.10/site-packages/pika/adapters/blocking_connection.py", line 514, in _flush_output
    self._impl.ioloop.poll()
  File "/home/lejus/venv/lib/python3.10/site-packages/pika/adapters/select_connection.py", line 579, in poll
    self._poller.poll()
  File "/home/lejus/venv/lib/python3.10/site-packages/pika/adapters/select_connection.py", line 1184, in poll
    events = self._poll.poll(self._get_max_wait())
KeyboardInterrupt

(venv) lejus@publisher:~$ python publisher.py
 [x] Sent message with login
(venv) lejus@publisher:~$ python publisher.py
 [x] Sent message with login
(venv) lejus@publisher:~$ python publisher.py
 [x] Sent message with login
(venv) lejus@publisher:~$ python publisher.py
 [x] Sent message with login
(venv) lejus@publisher:~$ python publisher.py
 [x] Sent message with login
(venv) lejus@publisher:~$ python publisher.py
 [x] Sent message with login

그리고 GUI의 Queues 탭에 hello Queue를 확인하면

Details 부분에 Messages Ready와 In memory가 6으로 되어있는 것을 확인할 수 있습니다.

Queue에 저장된 메시지가 구독자에 의해 처리되어야 하는데 연결이 끊겨 아직 Queue에 쌓여 있는 것입니다.

이제 Subscriber를 실행하면

(venv) lejus@subscriber:~$ python consumer.py
 [*] Waiting for messages...
 [x] Received: Hello RabbitMQ with login!
 [x] Received: Hello RabbitMQ with login!
 [x] Received: Hello RabbitMQ with login!
 [x] Received: Hello RabbitMQ with login!
 [x] Received: Hello RabbitMQ with login!
 [x] Received: Hello RabbitMQ with login!

Queue에 쌓여 있던 메시지가 모두 수신되는 것을 확인할 수 있습니다.

마무리

이번 AMQP예제를 통해서 어떻게 메시지가 처리되는지에 대해 알 수 있었습니다.

[MQ] 에 대해서

LeJus — Thu, 24 Apr 2025 09:10:07 +0900

MQ

이번 프로젝트를 진행하면서 MQ와 관련된 내용들이 많이 있어 정리하려고 합니다.

MQ(Message Queue)는 메시지를 큐에 저장하고, 필요한 시점에 꺼내어 처리할 수 있도록 해주는 시스템으로, 메시지를 효율적으로 주고받기 위한 MOM(Message-Oriented Middleware, 메시지 지향 미들웨어)의 한 종류입니다.

메시지 생성자(Producer)와 메시지 수신자(Consumer) 사이에서 중간에서 메시지를 받아 임시로 보관하고, 다시 전달하는 역할을 하므로 Broker라고도 불립니다.

MQ를 사용하는 이유

MQ를 사용하는 이유는 다음과 같습니다.

1. 데이터 유실 방지

기존 방식에서는 메시지를 직접 수신자(Consumer)에게 보내는 구조이기 때문에, 수신자가 꺼져 있거나 오류가 발생하면 메시지가 손실될 수 있습니다.

하지만 MQ는 중간에 Broker가 메시지를 받아 Queue에 저장하기 때문에, 수신자가 잠시 중단되어 있어도 나중에 다시 연결되었을 때 누락 없이 모든 메시지를 순차적으로 수신할 수 있습니다.

예시: IoT 센서가 주기적으로 데이터를 보내는데 서버가 재시작되는 상황에서도 데이터를 놓치지 않고 수신 가능.

2. 비동기 처리로 시스템 효율 향상

Producer와 Consumer가 직접 연결되어 있으면, Producer는 Consumer가 응답할 때까지 기다려야 합니다.
하지만 MQ를 사용하면 Producer는 메시지만 큐에 넣고 바로 다음 작업을 처리할 수 있기 때문에, 처리 속도가 빨라지고 시스템이 훨씬 유연해집니다.

예시: 사용자가 웹사이트에서 주문을 완료하면, 주문 정보는 MQ를 통해 백엔드 시스템으로 전달되고, 결제/배송 처리는 비동기적으로 진행됨.

3. 서비스 간 결합도 감소 (Decoupling)

Producer는 메시지를 큐에 넣기만 하면 되고, 누가 언제 어떻게 처리할지는 몰라도 됩니다.
Consumer는 큐에 들어온 메시지를 처리할 뿐, 누가 메시지를 보냈는지는 몰라도 됩니다.
이런 구조는 서로 독립적인 서비스 개발과 유지보수에 매우 유리합니다.

예시: 이메일 전송, SMS 알림, 푸시 메시지 등 다양한 알림 서비스가 동일한 메시지를 각각 처리할 수 있음.

4. 확장성과 유연한 메시지 처리

MQ를 사용하면 Consumer 수를 자유롭게 늘릴 수 있어, 많은 양의 메시지가 동시에 들어와도 여러 Consumer가 병렬로 처리할 수 있습니다.
또한 우선순위에 따라 다른 큐로 나누거나, 지연 처리(Delayed Queue) 등의 전략도 가능합니다.

예시: 대규모 이벤트 등록 시 수천 개의 요청을 동시에 받아도, Worker 수를 조절해 탄력적으로 처리 가능.

5. 재시도 및 장애 복구 지원

Consumer가 일시적으로 장애가 나도 MQ는 메시지를 큐에 보관하고 재시도할 수 있습니다.
또한 메시지 처리가 실패하면 다시 큐에 넣어 재전송하는 등의 정책 설정도 가능합니다.

MQ 프로토콜

MQ는 단순한 메시지 송수신 구조가 아니라, 중간에 메시지를 전달하고 분배하는 역할을 하는 Broker가 개입합니다.

이 구조에서는 메시지를 어떤 기준으로 어떤 Queue에 전달할지를 정해야 하며, 이를 위해 명확한 메시징 프로토콜과 구성 요소가 필요합니다.

기본 용어 정리

Producer (Publisher)
메시지를 생성하여 MQ에 전송하는 주체입니다.
Consumer (Subscriber)
메시지를 MQ에서 받아서 처리하는 주체입니다. 예: 결제 처리 서비스
Queue
메시지를 임시로 저장하는 공간입니다. 메시지는 여기서 대기하다가 Consumer가 처리합니다.
Exchange
메시지를 받아 어떤 Queue에 보낼지를 결정하는 라우팅 역할을 합니다.
(중간 관리자 느낌이라고 보면 됩니다.)
Binding
Exchange와 Queue를 연결할 때 사용하는 규칙입니다.
어떤 조건의 메시지를 어떤 Queue에 보낼지를 정합니다.
routing_key
Producer가 메시지를 보낼 때 함께 지정하는 "주소" 같은 역할입니다.
Exchange는 이 값을 기준으로 메시지를 라우팅합니다.

Exchange의 종류

1. Direct Exchange

정확히 일치하는 routing_key를 가진 Queue에만 메시지를 전달합니다.
마치 편지 봉투에 '서울시 강남구'라고 써 있으면, 정확히 그 주소의 집으로만 가는 느낌입니다.

예시:

routing_key = "email.send" 
Binding Key = "email.send"
→ 전달됨

routing_key = "email.update" 
Binding Key = "email.send" 
→ 전달 안 됨

2. Fanout Exchange

모든 연결된 Queue에 무조건 전달합니다.
routing_key는 무시됩니다.
마치 방송국이 전파를 퍼뜨리는 느낌입니다.

예시:

알림 시스템에서 "새 게시물 생성됨" 이벤트를 보내면:
- 이메일 알림
- 앱 푸시 알림
- 슬랙 메시지
  이 3개 Queue에 동시에 메시지 전달됨.

3. Topic Exchange

패턴 기반으로 routing_key와 Binding Key를 비교하여 메시지를 라우팅합니다.
와일드카드(*, #)를 사용할 수 있어 유연한 라우팅이 가능합니다.

와일드카드의미

*	정확히 하나의 단어와 일치
#	0개 이상의 단어와 일치

예시:

Binding Key: sensor.*
- routing_key = sensor.temp → ✅ 전달됨
- routing_key = sensor.humidity → ✅ 전달됨
- routing_key = sensor.temp.rom1 → ❌ 전달 안 됨
Binding Key: sensor.#
- routing_key = sensor → ✅ 전달됨
- routing_key = sensor.temp → ✅ 전달됨
- routing_key = sensor.temp.rom1 → ✅ 전달됨

4. Headers Exchange

routing_key를 사용하지 않고, 메시지에 포함된 헤더 값을 기준으로 메시지를 라우팅합니다.
조건은 헤더에 지정된 키-값 쌍이 Queue의 Binding 조건과 일치해야 합니다.
보다 복잡하거나 유연한 조건 기반 라우팅에 유리합니다.

예시:

메시지 헤더:

{
  "type": "email",
  "priority": "high"
}

Queue A의 Binding 조건:

{ 
  "x-match": "all", 
  "type": "email", 
  "priority": "high" 
}

→ 조건이 모두 일치하므로 메시지 전달됨.

x-match: any 로 설정하면 조건 중 하나만 일치해도 메시지가 전달됩니다.

대표적인 MQ 프로토콜 및 시스템

AMQP (Advanced Message Queuing Protocol)

다양한 시스템 간의 메시지를 안정적으로 전달하기 위한 프로토콜
RabbitMQ는 AMQP를 사용하는 대표적인 메시징 시스템

MQTT (Message Queuing Telemetry Transport)

사물인터넷(IoT) 환경에서 많이 사용되는 경량 메시징 프로토콜
낮은 대역폭과 낮은 전력 환경에서 효과적
Publish/Subscribe 구조를 채택
대표적인 브로커: Mosquitto, HiveMQ 등

Kafka

대용량 데이터 스트림 처리에 최적화된 분산 메시징 시스템
메시지를 토픽(Topic) 단위로 분류하며, 로그 수집/분석, 실시간 데이터 처리에 자주 사용됨

NATS

경량화된 메시지 브로커로, 빠른 속도와 단순한 구조가 장점
Microservices 간 통신에 적합
대용량 처리에 적합함

마치며

MQ를 몰랐던 때에는 로그 손실에 대한 걱정을 많이 했었는데 이번 프로젝트를 맡게 되면서 좋은 시스템을 알게 되었습니다.

[Linux] Ubuntu 24.04 Pacemaker 설정

LeJus — Fri, 14 Mar 2025 18:17:02 +0900

개요

Ubuntu 24.04 환경에서 Pacemaker를 이용한 이중화 클러스터를 구성하려고 여러 블로그의 게시글을 참고했지만,

설정이 제대로 이루어지지 않는 문제가 발생했습니다.

그 이유는 pcs cluster 설정 방식이 변경되었기 때문입니다.

이번 글에서는 Ubuntu 24.04에서 제대로 Pacemaker를 설정하는 방법을 설명하도록 하겠습니다.

테스트 환경

OS: Ubuntu 24.04
IP 설정:
- master: 192.168.172.101
- slave: 192.168.172.102

설치 및 설정

1. pacemaker, pcs 패키지 설치(master, slave)

sudo su -
apt install pacemaker pcs

2. 호스트 파일 수정 (master, slave)

vi /etc/hosts

192.168.172.101 master
192.168.172.102 slave

:wq

3. Corosync 서비스 설정 파일 수정 (master, slave)

vi /usr/lib/systemd/system/corosync.service

Type=simple # Type을 simple로 수정

:wq

4. Pcsd 서비스 활성화 및 인증 (master, slave)

systemctl start pcsd
systemctl enable pcsd

passwd hacluster
New passwd: 

pcs host auth master slave -u hacluster

5. Cluster 설정 (master)

pcs cluster setup my_cluster_name \
  master addr=192.168.172.101 \
  slave addr=192.168.172.102

6. Cluster 활성화 (master, slave)

pcs cluster start --all
pcs cluster enable --all

설정 확인

pcs status 명령어를 입력해 제대로 설정 되었는지 확인합니다.

양쪽의 서버에서

Node List에 * Online: [ master slave ] 가 확인되면 됩니다.

root@master:~# pcs cluster status
Cluster Status:
 Cluster Summary:
   * Stack: corosync (Pacemaker is running)
   * Current DC: master (version 2.1.6-6fdc9deea29) - partition with quorum
   * Last updated:  Fri Mar 14 08:57:31 2025 on master
   * Last change:   Fri Mar 14 08:39:42 2025 by my_cluster_name via crmd on master
   * 2 nodes configured
   * 0 resources instances configured
 Node List:
   * Online: [  master slave  ]
   
PCSD Status:
  slave: Online
  master: Online

root@slave:~# pcs cluster status
Cluster Status:
 Cluster Summary:
   * Stack: corosync (Pacemaker is running)
   * Current DC: master (version 2.1.6-6fdc9deea29) - partition with quorum
   * Last updated:  Fri Mar 14 08:57:31 2025 on slave
   * Last change:   Fri Mar 14 08:39:42 2025 by my_cluster_name via crmd on master
   * 2 nodes configured
   * 0 resources instances configured
 Node List:
   * Online: [  master slave  ]
   
PCSD Status:
  slave: Online
  master: Online

마무리

이로써 HA 구성 설정이 완료되었습니다.

[보안] 암호화 알고리즘

LeJus — Wed, 5 Mar 2025 09:47:29 +0900

암호화 알고리즘이란? 종류와 특징을 알아보자

데이터 보안은 오늘날 디지털 세상에서 매우 중요한 문제입니다. 다양한 형태의 정보를 안전하게 보호하고, 불법적인 접근을 막기 위해 사용되는 기술 중 하나가 바로 **암호화(Encryption)**입니다. 이 글에서는 암호화의 기본 개념과 다양한 암호화 알고리즘의 종류를 소개하고, 각각의 특징을 살펴보겠습니다.

암호화란?

암호화란 데이터를 읽을 수 없는 형태로 변환하는 과정입니다. 이를 통해 민감한 정보를 보호하고, 인가되지 않은 사용자가 해당 데이터를 열람하지 못하도록 합니다. 암호화된 데이터는 오직 정해진 키를 가진 사람만 복호화하여 원본 데이터로 되돌릴 수 있습니다.

암호화의 기본 요소

평문(Plaintext): 암호화되지 않은 원본 데이터
암호문(Ciphertext): 암호화된 데이터, 사람이 읽을 수 없는 형태
키(Key): 암호화 및 복호화에 사용되는 값
복호화(Decryption): 암호문을 다시 평문으로 되돌리는 과정

암호화 알고리즘의 종류

암호화 알고리즘은 크게 두 가지 주요 방식으로 나눌 수 있습니다: 대칭키 암호화와 비대칭키 암호화입니다.

1. 대칭키 암호화(Symmetric Key Encryption)

대칭키 암호화에서는 암호화와 복호화에 같은 키를 사용합니다. 이 방식은 빠르고 효율적이지만, 키를 안전하게 교환하는 것이 중요한 문제입니다.

주요 알고리즘:
- AES (Advanced Encryption Standard): 현재 가장 널리 사용되는 대칭키 암호화 알고리즘. 보안성과 속도 면에서 뛰어나며, 128, 192, 256 비트 키를 지원합니다.
- DES (Data Encryption Standard): 과거에 사용되었으나 현재는 보안 취약성으로 사용되지 않습니다. 56비트 키를 사용합니다.
- 3DES (Triple DES): DES를 3번 적용하여 보안을 강화한 방식이지만 속도가 느립니다.
- Blowfish: 빠르고 효율적인 암호화 알고리즘, 다양한 키 길이를 지원하지만 보안성에서는 AES에 비해 다소 부족할 수 있습니다.
- RC4: 스트림 암호화 알고리즘으로 빠르지만 보안상의 취약점이 발견되어 현재는 사용되지 않습니다.

2. 비대칭키 암호화(Asymmetric Key Encryption)

비대칭키 암호화에서는 서로 다른 두 키(공개키와 개인키)를 사용합니다. 공개키로 암호화된 데이터는 오직 개인키로 복호화할 수 있습니다. 이 방식은 보안성이 뛰어나지만 처리 속도가 상대적으로 느립니다.

주요 알고리즘:
- RSA: 가장 널리 사용되는 비대칭키 암호화 알고리즘으로, 큰 소수의 곱을 이용하여 보안성을 제공합니다.
- ECC (Elliptic Curve Cryptography): RSA보다 작은 키로도 높은 보안성을 제공하며, 특히 모바일 장치와 IoT 환경에서 많이 사용됩니다.
- DSA (Digital Signature Algorithm): 디지털 서명에 사용되며, RSA와 비슷하지만 서명 생성 및 검증에 특화된 알고리즘입니다.

3. 혼합형 암호화(Hybrid Encryption)

혼합형 암호화는 대칭키와 비대칭키 암호화를 결합한 방식입니다. 보통 비대칭키 알고리즘을 사용하여 대칭키를 안전하게 교환하고, 실제 데이터 암호화에는 대칭키 알고리즘을 사용합니다. 이 방식은 보안성과 성능을 동시에 만족시킬 수 있습니다.

예시: SSL/TLS - 웹에서 보안 통신을 제공하는 프로토콜로, 서버와 클라이언트 간에 비대칭키로 세션 키를 교환한 뒤, 대칭키로 실제 데이터를 암호화합니다.

4. 해시 함수(Hash Function)

해시 함수는 데이터를 고정된 크기의 해시값으로 변환하는 알고리즘입니다. 해시 함수는 복호화가 불가능하므로, 주로 데이터의 무결성을 검사하거나 디지털 서명을 생성할 때 사용됩니다.

주요 알고리즘:
- SHA (Secure Hash Algorithm): SHA-1, SHA-256, SHA-512 등 다양한 버전이 있으며, 블록체인 등에서 많이 사용됩니다.
- MD5: 과거에 널리 사용되었으나, 현재는 충돌 공격에 취약하여 보안 용도로 사용되지 않습니다.
- RIPEMD: SHA와 비슷한 방식으로 해시값을 생성하는 알고리즘입니다.

암호화 알고리즘 선택 기준

암호화 알고리즘을 선택할 때는 다음과 같은 요소들을 고려해야 합니다:

보안성: 알고리즘이 얼마나 안전한지, 해킹에 대한 저항력을 확인합니다.
성능: 암호화 및 복호화 속도가 얼마나 빠른지.
용도: 사용하려는 용도에 맞는 알고리즘을 선택합니다. 예를 들어, 데이터 전송이 중요한 경우 비대칭키 암호화가 사용될 수 있고, 대용량 데이터에는 대칭키 암호화가 더 적합할 수 있습니다.
키 관리: 키를 안전하게 관리할 수 있는 시스템이 필요합니다.

결론

암호화 알고리즘은 데이터를 안전하게 보호하는 데 중요한 역할을 합니다. 각 암호화 방식은 특정 상황에서 더 유리할 수 있으며, 대칭키와 비대칭키 암호화 방식은 서로 장단점이 다릅니다. 혼합형 암호화는 두 방식의 장점을 결합하여 더 높은 보안을 제공합니다. 해시 함수는 무결성 검사에 중요한 역할을 합니다.

올바른 암호화 알고리즘을 선택하는 것은 보안 시스템의 핵심이므로, 사용 목적에 맞는 알고리즘을 선택하고, 최신 보안 표준을 따르는 것이 중요합니다.

[Ubuntu 24.04] Python 3.6 설치 및 venv 설정

LeJus — Thu, 9 Jan 2025 11:48:11 +0900

개요

항상 필요할 때 검색하면서 찾아 다니고 오류 발생하면 트러블슈팅하는게 힘들어서 정리하고자 작성합니다

다른 블로그에도 잘 기술되어 있지만 사전에 필요한 라이브러리나 패키지에 대한 설명이 없어 해당 내용도 기술합니다

환경

OS : Ubuntu 24.04
VM

사전 준비

Python을 설치하는 방법은 여러 가지가 있지만, 오늘은 Python 공식 홈페이지에서 3.6 버전 tgz을 받아 설치합니다

make 과정이 필요하므로 필수 라이브러리를 먼저 설치합니다

1. apt update

$ sudo apt update
$ sudo apt-get update

2. 필수 라이브러리 설치

$ sudo apt install build-essential zlib1g-dev libssl-dev libbz2-dev libreadline-dev libsqlite3-dev wget curl llvm libncurses5-dev libncursesw5-dev libffi-dev liblzma-dev tk-dev libgdbm-dev libnss3-dev libssl-dev

파이썬 설치

기존에 설치되어 있는 파이썬은 그대로 두고 작업합니다

1. 파이썬 설치 파일 다운로드

$ sudo wget https://www.python.org/ftp/python/3.6.0/Python-3.6.0.tgz

2. 압축 해제 및 이동

$ tar xzvf Python-3.6.0.tgz
$ cd Python-3.6.0

3. 설치 경로 설정 및 설치

$ ./configure --prefix=/usr/local/python3.6
$ sudo make && sudo make install

4. Symbolic Link 연결

$ sudo ln -s /usr/local/python3.6/bin/python3.6 /usr/bin/

5. python3.6 동작 테스트

$ python3.6 --version

가상환경 만들기

기존에 사용하던 Python 버전과는 별개의 테스트 환경이 필요하므로 가상환경을 만들어 사용합니다

만약 설치되어있는 Python 버전이 다양하다면 여러 가상 환경을 만들어서 버전 별로 테스트가 가능합니다

1. venv 만들기(venv를 만들면 현재 경로에 디렉토리가 하나 생성됩니다. 위치는 본인 환경에 맞게 설정해주세요)

$ cd ~
$ python3.6 -m venv venv3.6

2. venv 환경 활성화

$ source venv3.6/bin/activate
(venv3.6) lejus@localhost:~$ python --version
Python 3.6.0
(venv3.6) lejus@localhost:~$

가상환경 활용

가상 환경을 사용한다면 반드시 외부와 독립되게 사용해야 합니다

가상 환경이 활성화 되어있다고 해도 외부 라이브러리를 사용할 수 있기 때문에 pip등과 같은 프로그램은 반드시 조심해야 합니다

가상 환경 상태에서 python3를 사용하게 되면 외부 라이브러리를 사용하기 때문에 아래와 같이 해당 환경에서만 사용할 pip 패키지를 설치할 수 있도록 합니다

(venv3.6) lejus@localhost:~$ python -m pip --version
pip 21.3.1 from /home/lejus/ralph/lib/python3.6/site-packages/pip (python 3.6)
(venv3.6) lejus@localhost:~$ python -m pip install requests

(venv3.6) lejus@localhost:~$ python -m pip list installed
Package            Version
------------------ ----------
certifi            2024.12.14
charset-normalizer 2.0.12
idna               3.10
pip                21.3.1
requests           2.27.1
setuptools         28.8.0
urllib3            1.26.20

마무리

이로써 Python 3.6 설치 및 가상환경 설정이 완료되었습니다.

[Network] Juniper OS LACP 구성

LeJus — Thu, 26 Dec 2024 18:49:42 +0900

개요

Juniper OS는 LACP(Port Channel 혹은 Ether Channel 등)을 구성하려면 반드시 드라이버를 활성화 시켜야 합니다

위 사전 지식이 없다면 꽤 오랜 시간을 투자해야 합니다(제가 그랬어요...)

그래서 오늘은 Juniper OS에서 LACP를 구성하는 방법에 대해 기술합니다

LACP Driver 활성화

configure 모드 접속 가능한 계정 로그인 후 아래 명령어 입력해주면 됩니다

{master:0}[edit]
root# set chassis aggregated-devices ethernet device-count 5

{master:0}[edit]
root# commit
configuration check succeeds
commit complete

{master:0}[edit]
root# exit
Exiting configuration mode

{master:0}
root> show lacp interfaces ae?
Possible completions:
  <interface-name>     Name of interface
  ae0
  ae1
  ae2
  ae3
  ae4
{master:0}
root> show lacp interfaces ae

해당 명령어는 Port Channel을 사용할 수 있는 개수를 설정하는 명령어로 최소 1개부터 최대 32개까지 활성화 가능합니다

위 명령어를 입력하지 않으면 절대 활성화가 되지 않으니 나머지 설정을 해도 무용지물입니다

적용하게 되면 위처럼 ae(LACP) 인터페이스가 ae0 ~ ae4까지 생성됩니다

LACP 설정할 인터페이스 unit 제거

Juniper OS에서 LACP 설정을 할 경우 먼저 인터페이스의 unit을 제거해야 합니다

{master:0}[edit]
root# set interfaces ge-0/0/0 ether-options 802.3ad ae0

{master:0}[edit]
root# set interfaces ge-0/0/2 ether-options 802.3ad ae0

{master:0}[edit]
root# commit
[edit interfaces ge-0/0/0]
  'unit 0'
     logical unit is not allowed on aggregated links
error: configuration check-out failed

제거되지 않으면 위처럼 적용할 수 없으니 반드시 제거해줍니다

{master:0}[edit]
root# delete interfaces ge-0/0/0 unit 0

{master:0}[edit]
root# delete interfaces ge-0/0/2 unit 0

예제에서는 ge-0/0/0, ge0/0/2 포트를 구성할 예정이므로 위와 같이 설정했습니다

인터페이스 LACP 설정

{master:0}[edit]
root# set interfaces ge-0/0/0 ether-options 802.3ad ae0

{master:0}[edit]
root# set interfaces ge-0/0/2 ether-options 802.3ad ae0

인터페이스에 802.3ad 채널을 개방한 후 ae0(Juniper OS에서 사용하는 LACP 인터페이스) 를 적용해줍니다

이렇게 되면 두 인터페이스가 하나의 ae0 인터페이스로 묶이게 됩니다

LACP 인터페이스 설정

이제 LACP로 묶었으니 설정을 진행합니다

맨 뒤에 active인지, passive인지를 확인 후 설정해줍니다

active
- 해당 포트를 통해 데이터를 전송하는 역할

passive
- 해당 포트를 통해 데이터를 수신 후 응답하는 역할

1. Active 모드 설정

{master:0}[edit]
root# set interfaces ae0 aggregated-ether-options lacp active

2. Passive 모드 설정

{master:0}[edit]
root# set interfaces ae0 aggregated-ether-options lacp passive

이후 switching 모드를 사용할 지 아니면 non switching 모드를 사용할 지, switching 모드를 사용한다면 access인지 trunk인지를 확인해줍니다

switching 모드
- 쉽게 말해 vlan을 사용하는 인터페이스를 만들겠다는 의미

non switching 모드
- 인터페이스에 vlan을 사용하지 않겠다는 의미로 직접 IP를 할당하는 설정이 가능

1. switching 모드(Access) 설정

{master:0}[edit]
root# set interfaces ae0 unit 0 family ethernet-switching port-mode access

2. switching 모드(Trunk) 설정

{master:0}[edit]
root# set interfaces ae0 vlan-tagging

{master:0}[edit]
root# set interfaces ae0 unit 0 family ethernet-switching port-mode trunk

3. non switching 모드 설정

{master:0}[edit]
root# set interfaces ae0 unit 0 family inet

LACP 구성

LACP가 잘 설정되었는지 확인하기 위해서는 configure 모드를 나간 후 명령어를 입력해야 합니다

{master:0}[edit]
root# exit
Exiting configuration mode

{master:0}
root> show lacp interfaces
Aggregated interface: ae0
    LACP state:       Role   Exp   Def  Dist  Col  Syn  Aggr  Timeout  Activity
      ge-0/0/0       Actor    No   Yes    No   No   No   Yes     Fast    Active
      ge-0/0/0     Partner    No   Yes    No   No   No   Yes     Fast   Passive
      ge-0/0/2       Actor    No   Yes    No   No   No   Yes     Fast    Active
      ge-0/0/2     Partner    No   Yes    No   No   No   Yes     Fast   Passive
    LACP protocol:        Receive State  Transmit State          Mux State
      ge-0/0/0            Port disabled     No periodic           Detached
      ge-0/0/2            Port disabled     No periodic           Detached

링크 연결을 안해서 Receive State와 Transmit State가 Port disabled 와 Noperiodic으로 되어있지만 위처럼 결과가 나온다면 정상적인 설정이 완료된 것입니다

마무리

이로써 LACP 구성이 완료되었습니다

[Rack Tables] 설치

LeJus — Tue, 24 Dec 2024 13:25:05 +0900

개요

전산장비 유지보수 업무를 하다 보면 랙 실장도가 필요할 때가 있는데 이를 잘 관리할 수 있는 오픈소스가 있어 사용해보니 정말 탄탄하고 좋은 것 같아서 작성해봅니다

https://www.racktables.org/

RackTables

RackTables is a nifty and robust solution for datacenter and server room asset management. It helps document hardware assets, network addresses, space in racks, networks configuration and much much more!

www.racktables.org

설치 환경

VMware
OS : Ubuntu 20.04
CPU : 2vCPU
Memory : 4GB
HDD : 50GB
IP : 192.168.111.50

OS 설치

우선 Rack Tables에서 제공되는 메뉴얼을 살펴보면 다음과 같습니다.

RackTables uses a web-server with PHP (7.0 is the minimum required version, 7.1
is the minimum tested version, 7.3 is the recommended version) for front-end and
a MySQL/MariaDB server version 5 or later for back-end. The most commonly used
web-server for RackTables is Apache httpd.

- PHP 버전 7.0 이상 7.3 권장
- MySQL/MariaDB는 5버전 이상을 권장
- Web Server는 어떠한 것을 사용해도 되지만, Apache를 보편적으로 가장 많이 사용함

위 조건만 충족되면 어떠한 OS에서 진행해도 무방하며, 저는 Ubuntu 20.04 버전을 설치했습니다

https://releases.ubuntu.com/focal/

Ubuntu 20.04.6 LTS (Focal Fossa)

Select an image Ubuntu is distributed on three types of images described below. Desktop image The desktop image allows you to try Ubuntu without changing your computer at all, and at your option to install it permanently later. This type of image is what m

releases.ubuntu.com

OS 설치 과정은 특별한 부분이 없으니 넘어가겠습니다

Rack Tables 의존 패키지 설치

각 OS 및 버전 별로 지원되는 설치 명령어 및 설정이 상이하니 참고하여 설치합니다

### 1.1. Install MySQL/MariaDB server

| Distribution       | How to do                                                               |
| ------------------ | ----------------------------------------------------------------------- |
| Debian 7           | `aptitude install mysql-server-5.1`                                     |
| Fedora 26          | `dnf install mariadb-server mariadb`                                    |
| Fedora 32          | `dnf install mariadb-server`                                            |
| FreeBSD 10         | `pkg install mysql56-server`                                            |
| openSUSE 42.1      | `zypper install mysql-community-server`                                 |
| Scientific&nbsp;Linux&nbsp;6 | `yum install mysql-server mysql` |
| Ubuntu 18.04       | `apt-get install mysql-server`                                          |
| Ubuntu 20.04       | `apt-get install mariadb-server`                                        |
| RHEL 7             | `yum install -y mariadb-server mariadb`                                 |

### 1.2. Enable Unicode in the MySQL/MariaDB server

| Distribution       | How to do                                                                                                          |
| ------------------ | ------------------------------------------------------------------------------------------------------------------ |
| Debian 7           | add `character-set-server=utf8` line to `[mysqld]` section of `/etc/mysql/my.cnf` file and restart mysqld          |
| Fedora 26-32       | ```printf "[mysqld]\ncharacter-set-server=utf8\n" > /etc/my.cnf.d/mysqld-charset.cnf; systemctl restart mariadb``` |
| openSUSE 42.1      | No action required, comes configured for UTF-8 by default.                                                         |
| Scientific&nbsp;Linux&nbsp;6 | add `character-set-server=utf8` line to `[mysqld]` section of `/etc/my.cnf` file and restart mysqld |
| Ubuntu 18.04       | ```printf "[mysqld]\ncharacter-set-server=utf8\n" > /etc/mysql/conf.d/charset.cnf; service mysql restart```        |
| Ubuntu 20.04       | No action required, comes configured for UTF-8 by default.                                                         |
| RHEL 7             | add `character-set-server=utf8` line to `[server]` section of `/etc/my.cnf.d/server.cnf` file and restart mysqld   |

### 1.3. Install PHP and Apache httpd (or nginx)

| Distribution       | How to do                                                                            |
| ------------------ | ------------------------------------------------------------------------------------ |
| Debian 7 (nginx)   | `aptitude install nginx php5-fpm` **(see note below)**                               |
| Fedora 26-32       | `dnf install httpd php php-mysqlnd php-pdo php-gd php-snmp php-mbstring php-bcmath`  |
| FreeBSD 10         | see note 1.3.c                                                                       | 
| openSUSE 42.1      | `zypper install apache2-mod_php5 php5-gd php5-mbstring php5-mysql php5-bcmath`       |
| Scientific&nbsp;Linux&nbsp;6 | `yum install httpd php php-mysql php-pdo php-gd php-mbstring php-bcmath` |
| Ubuntu 18.04       | `apt-get install apache2-bin libapache2-mod-php7.2 php7.2-gd php7.2-mysql php7.2-mbstring php7.2-bcmath php7.2-json php7.2-snmp`
| Ubuntu 20.04       | `apt-get install apache2-bin libapache2-mod-php7.4 php7.4-gd php7.4-mysql php7.4-mbstring php7.4-bcmath php7.4-json php7.4-snmp`
| RHEL 7             | `subscription-manager repos --enable=rhel-server-rhscl-7-rpms`
|                    | `yum install httpd24 rh-php70 rh-php70-php-mysqlnd rh-php70-php-pdo rh-php70-php-gd rh-php70-php-snmp rh-php70-php-mbstring rh-php70-php-bcmath rh-php70-php-ldap rh-php70-php`

저는 Ubuntu 20.04이므로 mariadb-server와 apache2, php-7.4 하위 의존 패키지를 설치했습니다

Rack Tables 설치 및 설정

대부분 아래 메뉴얼을 참고하여 진행하는데 경로가 살짝씩 바뀐 부분이 있습니다

##### Common install steps
Apache users should create a racktables.conf file under their apache
Includes directory with the following contents:
```
AddType  application/x-httpd-php         .php
AddType  application/x-httpd-php-source  .phps

<Directory /usr/local/www/racktables/wwwroot>
	DirectoryIndex index.php
	Require all granted
</Directory>
Alias /racktables /usr/local/www/racktables/wwwroot
```

Start services:
```
# echo 'apache24_enable="YES"' >> /etc/rc.conf
# service apache24 start
# echo 'mysql_enable="YES"' >> /etc/rc.conf
# service mysql-server start
```

Browse to http://address.to.your.server/racktables/index.php and follow the instructions.

Note: set `secret.php` permissions when prompted.
```
# chown www:www /usr/local/www/racktables/wwwroot/inc/secret.php
# chmod 400 /usr/local/www/racktables/wwwroot/inc/secret.php
```

1. 설치 파일 다운로드

$ cd /var/www
$ sudo wget https://sourceforge.net/projects/racktables/files/RackTables-0.22.0.tar.gz

2. 압축해제

$ sudo tar xzvf RackTables-0.22.0.tar.gz

3. 소프트 링크 설정

$ sudo ln -s RackTables-0.22.0 racktables

4. Apache 디렉토리에 racktables.conf 파일을 생성한 후 내용을 추가합니다.

$ cd /etc/apache2/
$ sudo vi racktables.conf

AddType  application/x-httpd-php         .php
AddType  application/x-httpd-php-source  .phps

<Directory /var/www/racktables/wwwroot>
	DirectoryIndex index.php
	Require all granted
</Directory>
Alias /racktables /var/www/racktables/wwwroot

:wq

5. apache2.conf 설정 파일에 내용을 추가합니다

$ pwd
/etc/apache2
$ sudo vi apache2.conf

...
LogLevel warn

# Include module configuration:
IncludeOptional mods-enabled/*.load
IncludeOptional mods-enabled/*.conf

# Include list of ports to listen on
Include ports.conf
Include racktables.conf ## 해당 내용 추가!!!!

...

:wq

6. http://192.168.111.50/racktables/ 접속을 확인한 후 하이퍼링크 되어있는 here를 클릭합니다.

7. 설치 마법사 화면이 출력되면 proceed를 누릅니다

8. 패키지 설치가 되어있는지 확인하는 화면인데 노란색(LDAP, curl, pcntl, https)으로 칠해진 부분은 필수는 아니고 추후 설정이 가능하므로 이번에는 그냥 넘어갑니다

9. 화면에 적힌 touch ~ 부분을 복사해서 파일을 생성한 후 retry를 눌러줍니다

$ sudo touch /var/www/racktables/wwwroot/inc/secret.php
$ sudo chmod a=rw /var/www/racktables/wwwroot/inc/secret.php

10. mysql 접속 후 초록색 하이라이트 부분을 복사해 입력해줍니다.

$ sudo mysql

Welcome to the MariaDB monitor.  Commands end with ; or \g.
Your MariaDB connection id is 38
Server version: 10.3.39-MariaDB-0ubuntu0.20.04.2 Ubuntu 20.04

Copyright (c) 2000, 2018, Oracle, MariaDB Corporation Ab and others.

Type 'help;' or '\h' for help. Type '\c' to clear the current input statement.

mysql> CREATE DATABASE racktables_db CHARACTER SET utf8 COLLATE utf8_general_ci;
Query OK, 1 row affected (0.001 sec)

mysql> CREATE USER racktables_user@localhost IDENTIFIED BY 'MY_SECRET_PASSWORD';
Query OK, 1 row affected (0.001 sec)

mysql> GRANT ALL PRIVILEGES ON racktables_db.* TO racktables_user@localhost;
Query OK, 1 row affected (0.001 sec)

mysql> exit

비밀번호는 수정하여 화면에 기입한 후 retry를 눌러줍니다

11. 데이터베이스 연결 설정이 완료되었다는 문구가 뜨면 proceed를 눌러줍니다

12. secret.php 파일에 대한 권한을 재설정한 후 retry를 누릅니다

$ sudo chown www-data:nogroup /var/www/racktables/wwwroot/inc/secret.php
$ sudo chmod 440 /var/www/racktables/wwwroot/inc/secret.php

13. secret.php 파일에 대한 권한 설정이 완료되었다는 문구가 뜨면 proceed를 누릅니다

14. 데이터베이스 초기화가 완료되었다는 문구가 뜨면 proceed를 누릅니다

15. 관리자 계정 비밀번호가 설정되어있지 않아 설정하라는 화면입니다

비밀번호를 입력하고 retry를 누릅니다(오타나지 않게 조심히 해주세요)

16. 관리자 비밀번호 설정이 완료되었다는 문구가 뜨면 proceed를 누릅니다

17. RackTables에 대한 초기 설정이 완료되었다는 문구가 뜨고 관리자 계정의 ID는 admin이라고 알려주네요

proceed를 누릅니다

18. 완료

마무리

RackTables에서 제공하는 기능이 너무 많습니다

시간 날 때 하나씩 살펴보는 것도 좋을 것 같습니다

[Network] mDNS로 인한 멀티캐스트 스톰

LeJus — Wed, 18 Dec 2024 13:16:54 +0900

개요

네트워크 엔지니어로 일하면서 겪은 일 중 하나인데 이에 관한 내용을 정리하려 합니다.

우선 용어를 정리할 필요가 있을 것 같아 여기서 정리좀 해보려 합니다.

mDNS :
- Apple에서 개발한 근접 호스트 탐색 프로토콜 입니다.
- UDP 5353 포트를 통해 통신하고 자신의 호스트 명과 IP를 멀티캐스트(IPv4: 224.0.0.251, IPv6: ff02::fb)를 통해 알립니다.
- 만약 호스트 이름이 동일한 장치가 있을 경우 동일한 호스트 전체 목록에 뒤에 숫자를 붙여 구분한 뒤 각 호스트에 대한 IP 주소를 전부 멀티캐스트를 통해 전달합니다.(호스트명이 같은 장비가 200대가 있다면 host(1): 1.1.1.1 host(2): 1.1.1.2 ... 이런 식으로 패킷을 만들어 전달합니다. 패킷이 길어져 패킷 크기가 1514를 초과한다면 패킷을 분리해 전송합니다.)
멀티캐스트 스톰
- 초당 발생할 수 있는 멀티캐스트량이 기준치를 초과하면 패킷 과다 발생으로 판단하고 이 상태를 Storm이라 칭합니다.
- 패킷이 전달되는 목적지의 종류에 따라 다른 명칭이 있는데, 하나의 목적지에 전달하는 것이 유니캐스트, 같은 그룹의 목적지에 전달하는 것이 멀티캐스트, 같은 네트워크 전체에 전달하는 것이 브로드캐스트이다.

이번 글에서는 강의실 두 군데에서 모두 동일한 호스트명을 사용하게 되면서 약 100여대의 PC에서 mDNS 패킷을 과다 발생시키고 조치하는 과정에 대해서 설명하려 합니다.

Trouble Shooting 과정

우선 증상이 특이했습니다.

사용하는 네트워크 구성은 다음과 같습니다.

그림 그리기가 힘드네요.

네트워크 장비에 직접 붙여서 사용하는 사람이 있는 반면에, 허브를 사용하는 사용자도 있습니다.

강의실 특성상 반드시 허브에 연결하여 사용해야 하는 구성이었습니다.

증상은 다음과 같습니다.

네트워크 장비에 직접 연결한 사용자는 네트워크에 이상이 없다.
허브를 사용하는 사용자들 중 1G급 이상 장비를 사용하는 사용자는 이상이 없다.
허브를 사용하는 사용자들 중 100M급 장비를 사용하는 사용자는 네트워크가 불안정하다.
강의실에서 강의가 진행될 경우 위 허브를 사용하는 사용자들의 네트워크가 불안정하다.
강의실의 PC가 모두 꺼지면 네트워크에 이상이 없다.

이를 바탕으로 각 사용자들의 장비에 이상이 없는 것을 확인하고 패킷 검사를 진행했습니다.

해당 패킷은 네트워크 장비에서 모니터링한 것이 아니라 클라이언트 PC에서 1분간 모니터링한 결과입니다.

뭐 별거 없어보이지만 중요한 것은 패킷 수량입니다.

MDNS 패킷만 피터링한 결과

무려 1분에 발생한 패킷이, 그것도 클라이언트에서 발생한 패킷이 77만건이 넘어가고 MDNS 관련 패킷만 확인한 결과 98.2%를 차지하고 있습니다. ㄷㄷㄷ

패킷 내용은 보안상의 이유로 보여드릴 수는 없지만 모두 MDNS를 통해 자신을 알리고, 동일한 PC명을 가진 호스트들의 전체적인 정보가 멀티캐스트로 뿌려지고 있습니다. 그 내용이 너무 커서 PDU 사이즈를 초과해 여러 개의 패킷으로 나누어져 보내지고 있는것이 보입니다.

이로써 패킷이 과다하게 발생해 클라이언트 측에서 문제가 발생했을 것으로 추정되었습니다.

그렇다면 네트워크 장비에 직접 연결하면 괜찮은데 허브에 연결한 장비들은 문제가 발생했을까요??

그것은 바로 대역폭이었습니다.

허브를 사용하는 사용자들 중에서도 성능이 좋은 장비를 사용하면 문제가 없지만 성능이 좋지 않으면 발생하는 것이었습니다.

그 이유는 저렇게 많은 MDNS 패킷을 전달하는 과정에서 대역폭을 모두 사용했기 때

문입니다.

조치 및 결과

1차 조치

네트워크 장비에서 해당 클라이언트까지의 MDNS 패킷을 차단해보았습니다.

1차 조치 결과 아주 많이 패킷이 줄어든 것이 확인되었습니다.

2차 조치

MDNS 패킷 차단 후 눈에 띄게 패킷이 줄어든 것이 확인되었고 강의실 내부의 MDNS 서비스를 모두 끄기로 했습니다.

MDNS 패킷의 비중이 거의 사라졌습니다.

마무리

해당 장애에 대한 트러블 슈팅 과정이 재미있었네요

[Zabbix] Docker-Compose로 Active Proxy 연동 하기

LeJus — Tue, 17 Dec 2024 17:23:03 +0900

작업 환경

VMware
OS : Ubuntu 24.04(LTS)
CPU : 4vCPU
Memory : 8GB
Zabbix : ubuntu-7.0-latest
Database: Postgres 14
사용 계정 : zabbix: uid=1001(zabbix) gid=1001(zabbix) groups=1001(zabbix),4(adm),27(sudo)
프록시 서버 IP : 192.168.111.90, 192.168.111.91
Zabbix 서버 IP : 192.168.111.80

Zabbix의 Proxy

Proxy는 요청을 대신 처리하는 대리자 정도로 생각하면 된다.

그 중 Zabbix에서 사용하는 Proxy 모드가 두 가지 있는데 Passive와 Active가 있다.

Active Proxy

출처: https://www.zabbix.com/documentation/current/en/manual/distributed_monitoring/proxies

Active Proxy는 Zabbix Server가 수행할 작업을 대신 수행한 후 결과를 서버에 돌려주는 역할을 한다. 만약 호스트가 200대가 있는데 SNMP 모니터링을 해야 한다고 했을 때, Proxy가 없다면 서버가 200대의 호스트에 SNMP 요청을 보내고, 가져온 데이터를 처리하는 과정까지 모두 진행하기 때문에 서버에 부담이 가게 됩니다.

이 부담을 줄여주는 것이 바로 Active Proxy로 200대에 대한 SNMP 요청을 Proxy 서버가 대신 수행하고 결과를 리턴하면 Server는 처리만 하면 되기 때문에 Zabbix Server의 성능을 고려한다면 반드시 사용하는 것이 좋습니다.

참고로 Active Proxy는 제약사항이 있다. (당연한 거지만)

SNMP, agent 통신 등 요청을 통한 데이터 수집은 가능하지만, SNMP Trap과 같이 Agent에서 전달받는 데이터는 처리가 되지 않습니다.

Passive Proxy

Passive Proxy는 Zabbix Server가 외부에 공개되는 것을 방지하고, Agent가 보내는 요청을 Passive Proxy가 대신 받아 처리한 후 전달하는 역할을 합니다.

해당 글에서는 Active Proxy에 대한 설치 및 설정 작업을 진행합니다.

Docker 설치 및 테스트

Docker의 설치는 공식 홈페이지의 가이드를 따라 진행했습니다

더욱 자세한 내용을 알고 싶으시면 아래 링크 참고해주세요

https://docs.docker.com/engine/install/ubuntu/

Ubuntu

Jumpstart your client-side server applications with Docker Engine on Ubuntu. This guide details prerequisites and multiple methods to install Docker Engine on Ubuntu.

docs.docker.com

1. 설치 전 충돌 가능성이 있는 패키지를 제거

$ for pkg in docker.io docker-doc docker-compose docker-compose-v2 podman-docker containerd runc; do sudo apt-get remove $pkg; done

2. 레포지토리 등록

# Add Docker's official GPG key:
$ sudo apt-get update
$ sudo apt-get install ca-certificates curl
$ sudo install -m 0755 -d /etc/apt/keyrings
$ sudo curl -fsSL https://download.docker.com/linux/ubuntu/gpg -o /etc/apt/keyrings/docker.asc
$ sudo chmod a+r /etc/apt/keyrings/docker.asc

# Add the repository to Apt sources:
$ echo \ "deb [arch=$(dpkg --print-architecture) signed-by=/etc/apt/keyrings/docker.asc] https://download.docker.com/linux/ubuntu \
$(. /etc/os-release && echo "$VERSION_CODENAME") stable" | \
sudo tee /etc/apt/sources.list.d/docker.list > /dev/null sudo apt-get update

3. 패키지 설치

$ sudo apt-get install docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin

4. Docker Test

$ sudo docker run hello-world
Unable to find image 'hello-world:latest' locally # 이미지가 현재 로컬에 설치되어 있지 않음을 알림
latest: Pulling from library/hello-world # 자동으로 hello-world를 찾고 image를 latest 태그로 설치함
c1ec31eb5944: Pull complete # 설치 완료
Digest: sha256:553c995e16e3178003c1227821318999dad22dac3dbb877aac3c28182255c736
Status: Downloaded newer image for hello-world:latest

Hello from Docker!
This message shows that your installation appears to be working correctly.

To generate this message, Docker took the following steps:
1. The Docker client contacted the Docker daemon.
2. The Docker daemon pulled the "hello-world" image from the Docker Hub. (amd64)
3. The Docker daemon created a new container from that image which runs the executable that produces the output you are currently reading.
4. The Docker daemon streamed that output to the Docker client, which sent it to your terminal.

To try something more ambitious, you can run an Ubuntu container with:
$ docker run -it ubuntu bash

Share images, automate workflows, and more with a free Docker ID:
https://hub.docker.com/

For more examples and ideas, visit:
https://docs.docker.com/get-started/

5. Docker Process 확인

$ sudo docker images
REPOSITORY TAG IMAGE ID CREATED SIZE
hello-world latest d2c94e258dcb 19 months ago 13.3kB

Docker Compose 설치 및 테스트

1. docker-compose 패키지 설치

$ sudo apt install docker-compose

2. compose 파일 만들기

!! compose 파일은 반드시 작업 디렉토리에서 만들어야 합니다

!! compose 파일은 이름을 반드시 맞춰 주어야 합니다.

- compose.yaml(권장) **

- compose.yml

- docker-compose.yaml

- docker-compose.yml

!! compose 파일에서 하위 항목의 구분은 공백 2칸씩 늘려가기 때문에 반드시 지켜야 합니다.

!! compose 파일에서 ${변수명} 형식은 .env파일에 작성해주어야 사용 가능합니다.

$ vi ~/compose.yaml

services:
  mysql:
    image: mysql:8.0.30
    container_name: zabbix-mysql
    environment:
      MYSQL_ROOT_PASSWORD: ${MYSQL_PASSWORD}
      MYSQL_DATABASE: ${MYSQL_DB}
      MYSQL_USER: ${MYSQL_USER}
      MYSQL_PASSWORD: ${MYSQL_PASSWORD}
    volumes:
      - mysql-data:/var/lib/mysql
    networks:
      - zabbix-network

  zabbix-proxy:
    image: zabbix/zabbix-proxy-mysql:latest
    container_name: zabbix-proxy
    mem_limit: 8g
    environment:
      ZBX_PROXY_MODE: 1
      ZBX_SERVER_HOST: 192.168.111.80  # Zabbix Server의 IP 주소
      ZBX_HOSTNAME: zabbix-proxy # 해당 이름이 가장 중요!!!
      DB_SERVER_HOST: zabbix-mysql
      MYSQL_ROOT_PASSWORD: ${MYSQL_PASSWORD}
      MYSQL_USER: ${MYSQL_USER}
      MYSQL_PASSWORD: ${MYSQL_PASSWORD}
      MYSQL_DBNAME: ${MYSQL_DB}
      # 아래는 zabbix_proxy.conf 파일에 대한 값을 수정할 수 있다.
      ZBX_CONFIGFREQUENCY: 300
      ZBX_CACHESIZE: 1G
      ZBX_HISTORYCACHESIZE: 384M
      ZBX_HISTORYINDEXCACHESIZE: 96M
      ZBX_STARTPOLLERS: 150
      ZBX_STARTPOLLERSUNREACHABLE: 30
      ZBX_STARTVMWARECOLLECTORS: 5
      ZBX_VMWAREFREQUENCY: 120
      ZBX_VMWAREPERFFREQUENCY: 120
      ZBX_VMWARECACHESIZE: 32M
      ZBX_VMWARETIMEOUT: 10
    depends_on:
      - mysql
    volumes:
      - proxy-data:/var/lib/zabbix
    ports:
      - "10051:10051"
    networks:
      - zabbix-network

  zabbix-agent:
    image: zabbix/zabbix-agent:latest
    container_name: zabbix-agent
    restart: unless-stopped
    privileged: true
    ports:
      - '10050:10050'
    environment:
      ZBX_SERVER_HOST: 192.168.111.80
      ZBX_HOSTNAME: Zabbix proxy
    networks:
      - zabbix-network

volumes:
  mysql-data:
  proxy-data:

networks:
  zabbix-network:
    driver: bridge

3. .env 파일 만들기

$ vi ~/.env
MYSQL_USER=zabbix
MYSQL_PASSWORD=Input youer password
MYSQL_DB=zabbix_proxy

4. docker compose 구동

$ sudo docker-compose up -d

5. 컨테이너 확인

$ sudo docker ps -a
CONTAINER ID   IMAGE                              COMMAND                  CREATED       STATUS      PORTS                                           NAMES
15850c85c9a6   zabbix/zabbix-proxy-mysql:latest   "/usr/bin/docker-ent…"   2 weeks ago   Up 7 days   0.0.0.0:10051->10051/tcp, :::10051->10051/tcp   zabbix-proxy
002bd58c61cd   zabbix/zabbix-agent:latest         "/usr/bin/docker-ent…"   2 weeks ago   Up 7 days   0.0.0.0:10050->10050/tcp, :::10050->10050/tcp   zabbix-agent
8e721d31b1d2   mysql:8.0.30                       "docker-entrypoint.s…"   2 weeks ago   Up 7 days   3306/tcp, 33060/tcp                             zabbix-mysql

Zabbix 설정

1. 왼쪽 메뉴 중 관리 - 프록시에서 우측 상단의 프록시 생성 버튼 클릭

2. 위에서 설정한 compose.yaml 파일에서 zabbix-proxy의 ZBX_HOSTNAME인 zabbix-proxy를 입력

정상적으로 등록되면 아래와 같이 연결되었다고 나옵니다.

3. 데이터 수집 - 호스트에서 호스트 중 데이터를 수집할 호스트를 선택하고, 감시용 서버를 프록시로 변경하고 선택 클릭

4. 생성한 zabbix-proxy 선택

5. 갱신 버튼 클릭

6. 적용 확인 및 에이전트 통신 확인

Zabbix Proxy Group 설정

성능상의 이유로 여러 대의 Proxy 서버를 두고 사용한다면 Proxy Group을 사용할 수 있다.

Proxy를 하나의 Group에 모아두고 여러 호스트에 Proxy Group을 설정하면 Zabbix Server에서 자동으로 Load Balancing을 진행해 Proxy 서버를 적절하게 나누어 배치하도록 설정되어 있습니다.

참고로 위에서 설정한 것과 동일하게 zabbix-proxy2라는 호스트를 만들어 두었습니다.

1. 왼쪽 메뉴 중 관리 - proxy groups에서 create proxy group 클릭합니다.

2. Proxy Group 이름 작성 후 추가 버튼 클릭한다. 여기서는 Switch proxy라는 이름을 사용하겠습니다.

3. 왼쪽 메뉴 중 관리 - 프록시에서 만들어 둔 프록시 호스트를 선택하고 Proxy Group을 Switch Proxy로 변경하면 Address for active agents라는 항목이 나온는데 이곳에 Proxy 서버의 IP를 작성합니다.

4. 왼쪽 메뉴 중 데이터 수집 - 호스트에서 각 호스트들의 감시용 서버를 Proxy group으로 변경한 후 Switch proxy를 선택한다.

5. 각 호스트들의 proxy가 잘 분산되었는지 확인합니다.

마무리

이로써 Zabbix Proxy(Active)에 대한 설정이 완료되었습니다.

[Zabbix] Docker-Compose로 구축하기

LeJus — Tue, 17 Dec 2024 13:59:22 +0900

작업 환경

VMware
OS : Ubuntu 24.04(LTS)
CPU : 4vCPU
Memory : 8GB
Zabbix : ubuntu-7.0-latest
Database: Postgres 14
사용 계정 : zabbix: uid=1001(zabbix) gid=1001(zabbix) groups=1001(zabbix),4(adm),27(sudo)
서버 IP: 192.168.111.80

Docker 설치 및 테스트

Docker의 설치는 공식 홈페이지의 가이드를 따라 진행했습니다

더욱 자세한 내용을 알고 싶으시면 아래 링크 참고해주세요

https://docs.docker.com/engine/install/ubuntu/

Ubuntu

Jumpstart your client-side server applications with Docker Engine on Ubuntu. This guide details prerequisites and multiple methods to install Docker Engine on Ubuntu.

docs.docker.com

1. 설치 전 충돌 가능성이 있는 패키지를 제거

$ for pkg in docker.io docker-doc docker-compose docker-compose-v2 podman-docker containerd runc; do sudo apt-get remove $pkg; done

2. 레포지토리 등록

# Add Docker's official GPG key:
$ sudo apt-get update
$ sudo apt-get install ca-certificates curl
$ sudo install -m 0755 -d /etc/apt/keyrings
$ sudo curl -fsSL https://download.docker.com/linux/ubuntu/gpg -o /etc/apt/keyrings/docker.asc
$ sudo chmod a+r /etc/apt/keyrings/docker.asc

# Add the repository to Apt sources:
$ echo \ "deb [arch=$(dpkg --print-architecture) signed-by=/etc/apt/keyrings/docker.asc] https://download.docker.com/linux/ubuntu \
$(. /etc/os-release && echo "$VERSION_CODENAME") stable" | \
sudo tee /etc/apt/sources.list.d/docker.list > /dev/null sudo apt-get update

3. 패키지 설치

$ sudo apt-get install docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin

4. Docker Test

zabbix@zabbix-docker:~$ sudo docker run hello-world
Unable to find image 'hello-world:latest' locally
latest: Pulling from library/hello-world
c1ec31eb5944: Pull complete
Digest: sha256:553c995e16e3178003c1227821318999dad22dac3dbb877aac3c28182255c736
Status: Downloaded newer image for hello-world:latest

Hello from Docker!
This message shows that your installation appears to be working correctly.

To generate this message, Docker took the following steps:
1. The Docker client contacted the Docker daemon.
2. The Docker daemon pulled the "hello-world" image from the Docker Hub. (amd64)
3. The Docker daemon created a new container from that image which runs the executable that produces the output you are currently reading.
4. The Docker daemon streamed that output to the Docker client, which sent it to your terminal.

To try something more ambitious, you can run an Ubuntu container with:
$ docker run -it ubuntu bash

Share images, automate workflows, and more with a free Docker ID:
https://hub.docker.com/

For more examples and ideas, visit:
https://docs.docker.com/get-started/

5. Docker Process 확인

zabbix@zabbix-docker:~$ sudo docker images
REPOSITORY TAG IMAGE ID CREATED SIZE
hello-world latest d2c94e258dcb 19 months ago 13.3kB

Docker Compose 설치 및 테스트

1. docker-compose 패키지 설치

$ sudo apt install docker-compose

2. compose 파일 만들기

!! compose 파일은 반드시 작업 디렉토리에서 만들어야 합니다

!! compose 파일은 이름을 반드시 맞춰 주어야 합니다.

- compose.yaml(권장) **

- compose.yml

- docker-compose.yaml

- docker-compose.yml

!! compose 파일에서 하위 항목의 구분은 공백 2칸씩 늘려가기 때문에 반드시 지켜야 한다.

!! compose 파일에서 ${변수명} 형식은 .env파일에 작성해주어야 사용 가능하다.

services:
  postgres-server:
    container_name: postgres-server
    image: postgres:14.0-alpine
    restart: always
    environment:
      POSTGRES_USER: ${POSTGRES_USER}
      POSTGRES_PASSWORD: ${POSTGRES_PASSWORD}
      POSTGRES_DB: ${POSTGRES_DB}
      PG_DATA: /var/lib/postgresql/data/pgdata
    volumes:
      - postgres-data:/var/lib/postgresql/data
      - ./public/postgres/postgresql.conf:/var/lib/postgresql/data/postgresql.conf
    networks:
      zabbix-network:
        ipv4_address: 172.26.0.10

  zabbix-server:
    container_name: zabbix-server
    image: zabbix/zabbix-server-pgsql:ubuntu-7.0-latest
    restart: always
    mem_limit: 12g
    ports:
      - '10051:10051'
    environment:
      POSTGRES_USER: ${POSTGRES_USER}
      POSTGRES_PASSWORD: ${POSTGRES_PASSWORD}
      POSTGRES_DB: ${POSTGRES_DB}
      ZBX_HISTORYSTORAGETYPES: log,text
      ZBX_DEBUGLEVEL: 1
      ZBX_HOUSEKEEPINGFREQUENCY: 1
      ZBX_MAXHOUSEKEEPERDELETE: 5000
    depends_on:
      - postgres-server
    volumes:
      - ./public/server/zabbix_server.conf:/etc/zabbix/zabbix_server.conf:ro
      - zabbix-data:/var/lib/zabbix
    networks:
      zabbix-network:
        ipv4_address: 172.26.0.20

  zabbix-frontend:
    container_name: zabbix-frontend
    image: zabbix/zabbix-web-nginx-pgsql:ubuntu-7.0-latest
    restart: always
    ports:
      - '80:8080'
    environment:
      POSTGRES_USER: ${POSTGRES_USER}
      POSTGRES_PASSWORD: ${POSTGRES_PASSWORD}
      POSTGRES_DB: ${POSTGRES_DB}
      ZBX_SERVER_HOST: zabbix-server
      ZBX_POSTMAXSIZE: 64M
      PHP_TZ: ${TZ}
      ZBX_MAXEXECUTIONTIME: 500
      TZ: "Asia/Seoul"
    depends_on:
      - postgres-server
      - zabbix-server
    volumes:
      - zabbix-frontend-data:/usr/share/zabbix
      # 리포트 연동으로 필요 시 주석 해제
      # - ./public/frontend/zabbix-pdf-report:/usr/share/zabbix/zabbix-pdf-report 
    networks:
      zabbix-network:
        ipv4_address: 172.26.0.30

  zabbix-agent:
    container_name: zabbix-agent
    image: zabbix/zabbix-agent:latest
    ports:
      - '10050:10050'
    privileged: true
    restart: unless-stopped
    environment:
      ZBX_SERVER_HOST: 172.26.0.20
      ZBX_HOSTNAME: Zabbix server
    volumes:
      # Syslog 연동으로 필요 시 주석 해제
      # - ./public/agent/syslog.log:/etc/zabbix/logs/syslog.log 
    networks:
      zabbix-network:
        ipv4_address: 172.26.0.40

networks:
  zabbix-network:
    ipam:
      driver: default
      config:
        - subnet: 172.26.0.0/16

volumes:
  postgres-data:
  zabbix-data:
  zabbix-frontend-data:

3. .env 파일 만들기

POSTGRES_USER=zabbix
POSTGRES_PASSWORD=Input your password
POSTGRES_DB=zabbix
TZ=Asia/Seoul

4. 의존 파일 및 디렉토리 생성하기

$ mkdir -p ~/public/server
$ mkdir -p ~/public/frontend
$ mkdir -p ~/public/postgress
$ mkdir -p ~/public/agent

!! 아래 config 파일 내용은 각 서버 환경에 맞게 수정이 필요합니다.

### postgres-server ### <- wal size 관리를 위한 config 파일 수정
$ vi ~/public/postgres/postgresql.conf

listen_addresses = '*' 
max_wal_size = 4GB
min_wal_size = 80MB
log_timezone = 'KST'
datestyle = 'iso, mdy'
timezone = 'KST'
default_text_search_config = 'pg_catalog.english'

### zabbix-server ### <- 메모리 관리를 위한 config 파일 수정
$ vi ~/public/server/zabbix_server.conf
LogType=console
DebugLevel=1
SocketDir=/tmp/
DBHost=postgres-server
DBName=zabbix
DBSchema=public
DBUser=zabbix
DBPassword=<Input your password>
DBPort=5432
HistoryStorageTypes=log,text
HousekeepingFrequency=1
MaxHousekeeperDelete=5000
CacheSize=4096M
HistoryCacheSize=1024M
HistoryIndexCacheSize=1024M
TrendCacheSize=256M
TrendFunctionCacheSize=256M
ValueCacheSize=1024M

AlertScriptsPath=/usr/lib/zabbix/alertscripts
ExternalScripts=/usr/lib/zabbix/externalscripts
FpingLocation=/usr/bin/fping
SSHKeyLocation=/var/lib/zabbix/ssh_keys
User=zabbix

SSLCertLocation=/var/lib/zabbix/ssl/certs/
SSLKeyLocation=/var/lib/zabbix/ssl/keys/
SSLCALocation=/var/lib/zabbix/ssl/ssl_ca/
LoadModulePath=/var/lib/zabbix/modules/

### zabbix-frontend ### <- Zabbix PDF Reporting 사용 시 관련 파일
### zabbix-agent ### <- Syslog 연동

5. docker compose 구동

$ sudo docker-compose up -d

6. 컨테이너 확인

$ sudo docker ps -a

Zabbix 기본 설정

1. http://192.168.111.80 접속 후 로그인(기본 계정 Admin/zabbix)

2. 왼쪽 메뉴 중 Adminitration - General - GUI에서 Default language를 English (en_US)에서 Korean (ko_KR)로 변경

3. 왼쪽 메뉴 중 데이터 수집 - 호스트에서 Zabbix server 항목의 interfaces > 에이전트의 IP 주소를 172.26.0.40으로 수정

마무리

이로써 모니터링 툴 Zabbix 설치가 완료되었습니다.