이 문서는 Windows 환경에서 SonarQube 설치 가이드 문서를 제공한다.


설치 환경

버전 호환성 확인


JAVA 설치

Download

JAVA 설치파일 web site에 접속하여 JAVA를 Download한다.


(옵션1) Windows Installer 설치

msi 파일을 다운로드 받아 설치를 진행한다.

설치 과정에서 옵션을 통해 Path, JAVA_HOME 환경 변수를 자동 등록할 수 있다.


(옵션2) ZIP 설치 - 설치파일 경로지정

ZIP 파일을 다운로드 받아 설치 파일 구분을 위해 C:\curvc-install\java 폴더 생성 및 압축 해제한다.

환경 변수 등록

JAVA_HOME을 WIndows 시스템 환경 변수에 등록한다.

  •  windows 검색창에서 '시스템 환경 변수 편집' 검색 → 시스템 속성 → 환경변수 → 시스템 변수 새로 만들기
    • 변수이름: JAVA_HOME
    • 변수 값: C:\curvc-install\java\jdk-21.0.10+7



  • 시스템 속성→ 시스템 변수 → 'Path' 편집 → 새로 만들기
    • %JAVA_HOME%\bin 추가


cmd를 통해 java 설치 확인

java -version







DB(PostgreSQL) 설치

Download

PostgreSQL 설치파일 web site에 접속하여 PostgreSQL을 Download한다.

설치파일 경로지정

설치 파일 구분을 위해 C:\curvc-install\postgresql-17 폴더를 생성한다. 


PostgreSQL 설치

다운로드받은 postgresql-17.x-windows-x64.exe 파일로 설치를 진행한다.


안내에 따라 비밀번호, Port (기본값: 5432), Locale (en-US) 등을 지정하고 설치를 완료한다. 

PostgreSQL 실행

C:\curvc-install\postgresql-17\bin\psql -U postgres

위에서 지정한 비밀번호 입력하여 접속한다.


SonarQube 연동 DB 생성

SonarQube와 연동해야 할 DB를 구성 해 준다.

# 유저 생성
create role sonar with login password 'sonar';
 
# DB 생성(UTF8)
CREATE DATABASE sonar WITH OWNER sonar ENCODING 'UTF8' LC_COLLATE='en_US.utf8' LC_CTYPE='en_US.utf8' TEMPLATE=template0;
 
# 권한 설정
grant all privileges on DATABASE sonar to sonar;



PostgreSQL 서비스 등록

아래와 같이 Command로 실행하거나 Windows 서비스에서도 실행 가능하다.

exe 실행 파일을 다운로드 받아 설치한 경우, 기본으로 서비스에 등록되므로 해당 과정은 불필요하다.

PostgreSQL 서비스를 등록하기 전에 명령어로 실행한 PostgreSQL 를 종료해야 한다.


# 서비스 등록
cd C:\curvc-install\postgresql-17\pgsql\bin
pg_ctl register -N postgresql17 -D C:\curvc-install\postgresql-17\pgsql\data
 
# cmd 서비스 실행
net start postgresql17

등록 후 PostgreSQL 서비스가 정상적으로 실행되지 않을 경우, 다음 절차를 통해 삭제 후 재등록하여 실행한다.

  1. PostgreSQL 관련 모든 실행파일 종료
  2. 1~2분 텀을 두고 다음 명령어로 서비스 삭제
    sc delete postgresql17
  3. 위 과정을 통해 서비스 재등록 후 실행




Sonarqube 설치

Download

SonarQube의 web site 접속 하여 SonarQube를 Download 한다.


설치파일 경로지정

설치 파일 구분을 위해 C:\curvc-install\sonarqube-26.3.0.120487 폴더에 압축 해제한다.


Sonar 실행용 JAVA HOME 지정

  • 설정이 적용을 위해 session 재실행 필요. 
  • setx 설정은 서버 부팅 이후에도 계속 적용된다.
// setx SONAR_JAVA_PATH "java.exe 경로"
setx SONAR_JAVA_PATH "$env:JAVA_HOME\bin\java.exe"


sonar.properties 변경

C:\curvc-install\sonarqube-26.3.0.120487\conf\sonar.properties 설정 파일을 변경한다.



Windows Service 등록

C:\curvc-install\sonarqube-26.3.0.120487\bin\windows-x86-64 폴더로 이동한다.

서비스 등록 및 시작 등의 과정에서는 관리자 권한으로 명령 프롬프트를 실행해야 한다.

# 테스트 실행
StartSonar.bat

# 서비스 등록
SonarService.bat install
# 서비스 시작
SonarService.bat start
# 서비스 중지
SonarService.bat stop


Website 접속

서비스 시작 후 http://localhost:9000 또는 http://ipaddress:9000 으로 접속한다.

초기 ID / PW : admin / admin

로그인 후 바로 연결되는 비밀번호 변경 요청 페이지에서 기본 비밀번호를 변경한다.


로그인 성공 후 메인 화면



  • 레이블 없음