Comment configurer la réplication de TrueNAS vers un autre serveur : guide étape par étape

La réplication copie les snapshots ZFS d'un dataset d'un système TrueNAS vers un autre. Si le serveur source tombe en panne ou si des données sont supprimées par erreur, vous pouvez restaurer les données à partir des snapshots répliqués. La première réplication transfère l'intégralité du dataset. Les réplications suivantes sont incrémentielles : elles ne transfèrent que les modifications contenues dans les snapshots plus récents, ce qui réduit généralement la quantité de données transférées.

Ce guide explique comment configurer une réplication push : le TrueNAS source envoie des snapshots à un TrueNAS de destination via SSH, selon un calendrier. Les étapes et les captures d'écran correspondent à TrueNAS 25.10. Dans d'autres versions, les noms des menus et les libellés des champs peuvent différer.

Prérequis

Vous avez besoin de :

• deux serveurs sur lesquels TrueNAS 25.10 est installé ;
• une connectivité réseau entre les serveurs ;
• un compte administrateur sur le serveur de destination avec un accès SSH, un répertoire personnel et des autorisations sudo ;
• suffisamment d'espace libre sur le pool de destination pour le dataset répliqué et ses snapshots.

Dans ce guide :

• le serveur source est le TrueNAS dont vous souhaitez protéger les données ;
• le serveur de destination est le TrueNAS qui stocke les copies.

Pour installer TrueNAS sur un serveur dédié, consultez Installation de TrueNAS sur un serveur dédié via IP-KVM et Virtual Media.

Préparer le serveur de destination

Toutes les étapes de cette section s'effectuent dans l'interface web du serveur de destination.

Créer un dataset pour les copies

Accédez à Datasets, sélectionnez le pool et cliquez sur Add Dataset. Dans Name, saisissez un nom, par exemple backup. Conservez le preset Generic et cliquez sur Save. Le dataset répliqué sera créé à l'intérieur de ce dataset. Utilisez un dataset neuf et vide. N'utilisez pas un dataset qui contient des données ou des snapshots importants, car la réplication peut gérer et supprimer les snapshots sur la destination selon les paramètres de rétention.

Configurer le compte administrateur

Accédez à Credentials > Users, sélectionnez le compte administrateur que vous utiliserez pour la réplication, par exemple truenas_admin, et cliquez sur Edit.

Dans Allow Access, sélectionnez SSH Access. Sélectionnez ensuite Allow SSH Login with Password (not recommended). La connexion par mot de passe n'est nécessaire que pendant que TrueNAS établit la connexion SSH et installe la clé publique. Une fois la connexion fonctionnelle, vous pouvez la désactiver.

Vérifiez le champ Home Directory dans Additional Details. Il doit pointer vers un répertoire réel, par exemple /home/truenas_admin. La réplication nécessite un vrai répertoire personnel pour ce compte ; ne le laissez donc pas défini sur /var/empty. Si nécessaire, cliquez sur l'icône de modification et définissez le répertoire personnel.

Dans Sudo Commands, cliquez sur l'icône de modification et sélectionnez Allow all sudo commands with no password. TrueNAS utilise sudo sans mot de passe pour exécuter les commandes ZFS requises sur le serveur de destination. Cliquez sur Save.

Les détails du compte affichent désormais SSH Password Login Enabled et Allowed Sudo Commands (No Password) : ALL.

Activer le service SSH

Accédez à System > Services, repérez SSH et cliquez sur l'icône de modification. Assurez-vous que Allow Password Authentication est sélectionné et cliquez sur Save.

Cliquez ensuite sur le bouton de démarrage à côté de l'état de SSH et activez le commutateur Start Automatically afin que le service démarre après un redémarrage. L'état passe à Running.

Préparer le serveur source

Les étapes restantes s'effectuent dans l'interface web du serveur source.

Créer un dataset à répliquer

Assurez-vous qu'un répertoire personnel est également défini pour le compte administrateur du serveur source : accédez à Credentials > Users, sélectionnez le compte et vérifiez le champ Home Directory.

Si les données que vous souhaitez protéger ne se trouvent pas encore dans un dataset distinct, créez-en un : accédez à Datasets, sélectionnez le pool, cliquez sur Add Dataset, saisissez un nom, par exemple data, et cliquez sur Save.

Créer une connexion SSH

Accédez à Credentials > Backup Credentials et cliquez sur Add dans le widget SSH Connections. Remplissez le formulaire :

• Connection Name : un nom au choix, par exemple backup-server ;
• Setup Method : Semi-automatic (TrueNAS only) ;
• TrueNAS URL : l'adresse du serveur de destination, par exemple https: //203.0.113.20 ;
• Admin Username et Admin Password : les identifiants du compte administrateur sur le serveur de destination ;
• Username : le même compte ;
• Enable passwordless sudo for zfs commands : sélectionné ;
• Private Key : Generate New.

Cliquez sur Save. Si le serveur de destination utilise le certificat auto-signé par défaut, TrueNAS affiche une erreur de certificat et demande s'il faut l'ignorer. Sélectionnez Confirm et cliquez sur Continue.

TrueNAS se connecte au serveur de destination, génère une paire de clés et y installe automatiquement la clé publique. La nouvelle connexion apparaît dans le widget SSH Connections et sa clé apparaît dans SSH Keypairs.

Créer la tâche de réplication

Accédez à Data Protection et cliquez sur Add dans le widget Replication Tasks. Le Replication Task Wizard s'ouvre.

What and Where

Dans Source Location, sélectionnez On this System et, dans Destination Location, sélectionnez On a Different System.

Dans SSH Connection, sélectionnez la connexion que vous avez créée. TrueNAS demande s'il faut utiliser sudo pour les commandes ZFS, car la connexion utilise un compte non root. Cliquez sur Use Sudo For ZFS Commands.

Dans Source, développez /mnt et le pool, puis sélectionnez le dataset que vous souhaitez répliquer. Sélectionnez Recursive si vous souhaitez également répliquer ses datasets enfants. Si le dataset n'a pas encore de snapshots, l'assistant indique que des snapshots seront créés automatiquement. TrueNAS crée une tâche de snapshots périodiques pour le dataset, que vous pourrez voir ensuite dans le widget Periodic Snapshot Tasks.

Dans Destination, développez l'arborescence du serveur de destination et sélectionnez le dataset backup. Ajoutez ensuite, après une barre oblique, un nom pour le dataset répliqué, par exemple tank/backup/data. TrueNAS crée ce dataset lors de la première exécution.

Laissez SSH Transfer Security sur Encryption et assurez-vous que Use Sudo For ZFS Commands est sélectionné.

Le champ Task Name est rempli automatiquement. Vous pouvez le remplacer par un nom plus facile à reconnaître dans la liste. Cliquez sur Next.

When

Dans Replication Schedule, conservez Run On a Schedule. Dans Schedule, sélectionnez la fréquence de la réplication. La valeur par défaut est Daily At 00:00 (12:00 AM). Pour des données importantes qui changent souvent, choisissez un calendrier plus fréquent.

Dans Destination Snapshot Lifetime, choisissez la durée de conservation des snapshots sur le serveur de destination :

• Same as Source : utilise la durée de conservation définie dans la tâche de snapshots périodiques de la source ;
• Never Delete : les snapshots sont conservés jusqu'à ce que vous les supprimiez manuellement ;
• Custom : les snapshots sont conservés pendant la période que vous définissez, par exemple 2 semaines.

Conserver les snapshots plus longtemps sur la destination que sur la source peut fournir des points de restauration supplémentaires, mais utilise plus d'espace.

Cliquez sur Save. La tâche apparaît dans le widget Replication Tasks avec l'état PENDING.

Exécuter et vérifier la réplication

Pour lancer la première réplication sans attendre le calendrier, cliquez sur le menu à trois points à côté de la tâche et sélectionnez Run job. Cliquez sur Continue pour confirmer.

La première exécution transfère l'intégralité du dataset et peut être longue, selon la quantité de données et la vitesse de la connexion entre les serveurs. Les exécutions suivantes ne transfèrent que les modifications.

Lorsque la tâche est terminée, son état passe à SUCCESS et la colonne Last Snapshot affiche le nom du snapshot envoyé. Si l'état est FAILED, cliquez dessus pour ouvrir le journal de la tâche et consulter l'erreur.

Pour vérifier le résultat, ouvrez l'interface web du serveur de destination et accédez à Datasets. Sélectionnez le dataset répliqué, par exemple tank/backup/data, et cliquez sur View Snapshots dans le widget Data Protection. La liste affiche les snapshots reçus du serveur source.

Restaurer des données à partir de la copie

Pour restaurer des fichiers individuels, clonez le snapshot nécessaire en tant que nouveau dataset sur le serveur de destination : accédez à Datasets, sélectionnez le dataset répliqué, cliquez sur View Snapshots, développez le snapshot et cliquez sur Clone To New Dataset. Copiez ensuite les fichiers dont vous avez besoin depuis le clone.

Pour recopier le dataset répliqué vers la source, accédez à Data Protection sur le serveur source, cliquez sur le menu à trois points à côté de la tâche de réplication et sélectionnez Restore. Saisissez un nom pour la tâche de restauration et sélectionnez l'emplacement des données restaurées sur le serveur source. TrueNAS crée une nouvelle tâche de réplication qui retransfère les données de la destination vers la source. La tâche a l'état PENDING. Exécutez-la pour lancer la restauration.