Veeam Agent for Linux Failed to create volume snapshot - veeamsnap 모듈 로드 점검

개요

Veeam Agent for Linux에서 백업을 시작하자마자 Failed to create volume snapshot 오류가 발생하는 경우가 있습니다. 이번 사례는 Veeam Agent for Linux 6.1.0.1498 환경에서 veeamsnap 커널 모듈을 확인하고, 현재 실행 중인 커널에 맞는 모듈을 수동으로 로드한 뒤 백업이 정상 완료된 케이스입니다.

Veeam Agent for Linux의 커널 드라이버는 볼륨 스냅샷 생성과 변경 블록 추적에 사용됩니다. 따라서 패키지가 설치되어 있더라도 현재 부팅된 커널에 맞는 모듈이 없거나 로드되지 않은 상태라면 스냅샷 생성 단계에서 백업이 중단될 수 있습니다.

이 글은 Rocky Linux 8.9로 구성된 테스트 자료를 기준으로 정리했습니다. 최신 Veeam Agent의 지원 OS 범위는 당시와 다르므로, 운영 환경에 적용할 때는 사용 중인 Agent 버전과 Linux 배포판·커널 조합을 Veeam 지원 매트릭스에서 함께 확인하는 편이 좋습니다.

증상

백업 작업에서 아래 오류가 발생했습니다.

Failed to create volume snapshot

첨부 자료에서는 Veeam Agent 패키지를 다음 버전으로 맞춰 설치한 상태였습니다.

veeam-libs-6.1.0.1498-1.x86_64.rpm
kmod-veeamsnap-6.1.0.1498-1.el8.x86_64.rpm
veeam-6.1.0.1498-1.el8.x86_64.rpm

RPM 파일을 직접 설치하는 테스트에서는 veeam-libs → kmod-veeamsnap → veeam 순서로 진행했습니다. 다만 현재 공식 설치 가이드에서는 RHEL/Rocky/Alma 계열에서 패키지 매니저를 통한 설치를 안내하고 있으며, 가능한 경우 yum이 의존성을 처리하도록 구성하는 편이 관리하기 쉽습니다.

왜 veeamsnap이 필요한가

Veeam Agent for Linux는 스냅샷 기반 백업에서 Linux 커널 드라이버를 사용합니다. Veeam Agent 6 계열에는 veeamsnap과 blksnap 두 모듈이 존재하며, 사용하는 모듈은 커널과 제품 버전에 따라 달라집니다.

Veeam KB2804 기준으로 Agent 6.1의 4.18 계열 커널에서는 veeamsnap이 사용됩니다. 반대로 더 새로운 커널에서는 blksnap이 사용되는 조합이 있습니다.

즉, 오류 메시지만 보고 저장소나 백업 서버부터 확인하기보다는 보호 대상 Linux 서버의 커널과 Veeam Snapshot Driver 상태를 먼저 보는 것이 빠릅니다.

1. 현재 커널 확인

먼저 현재 부팅된 커널을 확인합니다.

uname -r

이번 테스트 환경에서는 다음 커널을 사용하고 있었습니다.

4.18.0-513.5.1.el8_9.x86_64

Veeam 공식 설치 가이드도 커널 관련 패키지를 확인할 때 uname -r로 현재 커널 버전을 확인하도록 안내합니다.

2. 현재 커널용 veeamsnap 모듈 확인

첨부 자료에서는 전체 /lib/modules 아래에서 veeamsnap과 blksnap 파일을 확인했습니다.

find /lib/modules | egrep -i '(veeamsnap|blksnap)'

여러 커널 버전이 설치된 서버라면 예전 커널용 veeamsnap.ko도 같이 보일 수 있습니다. 그래서 운영 환경에서는 현재 커널 경로만 좁혀서 확인하는 방식이 더 편합니다.

find /lib/modules/$(uname -r) -type f | egrep -i '(veeamsnap|blksnap)'

그림 1. 현재 커널과 veeamsnap 모듈 경로 확인 흐름. 첨부 자료의 Rocky Linux 8.9 테스트 화면을 바탕으로 정리했습니다.

이번 환경에서는 현재 커널과 일치하는 다음 파일이 확인됐습니다.

/lib/modules/4.18.0-513.5.1.el8_9.x86_64/extra/veeamsnap.ko

3. 모듈 로드 상태 확인

파일이 존재하는 것과 실제 커널에 로드되어 있는 것은 별개의 문제입니다.

lsmod | egrep -i 'veeamsnap|blksnap'

추가로 모듈 정보를 확인할 때는 다음 명령도 유용합니다.

modinfo veeamsnap

현재 커널용 모듈 파일은 존재하지만 lsmod 결과에 보이지 않는다면, 모듈 로드 상태를 의심할 수 있습니다.

4. veeamsnap 수동 로드

이번 테스트에서는 현재 커널에 맞는 veeamsnap.ko를 직접 로드했습니다.

insmod /lib/modules/4.18.0-513.5.1.el8_9.x86_64/extra/veeamsnap.ko

로드 이후에는 다시 확인합니다.

lsmod | grep veeamsnap

insmod는 이번 장애 확인 과정에서 사용한 직접 조치입니다. 매 부팅마다 수동으로 insmod해야 정상 동작하는 상태라면 패키지 설치 상태, 현재 커널과 kmod/DKMS 패키지 일치 여부, 모듈 자동 로드 상태를 추가로 확인해야 합니다. 단순히 명령을 반복하는 방식으로 운영하는 것은 권장하지 않습니다.

5. 백업 재수행

모듈을 로드한 뒤 같은 백업 작업을 다시 수행했습니다.

결과는 다음과 같았습니다.

• Job progress: 100%

• Success: 1

• Warnings: 0

• Errors: 0

• Processed: 10.5 GB

• Active Full 백업 정상 완료

• Snapshot 생성 후 백업 데이터 전송 및 Snapshot 해제까지 정상 진행

그림 2. veeamsnap 로드 후 백업 정상 완료 흐름. 첨부 자료의 Veeam Job Session 결과를 바탕으로 정리했습니다.

운영 환경에서 확인할 순서

비슷한 오류가 발생하면 아래 순서로 보는 편이 빠릅니다.

1. 백업 세션에서 Failed to create volume snapshot 발생 여부 확인

1. uname -r로 현재 커널 확인

1. 현재 커널 경로에 veeamsnap.ko 또는 blksnap.ko 존재 여부 확인

1. lsmod로 실제 모듈 로드 여부 확인

1. Veeam Agent 버전과 OS·커널 조합이 지원 범위인지 확인

1. kmod 방식인지 DKMS 방식인지 확인

1. DKMS 방식이라면 현재 커널과 일치하는 kernel-devel 패키지 확인

1. 모듈 로드 후 작은 범위의 테스트 백업으로 Snapshot 생성·해제까지 확인

Veeam 공식 설치 문서에서는 RHEL/Rocky/Alma 계열에서 DKMS 방식 또는 사전 빌드된 kmod 패키지를 사용할 수 있다고 설명합니다. DKMS를 사용하는 경우에는 현재 실행 중인 커널과 kernel-devel 버전이 일치해야 합니다.

버전별 veeamsnap / blksnap 구분

veeamsnap이 모든 Linux 환경에서 사용되는 것은 아닙니다.

Veeam Agent 6부터는 새로운 커널을 위한 blksnap 모듈이 추가됐고, 두 모듈 모두 스냅샷 생성에 사용됩니다. KB2804에서는 veeamsnap은 Linux kernel 5.18까지, blksnap은 5.10 이상에서 지원되는 범위가 겹칠 수 있다고 설명하며, 실제 기본 모듈은 배포판과 Agent 버전에 따라 달라집니다.

따라서 아래처럼 단순하게 판단하면 안 됩니다.

Linux 백업 오류 = 무조건 veeamsnap 설치

대신 먼저 Agent 버전 + OS 버전 + 현재 커널 조합을 확인하고, 해당 조합에서 어떤 드라이버가 기본인지 확인하는 것이 중요합니다.

최신 환경에서 주의할 점

이번 사례는 Agent 6.1.0.1498과 4.18 계열 커널을 사용한 과거 테스트 환경입니다. 현재 Veeam Agent 문서는 최신 빌드를 기준으로 Rocky Linux 지원 버전과 설치 방식이 달라져 있습니다.

새 서버를 구축하거나 Agent를 업그레이드하는 경우에는 예전 RPM 파일을 그대로 재사용하기보다 현재 지원 매트릭스와 KB2804를 기준으로 패키지를 다시 선택하는 것이 안전합니다.

특히 다음 항목은 같이 확인해두면 좋습니다.

• 현재 Veeam Agent 빌드

• Linux 배포판과 Minor Version

• uname -r 결과

• kmod 또는 DKMS 설치 방식

• 현재 커널용 kernel-devel 설치 여부

• veeamsnap / blksnap 로드 여부

정리

이번 증상은 백업 데이터 전송 단계가 아니라 볼륨 Snapshot 생성 단계에서 막힌 케이스였습니다.

현재 커널 4.18.0-513.5.1.el8_9.x86_64에 맞는 veeamsnap.ko 파일이 존재하는 것을 확인하고 해당 모듈을 로드한 뒤, 동일 백업 작업이 정상 완료됐습니다.

비슷한 오류를 만나면 백업 서버나 Repository부터 크게 변경하기 전에 Linux Agent 쪽에서 커널 버전 → 모듈 파일 → 로드 상태 → 지원 매트릭스 순으로 확인해보면 원인 범위를 빠르게 줄일 수 있습니다.

공식 참고자료

• Veeam KB2804 - veeamsnap and blksnap Extended Linux Distribution Support

• Installing Veeam Agent for Linux with Kernel Module

• Veeam Agent for Linux Solution Architecture

• How Volume-Level Backup Works

• Veeam Agent for Linux System Requirements