Document toolboxDocument toolbox

13.1 Jira


Jira를 관리하기 위한 화면을 제공한다. Host 하위의 Atlassian Server에서 Jira의 생성, 수정, 삭제가 가능하며, 상태조회와 시작/종료를 수행할 수 있다.


참고

Playce WASup이 지원하는 Jira 버전은 8.5.2 이다.


내용




Jira 생성


Jira를 생성하려면 다음과 같이 진행한다.

1. [Create Server > Jira] 버튼을 클릭하여 Jira 정보 등록을 준비한다.

2. Jira의 속성을 입력한다.

3. [Save] 버튼을 클릭하여 저장한다.


참고

Jira는 Host에서 Engine 설치 과정을 거치지 않고 Jira 생성 시 자동적으로 Engine이 설치된다. 1개의 Host에는 1개의 Jira만 설치 가능하다. 


Jira의 주요 설정 값은 다음과 같다. 기호 * 는 필수값이다.

항목설명비고
Server Name *Server의 이름
  • 32자로 제한되며, 영숫자 및 일부 기호(-_ .=)만 가능
HostServer 엔진이 설치된 호스트의 이름
EngineServer에서 사용되는 엔진의 이름
  • 기본값 "Atlassian-Jira"
  • 수정 불가
Version *Server에서 사용되는 엔진의 버전
Install Path *Server에서 사용되는 엔진 설치 경로
  • 기본값 "/opt/wasup/servers/{Server Name}"
  • '/' 로 시작해야 하며, 영숫자 및 기호(- _ . ~ + # %)만 가능 
Jira의 동작 방법을 정의하는 데 필요한 주요 데이터가 저장되는 Jira 홈 디렉토리
  • 기본값 "/opt/wasup/servers/jira-home"
  • '/' 로 시작해야 하며, 영숫자 및 기호(- _ . ~ + # %)만 가능
Server를 시작할 때 사용하는 Java 홈 디렉토리
  • '/' 로 시작해야 하며, 영숫자 및 기호(- _ . ~ + # %)만 가능
Jira 구동 사용자 이름
  • 기본값 "wasup"
Java Heap Minimum Size (MB) *JVM의 최소 Heap 메모리
  • 기본값 "384"
Java Heap Maximum Size (MB) *JVM의 최대 Heap 메모리
  • 기본값 "2048"
Server LinkJira에 접근할 때 사용하는 URL 주소
  • 기본값 "http://{IP Address}:8080"
DescriptionServer에 대한 설명
  • 255자로 제한
Target 를 사용하여 Jira의 실시간 모니터링 정보를 수집 및 분석



Jira 수정

1. Atlassian Server 중 수정할 Jira를 선택한다.

2. [Action > Edit] 버튼을 클릭하여 선택한 Jira를 수정한다.

3. Server Name과 각 속성 정보를 원하는 값으로 수정한다.

[수정 가능한 항목] Server Name, Java Home, Jira Run User, Java Heap Minimum Size (MB), Java Heap Maximum Size (MB), Server Link, Description, Target 

4. 수정을 완료하면 [Save] 버튼을 클릭하여 저장한다.



Jira 삭제

1. Atlassian Server 중 삭제할 Jira를 선택한다.

2. [Action > Delete] 버튼을 클릭하여 Jira를 삭제한다.

3. 삭제 가능한 상태일 경우에만 [Delete] 버튼이 활성화 된다.


중요

Jira가 기동중일 경우 삭제할 수 없으며, 삭제 가능한 상태일 경우에만 [Delete] 버튼이 활성화 된다.



Jira 설정 관리

Atlassian Server 목록에서 Jira의 Server Name을 선택하면 상세조회 및 설정 정보를 변경하는 기능을 제공, 설정 파일의 버전별 비교 및 복원이 가능하다. 

Jira 하위에 Scouter Java Agent가 존재하는 경우, Scouter Java Agent 탭이 생성되어 Config File 관리가 가능하다. 

또한 사용자가 원하는 Config 파일을 직접 생성하고 관리할 수 있다.


중요

Jira 설정을 변경할 경우 수정된 사항의 반영을 위하여 Jira의 재기동이 필요하다.




1) General

Jira의 등록 정보는 Jira 상세조회 시 상단영역에 표시된다. 우측 상단의 [버튼을 클릭하면 수정 화면이 출력된다.


하단영역에는 Jira를 모니터링 하고 있는 Scouter Java Agent의 정보가 표시된다. 


2) Config File 

Jira의 Config File은 탭으로 구분되어 파일편집기를 통해 관리할 수 있다.


Jira의 제공되는 Config File은 다음과 같다. 

항목설명
setenv.shJVM size, Catalina log, Java_home, Scouter setting 등
user.shJira User 설정
server.xmlJira Application Server 설정
jira-application.propertiesJira Application Home 설정
seraph-config.xml보안 및 인증 관련 설정
crowd.propertiesJira의 Crowd 설정
dbconfig.xmlJira Database 설정



Config 파일을 수정하려면 다음과 같이 진행한다.

1. 조회된 화면에서 우측 상단의 [버튼을 클릭하면 파일을 편집할 수 있는 Edit Mode로 변환된다. 

2. 수정을 완료하면 [] 버튼을 클릭하여 저장한다.

3. 저장을 완료하면 Config 파일의 새로운 버전이 생성된다.


Config 파일의 버전별 비교 및 복원하려면 다음과 같이 진행한다.

1. Selected Version을 선택한다. 

2. Compared Version을 선택한다. 

3. 비교할 버전을 선택 완료하면 우측 상단의 [Compare] 버튼을 클릭한다.

4. Compare Config File 팝업창이 출력되어 선택한 버전의 파일 정보를 볼 수 있다. 설정 파일 비교 결과는 두개 버전을 동시에 볼 수 있는 [Split View]를 디폴트로 제공한다.

5. [Unified View] 로도 변환하여 확인 가능하다.

6. 복원하고자 하는 버전의 옆에 [Restore] 버튼을 클릭하면 해당 설정파일로 복원할 수 있다. 복원 시 Config 파일의 새로운 버전이 생성된다.


중요

Jira의 설정 파일 수정 및 제어를 Script 파일에서 직접 수행할 경우 사용자가 잘못된 내용을 입력할 수 있으므로 주의해야 한다. Playce WASup은 모든 작업들을 Manager를 통해 수행할 것을 권장한다.  


3) 사용자 정의 Config File

제공되는 Config File 외 사용자가 Config File이 추가로 필요할 경우, Config 파일을 사용자가 직접 생성하고 관리할 수 있다.


Config 파일을 생성하려면 다음과 같이 진행한다.

1. 조회된 화면에서 마지막 탭 우측의 [Add New +] 버튼을 클릭하면 Add Config File 팝업창이 출력된다. 

2. File Path를 클릭하여 Install Path 또는 Jira Home 중 1개를 선택하여 경로를 지정한다.

 

3. 선택된 File Path 다음으로 해당되는 Path를 입력하고 [Check File] 버튼을 클릭하여 Config 파일의 존재유무를 확인한다.

4. 파일이 존재 시에는 하단의 File Content 영역에 해당 내용을 표시해주며, 사용자는 이를 수정할 수 있다. 또한 파일이 존재하지 않을 경우에는 File Content 영역에 사용자가 신규로 작성할 수 있다.

5. File Content 작성이 완료하면 [Save] 버튼을 클릭하여 사용자정의 탭을 생성한다. 

6. 사용자가 생성한 탭에 대해서는 수정, 삭제가 가능하다.


참고

사용자가 생성한 탭을 삭제할 경우, 탭은 삭제되나 Config 파일 자체는 삭제되지 않는다.





Jira에 Scouter 연동

Jira에 Scouter Server를 연동하여 Jira의 실시간 모니터링이 가능하며, 연동된 Scouter Server의 설정파일을 관리할 수 있다.


Jira에 Scouter Server를 연동하려면 다음과 같이 진행한다.

1. [Create Server > Jira] 버튼을 클릭한다. 

2. 하단의 Target Scouter Server를 선택하면 Scouter Java Agent를 실행하여 Jira에 대한 모니터링이 가능하다.

[Target Scouter Server 표시 기준] IP Address : TCP Port

3. [Save] 버튼을 클릭하여 저장한다.


Jira에 연동된 Scouter Server가 존재하는 경우, Jira 상세조회 시 Scouter Java Agent 탭이 표시되며 Scouter Server의 Config File 관리가 가능하다. 


Scouter Java Agent의 제공되는 Config File은 다음과 같다. 

항목설명
scouter.confScouter Server의 포트 및 기본 설정
capture.plughook_args_patterns나 hook_constructor_patterns등을 통해 설정됨. method에 대해 해당 method의 시작 시점, 종료시점, Constructor 생성 시점에 호출됨
counter.plug성능카운터 정보에 대한 전처리 plugin
httpcall.plugHttpClient 등을 통해 http call을 사용하는 시점에 호출됨
httpservice.plugHttp Service 시작점, Http Service이 종료시점에 호출됨. 특정 Service는 사용자가 정의한 조건에 따라 reject할 수 있는 기능을 제공
jdbcpool.plugDB connection URL 요청 시점에 호출됨
service.plugService의 시작점, 종료 시점에 호출됨 (hook_service_patterns를 통해 설정된 서비스가 대상이 됨)
springControllerCapture.plugSpring Controller에 해당하는 URL 요청시 호출됨



Jira에 연동된 Scouter Server의 Config File 관리는 다음과 같이 진행한다. 

1. Scouter Java Agent 탭을 클릭하면 하위에 해당되는 탭이 조회된다.

2. 각 탭에서 파일편집기를 통해 Config 파일을 편집할 수 있다.

3. 또한 Config 파일의 버전별 비교 및 복원도 가능하다.





Jira 제어

  • [Action > Start] 버튼을 클릭하여 Jira를 시작한다. 

  • [Action > Stop - Force] 버튼을 클릭하여 Jira를 종료한다. 

  • [Action > Shutdown - Gracefully] 버튼을 클릭하여 Jira를 안전하게 종료한다. 

  • [Action > Restart - Force] 버튼을 클릭하여 Jira를 강제 재시작한다. 


참고

[Start], [Stop - Force], [Shutdown - Gracefully], [Restart]  버튼 모두 가능한 상태일 경우에만 버튼이 활성화 된다. 

  • [Start] 버튼은 Jira가 Stopped 상태일 때만 실행 가능
  • [Stop - Force], [Shutdown - Gracefully버튼은 Jira가 Running 상태일 때만 실행 가능
  • [Restart] 버튼은 Jira가 Running, Stopped 상태 모두 실행 가능




Jira 바로가기

1 . Atlassian Server 목록에서 [Jira ] 버튼을 클릭한다.

2. Server Link에 입력된 주소로 접근하여 Jira를 사용할 수 있다.





Log View

1 . Atlassian Server 목록에서 Jira의 [View] 버튼을 클릭하면 확인 가능한 Log 파일의 목록이 표출된다.

2. Log 파일을 확인할 수 있는 Log View 팝업창이 출력된다. 





13. Atlassian 제품 설치
13.2 Confluence


Copyright © 2021 Open Source Consulting, Inc. All Rights Reserved.