Crowd 생성
Crowd를 생성하려면 다음과 같이 진행한다.
1. [Create Server > Crowd] 버튼을 클릭하여 Crowd 정보 등록을 준비한다.
2. Crowd의 속성을 입력한다.
3. [Save] 버튼을 클릭하여 저장한다.
| Note | ||
|---|---|---|
| ||
Crowd는 Host에서 Engine 설치 과정을 거치지 않고 Crowd 생성 시 자동적으로 Engine이 설치된다. 1개의 Host에는 1개의 Crowd만 설치 가능하다. |
Crowd의 주요 설정 값은 다음과 같다. 기호 * 는 필수값이다.
항목 | 설명 | 비고 |
|---|---|---|
Server Name * | Crowd의 이름 |
|
Host | Crowd 엔진이 설치된 호스트의 이름 | |
Engine | Crowd에서 사용되는 엔진의 이름 |
|
Version * | Crowd에서 사용되는 엔진의 버전 | |
Install Path * | Crowd에서 사용되는 엔진 설치 경로 |
|
Crowd의 동작 방법을 정의하는 데 필요한 주요 데이터가 저장되는 Crowd 홈 디렉토리 |
| |
Crowd를 시작할 때 사용하는 Java 홈 디렉토리 |
| |
Crowd 구동 사용자 이름 |
| |
Java Heap Minimum Size (MB) * | JVM의 최소 Heap 메모리 |
|
Java Heap Maximum Size (MB) * | JVM의 최대 Heap 메모리 |
|
Server Link | Crowd에 접근할 때 사용하는 URL 주소 |
|
Description | Crowd에 대한 설명 |
|
Target | 를 사용하여 Crowd의 실시간 모니터링 정보를 수집 및 분석 |
Crowd 수정
1. Atlassian Server 중 수정할 Crowd를 선택한다.
2. [Action > Edit] 버튼을 클릭하여 선택한 Crowd를 수정한다.
3. Server Name과 각 속성 정보를 원하는 값으로 수정한다.
[수정 가능한 항목] Server Name, Java Home, Crowd Run User, Java Heap Minimum Size (MB), Java Heap Maximum Size (MB), Server Link, Description, Target
4. 수정을 완료하면 [Save] 버튼을 클릭하여 저장한다.
Crowd 삭제
1. Atlassian Server 중 삭제할 Crowd를 선택한다.
2. [Action > Delete] 버튼을 클릭하여 Crowd를 삭제한다.
3. 삭제 가능한 상태일 경우에만 [Delete] 버튼이 활성화 된다.
| Warning | ||
|---|---|---|
| ||
Crowd가 기동중일 경우 삭제할 수 없으며, 삭제 가능한 상태일 경우에만 [Delete] 버튼이 활성화 된다. |
Crowd 설정 관리
Atlassian Server 목록에서 Crowd의 Server Name을 선택하면 상세조회 및 설정 정보를 변경하는 기능을 제공, 설정 파일의 버전별 비교 및 복원이 가능하다.
Crowd 하위에 Scouter Java Agent가 존재하는 경우, Scouter Java Agent 탭이 생성되어 Config File 관리가 가능하다.
또한 사용자가 원하는 Config 파일을 직접 생성하고 관리할 수 있다.
| Warning | ||
|---|---|---|
| ||
Crowd 설정을 변경할 경우 수정된 사항의 반영을 위하여 Crowd의 재기동이 필요하다. |
1) General
Crowd의 등록 정보는 Crowd 상세조회 시 상단영역에 표시된다. 우측 상단의 [
] 버튼을 클릭하면 수정 화면이 출력된다.
하단영역에는 Crowd를 모니터링 하고 있는 Scouter Java Agent의 정보가 표시된다.
2) Config File
Crowd의 Config File은 탭으로 구분되어 파일편집기를 통해 관리할 수 있다.
Crowd의 제공되는 Config File은 다음과 같다.
| 항목 | 설명 | |
|---|---|---|
| setenv.sh | JVM size, Catalina log, Java_home, Scouter setting 등 | |
| catalina.sh | ||
| server.xml | Crowd Application Server 설정 | |
| crowd-init.properties | Crowd Application Home 설정 | |
| log4j.properties | ||
| crowd.cfg.xml | Crowd의 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 파일의 새로운 버전이 생성된다.
| Warning | ||
|---|---|---|
| ||
Crowd의 설정 파일 수정 및 제어를 Script 파일에서 직접 수행할 경우 사용자가 잘못된 내용을 입력할 수 있으므로 주의해야 한다. Playce WASup은 모든 작업들을 Manager를 통해 수행할 것을 권장한다. |
3) 사용자 정의 Config File
제공되는 Config File 외 사용자가 Config File이 추가로 필요할 경우, Config 파일을 사용자가 직접 생성하고 관리할 수 있다.
Config 파일을 생성하려면 다음과 같이 진행한다.
1. 조회된 화면에서 마지막 탭 우측의 [Add New +] 버튼을 클릭하면 Add Config File 팝업창이 출력된다.
2. File Path를 클릭하여 Install Path 또는 Crowd Home 중 1개를 선택하여 경로를 지정한다.
3. 선택된 File Path 다음으로 해당되는 Path를 입력하고 [Check File] 버튼을 클릭하여 Config 파일의 존재유무를 확인한다.
4. 파일이 존재 시에는 하단의 File Content 영역에 해당 내용을 표시해주며, 사용자는 이를 수정할 수 있다. 또한 파일이 존재하지 않을 경우에는 File Content 영역에 사용자가 신규로 작성할 수 있다.
5. File Content 작성이 완료하면 [Save] 버튼을 클릭하여 사용자정의 탭을 생성한다.
6. 사용자가 생성한 탭에 대해서는 수정, 삭제가 가능하다.
| Note | ||
|---|---|---|
| ||
사용자가 생성한 탭을 삭제할 경우, 탭은 삭제되나 Config 파일 자체는 삭제되지 않는다. |
Crowd에 Scouter 연동
Crowd에 Scouter Server를 연동하여 Crowd의 실시간 모니터링이 가능하며, 연동된 Scouter Server의 설정파일을 관리할 수 있다.
Crowd에 Scouter Server를 연동하려면 다음과 같이 진행한다.
1. [Create Server > Crowd] 버튼을 클릭한다.
2. 하단의 Target Scouter Server를 선택하면 Scouter Java Agent를 실행하여 Crowd에 대한 모니터링이 가능하다.
[Target Scouter Server 표시 기준] IP Address : TCP Port
3. [Save] 버튼을 클릭하여 저장한다.
Crowd에 연동된 Scouter Server가 존재하는 경우, Crowd 상세조회 시 Scouter Java Agent 탭이 표시되며 Scouter Server의 Config File 관리가 가능하다.
Scouter Java Agent의 제공되는 Config File은 다음과 같다.
| 항목 | 설명 |
|---|---|
| scouter.conf | Scouter Server의 포트 및 기본 설정 |
| capture.plug | hook_args_patterns나 hook_constructor_patterns등을 통해 설정됨. method에 대해 해당 method의 시작 시점, 종료시점, Constructor 생성 시점에 호출됨 |
| counter.plug | 성능카운터 정보에 대한 전처리 plugin |
| httpcall.plug | HttpClient 등을 통해 http call을 사용하는 시점에 호출됨 |
| httpservice.plug | Http Service 시작점, Http Service이 종료시점에 호출됨. 특정 Service는 사용자가 정의한 조건에 따라 reject할 수 있는 기능을 제공 |
| jdbcpool.plug | DB connection URL 요청 시점에 호출됨 |
| service.plug | Service의 시작점, 종료 시점에 호출됨 (hook_service_patterns를 통해 설정된 서비스가 대상이 됨) |
| springControllerCapture.plug | Spring Controller에 해당하는 URL 요청시 호출됨 |
Crowd에 연동된 Scouter Server의 Config File 관리는 다음과 같이 진행한다.
1. Scouter Java Agent 탭을 클릭하면 하위에 해당되는 탭이 조회된다.
2. 각 탭에서 파일편집기를 통해 Config 파일을 편집할 수 있다.
3. 또한 Config 파일의 버전별 비교 및 복원도 가능하다.
Crowd 제어
- [Action > Start] 버튼을 클릭하여 Crowd를 시작한다.
- [Action > Stop - Force] 버튼을 클릭하여 Crowd를 종료한다.
- [Action > Shutdown - Gracefully] 버튼을 클릭하여 Crowd를 안전하게 종료한다.
- [Action > Restart - Force] 버튼을 클릭하여 Crowd를 강제 재시작한다.
| Note | ||
|---|---|---|
| ||
[Start], [Stop - Force], [Shutdown - Gracefully], [Restart] 버튼 모두 가능한 상태일 경우에만 버튼이 활성화 된다.
|
Crowd 바로가기
1 . Atlassian Server 목록에서 [Crowd 
] 버튼을 클릭한다.
2. Server Link에 입력된 주소로 접근하여 Crowd를 사용할 수 있다.
Log View
1 . Atlassian Server 목록에서 Crowd의 [View
] 버튼을 클릭하면 확인 가능한 Log 파일의 목록이 표출된다.
2. Log 파일을 확인할 수 있는 Log View 팝업창이 출력된다.
