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 데이터 디렉토리 백업
- **파인더(Finder)**를 열고
/Applications
디렉토리로 이동하세요. ServBay
라는 이름의 디렉토리(이것은ServBay.app
애플리케이션이 아님)를 찾으세요.- 이 디렉토리의 이름을
ServBay.bak
로 변경하세요. 이 폴더에는 웹사이트 파일, 데이터베이스, SSL 인증서, 백업, 설정 등 모든 데이터가 들어 있습니다.
3단계: 새 Mac에서 ServBay 새로 설치
ServBay.bak
폴더 전체를 기존 Mac에서 새 M 시리즈 Mac의/Applications
폴더로 복사하세요.- 새 M 시리즈 Mac에서 ServBay 최신 버전을 다운로드해 설치하세요.
- 처음으로 ServBay.app을 실행하면, 새로운 설치 과정을 안내합니다. 안내에 따라 정상적으로 설치를 완수하세요. 설치가 완료되면
/Applications
폴더에 새로운ServBay
폴더가 생성됩니다.
4단계: 모든 필수 소프트웨어 패키지 재설치
- 새 Mac에서 ServBay를 실행하세요.
- 왼쪽 네비게이션 바의 패키지(Packages) 섹션으로 이동하세요.
- 이전 Mac에서 사용했던 모든 소프트웨어 패키지(예: PHP 8.2, MySQL 8.0, Nginx 1.25 등)를 다시 설치하세요.
- 중요: 이 단계에서는 패키지를 설치만 하고, 활성화하지 마세요.
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 아키텍처가 다르기 때문에, 기존 설정 파일을 그대로 사용할 수 없습니다.
- 새 Mac에서 백업해둔 설정 파일:
/Applications/ServBay.bak/data/servbay/config.data
를 찾으세요. - 이
config.data
파일을 ServBay 공식 기술 지원에 전달하세요(공식 Discord, Telegram, 위챗 혹은 이메일 등으로). - 지원팀이 이 파일을 새 M 시리즈 칩에 맞게 변환하여, 변환된 파일을 회신해 드립니다.
- 받은 변환 파일을 새 ServBay의 해당 경로(
/Applications/ServBay/data/servbay/config.data
)에 덮어쓰기 하세요.
8단계: ServBay Root CA 재설치
- ServBay 애플리케이션을 실행하세요.
- 왼쪽 네비게이션에서 설정(Settings) 메뉴로 이동하세요.
- 설정 페이지에서
ServBay Root CA
항목을 찾아ServBay Root CA 재설치
버튼을 클릭하세요.
9단계: 모든 서비스 재시작
- 왼쪽 네비게이션에서 패키지(Packages) 메뉴로 이동하세요.
- 설치된 각 패키지별로 아래의 순서대로 재시작 하세요: 먼저 스위치를 클릭해서 비활성화한 뒤, 다시 클릭해서 활성화하세요. 이 과정으로 모든 서비스가 방금 마이그레이션한 데이터 및 설정을 기반으로 정상 구동됩니다.
10단계: 이전 완료
이제 ServBay 데이터 마이그레이션이 모두 완료되었습니다! 새로운 M 시리즈 Mac에서 ServBay를 정상적으로 사용할 수 있습니다. 웹사이트, 데이터베이스, 각종 서비스가 모두 정상 작동하는지 확인해 보세요.
자주 묻는 질문 (FAQ)
- Q: 기술 지원팀에
config.data
파일 변환을 요청하는 과정을 건너뛸 수 있나요?- A: 불가합니다.
config.data
파일에는 하드웨어 아키텍처와 관련된 중요 설정이 들어 있기 때문에, 이 과정을 생략할 경우 웹사이트, 데이터베이스, 기타 서비스 설정을 ServBay가 올바르게 불러오지 못해 정상 동작하지 않을 수 있습니다.
- A: 불가합니다.
- Q: 이전에 설치했던 패키지를 기억하지 못하면 어떻게 하죠?
- A: 기술 지원팀에
config.data
파일을 변환 요청할 때 문의하시면 됩니다. 해당 파일에 설치 내역이 기록되어 있습니다.
- A: 기술 지원팀에
- Q: 마이그레이션 이후 웹사이트 접속이 안 되면 어떻게 해야 하나요?
- A: 아래 항목을 차례대로 확인해 보세요:
- 9단계에서 해당 소프트웨어 패키지(예: Nginx/Apache, 연관된 PHP 버전 등)를 모두 재시작했는지 확인하세요.
- ServBay 내 사이트 설정이 올바른지 검토하세요.
- 관련 패키지의 로그 파일을 확인하여, 구체적인 에러 메시지가 있는지 점검하세요.
- A: 아래 항목을 차례대로 확인해 보세요: