시스템 관리_53 Linux Samba CIFS 마운트 파일 Lock 경합 및 세션 타임아웃 원인 분석과 완벽 해결 가이드

# 1. 클라이언트 커널 로그에서 CIFS 세션 단절 및 재연결 타임아웃 확인
$ sudo dmesg -T | grep -iE "cifs|smb"
# [Thu Nov  5 10:15:21 2026] CIFS VFS: \\192.168.1.210 has not responded in 120 seconds. Reconnecting...
# [Thu Nov  5 10:15:23 2026] CIFS VFS: sends on sock 000000001245 stuck for 15 seconds
# [Thu Nov  5 10:15:25 2026] CIFS VFS: echo_interval 60 missed, initiating reconnect
# -> SMB 에코 핑(Keepalive) 실패로 클라이언트 커널이 세션을 강제 재수립하며 I/O 행 유발

# 2. 클라이언트 현재 CIFS 마운트 옵션 및 프로토콜 버전 확인
$ mount | grep -i cifs
# //192.168.1.210/shared on /mnt/cifs_share type cifs (rw,relatime,vers=3.0,cache=strict,username=appuser,uid=1000,forceuid,gid=1000,forcegid,addr=192.168.1.210,file_mode=0755,dir_mode=0755)
# -> 기본값인 cache=strict, brl(바이트 범위 락 활성화) 적용 상태 확인

# 3. Samba 서버 관점: 현재 물려있는 배타적 락(Oplocks / Lease / Deny Mode) 점검
$ sudo smbstatus -L
# Locked files:
# Pid          DataId             DenyMode   Access      R/W        Oplock           SharePath   Name   Time
# ------------------------------------------------------------------------------------------------------
# 14820        12:45120:0         DENY_NONE  0x120089    RDWR       LEASE(RWH)       /data/share log.db Thu Nov  5 10:10:02 2026
# 15210        12:45120:0         DENY_NONE  0x120089    RDWR       NONE             /data/share log.db Thu Nov  5 10:14:15 2026
# -> 14820 프로세스가 LEASE(RWH: Read/Write/Handle) 락을 쥐고 있어 다른 클라이언트의 접근이 대기열에 걸림

# 4. Samba 서버의 활성 SMB 클라이언트 세션 및 TCP 445 상태 확인
$ sudo smbstatus -S
$ ss -tan state established '( sport = :445 or dport = :445 )'

#!/bin/bash
# diagnose_cifs_lock_timeout.sh - Diagnose CIFS/SMB locking contention and session timeout

MOUNT_POINT=${1:-"/mnt/cifs_share"}

echo "=========================================="
echo " [Samba/CIFS 파일 락 및 타임아웃 진단기]"
echo " 대상 마운트 경로: ${MOUNT_POINT}"
echo "=========================================="

if [ "$EUID" -ne 0 ]; then
    echo "  [오류] 진단 및 마운트 분석을 위해 루트(root) 권한이 필요합니다."
    exit 1
fi

# 1. 마운트 상태 확인
MNT_ENTRY=$(grep -E "\s${MOUNT_POINT}\scifs\s" /proc/mounts)

if [ -z "$MNT_ENTRY" ]; then
    echo "  [오류] 지정한 경로가 CIFS 파일시스템으로 마운트되어 있지 않습니다."
    exit 1
fi

echo -e "\n[1] 현재 CIFS 마운트 파라미터 분석:"
echo "  - $MNT_ENTRY"

SERVER_IP=$(echo "$MNT_ENTRY" | grep -oE "addr=[0-9\.]+" | cut -d'=' -f2)
SMB_VER=$(echo "$MNT_ENTRY" | grep -oE "vers=[0-9\.]+" | cut -d'=' -f2)
echo "  - 서버 IP: ${SERVER_IP}"
echo "  - SMB 프로토콜 버전: ${SMB_VER:-"기본값"}"

# 2. 바이트 범위 락(BRL) 및 캐시 옵션 검사
if echo "$MNT_ENTRY" | grep -q "nobrl"; then
    echo "  - 바이트 범위 락(nobrl): 비활성화됨 (로컬 락 처리, 경합 최소화 모드)"
else
    echo "  - 바이트 범위 락: 활성화됨 (서버 측 전송으로 인한 경합 발생 가능)"
fi

# 3. 최근 커널 CIFS 에러 로그 분석
echo -e "\n[2] 최근 1시간 내 CIFS VFS 에러 이벤트 점검:"
CIFS_ERRS=$(dmesg -T | grep -i "CIFS VFS" | tail -n 5)

if [ -n "$CIFS_ERRS" ]; then
    echo "  [경고] 커널 수준 CIFS 타임아웃/에러 감지:"
    echo "$CIFS_ERRS" | sed 's/^/    /'
    
    if echo "$CIFS_ERRS" | grep -qi "has not responded"; then
        echo "  -> 원인: SMB 서버 응답 지연으로 인한 세션 단절 (Echo 타임아웃)"
    fi
    if echo "$CIFS_ERRS" | grep -qi "stuck"; then
        echo "  -> 원인: TCP 소켓 송신 버퍼 블로킹 (네트워크 정체 또는 서버 락 지연)"
    fi
else
    echo "  [정상] 최근 감지된 커널 CIFS 에러가 없습니다."
fi

# 4. 점유 중인 로컬 프로세스 확인
echo -e "\n[3] 대상 마운트 접근 중인 프로세스:"
MNT_PIDS=$(lsof +D "$MOUNT_POINT" 2>/dev/null | awk 'NR>1 {print $2}' | sort -u)

if [ -n "$MNT_PIDS" ]; then
    ps -fp $MNT_PIDS 2>/dev/null | awk '{printf "  -> PID: %-6s | 사용자: %-10s | 상태: %-4s | 명령: %s\n", $2, $1, $8, $8}'
else
    echo "  - 현재 열려있는 파일 핸들이 없습니다."
fi

# 5. 권장 최적화 마운트 옵션 제시
echo -e "\n[4] 성능 및 안정성 최적화 권장 옵션:"
echo "  - 세션 단절 방지 Keepalive: echo_interval=15 (기본 60초에서 단축)"
echo "  - 락 경합 완화: nobrl (다중 프로세스 공유 파일 I/O 충돌 회피)"
echo "  - 최신 다중화 프로토콜: vers=3.1.1"
echo "  [적용 예시]:"
echo "  mount -t cifs //${SERVER_IP}/share ${MOUNT_POINT} -o remount,vers=3.1.1,nobrl,echo_interval=15"

echo -e "\n=========================================="
echo " [진단 완료]"
echo "=========================================="

sudo mount -t cifs //server/share /mnt/share -o username=user,password=pass,nobrl

sudo mount -t cifs //server/share /mnt/share -o remount,echo_interval=15