Couchbase Server Enterprise 설치 방법

우분투 24.04에서 Couchbase Server Enterprise 설치하는 방법입니다.

SWAP 비활성화

즉시 SWAP 비활성화

sudo swapoff -a

재부팅 후에도 비활성화 유지

sudo sed -i '/swap/s/^/#/' /etc/fstab

Transparent Huge Pages(THP) 비활성화

THP는 데이터베이스 워크로드에서 지연(latency)을 유발할 수 있어 비활성화가 필요합니다.

즉시 비활성화

sudo bash -c 'echo "never" > /sys/kernel/mm/transparent_hugepage/enabled'
sudo bash -c 'echo "never" > /sys/kernel/mm/transparent_hugepage/defrag'

재부팅 후에도 적용되도록 설정

sudo tee /etc/rc.local << 'EOF'
#!/bin/bash

echo "never" > /sys/kernel/mm/transparent_hugepage/enabled
echo "never" > /sys/kernel/mm/transparent_hugepage/defrag
exit 0
EOF

sudo chmod +x /etc/rc.local

호스트명 및 네트워크 설정

클러스터 구성 시 노드 간 이름 해석을 위해 /etc/hosts에 고정 매핑을 추가합니다.

sudo tee -a /etc/hosts << 'EOF'
192.168.10.101 cb1
192.168.10.102 cb2
192.168.10.103 cb3
EOF

커널 파라미터 최적화(sysctl)

Couchbase 공식 가이드를 기반으로 메모리 및 네트워크 파라미터를 조정합니다.

sysctl 설정 파일 생성

sudo tee /etc/sysctl.d/90-couchbase.conf << 'EOF'
# Memory
vm.swappiness = 0
vm.dirty_ratio = 20
vm.dirty_background_ratio = 5
vm.dirty_expire_centisecs = 100
vm.overcommit_memory = 1

# Network
net.core.somaxconn = 1024
net.ipv4.tcp_max_syn_backlog = 1024
net.core.netdev_max_backlog = 5000
net.ipv4.tcp_keepalive_time = 300
net.ipv4.tcp_keepalive_probes = 5
net.ipv4.tcp_keepalive_intvl = 15

# File handles
fs.file-max = 2097152
EOF

sudo sysctl -p /etc/sysctl.d/90-couchbase.conf

파일 디스크립터 제한 설정

Couchbase 프로세스가 충분한 파일 핸들을 사용할 수 있도록 제한 값을 상향합니다.

sudo tee /etc/security/limits.d/couchbase.conf << 'EOF'
couchbase soft nofile 40960
couchbase hard nofile 40960
couchbase soft nproc 40960
couchbase hard nproc 40960
EOF

필수 도구 설치

sudo apt update
sudo apt install -y curl gnupg2 lsb-release

Couchbase Server Enterprise Edition 설치

패키지 다운로드

wget https://packages.couchbase.com/releases/8.0.0/couchbase-server-enterprise_8.0.0-linux_amd64.deb

패키지 설치

sudo dpkg -i couchbase-server-enterprise_8.0.0-linux_amd64.deb

Couchbase 서비스 관리

서비스 활성화 및 시작

sudo systemctl enable --now couchbase-server

서비스 재시작

sudo systemctl restart couchbase-server

서비스 상태 확인

sudo systemctl status couchbase-server

웹 콘솔 접속

http://[서버IP]:8091

참고URL

Couchbase : Couchbase Server Downloads