데이터베이스 볼륨이 가득 찬 후 Jellyfin을 복구하는 방법

에바 왕

IceWhale author

에바 왕 는 기술 작가 그리고 이자 ZimaSpace의 상주 장인입니다. 평생을 기술에 열정을 가진 사람으로서 홈랩과 오픈소스 소프트웨어에 열정을 가지고 있으며,복잡한 기술 개념을 쉽게 이해할 수 있는 실습 가이드로 번역하는 데 전문성을 가지고 있습니다.에바는 셀프 호스팅이 어렵지 않고 재미있어야 한다고 믿습니다. 그녀의 튜토리얼을 통해 커뮤니티가 하드웨어 설정의 신비를 풀도록돕고 있습니다. 첫 NAS 구축부터 Docker 컨테이너 마스터링까지.

How to Repair Jellyfin After Its Database Volume Fills Up - Zima Store Online

Jellyfin의 데이터베이스 볼륨이 가득 찬 후에는 새 쓰기를 중지하고, 데이터베이스와 WAL 파일을 보존하며, 안전하게 공간을 확보한 다음, 일반 작업을 재개하기 전에 데이터베이스를 검증하세요.

볼륨의 여유 공간이 0에 도달한 후 Jellyfin이 시작되지 않거나 SQLite 오류를 보고하거나 사용자가 사라진 상태로 열리나요? 데이터베이스 파일을 즉시 삭제하거나 정리 작업을 실행하지 마세요. 먼저 볼륨, 여유 바이트, 데이터베이스 파일 이름, 컨테이너 상태, 마지막으로 정상 작동이 확인된 백업을 기록하세요.

장애가 쓰기 폭주로 이어지지 않도록 중지하기

Jellyfin과 동일한 볼륨에 쓰기 작업을 수행하는 모든 가져오기 도구, 스캐너 또는 사이드카를 중지하세요. inode를 포함하여 어떤 마운트가 가득 찼는지 확인하고, 기본 데이터베이스와 모든 `-wal` 또는 `-shm` 파일을 보존하세요. 디스크가 가득 차면 구성 파일이 비어 있거나 일부만 기록될 수 있습니다. 버전별 장애 사례를 보면 공간만 확보하는 것으로는 시작 문제가 해결되지 않을 수 있습니다(볼륨 전체 사용 복구 사례).

영구 상태를 복사한 후에만 폐기 가능한 로그, 완료된 트랜스코딩 파일 또는 재생성 가능한 것으로 확인된 캐시에서 공간을 확보하세요. 첫 단계로 데이터베이스를 삭제하지 마세요.

정리하기 전에 데이터베이스 크기, WAL 파일, 로그, 캐시 및 남은 여유 공간을 기록하세요. 이를 통해 볼륨이 데이터베이스 증가, 트랜스코딩 출력, 로그 또는 다른 컨테이너 때문에 가득 찼는지 파악할 수 있습니다.

복구를 시도하기 전에 데이터베이스 무결성 확인하기

Jellyfin을 중지한 상태에서 데이터베이스 사본을 대상으로 작업하세요. 환경에서 사용할 수 있는 SQLite 도구로 무결성 검사를 실행하고, 로그에서 “디스크 가득 참”, 손상된 이미지 또는 열 수 없음 오류를 확인하세요. 검사가 통과하면 공간을 확보하고 한 번 다시 시작한 뒤 사용자, 라이브러리 및 재생 기능을 확인하세요.

데이터베이스가 손상된 경우 마지막으로 정상 작동이 확인된 백업을 먼저 복원하세요. 통제된 복구 절차에서는 사본에 SQLite 복구 도구를 사용할 수 있지만, 이는 검증된 백업을 대체하지 않으며 실행 중인 데이터베이스를 대상으로 수행해서는 안 됩니다(사본 기반 복구 절차).

재생성 가능한 데이터만 삭제해 공간을 확보한 후에는 데이터베이스 파일이 함께 존재하며 읽을 수 있는지 확인하세요. 이 확인 전에 다시 시작하면 불완전한 쓰기가 두 번째 장애로 이어질 수 있습니다.