Intel 칩에서 Apple Silicon(M 시리즈) 칩 Mac으로 ServBay 데이터 마이그레이션 방법

먼저, Apple Silicon 칩이 탑재된 새로운 Mac으로 업그레이드하신 것을 축하합니다! ServBay의 로컬 개발 환경이 새 장치에서도 원활하고 효율적으로 작동하도록 하려면, 지정된 마이그레이션 과정을 반드시 따라야 합니다. 이 가이드에서는 구체적인 단계별 과정을 안내합니다.

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

ServBay의 메인 애플리케이션은 범용 아키텍처로 설계되어 Intel과 Apple Silicon(M 시리즈) 칩 모두에서 네이티브로 호환됩니다.

그러나 ServBay가 제공하는 주요 소프트웨어 패키지(PHP, Node.js, Python, Go, Java, MySQL, MariaDB, Nginx, Apache 등)는 각 CPU 아키텍처에 맞게 컴파일되고 최적화되어 있습니다. 즉, Intel 칩에 맞게 최적화된 패키지는 M 시리즈 칩에서 바로 사용할 수 없고, 그 반대도 마찬가지입니다.

따라서 Intel Mac에서 M 시리즈 Mac으로 교체할 때는 ServBay 디렉토리를 단순히 복사해서는 안 되며, 반드시 설치된 모든 패키지를 대체하고, 개인 데이터와 설정을 마이그레이션해야 합니다.

상세 마이그레이션 절차

데이터의 완전성과 정확성을 위해 아래 단계들을 순서대로 따라 하세요.

1단계: ServBay 완전히 중지 및 종료

기존 Intel Mac에서 화면 상단 메뉴바의 ServBay 아이콘을 클릭한 후, 메뉴에서 모든 서비스 중지 및 종료를 선택하세요. 이 단계는 모든 데이터 파일이 백업 전에 올바로 닫히도록 보장하는 핵심 절차입니다.

2단계: ServBay 데이터 디렉토리 백업

1. **파인더(Finder)**를 열고 /Applications 디렉토리로 이동하세요.
2. ServBay라는 이름의 디렉토리(이것은 ServBay.app 애플리케이션이 아님)를 찾으세요.
3. 이 디렉토리의 이름을 ServBay.bak로 변경하세요. 이 폴더에는 웹사이트 파일, 데이터베이스, SSL 인증서, 백업, 설정 등 모든 데이터가 들어 있습니다.

3단계: 새 Mac에서 ServBay 새로 설치

1. ServBay.bak 폴더 전체를 기존 Mac에서 새 M 시리즈 Mac의 /Applications 폴더로 복사하세요.
2. 새 M 시리즈 Mac에서 ServBay 최신 버전을 다운로드해 설치하세요.
3. 처음으로 ServBay.app을 실행하면, 새로운 설치 과정을 안내합니다. 안내에 따라 정상적으로 설치를 완수하세요. 설치가 완료되면 /Applications 폴더에 새로운 ServBay 폴더가 생성됩니다.

4단계: 모든 필수 소프트웨어 패키지 재설치

1. 새 Mac에서 ServBay를 실행하세요.
2. 왼쪽 네비게이션 바의 패키지(Packages) 섹션으로 이동하세요.
3. 이전 Mac에서 사용했던 모든 소프트웨어 패키지(예: PHP 8.2, MySQL 8.0, Nginx 1.25 등)를 다시 설치하세요.
4. 중요: 이 단계에서는 패키지를 설치만 하고, 활성화하지 마세요.

5단계: ServBay 완전히 중지 및 종료

모든 패키지 설치가 완료되면, 메뉴바의 ServBay 아이콘을 다시 클릭하여, 모든 서비스 중지 및 종료를 선택하세요.

6단계: 핵심 데이터 및 설정 마이그레이션

이제 /Applications/ 폴더에는 관련된 두 폴더가 존재해야 합니다:

• /Applications/ServBay.bak (기존 Mac에서 옮긴 백업)
• /Applications/ServBay (새 Mac에서 새로 설치된 ServBay)

다음과 같이 복사 작업을 수행합니다:

/Applications/ServBay.bak 디렉토리에서 아래 하위 폴더들을 복사하여 새로운 /Applications/ServBay 폴더에 붙여넣기 하고, 동일한 이름의 파일과 폴더가 있다면 모두 덮어쓰기하세요:

• backup: 모든 수동 및 자동 백업 파일이 들어 있습니다.
• data: 웹사이트 설정, 앱 환경설정 등 보관.
• db: 모든 데이터베이스 파일(MySQL, MariaDB, PostgreSQL 등) 포함.
• ssl: 모든 SSL 인증서 파일.
• www: 모든 웹사이트 프로젝트 파일.

주의: 이 단계는 모든 데이터를 복구하는 데 매우 중요합니다.

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

CPU 아키텍처가 다르기 때문에, 기존 설정 파일을 그대로 사용할 수 없습니다.

1. 새 Mac에서 백업해둔 설정 파일: /Applications/ServBay.bak/data/servbay/config.data를 찾으세요.
2. 이 config.data 파일을 ServBay 공식 기술 지원에 전달하세요(공식 Discord, Telegram, 위챗 혹은 이메일 등으로).
3. 지원팀이 이 파일을 새 M 시리즈 칩에 맞게 변환하여, 변환된 파일을 회신해 드립니다.
4. 받은 변환 파일을 새 ServBay의 해당 경로(/Applications/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 데이터 마이그레이션이 모두 완료되었습니다! 새로운 M 시리즈 Mac에서 ServBay를 정상적으로 사용할 수 있습니다. 웹사이트, 데이터베이스, 각종 서비스가 모두 정상 작동하는지 확인해 보세요.

자주 묻는 질문 (FAQ)

• Q: 기술 지원팀에 config.data 파일 변환을 요청하는 과정을 건너뛸 수 있나요?
  • A: 불가합니다. config.data 파일에는 하드웨어 아키텍처와 관련된 중요 설정이 들어 있기 때문에, 이 과정을 생략할 경우 웹사이트, 데이터베이스, 기타 서비스 설정을 ServBay가 올바르게 불러오지 못해 정상 동작하지 않을 수 있습니다.
• Q: 이전에 설치했던 패키지를 기억하지 못하면 어떻게 하죠?
  • A: 기술 지원팀에 config.data 파일을 변환 요청할 때 문의하시면 됩니다. 해당 파일에 설치 내역이 기록되어 있습니다.
• Q: 마이그레이션 이후 웹사이트 접속이 안 되면 어떻게 해야 하나요?
  • A: 아래 항목을 차례대로 확인해 보세요:
    1. 9단계에서 해당 소프트웨어 패키지(예: Nginx/Apache, 연관된 PHP 버전 등)를 모두 재시작했는지 확인하세요.
    2. ServBay 내 사이트 설정이 올바른지 검토하세요.
    3. 관련 패키지의 로그 파일을 확인하여, 구체적인 에러 메시지가 있는지 점검하세요.