기존 앱 읽기

전문가

옮기기의 1단계로, 기존 앱의 설정을 앱을 통해서나 백업에서 읽습니다. 읽기는 HolyArrs에서도 기존 앱에서도 아무것도 바꾸지 않습니다.

읽기 결과는 앱 하나의 설정을 HolyArrs가 복사해 둔 것입니다. 옮기거나 제거할 때까지 보관됩니다.

앱 읽기

Settings > Move from other apps(설정 > 다른 앱에서 옮기기)를 열고 Add an app(앱 추가)을 누르세요.
앱을 고른 다음 Through the app(앱을 통해)이나 From a backup(백업에서)을 고르세요.
Check connection(연결 확인)을 누르세요. 몇 초 안에 앱과 버전이 표시됩니다.
읽기를 시작하세요. 라이브러리가 크면 몇 분 걸립니다. Stop reading(읽기 중지)을 누르면 멈춥니다. 시트를 닫는 것으로는 멈추지 않습니다.
읽기 결과가 목록에 표시됩니다. 다음 앱도 같은 방법으로 추가하세요.

행의 Edit(편집)를 누르면 그 앱을 다시 읽습니다. Remove(제거)를 누르면 읽기 결과를 버립니다.

선택 사항

앱을 통해

앱의 주소와 API 키를 입력하세요. qBittorrent는 사용자 이름과 비밀번호를 입력하세요. 5.2 이상 버전이면 API 키를 써도 됩니다.

기존 앱은 보통 홈 네트워크에 있으므로 읽을 때 로컬 네트워크 스위치를 켜세요. 클라우드 메타데이터 주소는 계속 차단되며, 앱이 HolyArrs를 다른 주소로 리디렉션할 수 없습니다.

백업에서

HolyArrs 서버에 있는 다음 중 하나의 전체 경로를 입력하세요.

Radarr, Sonarr, Lidarr, Prowlarr, Bazarr의 백업 zip
Seerr, Overseerr, qBittorrent, SABnzbd의 설정 폴더
데이터베이스 파일이나 설정 파일 하나

백업에서 읽을 때는 키가 저장되지 않습니다.

읽는 내용

앱	읽는 내용
Radarr, Sonarr, Lidarr	모든 영화, 시리즈(시즌 포함), 아티스트: ID, 폴더, 모니터링 여부, 품질 프로필, 태그, 추가한 날짜. 그리고 라이브러리 폴더, 태그, 품질 프로필, 사용자 지정 형식, 릴리스 단어 규칙, 대기 규칙, 이름 규칙, 인덱서, 다운로드 클라이언트, 목록, 알림, 메타데이터 작성기, 제외 목록, 언어 프로필(Sonarr v3), 메타데이터 프로필(Lidarr), Radarr의 출시 지연.
Prowlarr	인덱서, 앱 연동, 동기화 프로필, 인덱서 프록시, 다운로드 클라이언트, 알림.
Bazarr	켜져 있는 언어, 언어 프로필, 켜져 있는 자막 사이트, 기본 프로필.
qBittorrent, SABnzbd	주소, 포트, 사용자 이름, 다운로드 폴더, 카테고리, 그리고 (SABnzbd) 유즈넷 서버.
Seerr, Overseerr	사람(이름, 이메일, 역할, 권한, 요청 한도), 기본 한도, 대기 중이거나 승인된 모든 요청: 누가, 언제, 무엇을 요청했는지. 완료되었거나 거절된 요청은 개수만 셉니다. 아바타는 읽지 않습니다.

옮기는 것보다 더 많이 읽는 것은 의도된 동작입니다. 읽었지만 옮기지 않은 것은 모두 이유와 함께 not moved(옮기지 않음) 목록에 표시됩니다.

키와 비밀번호

읽기 결과에는 키, 비밀번호, 토큰, 쿠키가 들어가지 않습니다. 백업에 평문으로 들어 있어도 마찬가지입니다. 각각 needs re-entry(다시 입력 필요) 아래에 나열됩니다. 예: indexer "Nyaa": apiKey.

링크도 비밀 값으로 취급합니다. 토큰이 링크 안에 숨어 있기 때문입니다. 알림 링크, RSS 피드 주소, 자유 입력 추가 매개변수는 가져오지 않고 목록에 나열합니다. 인덱서 주소는 호스트와 API 경로만 남깁니다.

입력한 키

소유자가 키를 입력해서 앱을 읽으면 HolyArrs는 그 주소와 키를 암호화된 저장소에 보관합니다. 다음부터는 Edit가 Use the saved key(저장된 키 사용)를 켠 채로 다시 읽으며, 키는 저장된 주소로만 전송됩니다. HolyArrs는 키를 절대 보여 주지 않습니다.

저장된 키가 삭제되는 때
그 앱의 읽기 결과를 제거할 때
옮기기 작업이 실패 없이 끝날 때(실패한 항목이 있으면 다시 옮길 수 있게 키를 보관합니다)
`holyarrs import-secrets -forget-move-credentials`를 실행할 때

읽을 수 있는 사람

비밀번호로 로그인한 소유자와 관리자입니다. 로컬 네트워크 로그인 건너뛰기는 인정되지 않습니다. API 키에는 admin 범위가 필요합니다.

문제가 생기면

증상	원인	해결
Check connection이 실패함	주소는 HolyArrs 서버에서 테스트됩니다.	서버에서 접근할 수 있는 주소를 쓰세요. 홈 네트워크에 있는 앱이면 로컬 네트워크 스위치를 켜세요.
키가 틀림	복사하다 실수했거나, qBittorrent가 사용자 이름을 요구합니다.	기존 앱의 설정에서 키를 다시 복사하세요.
백업이 거부됨	zip이 변경되었거나 경로가 컨테이너 밖에 있습니다.	앱이 직접 만든 백업 zip을 변경 없이, HolyArrs 컨테이너 안의 경로로 쓰세요.
읽기 결과가 너무 큼	읽기 하나당, 서버당 한도가 있습니다.	더 이상 필요 없는 오래된 읽기 결과를 제거하세요.

고급 사용자용

백업 처리와 한도

규칙	값
복사되는 파일	필요한 파일만 비공개 임시 폴더에 복사하고, 읽은 뒤 삭제합니다.
복사되는 파일 하나의 크기	최대 1 GB.
arr 앱의 `config.xml`	절대 복사하지 않습니다. API 키가 들어 있습니다.
데이터베이스	읽기 전용으로 엽니다.
전체가 거부되는 때	항목이 zip 밖을 가리키거나, 링크가 들어 있거나, 파일이 풀렸을 때 원래 크기보다 훨씬 커지는 경우.
동시에 읽는 백업	1.
읽기 하나당 보관	16 MB.
보관되는 읽기 결과	최신 50개.

API

경로	하는 일
`POST /api/v1/migrate/probe`	어떤 앱과 버전이 응답하는지, 또는 어떤 백업인지 알려 줍니다.
`POST /api/v1/migrate/read`	설정 전체를 읽고 보관합니다.
`GET /api/v1/migrate/snapshots`	읽기 결과를 최신순으로 나열합니다.
`GET /api/v1/migrate/snapshots/{id}`	읽기 결과 하나와 거기에 든 모든 내용입니다.
`DELETE /api/v1/migrate/snapshots/{id}`	읽기 결과와 그 앱에 저장된 키를 제거합니다.
`GET /api/v1/migrate/saved-keys`	저장된 키가 있는 앱과 그 주소입니다. 키는 나오지 않습니다. 소유자만 쓸 수 있습니다.
`DELETE /api/v1/migrate/saved-keys`	저장된 키를 모두 삭제하거나, `?kind=`로 하나만 삭제합니다. 소유자만 쓸 수 있습니다.

probe와 read의 본문에는 앱 이름을 넣습니다: radarr, sonarr, lidarr, prowlarr, bazarr, seerr, overseerr, qbittorrent, sabnzbd. url과 key(또는 username과 password)를 넣거나 path를 넣으세요. 홈 네트워크에 접근하려면 allow_local_network를, 저장된 키를 쓰려면 use_saved_key를 추가하세요.