QueryPie ACP Community Edition 업그레이드 방법

Overview

업그레이드는 설치 스크립트(setup.v2.sh)의 --upgrade 옵션을 사용합니다. 기존 데이터와 설정을 유지한 채로 새 버전으로 전환하며, DB 마이그레이션까지 자동으로 수행합니다.

업그레이드 절차

Step 1: 현재 버전 확인 및 업그레이드 전제조건 확인

# Check which version the `current` symbolic link points to
ls -al ~/querypie/current ## This is an example when installed under the home directory.

# Check whether all required containers are running (app, mysql, redis)
docker ps --format "table {{.Names}}\t{{.Image}}" | grep querypie

Step 2: 설치 가능한 버전 확인

제품 버전 문서에서 설치 가능한 버전을 확인합니다.

Step 3: 업그레이드 실행

서버에 SSH로 직접 로그인한 후 실행합니다 (TTY 필요):

bash <(curl -s https://dl.querypie.com/setup.v2.sh) --upgrade <version>

예시:

bash <(curl -s https://dl.querypie.com/setup.v2.sh) --upgrade 11.6.0

동일 버전이나 낮은 버전으로는 업그레이드가 진행되지 않습니다.

Step 4: 업그레이드 완료 확인

# Check whether the `current` symbolic link points to the new version
ls -al ~/querypie/current ## This is an example when installed under the home directory.

# Check whether the new version containers are running
docker ps --format "table {{.Names}}\t{{.Image}}" | grep querypie

주의사항

• 직접 로그인 필요: 설치와 마찬가지로 TTY가 필요하므로 SSH로 서버에 직접 접속 후 실행합니다.
• 버전 순서: 동일 버전이나 낮은 버전으로는 업그레이드가 진행되지 않습니다.
• 이전 버전 디렉토리 보존: 업그레이드 후 이전 버전 디렉토리(~/querypie/<이전버전>/)는 자동 삭제되지 않습니다. 확인 후 필요 없다면 수동으로 삭제해야 합니다. (인증서 등 이전 버전에서 사용하던 파일 중 복사가 필요한 파일이 있다면 복사한 뒤 삭제합니다.)

  rm -rf ~/querypie/<previous version>

• 다운타임: 컨테이너 교체 과정에서 짧은 서비스 중단이 발생합니다.
• 라이선스: Community Edition 라이선스 유효기간은 발급일로부터 1년입니다. 업그레이드 후 라이선스 만료 여부를 확인합니다.