소프트웨어 패키지 업그레이드
ServBay 로컬 웹 개발 환경에서 PHP, 데이터베이스, 웹 서버 등의 소프트웨어 패키지를 최신 상태로 유지하는 것은 개발 효율, 보안, 최신 기능 활용을 위해 매우 중요합니다. ServBay는 패키지 관리와 업그레이드를 직관적이고 효율적인 프로세스로 제공합니다. 아래의 단계별 안내와 기능 설명을 참고하여 필요한 패키지를 쉽게 최신 버전으로 업데이트할 수 있습니다.
TIP
패키지 업그레이드 과정은 안전하며 파괴적이지 않습니다. 업그레이드를 해도 현재 보유한 데이터(MariaDB, MySQL, PostgreSQL 데이터베이스 파일, 웹사이트 파일, SSL 인증서 구성 등)를 포함해 모든 중요한 정보는 영향을 받지 않습니다. 데이터 손실이나 손상이 발생할 염려 없이 안심하고 최신 버전으로 업데이트하세요.
패키지 업그레이드 단계
ServBay의 그래픽 사용자 인터페이스(GUI)를 사용하면 업그레이드 과정이 매우 간편합니다. 다음 단계를 따라 진행하세요.
ServBay 앱 실행하기
ServBay 앱을 실행하세요. macOS의 Launchpad, Applications 폴더 또는 Spotlight 검색을 통해 쉽게 열 수 있습니다.“패키지” 페이지로 이동
ServBay 앱 화면의 왼쪽 내비게이션 메뉴에서패키지
항목을 클릭하세요. 해당 페이지에서 ServBay에 설치된 모든 소프트웨어 패키지를 관리할 수 있습니다.패키지 목록 확인
“패키지” 페이지에는 ServBay에 설치되었거나 사용할 수 있는 모든 패키지의 상세 목록이 나타납니다. 여기에는 패키지 이름, 현재 설치 버전, 최신 버전, 실행 상태(예: “실행 중”, “중지됨”), 프로세스 ID(PID) 등 주요 정보가 표시됩니다.업데이트 가능 여부 확인
패키지 목록의최신 버전
열을 주의 깊게 확인하세요. 업데이트가 있는 경우,최신 버전
칸에현재 버전
보다 높은 숫자가 나오며, 해당 패키지 항목의 가장 오른쪽에는 눈에 띄는 주황색업그레이드
버튼(위쪽 화살표 아이콘 포함)이 표시되어 업데이트 가능함을 안내합니다.“업그레이드” 버튼 클릭
업그레이드하고 싶은 패키지를 찾아 해당 항목의 오른쪽에 위치한 주황색업그레이드
버튼을 클릭하세요. 클릭하면 ServBay가 자동으로 업그레이드 절차를 시작합니다.업그레이드 진행 상황 모니터링
업그레이드 버튼을 누르면 ServBay가 자동으로 필요한 파일을 다운로드·설치합니다. 진행 상황은 화면의 인디케이터 또는 상태 메시지로 나타납니다. 다운로드 및 설치에 걸리는 시간은 패키지 크기와 네트워크 속도에 따라 달라집니다. 완료되면(기존에 실행되고 있었다면 자동 재시작) 해당 패키지의 상태는 **실행 중
**으로 변경되며,현재 버전
도 새로운 버전으로 업데이트됩니다.
예시: PHP 패키지 업그레이드 방법
ServBay에 설치된 PHP 8.1 버전을 업그레이드하는 과정을 예로 들어보겠습니다. 아래 단계대로 따라 하세요.
“패키지” 페이지로 이동
ServBay 앱을 열고 왼쪽 내비게이션 메뉴에서 **패키지
**를 클릭합니다.PHP 8.1 패키지 찾기
패키지 목록에서 아래로 스크롤하거나 검색 기능을 사용해PHP 8.1
항목을 찾으세요. 예를 들어,현재 버전
이8.1.28
,최신 버전
은8.1.29
로 표시된다면, 8.1.28에서 8.1.29로의 최신 업데이트가 가능한 상태입니다.해당 “업그레이드” 버튼 클릭
PHP 8.1
항목의 가장 오른쪽에 위치한 주황색업그레이드
버튼을 클릭하세요.업그레이드 완료 및 확인
ServBay가 자동으로 PHP 8.1의 최신 버전을 다운로드하고 설치합니다. 진행 중에는 상태가 “업그레이드 중”으로 표시될 수 있습니다. 업그레이드가 완료되면 상태가 다시 **실행 중
**으로 바뀌며,현재 버전
정보도8.1.29
로 갱신됩니다.
이미지 설명: ServBay 패키지 관리 화면에서 업그레이드 가능한 패키지와 업그레이드 버튼이 표시된 모습.
자주 묻는 질문 (FAQ)
패키지를 업그레이드하면 내 데이터나 프로젝트에 영향이 있나요?
영향이 없습니다. ServBay의 주요 설계 원칙 중 하나는 핵심 데이터의 안전성과 분리성입니다. 패키지 업그레이드는 프로그램 실행 파일만 교체하며, 웹사이트 파일, 데이터베이스 파일(/Applications/ServBay/data/mysql
, /Applications/ServBay/data/pgsql
등 폴더 내의 데이터), SSL 인증서, 사용자 정의 설정 파일 등은 별도의 위치에 저장되어 업그레이드시 삭제되거나 변경되지 않습니다. 데이터베이스 파일 관리에 관한 추가 정보는 데이터베이스 파일 관리 및 마이그레이션 문서를 참고하세요.
패키지가 정상적으로 업그레이드되었는지 어떻게 확인하나요?
정상 업그레이드 여부를 확인하는 방법은 다음과 같습니다.
- “패키지” 페이지에서 해당 패키지의
현재 버전
이 업그레이드 전최신 버전
으로 변경되어 있습니다. - 해당 패키지의 상태가 **
실행 중
**으로 표시됩니다. - 패키지 로그 파일을 확인하거나, 명령줄에서 새로운 버전이 적용되었는지 직접 확인할 수도 있습니다(예: PHP의 경우 터미널에
php -v
명령어를 입력해 버전을 확인. 단, 시스템 PATH가 ServBay의 PHP를 바라보고 있어야 합니다).
업그레이드 과정에서 오류가 발생하면 어떻게 하나요?
업그레이드 도중 네트워크, 파일 권한, 디스크 용량 부족 등 오류가 생기는 경우, ServBay 화면에서 관련 오류 메시지가 표시됩니다.
- 우선 오류 메시지를 참고해 네트워크 연결을 점검하거나, ServBay 앱의 쓰기 권한, 하드디스크 공간을 확보해보세요.
- 문제가 계속된다면 ServBay 앱을 재시작한 뒤 업그레이드를 다시 시도하세요.
- 계속 해결되지 않으면 ServBay 지원팀에 문의하여 오류정보, 사용 중인 ServBay 및 macOS 버전 등과 함께 상세한 상담을 받아보시기 바랍니다.
ServBay에서 소프트웨어 패키지 자동업그레이드는 되나요?
현재 ServBay는 완전 자동화된 백그라운드 패키지 업그레이드 기능을 제공하지 않습니다. 개발자는 정기적으로 직접 “패키지” 페이지에서 업데이트 가능 여부를 확인하고, 필요시 “업그레이드” 버튼을 클릭해 수동으로 진행해야 합니다. 이 방식은 개발자가 직접 업데이트 내역을 확인하고, 업그레이드 시점을 스스로 선택할 수 있으므로 예상치 못한 자동 업데이트로 인한 호환성 문제를 방지할 수 있습니다.
요약
ServBay의 직관적인 “서비스” 페이지와 간단한 클릭만으로 PHP, MySQL, Nginx, Apache, Node.js, Python, Go, Java 등 다양한 소프트웨어 패키지를 손쉽게 최신 상태로 유지할 수 있습니다. 패키지 정기 업그레이드는 개발 환경의 보안성과 안정성을 지키고 최신 기능을 확보하는 데 필수적인 과정입니다. 업그레이드 과정은 안전하며 기존 데이터에 영향을 주지 않으니, 안심하고 개발에 집중하세요.