문제가 발생한 서버 업데이트 후 Plex를 안전하게 롤백하는 방법

다운그레이드하기 전에 Plex 데이터 디렉터리를 백업한 다음, 최신 릴리스에서 데이터베이스 호환성이 변경되었는지 확인한 후에만 한 번에 한 버전씩 롤백하세요.

Plex 롤백은 바이너리나 Docker 이미지만 교체하는 작업이 아닙니다. 업데이트로 서버 데이터베이스가 마이그레이션될 수 있으며, 이전 서버는 최신 서버가 기록한 상태를 이해하지 못할 수 있습니다. 먼저 현재 데이터를 보존하고, 마지막으로 정상 작동한 빌드를 확인한 뒤, 롤백을 되돌릴 수 있는 상태로 유지하세요. 목표는 업데이트가 문제를 일으켰다는 사실을 입증하는 것이지, 소프트웨어 문제를 데이터베이스 복구 문제로 바꾸는 것이 아닙니다.

서버 버전을 변경하기 전에 현재 상태를 고정하세요

Plex를 정상적으로 중지하고 영구 서버 데이터 디렉터리를 복사하세요. 현재 서버 버전과 롤백하려는 정확한 증상을 기록하세요. Docker를 사용한다면 현재 이미지 태그 또는 다이제스트와 마지막으로 정상 작동한 태그도 기록하세요. 이렇게 해야 롤백이 “최신 버전 대 캐시된 어떤 버전”이 아니라 명확한 버전 전환이 됩니다.

최근 Plex 포럼의 복구 사례에서는 서버의 Updates 디렉터리에 이전 설치 프로그램이 있을 수 있다고 설명하며, 이전 서버 버전으로 롤백하는 방법을 안내합니다. 다만 이는 특정 버전에 해당하는 운영 참고 자료로만 활용하고, 모든 플랫폼이 동일한 방식으로 패키지를 저장한다고 보장하는 내용으로 받아들이지는 마세요.

롤백의 첫 단계로 현재 데이터베이스나 환경 설정을 삭제하지 마세요. 이전 빌드가 실패하면 롤백 전 상태로 돌아가기 위해 변경되지 않은 백업이 필요합니다. 안전한 롤백은 이전 빌드로 돌아가는 경로와 현재 빌드로 다시 복귀하는 경로를 모두 보존해야 합니다.

다운그레이드 전에 데이터베이스 마이그레이션 경계를 확인하세요

설치한 버전의 릴리스 노트나 알려진 회귀 문제에 대한 논의를 확인하세요. 일부 Plex 릴리스에서는 데이터베이스 호환성이 변경되었으므로, 이전 실행 파일 자체는 정상적으로 설치되더라도 너무 오래된 버전으로 바로 되돌리면 실패할 수 있습니다. 마이그레이션 경계가 있는 경우에는 지원되는 중간 경로를 따르거나 호환되는 데이터베이스 백업을 복원하세요. 최신 상태에 이전 서버를 강제로 연결하지 마세요.

1.40 마이그레이션과 관련된 Plex 커뮤니티 안내에서는 데이터베이스 호환성이 롤백 경로를 제한한 구체적인 사례를 설명합니다. 해당 사례의 정확한 버전 번호는 과거의 내용이지만, 릴리스를 다운그레이드하기 전에 해당 릴리스의 마이그레이션 경계를 확인해야 한다는 원칙은 지금도 유효합니다.

Plex가 현재 데이터베이스 마이그레이션을 수행 중이라면 롤백을 서두르기 위해 중단하지 마세요. 마이그레이션이 완료될 때까지 기다리거나 호환성이 확인된 백업을 복원하세요. 스키마 작업을 중단하면 또 다른 장애 상태가 발생하여, 원래 문제가 릴리스 자체에서 비롯되었는지 확인하기가 더 어려워집니다.

다른 변수는 변경하지 않고 이전 빌드를 설치하거나 고정하세요

Plex 서버 버전만 변경하세요. 동일한 앱 데이터 마운트, 미디어 경로, 네트워크 모드, 하드웨어 장치, 클라이언트 설정을 유지하세요. Docker에서는 변동 태그에 의존하지 말고 이전 이미지 태그를 고정하세요. 패키지 기반 설치에서는 해당 플랫폼에 적합하고 신뢰할 수 있는 출처의 이전 설치 프로그램을 사용하세요.

ZimaSpace 홈 서버 복구 체크리스트도 읽을 수 있는 상태를 보존하고, 문제가 발생한 계층을 확인하며, 처음부터 잘못된 구성 요소를 교체하거나 다시 구축하지 않는 동일한 복구 원칙을 따릅니다. Plex 롤백도 이처럼 범위를 좁혀 진행해야 합니다.

Plex를 시작한 뒤 재생을 테스트하기 전에 데이터베이스 오류가 있는지 로그를 확인하세요. 이전 빌드가 데이터베이스를 거부하거나 새 서버로 시작되면 즉시 중지하고 보호해 둔 상태를 복원하세요. 일치하지 않는 데이터 디렉터리에 새 파일을 기록하도록 방치해서는 안 됩니다.

-15% OFF

ZimaBoard 2 - 당신의 큰 아이디어를 위한 미니 홈 서버

Single board computer zimaboard2

$339.00 - $519.00

Buy Now

롤백 상태를 유지할지 결정하기 전에 원래 회귀 문제를 재현하세요

이전 빌드가 정상적으로 시작되면 업데이트 후 실패했던 정확한 조건을 재현하세요. 동일한 클라이언트, 미디어, 네트워크 경로, 라이브러리 작업 또는 예약된 작업을 사용해야 합니다. 이전 버전이 원래 문제를 일으킨 동작을 통과하고 서버의 나머지 기능도 정상적으로 유지될 때에만 롤백으로 해당 릴리스가 문제에 관여했다고 입증할 수 있습니다.

Plex를 한 번 재시작한 뒤 해당 동작을 다시 수행하여 정상적인 수명 주기 이벤트 이후에도 복구 상태가 유지되는지 확인하세요. 그런 다음 라이브러리 접근, 시청 기록, 사용하는 경우 원격 접속, 업데이트의 영향을 받을 수 있는 하드웨어 트랜스코딩 경로를 확인하세요. 홈 화면만 보고 성공했다고 판단하지 마세요.

이전 빌드에서도 문제가 발생한다면 보호해 둔 현재 상태로 돌아간 뒤 추가로 다운그레이드를 반복하지 말고 계속 원인을 진단하세요. 이전 빌드에서 문제가 해결된다면 롤백 상태를 임시로 유지하고 정상 작동하는 버전을 기록하세요. 그런 다음 회귀 문제를 해결한 이후 Plex 릴리스가 나올 때까지 기다렸다가 다시 업그레이드하세요.