Migrer Sia renterd vers un nouveau Mac

Introduction

Ce guide détaille la procédure complète pour transférer une installation renterd d'un Mac vers un autre sous macOS. Cette migration permet de conserver vos contrats, vos fichiers uploadés et votre solde de Siacoins.

Prérequis indispensable : Vous devez avoir votre seed de 12 mots. Sans elle, la migration est impossible.

Éléments à sauvegarder

La migration nécessite de transférer les fichiers suivants :

• db.sqlite : Base de données principale contenant les contrats, métadonnées des hosts et des objets.
• metrics.sqlite : Base de données des métriques pour l'interface web.
• partial_slabs/ : Dossier contenant les données en attente d'upload sur le réseau Sia.
  Attention : perdre ce dossier signifie une perte immédiate de données !
• renterd.yml : Fichier de configuration (optionnel mais recommandé).

Ces fichiers se trouvent dans le répertoire :
$HOME/Library/Application Support/renterd

Partie 1 : Sur l'ancien Mac

Étape 1 : Arrêter renterd

Avant toute manipulation, il est impératif d'arrêter renterd proprement pour garantir la cohérence des données.

Si renterd tourne dans un terminal, utilisez Ctrl+C. Vérifiez ensuite qu'il est bien arrêté :

pgrep -l renterd

Si la commande n'affiche rien, renterd est bien arrêté.

Étape 2 : Se placer dans le répertoire renterd

cd "$HOME/Library/Application Support/renterd"

Étape 3 : Vérifier l'état des bases de données

Vérifiez qu'il n'y a pas de fichiers -wal ou -shm dans le dossier db/ :

ls -la db/

Vous devez voir uniquement db.sqlite et metrics.sqlite. Si des fichiers -wal ou -shm sont présents, cela indique un arrêt non propre. Dans ce cas, relancez renterd puis arrêtez-le à nouveau correctement.

Étape 4 : Sauvegarder les bases de données

Utilisez la commande sqlite3 pour créer des sauvegardes cohérentes :

sqlite3 db/db.sqlite ".backup 'db.bkp'"
sqlite3 db/metrics.sqlite ".backup 'metrics.bkp'"

Étape 5 : Sauvegarder les partial slabs

Ce dossier contient des données pas encore uploadées sur le réseau Sia :

tar -cvf partial_slabs.tar partial_slabs/

Étape 6 : Sauvegarder le fichier de configuration

cp renterd.yml renterd.yml.bkp

Étape 7 : Vérifier les sauvegardes

ls -la *.bkp *.tar

Vous devez voir 4 fichiers : db.bkp, metrics.bkp, partial_slabs.tar et renterd.yml.bkp.

Étape 8 : Copier sur un support externe

Exemple avec une clé USB montée sur /Volumes/CLEFUSB :

cp db.bkp metrics.bkp partial_slabs.tar renterd.yml.bkp /Volumes/CLEFUSB/

Étape 9 : Éjecter proprement le support

diskutil eject /Volumes/CLEFUSB

Partie 2 : Sur le nouveau Mac

Étape 10 : Installer renterd

Installez renterd via Homebrew :

brew install siafoundation/sia/renterd

Étape 11 : Configurer renterd avec votre seed

Créez le répertoire et lancez l'assistant de configuration :

mkdir -p "$HOME/Library/Application Support/renterd"
cd "$HOME/Library/Application Support/renterd"
renterd config

L'assistant vous demandera :

• Data directory : Répondez no pour garder le répertoire par défaut.
• Seed phrase : Entrez exactement les 12 mots de votre ancienne installation.
• Password : Choisissez un mot de passe pour l'interface web.
• S3 settings : Répondez no si vous n'utilisez pas S3.
• Advanced settings : Répondez no.

Étape 12 : Restaurer les bases de données

Créez le dossier db et copiez les sauvegardes :

mkdir db
cp /Volumes/CLEFUSB/db.bkp db/db.sqlite
cp /Volumes/CLEFUSB/metrics.bkp db/metrics.sqlite

Étape 13 : Restaurer les partial slabs

tar -xvf /Volumes/CLEFUSB/partial_slabs.tar

Étape 14 : Lancer renterd

renterd

La synchronisation du consensus va démarrer. Vous verrez un message similaire à :

INFO bus.chainsubscriber sync progress {"height": 0, ...}

La synchronisation peut prendre plusieurs heures. C'est normal car le fichier consensus.db n'a pas été transféré (il est volumineux).

Vérification

Une fois renterd lancé, accédez à l'interface web :

http://localhost:9980

Connectez-vous avec le mot de passe défini lors de la configuration. Vous devriez retrouver :

• Votre solde de Siacoins
• Vos contrats actifs
• Vos fichiers uploadés

Points importants

• La seed est critique : Sans elle, impossible de récupérer vos Siacoins ni vos contrats.
• Les partial slabs sont essentiels : Ils contiennent des données non encore uploadées sur le réseau.
• Gardez renterd en ligne régulièrement : L'autopilot doit pouvoir migrer les données vers d'autres hosts si certains deviennent indisponibles.
• Ne lancez pas deux instances simultanément : N'exécutez jamais renterd sur l'ancien et le nouveau Mac en même temps avec la même seed.

Résumé des commandes

Sur l'ancien Mac

# Arrêter renterd (Ctrl+C) puis vérifier
pgrep -l renterd

# Se placer dans le répertoire
cd "$HOME/Library/Application Support/renterd"

# Vérifier l'état des bases
ls -la db/

# Sauvegarder
sqlite3 db/db.sqlite ".backup 'db.bkp'"
sqlite3 db/metrics.sqlite ".backup 'metrics.bkp'"
tar -cvf partial_slabs.tar partial_slabs/
cp renterd.yml renterd.yml.bkp

# Copier sur clé USB
cp db.bkp metrics.bkp partial_slabs.tar renterd.yml.bkp /Volumes/CLEFUSB/
diskutil eject /Volumes/CLEFUSB

Sur le nouveau Mac

# Installer renterd
brew install siafoundation/sia/renterd

# Configurer avec la même seed
mkdir -p "$HOME/Library/Application Support/renterd"
cd "$HOME/Library/Application Support/renterd"
renterd config

# Restaurer les sauvegardes
mkdir db
cp /Volumes/CLEFUSB/db.bkp db/db.sqlite
cp /Volumes/CLEFUSB/metrics.bkp db/metrics.sqlite
tar -xvf /Volumes/CLEFUSB/partial_slabs.tar

# Lancer renterd
renterd