SLV Migrate Linux - Início rápido

🚚 SLV Migrate Linux

Migre todo o disco Linux para um novo servidor via SSH usando o rsync. É uma migração do disco inteiro — tudo o que está no servidor de origem é copiado para o destino, incluindo dados de usuário, configurações, pacotes instalados e a configuração do nó SLV.
Nota: Isto é diferente de slv v switch (migração da identidade do validador). slv migrate linux copia todo o sistema de arquivos, enquanto slv v switch troca a identidade do validador entre dois nós que já estão em execução.

Pré-requisitos

  • SLV CLI instalado no nó de origem
  • Acesso sudo / root na origem e no destino
  • Acesso SSH da origem ao destino (por senha ou por chave)
  • O servidor de destino deve ser uma instalação nova (o SLV avisa se detectar dados existentes)

Uso básico

Execute no servidor de origem:
bash
sudo slv migrate linux --to root@new-server-ip
🚚 SLV Linux Migration

  Source:      ubuntu (this machine)
  Destination: [email protected]

📋 Exclude list:
  • /dev/*
  • /proc/*
  • /sys/*
  • /tmp/*
  • /run/*
  • /mnt/*
  • /media/*
  • /lost+found
  • /swapfile
  • /snap/*
  • /var/log/*

? Start migration? This will overwrite data on the destination. › Yes
  Syncing... (this may take a while depending on disk size)
√ Migration complete
  Rebooting destination...

Opções

OpçãoDescrição
-t, --to <ssh>Destino SSH (ex.: root@new-server)
-p, --port <port>Porta SSH (padrão: 22)
--skip-rebootPula a reinicialização automática após a migração
--exclude <path>Padrão de exclusão adicional do rsync (pode ser repetido)
--include <path>Remove das exclusões padrão (pode ser repetido)
--list-excludesMostra a lista de exclusões atual e sai
-y, --yesPula a solicitação de confirmação

Porta SSH personalizada

Se o destino usar uma porta SSH diferente da padrão:
bash
sudo slv migrate linux --to root@new-server-ip --port 2222

Personalizar as exclusões

Veja o que será excluído:
bash
slv migrate linux --list-excludes
Exclua outros caminhos (por exemplo, pule os dados do ledger para migrar mais rápido):
bash
sudo slv migrate linux --to root@new-server-ip --exclude /home/solv/ledger

Modo não interativo

Para scripts:
bash
sudo slv migrate linux --to root@new-server-ip --skip-reboot --yes

Como funciona

  1. Verificações prévias — Verifica a conectividade SSH e avisa se o destino já tem dados
  2. rsync — Copia todo o sistema de arquivos (exceto os pseudo-sistemas de arquivos do sistema) via SSH
  3. Pós-migração — Reinicia automaticamente o servidor de destino (a menos que você use --skip-reboot)
A migração usa o rsync com --archive --hard-links --acls --xattrs para preservar todos os atributos de arquivo, as permissões e os arquivos especiais.

⚠️ Observações importantes

  • Execute como root (ou com sudo). Uma migração sem root deixa arquivos do sistema de fora.
  • O destino deve ser um servidor novo. Os dados existentes serão sobrescritos.
  • Os códigos de saída 23/24 do rsync (transferência parcial) são tratados como avisos, não como erros. Alguns arquivos (como logs ativos) podem não ser transferidos perfeitamente.
  • Após a migração, confirme que o nó está funcionando corretamente antes de desativar a origem.
  • Para a migração da identidade do validador (troca sem downtime entre dois validadores em execução), use slv v switch em vez disso. Veja Migração do validador Mainnet.