콘텐츠로 이동

ZFS 데이터세트

ZFS 데이터세트는 컨테이너나 VM처럼 백업 목록의 항목입니다. 항목은 데이터세트 하나와 그 아래의 모든 데이터세트를 묶은 것입니다. 백업할 때마다 BombVault는 트리 전체의 ZFS 스냅샷을 하나 만들기 때문에, 그 안의 모든 데이터세트가 같은 순간의 상태로 기록됩니다. 그런 다음 그 스냅샷에서 각 데이터세트의 파일을 읽어 폴더와 같은 방식으로 restic에 저장하고, 곧바로 스냅샷을 제거합니다. 백업은 중복 제거되고, 모든 백업을 탐색할 수 있으며, 개별 파일을 복원할 수 있습니다.

백업은 restic에 스트림을 보내지 않으며 데이터세트를 롤백하지도 않습니다. BombVault는 자신이 만든 스냅샷만 삭제합니다. 선택 기능인 복제본이 zfs send를 쓰는 유일한 곳입니다. 복제본은 데이터세트를 두 번째 ZFS 서버로 복사할 뿐, 백업은 건드리지 않습니다.

요구 사항

  • 이 서버로의 SSH 연결. ZFS 데이터세트는 VM 백업과 같은 키, 호스트, 사용자를 씁니다. VM 백업이 이미 동작한다면 이것도 동작합니다. 그렇지 않다면 SSH를 통한 VM 백업 가이드를 따르세요. 템플릿 필드 이름은 Host SSH: Address, Host SSH: Port, Host SSH: User입니다.
  • 그 호스트의 zfs 명령. Unraid 6.12 이상과 TrueNAS SCALE에 있습니다.
  • Host Data를 /mnt로, Access Mode를 Read/Write - Slave로 매핑. 템플릿의 기본값입니다. 데이터세트의 스냅샷은 BombVault가 시작된 뒤에야 데이터세트의 .zfs/snapshot 폴더에 나타나므로, 컨테이너가 호스트가 나중에 만드는 마운트를 받아야 합니다.
  • /mnt 아래에 마운트된 데이터세트. Unraid에서는 풀이 /mnt/<pool>에 있으므로 이미 그렇습니다.

설정, 일반에서 섹션(ZFS 데이터세트)을 켭니다. 그러면 백업 페이지의 더보기 아래에 있는 이 서버와의 ZFS 연결이 이 서버와의 연결을 엽니다. 여기서 SSH 연결을 테스트하고, 접속하는 사용자와 호스트를 확인하며, 빠진 것이 있으면 무엇인지 알려 줍니다. 연결이 끊겨 있으면 백업 목록이 연결 보기로 그 사실을 알려 주고, 개요의 호스트 통합 카드에도 같은 결과가 표시됩니다.

항목과 하위 데이터세트

백업 페이지에서 추가를 고른 다음 ZFS 데이터세트를 고릅니다. 목록은 서버에서 가져옵니다. 백업하려는 범위의 맨 위 데이터세트, 예를 들어 cache/appdata를 고르면 항목은 그 데이터세트와 그 아래 모든 데이터세트를 포함합니다.

  • 새 하위 데이터세트는 저절로 포함됩니다. 나중에 항목 아래에 만들어진 데이터세트는 다음 실행에서 백업되며, 그 실행이 새 데이터세트라고 알려 줍니다. 첫 백업에서는 전체를 한 번 읽고, 그 뒤로는 변경분만 읽습니다.
  • 하위 데이터세트를 하나씩 뺄 수 있습니다. 항목의 설정 탭에서 하나를 끄면 그 아래의 모든 것과 함께 제외됩니다. 제외해 둔 하위 데이터세트가 서버에서 사라지면 그렇게 표시되며, 목록에서 지울 수 있습니다.
  • 읽을 수 없는 하위 데이터세트는 조용히가 아니라 알리고 건너뜁니다. 실행 기록에 목록이 남고, 항목에는 건너뛴 개수가 표시되며, 개요의 백업 안 됨 카드는 하나하나를 보호되지 않는 것으로 셉니다. 실행은 나머지를 모두 백업하고, 건너뛴 하위 데이터세트 때문에 실패하지 않습니다. 이유는 사유 코드 표에 있습니다. 마운트되지 않은 데이터세트, canmount=off, legacy 또는 없는 마운트 지점, 로드되지 않은 암호화 키, 꺼진 스냅샷 접근, BombVault가 볼 수 없는 마운트 지점이 해당합니다.
  • 건너뛴 데이터세트가 하위 데이터세트까지 데려가지는 않습니다. 다른 데이터세트만 담고 있는 canmount=off 데이터세트는 건너뛰고("구조만"으로 표시) 마운트된 하위 데이터세트는 백업합니다. 키가 로드되지 않은 암호화 데이터세트는 같은 키를 쓰는 하위 데이터세트와 함께 건너뜁니다.
  • VM 디스크나 시스템 데이터인 하위 데이터세트는 꺼진 채로 시작합니다. 추가 창에서 스위치 옆에 이유가 적혀 있습니다. 풀 전체를 추가하면 안에 무엇이 있는지 보여 주는 확인 창이 뜹니다.

볼륨

볼륨(zvol)은 파일이 아니라 가상 디스크를 담고 있으며, ZFS 항목은 볼륨을 백업하지 않습니다.

  • VM이 쓰는 볼륨은 그 VM과 함께 백업됩니다.
  • 어떤 VM도 쓰지 않는 볼륨(iSCSI 익스텐트, 분리해 둔 디스크)은 BombVault가 백업하지 않습니다. 추가 창과 백업 페이지가 이런 볼륨의 개수를 세어 그렇게 알려 줍니다. 이후 버전에서 백업할 예정입니다.

항목 트리 안의 볼륨은 건너뛰며, 실행할 때마다 이름이 표시됩니다.

Docker 스토리지

Docker의 ZFS 스토리지 드라이버를 쓰면 이미지 레이어 하나하나가 legacy 마운트 지점을 가진 데이터세트가 됩니다. 추가 창은 이것들을 상위 데이터세트당 한 줄로 접어서 보여 줍니다. 이런 데이터세트가 20개를 넘게 들어 있는 트리는 항목이 될 수 없습니다. 그 트리의 스냅샷이 있는 동안에는 Docker가 이미지 레이어를 지울 수 없기 때문입니다. 대신 그 아래의 데이터세트, 예를 들어 appdata를 추가하세요.

항목은 겹치지 않습니다

데이터세트는 하나의 항목에만 속할 수 있습니다. 기존 항목 안에 들어가거나 기존 항목을 포함하게 되는 새 항목은 BombVault가 거부합니다. 하위 항목 여럿을 상위 항목 하나로 합치려면, 먼저 하위 항목을 삭제하면서 백업은 남기도록 고른 다음 상위 항목을 추가하세요. 모든 데이터세트는 자기 이름으로 기록을 유지하므로, 다음 백업은 예전 항목이 끝낸 곳에서 이어지고 전부를 다시 읽지 않습니다.

스냅샷 전후에 컨테이너 멈추기와 명령 실행

실행 중인 데이터베이스의 스냅샷은 갑자기 전원이 나간 것과 같습니다. 대개 데이터베이스가 복구하지만, 복구를 해야만 합니다. 각 항목은 이를 위해 두 가지를 할 수 있으며, 둘 다 백업 전체가 아니라 스냅샷을 찍는 순간만 다룹니다.

  • 스냅샷 동안 이 컨테이너들을 멈춥니다. BombVault는 목록의 컨테이너를 멈추고, 스냅샷을 찍고, 곧바로 다시 시작합니다. 같은 의존 단계의 컨테이너는 병렬로, 의존하는 쪽부터 멈추므로 전체 구간은 보통 몇 초입니다. 실행 기록에 걸린 시간이 표시됩니다. 백업은 이미 앱이 다시 도는 동안 얼어 있는 스냅샷을 읽습니다. 실행 중이던 컨테이너만 멈춥니다.
  • 스냅샷 전후의 명령. 선택한 컨테이너 안에서 실행되며, 예를 들어 스냅샷 직전에 아무것도 멈추지 않고 데이터베이스를 데이터세트로 덤프할 때 씁니다. 스냅샷 전 명령이 실패하면 백업이 실패하고 스냅샷은 찍히지 않습니다. 스냅샷 후 명령이 실패하면 실행 기록에 표시되지만 백업은 실패하지 않습니다.

문제가 생겼을 때는 이렇게 됩니다.

  • 컨테이너를 멈출 수 없으면 BombVault는 이미 멈춘 컨테이너를 다시 시작하고, 백업은 해당 컨테이너 이름을 밝히며 실패합니다. 실행 중인 앱의 스냅샷으로 물러서는 일은 없습니다.
  • 멈추기 전에 실행 중인 컨테이너 백업이 끝나기를 기다립니다(수동 실행은 최대 30분, 예약 실행은 백업 제한 시간까지). 그래서 둘이 같은 컨테이너를 동시에 멈추고 시작하는 일이 없습니다.
  • 첫 컨테이너를 멈추기 전에 BombVault는 어떤 컨테이너를 멈추는지 적어 둡니다. 그 구간 안에서 BombVault가 강제 종료되면, 다음에 시작할 때 그 컨테이너들을 다시 시작하고 알림을 보냅니다. 시작하지 못한 컨테이너가 있으면 항목에 빨간 메모로 표시됩니다.

자동 데이터베이스 덤프는 ZFS 항목이 아니라 컨테이너 자체의 백업과 함께 실행됩니다. 컨테이너가 데이터세트로만 백업되는 데이터베이스는 덤프를 받지 못하므로, 여기서 명령을 지정하세요.

컨테이너는 이 목록에 있으면서 동시에 컨테이너로도 백업될 수 있습니다. 그러면 데이터가 두 저장소에 두 번 저장되고, 전체 백업이 컨테이너를 두 번 멈춥니다. 항목에 그렇게 표시됩니다.

복원

항목을 열고 복원을 고르거나, 복원 페이지에서 항목을 고릅니다. 복원 창은 백업을 묻고, 그다음 데이터세트를 묻습니다. 기본값은 항목의 최상위 데이터세트입니다. 무엇에서는 전부를 복원하거나 고른 파일과 폴더만 복원합니다. 어디로에서는 다음을 고를 수 있습니다.

  • 데이터세트 안으로 복원. 백업의 파일을 데이터세트의 마운트 지점에 씁니다. 이름이 같은 파일은 덮어쓰고 다른 파일은 그대로 둡니다. 데이터세트를 롤백하거나 교체하는 일은 없습니다. BombVault는 시작하기 전에 한 번, 쓰기 직전에 한 번 더 데이터세트가 마운트되어 있고 보이며 쓸 수 있는지 확인합니다. 안에 하위 데이터세트가 마운트된 곳에는 아무것도 쓰지 않습니다. 하위 데이터세트는 자기 파일, 소유자, 권한을 그대로 유지하며 자기 백업에서 복원합니다.
  • 폴더로. /mnt 아래의 폴더를 고릅니다. BombVault는 그 폴더가 마운트된 풀이나 공유에 있는지, 빈 공간이 충분한지 확인합니다. SSH 연결 없이도, 이미 없어진 데이터세트에도 동작합니다.
  • 새 데이터세트로. 아직 없는 데이터세트 이름을 적습니다. 창이 <dataset>-restored를 제안합니다. BombVault는 백업에 저장된 ZFS 속성으로 데이터세트를 만들고 그 안으로 복원합니다. 새 데이터세트로 복원을 참고하세요.

데이터세트로 이 백업의 모든 데이터세트를 고르면 트리의 모든 데이터세트를, 고른 폴더 안의 각자 하위 폴더에 씁니다. 그 백업에서 건너뛴 데이터세트는 이름이 표시됩니다. 다른 BombVault의 저장소에서 복원하려면 복원 페이지의 이전 백업 폴더에서를 쓰세요. 이 방법은 항상 폴더로 복원합니다. 백업 하나의 모든 데이터세트를 각자 하위 폴더에, 또는 트리의 데이터세트 하나를 통째로나 고른 파일만 복원합니다.

항목의 멈출 컨테이너 목록은 데이터세트 안으로 복원할 때도 제공됩니다. 그 컨테이너들은 복원이 끝날 때까지 멈춘 채로 있고, 그동안 컨테이너 백업은 기다립니다.

안전 스냅샷

데이터세트에 쓰기 전에 BombVault는 그 데이터세트 하나의 ZFS 스냅샷을 bombvault-prerestore-<time>이라는 이름으로 찍습니다. 먼저 지금 상태의 ZFS 스냅샷을 남기기는 기본으로 켜져 있습니다. 끄려면 한 번 더 확인해야 합니다. 스냅샷을 찍을 수 없으면 아무것도 복원하지 않습니다.

BombVault는 안전 스냅샷을 스스로 지우지 않습니다. 항목에 나이와 크기가 함께 나열되고 각각 삭제 동작이 있으며, 가장 오래된 것이 30일을 넘으면 경고합니다. 삭제하거나 바뀐 데이터를 풀에 붙들어 두기 때문입니다.

복원 뒤에 되돌리려면 데이터세트 안의 .zfs/snapshot/bombvault-prerestore-<time>에서 파일을 하나씩 복사하세요. zfs rollback <dataset>@bombvault-prerestore-<time>은 그 스냅샷이 데이터세트의 가장 새 스냅샷일 때만 동작합니다. zfs rollback -r은 자동 스냅샷을 포함해 더 새로운 스냅샷을 모두 지웁니다.

새 데이터세트로 복원

BombVault는 백업할 때마다 모든 데이터세트에 로컬로 설정된 ZFS 속성을 함께 저장합니다. 압축, 레코드 크기, 쿼터, 예약, atime, xattr, acltype, 대소문자 구분, 그리고 사용자 속성이 해당합니다. 상속된 값과 읽기 전용 값은 저절로 돌아오므로 빠집니다. BombVault가 속성을 저장하기 전의 백업에는 속성이 없습니다.

  • 새 데이터세트로는 저장된 모든 속성으로 zfs create를 실행합니다. 대소문자 구분, 정규화, utf8only는 이 방법으로만 설정할 수 있습니다. 쿼터와 예약은 파일을 쓴 뒤에 설정하므로 쓰기를 막지 못합니다. 마운트 지점은 빠지므로 사본이 원본과 겹치지 않으며, canmount, readonly, 암호화 설정도 빠져서 복원이 쓸 수 있습니다. 암호화된 데이터세트 아래의 새 데이터세트는 그 암호화를 이어받습니다. 새 데이터세트 바로 위의 데이터세트는 있어야 합니다. 새 데이터세트를 만든 뒤에 무언가 실패하면 그 데이터세트는 서버에 남습니다. BombVault는 데이터세트를 절대 삭제하지 않기 때문입니다.
  • 데이터세트 안으로 복원은 저장된 속성을 복원 옆에 나열합니다. 이 속성도 설정은 기존 데이터세트가 아직 받을 수 있는 속성을 파일을 쓰기 전에 설정합니다. 쿼터와 예약은 파일을 쓴 뒤에 설정하므로 쓰기를 막지 못합니다. 이 스위치를 켜지 않으면 데이터세트는 설정을 그대로 유지합니다.

백업에 들어 있는 것

백업에 들어 있는 것: 백업한 모든 데이터세트의 파일과 폴더(restic이 저장하는 소유권, 모드, 타임스탬프, 확장 속성 포함), 그리고 각 데이터세트에 로컬로 설정된 ZFS 속성.

백업에 들어 있지 않은 것:

  • 각 데이터세트 최상위 폴더 자체의 소유자와 모드(그 아래의 모든 것은 포함됩니다). 데이터세트 안으로 복원하면 기존 최상위 폴더는 그대로 두고, 폴더로 복원하면 모드 0755로 만듭니다.
  • 이미 있는 ZFS 스냅샷,
  • 건너뛰었거나 제외한 하위 데이터세트,
  • 볼륨.

새 풀로 복원하려면 풀을 만든 다음 각 데이터세트를 새 데이터세트로 복원하세요. TrueNAS가 SMB 데이터세트에 쓰는 NFSv4 ACL이 기대한 대로 돌아오는지는 아직 검증되지 않았으니, 의존하기 전에 자신의 데이터로 복원을 시험해 보세요.

암호화된 데이터세트

암호화된 데이터세트는 키가 로드되어 있는 동안에만 백업됩니다. 그렇지 않으면 경고와 함께 건너뜁니다. zfs load-key로 키를 로드하고 데이터세트를 마운트하세요. BombVault는 복호화된 데이터를 읽어서 암호화되는 restic 저장소에 저장합니다. BombVault에서 암호화를 껐다면 그 저장소는 암호화되지 않습니다.

복제본

복제본은 항목의 데이터세트를 두 번째 ZFS 서버에 복사한 것입니다. BombVault는 zfs send와 zfs receive로 이를 최신으로 유지합니다. 첫 실행은 전부 보내고, 그 뒤에는 바뀐 블록만 전송됩니다. 다른 서버에서는 그 사본을 바로 마운트할 수 있습니다.

복제본은 백업을 대신하지 않습니다. 이전 버전, 개별 파일, 검사는 계속 백업에서 가져오며, 복제본은 설정한 수만큼의 스냅샷만 보관합니다. 최신 복제본은 사업장 밖의 사본으로 치지만 백업으로 치지는 않습니다.

복제본은 백업을 기다리지 않습니다. 백업할 때마다는 항목의 백업 실행이 끝난 뒤를 뜻하며, 그 실행이 성공했든 실패했든 할 일이 없었든 마찬가지입니다. ZFS 섹션에 켜진 저장 위치가 없고 항목에도 전용 저장소가 없으면, 항목의 백업 실행은 복제본만 보내며 복제본 카드가 시점 옆 말풍선에서 그렇게 알려 줍니다. 백업 목록, 항목의 머리글, 실행 기록에 복제본이 표시됩니다. 실행 중에는 복제 중, 끝나면 시각과 함께 복제됨입니다.

복제본 카드의 복제본만, 백업 없음을 켜면 ZFS 섹션 전체가 백업은 만들지 않고 복제본만 보냅니다. 전용 폴더와 오프사이트 저장 위치는 각자의 스위치를 유지하므로 이를 끄면 다시 그곳으로 백업하며, 모든 ZFS 항목의 카드에 섹션의 스위치가 현재 상태 그대로 표시됩니다. 이런 항목은 백업 대신 첫 복제본을 기다리고, 지금 백업은 지금 복제로 나오며, 항목의 컨테이너 멈추기와 명령은 백업할 때처럼 스냅샷 전후에 실행됩니다. 이 항목의 복제본은 며칠에 한 번 일정, 지연 알림, 적용 범위에 포함됩니다.

항목의 설정 탭에 있는 복제본 카드에서 켭니다. 카드에 모든 데이터세트와 볼륨이 상태와 함께 나열되고, 지금 복제가 실행을 시작합니다. 복제본 실행은 자기 잠금을 쓰므로 오래 걸리는 첫 전송이 백업을 막지 않습니다.

필드 설정하는 것
복제 대상 대상입니다. ZFS 서버(SSH 경유로 표시) 또는 페어링된 인스턴스입니다. ZFS 서버 추가로 새 서버를 설정합니다.
시점 백업할 때마다(항목의 백업 실행 직후) 또는 별도 계획입니다.
대상에 보존 ZFS 서버에 남기는 스냅샷 수입니다. 짧게, 균형, 길게, 사용자 지정 값 중에서 고릅니다. 페어링된 인스턴스는 이를 스스로 정합니다.
이 서버에 보존 가장 새로운 복제본 스냅샷 중 몇 개를 이 서버에도 남길지 정합니다. 0이나 1이면 최신 것만 남깁니다.
복제본만, 백업 없음 ZFS 섹션 전체가 복제본을 보내고 백업은 만들지 않습니다.

ZFS 항목의 복제본 카드. ZFS 항목의 복제본 카드.

백업 페이지에서 ZFS 타일을 골랐을 때 백업 동작 옆에 있는 지금 모두 복제는 모든 ZFS 항목의 복제본을 차례로 보냅니다. 서버가 이 일괄 작업을 실행하므로 페이지를 떠나도 계속되며, 복제할 수 없는 항목은 이름이 표시되고 건너뜁니다.

ZFS 서버로 보내기

ZFS와 SSH가 있는 기기라면 어디서든 받을 수 있습니다. 예를 들어 두 번째 Unraid나 TrueNAS가 있습니다. 그곳에서 BombVault가 돌 필요는 없습니다.

  1. 설정, 페어링의 BombVault 없는 ZFS 서버에서 SSH로 연결을 고르거나, 항목의 복제본 카드에서 ZFS 서버 추가를 고릅니다.
  2. 주소, 사용자, 포트를 입력합니다. 대화 상자에 BombVault의 공개 키가 표시됩니다. 이를 서버에 있는 그 사용자의 ~/.ssh/authorized_keys에 추가합니다. Unraid에서는 Users, root, SSH keys에 있습니다. Display Settings에 따라 Users는 헤더 메뉴 또는 Settings 아래에 있습니다. TrueNAS에서는 Credentials, Users에서 사용자를 편집합니다. 이것은 복제본용 키입니다. VM 및 호스트 SSH 연결의 키와는 다르므로, 그 키가 이미 허용되어 있어도 이 키를 추가하세요.
  3. 연결을 테스트합니다. 그러면 대화 상자에 서버의 풀이 나열됩니다. 하나를 고르고 루트를 정합니다. 기본값은 <pool>/bombvault-replica입니다.
  4. 항목의 복제본 카드에서 새 서버를 고릅니다. 그러면 서버는 인스턴스 페이지에 자기 카드를 갖게 되고, 열기를 누르면 서버의 페이지로 이동합니다.

root라면 그 외에 필요한 것이 없습니다. 별도 사용자는 대상 풀에서 다음 권한이 필요하며, 대화 상자에도 표시됩니다.

zfs allow <user> receive,create,mount,rollback,destroy,userprop,readonly,canmount <pool>

소스에서는 같은 종류의 사용자가 항목의 최상위 데이터세트에서 다음 권한이 필요합니다.

zfs allow <user> send,snapshot,hold,release,bookmark,destroy,mount <dataset>

이 방향에서는 항목을 가진 BombVault가 서버에 쓸 수 있는 키도 함께 가집니다.

BombVault는 서버가 처음 연결할 때 보여 주는 호스트 키를 고정해 두고, 나중에 다른 키가 오면 거부합니다. 서버를 다시 설치했다면 서버 페이지에서 호스트 키 지우기를 누르세요. 그러면 다음 연결에서 새 키가 고정됩니다.

이 서버의 호스트가 ZFS 서버에 직접 닿을 수 있으면, zfs send를 복제본 키와 고정된 호스트 키로 자기 ssh에 바로 파이프로 연결해 서버로 보내므로 스트림이 BombVault를 거치지 않습니다. 그렇지 않으면 스트림이 BombVault를 거칩니다.

페어링된 인스턴스로 보내기

페어링된 BombVault는 복제본을 스스로 받을 수 있습니다. 상대 호스트에 SSH 접근 권한을 주는 사람도 없고, authorized_keys 파일에 들어가는 키도 없습니다.

  1. 항목의 복제본 카드에서 대상으로 페어링된 인스턴스를 고르거나, 인스턴스 페이지의 그 인스턴스 카드에서 ZFS 서버 역할을 켜고 거기서 ZFS 항목을 고릅니다. 답이 올 때까지 카드에 승인 대기 중이 표시됩니다.
  2. 받는 인스턴스에서 인스턴스를 엽니다. 요청은 보내는 인스턴스의 카드에 배지로 나타나고 그 세부 정보에도 나열됩니다. 그 서버에서 풀과 루트, 그리고 스냅샷을 몇 개 남길지 고른 다음 허용 또는 거절을 누릅니다.
  3. 허용 뒤에는 소스가 다른 대상과 마찬가지로 자기 계획에 따라 보냅니다.

받는 인스턴스는 승인이 포함하는 것만 받습니다. 항목의 데이터세트를 자기 루트 안으로 받는 것입니다. zfs receive는 받는 인스턴스가 직접 실행하며, 소스는 그곳의 무엇도 삭제하거나 롤백할 방법이 없습니다. 그래서 소스를 누군가 장악하더라도 사본은 살아남습니다. 받는 인스턴스는 자기 보존 규칙을 유지합니다. 소스는 요청할 때 규칙을 제안할 뿐입니다. 그런 소스도 새 스냅샷은 보낼 수 있으며, 시간이 지나면 그 스냅샷이 다른 스냅샷과 마찬가지로 규칙에 따라 오래된 것을 밀어냅니다. 받는 인스턴스의 시계보다 앞선 날짜가 이름에 붙은 스냅샷은 그 시각이 될 때까지 규칙에 세지 않습니다.

받는 인스턴스의 액세스 취소는 언제든 승인을 끝내고 소스에 알립니다. 그러면 소스는 승인이 철회되었다고 표시하고 멈춥니다. 받는 인스턴스에 이미 있는 것은 그대로 남습니다. 거절한 요청은 거절된 채로 있습니다. 데이터세트를 더 추가하거나 취소 뒤에 요청하면 다시 묻습니다.

받는 인스턴스는 HTTPS로 응답해야 합니다. 토큰과 데이터가 암호화 없이 네트워크를 지나가게 되므로 소스는 일반 http 주소로는 아무것도 보내지 않습니다. 또한 전송마다 받는 풀의 10분의 1을 비워 두고, 그 안으로 파고들기 전에 멈추므로 소스 하나가 받는 서버의 풀을 가득 채울 수 없습니다.

데이터가 놓이는 곳

데이터세트는 각각 <root>/<server>/<pool>/<path>에 놓입니다. 서버 폴더는 소스 인스턴스의 이름이며 첫 전송 때 정해지므로, 풀 이름이 같은 두 서버가 서로 방해하지 않습니다. 예를 들어 tower라는 서버의 cache/appdata는 backup/bombvault-replica/tower/cache/appdata에 놓입니다.

BombVault를 다시 설정한 뒤에는, 대상이 이전에 이 BombVault가 채운 폴더를 거부합니다. 그러면 복제본 카드에 폴더 넘겨받기가 나타나고, 다음 복제본은 그 안의 사본에서 이어집니다. 다른 BombVault가 그 폴더로 더 이상 복제하지 않을 때만 넘겨받으세요.

대상의 사본은 읽기 전용입니다. 기본값으로는 마운트되지 않으므로 그 서버의 어떤 것도 가리지 않습니다. SSH로 연결한 ZFS 서버는 자기 페이지에 서버에서 읽기 전용으로 마운트 스위치가 있습니다. 켜면 BombVault가 실행할 때마다 그곳에 사본을 읽기 전용으로 마운트하므로, 대상에서 파일을 읽고 복사할 수 있습니다. 암호화된 사본은 키를 로드하기 전까지 잠겨 있으며, 스위치를 꺼도 마운트 해제는 하지 않습니다. 복제본을 받는 페어링된 인스턴스는 마운트하지 않은 채로 둡니다. ZFS 속성은 함께 전달되지만 마운트 지점과 sharenfs, sharesmb는 제외됩니다. reservation과 refreservation도 남겨 두므로 사본은 데이터에 필요한 공간만 차지합니다.

들어가는 것

항목이 백업하는 모든 것이 들어가고, 백업이 건너뛰는 그 아래의 볼륨도 들어갑니다. 항목에서 꺼 둔 하위 데이터세트는 빠집니다. 한 번의 실행에 속하는 모든 데이터세트는 백업에서처럼 하나의 스냅샷에서 나옵니다.

다른 BombVault가 이 서버로 복제하는 사본은 더 보내지 않습니다. 보내면 그 소스가 아직 필요로 하는 기록을 솎아 내게 되기 때문입니다. 항목의 트리에 그런 사본이 있으면, 항목에서 그것을 끌 때까지 실행은 그 데이터세트에 대해 실패하고 이유를 알려 줍니다. 그 자체가 그런 사본인 항목은 아예 복제할 수 없습니다. 항목을 삭제하거나 복제본을 꺼도 그 사본과 스냅샷은 그대로 남습니다. 복제본 사용하기에 설명된 대로 사본을 넘겨받으면 일반 데이터세트로 취급됩니다.

스냅샷이 남는 기간

대상에서는 새 복제본이 일별 7개와 주별 3개의 스냅샷을 유지합니다. 대신 짧게, 균형, 길게를 고르거나 사용자 지정 값을 설정할 수 있습니다. 사용자 지정 값을 모두 0으로 하면 모든 스냅샷을 유지하며, 카드에 그렇게 표시됩니다. 대상에서는 bombvault-replica-<14 digits>라는 이름의 스냅샷만 지워지며, 양쪽이 공유하는 가장 새로운 스냅샷은 절대 지워지지 않습니다.

소스에서는 BombVault가 마지막 복제본 스냅샷과, 보낸 모든 상태의 북마크를 유지합니다. 북마크는 공간을 차지하지 않습니다. 다음 전송은 이를 기점으로 시작합니다.

소스에도 더 남기려면 복제본 카드에서 이 서버에 보존을 설정하세요. 예를 들어 7로 두면 대상이 남기는 것과는 별개로, 복제본을 보낼 때마다 가장 새로운 복제본 스냅샷 그만큼이 이 서버에 남습니다. 0이나 1이면 최신 것만 남깁니다. 최신 스냅샷에는 홀드가 걸려 있어서 다음 전송의 기점이 실수로 지워지지 않습니다. 더 오래된 것에는 홀드가 없습니다. 스냅샷은 그 뒤에 바뀐 블록을 붙들고 있으므로, 남기는 스냅샷은 하나하나 풀의 공간을 차지합니다. 복제본을 끄거나 다른 대상으로 바꾸거나 항목을 삭제하면 이 서버에서도 지워집니다. 그 아래에 중첩된 다른 항목의 스냅샷은 남습니다. 항목을 삭제할 때 호스트에 연결할 수 없으면 스냅샷도 남으며, 페이지가 그렇게 알려 줍니다. 직접 지우세요. zfs release -r bombvault-replica <dataset>@<snapshot>를 실행한 다음 zfs destroy를 실행합니다.

남겨 둔 스냅샷의 파일은 데이터세트나 복제본을 건드리지 않고 데이터세트 안의 .zfs/snapshot 폴더나 클론에서 바로 읽고 복사할 수 있습니다.

ls /mnt/cache/appdata/.zfs/snapshot/bombvault-replica-20261006014100
zfs clone cache/appdata@bombvault-replica-20261006014100 cache/appdata-20261006

클론은 안에서 무언가 바뀌기 전까지 공간을 차지하지 않습니다. 다 쓰면 zfs destroy cache/appdata-20261006으로 지우세요. 클론이 있는 스냅샷은 지울 수 없기 때문입니다.

가장 최근 복제본 스냅샷으로 돌아가는 것은 여기서 zfs rollback cache/appdata@<latest>만 실행하면 되고 대상에서는 할 일이 없습니다. 데이터세트 전체를 더 오래된 스냅샷으로 롤백하면 그 뒤의 스냅샷이 이 서버와 대상 모두에서 사라집니다. 최신 스냅샷은 홀드되어 있으므로 먼저 홀드를 풀고 여기서 데이터세트를 롤백하세요.

zfs release -r bombvault-replica cache/appdata@bombvault-replica-20261008014200
zfs rollback -r cache/appdata@bombvault-replica-20261006014100

대상의 사본도 되돌려야 하지만, 항상 같은 스냅샷으로 돌릴 수 있는 것은 아닙니다. 대상 자체의 보존 규칙이 그 스냅샷을 지웠을 수 있기 때문입니다. 복제를 한 번 실행하세요. 대상에 더 새로운 스냅샷이 있어서 해당 데이터세트에서 멈추고, 복제본 카드와 실행 기록이 대상을 되돌릴 스냅샷을 알려 줍니다. 양쪽이 아직 공유하는 가장 새로운 스냅샷입니다. ZFS 서버에서, 또는 복제본을 받는 페어링된 인스턴스의 호스트에서 사본을 그 스냅샷으로 롤백하세요. 예를 들면 다음과 같습니다.

zfs rollback -r backup/bombvault-replica/tower/cache/appdata@bombvault-replica-20261005014000

zfs rollback은 데이터세트 하나에 대해 동작하므로, 되돌리려는 하위 데이터세트마다 롤백을 반복하세요. 그다음 지금 복제를 누르면 공유 스냅샷에서 이어집니다.

복제본의 암호화된 데이터세트

암호화된 데이터세트는 raw로 전송됩니다. 대상에서도 암호화된 채로 있고, 대상은 키를 보지 못합니다. 키를 안전하게 보관하세요. 복원 뒤에 사본을 열려면 키가 필요하며, 키가 없는 복제본은 읽을 수 없습니다.

복제본 사용하기

항목의 백업 탭을 열고 스냅샷을 가진 장소 중 ZFS 복제본 행을 클릭합니다. 시트에 대상의 스냅샷이 나열되고, 실제 이름이 들어간 명령이 표시됩니다.

예전 상태를 보려면 대상에서 스냅샷을 클론하세요. 클론은 무언가 바뀌기 전까지 공간을 차지하지 않고 복제본은 건드리지 않습니다.

zfs clone backup/bombvault-replica/tower/cache/appdata@bombvault-replica-20261006014100 backup/bombvault-replica/clone-appdata

소스가 고장나면 대상에서 사본을 쓰기 가능한 일반 데이터세트로 바꾸세요.

zfs inherit -r readonly backup/bombvault-replica/tower/cache/appdata && zfs list -rH -o name -t filesystem backup/bombvault-replica/tower/cache/appdata | xargs zfs set canmount=on && zfs mount -a

그 뒤로 BombVault는 그 데이터세트와 그 하위 데이터세트로 복제하지 않습니다. 다음 실행은 이유와 함께 실패하며, 쓴 내용은 그대로 남습니다. 사본의 가장 새로운 스냅샷 이후 사본에 쓰인 다른 모든 것도 마찬가지입니다. BombVault는 사본을 절대 롤백하지 않습니다. 그곳으로 다시 복제하려면 필요한 것을 사본에서 옮긴 뒤 대상에서 사본을 삭제하세요. 그러면 다음 실행이 모든 것을 새로 보냅니다.

어떤 상태를 소스로 되찾으려면 시트에서 새 데이터세트로 되돌리기를 누르세요. BombVault는 스냅샷을 원본 옆의 새 데이터세트로 보내며, 이름은 <dataset>-bombvault-restore-에 타임스탬프를 붙인 것입니다. 원본 위에 덮어쓰는 일은 없습니다. 소스에서 잃어버린 하위 데이터세트도 사본에 그 스냅샷이 아직 있으면 돌아옵니다. 그 스냅샷이 없는 하위 데이터세트는 빠지며, 실행 기록에 그렇게 알립니다.

예제: 두 번째 Unraid 서버로 복제본 보내기

서버 tower가 데이터세트 cache/appdata를 ZFS 항목으로 백업합니다. BombVault가 없는 두 번째 Unraid 서버(192.168.1.20)에 backup이라는 풀이 있고, 언제든 읽을 수 있는 사본을 거기에 두려고 합니다.

  1. 백업을 열고 cache/appdata, 그리고 설정 탭을 엽니다. 복제본 카드의 복제 대상에서 ZFS 서버 추가를 고릅니다.
  2. 192.168.1.20, 사용자 root, 포트 22를 입력합니다. 대화 상자에 복제본용 키가 표시됩니다. 두 번째 서버에서 Users, root, SSH keys에 이를 붙여 넣고 Apply를 누르세요. 이 키는 Host SSH 키와 다르므로, 그 키가 이미 있어도 추가하세요.
  3. 연결을 테스트합니다. 풀 backup을 고르고 제안된 루트 backup/bombvault-replica를 그대로 둡니다.
  4. 카드로 돌아오면 복제 대상에 새 서버가 선택되어 있습니다. 시점은 백업할 때마다로, 대상에 보존은 일별 7개와 주별 3개 스냅샷 그대로 두고, 이 서버에 보존은 7로 설정합니다.
  5. 지금 복제를 누릅니다. 첫 실행은 전부 보내므로 1 Gbit/s 회선으로 300 GB면 최소 40분이 걸립니다. 카드와 백업 목록에 복제 중이 표시되다가 시각과 함께 복제됨으로 바뀝니다. 이후 실행은 바뀐 블록만 보냅니다.

이제 데이터세트는 두 번째 서버의 backup/bombvault-replica/tower/cache/appdata에 읽기 전용으로 놓여 있습니다. 개요에서 ZFS 섹션의 오프사이트는 이 복제본을 사업장 밖의 사본으로 셉니다.

지난 화요일의 파일 하나를 꺼내는 방법은 세 가지입니다.

  • 이 서버에서, 이 서버에 보존이 스냅샷 일곱 개를 갖고 있으니 다음과 같이 합니다.

    cp /mnt/cache/appdata/.zfs/snapshot/bombvault-replica-20261103014100/plex/Preferences.xml /mnt/user/restore/
    
  • 두 번째 서버에서, 대상의 스냅샷을 클론해서 꺼냅니다. 항목의 백업 탭에서 ZFS 복제본 행을 클릭하면 실제 이름이 들어간 명령이 표시됩니다. 다 쓰면 zfs destroy로 클론을 지우세요.

  • 마운트로, ZFS 서버 페이지에서 서버에서 읽기 전용으로 마운트를 켭니다. 다음 실행 뒤부터 사본이 두 번째 서버에 읽기 전용으로 마운트되어 있습니다.

복제본이 보관하는 것보다 오래된 버전은 다음 예제처럼 계속 백업에서 가져옵니다.

예제: ZFS 백업에서 파일 하나

  1. 복원을 열고 ZFS 타일을 고른 다음 cache/appdata를 클릭합니다.
  2. 백업을 고르고, 데이터세트에서 그 파일이 들어 있는 데이터세트를 고릅니다.
  3. 무엇에서 개별 파일을 고르고 파일에 체크합니다.
  4. 어디로에서 폴더로를 고르고 user/restore 같은 /mnt 아래의 폴더를 고릅니다. SSH 연결이 필요 없으며, 이미 없어진 데이터세트에도 동작합니다.
  5. 복원을 누릅니다. 파일은 그 위의 경로 없이 폴더 바로 안에 놓입니다.

남은 스냅샷

백업의 스냅샷 이름은 <dataset>@bombvault-<14 digits>이며, 예를 들면 cache/appdata@bombvault-20260924021500(UTC)입니다. BombVault는 백업 직후에 이를 제거합니다. 데이터세트가 사용 중이거나 BombVault가 멈추는 등의 이유로 실패하면, BombVault는 다음 시점에 이를 제거합니다.

  • 그 항목의 다음 백업 전에,
  • BombVault가 시작할 때, 모든 항목에 대해, 도메인이 꺼져 있어도,
  • 항목을 삭제할 때,
  • 항목에서 지금 지우기를 누를 때(남은 개수가 표시됩니다).

bombvault- 뒤에 숫자 14자리가 정확히 붙은 이름만 제거됩니다. 안전 스냅샷, 직접 만든 스냅샷, 자동 스냅샷은 절대 건드리지 않습니다. 직접 하나를 제거하려면 다음과 같이 합니다.

zfs destroy -r cache/appdata@bombvault-20260924021500

복제본의 스냅샷 이름은 <dataset>@bombvault-replica-<14 digits>이며 남은 스냅샷이 아닙니다. 소스에서는 더 새로운 복제본 실행이 대체할 때까지, 또는 이 서버에 보존이 유지하는 동안 남고, 대상에서는 보존 규칙이 유지하는 동안 남습니다. 정리 작업은 bombvault- 뒤에 정확히 숫자 14자리가 오는 이름만 대상으로 하므로 이 스냅샷은 건드리지 않습니다.

이상 징후

비워진 하위 데이터세트 하나는 큰 트리의 전체 합계를 거의 바꾸지 않습니다. 그래서 이상 징후 감지는 항목의 모든 데이터세트를 각각 따로 지켜봅니다. 크기, 파일 수, 새 데이터, restic 시간이 저마다 자기 기록을 가집니다. 이 기록은 데이터세트 이름에 속하므로, 나중에 그 트리가 다른 항목으로 백업되어도 유지됩니다.

이전 실행이 백업했는데 이번 실행이 읽지 못한 데이터세트는, 항목의 선택이 바뀌지 않은 한 비워진 것으로 셉니다. 로드되지 않은 키, 마운트되지 않은 데이터세트, 트리에서 사라진 데이터세트가 여기에 해당합니다. 직접 제외한 하위 데이터세트는 선택을 바꾸므로 기록이 새로 시작됩니다. 데이터 손실에 대한 발견 사항이 열려 있는 동안 보존 정리는 해당 데이터세트 하나의 이전 백업을 유지하고, 트리의 나머지는 평소처럼 정리합니다.

모든 데이터세트는 항목의 모니터링에 자기 줄을 가집니다. 이는 이상 징후 페이지의 모니터링으로 열리며 항목의 검증 탭에 있습니다. 열려 있는 발견 사항은 각 데이터세트 옆에 표시됩니다. 발견 사항의 링크는 그 데이터세트의 마지막 정상 백업에서 복원 창을 엽니다. 실행이 끝났는지의 판단은 실행이 통째로 성공하거나 실패하므로 항목 전체를 기준으로 합니다.

검사 자체는 이상 징후에 설명되어 있습니다. MCP 서버로 연결한 어시스턴트는 ZFS 항목의 복원 지점을 나열하고, 백업을 시작하고, 발견 사항을 읽을 수 있지만, 발견 사항을 확인 처리하는 것은 이상 징후 페이지에서 합니다.

사유 코드

항목 페이지, 실행 기록, 알림은 문제를 이 코드 중 하나로 알립니다. 대부분은 페이지에도 해결 방법이 바로 옆에 나와 있습니다.

코드 의미 할 일
ssh-missing 이 컨테이너에 SSH 연결이 설정되어 있지 않습니다. VM 백업과 같은 방식으로 SSH 연결을 설정하세요.
host-placeholder Host SSH: Address가 아직 자리표시자이고, host.docker.internal도 응답하지 않았습니다. Host SSH: Address를 이 서버의 LAN IP로 설정하세요.
host-fallback Host SSH: Address가 아직 자리표시자이지만 host.docker.internal은 동작합니다. 그대로 두거나 LAN IP를 설정하세요.
ssh-unreachable SSH로 서버에 닿을 수 없습니다. 주소와 포트, 그리고 SSH가 켜져 있는지 확인하세요.
ssh-auth 서버가 BombVault의 키를 거부했습니다. 이 서버와의 연결에 표시된 명령을 서버에서 한 번 실행하세요.
zfs-not-found SSH 호스트에 zfs 명령이 없습니다. Host SSH: Address가 풀을 가진 기기를 가리키게 하세요.
zfs-permission SSH 사용자가 이 zfs 명령을 실행할 수 없습니다. root를 쓰거나 TrueNAS SCALE을 참고하세요.
uri-mismatch LIBVIRT_URI가 SSH 필드와 다른 호스트나 사용자를 가리킵니다. 서로 일치시키거나, SSH 필드를 비워서 둘 다 URI에서 가져오게 하세요.
zfs-error zfs가 다른 오류를 보고했습니다. 세부 정보에 그 메시지가 표시됩니다.
propagation-missing 호스트의 새 마운트가 컨테이너에 전달되지 않습니다. Host Data의 Access Mode를 Read/Write - Slave로 설정하고 BombVault를 다시 시작하세요.
invalid-name BombVault가 받아들이지 않는 데이터세트 이름입니다. 데이터세트 이름을 바꾸세요.
name-too-long 트리의 데이터세트 이름이 스냅샷 이름으로 쓰기에 너무 깁니다. 이름을 바꾸거나, 그 아래의 데이터세트를 항목으로 추가하세요.
invalid-exclude 제외 패턴이나 제외한 하위 데이터세트가 항목과 맞지 않습니다. 메시지가 가리키는 항목을 고치세요. 하위 데이터세트 전체를 제외하려면 패턴을 쓰지 말고 그 스위치를 끄세요.
not-found 서버에 데이터세트가 없습니다. 항목을 제거하거나 데이터세트를 다시 만드세요. 백업은 계속 복원할 수 있습니다.
not-filesystem 파일 시스템이 아니라 볼륨입니다. 볼륨을 참고하세요.
overlaps-item 데이터세트가 기존 항목과 겹칩니다. 항목은 겹치지 않습니다를 참고하세요.
docker-storage 트리에 Docker의 이미지 스토리지가 들어 있습니다. Docker 스토리지를 참고하세요.
nothing-readable 지금 항목의 어떤 데이터세트도 읽을 수 없습니다. 건너뛴 데이터세트의 코드를 확인하세요.
snapshot-failed 스냅샷을 만들 수 없었습니다. 세부 정보에 zfs의 메시지가 표시됩니다.
containers-busy 컨테이너를 멈춰야 할 때 컨테이너 백업이 아직 실행 중이었습니다. 나중에 다시 시작하세요. 예약 실행은 알아서 기다립니다.
consistency-stop-failed 컨테이너를 멈출 수 없어서 스냅샷을 찍지 않았습니다. 컨테이너를 확인하거나 목록에서 빼세요.
pre-snapshot-failed 스냅샷 전 명령이 실패했습니다. 실행 세부 정보에 그 출력이 표시됩니다.
container-unknown 목록의 컨테이너가 존재하지 않습니다. 목록에서 제거하세요.
container-is-self BombVault는 자기 자신의 컨테이너를 멈출 수 없습니다. 목록에서 제거하세요.
leftover-snapshots BombVault가 제거하지 못한 스냅샷이 서버에 남아 있습니다. 지금 지우기를 누르세요. 남은 스냅샷을 참고하세요.
zvol 트리 안의 볼륨이며 건너뜁니다. 볼륨을 참고하세요.
canmount-off 마운트되지 않는 데이터세트(canmount=off)여서 건너뜁니다. 데이터가 있다면 마운트하거나 데이터를 하위 데이터세트로 옮기세요.
legacy-mount 레거시 마운트 지점이어서 건너뜁니다. /mnt 아래의 마운트 지점을 지정하세요.
no-mountpoint 마운트 지점이 없어서 건너뜁니다. /mnt 아래의 마운트 지점을 지정하세요.
not-mounted 서버에 마운트되어 있지 않아서 건너뜁니다. zfs mount를 하거나 canmount=on으로 설정하세요.
key-not-loaded 암호화되어 있고 키가 로드되지 않아서 건너뜁니다. zfs load-key를 한 뒤 마운트하세요.
snapdir-disabled 스냅샷 접근이 꺼져 있어서 건너뜁니다. zfs set snapdir=hidden <dataset>. .zfs 폴더는 숨겨진 채로 있습니다.
not-visible BombVault가 데이터세트의 마운트 지점을 볼 수 없습니다. 마운트 지점을 Host Data 경로 아래로 옮기거나, 같은 경로로 Read/Write - Slave를 지정해 컨테이너에 매핑하세요.
shfs-only 데이터세트가 스냅샷을 숨기는 /mnt/user로만 보입니다. Host Data로 /mnt/user가 아니라 /mnt를 매핑하세요.
snapshot-not-visible 스냅샷은 만들어졌지만 BombVault 안에 나타나지 않았습니다. 스냅샷 접근 확인을 실행하세요. 아래를 참고하세요.
snapshot-loop Host Data가 새 마운트를 전달하지 않아서 스냅샷이 BombVault에 닿지 않았습니다. Host Data의 Access Mode를 Read/Write - Slave로 설정하고 BombVault를 다시 시작하세요.
backup-failed 이 데이터세트에서 restic이 실패했습니다. 실행 세부 정보에 이유가 표시됩니다.
not-reached 이 데이터세트에 도달하기 전에 실행이 끝났습니다. 백업을 다시 실행하세요.
gone 데이터세트가 더 이상 서버에 없습니다. 할 일 없음. 백업은 계속 복원할 수 있습니다.
read-only-mount BombVault가 데이터세트를 읽기만 할 수 있어서 그 안으로 복원할 수 없습니다. 매핑을 Read/Write - Slave로 바꾸거나 폴더로 복원하세요.
destination-not-mounted 폴더가 마운트된 풀이나 공유에 있지 않습니다. 풀이나 공유에 있는 폴더를 고르세요.
not-enough-space 대상의 빈 공간이 부족합니다. 공간을 확보하거나 다른 폴더를 고르세요.
safety-snapshot-failed 안전 스냅샷을 찍을 수 없어서 아무것도 복원하지 않았습니다. 세부 정보에 zfs의 메시지가 표시됩니다.
safety-name-too-long 데이터세트 이름이 안전 스냅샷 이름으로 쓰기에 너무 깁니다. 안전 스냅샷을 끄거나 폴더로 복원하세요.
dataset-exists 같은 이름의 데이터세트가 이미 있습니다. 새 이름을 고르거나 그 데이터세트 안으로 복원하세요.
create-failed 새 데이터세트를 만들 수 없었습니다. 세부 정보에 zfs의 메시지가 표시됩니다. 바로 위의 데이터세트가 있는지 확인하세요.
new-dataset-not-visible 새 데이터세트는 만들어졌지만 BombVault가 볼 수 없어서 아무것도 복원하지 않았습니다. 데이터세트는 서버에 남아 있습니다. Host Data 경로 아래에 마운트하고 그 안으로 복원하세요.
set-properties-failed 저장된 속성을 설정할 수 없어서 아무것도 복원하지 않았습니다. 세부 정보에 zfs의 메시지가 표시됩니다.
set-limits-failed 파일은 복원했지만 저장된 쿼터나 예약을 설정할 수 없었습니다. 세부 정보에 zfs의 메시지가 표시됩니다. zfs set으로 쿼터나 예약을 직접 설정하세요.

컨테이너가 보는 것 확인하기

항목의 설정 탭에 있는 스냅샷 접근 확인은 트리의 실제 스냅샷을 찍고, 모든 데이터세트에 대해 BombVault 안에서 그것을 찾아본 뒤, 다시 제거합니다. 첫 예약 실행 전에 전체 경로를 확인하는 가장 빠른 방법입니다.

직접 확인하려면 서버에서 다음을 실행하세요.

docker exec BombVault grep zfs /proc/self/mountinfo

각 줄은 컨테이너 안의 마운트 하나입니다. 데이터세트의 줄에는 컨테이너 안의 경로(/host/user 아래)와 데이터세트 이름이 표시됩니다. 그 줄에 master:N 필드가 있으면 그 마운트는 호스트가 나중에 만드는 마운트를 받는다는 뜻이며, 스냅샷 접근에 필요한 조건입니다. 없다면 Host Data의 Access Mode를 Read/Write - Slave로 설정하고 BombVault를 다시 시작하세요.

TrueNAS SCALE

  • LIBVIRT_URI가 설정되어 있으면(TrueNAS의 VM 백업처럼) BombVault는 zfs 명령용 SSH 호스트, 사용자, 포트 중 따로 설정되지 않은 것을 URI에서 가져옵니다. VM 백업을 쓰지 않으면 설정할 것이 없습니다. TrueNAS 앱에서는 host.docker.internal이 해석되지 않으므로, BombVault는 앱의 기본 게이트웨이를 통해 root로 22번 포트로 호스트에 접속합니다. 다른 주소나 사용자를 쓰려면 앱의 environment에 LIBVIRT_HOST, LIBVIRT_SSH_USER, LIBVIRT_SSH_PORT를 설정하세요.
  • 설정, 연동, 호스트 SSH의 호스트 SSH 키를 Credentials, Users에서 root에 추가하고, System, Services에서 SSH 서비스를 켜세요. 이 TrueNAS나 다른 TrueNAS로의 복제본에는 복제본용 키도 필요하며, 그 키는 다른 키입니다.
  • root가 아닌 사용자는 항목의 최상위 데이터세트에 권한이 필요하며, 그러면 그 아래의 모든 데이터세트에 적용됩니다.
zfs allow <user> snapshot,destroy,mount <dataset>

새 데이터세트로 복원하려면 그 바로 위의 데이터세트에 create도 필요하고, 저장된 속성을 설정하려면 그 속성에 대한 권한이 필요합니다.

TrueNAS에서 root가 아닌 SSH 세션은 경로에 /usr/sbin이 없습니다. 그래서 BombVault는 /usr/sbin/zfs를 직접 호출합니다. - 앱의 Host Data는 ixVolume이 아니라 /mnt/tank처럼 데이터세트 위쪽의 호스트 경로여야 합니다. 호스트 경로를 쓰면 앱이 호스트의 새 마운트를 BombVault에 전달(rslave)하며, 스냅샷 접근에 필요한 조건입니다. 앱 설정 전체는 TrueNAS SCALE을 참고하세요.