Confluence URL: Upgrading

Table of Contents

SonarQube 버전 차이가 큰 버전 사이의 업그레이드는 자동으로 관리합니다. 다만, 마이그레이션 대상 버전 사이에 LTS 버전이 존재하는 경우, LTS 버전으로 우선 업그레이드 한 뒤 설치하고자 하는 최종 버전으로 업그레이드 해야합니다.

예: 4.2 -> 6.1 업그레이드 시: 4.2 -> 4.5.7 LTS -> 5.6 LTS -> 6.1
예: 5.1 -> 5.6 업그레이드 시: 5.1 -> 5.6

업그레이드는 어떻게 하나요?

이 섹션의 내용은 일반적인 업그레이드 방법을 가이드합니다. 설치하고자 하는 버전의 업그레이드 노트를 충분히 숙지한 뒤 아래 과정에 따라 업그레이드를 진행합니다.

업그레이드를 시작하기 전에 SonarQube Database를 백업합니다. 업그레이드 과정에서의 문제점은 많지 않으나 만약을 대비해 반드시 백업을 하도록 합니다:

새로운 디렉토리(NEW_SONARQUBE_HOME)에 신규 버전의 SonarQube 배포 파일을 다운로드한 후, 압축을 풉니다.
새로운 SonarQube 버전과 호환되는 플러그인을 다운로드 받아 설치합니다. 플러그인 호환성 매트릭스를 참조하여 설치하고자 하는 SonarQube 서버 버전과의 호환성을 확인합니다. 단순히 이전 SonarQube 서버에서 사용하던 플러그인 파일들을 복사하는 것만으로 호환성이 보장되지는 않습니다.
sonar.properties 파일 및 wrapper.conf 파일(NEW_SONARQUBE_HOME/conf 에 위치함)의 내용을 기존 SonarQube 서버 설정에 맞추어 업데이트합니다(web server URL, database, ldap setting 등). 이전 버전에서 사용하던 설정 파일을 덮어 씌우지 않도록 합니다
1. Oracle DB를 사용하는 경우, JDBC 드라이버를 _NEW_SONARQUBE_HOME/extensions/jdbc-driver/oracle_로 복사합니다.
기존 SonarQube 서버를 중지합니다.
신규 SonarQube 서버를 시작합니다.
http://yourSonarQubeServerURL/setup으로 접속해 설치 단계를 따릅니다.
프로젝트를 분석해 새로운 데이터를 얻습니다

기타 참고 사항들

Oracle Clean-up

SonarQube 6.6에서 Oracle 사용자를 위한 새로운 단계가 추가되었습니다. Oracle 데이터베이스의 경우 현재 드롭해야 할 데이터베이스의 컬럼은 UNUSED로 마킹만 하고 실제로 드롭을 하지는 않습니다. 디스크 공간을 절약하기 위해, Oracle 관리자들은 반드시 테이블 드롭 작업을 수작업로 진행해야 해야 합니다. SQL 요청은 다음과 같습니다:

ALTER TABLE foo DROP UNUSED COLUMNS

관련된 데이터베이스 테이블은 시스템 테이블인 all_unused_col_tabs에 기록되어 있습니다.

추가 데이터베이스 유지보수

기술적인 데이터베이스를 업그레이드 한 후(가장 마지막 단계 직전), 데이터베이스 통계 갱신 및 데이터베이스 인덱스 재생성작업을 수해알 것을 권장합니다.

스캐너 업데이트

Scanner 페이지를 참조해 필요한 경우 스캐너를 업데이트 합니다.

Linux 혹은 Windows 환경에서 SonarQube를 서비스로 사용

외부 환경 설정(즉, 스크립트 혹은 서버를 제어하는 Windows 서비스 등)을 사용하는 경우, 해당 설정이 NEW_SONARQUBE_HOME을 가리키도록 업데이트합니다.

InstallNTService.bat을 사둉해 SonarQube를 Windows 서비스로 등록한 경우, OLD_SONARQUBE_HOME/bin/.../UninstallNTService.bat을 실행한 후 NEW_SONARQUBE_HOME/bin/.../InstallNTService.bat을 실행합니다.

릴리즈 업그레이드 노트

새로운 버전의 SonarQube 서버가 릴리즈 되는 경우, 일반적으로 이전 버전에서 업그레이드하는 데 필요한 사항들을 함께 발표합니다. 이전 사용 버전과 업그레이드 할 버전의 업그레이드 노트를 모두 숙지해야 합니다. 아래 표시되지 않은 버전에서 업그레이드를 진행하는 경우, 이전 버전의 가이드 문서(영문)를 참조합니다.

Except where otherwise noted, content in this space is licensed under a

[Creative Commons Attribution-NonCommercial 3.0 United States License](https://creativecommons.org/licenses/by-nc/3.0/us/).

SONARQUBE is a trademark of SonarSource SA.

All other trademarks and copyrights are the property of their respective owners.

</center>