| Panel | ||||||||
|---|---|---|---|---|---|---|---|---|
| ||||||||
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 등). 이전 버전에서 사용하던 설정 파일을 덮어 씌우지 않도록 합니다
- 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에 기록되어 있습니다.
추가 데이터베이스유지보수
기술적인 데이터베이스를 업그레이드 과정이완료된한 후(위 7단계중, 7단계가장 마지막 단계 직전), 데이터베이스 통계 갱신 및 데이터베이스 인댁스를 재생성합니다. 브라우저에서다음 URL을입력합니다.
http://yourSonarQubeServerURL/maintenance인덱스 재생성작업을 수해알 것을 권장합니다.
스캐너업데이트
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 서버가릴리즈되는경우, 일반적으로이전버전에서업그레이드하는데필요한사항들을함께발표합니다. 이전사용버전과업그레이드할버전의업그레이드노트를모두숙지해야합니다. 아래표시되지않은버전에서업그레이드를진행하는경우, 이전버전의가이드문서(영문)를참조합니다.
- Release 6.7 Upgrade Notes (국문)
- Release 6.6 Upgrade Notes (국문)
- Release 6.5 Upgrade Notes (국문)
- Release 6.4 Upgrade Notes (국문)
- Release 6.3 Upgrade Notes (영문)
- Release 6.2 Upgrade Notes (영문)
- Release 6.1 Upgrade Notes (영문)
- Release 6.0 Upgrade Notes (영문)
- Release 5.6 Upgrade Notes (영문)
<center>
© 2008-2017, SonarSource S.A, Switzerland.
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>