ServBay 크로스플랫폼 데이터 마이그레이션 가이드

새 장치로 업그레이드하거나 다른 플랫폼(예: Intel Mac에서 Apple Silicon Mac, 또는 macOS에서 Windows)으로 전환할 때, ServBay 로컬 개발환경을 새 디바이스에서도 문제 없이 사용하려면 특정 마이그레이션 절차를 따라야 합니다. 이 가이드에서는 그 과정을 상세하게 안내합니다.

왜 특별한 마이그레이션 절차가 필요한가요?

ServBay는 macOS와 Windows를 지원하는 크로스플랫폼 로컬 개발환경입니다. macOS에서는 Intel과 Apple Silicon(M 시리즈) 칩을 모두 지원하는 범용 아키텍처의 메인 앱을 제공합니다.

하지만 ServBay의 소프트웨어 패키지(PHP, Node.js, Python, Go, Java, MySQL, MariaDB, Nginx, Apache 등)는 운영체제 및 CPU 아키텍처에 맞게 별도 컴파일/최적화되어 있습니다. 즉,

• macOS Intel 버전 패키지는 Apple Silicon Mac에서 작동하지 않습니다.
• macOS용 패키지는 Windows에서 작동하지 않습니다.
• Windows용 패키지는 macOS에서 작동하지 않습니다.

따라서 단순히 ServBay 폴더 전체를 복사하는 것이 아니라, 새 디바이스용 패키지 재설치와 데이터 및 환경설정의 이전이 반드시 필요합니다.

마이그레이션 상세 절차

아래 안내를 순서대로 따라야 데이터의 안정성과 정확성을 보장할 수 있습니다.

1단계: ServBay 완전 종료

기존 Intel Mac에서 상단 메뉴바의 ServBay 아이콘을 클릭 후 모든 서비스 중지 및 종료를 선택하세요. 백업 전 데이터가 안전하게 닫히도록 반드시 필요합니다.

2단계: ServBay 데이터 폴더 백업

macOS:

1. Finder를 열어 /Applications 폴더로 이동하세요.
2. ServBay라는 폴더(앱 자체가 아닌 폴더)를 찾으세요.
3. 해당 폴더를 ServBay.bak로 이름을 변경하세요.

Windows:

1. 파일 탐색기를 열고 C:\ 폴더로 이동하세요.
2. ServBay라는 폴더를 찾으세요.
3. 해당 폴더명을 ServBay.bak로 변경하세요.

이 폴더에는 웹사이트 파일, 데이터베이스, SSL 인증서, 백업 및 설정 정보가 모두 포함되어 있습니다.

3단계: 새 장치에 ServBay 신규 설치

1. ServBay.bak 폴더를 구버전에서 새 디바이스로 완전히 복사하세요:
   • macOS: /Applications 폴더에 복사
   • Windows: C:\ 폴더에 복사
2. 최신 ServBay 앱을 다운로드해 새 디바이스에 설치하세요.
3. 처음 ServBay를 실행하면 신규 설치 과정이 시작됩니다. 안내에 따라 정상적으로 설치하면 새로운 ServBay 폴더가 생성됩니다:
   • macOS: /Applications/ServBay
   • Windows: C:\ServBay

4단계: 모든 필요 패키지 재설치

1. ServBay를 실행하세요.
2. 왼쪽 네비게이션에서 패키지(Packages) 메뉴로 이동합니다.
3. 전에 사용하던 모든 패키지(PHP 8.2, MySQL 8.0, Nginx 1.25 등)를 새로 설치하세요.
4. 중요: 여기서는 패키지를 설치만 하고, 아직 실행하지 않습니다.

5단계: 다시 ServBay 완전 종료

패키지 설치를 끝낸 후, 메뉴바에서 ServBay 아이콘을 눌러 모든 서비스 중지 및 종료를 누르세요.

6단계: 핵심 데이터 및 설정 파일 이전

이제 두 개의 관련 폴더가 존재해야 합니다:

• macOS:
  • /Applications/ServBay.bak (백업본)
  • /Applications/ServBay (새 설치본)
• Windows:
  • C:\ServBay.bak (백업본)
  • C:\ServBay (새 설치본)

아래 하위 폴더들을 백업본에서 새 ServBay 폴더로 복사하여, 이전 파일과 폴더는 덮어쓰기 하세요:

• backup: 수동/자동 백업 파일
• data: 웹사이트 설정, 앱 환경설정 등
• db: 데이터베이스 파일(MySQL, MariaDB, PostgreSQL 등)
• ssl: SSL 인증서 파일
• www: 웹사이트 프로젝트 파일

중요: 이 단계에서 모든 데이터가 복구됩니다. 반드시 꼼꼼히 진행하세요.

7단계: 기술 지원팀에 설정 파일 변환 요청 (중요 단계)

서로 다른 플랫폼/아키텍처에서는 설정 파일 변환이 필요합니다.

1. 새 장치에서 아래 경로의 설정 파일을 찾으세요:
   • macOS: /Applications/ServBay.bak/data/servbay/config.data
   • Windows: C:\ServBay.bak\data\servbay\config.data
2. 이 config.data 파일을 ServBay 공식 기술 지원(Discord, Telegram, 위챗, 이메일 등)으로 전송하세요.
3. 지원팀이 새 플랫폼, 아키텍처에 맞게 파일을 변환하여 다시 보내줍니다.
4. 전송받은 파일을 아래 경로에 덮어쓰기 하세요:
   • macOS: /Applications/ServBay/data/servbay/config.data
   • Windows: C:\ServBay\data\servbay\config.data

8단계: ServBay Root CA 재설치

1. ServBay 앱을 엽니다.
2. 왼쪽 메뉴의 **설정(Settings)**으로 이동합니다.
3. 설정 화면에서 ServBay Root CA 항목을 찾아 ServBay Root CA 재설치 버튼을 클릭하세요.

9단계: 모든 서비스 재시작

1. 왼쪽 메뉴의 패키지(Packages) 화면으로 이동합니다.
2. 설치한 모든 패키지에 대해, 각각 재시작합니다: 먼저 스위치를 클릭하여 비활성화 후 다시 클릭하여 활성화하세요. 이렇게 하면 새로운 데이터 및 설정을 사용해 서비스가 정상적으로 시작됩니다.

10단계: 마이그레이션 완료

이로써 ServBay 데이터 마이그레이션이 모두 마무리되었습니다! 이제 새 장치에서 정상적으로 ServBay를 사용할 수 있으며, 웹사이트, 데이터베이스, 기타 서비스들이 모두 정상 작동하는지 확인하세요.

자주 묻는 질문 (FAQ)

• Q: 기술 지원팀에 config.data 파일 변환 요청 절차를 생략해도 되나요?
  • A: 절대 불가합니다. config.data에는 플랫폼/아키텍처 관련 핵심 설정 정보가 포함되어 있어, 변환 없이 사용하면 웹사이트, 데이터베이스, 기타 서비스 구성 로드 실패 및 서비스 자체가 작동하지 않을 수 있습니다.
• Q: 내가 예전에 어떤 패키지를 설치했는지 모를 때는 어떻게 하나요?
  • A: 기술 지원팀에 config.data 파일 변환 요청 시 같이 문의하세요. 이전에 설치했던 패키지 정보가 파일 내에 기록되어 있습니다.
• Q: 마이그레이션 후 웹사이트 접속이 안될 때 어떻게 하나요?
  • A: 아래 순서대로 점검하세요:
    1. 9단계에서 모든 패키지(Nginx/Apache 및 해당 PHP 버전 등)를 재시작했는지 확인
    2. ServBay 내 웹사이트 설정이 올바른지 점검
    3. 각 패키지의 로그 파일을 참고하여 구체적인 오류 메시지 확인