SLV Migrate Linux - 빠른 시작

🚚 SLV Migrate Linux

rsync를 사용해 SSH로 Linux 디스크 전체를 새 서버로 마이그레이션합니다. 전체 디스크 마이그레이션이므로 사용자 데이터, 설정, 설치된 패키지, SLV 노드 설정을 포함해 소스 서버의 모든 것이 대상 서버로 복사됩니다.
참고: 이것은 slv v switch(validator identity 마이그레이션)와 다릅니다. slv migrate linux는 파일 시스템 전체를 복사하고, slv v switch는 이미 실행 중인 두 노드 사이에서 validator identity를 교체합니다.

사전 요구 사항

  • 소스 노드에 SLV CLI 설치
  • 소스와 대상 모두에서 sudo / root 권한
  • 소스에서 대상으로의 SSH 접속 (비밀번호 또는 키 기반)
  • 대상 서버는 새로 설치한 상태여야 합니다 (기존 데이터가 감지되면 SLV가 경고합니다)

기본 사용법

소스 서버에서 실행:
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...

옵션

옵션설명
-t, --to <ssh>SSH 대상 (예: root@new-server)
-p, --port <port>SSH 포트 (기본값: 22)
--skip-reboot마이그레이션 후 자동 재부팅 건너뛰기
--exclude <path>추가 rsync 제외 패턴 (반복 지정 가능)
--include <path>기본 제외 목록에서 제거 (반복 지정 가능)
--list-excludes현재 제외 목록을 표시하고 종료
-y, --yes확인 프롬프트 건너뛰기

사용자 지정 SSH 포트

대상이 비표준 SSH 포트를 사용하는 경우:
bash
sudo slv migrate linux --to root@new-server-ip --port 2222

제외 경로 사용자 지정

제외될 항목 보기:
bash
slv migrate linux --list-excludes
추가 경로 제외 (예: 더 빠른 마이그레이션을 위해 ledger 데이터 건너뛰기):
bash
sudo slv migrate linux --to root@new-server-ip --exclude /home/solv/ledger

비대화형 모드

스크립트용:
bash
sudo slv migrate linux --to root@new-server-ip --skip-reboot --yes

작동 방식

  1. 사전 점검 — SSH 연결을 확인하고, 대상에 기존 데이터가 있으면 경고
  2. rsync — 파일 시스템 전체(시스템 의사 파일 시스템 제외)를 SSH로 복사
  3. 마이그레이션 후 — 대상 서버를 자동으로 재부팅 (--skip-reboot 지정 시 제외)
마이그레이션은 모든 파일 속성, 권한, 특수 파일을 보존하기 위해 --archive --hard-links --acls --xattrs 옵션으로 rsync를 사용합니다.

⚠️ 중요 참고 사항

  • root로 실행하세요 (또는 sudo 사용). root가 아닌 상태로 마이그레이션하면 시스템 파일이 누락됩니다.
  • 대상은 새 서버여야 합니다. 기존 데이터는 덮어씌워집니다.
  • rsync 종료 코드 23/24(부분 전송)는 오류가 아니라 경고로 처리됩니다. 일부 파일(활성 로그 등)은 완전히 전송되지 않을 수 있습니다.
  • 마이그레이션 후에는 소스 서버를 폐기하기 전에 노드가 정상적으로 작동하는지 확인하세요.
  • validator identity 마이그레이션(실행 중인 두 validator 간의 무중단 교체)에는 slv v switch를 대신 사용하세요. Mainnet Validator 마이그레이션을 참고하세요.