以前のアプリを読み取る

上級者

移行のステップ 1 として、以前のアプリの設定を、アプリ経由またはバックアップから読み取ります。読み取りでは、HolyArrs 側も以前のアプリ側も何も変わりません。

読み取りとは、1 つのアプリの設定を 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 の設定フォルダー
データベースファイルまたは設定ファイル 1 つ

バックアップからの読み取りでは、キーは保存されません。

読み取られるもの

アプリ	読み取られるもの
Radarr、Sonarr、Lidarr	すべての映画、番組(シーズンを含む)、アーティストについて、ID、フォルダー、監視フラグ、品質プロファイル、タグ、追加日。加えて、ライブラリフォルダー、タグ、品質プロファイル、カスタムフォーマット、リリースの単語ルール、待機ルール、命名、インデクサー、ダウンロードクライアント、リスト、通知、メタデータの書き出し、除外リスト、言語プロファイル(Sonarr v3)、メタデータプロファイル(Lidarr)、Radarr の利用可能になるまでの遅延。
Prowlarr	インデクサー、アプリ連携、同期プロファイル、インデクサープロキシ、ダウンロードクライアント、通知。
Bazarr	有効な言語、言語プロファイル、有効な字幕サイト、既定のプロファイル。
qBittorrent、SABnzbd	アドレス、ポート、ユーザー名、ダウンロードフォルダー、カテゴリ、(SABnzbd の場合)Usenet サーバー。
Seerr、Overseerr	ユーザー(名前、メールアドレス、ロール、権限、リクエスト上限)、既定の上限、承認待ちまたは承認済みのすべてのリクエスト(だれが、いつ、何をリクエストしたか)。完了済みと却下されたリクエストは件数だけ数えます。アバターは読み取りません。

移行するものより多く読み取るのは意図したものです。読み取ったのに移行されなかったものは、すべて理由付きで not moved(移行されなかったもの)の一覧に表示されます。

キーとパスワード

読み取りがキー、パスワード、トークン、Cookie を保持することはありません。バックアップに平文で入っている場合でも同じです。それぞれ 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 つあたりのサイズ	最大 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}`	1 つの読み取りと、その中身すべて。
`DELETE /api/v1/migrate/snapshots/{id}`	読み取りと、そのアプリ用に保存されたキーを削除します。
`GET /api/v1/migrate/saved-keys`	保存済みのキーがあるアプリとそのアドレス。キーそのものは返しません。オーナー専用です。
`DELETE /api/v1/migrate/saved-keys`	保存済みのキーをすべて削除します。`?kind=` を付けると 1 つだけ削除します。オーナー専用です。

probe と read のボディでは、アプリを radarr、sonarr、lidarr、prowlarr、bazarr、seerr、overseerr、qbittorrent、sabnzbd のいずれかで指定します。url と key(または username と password)、もしくは path を追加します。自宅のネットワークに接続するには allow_local_network を、保存済みのキーを使うには use_saved_key を追加します。