Debian 13 강좌 / UUID와 fstab 자동 마운트·부팅 오류 예방

Debian 13에서 데이터 디스크를 재부팅 후 자동 마운트하려면 실제 파일 시스템 UUID를 확인하여 fstab에 등록하고, 재부팅 전에 후보 파일 검사와 해당 경로의 마운트부터 확인합니다. 선택 디스크에는 nofail을 검토할 수 있지만, 부팅이 계속된다는 사실과 데이터 마운트·서비스가 정상이라는 사실은 따로 확인해야 합니다.

UUID를 쓰는 이유와 실습 조건

/dev/sdb1 같은 장치 이름은 디스크 탐지 순서에 따라 바뀔 수 있습니다. UUID(Universally Unique Identifier, 범용 고유 식별자)는 파일 시스템을 식별하는 값으로, fstab에서 장치 이름 대신 사용할 수 있습니다. Debian fstab 설명서도 LABEL·UUID를 이용한 지정 방법을 설명합니다.

이 강좌는 새 디스크에 GPT·ext4를 만든 실습의 8GiB 데이터 디스크를 그대로 사용합니다. 파일 시스템과 work/probe.txt는 이미 존재하며, 다시 포맷하지 않습니다. 기존 루트·EFI·swap 항목은 편집하지 않고 /srv/lf-data22 한 경로만 추가합니다.

lsblk -o NAME,SIZE,FSTYPE,LABEL,UUID,PARTUUID,MOUNTPOINTS
data_part=/dev/disk/by-id/ata-VBOX_HARDDISK_VB50a843e8-b263b0b5-part1
sudo blkid "$data_part"
data_uuid=$(sudo blkid -s UUID -o value "$data_part")
printf '%s\n' "$data_uuid"
findmnt -n -o SOURCE,FSTYPE /

by-id 경로는 자신의 데이터 파티션에 맞춥니다. 이 실습의 파일 시스템 UUID는 9d0dfcd8-cbef-4b80-843e-346430ff8737이었습니다. 같은 출력의 PARTUUID는 GPT 파티션 자체의 식별자로 별개의 값입니다. 이 글은 파일 시스템 UUID를 사용하므로 두 값을 섞지 마세요.

UUID는 마운트를 해제해도 유지되지만 새 파일 시스템을 만들면 달라질 수 있습니다. 디스크를 그대로 복제하면 UUID도 복제될 수 있으므로 같은 UUID의 복사본 두 개를 동시에 연결해 놓고 하나로 식별된다고 가정하지 않습니다. lsblk에서 대상·용량·파일 시스템·중복 값을 함께 확인합니다.

fstab 한 줄의 여섯 필드 읽기

이 실습에서는 없어도 운영체제가 부팅할 수 있는 선택 데이터 디스크로 구성합니다. 아래는 실제 사용한 한 줄입니다. 자신의 UUID가 다르면 실제 조회 값으로 바꿔야 합니다.

UUID=9d0dfcd8-cbef-4b80-843e-346430ff8737 /srv/lf-data22 ext4 defaults,nofail,x-systemd.device-timeout=5s 0 2
필드 이 예제의 값 판단할 내용
파일 시스템 UUID=실제 파일 시스템 UUID 대상 파티션과 ext4 UUID가 일치하는지 확인
마운트 지점 /srv/lf-data22 전용 디렉터리이며 기존 데이터·다른 마운트와 충돌하지 않음
형식 ext4 실제 파일 시스템 형식과 일치
옵션 defaults,nofail,x-systemd.device-timeout=5s 기본 마운트와 선택 디스크 처리, 장치 대기 제한
dump 0 dump 도구의 대상으로 지정하지 않음; 별도 백업 정책과 구분
파일 시스템 검사 2 루트 외 파일 시스템의 부팅 검사 대상으로 사용; 0은 검사 제외

필드 사이에는 공백이나 탭을 사용하고 옵션 사이는 쉼표로 구분합니다. 경로 안에 공백이 있으면 fstab의 이스케이프 규칙이 필요하므로 이 실습은 공백 없는 경로를 사용합니다. systemd의 fstab 변환에서는 루트 검사를 먼저 처리하고 나머지 pass 값은 단순한 검사 여부로 다루므로, 숫자 2·3만으로 모든 데이터 디스크의 순서를 정한다고 해석하지 않습니다.

원본 백업과 후보 파일 검사

같은 데이터 파일 시스템이 다른 경로에 마운트되어 있지 않은지 먼저 확인합니다. 해당 경로·백업 폴더가 이미 있으면 덮어쓰지 말고 기존 내용을 확인합니다. 콘솔에서 로그인·sudo가 가능한지 확인한 후 진행하고, 현재 SSH 세션은 재부팅 전 검사와 원복을 마칠 때까지 유지하세요.

findmnt -rn -S "UUID=$data_uuid"
grep -n '/srv/lf-data22' /etc/fstab
ls -ld /srv/lf-data22 /var/backups/lf-debian13-22
sudo findmnt --verify --verbose

아직 등록·마운트하지 않은 이 실습에서는 첫 두 조회에 일치 항목이 없어야 합니다. ls의 파일 없음 오류도 새 경로 확인의 예상 결과입니다. 기존 fstab 검사는 현재 상태를 이해하기 위한 기준입니다. 이 VM에는 빈 광학 드라이브의 noauto 항목 때문에 미디어 형식을 감지할 수 없다는 기존 경고가 하나 있었으며, 새 데이터 항목 오류와 구분했습니다. 모르는 경고를 일괄 무시하지는 마세요.

sudo test ! -e /var/backups/lf-debian13-22 &&
sudo install -d -m 700 /var/backups/lf-debian13-22 &&
sudo cp -a /etc/fstab /var/backups/lf-debian13-22/fstab-before &&
sudo cp /etc/fstab /var/backups/lf-debian13-22/fstab-candidate
sudo test ! -e /srv/lf-data22 &&
sudo install -d -m 755 /srv/lf-data22

어느 사전 조건에서든 실패하면 진행하지 않습니다. 원본 fstab은 보관하고 후보 파일에만 새 줄을 추가합니다. UUID 변수가 빈 값이면 추가하지 않도록 확인합니다.

test -n "$data_uuid" &&
printf '\nUUID=%s /srv/lf-data22 ext4 defaults,nofail,x-systemd.device-timeout=5s 0 2\n' "$data_uuid" |
sudo tee -a /var/backups/lf-debian13-22/fstab-candidate > /dev/null
sudo findmnt --verify --verbose --tab-file /var/backups/lf-debian13-22/fstab-candidate

findmnt의 verify 검사로 구문과 사용 가능성을 살펴봅니다. 새 항목에 UUID 미확인·형식 불일치·경로 문제 등이 있으면 적용하지 않습니다. 실습에서는 별도의 필수 마운트 후보에 존재하지 않는 UUID를 넣어 unreachable on boot required source 오류를 확인했고, 실제 fstab은 바꾸지 않은 상태에서 수정했습니다.

검사 성공이 실제 마운트 성공이나 재부팅 후 정상 동작까지 보증하지는 않습니다. 특히 nofail을 지정한 선택 디스크는 누락 상태를 필수 디스크와 다르게 처리할 수 있으므로, 경고 내용과 현재 장치를 함께 확인해야 합니다.

해당 경로만 마운트하고 생성 유닛 확인

후보를 준비한 동안 다른 편집으로 fstab이 바뀌지 않았는지 비교한 뒤 적용합니다. cmp가 다르다고 나오면 원본을 강제로 덮어쓰지 말고 최신 변경에 이번 항목만 다시 반영합니다.

sudo cmp /etc/fstab /var/backups/lf-debian13-22/fstab-before &&
sudo cp /var/backups/lf-debian13-22/fstab-candidate /etc/fstab
sudo systemctl daemon-reload
sudo mount /srv/lf-data22
findmnt --mountpoint /srv/lf-data22
findmnt -n -o UUID --mountpoint /srv/lf-data22
cat /srv/lf-data22/work/probe.txt

파일 시스템 UUID와 ext4·rw를 확인하고 기존 data-disk21 한 줄을 읽습니다. mount /srv/lf-data22는 fstab에서 해당 경로를 찾아 연결합니다. 이 단계에서는 다른 모든 항목을 함께 적용하는 대신 이번 경로부터 확인합니다.

systemd는 fstab을 부팅 초기와 관리자 설정 재읽기 시 마운트 유닛으로 변환합니다. 생성 결과를 볼 때는 경로를 직접 유닛 이름으로 추측하지 않고 변환 명령을 사용합니다.

mount_unit=$(systemd-escape --path --suffix=mount /srv/lf-data22)
systemctl cat "$mount_unit"
systemctl is-active "$mount_unit"

생성 파일에는 원본이 /etc/fstab임을 나타내는 SourcePath, UUID 장치 경로인 What, 마운트 지점인 Where 등이 보입니다. 하이픈처럼 이스케이프되는 문자가 있어 단순히 슬래시를 바꾸는 것만으로 유닛 이름을 만들면 틀릴 수 있습니다. systemd-fstab-generator 설명처럼 생성된 /run 아래 파일을 직접 편집하기보다 원본 설정을 관리합니다.

이 실습에서는 nofail 마운트가 local-fs.target의 wants 연결로 생성되는 것도 확인했습니다. 유닛이 읽는 Options에는 defaults,nofail이 보이지만 장치 대기 제한은 별도 의존성에 반영될 수 있으므로 Options 한 줄에 모든 원문 옵션이 그대로 있어야 한다고 가정하지 마세요.

재부팅 후 자동 마운트 확인

현재 마운트와 데이터를 확인한 뒤 콘솔을 확보한 상태에서 정상 재부팅합니다.

sudo systemctl reboot

부팅 완료 후 새 SSH 연결에서 확인합니다. 이전 셸의 변수는 새 세션에 남지 않으므로 필요한 값은 다시 조회합니다.

findmnt --mountpoint /srv/lf-data22
findmnt -n -o UUID --mountpoint /srv/lf-data22
cat /srv/lf-data22/work/probe.txt
mount_unit=$(systemd-escape --path --suffix=mount /srv/lf-data22)
systemctl is-active "$mount_unit"
sudo journalctl -b -u "$mount_unit" --no-pager
systemctl --failed --no-pager

수동 mount 명령을 다시 실행하기 전에 이미 연결되어 있는지 확인해야 자동 마운트를 검증할 수 있습니다. 이 VM에서는 새 부팅에서 동일 UUID·기존 파일·활성 마운트를 확인했습니다. SSH의 초기 연결 실패만으로 fstab 오류를 확정하지 말고 콘솔의 부팅 상태와 장치 준비도 함께 살펴보세요.

선택 디스크 누락과 서비스의 필수 마운트 조건

nofail은 systemd가 해당 마운트를 부팅의 필수 조건으로 요구하지 않고, 마운트 완료를 기다리지 않은 채 부팅을 계속할 수 있게 합니다. x-systemd.device-timeout=5s는 그 장치가 나타나기를 기다리는 제한이며, 전체 부팅 시간이나 모든 마운트 작업을 5초로 제한하는 옵션은 아닙니다. 5초는 이 로컬 실습의 값이며 준비가 느린 실제 저장장치에는 적합한 값을 따로 검토합니다. 의미와 적용 위치는 systemd.mount의 fstab 옵션을 참고하세요.

이 비교를 직접 하려면 시스템 디스크와 구분한 선택 데이터 VDI 연결만 사용해야 합니다. 마운트 중에 강제로 분리하지 않고 다음 순서로 진행합니다.

  1. VM을 정상 종료하고 전원 꺼짐을 확인합니다.
  2. VirtualBox 저장소에서 추가한 데이터 VDI 연결만 제거합니다. 파일 자체는 삭제하지 않습니다.
  3. 부팅하여 SSH·콘솔 접근과 데이터 마운트의 부재를 확인합니다.
  4. VM을 다시 정상 종료한 뒤 같은 VDI를 재연결하고 부팅합니다.
  5. 동일 UUID의 자동 마운트와 기존 파일을 다시 확인합니다.

누락 상태에서는 아래 두 명령의 의미가 다릅니다.

findmnt --mountpoint /srv/lf-data22
findmnt --target /srv/lf-data22

첫 명령은 그 경로 자체의 마운트를 찾지 못합니다. 두 번째는 그 디렉터리를 포함하는 파일 시스템을 보여 주므로, 실습에서는 루트 /dev/sda2가 나타났습니다. 디렉터리가 존재한다는 사실만으로 데이터 디스크가 연결된 것으로 판단하면 안 됩니다.

실제 비교에서는 데이터 VDI가 없어도 multi-user 대상과 SSH는 활성 상태였지만 마운트 작업에는 dependency 실패가 기록되었습니다. 다시 연결해 부팅하자 동일 파일 시스템과 파일을 읽을 수 있었습니다. nofail은 데이터 손실·장치 오류를 해결하거나 그 데이터를 사용하는 서비스의 정상 실행을 보장하는 옵션이 아닙니다. 루트·EFI·필수 데이터에 일괄 추가하지 마세요.

데이터 디스크가 필수인 서비스는 서비스별 drop-in의 [Unit] 구역에 다음과 같은 의존성을 검토합니다. 실제 서비스의 경로로 지정하고 drop-in 검사·재읽기·재시작 절차로 적용합니다.

[Unit]
RequiresMountsFor=/srv/lf-data22

RequiresMountsFor는 경로에 필요한 마운트에 요구·실행 순서 의존성을 추가합니다. 실습의 전용 시험 서비스는 누락 상태에서 의존성 때문에 시작 작업이 거부되어 실행 표식을 만들지 않았고, 재연결 후에는 실행됐습니다. 작업 의존성 실패와 프로그램 자체의 종료 결과는 다를 수 있으므로 journal의 dependency 기록과 실제 작업 결과까지 확인합니다. 이미 실행 중인 서비스의 모든 장애 처리 정책까지 이 옵션 하나로 대체하지는 않습니다.

이번 항목을 되돌리고 데이터 보존

실습을 마치면 관련 서비스가 경로를 사용하지 않는지 확인하고 현재 디렉터리를 밖으로 옮깁니다. 서비스에 이번 비교용 의존성을 추가했다면 해당 보완 설정만 원복하고 유닛을 다시 읽어 적용 상태도 확인합니다. 누락 비교를 했다면 데이터 VDI를 재연결하여 정상 마운트·데이터 확인까지 마친 후 정리합니다.

cd /
sudo umount /srv/lf-data22
sudo cmp /etc/fstab /var/backups/lf-debian13-22/fstab-candidate &&
sudo cp -a /var/backups/lf-debian13-22/fstab-before /etc/fstab
sudo systemctl daemon-reload
sudo findmnt --verify --verbose
sudo rmdir -- /srv/lf-data22
lsblk -o NAME,FSTYPE,LABEL,UUID,MOUNTPOINTS

이 복원은 현재 fstab이 이번 후보와 그대로 같다는 조건입니다. 다른 편집이 있으면 백업 전체를 덮지 말고 최신 파일에서 이번 데이터 항목만 제거하고 재검사합니다. rmdir가 비어 있지 않다고 나오면 마운트 누락 중 루트 디스크 쪽에 파일을 쓴 것은 아닌지 확인하고 재귀 삭제하지 않습니다.

정리 뒤에는 새 데이터 파티션의 ext4·UUID와 기존 파일이 디스크에 남고 자동 마운트 등록만 제거됩니다. 이 실습은 원래 fstab과 바이트가 같은 상태로 복원하고 데이터 파일 시스템은 연결된 채 미마운트 상태로 보존했습니다.