Migrer depuis d'autres applications

Reprenez la configuration de vos anciennes applications dans HolyArrs sans tout ressaisir.

HolyArrs ne fait que lire les anciennes applications. Rien n’y change, et vos fichiers multimédias ne bougent jamais.

Avant de commencer

• Connectez-vous en tant que propriétaire ou administrateur.
• Gardez sous la main l’adresse et la clé API de chaque ancienne application.
• Vérifiez que HolyArrs voit vos dossiers multimédias. Voir Dossiers et hardlinks.

Migrer votre configuration

1. Ouvrez Settings > Move from other apps (Paramètres > Migrer depuis d’autres applications). Vous devriez voir cinq étapes alignées en haut.
2. Read (Lire) : appuyez sur Add an app (Ajouter une application) pour chaque ancienne application. Vous devriez voir chaque application dans la liste, avec un interrupteur.
3. Choose (Choisir) : activez les groupes que vous voulez reprendre.
4. Try it (Tester) : vérifiez ce qui sera ajouté. Rien ne change encore.
5. Move (Migrer) : appuyez sur Move et confirmez. Vous pouvez quitter la page pendant la migration.
6. Done (Terminé) : vous devriez voir les résultats par groupe et Undo this move (Annuler cette migration).

Les clés et les mots de passe ne sont jamais repris. Voir Après la migration.

Dans quel ordre procéder

Ordre	Application	Pourquoi cet ordre
1	Radarr, Sonarr	Les dossiers de bibliothèque et les titres passent en premier. Voir Sonarr et Radarr.
2	Lidarr, Prowlarr, Bazarr	Musique, sources et langues de sous-titres. Voir Lidarr, Bazarr et Prowlarr.
3	qBittorrent, SABnzbd	Clients de téléchargement. Lisez-les dans la même migration que les applications ci-dessus.
4	Seerr, Overseerr	Personnes et demandes, associées aux titres déjà présents ici. Voir Applications de demandes.

Vous pouvez lire toutes les applications et tout migrer en une fois. L’ordre ne compte que si vous migrez par lots.

Après la migration

Chaque élément ci-dessous arrive en pause ou désactivé. Saisissez son secret, vérifiez-le, puis activez-le.

Élément	Où	Quoi faire
Sources	Settings > Sources	Saisissez la clé, puis reprenez.
Clients de téléchargement	Settings > Downloaders (Paramètres > Clients de téléchargement)	Saisissez le mot de passe ou la clé, puis reprenez.
Alertes	Settings > Alerts (Paramètres > Alertes)	Saisissez le lien ou le mot de passe de messagerie, puis activez.
Listes externes	Settings > Outside lists (Paramètres > Listes externes)	Vérifiez le dossier et les règles de sélection, puis activez. Une liste Trakt a d’abord besoin de votre clé Trakt.
Personnes	Settings > Users and roles (Paramètres > Utilisateurs et rôles)	Envoyez les invitations.

Une source, un client de téléchargement ou une alerte qui avait des étiquettes dans l’ancienne application sert maintenant tous les titres de son type. Vérifiez-le avant de l’activer.

Les sources et les clients de téléchargement arrivent avec May reach the local network (Peut accéder au réseau local) désactivé. Ne l’activez que pour un élément situé sur votre réseau domestique. Les adresses link-local et les adresses de métadonnées cloud restent bloquées dans tous les cas.

Pour saisir beaucoup de clés d’un coup, voir Importer les clés depuis un fichier.

Ce qui n’est pas repris

• Les fichiers multimédias. La migration ne déplace, ne renomme, ne copie et ne supprime jamais un fichier.
• Les clés, mots de passe, jetons et cookies. L’étape Move et le rapport les listent tous sous Keys to type again (Clés à saisir de nouveau).
• Les paramètres sans équivalent ici. Chacun figure dans la liste not moved (non migré) avec sa raison.
• L’historique. L’historique des anciennes applications n’est pas lu. La personne qui a demandé un titre, elle, est bien reprise.

Si ça ne fonctionne pas

Symptôme	Cause	Solution
Des titres apparaissent comme introuvables	Leur dossier ne correspond à aucun dossier de bibliothèque ici.	Ajoutez une règle de chemin sous Advanced (Avancé) dans Choose, puis migrez de nouveau.
Move indique que le plan a changé	Quelque chose a changé depuis le test.	Relancez Try it, puis migrez.
Le bouton de migration est grisé	Une personne attend un choix, ou HolyArrs est en mode sans échec.	Lisez le texte à côté du bouton.
Certains éléments ont échoué	Par exemple, le serveur de métadonnées était hors ligne.	Attendez, puis migrez de nouveau. Les clés de vos anciennes applications sont conservées.

Pour les experts

Migrer de nouveau, annuler, modules et mode sans échec

Migrer de nouveau. Une migration retient ce qu’elle a ajouté. Une nouvelle migration n’ajoute que ce qui est nouveau et indique already here (déjà présent) pour le reste. Une seule migration ou annulation s’exécute à la fois. Si HolyArrs s’arrête en pleine migration, celle-ci est marquée en échec au démarrage suivant, ou reprend si sa tâche est toujours en file d’attente. Elle ne bloque jamais la migration suivante.

Earlier moves (Migrations précédentes), sous les lectures, liste chaque migration et son état. Open (Ouvrir) affiche une migration à l’étape 5, ou à l’étape 4 tant qu’elle est en cours.

Annuler. Appuyez sur Undo this move à l’étape 5 (pour une migration plus ancienne, faites d’abord Open). L’annulation s’exécute en arrière-plan et ne supprime que ce que cette migration a ajouté, du plus récent au plus ancien :

• les titres quittent la Bibliothèque ; leurs fichiers restent où ils sont,
• les sources, clients de téléchargement, alertes, sites de sous-titres, personnes, demandes et entrées « à ne jamais ajouter » qu’elle a ajoutés sont supprimés,
• les listes externes qu’elle a ajoutées sont supprimées si elles sont encore en pause,
• le nommage, les langues de sous-titres par défaut et les délais des règles de sélection reviennent à ce qu’ils étaient.

Ce que vous avez configuré ou modifié après la migration reste, et le rapport d’annulation le liste : un secret que vous avez saisi, une personne ou une liste externe que vous avez activée, un nommage, des langues ou des délais que vous avez modifiés. Les dossiers de bibliothèque qui contenaient des titres restent, car les titres supprimés gardent leur historique.

Modules. Un module désactivé est laissé de côté. Films désactivés : aucun dossier de films, aucun film, aucune liste externe. Sous-titres désactivés : aucun paramètre de sous-titres. Demandes désactivées : aucune demande.

Mode sans échec. Vous pouvez lire, choisir et tester, mais pas migrer ni annuler.

API

Les clés API ont besoin de la portée admin.

Route	Ce que ça fait
POST /api/v1/migrate/plan	Le plan pour les lectures choisies, avec les décomptes et les règles de chemin suggérées.
POST /api/v1/migrate/dry-run	Le rapport de test et son plan_hash. Rien ne change. Une personne qui attend un choix a choose réglé sur same_name, numeric_id ou merge_gone.
POST /api/v1/migrate/moves	Démarre une migration. Nécessite le plan_hash du test. Répond 409 quand le plan a changé.
GET /api/v1/migrate/moves	Liste les migrations, de la plus récente à la plus ancienne.
GET /api/v1/migrate/moves/{id}	Une migration, son rapport et sa progression.
GET /api/v1/migrate/moves/{id}/report	Le rapport sous forme de fichier Markdown.
POST /api/v1/migrate/moves/{id}/undo	Met l’annulation en file d’attente (202). Suivez-la avec GET /api/v1/migrate/moves/{id}.

Corps de plan, dry-run et moves (moves prend aussi "plan_hash") :

{
  "snapshots": [1, 2],
  "path_rules": [{"from": "/data/media/movies", "to": "/movies"}],
  "skip": ["alerts"],
  "people": {"person:seerr:1": "owner", "person:seerr:3": "admin", "person:seerr:2": "merge"}
}

Le choix pour une personne est owner (uniquement le propriétaire de l’ancienne application), admin, merge ou skip. Groupes que vous pouvez ignorer : folders, pick_rules, titles, never_add, outside_lists, sources, downloaders, naming, subtitles, people, wishlist, alerts.

Pages de cette section

Page	À utiliser pour
Sonarr et Radarr	Reprendre les dossiers, les séries, les films et leurs règles. À faire en premier.
Lidarr, Bazarr et Prowlarr	Reprendre la musique, les langues de sous-titres et les sources.
Seerr et Overseerr	Reprendre les personnes et les demandes en cours.
Lire vos anciennes applications	Voir exactement ce que HolyArrs lit et conserve.
Importer les clés depuis un fichier	Saisir beaucoup de clés d’un coup.

Voir aussi

• Premier lancement
• Glossaire