Restaurer sur un partage réseau

Ce que fait la fonction

L'assistant Restaurer des fichiers écrit sur un partage réseau déclaré sur la machine cible. C'est un choix de l'étape Destination, pas une restauration à part. Voir Restaurer des fichiers depuis le portail.

Quand votre sélection contient des chemins de partage (/@shares/…), l'étape Destination propose trois emplacements.

Emplacement	Où arrivent les fichiers
Partage d'origine	Chaque fichier revient à sa place dans le partage, sur la machine source.
Dossier d'un partage	Les fichiers vont sous un dossier d'un partage de la machine cible.
Disque local	Les fichiers vont sous un dossier de la machine cible.

C'est l'agent de la machine cible qui écrit sur le NAS. Il se connecte au partage en écriture seulement pendant la restauration, puis il se déconnecte.

Une restauration n'efface jamais un fichier du partage, et elle ne modifie jamais le point de restauration.

Prérequis

• Un point de restauration qui contient des chemins de partage. Voir Sauvegarder un partage réseau.
• Le rôle Technicien ou Administrateur. Voir Rôles et droits.
• L'agent de la machine cible en ligne, en version 0.5.0 ou plus récente. Voir Versions d'agent minimales par fonction.
• Un partage déclaré sur la machine cible, dont le protocole est lu par son système.
• La machine cible du même client que la machine source.
• Un compte de partage qui écrit sur le NAS. L'agent écrit avec les droits de ce compte.
• Sur une machine Linux : un noyau 5.10 ou plus récent.
• Sur une machine Windows : l'évaluation des liens distants désactivée. C'est la valeur par défaut de Windows.

Les deux dernières lignes protègent la machine locale : un lien posé sur le partage ne doit jamais conduire l'agent à écrire hors du partage. Sans elles, la restauration vers un partage est refusée avec le code share_restore_not_supported, et rien n'est écrit.

Restaurer sur le partage d'origine

Choisissez ce scénario quand le client a perdu des fichiers du NAS et veut les retrouver à leur place.

1. À l'étape Sélection, ouvrez le point de restauration, puis cochez les éléments du partage. L'arbre nomme la ligne du partage Partages réseau, puis chaque partage par son nom et son adresse.
2. Cliquez Suivant : destination.
3. Sous Machine cible, gardez Cette machine, suivi du nom de la machine.
4. Sous Emplacement, choisissez Partage d'origine.
5. Sous Si un fichier existe déjà, choisissez Ne pas le toucher, ou Le remplacer s'il a changé.
6. Cliquez Suivant : vérification.
7. Vérifiez le point de restauration, les éléments, la machine cible et l'emplacement.
8. Cliquez Lancer la restauration.

Chaque fichier revient à son chemin dans le partage qui porte le même nom court, sur la machine source.

Ce choix n'existe que sur la machine source. Sur une autre machine, le portail écrit « Le partage d'origine est disponible uniquement sur la machine source. » Le nom court d'un partage appartient à une seule machine : sur une autre machine, le même nom court peut désigner un autre partage.

Pour rendre un partage à sa place, sélectionnez les chemins du partage. La racine / du point de restauration ne rend jamais un partage à sa place : l'agent laisse ces chemins de côté.

Restaurer dans le dossier d'un partage

Choisissez ce scénario quand le client veut relire ses fichiers sur le NAS avant de les remettre en place, ou quand la machine source n'existe plus.

1. À l'étape Destination, choisissez la Machine cible : Cette machine, ou Une autre machine du MSP du même client.
2. Sous Emplacement, choisissez Dossier d'un partage.
3. Ouvrez la liste Partage cible, puis choisissez un partage. Chaque ligne donne le nom et l'adresse du partage.
4. Lisez le Dossier dans le partage. Le portail propose BaaStide-restore/<AAAAMMJJ-HHMMSS>.
5. Gardez ce dossier, ou saisissez un autre sous-dossier.
6. Lisez l'exemple que le portail écrit sous le champ. Il montre où arrive le premier élément de votre sélection.
7. Sous Si un fichier existe déjà, gardez Ne pas le toucher.
8. Cliquez Suivant : vérification, puis Lancer la restauration.

L'agent crée le dossier quand il n'existe pas.

Où arrivent les fichiers

Les fichiers vont sous le dossier choisi, avec leur chemin du point de restauration.

Emplacement	Dossier choisi	Chemin du point de restauration	Fichier écrit
Dossier d'un partage	/@shares/archives/BaaStide-restore/20261105-100000	/@shares/compta/Factures/f.pdf	/@shares/archives/BaaStide-restore/20261105-100000/@shares/compta/Factures/f.pdf
Disque local, machine Linux	/restore	/@shares/compta/Factures/f.pdf	/restore/@shares/compta/Factures/f.pdf
Disque local, machine Windows	D:\Restore	/@shares/compta/Factures/f.pdf	D:\Restore\@shares\compta\Factures\f.pdf

Le dossier de restauration reste sur le partage. Une politique qui sauvegarde ce partage le sauvegarde aussi. Retirez-le du partage quand le client a relu ses fichiers, ou ajoutez-le aux exclusions de la politique.

Restaurer un partage sur un disque local

Choisissez ce scénario quand le NAS n'est pas disponible, ou quand le client veut ses fichiers sur une machine.

1. À l'étape Destination, choisissez la machine cible.
2. Sous Emplacement, choisissez Disque local.
3. Vérifiez le Dossier cible proposé pour le système de la machine cible.
4. Cliquez Suivant : vérification, puis Lancer la restauration.

Ce scénario suit les règles d'une restauration de fichiers vers un dossier. Les chemins du partage arrivent sous un dossier @shares. Voir Restaurer des fichiers depuis le portail.

Un chemin de partage saisi dans le champ du dossier local est refusé. Le portail écrit « Utilisez le choix « Dossier d'un partage » pour une destination réseau. »

Si un fichier existe déjà

Choix	Ce que fait l'agent
Ne pas le toucher	Le fichier présent sur le partage reste tel quel.
Le remplacer s'il a changé	L'agent remplace un fichier dont la taille ou la date est différente de celle du point de restauration.

Un NAS garde souvent les dates avec moins de précision qu'un disque local. Avec Le remplacer s'il a changé, un fichier identique peut donc être réécrit sans raison. Le contenu reste juste.

Rien n'est jamais supprimé sur le partage. Un fichier qui n'est pas dans le point de restauration reste en place.

Droits et dates remis sur le partage

Cas	Remis	Non remis
Agent Windows, partage SMB	Le contenu, les dates et les attributs étendus. Les fichiers prennent les droits d'accès (ACL) héritées de leur dossier sur le NAS.	Le propriétaire, les droits d'accès, les attributs et la date de création du point de restauration.
Agent Linux, export NFS	Le contenu, les dates, le propriétaire, le groupe et le mode.	Les bits setuid et setgid, les ACL et les attributs étendus.
Agent Linux, partage SMB	Le contenu et les dates.	Le propriétaire, le groupe, le mode et les attributs étendus.

Sur un partage, les droits sont ceux du NAS. L'agent ne pose pas les droits du point de restauration : un droit inconnu du NAS bloquerait les utilisateurs du client.

Sur un export NFS avec root_squash, l'agent ne peut pas poser le propriétaire d'un fichier. Chaque fichier donne alors une erreur, et la restauration finit en Partielle. Donnez l'accès root à l'adresse de l'agent sur l'export.

Restaurer par l'API ou par un assistant IA

1. Appelez POST /endpoints/{id}/restores. L'identifiant du chemin est celui de la machine source.
2. Donnez snapshot_id et paths, les chemins du point de restauration.
3. Donnez target : {"mode": "directory", "path": "/@shares/<nom court>/<dossier>"} pour le dossier d'un partage, ou {"mode": "original"} pour le partage d'origine.
4. Ajoutez target_endpoint_id pour écrire sur le partage d'une autre machine du même client.
5. Ajoutez overwrite : never ou if_changed.
6. Lisez la réponse 202. Elle donne restore_session_id.

Le nom court du chemin target est celui d'un partage de la machine cible.

Un assistant IA utilise l'outil MCP start_restore, avec target_directory réglé sur un dossier de partage. Cet outil ne restaure jamais vers une machine d'un autre client.

Quand la restauration est refusée

Le portail garde vos choix et écrit la cause sous le choix refusé.

Message	Ce que vous faites
« Un partage cible doit appartenir au même client que la source. »	Choisissez une machine du client de la source.
« La restauration vers un partage n'est pas disponible pour cette version de l'agent. Vous pouvez restaurer vers un disque local. »	Mettez l'agent de la machine cible à jour.
« Le partage d'origine est disponible uniquement sur la machine source. »	Choisissez la machine source, ou le dossier d'un partage.
« Aucun partage compatible sur cette machine. »	Déclarez un partage sur la machine cible.
« Saisissez un sous-dossier valide, sans point ni double point comme segment. »	Corrigez le dossier dans le partage.

Une restauration qui part et que l'agent refuse ensuite porte un code de partage sur chaque chemin sélectionné. Voir Causes des partages réseau et Suivre et arrêter une restauration.

Limites et précautions

• Un partage est une ressource du client. Une restauration vers un partage d'un autre client est toujours refusée, même avec une confirmation.
• Le partage d'origine n'existe que sur la machine source.
• La machine cible exécute une seule restauration à la fois.
• La commande baastide restore de la machine n'écrit pas sur un partage réseau. Elle écrit dans un dossier de la machine. Voir baastide restore.
• L'agent écrit dans un dossier de travail à la racine du partage pendant la restauration, puis il déplace chaque élément à sa place. Ce dossier porte le nom .baastide-restore-, suivi de deux identifiants.
• Quand la machine s'arrête pendant une restauration, le dossier de travail reste sur le partage. L'agent le retire à la restauration suivante vers ce partage. Il ne touche jamais au dossier de travail d'une autre machine ni d'une restauration en cours. Au-delà de 100 restaurations terminées, les dossiers les plus anciens restent : retirez-les à la main.
• L'agent ne suit jamais un lien pendant une restauration sur un partage. Un lien posé par un autre client du NAS à la place d'un dossier donne une erreur sur cet élément, jamais une écriture hors du partage.
• Avec Ne pas le toucher, un fichier créé par un autre client du NAS pendant la restauration peut encore être remplacé : c'est le seul cas.
• Sur un export NFS, un dossier qui existe déjà est fusionné avec le dossier restauré. Les fichiers déjà présents suivent le choix d'écrasement.
• L'agent ne vérifie pas le propriétaire du dossier cible sur un partage : les droits sont ceux du NAS. Choisissez un partage dont le compte n'écrit que là où le client l'accepte.
• Un partage supprimé ne reçoit plus de restauration. Ses points de restauration restent lisibles, et leurs chemins s'affichent avec le nom court du partage supprimé.
• Le journal d'audit garde chaque demande de restauration, avec ses chemins. Voir Journal d'audit.

Référence

• API : Create restore, route POST /endpoints/{id}/restores.
• Outils MCP : start_restore.
• Codes de cause : Causes des partages réseau.