마이그레이션

더 강력한 PCS로 업그레이드하거나 다른 위치로 이전할 때, 마이그레이션 기능을 사용하면 모든 앱과 데이터를 새 기기로 전송할 수 있습니다.

마이그레이션 작동 방식

마이그레이션 프로세스는 기존 PCS(소스)와 새 PCS(타겟) 사이에 보안 연결을 생성한 후, 모든 앱 데이터와 구성을 전송합니다. 파이프라인은 여러 단계로 구성됩니다:

단계	설명
준비	소스 PCS가 모든 앱 데이터를 전송용으로 패키징
전송	데이터가 네트워크를 통해 소스에서 타겟으로 안전하게 복사
검증	타겟 PCS가 모든 데이터가 정상적으로 수신되었는지 확인
활성화	타겟 PCS가 전송된 데이터로 모든 앱을 시작
DNS 업데이트	도메인 라우팅이 새 PCS를 가리키도록 업데이트

마이그레이션 전 준비

전제 조건

• 두 PCS 기기가 모두 온라인이고 인터넷에 연결되어 있어야 합니다
• 새 PCS에 모든 데이터를 수용할 충분한 디스크 공간이 있어야 합니다
• 두 기기가 같은 소프트웨어 버전이거나 타겟이 더 새로운 버전이어야 합니다

권장 준비 사항

1. 기존 PCS의 관리자 패널 → 앱에서 모든 중요 앱의 백업을 생성하세요. 마이그레이션이 모든 것을 복사하지만, 별도 백업이 있으면 보험이 됩니다.

2. 기존 PCS의 관리자 패널 → 리소스 → 디스크 탭에서 디스크 사용량을 확인합니다. 새 PCS에 최소 이 정도의 여유 공간이 있는지 확인하세요.

3. 앱을 기록하세요 — 관리자 패널 → 앱에서 설치된 앱과 백업 상태를 기록합니다.

4. 사용자에게 알림 — 다른 사람들이 앱을 사용한다면 마이그레이션 중 잠시 다운타임이 있을 것임을 알려주세요.

마이그레이션 시작

새 PCS (타겟)에서

1. 새 PCS를 설정하고 초기 구성을 완료합니다.
2. 관리자 패널 → 마이그레이션으로 이동합니다.
3. 연결 설정이 있는 마이그레이션 인터페이스가 표시됩니다.

기존 PCS (소스)에서

1. 관리자 패널 → 마이그레이션으로 이동합니다.
2. 안내에 따라 타겟 PCS로의 마이그레이션을 시작합니다.
3. 두 기기가 보안 연결을 설정합니다.

마이그레이션 중

• 마이그레이션 진행 상황이 두 기기 모두에서 실시간으로 표시됩니다.
• 마이그레이션 중에 두 기기의 전원을 끄지 마세요.
• 마이그레이션 진행 중에 소스 PCS의 앱이나 데이터를 수정하지 마세요.
• 마이그레이션 시간은 데이터 양과 네트워크 속도에 따라 다릅니다.

마이그레이션 후

모든 것이 작동하는지 확인

1. 새 PCS에서 관리자 패널 → 앱으로 이동하여 모든 앱이 목록에 있는지 확인합니다.
2. 각 앱을 브라우저에서 열어 데이터가 온전한지 확인합니다.
3. 관리자 패널 → 상태에서 지금 실행을 클릭하여 시스템 상태를 확인합니다.
4. 관리자 패널 → 도메인에서 라우팅이 새 PCS를 가리키는지 확인합니다.

일반적인 마이그레이션 후 작업

• IP 주소가 변경된 경우 북마크 업데이트
• URL이 변경된 경우 모바일 앱 재연결 (Immich, Nextcloud 등)
• 백업 확인 — 새 PCS에서 새 백업을 생성하세요
• 인증서 확인 — 관리자 패널 → 인증서에서 유효한지 확인

마이그레이션 문제 해결

문제	해결 방법
전송에서 멈춤	두 기기 간 네트워크 연결을 확인. 두 기기 모두 절전 모드에 들어가지 않았는지 확인.
디스크 공간 부족	타겟에서 공간을 확보하거나 마이그레이션 전에 소스에서 불필요한 앱을 제거.
마이그레이션 후 앱이 시작되지 않음	상태 → 지금 실행으로 자가 점검 실행. 터미널에서 개별 앱 로그 확인.
도메인이 새 PCS로 연결되지 않음	자가 점검을 실행하여 DNS 라우팅 업데이트. DNS 전파에 최대 24시간 소요.
일부 데이터 누락	앱이 비표준 위치에 데이터를 저장하는지 확인. 마이그레이션 전 생성한 백업에서 복원.

다른 플랫폼에서 마이그레이션

PCS가 아닌 환경(예: Docker를 실행하는 일반 서버)에서 이전하는 경우:

1. PCS의 CasaOS 앱 스토어에서 같은 앱을 설치합니다.
2. SCP 또는 rsync를 사용하여 데이터를 PCS로 복사합니다:

   # 기존 서버에서
   rsync -avz /path/to/app-data/ admin@<pcs-ip>:/DATA/AppData/<앱-이름>/

3. 가져온 데이터를 인식하도록 PCS에서 앱을 재시작합니다.

경고

다른 플랫폼에서 마이그레이션할 때는 디렉토리 구조가 PCS 앱이 예상하는 것과 일치하는지 확인하세요. 예상되는 데이터 레이아웃은 앱의 문서를 확인하세요.

팁

마이그레이션 시작 전에 항상 기존 PCS에서 백업을 생성하세요. 문제가 발생했을 때 복구할 수 있는 안전망입니다.