SonarQube Server를 실행하려면 구매하신 플랜에 맞는 라이선스가 필요합니다. 라이선스에는 SonarQube Server 에디션, 코드 라인 수(LOC), 스테이징 라이선스, 상용 지원, 고급 보안과 같은 추가 기능이 포함됩니다.
이제 SonarQube Server는 온라인 활성화를 사용하는 인스턴스에 대해 12시간마다 SonarQube 라이선스를 자동으로 갱신합니다.
이를 통해 별도의 수동 작업 없이도 새로운 기능과 LOC 제한 업데이트를 즉시 적용할 수 있습니다.
라이선스 키 형식이 XXXX-XXXX-XXXX-XXXX인 경우 라이선스 적용에 참고하세요.
권한
SonarQube 서버에서 라이선스 및 추가 기능을 관리하려면 시스템 관리 권한이 있어야 합니다.
사용자 또는 그룹에 권한을 적용하려면 Administration > Security > Global Permissions 으로 이동하여 Administer System를 선택하세요.
License 활성화
SonarQube Server 라이선스를 활성화하려면 다음 단계를 따르세요.
Administration > Configuration > License Manager로 이동하세요.
'Add license' 버튼을 클릭하여 모달 창을 여세요.
모달 창에 라이선스 키를 입력하고 이용 약관에 동의하세요.
Set license을 클릭하여 확인하세요.
라이선스를 활성화하려면 인터넷 연결이 필요합니다.
인스턴스가 다음 리소스에 액세스할 수 있도록 허용해야 합니다.https://api.prod.sonarsource.licensespring.com
라이선스를 오프라인에서 활성화하기
SonarQube 서버 인스턴스가 오프라인 상태이고 라이선스 키를 입력한 후 이전 섹션에 나열된 온라인 리소스에 연결할 수 없는 경우 "Activate offline(오프라인 활성화)" 옵션을 선택해야 합니다.
그리고 다음 단계를 진행하세요.
'Download .req file'를 클릭하여 요청 파일을 컴퓨터에 다운로드하세요. 다음 단계에서 이 파일이 필요합니다.
새 탭에서 열리는 활성화 페이지에 이 .req 요청 파일을 업로드하세요. 라이선스 활성화 URL은 다음과 같습니다.
https://offlinelicense.sonarsource.com이 링크를 클릭하면 .lic 라이선스 파일이 자동으로 컴퓨터로 다운로드됩니다.'Upload .lic file'를 클릭하고 .lic 파일을 찾아 SonarQube 서버 인스턴스에 업로드하여 활성화를 완료하세요.
SonarQube Server 라이선스 페이지
활성화가 완료되면 SonarQube 라이선스 페이지에 다음 정보가 표시됩니다.
'Set a new licens'을 클릭 하고 새 라이선스 키를 입력하여 현재 라이선스를 교체하세요. 드롭다운 메뉴를 클릭하고 'Unset license'를 선택하여 라이선스를 제거할 수 있습니다.
자세한 내용은 '라이선스 설정 해제'를 참조하세요 .라이선스는 12시간마다 자동으로 갱신되어 수동 작업 없이도 새로운 기능 및 LOC 제한 업데이트에 대한 최신 액세스를 보장합니다.
라이선스 서버에서 최신 라이선스 정보를 가져오려면 'Refresh license'을 클릭하십시오. 오프라인으로 활성화된 라이선스를 갱신하려면 '동일한 라이선스 키로 'Set a new license'을 사용할 수 있습니다 .라이선스 정보 :
Edition : 이는 구매하신 플랜(개발자, 엔터프라이즈 또는 데이터 센터)에 따라 다릅니다.
Type: 라이선스 유형이며, 옵션은 프로덕션, 테스트 및 평가판입니다.
Start Date : 라이선스 시작일을 표시합니다.
Expiration Date : 라이선스가 만료되는 날짜를 표시합니다.
Support included: 라이선스에 상업적 지원이 포함되어 있는지 여부를 나타냅니다.
Activation method: 라이선스가 온라인으로 활성화되었는지, 오프라인으로 활성화되었는지, 또는 서버 ID를 기반으로 활성화되었는지 여부를 표시합니다.
License key: 현재 사용중인 라이선스 키
라이선스 사용 :
Lines of code (LOC): 현재 분석 중인 코드 라인 수를 라이선스에서 허용된 총 코드 라인 수 대비로 보여줍니다.
Notifiaction threshold : 이메일 알림을 트리거하는 LOC 임계값을 표시합니다. 라이선스 만료 2개월 전과 1개월 전에 알림이 전송됩니다. 알림 임계값을 변경하려면 'Edit notification threshold을 클릭하세요.
자세한 내용은 LOC 사용량 확인을 참조하세요.
추가 기능 : 조직에서 구매한 모든 추가 기능을 나열합니다. 기능 이름, 시작일 및 만료일, 사용 가능 여부 및 활성화 상태를 보여줍니다.
Server ID 변경
라이선스를 다른 서버 ID를 가진 인스턴스로 이전하려면 현재 인스턴스에서 라이선스를 해제해야 합니다. 자세한 내용은 라이선스 해제를 참조하세요.
라이선스 무효화 시나리오
특정 작업을 수행하면 서버 ID가 변경되어 라이선스 활성화가 무효화됩니다. 다음은 가장 일반적인 몇 가지 사례입니다.
데이터베이스 서버를 다른 IP 주소 또는 DNS 이름을 가진 다른 호스트로 이동, 업그레이드 또는 변경하는 경우.
기존 데이터베이스 서버의 IP 주소 또는 DNS 이름을 변경합니다.
데이터베이스 서버에서 데이터베이스/스키마 이름을 변경하는 방법.
다른 SonarQube 서버 인스턴스에서 데이터베이스 콘텐츠를 복원합니다(프로덕션/스테이징 동기화 제외).
비어있는 데이터베이스에 SonarQube 서버를 재설치하는 방법.
DBCopy 또는 MySQL Migrator를 사용하여 기존 데이터베이스를 새 데이터베이스로 복사합니다.
만약 이러한 시나리오 중 하나를 진행할 계획이고 상업적 지원을 받고 있다면, 사전에 지원 티켓을 열어 실행 계획을 확인하세요.
라이선스 설정 해제
라이선스를 해제하는 작업은 여러 상황에서 필요합니다.
다른 서버 ID를 가진 다른 인스턴스에서 라이선스를 재사용할 경우
현재 인스턴스의 서버 ID를 변경할 때
- 현재 인스턴스에 다른 라이선스를 적용할 때
온라인으로 활성화된 라이선스 설정 해제
온라인으로 활성화된 라이선스를 해제하려면 ' Set a new license' 버튼 옆의 드롭다운 메뉴를 클릭하고 'Unset license '를 선택하세요.
라이선스를 해제하면 로컬 및 라이선스 서버에서 모두 제거되며, 다른 인스턴스에서 다시 사용하거나 현재 인스턴스에 다른 라이선스를 설정할 수 있습니다.
'Set a new license' 버튼을 사용하면 먼저 현재 라이선스가 해제된 다음 새 라이선스가 활성화됩니다.
오프라인에서 활성화된 라이선스 설정 해제
라이선스를 오프라인으로 활성화한 경우, SonarQube UI에서 라이선스 설정을 해제해도 SonarQube 서버가 라이선스 서버에 연결되어 있지 않으므로 라이선스 서버에서 라이선스가 제거되지 않습니다.
라이선스는 로컬에서만 제거되며, 라이선스 서버에서는 여전히 활성화된 상태로 간주됩니다.
라이선스 서버에서 라이선스를 완전히 제거하려면 다음을 참고하세요,
.req 파일을 가져오려면 엔드포인트 를 사용하세요.
POST /api/v2/entitlements/offline-deactivation(시스템 관리자 권한 필요)라이선스 서버에서 설정 해제 : https://offlinelicense.sonarsource.com/
.req에 접속하여 이전 단계에서 가져온 파일을 업로드하세요.
이 프로세스는 라이선스 서버에서 라이선스를 해제하여 다른 서버 ID를 가진 인스턴스에서 다시 활성화할 수 있도록 합니다.
갱신 후와 같이 동일한 인스턴스에 다른 라이선스를 설정해야 하는 경우 SonarQube UI의 'Unset license ' 또는 'Set a new license' 기능을 계속 사용할 수 있습니다.
라이선스 사용자 포털
라이선스가 생성되는 즉시, 귀하의 조직은 라이선스 사용자 포털에 접속할 수 있는 이메일을 받게 되며, 해당 포털에서 사용 가능한 모든 라이선스를 확인할 수 있습니다.
라이선스 사용자 포털에 로그인
Sonar License 사용자 포털은 http://license.sonarsource.com/ 에서 이용할 수 있습니다 .
라이선스 사용자 포털에 액세스하려면 귀하의 이메일 주소가 Sonar에 조직의 라이선스 관리자로 등록되어 있어야 합니다.
사용 가능한 싱글 사인온(SSO) 인증 제공업체 중 하나를 사용하여 로그인하는 것을 권장합니다.
처음 로그인하는 경우이고 SSO 제공업체 대신 이메일 주소를 사용하는 경우, 먼저 계정을 생성하기 위해 가입 해야 합니다.
- 기존 고객 지원 센터 계정 자격 증명은 라이선스 사용자 포털에 접속하는 데에도 유효합니다.
라이선스 상태 확인
라이선스 상태를 확인하려면 다음 단계를 따르세요.
왼쪽 탐색 메뉴에서 'Licenses'를 클릭하면 조직에 할당된 모든 라이선스 목록을 볼 수 있습니다.
라이선스를 선택하고 'Devices' 탭으로 이동하세요.
- 'Devices' 탭에는 SonarQube 서버 인스턴스 목록이 표시됩니다.
- 'Status' 열에는 해당 인스턴스의 라이선스 상태( Active 또는 Inactive) 가 표시됩니다 .
- 'Hardware ID' 열에는 SonarQube 서버의 서버 ID가 표시됩니다.
라이선스 키가 작동하지 않을때
라이선스 키가 작동하지 않는 경우 다음 정보를 포함하여 contact@sonarsource.com으로 이메일을 보내주세요.
서버 ID는 Administration > System에서 찾을 수 있습니다.
SonarQube 서버 버전은 Administration > System에서 확인할 수 있습니다 .
어떤 기존 라이선스(프로덕션 또는 스테이징)와 서버 ID를 대체하는지 명확히 하세요.
기존 라이선스의 상태를 확인하세요,