1.3.4.8 on LENA Docs

Installation

Mon, 01 Jan 0001 00:00:00 +0000

Installation

1. Overview

본문서는 일반적인 VM Host 기반 LENA Server를 운영하기 앞서 설치에 대해 기술한다. LENA 의 전체 기능 및 운영에 대한 내용은 별도로 제공되는 운영자 매뉴얼을 참고한다.

본 문서는 LENA 1.3.4.8 버전을 기준으로 기술하고, 다음과 같은 내용을 포함한다.

LENA 설치
- Linux 기반
- Windows 기반

1.1. 구성요소

LENA는 Web Server, WAS(Web Application Server), Session Server와 Web Server의 Status를 확인하고 제어하는 역할인 Node Agent, Application Server에 설치되어 Status정보를 제공하는 Advertiser와 관리자에게 제공되는 통합관리 도구인 Manager로 구성된다.

1.1.1. Server

LENA에서 제공되는 서버의 종류는 Web Server, Application Server, Session Server 3가지가 있다. 각 서버의 용도는 아래와 같다.

Web Server: 사용자 요청에 따라 Web Resource를 제공한다. Application Server가 제공하는 응용서비스의 Front역할을 수행하면서, 선택적으로 Load Balancing 및 보안 레이어(SSL)를 제공하는 역할을 수행한다.
Application Server: Java로 작성된 응용 서비스를 실행/제공 한다.
Session Server: Application Server간 사용자의 세션을 유지한다.

1.1.2. Agent, Advertiser

Node, Server에 설치되어 제어 및 모니터링 기능을 담당하는 Agent 이다.

Node Agent
- Web Server 상태 모니터링 데이터를 취합하여 Manager에게 제공한다.
Advertiser
- Application Server 상태 모니터링 데이터를 취합하여 Manager에게 제공한다.

1.1.3. Manager

Manager는 Node Agent와 Advertiser를 통하여 Node와 Server의 제어 및 모니터링 기능 등을 제공하는Web Application이다. 대표적으로 아래와 같은 기능을 제공한다.

Table 1. LENA Manager 주요 기능
항목	설명
Dashboard	Server, Server Cluster 현황 Notification 확인
Server	System (논리적 Server 그룹) 등록/수정/삭제
Server Cluster	Server Cluster 등록/수정/삭제 Server Cluster 에 등록할 Server 등록/삭제 Server Cluster 에 등록한 Server 설정 비교 및 동기화 Server Cluster 설정 백업 및 복원을 위한 Snapshot Server Cluster 에 등록한 Server 들의 Graceful Restart
Resource	Resource의 조회 및 등록/수정/삭제 Database / DataSource / MessageService(JMS) / Transaction(JTA) / Application / LoadBalancer(SLB) Resource를 사용하는 Server 목록 조회 및 등록/수정/삭제
Diagnostics + (모니터링)	Server에 대한 이슈 현황 모니터링 기능 Server에서 발생한 Event 조회 기능
Topology	System별 Server 구성현황 조회
Admin	사용자 및 권한 관리, 사용자/권한/메뉴 매핑 사용자 운영 이력 조회 라이선스 관리, 현황 조회 및 업로드

LENA는 Manager를 통해서 Web Server/WAS를 모니터링 및 통합관리하는 기능을 제공한다. 이를 위해 Node라는 단위로 Agent가 설치되는데 이를 Node Agent라고 한다. Node Agent는 Manager의 사용자 명령을 전달받아 Node에 설치된 Web Server/WAS를 제어하며 Node가 설치된 Host/VM, Web Server 의 모니터링 정보를 Manager로 전송한다.

Figure 1. LENA Manager의 모니터링 및 통합관리의 작동방식

LENA Manager, Web Server, WAS 외에도 Manager의 동작을 위해 사용되는 Manager Repository, Session Clustering을 위한 Sesssion Server, WAS의 모니터링 정보 수집을 위한 Advertiser가 작동하여 Manager를 통한 모니터링 및 통합관리가 가능하도록 한다.

항목	설명
Manager	서버에 배포되는 설정파일 관리 및 Server 모니터링 기능 제공
Manager Repository	Manager 운영을 위한 파일저장 Repository, 각종 설정정보 및 DB 정보를 포함함
Node Agent	Web 서버 모니터링 데이터 취합 및 Manager에게 송신, Manager로부터 수신한 제어/설정 명령 실행
Application Server	Application Server Instance
Web Server	Web Server Instance
Session Server	Session Server Instance
Advertiser	모니터링 데이터 취합 및 Manager에게 송신(Application Server에 통합)

항목

설명

Manager

서버에 배포되는 설정파일 관리 및 Server 모니터링 기능 제공

Manager Repository

Manager 운영을 위한 파일저장 Repository, 각종 설정정보 및 DB 정보를 포함함

Node Agent

Web 서버 모니터링 데이터 취합 및 Manager에게 송신, Manager로부터 수신한 제어/설정 명령 실행

Application Server

Application Server Instance

Web Server

Web Server Instance

Session Server

Session Server Instance

Advertiser

모니터링 데이터 취합 및 Manager에게 송신(Application Server에 통합)

2. Installation Prerequisite

2.1. 시스템 요구사항

2.1.1. Hardware Resource

CPU
전적으로 구동하고자 하는 Web Application이 어느 정도의 성능을 요구하는지에 달려있다. 기본적인 LENA 서비스 구동에 필요한 CPU는 2 Core 이상을 권고한다.
Memory
Memory에 대해서는 아래 표를 참조한다. Web Server를 제외한 모든 Module은 JVM 기반으로 동작하므로 Heap Memory를 사용한다. LENA에서는 기본 Heap Memory 값을 미리 설정해 놓았으며, 설치 시에 해당 값으로 설치되나 필요에 따라 수정이 가능하다. 안정적인 운영을 위해 하나의 물리적 서버에 설치될 모든 모듈의 Heap Memory 설정 값의 합이 물리 서버의 잔여 메모리 용량보다 크지 않도록 유의한다.

LENA Manager 및 각 Server 설치에 대한 최소 요구사항은 다음과 같다.

구분	JVM	Disk Space	최소 Memory	기본 Memory
Manager	JDK 1.8 +	약 300 MB	512 MB	1 GB
Node Agent	JDK 1.8 +	약 300 MB	64 MB	256 MB
Application Server	JDK 1.8 +	약 100 MB	512 MB	2 GB
Web Server	JDK 1.8 +	약 100 MB	512 MB	-
Session Server	JDK 1.8 +	약 100 MB	512 MB	1 GB

구분

JVM

Disk Space

최소 Memory

기본 Memory

Manager

JDK 1.8 +

약 300 MB

512 MB

1 GB

Node Agent

JDK 1.8 +

약 300 MB

64 MB

256 MB

Application Server

JDK 1.8 +

약 100 MB

512 MB

2 GB

Web Server

JDK 1.8 +

약 100 MB

512 MB

Session Server

JDK 1.8 +

약 100 MB

512 MB

1 GB

각 Server 설치 시 기본 Memory 기준으로 설치 되며, Memory 설정은 최소 Memory 이상으로 설정값을 변경하여 적용할 수 있다.

2.1.2. 운영체제

Linux
Redhat (RHEL, CentOS) 6.5 이상 / Ubuntu 12.04 이상을 지원하며 가장 권고하는 운영체제이다. 일반적인 x86 아키텍처의 특성에 맞도록 대용량 통합서버 구성보다는 저용량 다수의 서버에 분산 설치하는 것을 권장한다.
Windows
Windows 7 이상을 지원한다. Linux/Unix와 달리 Windows 특성에 따라 LENA Module을 Background로 띄우기 위해 Windows Service 등록 기능을 제공한다. 그렇지 않으면 LENA Module이 항상 Foreground로 실행된다.

Linux/Unix에서는 기본적으로 LENA Module을 실행시키기 위한 스크립트를 제공한다.
만약 OS Service로 등록이 필요할 시 서버 담당자가 OS 환경에 맞게 직접 설정해야 한다.

Unix
Solaris, HP-UX, AIX를 지원한다. Unix의 경우 Linux/Windows와 달리 신규 버전 및 Patch가 기본 제공되지 않으며, 필요 시 해당 OS의 버전 별 개별 검토를 통해 제작 및 배포되며 이는 통상적으로 약 2주의 소요시간이 필요하다.

2.1.3. 계정

LENA를 설치하기 전 LENA 설치 및 기동에 이용할 계정이 필요하다. 적합한 이유가 없다면 보안 상 Root / Administrator 계정은 권고되지 않으며 이를 통해 LENA를 실행시킬 수 없으니 별도의 계정을 미리 생성하도록 한다.

X86 아키텍처에서 권고되는 바는 아니지만, 만약 한 물리 서버에 서로 다른 다수의 업무 시스템이 운영되고 각 시스템 별로 담당 운영자가 구분되며 시스템 간 접근 통제를 위해 계정을 분리하여 사용한다고 가정하자. 이런 경우 운영자 계정 별(업무 시스템 별)로 Node를 설치/구성 하여 운영해야 하며 LENA Manager 또한 시스템 별로 구성하는 것을 권고한다.

2.1.4. 디렉토리

LENA 설치를 진행하기에 앞서 이전 단계에서 생성한 계정이 이용 가능한 설치 디렉토리를 준비하여야 한다. 아래 표는 LENA에서 제안하는 디렉토리 구성이며 사용자 별로 정책에 맞는 디렉토리 구성을 이용하면 된다. 아래 표는 Linux/Unix 기준으로 설명되었으나 Windows의 경우 C: 하위에 동일하게 디렉토리를 구성한다.

Table 2. Directory Requirement
구분	Directory	비고
LENA WAS Node(Binary)	/engn001/lena
LENA WEB Node(Binary)	/engn001/lenaw
Web Server, WAS Log	/logs001	log경로 분리 필요 시 설정
Web Application Source	/sorc001

고려할 사항은 log 파일을 분리할 것인지 여부이다. log는 별도 분리 설정하지 않으면 LENA Node 가 설치되는 경로 하위에 기본 생성된다. log 확인을 손쉽게 하면서도 Disk 용량 관리를 편하게 하기 위해서는 log 디렉토리의 분리를 권장한다.

가능하다면 별도 외장 disk 볼륨을 Node, log, source 디렉토리에 Mount하여 OS System 영역과 격리하는 것을 권장한다.

2.1.5. JVM

JDK의 경우 LENA 설치 진행하기 전 별도 Binary 형태로 혹은 OS에서 제공하는 Package 설치 관리자를 통해 설치가 되어 있어야 한다.

LENA 버전	EN(Engine No)	JDK버전(LTS)	JAVA EE Spec	Servlet Spec
1.3.4.X	7	JDK 6 (1.6.x+), 7 (1.7.x+), 8 (1.8.x+)	6	3.0
	8	JDK 8 ( 1.8.x+), 11	7	3.1
	*9 (Default)*	*JDK 8 (1.8.x+), 11, 17, 21*	8	*4.0*
	10	JDK 11, 17, 21	10 (Servlet)	6.0
1.3.3.X	7	JDK 6 (1.6.x+), 7 (1.7.x+), 8 (1.8.x+)	6	3.0
	8	JDK 8 ( 1.8.x+), 11	7	3.1
	*9 (Default)*	*JDK 8 (1.8.x+), 11, 17, 21*	8	*4.0*
	10	JDK 11, 17, 21	10 (Servlet)	6.0
1.3.2.X	7	JDK 6 (1.6.x+), 7 (1.7.x+), 8 (1.8.x+)	6	3.0
	*8 (Default)*	*JDK 8 ( 1.8.x+), 11*	7	*3.1*
	9	JDK 8 (1.8.x+), 11, 17	8	4.0
	10	JDK 11, 17	10 (Servlet)	6.0
1.3.1.X	N/A	JDK 8 (1.8.x+), JDK 11	7	-
1.3.0.X	N/A	JDK 8 (1.8.x+), JDK 11	7	-

OracleJDK의 경우 8u202 버전 까지만 무료로 이용할 수 있다.

2.1.6. Network

아래 다이어그램은 LENA의 각 Module간 트래픽의 흐름을 나타낸 도표이다. LENA Management 관련 경로와 Web Service 관련 경로가 상세히 표현되어있다.

Figure 2. LENA Network Traffic

위 다이어그램에 표현된 LENA 모듈간 트래픽 경로와 사용 Port는 아래 표와 같다. 명시된 Port 번호는 사전 정의된 기본값이며 각 Module 설치 시 별도로 지정할 수 있다. 아래 표를 참고하여 Port를 선정한 뒤, 사전에 방화벽을 Open 해 놓아야 한다.

LENA에서 사용하는 Port는 보안 요건 상 1025이상의 Port를 이용한다. 단, 서비스 제공 시 80 Port 등의 Well-known Port를 이용해야 한다면 부록에서 제공되는 80포트 이용 가이드를 참고한다.

Table 3. LENA Firewall Open Rule
Src	Dest	Protocol	Port	비고
운영자	LENA Manager	TCP	7700	Manager Web UI 접속
LENA Manager	WEB Node Agent	TCP	16900	WEB Node 제어
LENA Manager	WAS Node Agent	TCP	16800	WAS Node 제어
WEB Node Agent	LENA Manager	UDP	16100	모니터링 정보 송신
WAS Node Agent
WAS Advertiser
Session Server
유저/운영자	Web Server	HTTP	8000	WEB 서비스 접속
유저/운영자	Web Server	HTTPS	*8363*	WEB 서비스 보안(SSL) 접속 (HTTP + 363 / 수정가능)
운영자	WAS	HTTP	8080	WAS 서비스 접속
Web Server	WAS	AJP	*8009*	Web Server-WAS 연계 (HTTP - 71 / 수정가능)
WAS	Session Server	TCP	5180	Session Clustering
Session Server	Session Server	TCP	5180	Session Clustering
WAS	DB	TCP	3306	WAS JDBC 접속

LENA는 Web Server / WAS 설치 시 HTTP Port를 지정하여 설치하도록 하고있다. 이 HTTP Port를 기준으로 HTTPS 포트와 같은 Server 동작을 위한 다른 Port를 자동계산하여 설치하는데 그 예시가 위 표에서 이탤릭 체로 표시된 포트이다. 따라서, Web Server, WAS를 다수 설치하는 과정에서 이미 사용된 다른 Port 와의 충돌을 방지하기 위해서 1과 10의 자리는 Web Server나 WAS 별로 동일하게, 100의 자리는 변경하여 설치하는 것을 권장한다.

Table 4. IP가 같은 장비에 Web Server, WAS 설치 시 HTTP Port 설정 예시
구분	Server 명	HTTP Port	비고
WAS	ee_01	8080	-
WAS	ee_02	8180	ee_01의 HTTP Port 값 + 100
Web	web_01	7180	-
Web	web_02	7280	web_01의 HTTP Port 값 + 100

또한 Dynamic Port Range를 전체 Port 범위로 사용하지 말 것을 권고한다. LENA 기동에 필요한 Port를 OS의 다른 Service가 Source Port로 점유하는 일이 발생할 가능성이 있다.

3. Installation

3.1. LENA 설치

LENA 설치파일을 대상 서버의 준비된 디렉토리에 업로드한다. 설치파일을 통해 LENA Manager를 설치하고자 하는 Server에 LENA Manager를 설치하고 Web Server를 설치할 Server에 Web Server Node를, WAS를 설치할 Server에 WAS Node를 설치한다.

LENA 설치를 진행 하기에 앞서 운영자메뉴얼의 JVM 항목을 참조하여 JDK를 미리 설치하도록 한다.

Node의 설치 후 Web Server와 WAS의 설치는 LENA Manager의 Web UI를 통해서 설치한다. LENA 설치 파일은 제품 구분과 용도에 따라 다음과 같이 구분된다.

Table 5. LENA 설치 파일 구분 (OS: Linux/Windows 64bit / LENA: 1.3.4.8 기준)
제품 구분(Edition)	OS 구분	설치 파일	비고
Enterprise	Linux	lena-enterprise-linux_na_x86_64-1.3.4.8.tar.gz	LENA Manager, WAS 설치용
Enterprise	Windows	lena-enterprise-win_na_x86_64-1.3.4.8.zip
Standard	Linux	lena-standard-linux_na_x86_64-1.3.4.8.tar.gz
Standard	Windows	lena-standard-win_na_x86_64-1.3.4.8.zip
-	Linux	lena-web-linux_na_x86_64-1.3.4.8.tar.gz	Web Server 설치용
-	Windows	lena-web-win-na_x86_64-1.3.4.8.zip	Web Server 설치용

Enterprise Edition과 Standard Edition의 차이는 운영자 매뉴얼의 Server Module을 참고한다.

Linux와 Windows 에서의 LENA 설치는 큰 흐름에서는 동일한 방식으로 진행된다. 본 문서에서는 Linux를 기준으로 설명한다.

3.1.1. LENA Manager 설치/실행

LENA 설치 패키지는 압축파일 형식으로, 설치할 서버에 업로드 후에 압축을 해제하여 사용한다. LENA Manager는 WAS Node 설치파일에 포함되어 있으며 설치할 경로(예: /engn001/lena)에 설치파일을 업로드 후 압축을 푼다.

LENA Manager는 WAS Node 설치파일에 포함되어 있다.

설치 경로 및 설치 파일 업로드 확인

 [lena]# cd /engn001/lena
 [lena]# ll
 -rw-rw-r-- 1 lena lena lena-enterprise-linux_na_x86_64-1.3.4.8.tar.gz

압축 해제 시 설치파일의 확장자 부분을 제외한 나머지 이름으로 디렉토리가 생성되는데
이 디렉토리 명을 1.3 으로 간략하게 변경하여 사용한다.

설치 파일 압축 해제 / 디렉토리 명 변경

 [lena]# tar -xvzf lena-enterprise-linux_na_x86_64-1.3.4.8.tar.gz
 [lena]# mv lena-enterprise-linux_na_x86_64-1.3.4.8 1.3
 [lena]# ll
 drwxr-xr-x 12 lena lena 1.3
 -rw-rw-r-- 1 lena lena lena-enterprise-linux_na_x86_64-1.3.4.8.tar.gz

install.sh(예: /engn001/lena/1.3/bin/install.sh) 파일을 이용하여 설치하며
다음과 같은 명령어를 사용하여 설치할 수 있다.

LENA Manager 설치

[lena]# cd /engn001/lena/1.3/bin
[lena]# ./install.sh create lena-manager
*******************************
* LENA Server Install ! *
*******************************
+-------------------------------------------------------------------------------------
| 1. SERVICE_PORT is the port number used by Manager.
| ex : 7700
| 2. MONITORING_PORT is the port number used by Manager for monitoring.
| ex : 16100
| 3. RUN_USER is user running LENA Manager.
| ex : lena, wasadm
| 4. ADMIN_ID is the administrator's ID.
| ex : admin
| 5. ADMIN_PW is the administrator's password.
+-------------------------------------------------------------------------------------
Input SERVICE_PORT for execution. (q:quit)
Default value is '7700'
7700

LENA Manager 설치가 완료되면 install.sh 을 실행한 디렉토리에 LENA Manager 와 관련된 Script 파일이 생성된다.

Table 6. LENA Manager 관리용 Script 파일
Script 파일명	설명
start-manager.sh	LENA Manager 를 시작한다.
ps-manager.sh	LENA Manager가 실행중인지 확인한다.
stop-manager.sh	LENA Manager 를 중지한다.

start-manager.sh 을 실행하여 LENA Manager를 시작한다.

[lena]# ./start-manager.sh
--------------------------------
 LENA Manager
--------------------------------
Using LENA_HOME : /engn001/lena/1.3
Using JRE_HOME : /engn001/java/jdk1.8.0_202
Using SERVER_PID : /engn001/lena/1.3/modules/lena-manager/lena-manager_solmanager.pid
Using SERVER_HOME : /engn001/lena/1.3/modules/lena-manager
Using SERVER_ID : lena-manager
Using INSTANCE_NAME : lena-manager_solmanager
LENA started.

LENA Manager가 정상적으로 실행되면 해당 서버의 Service Port로 Manager에 접속할 수 있다.
http://Server_IP:7700

Figure 3. LENA 접속 화면

LENA Manager 설치 시 입력했던 ID/비밀번호로 접속하면 초기화면을 확인 할 수 있다.

Figure 4. LENA 초기화면(DASHBOARD)

3.1.2. Node 설치(Command Line)

Node의 설치는 LENA 설치 패키지의 압축을 푸는 것과 같다. WAS, Web Server, Memory Cahce를 설치할 서버에 각 설치 패키지를 준비한 경로(예: /engn001/lena 또는 /engn001/lenaw)에 업로드 후 압축을 해제한다.
Node를 설치하면 아래와 같이 Node Agent를 실행, 중지, 상태확인을 하기위한 script가 존재한다.

Table 7. Node Agent 관리 Script
script 경로	script 명	비고
Node 설치경로 하위 'bin' (예: /engn001/lena/1.3/bin)	start-agent.sh	Node Agent 실행
	ps-agent.sh	Node Agent 프로세스 확인
	stop-agent.sh	Node Agent 중지

WAS Node 설치

WAS Node의 설치 시 고려할 수 있는 사항은 다음과 같다.

LENA Manager와 WAS Node를 같은 Server에 설치
LENA Manager와 WAS Node를 다른 Server에 설치(LENA Manager 독립 설치)

1번의 경우 LENA Manager 설치/실행 에서 LENA Manager를 설치하기 위해 WAS Node 설치 패키지의 압축을 풀었으므로 이미 WAS Node가 설치되어 있는 상태이다.

2번의 경우 WAS Node를 설치할 Server의 준비한 경로(예: /engn001/lena)에 LENA WAS 설치 패키지를 업로드 후 다음과 같이 압축을 풀어 설치한다.

설치 경로 및 설치 파일 업로드 확인

 [lena]# cd /engn001/lena
 [lena]# ll
 -rw-rw-r-- 1 lena lena lena-enterprise-linux_na_x86_64-1.3.4.8.tar.gz

압축 해제 시 설치파일의 확장자 부분을 제외한 나머지 이름으로 디렉토리가 생성되는데
이 디렉토리 명을 1.3 으로 간략하게 변경하여 사용한다.

설치 파일 압축 해제 / 디렉토리 명 변경

 [lena]# tar -xvzf lena-enterprise-linux_na_x86_64-1.3.4.8.tar.gz
 [lena]# mv lena-enterprise-linux_na_x86_64-1.3.4.8 1.3
 [lena]# ll
 drwxr-xr-x 12 lena lena 1.3
 -rw-rw-r-- 1 lena lena lena-enterprise-linux_na_x86_64-1.3.4.8.tar.gz

Node를 설치했다면 start-agent.sh로 Node Agent를 실행한다.

Node Agent 실행

[lena]# cd /engn001/lena/1.3/bin
[lena]# ./start-agent.sh
Input JAVA_HOME path for LENA. ( q: quit )
JAVA_HOME PATH :
/engn001/java/jdk1.8.0_202 (1)
Input Agent port for LENA Agent. ( q: quit )
Agent port (Default : 16800):
16800 (2)
Input Agent user for LENA Agent. ( q: quit )
Agent user (Default : lena):
lena (3)

--------------------------------
 LENA Agent
--------------------------------
Using LENA_HOME : /engn001/lena/1.3
Using JAVA_HOME : /engn001/java/jdk1.8.0_202/jre
Using CONF_FILE : /engn001/lena/1.3/conf/agent.conf
Using LOG_HOME : /engn001/lena/1.3/logs/lena-agent
Using RUN_USER : lena
Using PORT : 16800
Using UUID : 98449860-0a9a-323b-9766-98c4292000df
LENA Agent is started.

Node Agent 실행 시 입력받는 항목은 다음과 같다.

1	JAVA HOME (jdk) 경로 입력
2	Node Agent가 사용할 Port 입력
3	Node Agent 실행 OS 계정 입력

WAS Node 설치 (스펙 변경시)

WAS Node의 Spec을 변경하기 위한 절차는 다음과 같다.

기본 설치 파일로 WAS Node설치를 진행한다.
추가로 서버 설치를 진행하지 않은 상태에서 depot변경을 수행한다.

LENA_HOME/bin/change-depot.sh <depot파일 경로>

[lena]$ ./change-depot.sh ~/lena-depot-linux_na_x86_64-1.3.4.8-EN9.tar.gz
*******************************
* LENA Depot Change ! *
*******************************
========================= Execution Result ========================
RESULT : Success
MESSAGE : depot change succeeded from EN8 to EN9
===================================================================

Execution is completed.!!

depot 파일 명의 규칙은 다음과 같다.

lena-depot-{os name}-{lena version}-{engine number}

예) lena-depot-linux_na_x86_64-1.3.4.8-EN9.tar.gz

Web Server Node 설치

Web Server를 설치할 Server에 LENA Web Server 설치용 패키지를 업로드 후 압축을 풀어 설치한다.

경로 / 파일 확인

 [lenaw]# cd /engn001/lenaw
 [lenaw]# ll
 -rw-rw-r-- 1 lena lena lena-web-linux_na_x86_64-1.3.4.8.tar.gz

설치파일 압축 해제 / 디렉토리 명 변경

 [lenaw]# tar -xvzf lena-web-linux_na_x86_64-1.3.4.8.tar.gz
 [lenaw]# mv lena-web-linux_na_x86_64-1.3.4.8 1.3
 [lenaw]# ll
 drwxr-xr-x 12 lena lena 1.3
 -rw-rw-r-- 1 lena lena lena-web-linux_na_x86_64-1.3.4.8.tar.gz

압축 해제 시 설치파일의 확장자 부분을 제외한 나머지 이름으로 디렉토리가 생성되는데
이 디렉토리 명을 1.3 으로 간략하게 변경하여 사용한다.

Node를 설치 한 후 start-agent.sh로 Node Agent를 실행한다.

Node Agent 실행

[lena]# cd /engn001/lenaw/1.3/bin
[lena]# ./start-agent.sh
Input JAVA_HOME path for LENA. ( q: quit )
JAVA_HOME PATH :
/engn001/java/jdk1.8.0_202 (1)
Input Agent port for LENA Agent. ( q: quit )
Agent port (Default : 16900):
16900 (2)
Input Agent user for LENA Agent. ( q: quit )
Agent user (Default : lena):
lena (3)
Input Web Agent Engine type for LENA Agent. ( q: quit )
Agent Engine type [EN-A, EN-N] (Default : EN-A):
EN-A (4)
Openssl version 1.1.1 detected.
Input your openssl version(1.0.1, 1.0.2, 1.1.1 or 3.0) (Default : 1.1.1, q:quit):
1.1.1 (5)
Do you want to select the module for the openssl version 1.1.1? Make sure all of your instances are shut down(Y/N, Default:Y)
Y (6)

The modules have been copied successfully.
--------------------------------
 LENA Agent
--------------------------------
Using LENA_HOME : /engn001/lenaw/1.3
Using JAVA_HOME : /engn001/java/jdk1.8.0_202/jre
Using CONF_FILE : /engn001/lena/1.3/conf/agent.conf
Using LOG_HOME : /engn001/lena/1.3/logs/lena-agent
Using RUN_USER : lena
Using PORT : 16900
Using UUID : 98449860-0a9a-323b-9766-98c4292000df
LENA Agent is started.

Node Agent 실행 시 입력받는 항목은 다음과 같다.

1	JAVA HOME (jdk) 경로 입력
2	Node Agent가 사용할 Port 입력
3	Node Agent 실행 OS 계정 입력
4	Node Agent가 사용할 WebServer Engine Type 입력 Default : EN-A Engin Type : EN-A (기존 Apache 기반), EN-N (Nginx 기반) Agent 최초 기동 시에 Engine Type을 결정하며, 하나의 Agent 내부에서 교차 엔진(EN-A, EN-N) 사용 불가
5	open ssl version 입력
6	open ssl version 입력 확인 입력

Memory DataStore Node 설치

Memory Cache를 설치할 Server에 LENA Memory Cache 설치용 패키지를 업로드 후 압축을 풀어 설치한다.

경로 / 파일 확인

 [lena]# cd /engn001/lena
 [lena]# ll
 -rw-rw-r-- 1 lena lena lena-mds-linux_na_x86_64-1.3.4.8.tar.gz

설치파일 압축 해제 / 디렉토리 명 변경

 [lena]# tar -xvzf lena-mds-linux_na_x86_64-1.3.4.8.tar.gz
 [lena]# mv lena-mds-linux_na_x86_64-1.3.4.8
 [lena]# ll
 drwxr-xr-x 12 lena lena 1.3
 -rw-rw-r-- 1 lena lena lena-mds-linux_na_x86_64-1.3.4.8.tar.gz

압축 해제 시 설치파일의 확장자 부분을 제외한 나머지 이름으로 디렉토리가 생성되는데
이 디렉토리 명을 1.3 으로 간략하게 변경하여 사용한다.

Node를 설치 한 후 start-agent.sh로 Node Agent를 실행한다.

Node Agent 실행

[lena]# cd /engn001/lena/1.3/bin
[lena]# ./start-agent.sh
Input JAVA_HOME path for LENA. ( q: quit )
JAVA_HOME PATH :
/engn001/java/jdk1.8.0_202
Input Agent port for LENA Agent. ( q: quit )
Agent port (Default : 16700):

Input Agent user for LENA Agent. ( q: quit )
Agent user (Default : lena):

Agent Engine type [ EN-R ]

--------------------------------
 LENA Agent
--------------------------------
Using LENA_HOME : /engn001/lena/lena-mds-linux_na_x86_64-1.3.4.8
Using JAVA_HOME : /engn001/java/jdk1.8.0_202/jre
Using CONF_FILE : /engn001/lena/lena-mds-linux_na_x86_64-1.3.4.8/conf/agent.conf
Using LOG_HOME : /engn001/lena/lena-mds-linux_na_x86_64-1.3.4.8/logs/lena-agent
Using RUN_USER : lena
Using PORT : 16700
Using UUID : f6614115-d861-3678-ac36-e4d068eeb02a
LENA Agent is started.

Node Agent 실행 시 입력받는 항목은 다음과 같다.

1	JAVA HOME (jdk) 경로 입력
2	Node Agent가 사용할 Port 입력
3	Node Agent 실행 OS 계정 입력
4	Node Agent가 사용할 Memory Cacher Engine Type 입력 Default : EN-R Engin Type : EN-R (Redis 기반) 현재는 Redis 버전만 제공함.

LENA Manager와 Node의 연동(등록)

WAS Node와 Web Server Node를 설치하고 Agent를 기동하면 LENA Manager를 통해 Node를 등록할 수 있다.

LENA Manager의 상단 'SERVER' 메뉴를 선택하면 Node List를 확인 할 수 있다.
Node 등록을 위해 'Register' 버튼을 클릭하면 아래와 같이 Node를 등록하기 위한 Empty Row가 추가되며 각 입력 항목을 등록한다.

Figure 5. SERVER 메뉴 초기화면

Node 등록 시 입력할 항목은 다음과 같다.

Node Name: 등록할 Node의 명칭
Node Type: Application / Web 중에 선택
Node IP: Node가 설치된 Server의 IP Address
Node Port: Node 설치시 입력한 Node Port

Manager Address 항목의 경우 LENA Manager가 설치된 Server의 IP가 자동입력 되므로 별도 입력할 필요는 없다.

입력 항목을 모두 입력한 뒤 'Save' 버튼으로 Node 등록을 완료하며 정상 처리 시 아래와 같은 화면을 확인할 수 있다.

Engine Field 를 통해서 해당 엔진의 타입을 확인할 수 있다.

EN-A : Apache 기반 Web Server Engine
EN-N : Nginx 기반 Web Server Engine
EN-R : Redis 기반 Memory Cache Engine

Figure 6. Node 정상 등록 예시 화면

3.1.3. Node 원격 설치(LENA Manager Web UI)

Node의 설치는 Node 설치(Command Line) 에서 진행한 방법 외에도 LENA Manager를 통해 원격으로 설치할 수도 있다. 이를 위해서는 LENA (Manager)를 설치한 Server의 특정 디렉토리 안에 LENA 설치파일(WAS, Web Server, Memory Cache)를 업로드 해 두어야 한다. 설치 패키지를 업로드 해 두어야 하는 경로의 예시는 다음과 같다.

Table 8. Node 원격 설치를 위한 설치파일 업로드 경로(예시)
LENA 설치경로	LENA 설치 패키지 업로드 경로
/engn001/lena/1.3 (LENA_HOME)	[LENA_HOME]/repository/install-files/default

해당 경로에 앞서 사용한 WAS, Web Server 설치파일을 업로드 한다.

원격 설치를 위한 설치 패키지 확인

[lena]# cd /engn001/lena/1.3/repository/install-files/default
[lena]# ll
-rw-rw-r--. 1 lena lena lena-enterprise-linux_na_x86_64-1.3.4.8.tar.gz
-rw-rw-r--. 1 lena lena lena-web-linux_na_x86_64-1.3.4.8.tar.gz
-rw-rw-r--. 1 lena lena lena-mds-linux_na_x86_64-1.3.4.8.tar.gz

해당 경로에 설치 패키지를 업로드 했다면 LENA Manager의 'SERVER' 메뉴를 선택하고 하단의 'Install' 버튼을 클릭한다.

Figure 7. WAS Node 원격 설치 예시

Node 원격 설치 시 입력해야 하는 항목은 다음과 같다.

Node Type: Application / Web 중에 선택
Node Name: 원격 Server에 설치할 Node의 명칭
Node Address: Node를 설치할 원격 Server의 IP Address
Node Port: 원격 Server에서 Node가 사용할 Port
User: 원격 Server의 OS 계정
Password: 원격 Server의 OS 계정의 비밀번호
SSH Port: 원격 Server의 SSH Port
LENA Home: 원격 Server에 Node를 설치할 경로
Java Home: 원격 Server에 설치되어있는 JAVA Home 경로

원격 설치에서 입력하는 값을 토대로, LENA Manager는 앞서 미리 준비해둔 설치 패키지 파일을 원격 Server로 전송하고 Node를 설치하고, 설치한 Node의 Agent를 자동으로 실행하는 것으로 원격 설치는 완료된다. 이러한 진행 상황은 Popup 창을 통해 확인 할 수 있다.

Figure 8. WAS Node 원격 설치 진행 확인 예시

설치가 정상적으로 완료되면 원격 설치한 Node는 LENA Manager에 자동으로 등록된다.

Figure 9. Node 원격 설치 후 등록 완료된 상태 예시

Node의 원격 설치를 위해서는 LENA Manager가 설치된 Server와 원격 설치할 Server 간의 SSH Port 방화벽이 Open 되어있어야 한다.

3.1.4. WAS 설치/실행

WAS Node를 설치, 등록까지 완료했다면 이제 LENA Manager Web UI를 통해 WAS를 설치할 수 있다. LENA Manager 상단의 'SERVER' 메뉴를 선택 한 뒤 좌측에서 WAS를 설치할 WAS Node를 선택하면 WAS List를 확인할 수 있다. 이 화면에서 'Install' 버튼을 클릭한다.

Figure 10. WAS List 확인

Figure 11. WAS 설치정보 입력 Popup 과 입력 값 예시

'Install' 버튼을 클릭하면 WAS를 설치하기 위한 정보를 입력하는 Popup 창이 출력되며 각 입력항목은 다음과 같다.

Server Type: WAS의 Type, Standard / Enterprise 중 택
Node: WAS가 설치될 Node(수정불가)
Server ID: LENA Manager 가 WAS를 식별하기 위한 명칭
Service Port: WAS가 설치될 때 기준이 되는 HTTP Port를 의미
Run User: WAS 의 기동 시 사용할 OS 계정(수정불가)
Install Root Path: WAS가 설치될 경로(수정불가)
Log Home: WAS Log의 경로
1. default: [Install Root Path]/logs
2. cutom: 사용자가 임의로 경로 지정
JVM Route: Web Server와 연동 시 Web Server가 WAS를 식별하기 위한 값
1. auto: LENA에서 자동생성
2. manual: 사용자가 임의로 지정

WAS는 기동 시 HTTP, HTTPS, AJP 등 다양한 Port를 사용하는데 LENA 에서는 WAS 설치 시 사용자 편의를 위해 HTTP Port 만을 입력받고 이를 기준으로 다른 Port 값을 자동계산하여 설치한다.

WAS 설치 정보를 모두 입력 한 뒤 'Save' 버튼을 클릭하면 WAS가 설치되며 WAS List 에서 설치한 WAS를 확인 할 수 있다.

Figure 12. WAS 정상 설치 후 WAS List

중지되어 있는 WAS를 기동하려면 WAS List 우측의 'Start' 버튼을 클릭한다. 또한 기동되어있는 WAS를 중지하려면 같은 위치의 'Stop' 버튼을 바뀌므로 해당 버튼을 클릭한다.

WAS 기동 시에는 WAS 기동 Log(Application 이 배포되어 있다면 Application 기동 Log 도 함께)가 Popup 창으로 출력된다.

Figure 13. WAS의 기동과 Log

3.1.5. Web Server(EN-A) 설치/실행

WAS 설치와 동일한 방식으로, LENA Manager Web UI를 통해 Web Server를 설치할 수 있다. Engine이 EN-A인 Web Server Node를 선택한 뒤 Web Server(EN-A)를 설치할 수 있다.

Figure 14. Web Server List 확인

Figure 15. Web Server 설치정보 입력 Popup 과 입력 값 예시

'Install' 버튼을 클릭하면 Web Server를 설치하기 위한 정보를 입력하는 Popup 창이 출력되며 각 입력항목은 다음과 같다.

Server Type: Web Server (고정)
Node: Web Server가 설치될 Node (수정불가)
Server ID: LENA Manager 가 Web Server를 식별하기 위한 명칭
Service Port: Web Server가 사용할 HTTP Port
Run User: Web Server 기동 시 사용할 OS 계정(수정불가)
Web Server Engine Path: Web Server 설치 시 사용할 Engine 경로(수정불가)
Install Root Path: Web Server가 설치될 경로(수정불가)
Log Home: Web Server Log 경로
1. default: [Install Root Path]/logs
2. custom: 사용자가 임의로 경로 지정

Web Server는 기동 시 HTTP, HTTPS 등 다양한 Port를 사용하는데 LENA 에서는 Web Server 설치 시 사용자 편의를 위해 HTTP Port 만을 입력받고 이를 기준으로 다른 Port 값을 자동계산하여 설치한다.

Web Server 설치 정보를 모두 입력 한 뒤 'Save' 버튼을 클릭하면 Web Server가 설치되며 Web Server List 에서 확인할 수 있다.

Figure 16. Web Server 정상 설치 후 Web Server List

중지되어 있는 Web Server를 기동하려면 Web Server List 우측의 'Start' 버튼을 클릭한다. 또한 기동되어있는 Web Server를 중지하려면 같은 위치의 'Stop' 버튼을 바뀌므로 해당 버튼을 클릭한다.

Web Server 기동 시에는 Web Server 기동 Log가 Popup 창으로 출력된다.

Figure 17. Web Server 의 기동과 Log

3.1.6. Memory Cache 설치/실행

MDS Node를 설치, 등록까지 완료했다면 이제 LENA Manager Web UI를 통해 Memory Cache를 설치할 수 있다. LENA Manager 상단의 'SERVER' 메뉴를 선택 한 뒤 좌측에서 Memory Cache를 설치할 MDS Node를 선택하면 Cache List를 확인할 수 있다. 이 화면에서 'Install' 버튼을 클릭한다.

Figure 18. Cache List 확인

Figure 19. Memory Cache 설치정보 입력 Popup 과 입력 값 예시

'Install' 버튼을 클릭하면 Memory Cache를 설치하기 위한 정보를 입력하는 Popup 창이 출력되며 각 입력항목은 다음과 같다.

Server Type: Standard
Node: Memory Cache가 설치될 Node(수정불가)
Server ID: LENA Manager 가 Memory Cache를 식별하기 위한 명칭
Service Port: Memory Cache가 설치될 때 기준이 되는 HTTP Port를 의미
Run User: Memory Cache의 기동 시 사용할 OS 계정(수정불가)
Install Root Path: Memory Cache가 설치될 경로(수정불가)
Log Home: Memory Cache Log의 경로
1. default: [Install Root Path]/logs
2. custom: 사용자가 임의로 경로 지정

Memory Cache 설치 정보를 모두 입력 한 뒤 'Save' 버튼을 클릭하면 Memory Cache가 설치되며 Cache List 에서 설치한 Memory Cache를 확인 할 수 있다.

Figure 20. Memory Cache 정상 설치 후 Memory Cache List

중지되어 있는 Memory Cache를 기동하려면 Cache List 우측의 'Start' 버튼을 클릭한다. 또한 기동되어있는 Memory Cache를 중지하려면 같은 위치의 'Stop' 버튼을 바뀌므로 해당 버튼을 클릭한다.

Memory Cache 기동 시에는 기동 Log가 Popup 창으로 출력된다.

Figure 21. Memory Cache의 기동과 Log

3.1.7. Web Server(EN-A) - WAS 연동

Web Server(EN-A)와 WAS 간 연동 설정에 대해 알아본다. Web Server(EN-A)와 WAS 의 연동은 Web Server 설정 화면에서 할 수 있다. LENA Manager 상단의 'SERVER' 메뉴에서 설치한 Web Server를 선택하여 설정 화면을 열고 설정 화면 내 상단의 'Connector' 탭을 선택한다.

Figure 22. Web Server 초기 설정화면

Web Server 의 'Connector' 탭에서는 Web Server 와 WAS 간 연결에 대한 설정을 관리한다.
'Connector' 탭 화면 하단의 Load Balancer Worker List 란에 연동할 WAS를 추가하면 기본적인 Web Server 와 WAS 간 연동이 완료된다.

연동할 WAS를 추가하기 위해서는 Load Balancer 란의 Configuration탭에서 'Add Worker' 버튼을 클릭하면 열리는 팝업에서 설치되어 있는 WAS를 선택하고 'Save' 버튼을 클릭한다.
팝업에서는 LENA Manager 에 등록되어있는 WAS Node 별로 WAS 목록을 확인 할 수 있으며 이미 'Connector' 에 등록한 WAS는 보이지 않는다.

Figure 23. 연동할 WAS 추가

WAS List에 연동 설정할 WAS가 추가되면 우측 하단의 'Save' 버튼을 클릭하여 최종 저장한다.

Figure 24. 연동할 WAS 목록 저장

3.1.8. Web Server(EN-N) 설치/실행

Web Server(EN-A) 설치와 동일한 방식으로, LENA Manager Web UI를 통해 Web Server를 설치할 수 있다. Engine이 EN-N인 Web Server Node를 선택한 뒤 Web Server(EN-N)를 설치할 수 있다.

Figure 25. Web Server List 확인

Figure 26. Web Server 설치정보 입력 Popup 과 입력 값 예시

'Install' 버튼을 클릭하면 Web Server를 설치하기 위한 정보를 입력하는 Popup 창이 출력되며 각 입력항목은 다음과 같다.

Node: Web Server가 설치될 Node (수정불가)
Server ID: LENA Manager 가 Web Server를 식별하기 위한 명칭
Service Port: Web Server가 사용할 Port Type 및 Port Number
1. Port Type : Port Type에는 네 가지 타입을 가지고 있으며, 설치 시에 정해지는 default Type은 변경이 불가능 하다. (Port Number 는 수정 가능하다.)
2. HTTP : HTTP Protocol 기반 Web Server
3. HTTPS : HTTPS Protocol 기반 Web Server
  1. SSLCertificateFile : SSL Cert 파일경로
  2. SSLCertificateKeyFile : SSL CertKey 파일경로
  3. SSLPassword : SSL 암호
4. TCP : TCP 포트를 기반으로 하는 Net Gateway
5. UDP : UDP 포트를 기반으로 하는 Net Gateway
Run User: Web Server 기동 시 사용할 OS 계정(수정불가)
Web Server Engine Path: Web Server 설치 시 사용할 Engine 경로(수정불가)
Install Root Path: Web Server가 설치될 경로(수정불가)
Log Home: Web Server Log 경로
1. default: [Install Root Path]/logs
2. custom: 사용자가 임의로 경로 지정

Web Server는 기동 시 HTTP, HTTPS 등 다양한 Port를 사용하는데 EN-N Engine 타입의 Web Server에서는 Web Server 설치 시 기본이 되는 Port 만을 입력 받고, 이를 기준으로 해당 Type으로 설치를 한다. 이후 다른 Type 추가는 가능하며, 기본으로 설치한 Type은 삭제가 불가능 하다

Web Server 설치 정보를 모두 입력 한 뒤 'Save' 버튼을 클릭하면 Web Server가 설치되며 Web Server List 에서 확인할 수 있다.

Figure 27. Web Server 정상 설치 후 Web Server List

Web Server 기동 시에는 Web Server 기동 Log가 Popup 창으로 출력된다.

Figure 28. Web Server 의 기동과 Log

3.1.9. Web Server(EN-N) - WAS 연동 (Proxy)

Web Server(EN-N)와 WAS 간 연동 설정에 대해 알아본다. Web Server(EN-N)와 WAS 의 연동은 Web Server(EN-N) 설정 화면에서 할 수 있다. LENA Manager 상단의 'SERVER' 메뉴에서 설치한 Web Server(EN-N) 를 선택하여 설정 화면을 열고 설정 화면 내 상단의 'Connector' 탭을 선택한다.

Figure 29. Web Server 초기 설정화면

Web Server(EN-N) 의 'Connector' 탭에서는 Web Server(EN-N) 와 WAS 간 연결에 대한 설정을 관리한다. 'Connector' 탭 화면 하단 > Proxy 탭 > Load Balancer > Configuration 탭의 Load Balancer Member List에 연동할 WAS를 추가하면 기본적인 Web Server(EN-N) 와 WAS 간 연동이 완료된다.

연동할 WAS를 추가하기 위해서는 Load Balancer 란의 Configuration탭에서 'Add Member' 버튼을 클릭하면 열리는 팝업에서 설치되어 있는 WAS를 선택하고 'Save' 버튼을 클릭한다. 팝업에서는 LENA Manager 에 등록되어있는 WAS Node 별로 WAS 목록을 확인 할 수 있으며 이미 'Connector' 에 등록한 WAS는 보이지 않는다.

Figure 30. 연동할 WAS 추가

WAS List에 연동 설정할 WAS가 추가되면 우측 하단의 'Save' 버튼을 클릭하여 최종 저장한다.

Figure 31. 연동할 WAS 목록 저장

3.1.10. Web Server(EN-N) - WAS 연동 (Net Gateway)

Web Server(EN-N)와 Backend Server간 연동 설정에 대해 알아본다.Web Server(EN-N)와 Backend Server의 연동은 Web Server(EN-N) 설정 화면에서 할 수 있다. LENA Manager 상단의 'SERVER' 메뉴에서 설치한 Web Server(EN-N) 를 선택하여 설정 화면을 열고 설정 화면 내 상단의 'Connector' 탭을 선택한다. 이후 아래의 'Net Gateway' 탭을 선택 한다.

Figure 32. Web Server 초기 설정화면

Web Server(EN-N) 의 'Connector' 탭 하위의 'Net Gateway' 탭 에서는 Web Server(EN-N) 와 Backend Server간 연결에 대한 설정을 관리한다. 'Connector' 탭 화면 하단의 Load Balancer Worker List 란에 연동할 Backend Server를 추가하면 기본적인 Web Server 와 Backend Server간 연동이 완료된다.

Backend Server를 추가하기 위해서는 Load Balancer 란의 Configuration탭에서 'Add Upstream' 버튼을 클릭하면 열리는 리스트에서 IP 혹은 DNS, Port를 직접 입력하고 'Save' 버튼을 클릭한다.

Figure 33. 연동할 Backend Server 추가

Member List에 연동 설정할 Backend Server가 추가되면 우측 하단의 'Save' 버튼을 클릭하여 최종 저장한다.

Figure 34. 연동할 Backend Server 목록 저장

3.1.11. Session Server 설치 및 연동

Session Server는 Session Clustering 을 적용 시에 설치하며 다음 두 가지 방법으로 설치할 수 있다.

Standalone 모드: Session Server를 별도 Server 로 설치하는 방법
Embedded 모드: Session Server를 별도 Server 로 설치하지 않고 기존에 설치한 WAS 내에 Emebedded 형태로 설치하는 방법

Standalone 모드 설치와 WAS 연동

Session Server 는 WAS Node에 설치할 수 있다. LENA Manager 상단의 'SERVER' 메뉴를 선택 후 Session Server 를 설치할 WAS Node를 선택한다. WAS List 하단에는 설치된 Session Server를 확인 할 수 있는 Session Server List 를 확인할 수 있다.

Figure 35. Session Server List 확인

Figure 36. Session Server 설치정보 입력 Popup 과 입력 값 예시

'Install' 버튼을 클릭하면 Session Server를 설치하기 위한 정보를 입력하는 Popup 창이 출력되며 각 입력항목은 다음과 같다.

Server Type: Standalone (고정)
Node: Session Server 가 설치될 Node(수정불가)
Server ID: LENA Manager 가 Session Server 를 식별하기 위한 명칭
Service Port: Session Server 가 사용할 Port
Mirror Server IP: 다른 하나의 Session Server 가 설치된 Node(등록한 Node 중에서 선택)
Mirror Server Port: 다른 하나의 Session Server 가 설치된 Node에서 Session Server 가 사용하는 Port
Run User: Session Server 기동 시 사용할 OS의 계정(수정불가)
Install Root Path: Session Server 가 설치될 경로(수정불가)
Log Home: Session Server Log 경로
1. default: [Install Root Path]/logs
2. Enter manually: 사용자가 임의로 경로 지정

Session Server 설치 정보를 모두 입력 한 뒤 'Save' 버튼을 클릭하면 Session Server 가 설치되며 Session Server List 에서 확인 할 수 있다.

Session Clustering 구성 시 Session Server는 2기를 설치하여 하나는 Primary, 다른 하나는 Secondary 이중화 구성을 한다.

위 예시 그림에서는 'Mirror Server IP' 에 다른 하나의 WAS Node를 지정하였으며 해당 WAS Node 에도 아래와 같이 Session Server 를 설치한다.

Figure 37. 다른 하나의 Session Server 설치

Session Server 를 모두 설치 한 뒤 WAS 와 연동하기 위해 WAS 설정 화면의 'Session' 탭을 선택한다.
'Session' 탭 에서는 WAS 의 Session Clustering 적용을 위한 Session Server 연동 설정을 관리한다. 설정 항목의 'Session Clustering Enable' 항목을 'Yes' 로 변경하여 세부 설정이 표시되도록 한다. Standalone Mode 의 경우 별도로 설치한 Session Server 를 기동하고 이를 WAS 와 연동하여 Session Clustering 을 적용하는 방식이다.

Figure 38. WAS 의 Standalone 모드 Session Server 설정

Standalone 모드 Session Server 를 기준으로, 설정 값은 다음과 같다.

Primary Server Host: Primary 로 지정할 Session Server 가 설치된 Node 를 선택하고 Session Server 를 지정한다.
Secondary Server Host: Secondary 로 지정할 Session Server 가 설치된 Node 와 Session Server 를 지정한다. Session Server 가 2기 설치되어 있고, Primary Server Host 를 선택하면 나머지 Session Server 가 자동으로 Secondary 로 지정된다.
External Stored Session: Session Clustering 적용과 함께 WAS 와 Session Server(2기)에서 관리되는 Session 정보를 Session Server(2기) 에서만 관리할 지 여부를 선택한다. 주로 Cloud, Container 환경에서 구성 시 해당 옵션을 사용한다.(Default false)
Share session in applications: WAS에 여러 Application 이 배포되는 경우 해당 Application 간 Session 정보를 공유할 지 여부를 선택한다.(Default false)
Multi Login Control: 중복 로그인 제어 기능의 사용여부를 선택한다.(Default false)

Standalone 모드 Session Server 의 경우 설정을 적용할 WAS 마다 위와 같은 설정을 적용해 주어야 한다.

Session 설정 변경 후 WAS를 재기동 해야한다.

Embedded 모드 설치와 WAS 연동

Session Server 의 기능을 Embedded 모드로 사용할 WAS를 선택하여 설정화면을 연 뒤, 상단의 'Session' 탭을 선택한다.
'Session' 탭 에서는 WAS 의 Session Clustering 적용을 위한 Session Server 연동 설정을 관리한다. 설정 항목의 'Session Clustering Enable' 항목을 'Yes' 로 변경하여 세부 설정이 표시되도록 한다. Embedded Mode 의 경우 WAS 에 Session Server 기능이 WAS 에 Embedded 형태로 WAS가 기동한다.

Figure 39. WAS 의 Embedded 모드 Session Server 설정

Embedded 모드 Session Server 를 기준으로, 설정 값은 다음과 같다.

Embedded Host: Embedded Mode 선택 시 현재 WAS 로 고정된다.
Embedded Port: Embedded Session Server 가 사용할 Port를 입력한다.
Secondary Server Host: 다른 하나의 Embedded Session Server 를 사용할 WAS를 지정한다. WAS가 설치된 Node 를 선택 후 WAS를 선택한다.
Secondary Server Port: 다른 하나의 Embedded Session Server 가 사용할 Port 를 입력한다.
Multi Login Contorl: 중복 로그인 제어 기능의 사용여부를 선택한다. (Default false)

설정 값 입력, 선택을 마친 뒤 'Save' 버튼을 눌러 저장하면 Embedded Session 설정이 완료되며 Embedded Session 의 설정은 하나의 WAS 에서 진행하면 다른 하나의 WAS 에도 설정이 적용된다.

Session 설정 변경 후 WAS를 재기동 해야한다.

Figure 40. WAS 의 Embedded 모드 Session Server 설정의 완료

3.1.12. Server 간 연동 확인

앞서 Web Server(EN-A) - WAS 연동 과 Web Server(EN-N) - WAS 연동 (Proxy) 과 Web Server(EN-N) - WAS 연동 (Net Gateway) 과 Session Server 설치 및 연동 과정을 통해서 진행한 연동 설정을 확인하는 방법을 설명한다.
LENA Manager 에서는 설치한 Server 의 구성을 간편하게 확인할 수 있도록 Topology View 를 제공하고 있다. 이 Topology 기능을 통해 연동이 정상적으로 확인 하는 방법과 Web Server, WAS 설치 시 기본 탑재되어 있는 LENA Sample 페이지를 통해 연동이 정상적으로 되어있는 지를 확인 할 수 있다.

Topology 를 통한 확인

LENA Manager 상단의 'Topology' 메뉴를 선택한다.

Figure 41. Topology View

Topology View 에서는 기본적으로 현재 등록되어 있는 Node 와 Node 별 설치한 Server 의 구성과 연동정보를 확인 할 수있다.
위 그림에서는 Web Server 2기, WAS 2기 그리고 Session Server 2기가 설치되어 있으며 Web Server 와 WAS, WAS 와 Session Server 간 연동 설정이 연결선으로 표현되고 있으며 이를 통해 Server 간 연동이 정상적으로 되었는지 확인 할 수 있다.

Sample Page 호출을 통한 확인

LENA 의 Web Server 와 WAS 에는 기본 탑재된 Sample Page와 Sample Application 이 있다. 이는 초기 설치 후 정상 연동을 확인하는 용도로도 사용될 수 있다.

먼저 Web Server 의 IP와 Port를 확인한 뒤 웹 브라우저에 아래와 같이 입력한다.

http://[Web Server IP]:[Web Server Port]/index.html

그럼 아래와 같이 LENA 에서 제공하는 index.html 페이지가 호출되는 것을 확인 할 수 있으며 Web Server가 정상호출 되는 것을 확인 할 수 있다.

Figure 42. Web Server 호출 Test

Sample Application 호출을 통한 확인

LENA WAS를 설치하면 LENA 에서 제공하는 기본 Application 이 탑재되어 있다. 이 Application의 index.jsp, session.jsp 를 호출하면 각각 WAS 호출 테스트, Session Clustering 기능 테스트를 수행할 수 있다.

Web Server 와 WAS가 설치 초기상태로 설정되어 있다는 가정 하에 웹 브라우저에 아래와 같이 입력한다.

http://[Web Server IP]:[Web Server Port]/index.jsp

Web Server 와 WAS가 정상 연결이 되어있다면 Web Server 의 IP와 Port 로 호출한 위 요청은 WAS로 전달되어 index.jsp 페이지를 요청하게 되고 다음과 같이 LENA Sample Application 에서 제공하는 index.jsp 페이지가 호출된다.

Figure 43. index.jsp 호출 Test

index.jsp 페이지를 호출하면 현재 요청을 어떤 WAS가 처리하는지를 Server ID, Service Port, JvmRout 값을 통해 확인할 수 있다.

이번에는 동일한 Web Server IP, Port 로 아래와 같이 session.jsp 를 호출한다.

http://[Web Server IP]:[Web Server Port]/session.jsp

session.jsp 를 호출하면 현재 요청에 대한 Session 정보가 추가로 확인된다. 호출을 반복함에 따라 Session Count 의 수가 증가하며 두번째 호출 부터 발급된 Session ID가 표시된다. Session Clustering 이 정상 적용 되었는지를 확인 하기 위해서는 Session ID가 발급된 상태에서 현재 요청을 처리중인 WAS를 중지하고 웹 브라우저를 새로고침하여 요청을 다시 보냈을 때, 기동중인 다른 WAS가 요청을 처리하지만 Session ID 가 그대로 유지되며 Session Count 가 증가하는 것으로 확인할 수 있다.

Figure 44. session.jsp 호출 Test

User Guide

Mon, 01 Jan 0001 00:00:00 +0000

User Guide

1. Overview

1.1. LENA는 무엇입니까?

LENA는 Enterprise 환경에서 JAVA J2EE Web Application을 서비스하는데 필요한 모든 구성 요소가 포함된 웹 미들웨어 솔루션이다.

LENA는 실질적인 웹 서비스를 제공하는 Server 제품들과 이를 통합적으로 관리하기 위한 Web UI 기반의 Manager Console로 이루어져있다. 사용자는 Manager Console을 통해 Server 설치부터 Parameter 설정 및 각 제품간 연동 등을 손쉽게 수행할 수 있으며, LENA만의 사용자 친화적인 UX/UI 설계로 웹 미들웨어 솔루션 사용에 익숙하지 않은 사용자라도 빠르게 사용법을 습득하여 웹 미들웨어 관련 지식을 갖출 수 있다.

LENA는 데이터 센터/클라우드 환경에서 웹 미들웨어 운영자들로부터 다년간의 운영 노하우를 집약하여 다양한 편의 기능을 제공한다. 이와 함께 대규모 트랜잭션을 안정적으로 처리하고 서비스 장애를 최소화 할 수 있도록 고가용성, 내결함성을 보완한 Clustering, 장애 진단/대응 기능을 제공한다.

다음 절은 LENA의 특징들에 대해 더 상세히 설명한다.

1.2. LENA 특징

Enterprise 요건 제공: LENA Web Application Server EE (J2EE Edition)는 Enterprise Web Application을 실행시키는데 필요한 EJB, JTA/XA, JMS, JAX-WS 등 J2EE Spec을 지원한다. 또한 타사 WAS에 비해 기동성능, Application Deploy성능의 향상을 이루었고, CPU/Memory 등 자원 사용 효율성 역시 향상되었다. 고가용성을 위해 필수인 Session Clustering을 위해 Session Server를 Enterprise Edition에서 기본으로 제공한다.
Open Source 호환성 보장: LENA Web Server, LENA WAS는 Open Source Base로 구현되어 완벽한 Open Source 호환성을 보장한다. Open Source 기반으로 작성된 Web Application이 별도의 수정 없이 LENA에 적용되므로 전환 Effort를 대폭 절감할 수 있다. 또한 Library 및 설정 관련하여 표준 기술을 사용하므로 Vendor 종속성을 해결하여 사용자의 IT Ownership을 강화할 수 있다.
지능형 장애 진단/대응 및 서비스 추적: Thread Pool Full / Hang / Out of memory 등 대표적인 장애 상황들에 대해 사전 정의된 Rule 기반으로 진단을 수행하여 적절한 조치를 수행할 수 있다. 실시간으로 수집되는 Monitoring 데이터를 기반으로 분석하여 Server가 실제 장애로 이어지기 전에 Fake Page 우회 혹은 강제 재기동 등을 통해 장애 상황을 방지하거나 장애로 이어지더라도 장애 시간을 최소화할 수 있다. 이와 동시에 관련된 Dump와 Report를 제공하여 원인 분석을 수행할 수 있게 한다.
Multi-Server 관리 및 Centralized Operation: 여러 LENA Web Server와 LENA WAS를 하나의 Cluster로 묶을 수 있어 Single Operation으로 여러 Server를 동시에 제어할 수 있다. 일관적인 설정 동기화와 함께 Graceful Restart혹은 Rolling Restart를 통해 안정적인 반영이 가능하다. 또한 Cluster로 묶이지 않은 Server들에 대해서도 Multi Control을 지원한다.
운영 관점의 차별화 기능 제공: 웹 미들웨어 솔루션을 운영하기에 편리한 다양한 편의 기능을 제공한다. Template 기반의 간단하고 빠른 Server설치와 Server 복제 기능을 이용하여 원하는 구성 Set을 짧은 시간 안에 구축이 가능하다. Topology View를 통해 Server 모듈 간 구성 및 연동 정보를 한눈에 확인할 수 있어 가시성을 향상할 수 있다. Dashboard를 통해 운영 중인 시스템의 Event와 성능 현황 등을 확인할 수 있다. 그 밖에 Multi Account 관리를 통해 메뉴/자원의 접근 권한 설정이 가능하며, 운영자 Action Tracing, 설정 변경 정보 History 추적 및 Restore 기능을 제공한다.

1.3. LENA 구성 요소 및 주요 개념

LENA는 Binary Package를 통해 제공이 되며 그 안에 필요한 모든 구성 요소를 포함하고 있다. 구성 요소는 크게 두 범주로 나누어진다.

LENA를 운영 관리하기 위한 Management Module로 LENA Manager Console과 LENA Node Agent가 포함된다.
실질적인 Web Service를 담당하는 Server Module로 LENA Web Server, LENA WAS(Web Application Server), LENA Session Server를 포함된다.

다음은 각 구성 요소 별 상세 설명과 함께 이에 따른 주요 개념을 다룬다.

1.3.1. Management Module

LENA Manager

LENA Manager는 Web UI를 통해 LENA의 모든 자원/기능을 설정 및 제어할 수 있도록 설계된 Web Application이다. LENA Package에 준비된 스크립트를 통해 설치 및 기동할 수 있다. LENA Manager를 통해 Server 설치/관리를 수행하려면 Node Agent 및 Advertiser와의 연동을 구성해야 한다.

다음은 LENA Manager에서 제공하는 대표적인 기능과 개념에 대해 설명한다. 아래에 설명되지 않은 상세 사항들에 대해서는 “운영자가이드”를 참조한다.

Dashboard
LENA Node, Server의 자원 현황과 Event 확인
Server
LENA Node의 등록, Web Server, WAS, Session Server 를 설치, 설정 관리 및 기동/중지 제어
- System
  LENA Node, Server가 관리되는 최소 단위. 하나의 System하위에는 여러 Node를 등록할 수 있으나, 하나의 Node는 여러 System에 중복 등록이 불가하다.
- Node
  Node Agent와 1:1로 대응되는 개념. Manager에서 원격지에 있는 Server에 명령을 수행하기 위해선 Node Agent를 통해야 한다.
Cluster
Multi-Server 관리. 하나의 System 내의 Server들에 대해서만 Cluster 구성이 가능하며, 하나의 Server는 여러 Cluster에 속할 수 없다.
- Server Cluster
  여러 LENA Web Server, WAS를 하나의 묶음으로 관리할 수 있다. 설정 동기화, 통합 재 기동 등의 다양한 편의 기능 제공.
Resource
LENA에서 제공하는 Module이 아니지만 LENA Server와 밀접하게 연동되는 자원에 대해 명세를 정의함으로써 Resource로 사용한다. Resource는 LENA WAS별로 Local 설정할 수 있지만, Resource 메뉴를 통해 Global 설정하여 WAS에서 공통 Import하는 방식을 통해 중복된 작업을 피할 수 있다.
- Database
  DBMS의 IP, Port, Driver 등 물리적 명세를 정의. 하나의 DBMS와 1:1로 대응된다.
- Datasource
  DB Connection Pool을 LENA WAS에서 구성하기 위해 JNDI Name, Url, User ID/Password등을 지정한다. 하나의Database하위에 여러 Datasource를 구성할 수 있다.
- Application
  LENA WAS를 통해 실행할 Application의 위치와 Context Path를 지정한다.
Topology
LENA Manager상에 설치되고 연동 구성되어 있는 LENA Web Server, LENA WAS, LENA Session Server 등의 구성 현황을 Topology Diagram 형식으로 표현한다. 이 기능을 통해 Server의 간단한 설치와 기동/중지 제어도 가능하다.
Diagnostics
LENA Node와 Server에 대한 자원 모니터링과 그에 연계된 다양한 기능 탑재.

LENA Node Agent

LENA Node Agent는 LENA Manager에 Node를 등록할 때 Node와 1:1로 대응되며 LENA Package에 기본적으로 설치되어 있으며 준비된 스크립트를 통해 기동할 수 있다. 주요 역할은 LENA Manager를 통해 Node 하위의 Server에 명령을 수행할 때 Node Agent가 이를 담당하며 모니터링 및 상태 데이터를 LENA Manager로 전송하는 기능도 수행한다. 물리 서버 당 1개의 Node Agent를 설치하는 것이 기본이지만, 필요에 따라 여러 개의 Node Agent를 구성할 수 있다. LENA Web Server, LENA WAS, LENA Session Server는 LENA Node 하위에 구성되며, LENA Node는 하나의 System 하위에 구성된다.

1.3.2. Server Module

LENA Web Server

LENA Web Server는 정적 컨텐츠를 전송할 수 있으며 LENA WAS와 AJP 혹은 Reverse Proxy 형태로 연동하여 LENA WAS가 제공하는 Web Application 서비스의 front-end 역할을 수행한다. 그 외 선택적으로 다양한 추가 기능을 이용할 수 있는데, Domain/URI 기반 분기 및 Load Balancing 기능과 보안 레이어(SSL)를 제공하는 것이 대표적이다.

LENA WAS (Web Application Server)

LENA WAS는 Java Web Application을 실행하여 Web Application 서비스를 제공한다. DB Connection Pool을 이용하기 위한 Datasource 연동 기능과 Session Clustering을 이용하기 위한 Session Server 연동 기능을 포함하고 있다. 다음은 LENA WAS의 두 가지 Type을 설명한다.

LENA WAS SE (Standard Edition)
Java Class 파일을 처리하기 위한 Servlet Engine과 JSP 파일을 처리하기 위한 JSP Engine으로만 구성되어 있으며 WAR Type의 Web Application만 실행할 수 있다. LENA WAS EE에 비해 상대적으로 가볍고 빠르다는 장점이 있다.
LENA WAS EE (Enterprise Edition)
LENA WAS SE가 제공하는 Engine 외에도 EJB Engine, JMS Engine 등 J2EE Spec을 지원하며, WAR/EJB/EAR Type의 Application을 실행할 수 있다. 또한 2 Phase Commit을 위한 XA Datasource를 지원한다.

LENA WAS는 내부적으로 Advertiser Module을 탑재하고 있으며 이는 LENA WAS의 JVM 내부 모니터링 결과를 JMX를 통해 수집하여 LENA Manager로 전달한다.

LENA Session Server: LENA Session Server는 여러 LENA WAS 간의 Session을 공유하여 WAS 다중화를 통한 고 가용성을 보장하기 위해 제공된다. LENA Enterprise Edition을 사용할 경우 기본으로 제공되며 2개의 LENA Session Server를 Active-Active Clustering (양방향 Active-Standby)을 통해 Session Clustering을 구성할 수 있다. LENA Session Server를 사용하기 위해 Application에서 별도의 설정을 할 필요가 없이 LENA Manager에서 간단한 설정만으로 구현이 가능하다.

단, Session-clustering을 하기 위해선 HTTP Session에 저장되는 모든 객체는 직렬화(Serializable)되어야한다.

1.4. LENA 작동방식

Manager에 등록된 Node에는 Node Agent, Application Server에는 Advertiser가 설치되어 있다.

운영자는 Manager의 UI를 통해 각 Node Agent에 Server에 대한 제어요청(예: Start, Stop, Reload, Dump, 설정변경 등)을 보내고, Node Agent가 이를 수신하여 제어를 실행한다.

Node Agent, Advertiser는 주기적으로 모니터링 데이터를 Manager로 전송하고, 운영자는 Monitoring Dashboard와 같은 Manager의 UI를 통해서 각 서버의 자원 현황을 확인할 수 있다. Session Server의 경우 자기 자신의 모니터링 데이터를 직접 Manager에 전달한다.

Figure 1. LENA Mechanism

Table 1. LENA 구성 요소 별 설명
구성요소	설명
Manager	Agent를 통한 Server제어와 모니터링 기능 제공
Repository	Manager 운영을 위한 File/DB 탑재
Node	Node Agent를 탑재. Node하위에 Server Module이 설치됨
Node Agent	- Server 설치/복제/패치 - Server 기동/중지 제어 - Server 설정 관리 - Node, Web Server, WAS, Session Server 상태 정보 - Node, Web Server 자원 모니터링 데이터 제공
Advertiser	WAS 자원 모니터링 데이터 제공
WAS	Java Web Application 서비스 제공
Web Server	WAS와 Reverse Proxy 형태로 연동하여 Web 서비스의 Front-end 역할
Session Server	- WAS와 Session Clustering 연동하여 고가용성 구현 - Session Server 모니터링 데이터 제공

1.5. Edition 별 제공 Spec

LENA 는 Application Server 의 기능 제공 범위에 따라 Standard와 Enterprise Edition으로 구분된다. Standard Edition이 Web Application 중심의 Spec을 지원하는 반면, Enterprise Edition은 JTA, JMS, EJB등 J2EE Spec을 지원하며 Session Clustering을 제공한다. 각 Edition별 제공되는 기능 또는 스펙은 아래와 같다.

Table 2. Edition별 제공 기능과 스펙
기능/Spec (LENA-Manager 기준)		Standard	Enterprise
Server	Web Server	●	●
	WAS (SE)	●	●
	WAS (EE)	-	●
	Session Server	-	●
Resource	Database	●	●
	DataSource (일반)	●	●
	DataSource (XA)	-	●
	JTA	-	●
	JMS	-	●
	Application (WAR)	●	●
	Application (EJB, EAR)	-	●
Cluster		-	●
Topology		●	●
Security		●	●
Diagnostics	Monitoring	●	●
Diagnostics	진단/대응	-	●
Patch		●	●

(범례 : ● 제공됨, - 제공되지 않음)

2. Log In/Out

Manager에 로그인과 로그아웃하는 기능을 제공한다.

2.1. Log In

Figure 2. Manager 접속화면

사용자 ID 와 비밀번호를 입력하면 로그인이 가능하다.

로그인 시도시, 7번 이상의 비밀번호 오류가 발생하는 경우 해당 계정으로 로그인을 할 수 없다. 이런 경우 console을 통해 패스워드를 초기화 해야한다. (자세한 내용은 Appendix에서 'Manager 의 admin 패스워드 초기화' 항목을 참고한다.)

2.1.1. OpenID Connect

Admin 메뉴의 Manager Environment 에서 OpenID Connect 설정을 활성화 하면, 로그인 화면에 OpenID Connect 토글이 활성화 된다. OpenID Connect 토글을 통해 Keycloak 과 같은 인증 제공자를 통해 로그인 할 수 있다.

2.1.2. 언어 설정

Language 에서 Manager 에서 사용할 언어를 설정할 수 있다.(English, 한글, 中文)

로그인 페이지 하단 좌측에는 설치된 버전이, 우측에는 기술지원 연락처가 기술되어 있다.

2.2. Log Out

Manager 상단 우측의 문 아이콘 을 이용하여 로그아웃을 할 수 있다.

2.3. Theme 변경

Manager 상단 우측의 수레바퀴 아이콘 메뉴의 Dark Theme 메뉴를 통해 테마를 설정 할 수 있다. 라이트 모드와 다크 모드 두 가지 중에 선택이 가능하다.

3. Dashboard

Manager에서 관리되는 시스템 별 구성 정보, 자원 모니터링, 이벤트, 라이센스 등의 정보를 요약하여 제공한다.

Figure 3. Dashboard

화면 좌측의 시스템 목록에는 로그인 한 사용자에게 권한이 있는 시스템 목록이 제공된다. All은 권한이 있는 모든 시스템의 정보를 통합하여 보여준다.

Table 3. Dashboard 항목
항목		설명	비고
INVENTORY	Node	System 에 포함된 Node의 수	범례: Node의 타입 별 갯수 Web type : Web Server를 설치 할 수 있는 노드 수 WAS type : WAS, Session Server를 설치 할 수 있는 노드 수
	Server	System에 포함된 Server 타입 별 갯수
	Node Status	System에 포함된 Node의 자원(CPU, Memory, DISK) 사용률 상태	범례 High / Middle / Low Not working : 정지 상태의 Node(Agent) 갯수
	Server Status	System에 포함된 Server의 자원 사용률 상태 Web Server : CPU, Memory, Thread 체크 WAS : Heap Memory, Thread Pool 체크 Session : Heap Memory 체크	범례 High / Middle / Low Not working : 정지 또는 Hang 상태인 서버의 갯수
SERVER CLUSTER	Server Cluster	server cluster 수
SERVER CLUSTER	Member	server cluster에 속해 있는 타입별 서버 총 수
CHECK	Modified Server	System에 포함된 Server중 재기동이 필요한 서버 존재여부
	Out of Cluster Sync	sync가 필요한 Server Cluster 존재여부
	Diagnostic Report	진단 프로세스 수행 후 발행된 레포트 갯수
EVENT	Exception	System에 포함된 Server에서 발생된 Exception 갯수
	Stuck Thread	System에 포함된 Server에서 발생된 Stuck Thread 갯수
	OOM	System에 포함된 Server에서 발생된 Out Of Memory 갯수
	Full GC	System에 포함된 Server에서 발생된 Full GC 갯수
RESOURCE	DB Resource	RESOURCE메뉴에서 등록되어 관리되는 Database와 Datasource 수	Datasource의 범례 Used : WAS에서 사용 중인 Datasource 수 Not Used : WAS에서 미사용 중인 Datasource 수
LICENSE	License Status	노드들의 라이선스 상태 (Trial 라이선스의 유효일 수 또는 상용라이선스의 유효일 수(종료일자기준 15일 전 부터) 표시)

4. Server

Node 및 WAS, Web Server, Session Server, Memory Cache Server를 관리하기 위한 화면을 제공한다.

특정 System 내의 Node 및 각 Server별 개수를 확인하고, 실시간으로 Node 및 Server 상태를 통합적으로 관리 할 수 있다.

4.1. System

System은 다수의 Server를 가지는 논리적인 그룹이다. "DefaultSystem"을 기본적으로 제공하며 사용자는 System을 생성, 수정, 삭제 할 수 있다.

4.1.1. 목록

System 목록은 화면 좌측에 트리 형태로 제공된다.

Figure 4. System List

4.1.2. 등록

등록(+) 버튼 을 클릭하여 목록에 "Create System" 을 생성한다.
생성할 시스템 명을 입력한 후 엔터키를 입력한다.
OK 버튼 을 클릭하여 저장한다.

현재 로그인한 사용자의 권한이 해당 System에 매핑된다. 즉, 로그인한 사용자와 동일한 권한을 가진 사용자에게만 해당 System이 조회된다. (Node, Server, Resource 동일하게 적용됨)

4.1.3. 수정

수정할 System을 선택한다.
수정(연필) 버튼 을 클릭하여 선택한 System의 이름을 변경한 후 엔터키를 입력한다.
OK 버튼 을 클릭하여 저장한다.

4.1.4. 삭제

삭제할 System을 선택한다.
삭제(-) 버튼 을 클릭한다.
OK 버튼 을 클릭하여 저장한다.

하위에 Node가 존재하는 System은 삭제할 수 없다. 즉, 빈 System만 삭제 가능하다.

4.2. Node

Node는 다수의 WAS, Web Server, Session Server를 가지는 물리적인 Server이다.

4.2.1. 목록

Node List를 통하여 각 Node를 관리할 수 있다.

Figure 5. Node List

Node의 속성은 아래와 같다.

Table 4. Node 속성
항목(*는 필수값)	설명	비고
Node 정보 변경상태	Node 데이터의 신규/변경/삭제 상태	+ 아이콘 - Register / 수정(연필) 버튼을 클릭한 경우 변경 상태 표시 표시 - 아이콘 - 삭제(휴지통) 을 클릭한 경우 삭제 예정임을 표시
Status	Node의 현재 상태	Started(v) Stop(ㅁ)
Name(*)	Node의 이름
Type(*)	Node의 Type	All - 모든 종류의 Server 설치 가능 Application - WAS와 Session Server 설치가능 Web - Web Server 설치 가능 MDS - Cache Server 설치 가능
Engine	Node Type 에 따른 엔진의 유형	Application - EN-7: Java EE 6 / Servlet 3.0 지원 - EN-8: Java EE 7 / Servlet 3.1 지원 - EN-9: Java EE 8 / Servlet 4.0 지원 - EN-10: Servlet 6.0 지원 Web - EN-A: JK, Proxy 지원 - EN-N: Proxy, Net-Gateway 지원 MDS - EN-R: Memory Cache 지원
Address(*)	Node의 IP주소
Port(*)	Node Agent의 Port번호	Default - 16800(Node Type이 All 또는 Application인 경우) - 16900(Node Type이 Web인 경우) - 16700(Node Type이 MDS인 경우)
Manager Address(*)	Manager IP 주소
버튼 영역	Node 정보 변경 및 관련 기능 버튼을 표시	휴지통 아이콘 - Node 정보를 삭제 펜 아이콘 - Node 정보를 수정 터미널 아이콘 - Node가 설치된 서버로 SSH 터미널 기능 제공 더보기 아이콘 - JAVA Home 설정과 Start/Stop을 수행할 수 있는 메뉴 제공

4.2.2. Install

Install 버튼 을 클릭하여 Node정보 등록을 준비한다.
Node의 속성 값을 입력한다.
Save 버튼 을 클릭하여 저장한다.

Table 5. Install 시 설정하는 속성
항목(*는 필수값)	설명	비고
Node Type	Node의 Type	다음과 같은 타입을 제공함 Application: WAS와 Session Server 설치가능 Web: Web Server 설치가능
Node Name(*)	Node의 이름
Node Address(*)	Node의 IP주소
Node Port(*)	Node Agent의 Port번호	Default : 16800(Node Type이 All 또는 Application인 경우), 16900(Node Type이 Web인 경우)
User(*)	Node 실행 사용자 계정	Node Type이 Application인 경우, root 계정으로 실행 할 수 없음. Node Type이 Web인 경우 Web Server의 Port를 1024이하를 사용해야하는 경우에만 root 사용.
Password(*)	Node 실행 사용자 계정 비밀번호
SSH Port	해당 Server에 접속할 SSH 포트
LENA Home	Node Agent가 설치 될 위치
JAVA Installation	Java 설치 여부
JAVA Home	설치된 JAVA 경로

Install 기능은 Linux 환경에서만 지원한다.

4.2.3. Register

Register 버튼 을 클릭하여 Node정보를 등록 가능한 상태로 변경한다.
Node의 Name, Type, Address, Port, Manager Address(기본값이 제공됨) 속성을 입력한다.
Save 버튼 을 클릭하여 저장한다.

Manager IP는 Node의 host IP로 자동 입력된다.
네트워크 구성에 따라 자동 입력된 IP가 실제 네트워크 IP와 다른 경우가 발생할 수 있다.
이때는 Manager IP를 수정하여 입력해야 한다.

4.2.4. 수정

수정(연필) 버튼 을 클릭하여 Node정보를 수정 가능한 상태로 변경한다.
Node의 속성을 수정한다.
Save 버튼 을 클릭하여 저장한다.

포트 정책이나 방화벽 정책 변경 등에 의해 Node의 Address나 Port를 변경해야 하는 경우, agent.conf의 설정정보를 수정 후 Node Agent를 재기동한다.
이 때 변경된 정보를 Manager에서도 알 수 있도록 Node의 Address와 Port정보를 수정하여 입력한다.

수정된 정보를 저장할 때 'Occured Read Timeout' 메세지가 발생하면 아래의 경우를 확인한다.

Node Agent가 아닌 다른 곳에서 포트를 사용하는 경우
Node Agent가 Hang이 걸린 경우
Network 문제가 있는 경우

4.2.5. 삭제

휴지통 버튼 을 클릭하여 Node정보를 삭제 가능한 상태로 변경한다.
Save 버튼 을 클릭하여 저장한다.

Node 하위에 Server가 등록되어 있는 경우 해당 Node를 삭제할 수 없다.

Uninstall은 Linux 환경에서만 지원되고, 삭제할 노드를 한 개만 선택한 경우 가능하다.

4.2.6. Start

정지 상태인 노드를 기동 시킬 수 있다.

Node목록에서 해당 Node의 맨 우측 컬럼에 있는 … 버튼 을 선택시 제공되는 Start 메뉴를 선택하면 팝업창이 나타난다.
User, Password, SSH Port번호를 입력 후 Start 버튼 을 누른다.

4.2.7. Stop

기동 상태인 노드를 정지 시킬 수 있다.

Node목록에서 해당 Node의 맨 우측 컬럼에 있는 … 버튼 을 선택시 제공되는 Stop 메뉴를 선택하면 팝업창이 나타난다.
User, Password, SSH Port번호를 입력 후 Stop 버튼 을 누른다.

4.2.8. Change Java Home

Node와 Node에 설치된 Server들의 JAVA Home 경로를 수정할 수 있다.

JAVA Home Path를 수정한다.
- Node Java Home Path : Node Java Home Path를 편집한다.
- Server Java Home Path : 선택한 서버들의 JAVA Home 경로를 편집한다. (Web Node에서는 지원하지 않음)
Save 버튼 을 누른다.

4.2.9. Node Terminal

LENA Manager를 통해 대상 Node가 설치된 VM에 접속하여 SSH 터미널 기능을 사용할 수 있다.

이 기능을 사용하기 위해서는 다음을 만족해야 한다.

Node 가 기동중이어야 하며 LENA Manager 와 통신이 가능해야 한다.
Node 가 설치된 OS 가 Linux 계열이다(Windows 계열 미지원).
Node 설치/실행 OS 계정이 Password 인증을 통한 SSH 접근이 허용되어있어야 한다.

해당 기능은 LENA Manager 와 Node 간 연결을 재사용 하므로 이 터미널 기능을 사용하기 위해 별도의 Port 작업은 불필요 하다.

Node 목록에서 [.icon]#터미널 아이콘#을 클릭하면 기능 사용을 위한 팝업 화면을 확인 할 수 있으며
Node Agent를 실행한 OS 계정의 패스워드를 입력하면 SSH 터미널이 실행된다.

Node Terminal 기능의 세부 설정은 다음 Manager Configuration의 관련 설정 을 참고한다.

Table 6. Manager Configuration(manager.conf)의 Node Terminal 기능 설정 옵션
옵션 key	기본값	설명
ssh.cmdCheck.mode.isWhiteList	true	- true 인 경우 화이트리스트 방식으로 명령어를 제어한다. - false 인 경우 블랙리스트 방식으로 명령어를 제어한다.
ssh.cmdCheck.idleTimeout	600 (second)	Terminal 접속 후 아무런 동작을 하지 않으면 해당 시간 후 접속을 해제한다. (설정 가능한 최소값: 30)
ssh.cmdCheck.whitelist.view	view	화이트리스트 방식으로 사용시 허용할 'view’나 'vi' 명령어를 ',' 구분자로 설정한다
ssh.cmdCheck.whitelist	cd,clear,echo,ll,ls,ps,tail,exit	화이트리스트 방식으로 사용시 허용할 명령어를 설정한다.(view, vi 제외)
ssh.cmdCheck.blacklist	alias,chmod,chown,cp,dd,export,rm,mkdir,mv,kill,sed,source,sudo,touch,vi	블랙리스트 방식으로 사용시 금지할 명령어를 ',' 구분자로 설정한다

Manager Configuration 의 관련 설정과는 무관하게 다음과 같은 표현은 사용이 불가능하다.

'|' 는 '| grep' 의 경우를 제외하곤 사용 불가

'&&' 의 사용 불가

'>' 또는 '>>' 의 사용 불가

'()'(sub shell) 및 $(), 그리고 ``(백틱)의 사용 불가

4.3. WAS(SE/EE)

WAS를 관리하기 위한 화면을 제공한다. Node에 설치한 Server의 등록, 수정, 삭제를 수행하며, 그 외 Server의 설치, 제거 및 복제를 할 수 있다.

4.3.1. 목록

WAS List를 통하여 각 WAS를 관리할 수 있다.

Figure 6. Web Application Server List

WAS의 속성은 아래와 같다.

Table 7. WAS 속성
항목(*는 필수값)	설명	비고
Server의 정보 변경상태	WAS 데이터의 신규/변경/삭제 상태 및 선택을 위한 CheckBox	+ 아이콘 - Register / 수정(연필) 버튼을 클릭한 경우 변경 상태 표시 표시 - 아이콘 - 삭제(휴지통) 을 클릭한 경우 삭제 예정임을 표시
Status	Server의 상태	Started (v) Stop (ㅁ) Error (!)
Name(*)	Server의 이름
Address	Server의 IP주소
Server ID	Server의 ID
Type	Server의 유형	Standard Enterprise/EE Enterprise/SE
Engine	Server의 엔진 유형	Engine 는 LENA의 엔진 유형을 의미하며 WAS의 Java Spec버전 별로 다르다. - EN-7: Java EE 6 / Servlet 3.0 지원 - EN-8: Java EE 7 / Servlet 3.1 지원 - EN-9: Java EE 8 / Servlet 4.0 지원 - EN-10: Servlet 6.0 지원
HTTP Port	HTTP 포트번호
AJP Port	AJP 포트번호
시작/중지 버튼	Server의 시작 및 종료
버튼 영역	서버 정보 변경 및 관련 기능 버튼을 표시	휴지통 아이콘 - 서버 정보를 삭제 펜 아이콘 - 서버 정보를 수정 Log 파일 아이콘 - Server Log Viewer 기능 제공 더보기 아이콘 - Start/Stop을 수행할 수 있는 메뉴 제공

4.3.2. Install

Install 버튼 을 클릭하여 Server의 설치를 준비한다.
Server Type, Server ID 등을 입력한다.
Save 버튼 을 클릭하여 저장한다.

Node에 실제 설치되어 있는 Server와 Manager에서 관리하는 Server의 정보에는 차이가 있을 수 있다. (console기반 설치 시)
Server ID 중복 오류가 발생하는 경우, Register 기능을 이용하여 설치된 Server 정보를 추가로 확인해야 한다.

4.3.3. Clone

Clone 버튼 을 클릭하여 Server의 복제를 준비한다.
Node List에서 복제할 Server를 선택한다. 이때 Clone Server ID, Clone Service Port가 자동으로 입력된다.
Clone Server ID와 Service Port를 원하는 값으로 수정한다.

(Include External Source는 다른 노드로 서버를 복제하는 경우 사용가능하며, 복제할 서버에 배포되어 있는 어플리케이션 파일도 함께 복제하는지 여부를 설정한다.)
Save 버튼 을 클릭하여 저장한다.

Node에 실제 설치되어 있는 Server와 Manager에서 관리하는 Server의 정보에는 차이가 있을 수 있다. (console기반 설치 시)
Server ID 중복 오류가 발생하는 경우, register 기능을 이용하여 기존에 설치된 Server 정보를 추가로 확인해야 한다.
WAS서버의 원격 복제시에는 Node의 Engine No.가 같아야 WAS서버를 Clone할 수 있다.

4.3.4. Register

Register 버튼 을 클릭한다.
등록하려는 Server를 선택한다.
Save 버튼 을 클릭하여 저장한다.

System > Application Server List Tab에서도 설치가 가능하다. 단, Node List에서 설치할 Node를 선택해야 한다.

4.3.5. 수정

수정(연필) 버튼 을 클릭하여 Server정보를 수정 가능한 상태로 변경한다.
Server의 속성을 수정한다.
Save 버튼 을 클릭하여 저장한다.

4.3.6. 삭제

삭제(휴지통) 버튼 을 클릭하여 Server 정보를 삭제 가능한 상태로 변경한다.
Save 버튼 을 클릭한다.
OK 버튼 을 누르면 삭제 유형을 선택하는 창이 출력된다.
- Deregister : Manager DB에서만 해당 Server 정보를 삭제하고 물리적인 Server engine은 유지 (추후 Register 버튼 을 통해 다시 등록 가능)
- Uninstall : Manager DB에서 해당 Server 정보를 삭제하고 물리적인 Server engine도 삭제

Uninstall 선택시, 로그 디렉토리 삭제여부를 묻는 창이 출력된다.

WAS를 삭제할 경우 서비스 제어(ADMIN > Security > Rule Applying 메뉴)의 적용 대상 목록에서 해당 Server는 삭제된다.

Server Cluster에 묶여있는 서버는 삭제할 수 없다.

ADMIN > Preference > Manager Environment 메뉴의 Manager Configuration 영역에서 use Server Delete Protection 값을 true로 설정하는 경우 Manager에서 서버가 uninstall되는 것을 방지 할 수 있다.

4.3.7. Start/Stop

Single Start/Stop

Stop 버튼 을 클릭하여 Server를 종료한다.
Start 버튼 을 클릭하여 Server를 시작한다.

Server를 중지시 WAS가 서비스중인 모든 작업이 끝난 후 종료된다.
General 탭의 Shutdown Timeout 시간 이후에도 작업이 끝나지 않은경우 강제로 중지된다.

Server를 시작하면 로그파일을 볼 수 있는 팝업이 실행된다. 팝업을 통해 Server의 정상 기동 여부를 확인할 수 있다.

시작 가능한 상태일 경우에만 Start 버튼 이 활성화 된다.

실시간 상태 모니터링

Manager는 SSE(Server-Sent Events)를 통해 서버 시작/중지 작업의 상태를 실시간으로 모니터링한다. 작업이 진행되는 동안 UI에서 진행 상태를 확인할 수 있으며, 작업 완료 시 자동으로 상태가 업데이트된다.

작업 진행 중에는 해당 서버에 대한 다른 시작/중지 작업이 차단됨
타임아웃 시간 내에 작업이 완료되지 않으면 실패로 처리됨
관련 설정은 ADMIN > Preferences > Manager Environment 에서 Operation Verification 항목 참조

Multi Start/Stop

시작 혹은 종료하고자 하는 복수개의 Server를 선택한다.
Server 목록 하단의 Multi Action 버튼 을 클릭한다.
팝업창에서 Action Type을 선택 후 Action 버튼 을 클릭하여 복수개의 Server에 대한 시작 혹은 종료 작업을 수행한다.

팝업 화면에서 Start / Stop 명령 이후에는 팝업을 닫더라도 요청한 명령이 중지되지 않는다.

Forced Stop/Restart

Server 목록 가장 우측의 추가 기능(…) 버튼 을 클릭한다.
강제 종료 혹은 강제 재시작을 수행한다.

강제 중지, 재시작을 수행하면 현재 서비스중인 모든 작업이 즉시 중지되므로 주의해야한다.

4.3.8. 설정 정보 관리

Server의 설정 정보를 변경하는 기능을 제공한다. Server 목록에서 변경하려는 Server 명을 선택한다. Standard Edition의 경우 General, Session, Logging, Web Config, Environment, Properties, Audit, Config Tree, History, TunA 탭을 제공하며, 설정 정보 수정 시 백업을 하여 복원이 가능하다. Enterprise Edition는 Container 탭을 추가적으로 제공한다.

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

General

Server의 일반적인 설정 정보를 관리한다. Port정보, Connector정보, Stuck Thread 관련 설정을 수정 및 저장 할 수 있다.

설정 정보의 상세내용은 아래와 같다.

Server Info

Server의 주요 설정 값을 나타낸다.

Table 8. 주요 설정
항목(*는 필수값)	설명	비고
HTTP Port(*)	HTTP 포트번호
AJP Port	AJP 포트번호	HTTP 포트번호 - 71 (자동계산)
HTTPS Port	HTTPS 포트번호	HTTP 포트번호 + 363 (자동계산)
Shutdown Port	Shutdown 명령 문자열을 받기 위한 포트	HTTP 포트번호 - 75 (자동계산) -1 설정 시 Shutdown 명령을 사용하지 않고 SIGTERM 신호로 종료 (Linux 환경)
Install Path	Server 설치 경로
Java Home Path	Java Home 경로
Minimum Heap Size(MB)(*)	WAS에 설정할 최소 Heap 사이즈(Megabyte)	Default : 2048
Maximum Heap Size(MB)(*)	WAS에 설정할 최대 Heap 사이즈(Megabyte)	Default : 2048
AppBase	Application의 Base 디렉토리	Server가 stop 상태이거나, appBase에 deploy이된 Application이 없을 경우에만 수정이 가능하다.
Jvm Route	Server의 Unique한 Identifier	System Property에 설정되어 있는 값을 우선함. 없을 경우 server.xml의 값을 사용 (Hostname + Port의 조합으로 생성됨)
Auto Deploy	어플리케이션 변경 시 자동 Deploy 여부	Default : false Application별 DocBase에 war 파일을 재 업로드 할 경우 감지됨
Deploy On Startup	WAS 기동 시 Application Deploy 여부	Default : true
Shutdown Timeout(s)	Server 종료 시 실행중인 작업이 존재할 경우 대기하는 시간(초)	Default : 0 (무제한 대기)

Connector

Server에서 사용하는 Connector 설정 값을 나타낸다.

Table 9. 주요 설정
항목(*는 필수값)	설명	기본값
Protocol	프로토콜 유형	HTTP/1.1, AJP/1.3
port	포트번호
Redirect Port	Redirect 포트	HTTPS Port와 동일
Connection Timeout(ms)	Connector가 연결을 허용한 후 Request URI 수신을 대기하는 시간(ms)	HTTP : 20000, AJP : 60000
URI Encoding	URI byte를 변환하기 위한 Character Encoding	UTF-8
Server	Http Response에 대한 Server Header를 재정의하여 Server 정보 노출을 방지	Server
Max Threads	Connector가 생성할 수 있는 최대 Thread 수	256
Min Spare Threads	Connector생성시 확보하는 최소 Thread 수	10
Max Queue Size	Request Queue 의 최대길이	Integer.MAX_VALUE
Packet Size	AJP packet 크기	8192
Enable Lookups	DNS LookUp 사용여부. 사용하지 않을 시 성능에 유리하다	false
Compression	HTTP message Body 압축여부(off, on:Text만, force:전체)	off
Tcp No Delay	TCP 패킷을 Delay 없이 전송	true

Stuck Thread

Stuck Thread의 설정값을 나타낸다.

Table 10. 주요 설정
항목(*는 필수값)	설명	비고
Threshold(s)	Stuck Thread를 식별하기 위한 최소 시간(s)
Interrupt Thread Threshold	Stuck Thread를 중단하기 위한 최소 시간(s)	Stuck Thread 판별 이후 n초 뒤 종료시키려면 "Threshold+n"값 입력

Service Endpoint

Endpoint Address의 설정값을 나타낸다.

Table 11. 주요 설정
항목(*는 필수값)	설명	비고
Service Endpoint Address	WAS의 대표 서비스 도메인 주소

Session

Session Cluster 기능을 사용할지 여부를 설정한다.

Embedded Session Server 모드

WAS에 Session Server 모듈을 Embedded하여 동작하는 경우 선택한다. Session Server Mode 항목에서 Embedded Mode를 선택하게 되면, Server 관리 화면에서 Session Server 리스트에 Embedded Type으로 표시된다.

Table 12. 주요 설정
항목(*는 필수값)	설명	기본값
Embedded Host	해당 WAS를 의미	자기 자신의 IP (변경불가)
Embedded Port(*)	해당 WAS에서 사용할 Embedded Session Server 용 port 정보
Secondary Server Host(*)	Slave Server 호스트 IP
Secondary Server Port(*)	Slave Server Port
Multi Login Control	이중 로그인 방지여부	false (true인 경우 아래 3가지 항목이 제공)
Logout Page when Multi Login check(Multi Login)	이중 로그인시 먼저 로그인한 사용자의 세션 종료 후 제공할 화면
Logout Message when Multi Login check(Multi Login)	이중 로그인시 먼저 로그인한 사용자의 세션 종료 후 보여줄 메세지
Excepted Page When Multi Login Check(Multi Login)	이중 로그인 체크 예외 URL

Standalone 모드

별도의 Session Server를 연결하여 동작하는 방식이다. Mode 항목에서 Standalone을 선택한다.

Standalone 모드에서 Primary Server와 Secondary Server 설정 시 사전에 Session Server가 구성되어 있어야한다.

Table 13. 주요 설정
항목(*는 필수값)	설명	기본값
Primary Server Host(*)	Primary Session Server 호스트	Enter manually 선택시 시스템 외부의 세션서버 설정이 가능
Primary Server Port(*)	Primary Session Server 포트
Secondary Server Host(*)	Secondary Session Server 호스트 PrimaryServer와 연결이 끊어진 경우에만 사용	Enter manually 선택시 시스템 외부의 세션서버 설정이 가능
Secondary Server Port(*)	Secondary Session Server 포트 PrimaryServer와 연결이 끊어진 경우에만 사용
External Stored Session	Session객체를 로컬 WAS에 저장하지 않고 Session Server에 저장	false
Share session in applications	Multi Application간 Session객체를 공유 Standalone Mode에서만 설정가능	false
Multi Login Control	이중 로그인 방지여부	false (true인 경우 아래 3가지 항목이 제공)
Logout Page when Multi Login check(Multi Login)	이중 로그인시 먼저 로그인한 사용자의 세션 종료 후 제공할 화면
Logout Message when Multi Login check(Multi Login)	이중 로그인시 먼저 로그인한 사용자의 세션 종료 후 보여줄 메세지
Excepted Page When Multi Login Check(Multi Login)	이중 로그인 체크 예외 URL

Session 기능은 Enterprise Edition에서 제공되는 기능이다.

Logging

Server의 Logging 설정 정보를 관리한다.

Log Home

Table 14. 주요 설정
항목(*는 필수값)	설명	비고
Log Home(*)	Log Home 경로	default 선택시 서버설치디렉토리 하위 logs 폴더로 설정, Enter manually 선택시 Log Home Prefix항목에서 로그디렉토리 홈 경로 입력가능
Retention Days(*)	로그 최대 보관 일수	Default : 0(무제한)

Access Log

Request에 대한 Access 로그의 설정값을 나타낸다.

Table 15. 주요 설정
항목(*는 필수값)	설명	비고
Logging Directory	Log 디렉토리	절대경로 또는 $CATALINA_BASE의 상대경로로 지정할 수 있음
Pattern	Logging field의 Layout
Prefix	Log 파일의 prefix
Suffix	Log 파일의 suffix

Handler List

Handler 설정 정보의 상세내용은 아래와 같다.

Table 16. 주요 설정
항목(*는 필수값)	설명	비고
Name(*)	Handler의 클래스명
Type	Handler의 유형	ConsoleHandler와 FileHandler 선택 가능
Level	Handler의 로그레벨
Filter	java.util.logging.Filter의 구현체
Formatter	java.util.logging.Formatter의 구현체	Default : java.util.logging.SimpleFormatter
Encoding	Handler의 Character Encoding
Root Handler	Root Logger여부

Logger List

Logger 설정 정보의 상세 내용은 아래와 같다.

Table 17. 주요 설정
항목(*는 필수값)	설명	비고
Name(*)	Logger 이름 지정
Level(*)	Logger의 로그레벨
Handler(*)	Logger가 어떠한 Handler를 사용할지 선택	ConsoleHandler가 기본 선택

Server의 로그설정 파일은 $CATALINA_HOME($CATALINA_BASE)/conf/logging.properties 이다.

Web Config

Global web.xml의 설정을 관리하는 화면을 제공한다. 필요 항목을 수정한 후 하단의 Save 버튼 을 클릭하여 저장한다.

설정 정보의 상세내용은 아래와 같다.

Default Servlet

Table 18. 주요 설정
항목(*는 필수값)	설명	기본값
Directory Listing	Welcome파일이 없을 때, Directory Listing을 허용할지 여부	false
Readonly	PUT, DELETE 등의 HTTP메소드를 허용하지 않음	true
Input Buffer Size	입력 buffer 크기 (bytes)	2048
Output Buffer Size	출력 buffer 크기 (bytes)	2048
File Encoding	파일 인코딩	platform 기본값
Show Server Info	Directory Listing이 허용되어 있을 때 Server 정보를 표시할지 여부	true
Load On Startup(*)	WAS 기동 시 Servlet 로딩 순서 지정	1 (음수: disable / 0: 가장 마지막)

JSP Engine

Table 19. 주요 설정
항목(*는 필수값)	설명	기본값
Check Interval(s)	Development가 false일 때 jsp의 변경을 검사하여 재컴파일할지 확인하는 주기(s)	0 (0: 비활성화 / 양수: 해당 주기로 활성화)
Development	Development 여부. Development가 true인 경우에는 modificationTestInterval 값을 주기로 하여 변경을 검사함	true
Generate String As Character Array	String생성을 Char Array로 할지 여부	false
Modification Test Interval(s)	Development가 true일 경우에 동작하는 jsp 변경 검사 주기	4 (0일 경우: 매 access마다 점검)
Trim Spaces	응답에서 쓸데 없는 whitespace를 제거하여 응답바이트를 줄임	false
Java Encoding	Java소스를 generate할때의 Encoding	UTF8
Load On Startup(*)	WAS 기동 시 Servlet 로딩 순서 지정	3

JSP Page Encoding

Table 20. 주요 설정
항목(*는 필수값)	설명	비고
URL Pattern	Page Encoding을 적용할 JSP Page의 URL Pattern
JSP Page Encoding	적용할 Page Encoding을 지정

Session

Table 21. 주요 설정
항목(*는 필수값)	설명	비고
Session Timeout(m)	세션 타임아웃 시간(분)	Default : 30

Welcome File List

Table 22. 주요 설정
항목(*는 필수값)	설명	비고
File(*)	Directory index로 호출할 경우에 service할 파일을 순서대로 지정함

Environment

JVM 옵션, Start Shell의 설정과 System Properties(Enterprise Edition인 경우만 제공)를 관리하는 화면을 제공한다. 파일 에디터를 통해 수정한 후 Save 버튼 을 클릭하여 저장한다.

JVM Env ($CATALINA_HOME/bin/setenv.sh): Server 실행을 위한 JVM 옵션
Custom Env ($CATALINA_HOME/bin/customenv.sh): 사용자 커스텀 환경변수 설정
Base Env ($CATALINA_HOME/env.sh): Server 시작을 위한 Shell Script

JVM_ROUTE 값은 여기서 직접 수정하지 않고, General 탭의 Server Info 영역에 있는 JvmRoute 항목의 불러오기 버튼 을 사용하여 수정한다. 여기서 직접 수정할 경우 Manager DB의 정보가 Update되지 않아 DB값 불일치가 발생한다.

System.properties($CATALINA_HOME/conf/system.properties) (이 항목은 Enterprise Edition에서만 확인할 수 있다)
Catalina.properties ($CATALINA_HOME/conf/catalina.properties): Server의 Catalina 설정

$CATALINA_HOME은 WAS의 기본 설치 디렉토리이다. $CATALINA_BASE는 본래 하나의 WAS에 복수개의 Instance를 사용하고자 할 때 디렉토리를 생성하여 Instance별로 지정하여 사용되지만 LENA에서는 WAS와 Instance가 1:1 관계라 $CATALINA_HOME이 곧 $CATALINA_BASE로 사용된다.

기본적으로 설정을 수정할 수 없도록 Disable 되어 있지만, 수정하고 싶은 경우 ADMIN > Manager Environment > Manager Configuration 항목에서 설정 버튼 을 클릭해 아래 설정을 false 로 변경한다.

server.environment.envshell.readonly=false

Properties

Server의 System Properties 와 System Environments를 확인하는 화면을 제공한다. System Properties 중 Key Properties 를 별도로 제공하여 Server경로, JAVA버전 등의 주요 정보를 확인할 수 있다. Server가 기동된 상태에서만 정보를 확인할 수 있다.

Container

Enterprise Edition의 경우 EJB Container의 설정 변경 기능을 제공한다. container설정 없이 Server를 기동하면 EJB에서 필요한 container가 default 설정으로 생성된다. default설정 외에 변경이 필요한 설정이 있을 경우에는 container를 생성하여 설정을 변경해야 한다.

기본 설정

Table 23. 기본 설정
항목(*는 필수값)	설명	비고
ID(*)	Container의 식별자
Type(*)	Container의 유형

CMP_ENTITY 설정

Table 24. CMP_ENTITY 설정
항목(*는 필수값)	설명	비고
CmpEngineFactory	Factory 클래스 명	Default : org.apache.openejb.core.cmp.jpa.JpaCmpEngineFactory

BMP_ENTITY 설정

Table 25. BMP_ENTITY 설정
항목(*는 필수값)	설명	비고
PoolSize	Bean pool의 크기 지정	Default : 10

STATELESS 설정

Table 26. STATELESS 설정
항목(*는 필수값)	설명	비고
AccessTimeOut	호출간 대기시간 (Specifies the time to wait between invocations)	Default : 0 (means no timeout)
MaxSize	Bean pool의 최대 개수	Default : 10
MinSize	Bean pool의 최소 개수	Default : 0
StrictPooling	Pool이 최대치에 도달했을 때 동작방식 지정. StrictPooling은 pool size를 늘리지 않고 기다림	Default : true
MaxAge	Pool에서 제거되기까지의 최대 시간(h)	Default : -1
ReplaceAged	MaxAge에 도달했을 때 Replace할지 여부	Default : true
ReplaceFlushed	pool에서 Flush될 때 Replace할지 여부	Default : false
MaxAgeOffset	MaxAge 사용량	Default : -1
IdleTimeout	인스턴스가 pool에서 idle상태로 있을 수 있는 최대 시간(m)	Default : 0
GarbageCollection	풀을 줄이기 위한 메커니즘으로 garbage collection을 허용할지 여부	Default : false
SweepInterval	컨테이너가 풀을 정리하고 만료된 instance들을 제거하는 주기(m)	Default : 5
CallbackThreads	Thread Pool 사이즈. 이 값은 컨테이너에 배포되어 있는 모든 Bean들에게 공유됨	Default : 5
CloseTimeout	풀이 닫히고 PostConstruct 메소드가 호출될때까지 기다리는 최대 시간(m)	Default : 5

SINGLETON 설정

Table 27. SINGLETON 설정
항목(*는 필수값)	설명	비고
AccessTimeout	호출간 대기시간 (Specifies the time to wait between invocations)	Default : 0 (means no timeout)

STATEFUL 설정

Table 28. STATEFUL 설정
항목(*는 필수값)	설명	비고
AccessTimeout	호출간 대기시간 (Specifies the time to wait between invocations)	Default : 0 (means no timeout)
Cache	Stateful 빈 인스턴스를 관리할 cache	Default : org.apache.openejb.core.stateful.SimpleCache
Passivator	Passivator클래스 지정	Default : org.apache.openejb.core.stateful.SimplePassivater
TimeOut(m)	호출간 대기시간 (Specifies the time to wait between invocations)	Default : 20
Frequency	빈 캐쉬가 idle상태인 빈들을 확인하는 주기(s)	Default : 60
Capacity	Stateful SessionBean 컨테이너에 대한 bean pool의 크기	Default : 1000
BulkPassivate	한번에 passivate할 instance의 개수	Default : 100

MESSAGE 설정

Table 29. MESSAGE 설정
항목(*는 필수값)	설명	비고
ResourceAdapter	Resource Adapter 지정	Default : Default JMS Resource Adapter
MessageListenerInterface	MessageListener 지정	Default : Javax.jms.MessageListener
ActivationSpecClass	Activation Spec Class 지정	Default : org.apache.activemq.ra.ActiveMQActivationSpec
InstanceLimit	Instance 최대 개수	Default : 10

Audit

WAS에서 발생한 이벤트로 수집/관리하는 기능이다.

수집된 이벤트 정보는 이벤트 대시보드에서 확인할 수 있다. 이벤트 대시보드 관련 내용은 Event Dashboard를 참고한다.

총 네 가지 타입의 Detection Rule을 설정해 이벤트를 수집할 수 있다.

Table 30. OOM Detection Rule
항목	설명	비고
Enable	Out Of Memory Error 발생을 감지한다	Default : true

Table 31. Stuck Thread Detection Rule
항목	설명	비고
Enable	Stuck Thread 발생을 감지한다	Default : false

LenaStuckThreadDetectionValve 는 server.xml 내에 기본적으로 설정되어 있으며, LenaStuckThreadDetectionValve 관련 설정은 SERVER > Server 선택 > General 탭 화면의 Stuck Thread 항목에서 할 수 있다.

사용자 요청의 처리 시간이 Threshold 설정 값을 초과한 경우 이벤트가 발생되어 Manager로 전송된다.

Table 32. Full GC Detection Rule
항목	설명	비고
Enable	Full GC 발생을 감지한다	Default : false

Table 33. Exception Detection Rule
항목	설명	비고
Enable	Exception 발생을 패턴으로 감지한다	Default : false
Exception Class Pattern	감지할 Exception 패턴을 지정한다. 해당 패턴의 Exception을 상속한 Exception도 검출한다. 최대 10개까지 지정 가능하며, * 패턴은 사용할 수 없다. ex) abc.dbc.ExampleException
Exclude Exception Class Pattern	감지에서 제외할 Exception 패턴을 지정한다. 최대 10개까지 지정 가능하며, * 패턴은 사용할 수 없다. ex) abc.dbc.ExampleException
Enable Full Stack	Exception이 여러 Cause를 가지고 있을 때, 요약 정보가 아닌 내용 전체를 표시할 지 여부	Default : true
Max Line of Stack’s Cause	Exception Stack Trace에서 표현할 Line 수. 각 Cause by 별로 설정한 수 만큼의 Line이 수집된다. 너무 큰 수로 지정하면 수집 및 저장관리에 부하가 발생할 수 있다	Default : 3

검출이 가능한 Exception 클래스는 Java 자체적인 라이브러리에 포함된 Exception이 아닌, Application이나 Framework의 Exception이다. 너무 많은 량의 이벤트가 발생하지 않도록 Exception 패턴을 정의해야 한다.

Audit 기능은 Enterprise Edition에서 제공되는 기능이다.

Config Tree

WAS의 설치경로 하위의 /conf 폴더 하위 설정 파일들을 파일편집기를 통해 관리 할 수 있다.

Node Agent를 실행하는 사용자가 WAS 설정 정보 파일의 접근 권한이 있어야 수정이 가능하다. 접근 권한이 없을 경우 파일 Write 권한이 없어 편집 할 수 없다는 메시지가 출력 된다.

History

설정 정보의 백업 및 복원 기능을 제공한다. 설정 정보를 수정하여 저장하면 유형별로 History를 관리한다. 수정 일시와 설정 파일 Type을 입력하여 검색한다.

보기(돋보기) 버튼 을 클릭하여 선택한 파일의 정보를 볼 수 있으며, Restore 버튼 을 클릭하여 해당 설정 파일로 복원할 수 있다.

4.3.9. Resource 관리

Server메뉴 하위의 Resources메뉴를 선택하면 해당 Server에 관련된 Resource정보를 관리할 수 있는 화면이 표시된다. 기본적으로 DataSource, JMS, JTA Resource에 대한 정보를 관리할 수 있다. (JMS, JTA Resource는 Enterprise Server일 경우에만 지원)

WAS에 Resource 를 설정하는 방법은 다음과 같다.

추가 : New 버튼 을 클릭하여 Resource를 추가한다. (Datasource, JMS 가능)
삭제 : Delete 버튼 을 클릭하여 Resource를 삭제한다. (Datasource, JMS 가능)
가져오기 : Import 버튼 을 클릭하여 RESOURCE 메뉴에서 등록된 Resource를 가져온다. (Datasource, JMS, JTA 가능)

DataSource

WAS의 Application이 사용할 수 있는 JNDI DataSource를 관리하는 기능을 제공한다. JNDI를 설정하여 Server에서 실행되는 모든 Application이 공유하여 사용할 수 있으며, 각각의 Application에 JNDI 설정을 하여 사용할 수도 있다. Enterprise Edition의 경우 JTA를 지원하여 속성이 추가된다.

Server DataSource 설정

Server에서 실행되는 모든 Application이 공유하는 DataSource를 설정한다. Server에서 사용 가능한 DataSource의 목록을 조회할 수 있으며, DataSource의 등록, 수정, 삭제가 가능하다.

DataSource의 상태를 체크하기 위한 접속테스트도 수행할 수 있다.

DataSource의 속성은 아래와 같다. 최초 화면에서 보이지 않는 속성은 Expand all 버튼 을 클릭하면 표시된다.

Table 34. DataSource 속성
항목(*는 필수값)	설명	비고
Scope	DataSource를 사용할 범위	다음과 같은 스코프를 제공함 Context: 모든 Application이 공유하도록 Datasource 정보가 공통 context 영역에 설정된다. Global: GlobalNamingResource영역에 Datasource 정보가 설정되고, 어플리케이션 개별적으로 DataSource Link List에서 설정하여 사용한다. Global+ResourceLink: GlobalNamingResource 영역에 Datasource정보가 설정되고 Datasource 링크는 공통 context영역에 설정된다.
JNDI Name(*)	Global DataSource의 JNDI명
Databases(*)	공통으로 사용할 데이터소스의 정보를 설정
Resource Name(*)	Databases의 이름
Address(Host/Port)(*)	공통으로 사용할 아이피와 포트
Driver Class Name(*)	JDBC Driver 클래스명
URL(*)	JDBC URL
User Name(*)	접속 사용자명
Password(*)	접속 패스워드	encryption을 체크할 경우 패스워드를 암호화하여 저장한다. 보안을 위해 암호화하는 것을 권장한다.
Encryption Level	인증 정보에 대한 암호화 범위 지정	Default : Password only
DefaultAutoCommit	Pool에서 생성된 Connection들의 자동 Commit 상태	Default : JDBC driver의 기본값
Auto Reconnection	TestOnBorrow와 TestWhileIdle의 값을 설정할 때 사용. true/false에 따라 두 값도 동일하게 설정됨. User Definded 선택시 두 값을 사용자가 직접 설정 가능
InitialSize	Pool의 초기 Connection 수	Default : 10
MaxActive	Pool의 최대 Connection 수	Default : 100
MinIdle	최소 Idle Connection 수	Default : 10
MaxIdle	최대 Idle Connection 수	Default : 100
MaxWait(ms)	Pool에 가용한 Connection이 없을 경우 대기하는 최대시간(ms)	Default : 30000
MinEvictableIdleTimeMillis(ms)	해당 시간 이상 idle 상태로 Pool에 존재한 Connection은 제거 대상이 됨 (ms)	Default : 60000 (60s) (XaDataSource = true로 설정하였을 시 1800000 (30m))
ValidationQuery	Connection 유효성 검증 쿼리	Default : null
ValidationInterval	Connection 유효성 검증 주기(ms)	Default : 3000
TestOnBorrow	Pool에서 커넥션을 꺼내기 전에 validationQuery에 설정된 쿼리문을 수행하여 커넥션의 유효여부 확인	Default : default
TestOnReturn	Pool에 커넥션을 반납하기 전에 validationQuery에 설정된 쿼리문을 수행하여 커넥션의 유효여부 확인	Default : default
TestWhileIdle	Idle 상태의 커넥션에 대해 validationQuery에 설정된 쿼리문을 수행하여 커넥션의 유효여부 확인	Default : default
LogValidationErrors	validation query 수행 후 오류 발생 시 오류 출력 여부	Default : default(false)
TimeBetweenEvictionRunsMillis(ms)	사용되지 않은 Connection을 추출하는 Thread 실행주기(ms)	Default : 5000
RemoveAbandoned	Connection 유실 검출 여부	Default : default
RemoveAbandonedTimeout(s)	유실Connection을 판단하기 위한 Timeout 값(s)	Default : 60
LogAbandoned	Connection 유실 처리시 로깅여부	Default : default
AbandonWhenPercentageFull	Connection pool이 설정한 점유율을 초과해야지만 abandon을 수행함	Default : 100
JdbcInterceptors	유연하고 플러그 가능한 인터셉터를 사용하여 사용자 정의 기능을 추가할 수 있음	QueryTimeout 설정시 QueryTimeoutInterceptor(queryTimeout=시간(초)) 입력

Default 값이 true 또는 false가 아닌 default 인 경우, JDBC Driver의 기본값이 사용된다.

Enterprise Edition의 추가 속성은 아래와 같다.

Table 35. Enterprise Edition 추가 속성
항목(*는 필수값)	설명	비고
JtaManaged	JTA 사용여부	Default : false
XaDataSource	XA 사용여부	Default : false

XADataSource설정은 JTA가 설정되어야만 사용할 수 있으며, XADataSource를 설정하게 되면 validationInterval, logValidationErrors, abandonWhenPercentageFull 속성을 사용할 수 없다.
DataSource를 Context 범위로 설정하면 모든 Application이 공유한다.
EnterpriseServer에서 DataSource를 Context 범위로도 설정할 수 있으나, EJB에서는 Lookup이 불가능하다. EnterpriseServer에서는 Global + ResourceLink 범위로 설정하는 것을 권장한다.
Password 암호화 알고리즘은 AES를 사용하고 있다. 암호화를 위한 키 값은 Manager LENA Home 하위 /repository/conf/manager.conf 파일과 각 WAS Home 하위 /conf/advertiser.conf 내에서 “datasource.key=키값”으로 관리한다.

Databases

URL 설정 시 공통으로 사용할 정보를 Databases를 만들어 등록한다.

추가(+) 버튼 을 클릭하면 팝업창이 생성된다.

Databases를 구분할 Resource Name을 입력한다.
자동으로 채워진 DriverClassName 을 확인한다. 변경할 필요가 있을 경우 변경한다.
Address(아이피 및 포트)를 입력한 후 저장한다.

JDBC driver Upload

Manager를 통해 JDBC Driver library를 upload 할 수 있다.

DataSource 상세 정보 하위의 Upload 버튼 을 클릭하면 아래와 같이 upload를 위한 화면이 출력된다.

Search버튼을 통해 upload 할 파일을 선택한다. Upload 할 파일은 JDBC Driver library 이므로 JAR 형식의 파일만 선택할 수 있다.
Upload 버튼을 클릭하면 선택한 파일이 target 디렉토리로 upload 된다.
JDBC Driver 파일이 upload되는 경로는 ${SERVER_HOME}/lib/datasource이다.

Connection Test

DataSource 상세 화면에서 Connection Test 버튼 을 클릭하면 설정된 DataSource에 대한 연결 테스트를 수행할 수 있다. 정상적으로 연결이 된 경우 "JDBC Connection is successfully tested" 라는 문구가 출력된다.

만약 "Driver Class[클래스명] does not exist." 라는 오류 문구가 출력될 경우, 해당 driver class가 정상적으로 업로드 되어 있으며 이에 대한 classpath가 설정되어 있는지 확인한다.

classpath는 WAS 상세 > Environment > JVM Settings 내에 추가한다.

설정 예

CLASSPATH="$\{CLASSPATH}:$\{CATALINA_HOME}/lib/datasource/ojdbc6.jar"

JMS

Enterprise Edition의 경우 JMS관련 Resource를 정의할 수 있다. Active MQ Resource Adapter, JMS Connection Factory, Queue, Topic설정을 각각 추가, 수정, 삭제할 수 있다.

Table 36. 주요 설정
항목(*는 필수값)	설명	비고
ID(*)	Resource의 식별자
Type(*)	Resource의 유형	다음과 같은 타입을 제공함 ActiveMQResourceAdapter JMSConnectionFactory Queue Topic

Active MQ Resource Adapter 설정

Table 37. 주요 설정
항목(*는 필수값)	설명	비고
BrokerXmlConfig	Broker 설정	Default : broker:(tcp://localhost:61616)?useJmx=false
ServerUrl	Broker 주소	Default : vm://localhost?waitForStart=20000&async=true
DataSource	Datasource for persistence messages
StartupTimeout	Startup 최대 대기시간(s)	Default : 10

JMS Connection Factory 설정

Table 38. 주요 설정
항목(*는 필수값)	설명	비고
ResourceAdapter	사용할 Resource Adapter 지정
TransactionSupport	Global Transaction 여부 지정	다음과 같은 타입을 제공함 XA LOCAL NONE
PoolMaxSize	ActiveMQ broker에 연결되는 물리적인 커넥션의 최대 개수	Default : 10
PoolMinSize	ActiveMQ broker에 연결되는 물리적인 커넥션의 최소 개수	Default : 0
ConnectionMaxWaitTime	커넥션 최대 대기시간	Default : 5 Seconds
ConnectionMaxIdleTime	반납되기전 최대 idle시간	Default : 15 Minutes

Queue 설정

Table 39. 주요 설정
항목(*는 필수값)	설명	비고
Destination	Queue의 이름 지정

Topic 설정

Table 40. 주요 설정
항목(*는 필수값)	설명	비고
Destination	Topic의 이름 지정

JMS 기능은 Enterprise Edition에서 제공되는 기능으로 되는 기능으로 Enterprise 버전의 WAS를 설치 시 사용 가능하다.

JTA

Enterprise Edition의 경우 Transaction Manager의 설정 변경 기능을 제공한다.

Transaction Manager의 설정을 기본 설정으로 사용하려면 Managed Type을 Auto로 선택한다. (설치 시 default)

Transaction Manager의 설정을 변경하고자 한다면 User Defined를 선택한다. (User Defined를 선택시 Recovery 옵션은 default로 "No"가 선택된다)

주요 설정

Table 41. 주요 설정
항목(*는 필수값)	설명	비고
Managed Type	User Defined Transaction Manager 여부 선택	Default : Auto
ID(*)	Transaction Manager의 이름
Default TimeOut(min)	Timeout 지정	Default : 10 minutes
Type	JTA Type
Recovery	Transaction 오류 시 복원여부 설정	Yes를 선택한 경우 Logging 설정이 열림

Transaction Recovery Logging(howl) Option

Table 42. Transaction 오류 시 복구를 위한 로깅 설정
항목(*는 필수값)	설명	비고
Directory	로그파일을 생성할 디렉토리 위치	Default : txlog
File Name	로그 파일 명	Default : howl
File Extension	로그 파일의 확장자	Default : log
Max Log Files	생성되는 로그파일의 최대 개수	Default : 2
Max Block Per File	파일당 최대 블록 수	Default : -1
Buffer Size	버퍼사이즈(kb)	Default : 32
Max Buffers	버퍼의 최대값	Default : 0
Min Buffers	버퍼의 최소값	Default : 4
Adler32 Checksum	Adler32 Checksum, Checksum Enabled 설정이 모두 "Yes"인 경우 Adler32 알고리즘을 사용하여 checksum을 계산	Default : Yes
Checksum Enabled	Buffer의 Contents를 Disk에 기록 전 체크	Default : Yes
Threads Waiting	대기하는 스레드의 최대 갯수	Default : -1
Flush SleepTime	ForceManager의 총 sleep 시간	Default : 50 Milliseconds

JTA 기능은 Enterprise Edition에서 제공되는 기능으로 되는 기능으로 Enterprise 버전의 WAS를 설치 시 사용 가능하다.

4.3.10. Application 배포

화면 상단의 SERVER 메뉴를 선택하여 Server 현황을 조회한다. 좌측 메뉴에서 배포할 Server의 Application을 선택한다. 배포가 완료된 Application의 목록을 조회하는 화면을 제공한다.

Application 목록의 항목은 아래와 같다.

Table 43. Application List 항목
항목	설명	비고
Type	배포할 Application의 형태	Enterprise WAS Type 인 경우만 다음과 같은 타입을 제공함 EJB EAR WAR
Base Name	Base 명
Context Path	Context 경로
DocBase	Application의 위치
Status	Application 상태	아래와 같은 상태를 제공함 Started(v) Stop(ㅁ) Error(!)
	Action 버튼	아래와 같은 기능을 제공함 Undeploy(휴지통) 버튼 Application Start 버튼 Application Stop 버튼 Application Reload 버튼
	View 버튼	아래와 같은 기능을 제공함 web.xml View(문서) 버튼

Deploy

Application 을 배포하기 위한 속성은 아래와 같다.

Table 44. Application 배포 속성
항목(*는 필수값)	설명	비고
Application Type	배포할 Application의 형태	Enterprise WAS Type 인 경우만 다음과 같은 타입을 제공함 EJB EAR WAR
Context Path(*)	Context 경로
unpackWAR	WAR파일을 전개하고 나서 실행할 것인지의 여부. 값이 false인 경우, WAR 파일의 압축을 풀지 않고 배포	Default : true
DocBase(*)	Application의 위치	Upload 선택(파일) 버튼 을 통해 파일을 업로드 할 수 있음

Application Upload

별도의 배포 시스템이 없는 경우 Manager를 통해 application을 upload 할 수 있다.

서버를 선택한 후 Applications 를 선택하여 Application 화면으로 이동한다.
Applications 화면 하단의 Application Deploy 영역에서, DocBase 항목 우측 끝에 있는 Upload 선택(파일) 버튼 을 클릭하면 파일시스템 화면이 출력된다.
upload 할 target 디렉토리(Server 쪽 Host)를 선택한다.
Upload 버튼 을 클릭하면 application 파일을 선택할 수 있는 팝업이 생성된다.
배포할 application 파일을 선택하고 Upload 버튼 을 클릭하면 선택한 파일이 target 디렉토리로 upload 된다.

Import

Import 버튼 을 클릭하여, [Resource] 메뉴에서 등록한 Application 정보를 가져와 배포할 수 있다.

설정 정보 관리

Application 목록조회 화면에서 Application Name을 선택하면 Application 설정 관리화면을 조회할 수 있다. Application Descriptor 와 DataSource에 대한 설정 및 관리 기능을 제공한다.

Application 설정 변경은 선택한 Server에서만 가능하다.

Application Settings

Application Descriptor에 설정된 정보를 관리한다.

뒤로가기(←) 버튼 을 클릭하여 Application 목록화면으로 돌아갈 수 있다. Expand all 버튼 을 클릭하여 Context의 추가적인 속성을 설정할 수 있다.

DocBase와 ContextPath는 수정할 수 없으며, 속성의 자세한 정보는 아래와 같다. 최초 화면에서 보이지 않는 속성은 Expand all 버튼 을 클릭해 확인할 수 있다.

Table 45. Application Setting
항목(*는 필수값)	설명	비고
DocBase(*)	Application의 Document Base
Context Path(*)	Context 경로
unpackWAR	WAR파일을 전개하고 나서 실행할 것인지의 여부. 값이 false인 경우, WAR 파일의 압축은 풀리지 않고, 웹 애플리케이션은 단지 압축된 채로 재배치	Default : true
reloadable	Application 변경 시(Class File) 재 반영 여부
privileged	Container Servlet의 사용 여부
cookies	session identifier 통신에 cookie 사용 여부
useHttpOnly	client side에서 스크립트를 활용하여 session ID로의 접근 차단 여부
session Cookie Domain	설정했을 경우 웹 어플리케이션에서 설정된 모든 도메인을 덮어씀. 설정하지 않을 경우 웹 어플리케이션에 의해 구분된 domain이 사용됨
session Cookie Name	설정하면 해당 이름으로 모든 세션 쿠키가 생성됨	Default : JSESSIONID
session Cookie Path	설정할 경우 웹 어플리케이션은 해당 경로를 사용
useNaming	J2EE 플랫폼을 위한 JNDI InitialContext를 사용하기 위해 설정	Default : true

Add Attribute 버튼 을 사용하여 속성 값을 추가할 수 있다.

DataSource Link List

Global DataSource를 Application에서 사용할 수 있도록 설정 기능을 제공한다.

DataSource 링크 관리의 속성은 아래와 같다.

Table 46. DataSource 링크 관리 속성
항목(*는 필수값)	설명
Name(*)	Application에서 사용할 JNDI 이름
JNDI Name(*)	Global DataSource의 JNDI이름
User Name	DataSource 접속 사용자 명
URL	JDBC URL
Description	DataSource에 대한 설명
+ 아이콘	New 버튼, 수정(연필) 버튼 을 클릭하여 선택된 DataSource정보가 변경 중임을 표시
- 아이콘	삭제(휴지통) 버튼 을 클릭하여 선택된 DataSource 정보가 삭제됨을 표시

New 버튼 을 클릭하면 신규 설정을 추가할 수 있고, Save 버튼 을 클릭하면 변경된 설정이 저장된다.

WAS에 설정된 Datasource 중 Scope가 Global 또는 Global + ResourceLink로 되어있는 Datasource가 신규 설정시 JNDI Name의 선택항목으로 나온다.

4.3.11. Server Log Viewer

서버 목록의 우측 Log Viewer 버튼으로 대상 서버의 Log Home 경로 하위의 로그 파일 내용을 탐색할 수 있다.

이 기능을사용하기 위해서는 다음을 만족해야 한다.

대상 서버가 속한 Node 가 기동중이어야 한다.

서버 목록의 Log Viewer 버튼을 클릭하면 대상 서버의 Log Home 경로를 기준으로 디렉토리 및 파일을 트리 구조로 확인 할 수 있다.

파일을 선택하면 파일의 내용을 조회하며, 처음 선택 시 해당 파일의 맨 끝부터 정해진 크기만큼의 파일 내용을 확인 할 수 있다.

Load More, Load Previous 버튼을 사용하여 정해진 크기만큼 로그 파일의 내용을 조회 및 확인 할 수 있다.

Load Previous 버튼 사용 중 더 이상 조회할 내용이 없는 경우(eg. 파일의 맨 처음), 화면에 Alert 으로 더 이상 읽어들일 데이터가 없다는 메시지가 출력된다.
Load More 버튼 사용 중 회하는 경우 더 이상 조회할 내용이 없는 경우(eg. 파일의 맨 끝),더 이상 읽어들일 데이터가 없다는 메시지가 화면 하단에 표기 된다.

4.4. WAS(FE)

WAS를 관리하기 위한 화면을 제공한다. WAS(FE)는 서버 목록에서 Server Type이 Enterprise/FE로 표시된다.

서버의 목록 조회, 수정, 삭제, 시작/종료(Start/Stop, Multi Start/Stop, Forced Stop/Restart) 등 공통 관리 절차는 WAS(SE/EE)와 동일하므로 앞의 WAS(SE/EE) 절(목록, 수정, 삭제, Start/Stop)을 참고한다. 이 절에서는 WAS(FE)에 해당하는 차이점과 고유 기능을 설명한다.

Figure 7. WAS(FE) Server List

4.4.1. Install

Install 버튼 을 클릭하여 Server의 설치를 준비한다.
설치 정보를 입력한 후 확인 버튼 을 클릭하면 설치가 진행된다.

WAS(FE)의 관리 포트(Management Port)와 관리 계정은 설치 시 입력하지 않는다.

관리 포트는 HTTP 포트번호 + 1910 으로 자동 산출된다.
관리 계정은 LENA가 설치/기동 과정에서 자동으로 등록하고 관리한다.

4.4.2. 설정 정보 관리

Server의 설정 정보를 변경하는 기능을 제공한다. Server 목록에서 변경하려는 Server 명을 선택한다. WAS(FE) 서버는 General, Logging, Environment, Properties, Config Tree, History 탭을 제공한다.

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

General

Server의 일반적인 설정 정보와 Undertow Worker/Listener 정보를 관리한다.

Server Info 영역에서 관리하는 항목은 아래와 같다.

Table 47. Server Info 속성
항목(*는 필수값)	설명	비고
HTTP Port(*)	서비스 HTTP Port
AJP Port	AJP Listener Port	HTTP 포트번호 - 71 (자동 계산)
Install Path	Server 설치 경로
Java Home Path	Server가 사용하는 JDK 경로
Minimum Heap Size(MB)(*)	JVM Heap 최소 크기	Default : 2048m
Maximum Heap Size(MB)(*)	JVM Heap 최대 크기	Default : 2048m
Bind Address	서비스 바인딩 주소	Default : 0.0.0.0
Jvm Route	로드밸런싱 식별 값. 불러오기(새로고침) 버튼 으로 기본값을 가져올 수 있다.
Shutdown Timeout(s)	종료 대기 시간	Default : 0
Management Port	관리 콘솔 및 관리 API 접근 포트	HTTP 포트번호 + 1910 (자동 계산)

Management Port는 HTTP 포트번호 + 1910 으로 자동 산출되며 화면에서는 확인만 할 수 있다. 관리 인터페이스는 127.0.0.1(loopback)으로 바인딩되어 외부에서 직접 접근할 수 없다.

Worker & Listener 영역에서는 Undertow 서브시스템의 Worker와 HTTP/AJP Listener 정보를 관리한다.

Table 48. Worker 속성
항목(*는 필수값)	설명	비고
Worker Name	Undertow Worker 이름
Max Threads	최대 작업 스레드 수	Default : 256 (비우면 cpuCount × 16 자동 산출)
Core Threads	기본 작업 스레드 수	Default : 32 (비우면 서버가 자동 결정)
IO Threads	IO 스레드 수	Default : 16 (비우면 cpuCount × 2 자동 산출)

Table 49. Listener 속성
항목(*는 필수값)	설명	비고
Protocol	Listener 프로토콜(HTTP/AJP 등)
Port / Redirect Port	Listener Port 및 Redirect Port
Worker	Listener가 사용할 Worker 선택	미지정 시 기본 Worker 자동 적용
Reading Timeout	요청 읽기 제한 시간	Default : HTTP 60000ms / AJP 300000ms
Request Parsing Timeout	요청 파싱 제한 시간	Default : HTTP 20000ms / AJP 60000ms
URI Encoding	URI 인코딩	Default : UTF-8
Packet Size	AJP 패킷 크기	AJP Listener 전용, Default : 8192, 최대 65536

빈 칸으로 표시된 항목은 서버 설정 파일에 명시 설정이 없으며 서버가 시스템 리소스에 따라 자동 결정한다.

서버가 기동 중일 때 Worker & Listener 설정을 저장하면 처리 중인 요청 완료를 대기한 후 reload되며, 대기 한도 초과 시 중단될 수 있다.

Logging

Server의 Logging 설정 정보를 관리한다. Log Home, Access Log, Handler, Logger 설정을 조회/수정할 수 있다.

Log Home 영역에서 관리하는 항목은 아래와 같다.

Table 50. Log Home 속성
항목(*는 필수값)	설명	비고
Log Home(*)	로그 디렉토리 경로. Default 또는 직접 입력을 선택한다.	Default 선택 시 Server 설치 경로 하위 logs 디렉토리 사용
Retention Days(*)	로그 보관 일수	Default : 0 (삭제하지 않음)

Access Log 영역에서는 Undertow Server와 Host를 선택하여 접근 로그의 상세 설정을 관리한다. 설정을 입력한 후 Save 버튼 으로 저장하며, Clear Config 버튼 으로 설정을 제거할 수 있다.

Table 51. Access Log 속성
항목(*는 필수값)	설명	비고
Undertow Server / Undertow Host	Access Log를 설정할 Undertow Server와 Host 선택
Logging Directory	Access Log 파일이 생성될 디렉토리
Pattern	Access Log 기록 패턴
Prefix	Access Log 파일명 접두어
Suffix	Access Log 파일명 접미어

Handler List 영역에서는 로그 Handler 목록(Name, Type, Level, Root Handler)을 조회하고, New 버튼 / Delete 버튼 으로 Handler를 추가/삭제할 수 있다. Handler를 선택하면 상세 정보를 수정할 수 있다.

Table 52. Handler 상세 속성
항목(*는 필수값)	설명	비고
Name(*)	Handler 이름
Type	Handler 유형	ConsoleHandler FileHandler PeriodicRotatingFileHandler
Level	기록할 로그 레벨 (ALL, FINEST, FINER, TRACE, DEBUG, FINE, CONFIG, INFO, WARN, WARNING, ERROR, SEVERE, FATAL, OFF)
Encoding	로그 인코딩
Formatter	로그 출력 형식	Default : %d{HH:mm:ss,SSS} %-5p [%c] (%t) %s%e%n
Filter	로그 필터 식
Root Handler	Root Logger에 연결할지 여부 (Y/N)
Autoflush	로그 즉시 기록 여부	Default : true
Enabled	Handler 활성화 여부	Default : true
Target	출력 대상	ConsoleHandler 전용
Append	기존 파일에 이어쓰기 여부	파일 계열 Handler 전용, Default : true
File Path(*)	로그 파일 경로	파일 계열 Handler 전용
File Relative To(*)	로그 파일 기준 경로	파일 계열 Handler 전용
Suffix(*)	로그 파일 순환 주기 접미어	PeriodicRotatingFileHandler 전용

Logger List 영역에서는 Logger 목록(Name, Level)을 조회하고, New 버튼 / Delete 버튼 으로 Logger를 추가/삭제할 수 있다. Logger를 선택하면 상세 정보를 수정할 수 있다.

Table 53. Logger 상세 속성
항목(*는 필수값)	설명	비고
Name(*)	Logger 이름(카테고리)
Level(*)	기록할 로그 레벨 (ALL, TRACE, DEBUG, INFO, WARN, ERROR, FATAL, OFF)	Default : INFO
Handler	Logger에 연결할 Handler 선택

Environment

Server의 JVM 옵션과 환경 설정 파일을 편집하는 화면을 제공한다. 파일 에디터를 통해 수정한 후 각 영역의 Save 버튼 을 클릭하여 저장한다.

편집 가능한 영역은 아래와 같다.

Table 54. Environment 편집 영역
항목(*는 필수값)	설명	비고
JVM Env	JVM 옵션 설정 파일을 편집한다.
Custom Env	사용자 정의 환경 파일(customenv.sh)을 편집한다.
Base Env	기동 환경 파일(Start Shell)을 편집한다.	운영 환경 설정에 따라 편집이 잠길 수 있음
System Properties	서버 설정 파일의 system-properties 항목을 편집한다.

JVM_ROUTE 값은 여기서 직접 수정하지 않고, General 탭의 Jvm Route 항목을 사용하여 수정한다.

Properties

Server에 적용된 Key Properties, System Properties, System Environments를 확인하는 화면을 제공한다. 이 탭은 조회 전용이며 값을 수정할 수 없다.

Key Properties : 주요 System Property를 별도로 표시한다.
System Properties : 서버 프로세스의 전체 System Property 목록을 표시한다.
System Environments : 서버 프로세스의 OS 환경 변수 목록을 표시한다.

Config Tree

Server 설치 경로 하위의 설정 파일들을 파일 트리를 통해 조회하고 편집할 수 있다.

좌측 트리에서 설정 파일을 선택하면 우측 영역에 파일 내용이 표시된다.
파일 내용은 기본적으로 읽기 전용으로 표시된다.
편집 버튼 을 클릭하면 쓰기 가능한 파일에 한해 편집할 수 있으며, 저장 버튼 으로 저장한다.

Node Agent를 실행하는 사용자가 설정 파일의 접근 권한이 있어야 수정이 가능하다.

History

설정 정보의 백업 및 복원 기능을 제공한다. 설정 정보를 수정하여 저장하면 유형별로 History를 관리한다.

파일명과 수정 일시(날짜 범위)를 입력하여 검색한다.
설정 파일 Type(General, Logging, Environment, Config Tree)을 선택하여 검색 범위를 지정할 수 있다.
검색 결과에서 이력을 선택하여 내용 확인 및 복원을 수행한다.

4.4.3. Application 배포

WAS(FE) 서버에 Application의 배포, 재배포, 배포 해제를 수행할 수 있다. 화면 상단의 SERVER 메뉴에서 Server를 선택한 후 좌측 메뉴에서 Applications를 선택한다. 배포가 완료된 Application 목록에서는 Type, Runtime Name, Context Path, Status를 확인할 수 있다.

Application 을 배포하기 위한 속성은 아래와 같다.

Table 55. Application 배포 속성
항목(*는 필수값)	설명	비고
Application Type	배포할 Application의 형태	WAR EJB EAR JAR
Context Path(*)	Context 경로. WAR 배포 시에만 입력하며, 단일 레벨 경로만 지원한다.	WAR 전용
Application File(*)	Application의 위치	Upload 선택(파일) 버튼 을 통해 파일을 업로드 할 수 있음

Runtime Name은 서버가 배포를 실행하는 데 사용하는 내부 별칭으로, 배포 시 직접 입력하지 않는다.

WAR 배포 시 Context Path로부터 파생된다.
값이 비어 있으면 배포 파일명이 자동으로 사용된다.
배포가 완료된 Application 목록의 Runtime Name 컬럼에서 확인할 수 있다.

배포 파일의 확장자 규칙(.war 등)이 검증된다.

4.4.4. 모니터링

WAS(FE) 서버는 모니터링 대시보드에서 다음과 같은 차이가 있다. 화면 구성은 기존 WAS(SE/EE)의 모니터링 화면과 동일하며, 대시보드 사용 방법은 Diagnostics 챕터의 Monitoring Dashboard 절을 참고한다.

스레드풀 : WAS(FE)는 HTTP/AJP Listener가 단일 Undertow Worker를 공유하므로 대시보드에 worker 대표값 1개로 통합 표시된다.
DB Conn Usage : 서버 설정 파일에 정의된 DataSource의 풀 사용량이 표시된다.
연결 서버 : HA 클러스터 멤버로 인식된 서버 목록이 표시된다.

4.5. WEB

NODE의 Engine이 EN-A, EN-N 인 Web Server를 관리하기 위한 화면을 제공한다. Node에 설치한 Web Server의 등록, 수정, 삭제가 가능하며, 시작과 종료를 수행할 수 있다.

4.5.1. 목록

Web Server List를 통하여 각 Web Server를 관리할 수 있다.

Web Server의 속성은 아래와 같다.

Table 56. Web Server 속성
항목(*는 필수값)	설명	비고
Status	Server의 상태	아래와 같은 상태를 제공함 Started(v) Stop(ㅁ) Error(!)
Name(*)	Server의 이름
Address	Server의 IP주소
Server ID	Server의 ID
Engine	Node의 Engine 타입	EN-A EN-N
HTTP Port	HTTP 포트번호
HTTPS Port	HTTPS 포트번호
SSL	Shell 실행시 SSL 기반의 패스워드 사용여부	Web Server에 SSL 관련 설정을 해야함
시작/중지 버튼	Server의 시작 및 종료
버튼 영역	서버 정보 변경 및 관련 기능 버튼을 표시	휴지통 아이콘 - 서버 정보를 삭제 펜 아이콘 - 서버 정보를 수정 Log 파일 아이콘 - Server Log Viewer 기능 제공 더보기 아이콘 - Start/Stop을 수행할 수 있는 메뉴 제공

4.5.2. Install

Install 버튼 을 클릭하여 Server의 설치를 준비한다.
Server ID와 Service Port를 입력한다.
Save 버튼 을 클릭하여 저장한다.

Node에 실제 설치되어 있는 Server와 Manager에서 관리하는 Server의 정보에는 차이가 있을 수 있다. (console기반 설치 시)

Server ID 중복 오류가 발생하는 경우, Register 기능을 이용하여 설치된 Server 정보를 추가로 확인해야 한다.

4.5.3. Clone

Clone 버튼 을 클릭하여 Web Server의 복제를 준비한다.
Node List를 선택하여 복제할 Server를 선택한다.
Clone Server ID와 Service Port를 입력한다.

(Include External Source는 다른 노드로 서버를 복제하는 경우 사용가능하며, 복제할 서버의 Document Root 디렉토리에 있는 파일도 함께 복제하는지 여부를 설정한다.)
Save 버튼 을 클릭하여 저장한다.

Node에 실제 설치되어 있는 Server와 Manager에서 관리하는 Server의 정보에는 차이가 있을 수 있다. (console기반 설치 시)

Server ID 중복 오류가 발생하는 경우, Register 기능을 이용하여 설치된 Server 정보를 추가로 확인해야 한다.

4.5.4. Register

Register 버튼 을 클릭한다.
등록하려는 Server를 선택한다.
Save 버튼 을 클릭하여 저장한다.

4.5.5. 수정

수정(연필) 버튼 을 클릭하여 Server 정보를 수정 가능한 상태로 변경한다.
Server의 속성을 수정한다.
Save 버튼 을 클릭하여 저장한다.

4.5.6. 삭제

삭제(휴지통) 버튼 을 클릭하여 Server정보를 삭제 가능한 상태로 변경한다.
Save 버튼 을 클릭한다.
OK 버튼 을 누르면 삭제 유형을 선택하는 창이 출력된다.
- Deregister : Manager DB에서만 해당 Server 정보를 삭제하고 물리적인 Server engine은 유지 (추후 Register 버튼 을 통해 다시 등록 가능)
- Uninstall : Manager DB에서 해당 Server 정보를 삭제하고 물리적인 Server engine도 삭제

Uninstall 선택시, 로그 디렉토리 삭제여부를 묻는 창이 출력된다.

Server Cluster에 묶여있는 서버는 삭제할 수 없다.

4.5.7. Start/Stop

Single Start/Stop

Stop 버튼 을 클릭하여 Server를 종료한다.
Start 버튼 을 클릭하여 Server를 시작한다.

Server를 중지시 General 탭의 Stop Mode 에 따라 종료 방식이 달라진다.

Stop : 기본 종료 옵션으로 현재 서비스중인 작업을 보장하지 않는다.
Graceful Stop : 현재 서비스중인 작업을 완료한 후 종료한다. (Window 에서는 서비스 보장하지 않음)

시작 가능한 상태일 경우에만 Start 버튼 이 활성화 된다.

Multi Server Start/Stop

시작 혹은 종료하고자 하는 복수개의 Server를 선택한다.
Server 목록 하단의 Multi Action 버튼 을 클릭한다.
팝업창에서 Action Type을 선택 후 Action 버튼 을 클릭하여 복수개의 Server에 대한 시작 혹은 종료 작업을 수행한다.

Forced Stop/Restart

Server 목록 가장 우측의 … 버튼 을 클릭한다.
강제 종료 혹은 강제 재시작을 수행한다.

4.5.8. 설정 정보 관리 (EN-A)

Web Server의 EN-A 엔진의 설정 정보를 변경하는 기능을 제공한다. Web Server 목록에서 Server를 선택하면 설정 정보를 관리하는 화면으로 이동한다.

General

Web Server의 일반적인 설정 값과 Connection, Process 정보를 편집할 수 있다.

Web Server의 설정 정보는 저장 시 설정 파일에 대한 Validation을 수행하게 되어 있으며, 설정 파일 오류로 인한 Server 기동 장애가 발생을 최소화하고 있다.

설정 파일 오류 시 파일이 저장되지 않고 오류 메시지가 출력된다

오류 메시지 예

AH00526: Syntax error on line 253 … Argument for 'Require all' must be 'granted' or 'denied'

설정 정보의 상세 내용은 다음과 같다.

Server Info (env.sh과 /conf/httpd.conf 파일 관리)

Table 57. Server Info
항목(*는 필수값)	설명	비고
HTTP Port(*)	HTTP Port
HTTPS Port(*)	HTTPS Port
Staging HTTP Port	Staging 모드로 기동 시 사용하는 서비스 포트	Graceful restart 시에 이용됨 LENA는 기본 nostage 모드
Staging HTTPS Port	Staging 모드로 기동 시 사용하는 HTTPS 포트	Graceful restart 시에 이용됨 LENA는 기본 nostage 모드
Install Path	Server 설치 경로
Document Root(*)	Web Server에서 제공하는 문서들이 저장되어 있는 기본 폴더 경로
Welcome Page	웹사이트의 초기페이지 문서로 어떤 파일을 사용할 것인지 정의
Stop Mode	Web Server 종료시 참조하는 옵션	Stop : 기본 종료 옵션으로 현재 서비스중인 작업을 보장하지 않는다. Graceful Stop : 현재 서비스중인 작업을 완료한 후 종료한다. (Window 에서는 서비스 보장하지 않음)
Directory/Path	어떤 서비스와 기능을 허용/거부 할지를 설정할 웹 문서들이 있는 디렉토리 경로
Directory/Options	지정한 디렉토리 이하의 모든 파일과 디렉토리들에 적용할 접근 제어 설정	Indexes : welcome page를 찾을 수 없을 때, Document Root 하위의 파일 목록을 보여주는 것을 방지 FollowSymLinks : Document Root 하위에 기존의 웹문서 이외의 파일시스템에 심볼릭링크로 접근 하는 것을 방지
Directory/Allow Override	Document Root 하위 디렉토리 별 리소스 접근 제어 설정 파일 (일반적으로 AccessFileName : .htaccess)에 대하여 어떤 지시자 사용을 허가할 것인지 설정	다음과 같은 유형이 존재함 * None : 어떠한 지시자도 허용하지 않음 * All : 모든 지시자 사용가능 * AuthConfig : 사용자 인증 지시자 허용 * FileInfo : 문서 유형 제어 지시자 허용 * Indexes : 디렉토리 Indexing 제어 지시자 허용 * Limit : 호스트 접근 제어 지시자 허용
Directory/Require	인증된 사용자가 허가된 Action을 수행하는지 검증

Connection Info (/conf/extra/httpd-default.conf 파일 관리)

Table 58. Connection Info
항목(*는 필수값)	설명	비고
Timeout(s)(*)	클라이언트와 Server간에 연결 후 일정 시간 동안 아무 이벤트가 발생하지 않았을 때 Server가 기다리다가 연결을 끊을 시간(s)	Default : 60
Keep Alive(*)	특정 한 프로세스가 특정 사용자의 요청작업을 계속해서 처리할지 여부	Default : On
Max Keep Alive Requests(*)	KeepAlive가 On일 때 유효한 값으로 하나의 프로세스가 특정 사용자의 요청을 지정한 횟수만큼 처리 이 값을 넘어서면 해당 프로세스는 죽고 다른 프로세스가 요청을 처리함	Default : 100
Keep Alive Timeout(s)(*)	KeepAlive가 On 일 때 유효한 값으로 설정한 시간 동안 요청이 없으면 연결을 끊기 위해 타임아웃 시킴(s)	Default : 5
Request Read Timeout(s)(*)	사용자로부터 request header와 body를 받기 위해 기다리는 시간 설정된 시간 안에 받지 못하면 408 REQUEST TIME OUT 에러를 보냄	Default : header=20-40,MinRate=500 body=20,MinRate=500

Process Info (/conf/extra/httpd-mpm.conf 파일 관리)

Table 59. Process Info
항목(*는 필수값)	설명	비고
Start Servers(*)	Web Server 기동 시 초기화 되는 Server 프로세스 수	Default : 2
Server Limit(*)	MaxClients가 생성할 수 있는 최대 프로세스 값	Default : 8
Threads Per Child(*)	각각의 자식 프로세스가 생성하는 Thread 수	Default : 128
Thread Limit(*)	ThreadsPerChild의 설정 가능한 최대 값	Default : 128
Min Spare Threads(*)	Idle 상태에서 Idle Thread 개수가 이 값보다 적을 때 Thread가 이 값까지 늘어나 유지	Default : 128
Max Spare Threads(*)	Idle 상태에서 Idle Thread 개수가 이 값보다 많을 때 Thread가 이 값까지 줄어들어 유지	Default : 256
Max Request Workers(*)	전체 자식 프로세스가 생성할 수 있는 최대 Thread 수	Default : 1024
Max Connection Per Child(*)	자식 프로세스가 서비스 할 수 있는 최대 요청 수. 이 값만큼 요청을 처리한 후 종료한다.	Default : 0 (0: 제한없음)

Web Server가 mpm event 방식을 사용할 수 있는 환경인 경우 Process Info 설정을 간편하게 할 수 있는 기능을 제공한다.

Web Server 의 Process Info 설정 시 우측 상단의 Auto Calculation 을 체크하면 기본 제공되는 설정 값 유효성 검사 외에 간편 자동계산 기능이 제공된다.

규칙

유효성 검사

자동 계산

StartServer ≤ ServerLimit

●

ThreadsPerChild ≤ ThreadLimit

●

ThreadsPerChild + MinSpareThreads ≤ MaxSpareTheads

●

ThreadsPerChild 변경 시 MinSpareThreads, MaxSpareThreads 자동 계산

ServerLimit × ThreadLimit ≤ MaxRequestWorkers

●

ServerLimit, ThreadLimit 변경 시 MaxRequestWorkers 자동 계산

Pagespeed Info

Table 60. Pagespeed Info
항목(*는 필수값)	설명	비고
Enabled(*)	mod_pagespeed를 적용하여 Web Server가 제공하는 Resource에 대한 최적화를 수행하여 사이트 속도를 높일지 여부	Default : off 다음과 같은 옵션을 제공함 on : Resource들에 대해 최적화 허용 off : 추가적인 최적화를 중지하나, 기존에 최적화 되어있는 Resource들에 대한 접근 허용 unplugged : 최적화 중지 및 접근 불허
Rewrite Level(*)	모듈이 rewrite할 필터의 Level 설정	Default : default(CoreFilters) 다음과 같은 옵션을 제공함 CoreFilters : 사전에 대부분의 웹사이트에서 안전하다고 생각하는 필터가 포함되어있음 OptimizeForBandwidth : 안전성을 강화하며, Pagespeed를 인식하지 못하는 사이트에서 사용하기 적합 PassThrough : 필터를 전부 수동으로 입력
File Cache Path(*)	Caching 될 File들이 저장되는 디렉토리의 경로
LogDirPath(*)	Log를 기록할 디렉토리의 경로
Enable Filters	사용할 필터들의 목록
Disable Filters	사용하지 않을 필터들의 목록
Allow URI	rewrite를 허용할 Resource들의 와일드카드(*)를 포함한 URI	예) /.js
Disallow URI	rewrite를 허용하지 않을 와일드카드(*)를 포함한 URI

Enable Custom

Table 61. Custom Configuration
항목(*는 필수값)	설명	비고
Custom Configuration	사용자가 임의로 추가하고 싶은 설정을 추가 합니다.	custom-httpd.conf 파일에 별도로 저장되어, 관리합니다.

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

Connector

Web Server와 WAS를 연계하기 위한 정보를 관리한다.
Connector 페이지는 연계 방식에 따라 JK와 Proxy 탭으로 나누어져 있으며, 각 탭에서 모듈에 따른 Connector 설정 정보를 편집할 수 있다.

JK

JK(mod_jk)를 사용할 때의 설정 정보를 편집한다.

JK 탭의 설정은 위 화면과 같이 Connector Info, Load Balancer, URI Pattern Group의 세 가지 영역으로 나누어져 있다.

Connector Info
JK의 기본 설정 값을 관리한다.

Table 62. Connector Info (JK)
항목(*는 필수값)	설명	비고
Type(*)	Web Server와 WAS가 통신할 때 사용하는 프로토콜이다. (ajp12, ajp13, ajp14, jni, lb 그리고 status 중 하나를 사용할 수 있으나 ajp13, lb, status를 권장한다.)	Default: ajp13
Load Balancing Factor(*)	WAS의 부하 분산 지수. 즉, 작업량 할당 비율을 의미한다.	Default: 1
Request Read Timeout(s)(*)	JK와 원격 호스트 간의 통신 채널에 사용되는 Timeout(초)이다. 지정된 시간 초과 내에 원격 호스트가 응답하지 않으면 JK가 오류를 발생시키고 다시 시도한다. 0(기본값)으로 설정하면 JK는 모든 소켓 작업에서 계속 응답을 기다린다.	Default: 300
Socket Connect Timeout(s)(*)	JK와 원격 호스트 간 소켓 연결을 구성하는 데에 걸리는 시간(초)의 임계치를 의미한다. 지정된 시간 내에 소켓 연결을 구성하지 못하면 JK가 오류를 발생시키고 재연결을 시도한다.	Default: 5
Socket Keep Alive(*)	Web Server와 WAS 사이에 방화벽이 존재하는 경우 비활성화 된 연결을 버리도록 되어있으나, 이 속성이 TRUE일 때에는 운영 체제에 KEEP_ALIVE 메시지를 보내도록 함으로써 방화벽이 비활성화 된 연결을 끊지 못하도록 한다.	Default: TRUE
Connect Timeout(*)	connectTimeout: JK와 WAS 간 연결이 완료된 후, ajp13 프로토콜에서 cping request에 대한 cpong respond 대기 시간(s)을 의미한다.	Default: 10
Connection Pool Size(*)	JK와 WAS 간 커넥션 풀로 유지 관리되는 커넥션 개수를 의미한다.	Default: 128
Connection Pool Min Size(*)	JK와 WAS 간 커넥션 풀로 유지 관리되는 커넥션의 최소 개수를 의미한다.	Default: 32
Connection Pool Timeout(s)(*)	JK가 비활성화 된 소켓을 닫기 전에 유지해야 하는 시간(초)을 지정한다. 0으로 지정 시 소켓을 닫는 것을 비활성화 한다.	WAS의 connectionTimeout 옵션과 함께 사용한다. Default: 20
Log Level(*)	로그 파일에 기록될 로그 수준을 지정한다.	Default: error
Log Format(*)	로그 파일에 어떤 포맷으로 로그를 남길지 설정한다.	Default: "[%a %b %d %H:%M:%S %Y]"
Status(*)	Server 상태 모니터링 설정값 셋팅 여부로, Enable 선택시 Status Url과 Allow IP를 설정할 수 있다.	Default: Enable
Status Url(*)	Server 상태 모니터링을 위한 URL이다.	Default: /jk-status/
Status Allow IP(*)	Server 상태 모니터링 URL에 접근 가능한 IP이다.	Default: 127.0.0.1

Load Balancer
부하 분산을 위해 Load Balancer의 기본 설정 및 Worker를 관리한다.
Load Balancer 영역에는 Overview 탭과 Configuration 탭이 존재하며, Overview 탭에서는 현재 생성되어 있는 Load Balancer의 전반적인 정보를 확인할 수 있고 Configuration 탭에서는 Load Balancer의 상세 내용을 구성할 수 있다.

Table 63. Load Balancer Info - Overview (JK)
항목(*는 필수값)	설명	비고
Load Balancer ID	현재 생성되어 있는 Load Balancer의 ID이다.
Target Server	Load Balancer에 등록된 Worker의 기본 정보이다. 'Node Name/Server Name' 형식으로 출력된다.
URI Pattern Group ID	특정 URI Pattern에서 Load Balancer를 지정한 경우, 해당 URI Pattern이 속해있는 URI Pattern Group ID가 출력된다.

Table 64. Load Balancer Info - Configuration (JK)
항목(*는 필수값)	설명	비고
Load Balancer ID(*)	Load Balancer의 이름이다.	'lb_'라는 접두사가 추가된다.
Sticky Session(*)	Session ID를 기반으로 라우팅을 지원할 지에 대한 여부이다.
Method(*)	Load Balancer가 부하를 분산하기 적절한 Worker를 판별하는데 사용하는 방법을 지정한다.	* R[equest] : 요청수가 가장 적은 Worker를 선택한다. (Default) * S[ession] : 연결된 세션이 가장 적은 Worker를 선택한다. * N[ext] : S[ession]과 비슷하지만 더 적은 수의 Session을 분산해야 하는 경우 선택한다. * T[raffic] : JK와 AJP커넥터 사이에 네트워크 트래픽이 가장 작은 Worker를 선택한다. * B[usyness] : 요청 수를 기반으로 가장 부하가 적은 Worker를 선택한다.
Session Cookie	Session Cookie 이름을 변경하고자 하는 경우 설정한다.	Default: JSESSIONID

Worker는 Load Balancer Worker List 테이블의 Add Worker 버튼으로 추가한다.
Add Worker 버튼을 눌렀을 때 Worker를 추가할 수 있는 창이 화면에 출력되며, 사용자는 이 창에서 LENA Manager에서 관리하는 서버를 Worker를 선택할 수 있다. 추가된 Worker는 아래와 같은 정보를 통해 관리된다.

Table 65. Load Balancer Worker List
항목(*는 필수값)	설명	비고
Node Name	Worker가 가리키는 서버의 노드 이름이다.
Server Name	Worker가 가리키는 서버의 이름이다.
Server Type	Worker가 가리키는 서버의 유형이다.	값으로 Standard 또는 Enterprise가 출력 된다.
Redirect	해당 Worker가 오류 상태일 때, 이 Worker가 받은 요청을 대신 처리 할 Failover Worker를 설정한다.	Default: NONE
Load Balancing Factor	작업량 할당 비율으로, 해당 Worker가 다른 Worker들에 비해 얼마나 많은 일을 할 지 정의한다.	Default: 1
Route ID	Worker의 Route ID이다.
Order	Worker들 간의 순서를 변경할 수 있다.

URI Pattern Group
Web Server로 들어온 요청들에 대해 URI 패턴을 검사하여 WAS로 전달하는 URI Mapping을 정의한다.

Table 66. URI Pattern Group (JK)
항목(*는 필수값)	설명	비고
URI Pattern Group ID(*)	URI 패턴을 그룹화하고 관리하는 데 사용되는 이름이다. Virtual Host에서 사용하는 URI Pattern Group일 경우, ID 옆에 어느 Virtual Host에서 사용하고 있는 지에 대한 정보가 함께 출력된다.	Group 생성 시 'uri_'라는 접두사가 추가된다.
Mode	URI 패턴을 LENA Manager가 관리하는 형식으로 입력할 지, 사용자 임의로 입력할 지 지정한다. 본 항목에 따라 Patterns to be Included/Excluded 또는 URI Patterns로 입력하는 화면이 출력된다. 이미 저장된 패턴이 LENA Manager가 관리하는 방식이라면 Standard로, 사용자 임의 형식이라면 Manual로 자동 지정된다.	Standard: LENA Manager URI Rule에 따른 입력 방식 Manual: 사용자 임의 입력 방식
Patterns to be Included	WAS로 전달 할 URI 패턴을 입력한다. 우측 Select box를 통해 Load Balancer를 선택해야 저장할 수 있다. ⓧ버튼을 통해 패턴을 삭제할 수 있다.	모든 문자를 허용하는 의미의 Asterisk(*)를 사용할 수 있으며 Hash(#), Equal(=)은 허용되지 않는다.
Patterns to be Excluded	WAS로 전달 하지 않을 URI 패턴을 입력한다. ⓧ버튼을 통해 패턴을 삭제할 수 있다.	모든 문자를 허용하는 의미의 Asterisk(*)를 사용할 수 있다.
URI Patterns	사용자 임의의 패턴을 입력할 시 사용한다.

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

Proxy

Proxy(mod_proxy)를 사용할 때의 설정 정보를 편집한다.

Proxy 탭의 설정은 Connector Info, Load Balancer, URI Pattern Group, Enable Custom의 네 가지 영역으로 나누어져 있다.

Connector Info
Proxy의 기본 설정 값을 관리한다.

Table 67. Connector Info (Proxy)
항목(*는 필수값)	설명	비고
Socket Connect Timeout(s)(*)	Apache httpd가 백엔드에 연결을 생성하는 것을 완료할때 까지 대기하는 시간(s)이다.	Default: 5
DNS Lookup Interval(s)(*)	DNS 조회 간격. 기능을 사용하지 않으려면 0으로 설정한다.	Default: 10
Request Read Timeout(s)(*)	Apache httpd가 백엔드에서 주고 받는 전송된 데이터를 기다리는 시간(초)이다.	Default: 300
Background ServerFault Check Interval(s)(*)	백엔드 서버와 연결된 Member가 오류 상태인 경우, 본 항목에 설정한 간격(초)으로 서버를 확인하고 서버가 정상 동작 하면 요청을 다시 전달한다. 기능을 사용하지 않으려면 0으로 설정한다.	Default: 10
ServerFault Retry Time(s)(*)	백엔드 서버와 연결된 Member가 오류 상태인 경우, Apache httpd timeout(초)이 만료될 때 까지 어떠한 요청도 해당 서버에 전달하지 않는다.	Background ServerFault Check Interval 항목이 0인 경우 수정 가능하다. Default: 60

Load Balancer
부하 분산을 위해 Load Balancer의 기본 설정 및 Member를 관리한다.
Load Balancer 영역에는 Overview 탭과 Configuration 탭이 존재하며, Overview 탭에서는 현재 생성되어 있는 Load Balancer의 전반적인 정보를 확인할 수 있고 Configuration 탭에서는 Load Balancer의 상세 내용을 구성할 수 있다.

Table 68. Load Balancer Info - Overview (Proxy)
항목(*는 필수값)	설명	비고
Load Balancer ID	현재 생성되어 있는 Load Balancer의 ID이다.
Target Server	Load Balancer에 등록된 Member의 기본 정보이다. 'Node Name/Server Name' 또는 'Address:Port' 형식으로 출력된다.
URI Pattern Group ID	특정 URI Pattern에서 Load Balancer를 지정한 경우, 해당 URI Pattern이 속해있는 URI Pattern Group ID가 출력된다.

Table 69. Load Balancer Info - Configuration (Proxy)
항목(*는 필수값)	설명	비고
Load Balancer ID(*)	Load Balancer의 이름이다.	'lb_'라는 접두사가 추가된다.
Sticky Session(*)	Session ID를 기반으로 라우팅을 지원할 지에 대한 여부이다.
Method(*)	Load Balancer가 부하를 분산하기 적절한 Member를 판별하는데 사용하는 방법을 지정한다.	* R[equest] : 요청수가 가장 적은 Member를 선택한다. (Default) * T[raffic] : 네트워크 트래픽이 가장 작은 Member를 선택한다. * B[usyness] : 요청 수를 기반으로 가장 부하가 적은 Member를 선택한다.
Session Cookie	Session Cookie 이름을 변경하고자 하는 경우 설정한다.
Protocol Type(*)	Member의 프로토콜 타입을 지정한다. Member가 지정되어 있지 않은 경우에만 변경 가능하다.	Default: HTTP
SSL Enable	Proxy용 SSL/TLS 프로토콜 엔진을 사용한다.	이 옵션은 설정이 불가능하며 오직 Protocol 설정에 따라 동작한다. Default: HTTP인 경우 Off, HTTPS인 경우 On
SSLProxyCheckPeerExpire	원격 서버 인증서가 만료되었는지 확인한다.	Default: On
SSLProxyCheckPeerCN	원격 서버 인증서의 CN 필드를 확인한다.	Default: Off

Member는 Load Balancer Member List 테이블의 Add Member 버튼으로 추가한다.
Add Member 버튼을 눌렀을 때 Member를 추가할 수 있는 창이 화면에 출력되며, 사용자는 이 창에서 LENA Manager에서 관리하는 서버를 Member로 선택하거나 직접 Member 정보를 입력하여 추가할 수 있다.

추가된 Member는 아래와 같은 정보를 통해 관리된다.

Table 70. Load Balancer Member List
항목(*는 필수값)	설명	비고
Target Server	Member가 가리키는 서버의 기본 정보이다. LENA Manager에서 관리하는 Member인 경우 Node Name/Server Name의 형태로, LENA Manager가 관리하지 않는 Member인 경우 Address:Port의 형태로 출력된다.
Protocol Type	Member가 사용하는 프로토콜 유형이다.
Redirect	해당 Member가 오류 상태일 때, 이 Member가 받은 요청을 대신 처리 할 Failover Member를 설정한다.	Default: NONE
Load Balancing Factor	작업량 할당 비율으로, 해당 Member가 다른 Member들에 비해 얼마나 많은 일을 할 지 정의한다.	Default: 1
Route ID	Member의 Route ID이다.	Sticky Session을 사용하는 경우 필수로 입력해야 한다.
Order	Member들 간의 순서를 변경할 수 있다.

URI Pattern Group
Web Server로 들어온 요청들에 대해 URI 패턴을 검사하여 WAS로 전달하는 URI Mapping을 정의한다.

Table 71. URI Pattern Group (Proxy)
항목(*는 필수값)	설명	비고
URI Pattern Group ID(*)	URI 패턴을 그룹화하고 관리하는 데 사용되는 이름이다. Virtual Host에서 사용하는 URI Pattern Group일 경우, ID 옆에 어느 Virtual Host에서 사용하고 있는 지에 대한 정보가 함께 출력된다.	Group 생성 시 'uri_'라는 접두사가 추가된다.
Mode	URI 패턴을 LENA Manager가 관리하는 형식으로 입력할 지, 사용자 임의로 입력할 지 지정한다. 본 항목에 따라 Patterns to be Included/Excluded 또는 URI Patterns로 입력하는 화면이 출력된다. 이미 저장된 패턴이 LENA Manager가 관리하는 방식이라면 Standard로, 사용자 임의 형식이라면 Manual로 자동 지정된다.	Standard: LENA Manager URI Rule에 따른 입력 방식 Manual: 사용자 임의 입력 방식
Patterns to be Included	WAS로 전달 할 URI 패턴을 입력한다. 우측 Select box를 통해 Load Balancer를 선택해야 저장할 수 있다. ⓧ버튼을 통해 패턴을 삭제할 수 있다.	모든 문자를 허용하는 의미의 Asterisk(*)를 사용할 수 있으며 Hash(#), Equal(=)은 허용되지 않는다.
Patterns to be Excluded	WAS로 전달 하지 않을 URI 패턴을 입력한다. ⓧ버튼을 통해 패턴을 삭제할 수 있다.	모든 문자를 허용하는 의미의 Asterisk(*)를 사용할 수 있다.
URI Patterns	사용자 임의의 패턴을 입력할 시 사용한다.

Table 72. Enable Custom (Proxy)
항목(*는 필수값)	설명	비고
Custom Configuration	사용자가 임의로 추가하고 싶은 설정을 추가 합니다.	custom-proxy.conf 파일에 별도로 저장되어, 관리합니다.

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

Virtual Host

Web Server의 Virtual Host 정보를 등록/수정/복제/삭제할 수 있다.

Create 버튼, Delete 버튼 을 통해 Virtual Host를 등록/삭제할 수 있으며, Clone 버튼 을 통해 복제하거나, Rename 버튼 을 통해 이름을 변경할 수 있다.

1개 이상의 Load Balancer를 적용한 Virtual Host는 삭제할 수 없다. 만약 해당 Virtual Host를 삭제하려면, 먼저 Connector 탭을 통해 Load Balancer의 Virtual Host ID를 다른 Virtual Host ID로 변경해야 한다.

SSL Enabled와 Rewrite Enabled를 체크한 경우 아래와 같이 상세 항목 영역이 추가로 출력된다.

설정 정보의 상세 내용은 다음과 같다.

관리 대상 파일

/conf/extra/vhost/{Virtual Host ID}.conf
/conf/extra/rewrite/rewrite_{Virtual Host ID}.conf
/conf/extra/ssl/ssl_{Virtual Host ID}.conf
/conf/extra/vhost/custom_{Virtual Host ID}.conf

Table 73. Virtual Host Info 설정 정보
항목(*는 필수값)	설명	비고
Virtual Host ID(*)	Virtual Host 이름
Port(*)	해당 가상호스트가 사용하는 HTTP Port
Document Root(*)	해당 가상호스트의 홈페이지 디렉토리 위치	Server의 DocumentRoot 변수인 ${DOC_ROOT}를 활용하여 동일하게 혹은, 그 하위로 지정가능
Domain Name(*)	가상호스트 식별 하는 도메인 명
Server Alias	가상호스트가 사용하는 ServerAlias	와일드카드 문자 포함 가능(*.example.com)
Custom Log(*)	가상호스트의 웹 로그파일 위치
Directory/Path	DocumentRoot에서 지정한 경로
Directory/Options	지정한 디렉토리 이하의 모든 파일과 디렉토리들에 적용할 접근 제어 설정	-Indexes는 welcome page를 찾을 수 없을 때, Document Root 하위의 파일 목록을 보여주는 것을 방지 -FollowSymLinks는 Document Root 하위에 기존의 웹문서 이외의 파일시스템에 심볼릭링크로 접근 하는 것을 방지
Directory/Allow Override	Document Root 하위 디렉토리 별 리소스 접근 제어 설정파일 (일반적으로 AccessFileName : .htaccess)에 대하여 어떤 지시자 사용을 허가할 것인지 설정	다음과 같은 유형을 제공함 None : 어떠한 지시자도 허용하지 않음 All : 모든 지시자 사용가능 AuthConfig : 사용자 인증 지시자 허용 FileInfo : 문서 유형 제어 지시자 허용 Indexes : 디렉토리 Indexing 제어 지시자 허용 Limit : 호스트 접근 제어 지시자 허용
Directory/Require	인증된 사용자가 허가된 Action을 수행하는지 검증
Connector Enable	가상 호스트 Connector 설정 여부
Connector Type/ID	가상 호스트 Connector 를 설정 하는 경우 Jk/Proxy 유형에 따라 선택	Connector Tab 에서 생성한 Connector 목록 표시.
Rewrite Enable	Rewrite 사용여부
Rewrite Config	Rewrite 관련 상세 설정. 지정한 Rewrite Condition 에 따라 Rewrite Rule에 설정한 rule 대로 rewrite함
Enable Custom	사용자가 Vhost에 임의로 추가하고 싶은 설정을 추가 합니다.	custom_{Virtual Host ID}.conf 파일에 별도로 저장되어, 관리합니다.
SSL Enabled	SSL 사용여부
SSL Port(*)	HTTPS Port
SSL Certificate File(*)	SSL 인증서 경로
SSL Certificate Key File(*)	SSL인증서 Key파일 경로
SSL Certificate Chain File	File of PEM-encoded Server CA Certificate
SSL CA Certificate File	ROOT인증서 경로
Https Redirect Enabled	Http→Https Redirect 사용여부
SSL Log Separation	SSL Log 설정 분리 사용여부
SSL Custom Log(*)	SSL Custom Log 설정

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

Logging

Web Server의 로그설정 정보를 편집할 수 있다.

설정 정보의 상세 내용은 다음과 같다.

Log Home

Table 74. Log Home
항목(*는 필수값)	설명	비고
Log Home(*)	Log Home 경로	default 선택시 서버설치디렉토리 하위 logs 폴더로 설정, custom 선택시 Log Home Prefix항목에서 로그디렉토리 홈 경로 입력가능
Retention Days(*)	로그 최대 보관 일수	Default : 0(무제한)

Error Log

Web Server가 진단정보와 request를 처리하는 도중에 발생한 오류를 기록할 때 사용된다. Server가 시작하거나 동작하는데 문제가 발생시 여기에 설정된 위치의 파일을 먼저 확인한다.

Table 75. Error Log
항목(*는 필수값)	설명	비고
Location(file/pipe)(*)	Web Server의 에러로그파일 위치를 지정
Log Level(*)	에러로그파일의 기록내용을 얼마나 자세하게 기록할 지 지정

Log Format

로그파일에 사용할 형식을 설정한다.

Table 76. Log Format
항목(*는 필수값)	설명	비고
Format(*)	로그파일에 어떤 포맷으로 로그를 남길지 설정
Nickname(*)	사용할 로그포맷의 명칭

Log Format with logio

Table 77. Log Format with logio
항목(*는 필수값)	설명	비고
Format(*)	로그파일에 어떤 포맷으로 로그를 남길지 설정	%I와 %O 변수를 사용해 request와 head를 포함하여 보내고 받는 byte 측정이 가능
Nickname(*)	사용할 로그포맷의 명칭	combinedio는 mod_logio_module이 로드되어 있어야 함

Log Env

Request의 조건에 따라 환경변수를 설정할 때 사용한다.

Table 78. Log Env
항목(*는 필수값)	설명	비고
Attribute(*)	HTTP 요청 헤더(ex: Host, User-Agent, Referer, Accept-Language), 요청 속성 중 하나(Remote_Host, Remote_Addr, Server_Addr, Request_Method, Request_Protocol, Request_RUI) 또는 요청과 연관된 환경 변수 이름
Regex(*)	Perl 호환 정규식
Env-variable name(*)	설정할 변수명과 설정값(optional) Varname, !varname 또는 varname=value
Case	Env-variable에 대소문자 구분할지 여부	With case : 대소문자 구분 No case : 대수문자 구분없음

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

Environment

JVM 옵션, Start Shell의 설정 등을 관리하는 화면을 제공한다. 파일 에디터를 통해 수정한 후 Save 버튼 을 클릭하여 저장한다.

Custom Env ($CATALINA_HOME/bin/customenv.sh): 사용자 커스텀 환경변수 설정
Base Env ($CATALINA_HOME/env.sh) - Server 시작을 위한 Shell Script

기본적으로 설정을 수정할 수 없도록 되어 있다. 수정하고 싶은 경우 ADMIN > Manager Environment > Manager Configuration 항목에서 설정 버튼 을 클릭해 아래 설정을 false 로 변경한다.

server.environment.envshell.readonly=false

Config Tree

Web Server의 ${SERVER_HOME}/conf 디렉토리 하위 설정파일들을 파일편집기를 통해 관리 할 수 있다.

Node Agent를 실행하는 사용자가 Web Server 설정 정보 파일의 접근 권한이 있어야 수정이 가능하다. 접근 권한이 없을 경우 파일 Write 권한이 없어 편집 할 수 없다는 메시지가 출력 된다.

History

설정 정보의 백업 및 복원 기능을 제공한다. 설정 정보를 수정하여 저장하면 History를 관리한다. 수정 일시를 입력하여 검색한다.

보기(돋보기) 버튼 을 클릭하여 선택한 파일의 정보를 볼 수 있으며, Restore 버튼 을 클릭하여 해당 설정파일로 복원할 수 있다.

4.5.9. 설정 정보 관리 (EN-N)

EN-N 타입의 Web Server의 엔진 설정 정보를 변경하는 기능을 제공한다. Web Server 목록에서 Server를 선택하면 설정 정보를 관리하는 화면으로 이동한다.

General

Web Server의 일반적인 설정 값과 Connection, Process 정보를 편집할 수 있다.

Web Server의 설정 정보는 저장 시 설정 파일에 대한 Validation을 수행하게 되어 있으며, 설정 파일 오류로 인한 Server 기동 장애가 발생을 최소화하고 있다.

설정 파일 오류 시 파일이 저장되지 않고 오류 메시지가 출력된다

오류 메시지 예

AH00526: Syntax error on line 253 … Argument for 'Require all' must be 'granted' or 'denied'

설정 정보의 상세 내용은 다음과 같다.

Server Info (/var/common_value.env 파일 관리)

Table 79. Server Info
항목(*는 필수값)	설명	비고
Install Path	Server 설치 경로
Base Port(*)	설치할때 설정한 Port Type 정보와 Port Number	Port Type은 변경 불가능, Port Number는 변경 가능
Welcome Page	웹사이트의 초기페이지 문서로 어떤 파일을 사용할 것인지 정의
Stop Mode	Server 중지 Mode	Stop Graceful Stop
Directory Root Path	Web Server에서 제공하는 문서들이 저장되어 있는 기본 폴더 경로
Disable Symbolic Links	Symbolic Link 미사용 여부	Default : on (사용 안함)
Diasble Auto Index	디렉터리 목록 출력을 활성화하거나 비활성화합니다.	Default : on (비활성화)

Additional Port Info (/var/tcp_port.env, /var/udp_port.env 파일 관리)

Table 80. TCP Port
항목(*는 필수값)	설명	비고
Port Alias(*)	포트의 Alias 를 설정한다.
Port Number	포트 번호를 지정한다.
Protocol Type	프로토콜 타입을 선택한다.
Virtual Host ID	해당 Port를 사용중인 Virtual Host ID를 표시한다.	특정 Virtual Host에서 해당 Port를 사용중이라면, Port Alias를 변경 할 수 없다.

TCP Protocol 전용 사용 포트 (Proxy(HTTP, HTTPS), Net Gateway(TCP))

Table 81. UDP Port
항목(*는 필수값)	설명	비고
Port Alias(*)	포트의 Alias 를 설정한다.
Port Number	포트 번호를 지정한다.
Protocol Type	프로토콜 타입을 선택한다.
Virtual Host ID	해당 Port를 사용중인 Virtual Host ID를 표시한다.	특정 Virtual Host에서 해당 Port를 사용중이라면, Port Alias를 변경 할 수 없다.

UDP Protocol 전용 사용 포트 (Net Gateway)

Connection Info (/var/common_value.env 파일 관리 - 연관 파일 /conf/http/lenan-http.conf)

Table 82. Connection Info
항목(*는 필수값)	설명	비고
Send Timeout(*)	client로 응답을 전송하는데 설정된 timeout 시간이다. 전체 응답 전송 timeout 시간이 아니라 두개의 연속적인 쓰기 작업 사이의 timeout 시간이다. send_timeout에 지정한 시간안에 client가 아무것도 받지 못하면 connection은 닫힌다.	Default : 60
Keep Alive Timeout(s) (*)	서버와 커넥션이 계속 열린채로 유지하는데 설정한 timeout 시간이다.	Default : 5
Client Header Timeout(*)	request header 정보를 읽는 시간, 지정한 시간 안에 client가 헤더를 전송하지 않으면 요청은 408(Request Time-out)로 끝난다.	Default: 60
Client Body Timeout(*)	request body 정보를 읽는 시간, request body 전체 전송 timeout 시간이 아니라, 두개의 연속적인 읽기 작업 사이의 timeout 시간이다. client_body_timeout에 지정한 시간 안에 client가 아무것도 전송하지 않으면 요청은 408(Request Time-out)로 끝난다.	Default: 60

Process Info (/var/common_value.env 파일 관리 - 연관 파일 /conf/lenan.conf)

Table 83. Process Info
항목(*는 필수값)	설명	비고
Worker Process(*)	worker 프로세스 수를 정의 합니다.	Default : 2
Worker Connection(*)	최대 동시 연결 수를 설정합니다.	최대 Request 허용 갯수 : worker_processes * worker_connections

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

Enable Custom (/conf/custom/custom.conf 파일 관리 - 연관 파일 /conf/lenan.conf)

Table 84. Enable Custom
항목(*는 필수값)	설명	비고
Custom Configuration	lenan.conf에 include되는 custom.conf를 통해 사용자가 자유롭게 삽입할 내용을 입력합니다.

Connector

Web Server와 WAS(Backend)를 연계하기 위한 정보를 관리한다.
Connector 페이지는 프토토콜에 따라 Proxy와 Net Gateway 탭으로 나누어져 있으며, 각 탭에서 모듈에 따른 Connector 설정 정보를 편집할 수 있다.

Proxy

Proxy(ngx_http_upstream_module)를 사용할 때의 설정 정보를 편집한다.

Proxy 탭의 설정은 위 화면과 같이 Connector Info, Load Balancer, URI Pattern Group의 세 가지 영역으로 나누어져 있다.

Connector Info
Proxy의 기본 설정 값을 관리한다.

Table 85. Connector Info (Proxy)
항목(*는 필수값)	설명	비고
Proxy Read Timeout(*)	백엔드 서버로 부터 응답을 읽는데 설정한 timeout 시간이다. 전체 응답 전송 timeout 시간이 아니라 두 개의 연속적인 읽기 작업 사이의 timeout 시간이다. proxy_read_timeout에 지정한 시간 안에 백엔드 서버가 아무것도 전송하지 않으면 connection은 닫힌다.	Default: 300
Proxy Connect Timeout(*)	백엔드 서버와의 연결을 설정하기 위한 시간 제한을 정의합니다. 이 시간 제한은 일반적으로 75초를 초과할 수 없습니다.	Default: 5
Background ServerFault Check Interval(*)	백엔드 서버와 연결된 Member가 오류 상태인 경우, 본 항목에 설정한 간격(초)으로 서버를 확인하고 서버가 정상 동작 하면 요청을 다시 전달한다. 기능을 사용하지 않으려면 0으로 설정한다.	Default: 10
Server Fault Retry Time(*)	백엔드 서버와 연결된 Member가 오류 상태인 경우, timeout(초)이 만료될 때 까지 어떠한 요청도 해당 서버에 전달하지 않는다.	Default: 60
Health Check Interval(*)	백엔드 서버의 상태를 확인하기 위해 설정된 간격(초)으로 서버를 확인한다. 기능을 사용하지 않으려면 0으로 설정한다.	Default: 60
DNS Lookup Interval(*)	DNS 조회 간격. 기능을 사용하지 않으려면 0으로 설정한다.	Default: 10

Background ServerFault Check Interval과 Health Check Interval을 0으로 저장 시
모든 LoadBalancer의 Auto Server Fault Recovery값이 off로 변경되며, 신규생성 값도 off로 고정된다.

Load Balancer
부하 분산을 위해 Load Balancer의 기본 설정 및 Member를 관리한다.
Load Balancer 영역에는 Overview 탭과 Configuration 탭이 존재하며, Overview 탭에서는 현재 생성되어 있는 Load Balancer의 전반적인 정보를 확인할 수 있고 Configuration 탭에서는 Load Balancer의 상세 내용을 구성할 수 있다.

Table 86. Load Balancer Info - Overview (Proxy)
항목(*는 필수값)	설명	비고
Load Balancer ID	현재 생성되어 있는 Load Balancer의 ID이다.
Target Server	Load Balancer에 등록된 Worker의 기본 정보이다. 'Node Name/Server Name' 형식으로 출력된다.
Pattern	특정 URI Pattern에서 Load Balancer를 지정한 경우, 해당 URI Pattern이 속해있는 URI Pattern Group ID가 출력된다.

Table 87. Load Balancer Info - Configuration (Proxy)
항목(*는 필수값)	설명	비고
Load Balancer ID(*)	Load Balancer의 이름이다.	'lb_'라는 접두사가 추가된다.
Method(*)	Load Balancer가 부하를 분산하기 적절한 Worker를 판별하는데 사용하는 방법을 지정한다.	Sticky Session : Session Cookie를 기반으로 라우팅 RoundRobin : 등록된 멤버의 순서대로 라우팅 IP Hash : Client의 IP를 기반으로 라우팅 Least Connection : 커넥션이 적은 쪽으로 라우팅
Session Cookie(*)	Session Cookie 이름을 변경하고자 하는 경우 설정한다.	Default: JSESSIONID
Timeout Retry	Session Cookie 이름을 변경하고자 하는 경우 설정한다.	Default:Off On 셋팅 시 Gateway Timeout 발생 시 재 전송한다.
Auto Server Fault Recovery	fox Directive 사용여부	Default: On Off 셋팅 시 Fail Check 관련하여 Health Check Interval값 대신 ServerFault Retry Time 값이 적용된다.

Member는 Load Balancer MemberList 테이블의 Add Member 버튼으로 추가한다.
Add Member버튼을 눌렀을 때 Member를 추가할 수 있는 창이 화면에 출력 되며, 사용자는 이 창에서 LENA Manager에서 관리하는 서버를 Member를 선택할 수 있다. 추가된 Member는 아래와 같은 정보를 통해 관리된다.

Table 88. Load Balancer Member List
항목(*는 필수값)	설명	비고
Target Server	Member가 가리키는 서버의 노드 이름과 서버의 이름이다.
Route ID	Member의 Route ID 이다
Weight	작업량 할당 비율으로, 해당 Worker가 다른 Worker들에 비해 얼마나 많은 일을 할 지 정의한다.	Default: 1

URI Pattern Group
Web Server로 들어온 요청들에 대해 URI 패턴을 검사하여 WAS로 전달하는 URI Mapping을 정의한다.

Table 89. URI Pattern Group (Proxy)
항목(*는 필수값)	설명	비고
URI Pattern Group ID(*)	URI 패턴을 그룹화하고 관리하는 데 사용되는 이름이다. Virtual Host에서 사용하는 URI Pattern Group일 경우, ID 옆에 어느 Virtual Host에서 사용하고 있는 지에 대한 정보가 함께 출력된다.	Group 생성 시 'uri_'라는 접두사가 추가된다.
Mode	URI 패턴을 LENA Manager가 관리하는 형식으로 입력할 지, 사용자 임의로 입력할 지 지정한다. 본 항목에 따라 Patterns to be Included/Excluded 또는 URI Patterns로 입력하는 화면이 출력된다. 이미 저장된 패턴이 LENA Manager가 관리하는 방식이라면 Standard로, 사용자 임의 형식이라면 Manual로 자동 지정된다.	Standard: LENA Manager URI Rule에 따른 입력 방식 Manual: 사용자 임의 입력 방식
Patterns to be Included	WAS로 전달 할 URI 패턴을 입력한다. 우측 Select box를 통해 Load Balancer를 선택해야 저장할 수 있다. ⓧ버튼을 통해 패턴을 삭제할 수 있다.	모든 문자를 허용하는 의미의 Asterisk(*)를 사용할 수 있으며 Hash(#), Equal(=)은 허용되지 않는다.
Patterns to be Excluded	WAS로 전달 하지 않을 URI 패턴을 입력한다. ⓧ버튼을 통해 패턴을 삭제할 수 있다.	모든 문자를 허용하는 의미의 Asterisk(*)를 사용할 수 있다.
URI Patterns	사용자 임의의 패턴을 입력할 시 사용한다.

Enable Custom
/conf/http/custom/custom_http.conf 파일 관리 - 연관 파일 /conf/http/lenan-http.conf)

Table 90. Enable Custom (Proxy)
항목(*는 필수값)	설명	비고
Custom Configuration	lenan-http.conf에 include 되는 custom_http.conf를 통해 사용자가 자유롭게 삽입할 내용을 입력합니다.

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

Net Gateway

Net Gateway(ngx_stream_upstream_module)를 사용할 때의 설정 정보를 편집한다.

Net Gateway 탭의 설정은 Connector Info, Load Balancer 두 가지 영역으로 나누어져 있다.

Connector Info
Net Gateway의 기본 설정 값을 관리한다.

Table 91. Connector Info (Net Gateway)
항목(*는 필수값)	설명	비고
Proxy Timeout(s)(*)	클라이언트 또는 프록시 서버 연결에서 두 번의 연속적인 읽기 또는 쓰기 작업 사이의 시간 제한을 설정합니다. 이 시간 내에 데이터가 전송되지 않으면 연결이 닫힙니다.	Default: 5
Proxy Connect Timeout(s)(*)	프록시 서버와의 연결을 설정하기 위한 시간 초과를 정의합니다	Default: 10
ServerFault Retry Time(s)(*)	지정된 수의 서버 통신 실패 횟수가 발생하여 서버를 사용할 수 없다고 간주해야 하는 시간, 서버를 사용할 수 없는 것으로 간주되는 기간입니다.	Default: 60

Load Balancer
부하 분산을 위해 Load Balancer의 기본 설정 및 Member를 관리한다.
Load Balancer 영역에는 Overview 탭과 Configuration 탭이 존재하며, Overview 탭에서는 현재 생성되어 있는 Load Balancer의 전반적인 정보를 확인할 수 있고 Configuration 탭에서는 Load Balancer의 상세 내용을 구성할 수 있다.

Table 92. Load Balancer Info - Overview (Net Gateway)
항목(*는 필수값)	설명	비고
Load Balancer ID	현재 생성되어 있는 Load Balancer의 ID이다.
Target Server	Load Balancer에 등록된 Member의 기본 정보이다. 'Address:Port' 형식으로 출력된다.

Table 93. Load Balancer Info - Configuration (Net Gateway)
항목(*는 필수값)	설명	비고
Load Balancer ID(*)	Load Balancer의 이름이다.	'lb_'라는 접두사가 추가된다.
Method(*)	Load Balancer가 부하를 분산하기 적절한 Member를 판별하는데 사용하는 방법을 지정한다.	Round Robin : 등록된 멤버 리스트를 순차적으로 라우팅 IP Hash : Client IP를 기준으로 라우팅 Least Connection : Connection을 기준으로 적은 쪽으로 라우팅

Member는 Load Balancer Member List 테이블의 Add Upstream 버튼으로 추가한다.
Add Upstream 버튼을 눌렀을 때 Upstream을 추가할 수 있는 창이 화면에 출력 되며, 사용자는 이 창에서 직접 Upstream정보를 입력하여 추가할 수 있다.

추가된 Upstream은 아래와 같은 정보를 통해 관리된다.

Table 94. Load Balancer Member List
항목(*는 필수값)	설명	비고
IP or DNS	Upstream이 가리키는 서버의 기본 정보이다. 기본적으로 Address:Port의 형태로 출력된다.	DNS도 입력 가능하다.
Port	Upstream가 사용하는 포트 정보이다.
Weight	작업량 할당 비율로, 해당 Upstream이 다른 Upstream들에 비해 얼마나 많은 일을 할 지 정의한다.	Default: 1 작업량 할당이기 때문에 0 입력 불가 (default 1로 변경)

Enable Custom
/conf/stream/custom/custom_stream.conf 파일 관리 - 연관 파일 /conf/stream/lenan-stream.conf)

Table 95. Enable Custom (Net Gateway)
항목(*는 필수값)	설명	비고
Custom Configuration	lenan-stream.conf에 include 되는 custom_stream.conf를 통해 사용자가 자유롭게 삽입할 내용을 입력합니다.

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

Virtual Host

Proxy

Proxy Web Server의 Virtual Host 정보를 등록/수정/복제/삭제할 수 있다.

Create 버튼, Delete 버튼 을 통해 Virtual Host를 등록/삭제할 수 있으며, Clone 버튼 을 통해 복제하거나, Rename 버튼 을 통해 이름을 변경할 수 있다.

Enable SSL과 Enable Rewrite와 Enable Custom을 체크한 경우 상세 항목 영역이 추가로 출력된다.

설정 정보의 상세 내용은 다음과 같다.

관리 대상 파일

/conf/http/vhost/vhost_{Virtual Host ID}.conf
/conf/http/vhost/vhost.list
/conf/http/vhost/rewrite/rewrite_{Virtual Host ID}.conf
/conf/http/vhost/custom/custom_{Virtual Host ID}.conf

Table 96. Virtual Host Info 설정 정보
항목(*는 필수값)	설명	비고
Virtual Host ID(*)	Virtual Host 이름
Domain Name	가상호스트 식별 하는 도메인 명
IP(*)	해당 가상호스트가 사용할 프로토콜을 선택(HTTP, HTTPS) 해당 가상호스트가 사용하는 IP
Port(*)	해당 가상호스트가 사용하는 Port
SSL Enable	SSL 추가 사용 여부, 해당 가상호스트가 사용하는 HTTPS Port	체크할 경우, HTTPS 서비스 포트로 사용할 포트를 콤보 박스에서 사용 필요(사용할 포트 정보는 General 탭의 Port Info에서 HTTPS 포트로 미리 등록 해야함)
SSL/SSLCertificateFile	SSL 인증서 경로
SSL/SSLCertificateKeyFile	SSL 인증서 Key파일 경로
SSL/SSLPassword	SSL Password	password를 입력할 경우, AES256 암호화를 통하여 관리
SSL/Use HTTPS Redirect	Http→Https Redirect 사용여부
Document base/Directory Root Path	해당 가상호스트의 홈페이지 디렉토리 위치	Server의 DocumentRoot 변수인 ${DOC_ROOT}를 활용하여 동일하게 혹은, 그 하위로 지정가능
Document base/Disable Symbolic Links	Document Root 하위에 기존의 웹 문서 이외의 파일 시스템에 심볼릭링크로 접근 하는 것을 방지
Document base/Disable Auto Index	welcome page를 찾을 수 없을 때, Document Root 하위의 파일 목록을 보여주는 것을 방지
Document base/Allowed Methods	지정한 http method에 대한 액세스 허용
Document base/Deny IP	지정된 네트워크 또는 주소에 대한 액세스 거부
Access Log/Alias	로그파일에 어떤 포맷으로 로그를 남길지 설정
Access Log/Location	로그파일을 어떤 위치에 어떤 이름으로 남길지 설정
URI	Connector Proxy Tab에서 설정한 URI Pattern Group 선택	필수 선택 아님
Enable Rewrite	Rewrite 기능을 사용할 것인지 여부, 체크 하면 하단에 입력 창 생성	입력되는 내용은 별도의 파일로 생성, 저장
Enable Custom	Custom Configuration 사용여부, 체크 하면 하단에 입력 창 생성	입력되는 내용은 별도의 파일(/conf/http/vhost/custom/custom_default.conf)로 생성, 저장

Net Gateway

Net Gateway Web Server의 Virtual Host 정보를 등록/수정/복제/삭제할 수 있다.

Create 버튼, Delete 버튼 을 통해 Virtual Host를 등록/삭제할 수 있으며, Clone 버튼 을 통해 복제하거나, Rename 버튼 을 통해 이름을 변경할 수 있다.

설정 정보의 상세 내용은 다음과 같다.

관리 대상 파일

/conf/stream/vhost/vhost_{Virtual Host ID}.conf
/conf/stream/vhost/vhost.list
/conf/stream/vhost/custom_{Virtual Host ID}.conf

Table 97. Virtual Host Info 설정 정보
항목(*는 필수값)	설명	비고
Virtual Host ID(*)	Virtual Host 이름
IP(*)	해당 가상호스트가 사용할 프로토콜을 선택(HTTP, HTTPS) 해당 가상호스트가 사용하는 IP
Port(*)	해당 가상호스트가 사용하는 Port
Access Log/Alias	로그파일에 어떤 포맷으로 로그를 남길지 설정
Access Log/Location	로그파일을 어떤 위치에 어떤 이름으로 남길지 설정
Load Balancer	Connector Net Gateway Tab에서 설정한 Load Balancer Group 선택
Enable Custom	Custom Configuration 사용여부, 체크 하면 하단에 입력 창 생성	입력되는 내용은 별도의 파일(/conf/stream/vhost/custom/custom_default.conf)로 생성, 저장

Logging

Web Server의 로그설정 정보를 편집할 수 있다.

설정 정보의 상세 내용은 다음과 같다.

Log Home

Table 98. Log Home
항목(*는 필수값)	설명	비고
Log Home(*)	Log Home 경로	default 선택시 서버설치디렉토리 하위 logs 폴더로 설정, custom 선택시 Log Home Prefix항목에서 로그디렉토리 홈 경로 입력가능
Retention Days(*)	로그 최대 보관 일수	Default : 0(무제한)

Error Log

Table 99. Error Log
항목(*는 필수값)	설명	비고
Location(file/pipe)(*)	Web Server의 에러로그파일 위치를 지정
Log Level(*)	에러로그파일의 기록내용을 얼마나 자세하게 기록할 지 지정

Log Format : Proxy

Proxy 로그파일에 사용할 형식을 설정한다.

Table 100. Log Format : Proxy
항목(*는 필수값)	설명	비고
Alias(*)	사용할 로그포맷의 명칭
Format(*)	로그파일에 어떤 포맷으로 로그를 남길지 설정

Log Format : Net Gateway

Net Gateway 로그파일에 사용할 형식을 설정한다.

Table 101. Log Format : Net Gateway
항목(*는 필수값)	설명	비고
Alias(*)	사용할 로그포맷의 명칭
Format(*)	로그파일에 어떤 포맷으로 로그를 남길지 설정

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

Environment

JVM 옵션, Start Shell의 설정 등을 관리하는 화면을 제공한다. 파일 에디터를 통해 수정한 후 Save 버튼 을 클릭하여 저장한다.

Custom Env ($CATALINA_HOME/bin/customenv.sh): 사용자 커스텀 환경변수 설정
Base Env ($CATALINA_HOME/env.sh) - Server 시작을 위한 Shell Script

server.environment.envshell.readonly=false

Config Tree

Web Server의 ${SERVER_HOME}/conf 디렉토리 하위 설정파일들을 파일편집기를 통해 관리 할 수 있다.

History

설정 정보의 백업 및 복원 기능을 제공한다. 설정 정보를 수정하여 저장하면 History를 관리한다. 수정 일시를 입력하여 검색한다.

보기(돋보기) 버튼 을 클릭하여 선택한 파일의 정보를 볼 수 있으며, Restore 버튼 을 클릭하여 해당 설정파일로 복원할 수 있다.

4.5.10. Server Log Viewer

서버 목록의 우측 Log Viewer 버튼으로 대상 서버의 Log Home 경로 하위의 로그 파일 내용을 탐색할 수 있다.

이 기능을사용하기 위해서는 다음을 만족해야 한다.

대상 서버가 속한 Node 가 기동중이어야 한다.

서버 목록의 Log Viewer 버튼을 클릭하면 대상 서버의 Log Home 경로를 기준으로 디렉토리 및 파일을 트리 구조로 확인 할 수 있다.

파일을 선택하면 파일의 내용을 조회하며, 처음 선택 시 해당 파일의 맨 끝부터 정해진 크기만큼의 파일 내용을 확인 할 수 있다.

Load More, Load Previous 버튼을 사용하여 정해진 크기만큼 로그 파일의 내용을 조회 및 확인 할 수 있다.

Load Previous 버튼 사용 중 더 이상 조회할 내용이 없는 경우(eg. 파일의 맨 처음), 화면에 Alert 으로 더 이상 읽어들일 데이터가 없다는 메시지가 출력된다.
Load More 버튼 사용 중 회하는 경우 더 이상 조회할 내용이 없는 경우(eg. 파일의 맨 끝),더 이상 읽어들일 데이터가 없다는 메시지가 화면 하단에 표기 된다.

4.6. Session Server

Session Server를 관리하기 위한 화면을 제공한다. Node에 설치한 Session Server의 등록, 수정, 삭제가 가능하며, 시작과 종료 Shell을 실행할 수 있다.

4.6.1. 목록

Session Server List를 통하여 각 WAS를 관리할 수 있다.

Figure 8. Session Server List

Session Server의 속성은 아래와 같다.

Table 102. Session Server 속성
항목(*는 필수값)	설명	비고
Status	Session Server의 상태	Started(v) Stop(ㅁ) Error(!)
Name(*)	Session Server의 이름
Address	Session Server의 IP주소
Server ID	Server의 ID
Type	Session Server의 유형	Standalone Embedded
Port	Service 포트번호
시작/중지 버튼	Server의 시작 및 종료
버튼 영역	서버 정보 변경 및 관련 기능 버튼을 표시	휴지통 아이콘 - 서버 정보를 삭제 펜 아이콘 - 서버 정보를 수정 Log 파일 아이콘 - Server Log Viewer 기능 제공 더보기 아이콘 - Start/Stop을 수행할 수 있는 메뉴 제공

Session Server는 Enterprise Edition에서 제공되는 기능으로 되는 기능으로 Enterprise 버전의 WAS를 설치 시 사용 가능하다.

4.6.2. Install

Install 버튼 을 클릭한다.
Server ID와 Service Port, Mirror Server IP/Port를 입력한다.
Save 버튼 을 클릭하여 저장한다.

Node에 실제 설치되어 있는 Server와 Manager에서 관리하는 Server의 정보에는 차이가 있을 수 있다. (console기반 설치 시)

Server ID 중복 오류가 발생하는 경우, Register 기능을 이용하여 이전에 설치된 Server 정보를 확인한다.

4.6.3. Register

Register 버튼 을 클릭한다.
등록할 Server를 클릭한다.
Save 버튼 을 클릭하여 저장한다.

4.6.4. 수정

수정(연필) 버튼 을 클릭하여 Server 정보를 수정 가능한 상태로 변경한다.
Server의 속성을 수정한다.
Save 버튼 을 클릭하여 저장한다.

4.6.5. 삭제

삭제(휴지통) 버튼 을 클릭하여 Server 정보를 삭제 가능한 상태로 변경한다.
Save 버튼 을 클릭한다.
OK 버튼 을 누르면 삭제 유형을 선택하는 창이 출력된다.
- Deregister : Manager DB에서만 해당 Server 정보를 삭제하고 물리적인 Server engine은 유지 (추후 Register 버튼 을 통해 다시 등록 가능)
- Uninstall : Manager DB에서 해당 Server 정보를 삭제하고 물리적인 Server engine도 삭제

Uninstall 선택시, 로그 디렉토리 삭제여부를 묻는 창이 출력된다.

Server Cluster에 묶여있는 서버는 삭제할 수 없다.

4.6.6. Start/Stop

Stop 버튼 을 클릭하여 Server를 종료한다.
Start 버튼 을 클릭하여 Server를 시작한다.

시작 가능한 상태일 경우에만 Start 버튼 이 활성화 된다.

4.6.7. 설정 정보 관리

General

Server의 설정 정보를 변경하는 기능을 제공한다. Session Server 목록에서 Server를 선택하면 설정 정보를 관리하는 화면으로 이동한다.

환경설정에서 변경 가능한 속성은 아래와 같다.

Configuration

Table 103. Configuration
항목(*는 필수값)	설명	비고
Host(*)	Server의 Service Host(IP)
Port(*)	Server의 Service Port
Mirror Server Host(*)	Pair Server의 Host(IP)
Mirror Serror Port(*)	Pair Server의 Service Port
Share session in applications	Multi Applications 간 Session 공유 여부 설정.	WAS에서도 이 항목을 동일한 값으로 처리해야 적용됨. standalone에서만 가능함.
Session Timeout(s)	Session server의 session expired time 설정.	standalone에서만 가능함.

Connected WAS List

Refresh 버튼 을 클릭하면 리스트를 갱신해준다.

Table 104. Connected WAS List
항목(*는 필수값)	설명	비고
Server ID	WAS의 ID
Host	WAS가 설치된 Host명

Status (Session Server의 상태 정보 제공)

Refresh 버튼 을 클릭하면 리스트를 갱신해준다.

Table 105. Status
항목(*는 필수값)	설명
Session Count	현재 Session 개수
Logout Count	Logout 요청으로 Logout 된 Session 수
Session Max Count	Session 저장 최대 개수
Session Timeout	Session timeout 시간(ms)
Request Getnew Logout	WAS에서 전달된 GET_FRESH Request에 대한 Logout 응답 횟수
Data From Nodes	WAS에서 전달된 Session 개수
Request Getnew Nodata	WAS에서 전달된 GET_FRESH Request에 대한 NODATA 응답 횟수
Request Getnew	WAS에서 GET_SESSION Request했을 때 늘어난 횟수
Pid	Session이 standalone일 경우 프로세스 ID
Request Getfresh Data	WAS에서 GET_FRESH Request 가 왔을 때 해당 Session이 있는 경우 횟수
Request Getfresh Logout	WAS에서 GET_FRESH Request가 왔을 때 해당 Session이 Logout 된 횟수
Session Recv Lost	Session receive가 유실된 개수
Logout From Nodes	다른 was에서 logout 된 횟수
Session Expired	Session Time Out 시간으로 Expired 된 Session 수
Request Getfresh Nodata	WAS 에서 GET_FRESH_SESSION request했는데 데이터가 없을 경우 늘어난 횟수
Data From Secondary	Slave server에서 온 Data 개수
Request Getfresh	WAS에서 GET_FRESH Request 요청 횟수
Logout From Secondary	Slave Server에서 Logout Request가 전달 된 횟수
Req Lost	Request 유실 개수
Request Getfresh Secondary	Slave Server에서 GET_FRESH Request 요청 횟수
Resp Lost	Response Queue의 사이즈 이상으로 Response 가 수신되어 손실된 Response 개수
Request Getfresh Not New	WAS에서 전달된GET_FRESH Request에 대한 NOT_NEW Response 횟수
Request Getnew Secondary	Slave Server에서 GET_SESSION request했을 때 늘어난 횟수

Logging

Session Server의 로그설정 정보를 편집할 수 있다.

설정 정보의 상세 내용은 다음과 같다.

Log Home

Table 106. Log Home
항목(*는 필수값)	설명	비고
Log Home(*)	Log Home 경로	default 선택시 서버설치디렉토리 하위 logs 폴더로 설정, Enter manually 선택시 Log Home Prefix항목에서 로그디렉토리 홈 경로 입력가능
Retention Days(*)	로그 최대 보관 일수	Default : 0(무제한)

Environment

Start Shell의 설정을 관리하는 화면을 제공한다. 파일 에디터를 통해 수정한 후 Save 버튼 을 클릭하여 저장한다.

Base Env ($CATALINA_HOME/env.sh) - Server 시작을 위한 Shell Script

server.environment.envshell.readonly=false

4.6.8. Server Log Viewer

서버 목록의 우측 Log Viewer 버튼으로 대상 서버의 Log Home 경로 하위의 로그 파일 내용을 탐색할 수 있다.

이 기능을사용하기 위해서는 다음을 만족해야 한다.

대상 서버가 속한 Node 가 기동중이어야 한다.

서버 목록의 Log Viewer 버튼을 클릭하면 대상 서버의 Log Home 경로를 기준으로 디렉토리 및 파일을 트리 구조로 확인 할 수 있다.

파일을 선택하면 파일의 내용을 조회하며, 처음 선택 시 해당 파일의 맨 끝부터 정해진 크기만큼의 파일 내용을 확인 할 수 있다.

Load More, Load Previous 버튼을 사용하여 정해진 크기만큼 로그 파일의 내용을 조회 및 확인 할 수 있다.

Load Previous 버튼 사용 중 더 이상 조회할 내용이 없는 경우(eg. 파일의 맨 처음), 화면에 Alert 으로 더 이상 읽어들일 데이터가 없다는 메시지가 출력된다.
Load More 버튼 사용 중 회하는 경우 더 이상 조회할 내용이 없는 경우(eg. 파일의 맨 끝),더 이상 읽어들일 데이터가 없다는 메시지가 화면 하단에 표기 된다.

4.7. Memory Cache Server

Memory Cache Server를 관리하기 위한 화면을 제공한다. Node에 설치한 Memory Cache Server의 등록, 수정, 삭제가 가능하며, 시작과 종료 Shell을 실행할 수 있다.

4.7.1. 목록

Cache Server List를 통해 각 Memory Cache Server를 관리할 수 있다.

Figure 9. Cache Server List

Memory Cache Server의 속성은 아래와 같다.

Table 107. Memory Cache Server 속성
항목(*는 필수값)	설명	비고
Status	Cache Server의 상태	Started(v) Stop(ㅁ) Error(!)
Name(*)	Cache Server의 이름
Address	Cache Server의 IP주소
Server ID	Cache Server의 ID
Type	Cache Server의 유형	Memory Cache Server(MCR) Sentinel(MCRS)
Port	Service 포트번호
시작/중지 버튼	Cache Server의 시작 및 종료
버튼 영역	서버 정보 변경 및 관련 기능 버튼을 표시	휴지통 아이콘 - 서버 정보를 삭제 펜 아이콘 - 서버 정보를 수정 Log 파일 아이콘 - Server Log Viewer 기능 제공 더보기 아이콘 - Start/Stop을 수행할 수 있는 메뉴 제공

4.7.2. Install

Install 버튼 을 클릭한다.
Server ID와 Service Port, Mirror Server IP/Port를 입력한다.
Save 버튼 을 클릭하여 저장한다.

Node에 실제 설치되어 있는 Server와 Manager에서 관리하는 Server의 정보에는 차이가 있을 수 있다. (console기반 설치 시)

Server ID 중복 오류가 발생하는 경우, Register 기능을 이용하여 이전에 설치된 Server 정보를 확인한다.

4.7.3. Register

Register 버튼 을 클릭한다.
등록할 Server를 클릭한다.
Save 버튼 을 클릭하여 저장한다.

4.7.4. 수정

수정(연필) 버튼 을 클릭하여 Server 정보를 수정 가능한 상태로 변경한다.
Server의 속성을 수정한다.
Save 버튼 을 클릭하여 저장한다.

4.7.5. 삭제

삭제(휴지통) 버튼 을 클릭하여 Server 정보를 삭제 가능한 상태로 변경한다.
Save 버튼 을 클릭한다.
OK 버튼 을 누르면 삭제 유형을 선택하는 창이 출력된다.
- Deregister : Manager DB에서만 해당 Server 정보를 삭제하고 물리적인 Server engine은 유지 (추후 Register 버튼 을 통해 다시 등록 가능)
- Uninstall : Manager DB에서 해당 Server 정보를 삭제하고 물리적인 Server engine도 삭제

Uninstall 선택시, 로그 디렉토리 삭제여부를 묻는 창이 출력된다.

4.7.6. Start/Stop

Stop 버튼 을 클릭하여 Server를 종료한다.
Start 버튼 을 클릭하여 Server를 시작한다.

시작 가능한 상태일 경우에만 Start 버튼 이 활성화 된다.

4.7.7. 설정 정보 관리 (Memory Cache)

General

Memory Cache Server의 설정 정보를 변경하는 기능을 제공한다.

환경설정에서 변경 가능한 속성은 아래와 같다.

Server

Table 108. Server
항목(*는 필수값)	설명	비고
Install Path(*)	Memory Cache Server 인스턴스 경로	수정 불가
Port(*)	Server의 Service Port
Protocol(*)	통신 프로토콜
Bind Address	외부에서 해당 인스턴스에 접근을 허용할 IP
Outbound Source Address	외부 Memory Cache Server 서버 접속 시 알릴 본인 IP
Shutdown Timeout(s)	서버가 안전하게 종료될 때까지 대기하는 최대 시간
Shutdown On SIGTERM	SIGTERM 명령 시 처리동작
Log Home(*)	Log Home 경로
Log File Name	로그 파일명	설정하지 않을 경우 로그를 남기지 않음
Log Level	로그 레벨
TLS Ciphers	TLS암호화 알고리즘
TLS CA Certificate File	CA인증서
TLS Certificate File	공개키 인증서
TLS Key File	개인키 인증서
TLS Key File Password	개인키 비밀번호

Performance

Table 109. Performance
항목(*는 필수값)	설명	비고
Max Memory (Bytes)	Memory Cache Server가 사용할 최대 메모리
Max Memory Policy	메모리 사용이 Max Memory에 도달할 경우 데이터 삭제 정책
Max Clients	동시에 접속가능한 최대 클라이언트
Timeout	클라이언트 접속 타임아웃
TCP Backlog	TCP Backlog 설정
TCP Keepalive	클라이언트의 TCP keepalive 설정

User

Memory Cache Server의 계정관리를 지원(생성,삭제,관리)하며, User별 권한관리를 통한 Memory Cache Server내 명령을 제어할 수 있다.

환경설정에서 변경 가능한 속성은 아래와 같다.

User

Table 110. User
항목(*는 필수값)	설명	비고
Use ACL File	ACL파일 사용여부
ACL File	ACL파일 위치
Default User’s Password	default사용자 비밀번호	ACL파일을 사용하지 않을 경우 사용

User List

Table 111. User List
항목(*는 필수값)	설명	비고
User	생성한 사용자 ID
Enabled	사용여부

Rules

Table 112. Rules
항목(*는 필수값)	설명	비고
User	User List에서 선택한 사용자 ID
Enable The User	사용여부
Password/ User Password	비밀번호 설정 여부
Password/ Set Password	사용자 비밀번호
Commands/ Allow	Command 권한 설정 여부
Commands/ Set Allowing Command	Command 권한 상세 설정
Key Permissions/ Use Key Permissions	Key 권한 설정 여부
Key Permissions/ Set Key Permissions	Key 권한 상세 설정
Pub/Sub Channels/ Use Pub/Sub Channels	Pub/Sub 권한 설정 여부
Pub/Sub Channels/ Set Pub/Sub Channels	Pub/Sub 권한 상세 설정

Persistence

Memory Cache Server데이터 백업을 위한 RDB, AOF 등의 설정을 지원한다.

환경설정에서 변경 가능한 속성은 아래와 같다.

Persistence Directory

Table 113. Persistence Directory
항목(*는 필수값)	설명	비고
Directory	Persistence 디렉터리

Table 114. RDB
항목(*는 필수값)	설명	비고
Use RDB	RDB백업 사용여부
Save / Seconds	RDB 스냅샷을 수행하기 위한 기준이 되는 시간
Save / Changes	RDB 스냅샷을 수행하기 위한 Seconds내 변경 작업 횟수	Seconds시간 내에 Changes 횟수 만큼 작업 변경이 일어나면 Snapshot을 찍는다.
RDB compression	RDB 스냅샷 수행 시 텍스트 영역을 압축해 수행한다.
RDB checksum	RDB 스냅샷 파일의 체크섬을 생성할지 여부를 설정
File Name	RDB파일명
Stop Writes On Background Saving Error	RDB 스냅샷 중 오류 발생 시 쓰기 작업을 중지할지 여부를 설정
RDB Delete Sync Files	RDB 스냅샷 파일 생성 후 동기화 파일을 삭제할지 여부를 설정

Table 115. AOF
항목(*는 필수값)	설명	비고
Use AOF	AOF백업 사용여부
Auto AOF Rewrite Minimum Size	AOF파일을 rewrite을 할 기준이 되는 최소 파일 사이즈	파일 사이즈가 해당 설정값보다 작으면 rewrite하지 않는다.
Auto AOF Rewrite percentage(%)	Rewrite Minimum Size를 기준으로 해당 설정 %값 만큼 증가 시 rewrite 수행
File Name	AOF파일명
AOF Load Truncated	AOF파일 로드 시 파일 끝이 잘린 경우 load하는 방법	yes:로드 성공(로그에 오류를 남김), no:로드 실패
Append File Sync	Append Only 파일에 대한 동기화 방법을 설정
No Append File Sync On Rewrite	AOF 재작성 중에 Append Only 파일 동기화를 비활성화

Replication

Redis 백업 아키텍처인 Master, Slave에 대한 설정관리를 제공한다.

환경설정에서 변경 가능한 속성은 아래와 같다.

Master

Table 116. Master
항목(*는 필수값)	설명	비고
General / Replica Timeout(s)	Master에서 인식하는 replica(slave)와의 connection timeout	이 값은 Replica PING Replica Period(s)보다 커야한다.
General / Replica PING Replica Period(s)	replica에 ping을 보내는 주기
General / Minimum Replicas To Write	쓰기 작업을 위해 필요한 최소 replica(slave) 수를 설정
General / Minimum Replicas Max Lag	최소 replica(slave) 지연 시간의 상한을 설정
General / Replica Disable TCP No Delay	TCP_NODELAY 옵션을 비활성화할지 여부를 설정
Diskless Replication / Replica Diskless Sync	디스크를 사용하지 않고 동기화 수행
Diskless Replication / Replica Diskless Sync Delay(s)	디스크를 사용하지 않고 첫 번째 동기화 요청이 들어온 후 동기화 하지 않고 다음 replica(slave)를 기다리는 시간
Diskless Replication / Replica Diskless Sync Max Replicas	디스크를 사용하지 않고 replica(slave)를 동기화 할때 허용되는 최대 replica 수

Slave

Table 117. Slave
항목(*는 필수값)	설명	비고
General / Replica Announce IP	Master에게 알릴 본인(slave) IP
General / Replica Announce Port	Master에게 알릴 본인(slave) Port
General / Replica Serve Stale Data	Master와 연결이 끊어진 상태에도 서비스를 지속할지 여부
General / Replica Priority	replica(slave)들에서 우선순위를 설정함	해당 값이 큰 slave를 master로 승격함
Master Information / Replica of	동기화할 Master 주소
Master Information / Master User	동기화할 Master ID
Master Information / Master Password	동기화할 Master Password
Diskless Replication / Replica Diskless Load	디스크 사용하지 않고 rdb를 메모리에 올려 동기화 수행 여부

4.7.8. 설정 정보 관리 (Sentinel)

General

Memory Cache Sentinel의 설정 정보를 변경하는 기능을 제공한다.

환경설정에서 변경 가능한 속성은 아래와 같다.

Server

Table 118. Server
항목(*는 필수값)	설명	비고
Install Path(*)	Memory Cache Sentinel 인스턴스 경로	수정 불가
Port(*)	Server의 Service Port
Log Home(*)	Log Home 경로
Log File Name	로그 파일명	설정하지 않을 경우 로그를 남기지 않음
Log Level	로그 레벨

Failover

Table 119. Failover
항목(*는 필수값)	설명	비고
Master Info	상태를 감시할 Memory Cache Server(Master)를 설정
Quorum	Master의 장애를 확인하고 새로운 Master를 승격하기 위해 필요한 최소한의 Sentinel 인스턴스 동의 수
Auth User	Master ID	Master에 접속 계정/권한 설정 시
Auth Password	Master 비밀번호	Master에 접속 계정/권한 설정 시
Down after milliseconds	Master가 다운되었다고 판단하기까지 기다리는 시간
Failover Timeout	Master 장애 발생 시 새로운 Master를 선출하고 복구하는 데까지 허용되는 최대 시간
Down after milliseconds	Master가 다운되었다고 판단하기까지 기다리는 시간
Resolve Hostname	호스트 이름을 IP 주소로 변환할지 여부를 설정
TLS Replication	TLS프로토콜을 사용해 Master 접속 여부
TLS CA Certificate File	CA인증서
TLS Certificate File	공개키 인증서
TLS Key File	개인키 인증서
TLS Key File Password	개인키 비밀번호

4.7.9. Server Log Viewer

서버 목록의 우측 Log Viewer 버튼으로 대상 서버의 Log Home 경로 하위의 로그 파일 내용을 탐색할 수 있다.

이 기능을사용하기 위해서는 다음을 만족해야 한다.

대상 서버가 속한 Node 가 기동중이어야 한다.

서버 목록의 Log Viewer 버튼을 클릭하면 대상 서버의 Log Home 경로를 기준으로 디렉토리 및 파일을 트리 구조로 확인 할 수 있다.

파일을 선택하면 파일의 내용을 조회하며, 처음 선택 시 해당 파일의 맨 끝부터 정해진 크기만큼의 파일 내용을 확인 할 수 있다.

Load More, Load Previous 버튼을 사용하여 정해진 크기만큼 로그 파일의 내용을 조회 및 확인 할 수 있다.

Load Previous 버튼 사용 중 더 이상 조회할 내용이 없는 경우(eg. 파일의 맨 처음), 화면에 Alert 으로 더 이상 읽어들일 데이터가 없다는 메시지가 출력된다.
Load More 버튼 사용 중 회하는 경우 더 이상 조회할 내용이 없는 경우(eg. 파일의 맨 끝),더 이상 읽어들일 데이터가 없다는 메시지가 화면 하단에 표기 된다.

5. Cluster

5.1. Server Cluster

Server Cluster는 동일한 서비스 제공을 위해 동일한 구성으로 구동되는 Application Server와 Web Server의 묶음이다.

Figure 10. Server Cluster 화면

5.1.1. Server Cluster 목록

매니저에 등록된 Server Cluster 목록은 좌측메뉴에서 Server Cluster를 선택하면 확인 할 수 있다.

Server Cluster List 테이블에서 제공되는 속성은 아래와 같다.

Table 120. Server Cluster 속성
항목	설명	비고
Select	삭제를 위한 체크박스
Server Cluster Name	Cluster 명
Servers	Server Cluster를 구성하는 각 Server별 개수 WAS Web

5.1.2. Server Cluster 생성

Server Cluster 생성에서는 Server Cluster를 구성할 Application Server 목록과 Web Server 목록을 선택한다.

Server Cluster Group을 선택하고 Server Cluster 목록 하단의 +New 버튼 을 클릭하면 신규 등록 화면이 출력된다.
Server Cluster의 기본 정보를 입력한다.
- Server Cluster Name: Server Cluster명을 입력한다.
- WAS type: Server Cluster의 멤버로 사용될 Application의 Type을 선택한다. Standard와 Enterprise 두가지 유형이 있다.
- Enable Scaling: Auto Scaling기능 사용여부를 선택한다. 이 옵션은 server cluster 생성 후에는 변경 할 수 없다.(이 기능은 Container Edition에서만 지원하며, 사용하기 위해선 manager.conf에서 scaling.enable를 true로 설정한다.)
- Description: Server Cluster와 관련하여 필요한 설명들을 입력한다.

선택한 Application Server Type에 해당하는 서버 목록이 아래 Application server in server cluster 영역에 조회된다. Selectable Servers 에서 원하는 서버를 클릭 후 >> 버튼 을 눌러 Selected Servers 영역으로 옮긴다. Web Servers in server cluster 영역에서 마찬가지로 Selectable Servers에서 원하는 서버를 클릭 후 >> 버튼 을 눌러 Selected Servers 영역으로 옮긴다.

하나의 Server는 하나의 Server Cluster에만 지정할 수 있으므로, 다른 Server Cluster에 매핑되지 않은 Application Server와 Web Server만 Selectable Servers 목록에 조회된다.
Engine No.가 다른 WAS인스턴스를 하나의 Server Cluster로 구성할 수 없다.

V Save 버튼 을 클릭하여 저장한다.
좌측 트리에 입력한 Server Cluster명의 메뉴가 추가되었음을 확인할 수 있다.

5.1.3. Server Cluster 삭제

좌측 Server Cluster 트리메뉴에서 Server Cluster Group을 선택한다.
Server Cluster List에서 삭제할 Server Cluster의 Select 컬럼의 체크박스를 선택한다.
- Delete 버튼 을 클릭하여 삭제한다.

5.1.4. Server Cluster 상세

Overview

좌측 메뉴 또는 Server Cluster Group 상세에서 Server Cluster를 선택하면 Server Cluster에 대한 Overview 화면이 출력된다.

Server Cluster 상세 영역의 항목 및 버튼이 제공하는 기능은 아래와 같다.

Table 121. Server Cluster 상세 영역의 항목 및 버튼
항목 또는 버튼명	기능
Server Cluster Name(*)	Server Cluster 명
WAS type(*)	Server Cluster에 구성되어 있는 Application Server 유형(변경 불가)
Server Config Synchronization Policy	Server Cluster 동기화 수행(Sync 버튼 선택) 중 오류 발생시 처리 정책 Server Config Synchronization Policy의 option은 아래와 같다. (기본값 : Force) Stop : 설정 동기화 중 오류 발생 시 즉시 중지 Rollback : 설정 동기화 중 오류 발생 시 전체 rollback Force : 설정 동기화 중 오류 발생 시 해당 Server를 건너뛰고 다음 수행
Enable Scaling	Server Cluster의 Auto Scaling 기능 사용여부(변경 불가)
Description	Server Cluster에 대한 설명
Compare 버튼	Server Cluster 내 Application Server와 Web Server, Session Server의 동기화 상태를 비교한다. Server 유형별 비교 항목은 아래와 같으며, 이는 아래 Server 목록 영역 각각의 컬럼에 출력된다. Server Config, Application, Resource 및 Session 비교는 각 Server 유형별 Master Server를 기준으로 한다. Application Server Server Config : Application Server 설정 정보 동일 여부 Application : 각 Application Server에 deploy된 Application이 동일 여부 Resource : Resource 설정 동일 여부 Session : Session Clustering을 위한 Session Server 설정 동일 여부 Web Server Server Config : Web Server 설정 정보 동일 여부 Connect to WAS : Server Cluster 내 모든 Application Server와 연계되어 있는지 여부
Sync 버튼	Server Cluster 내 Application Server의 Server Config, Application, Resource, Session 정보를 동기화한다. Server Cluster 내 Web Server의 Server Config를 동기화한다.
Clustering 버튼	마스터 Web Server에 Server Cluster 내 WAS를 Full Mesh 구조로 반영하고, 슬레이브 Web Server에 전파한다.
Snapshot 버튼	동기화된 Server Cluster에 대해 현재 상태를 Snapshot으로 저장한다. 생성된 Snapshot은 Snapshot 탭에서 확인할 수 있다. Snapshot에는 Application Source도 포함된다. 따라서 과도하게 Snapshot을 생성하면 시스템 디스크 용량을 많이 차지할 수 있으므로 꼭 필요한 경우에만 생성하고 불필요한 Snapshot은 Snapshot 탭을 통해 삭제해야 한다.
Graceful Restart 버튼	Server Cluster 내 Web Server와 Application Server를 순차적으로 재기동한다. Graceful Stop을 수행하므로 처리 중인 service가 모두 종료된 후 Server가 stop 된다. 처리 순서는 아래와 같다. ()로 표현된 절차는 생략 가능하다. Web Server Stop Application Stop (Application Source 업로드) Application Server Start (별도 port로 테스트를 위해 Web Server를 staging port로 Start) Web Server Start
V Save 버튼	변경된 Server Cluster 상세 설정 내용을 저장한다.

동기화 상태 조회

Server Cluster의 동기화 상태는 Compare 버튼 을 선택하여 비교 후 그 결과를 각 Server 목록의 아래 컬럼을 통해 확인할 수 있다.

동일 또는 유효한 상태인 경우 상태가 초록색 원 아이콘 으로 출력된다.

Server의 상태가 동일하지 않을 경우 붉은색 원 아이콘 으로 나타나며, 해당 아이콘을 클릭하면 별도의 팝업창이 출력되어 Server별 상세 정보를 확인할 수 있다.

또한 각 Server 목록에서 Server Name을 클릭하면 해당 Server 상세 화면으로 이동할 수 있다.

Application Server의 Server Config 상세

설정 파일의 비교 결과가 출력된다. 팝업창에서 파일 명 옆에 있는 Detail 항목의 돋보기 버튼 을 클릭하면 Master서버와 비교하여 현재 설정 파일의 비교결과(최종 수정일자, 설정 파일 내용)를 상세하게 볼 수 있다.
Application Server의 Application 상세

Application의 Deploy 상태 비교 결과가 출력된다.
Application Server의 Resource 상세

Application Server의 Resource 비교 결과가 출력된다.
Application Server의 Session 상세

Application Server의 Session 설정 비교 결과가 출력된다. 팝업창에는 Master Server에 설정된 세션 정보를 제공한다.
Web Server의 Server Config

설정 파일의 비교 결과가 출력된다. 팝업창에서 파일 명 옆에 있는 Detail 항목의 돋보기 버튼 을 클릭하면 Master서버와 비교하여 현재 설정 파일의 비교결과(최종 수정일자, 설정 파일 내용)를 상세하게 볼 수 있다.
Web Server의 Connect to WAS

해당 Web Server가 Server Cluster에 속한 모든 Application Server에만 연계되어 있을 때 초록색 원 아이콘 상태로 출력되며 그 외의 경우에는 붉은색 원 아이콘 으로 표시된다. 붉은색 원 아이콘 을 클릭하면 별도의 팝업창이 출력되어 상세 정보를 확인할 수 있다.

팝업창에는 Web Server에 연계되어 있는 Application Server가 모두 Server Cluster에 등록된 Server인지에 대한 상세 정보를 출력한다((Web Server Status). 또한 Server Cluster에 등록된 모든 Application Server가 해당 Web Server에 연계되어 있는지에 대한 상세 정보를 출력한다.(Application Server Status)

상태 동기화 수행

Server Cluster의 동기화 수행은 Sync 버튼 을 선택하여 진행 한다. 그 결과는 각 Server 목록의 아래 컬럼을 통해 확인할 수 있다.

Graceful Restart

Graceful Restart 기능은 처리중인 업무의 처리 종료를 보장하면서 Server Cluster 내 모든 서버에 대한 재기동을 수행할 때 사용된다. 수행시 아래와 같은 절차를 통해 수행된다. (Server Cluster 내 모든 서버에 적용됨)

Graceful Restart 시작 전

Start Process 버튼을 클릭하면 Graceful Restart 작업이 시작된다.
Web Server Stop 단계

Web Server에 대한 Stop을 수행한다. 수행 중인 Thread가 모두 종료된 후 Web Server가 Stop된다.
Application Server Stop 단계

Application Server에 대한 Stop을 수행한다. 본 단계는 모든 Web Server가 종료된 후 활성화된다.
소스 배포 (생략 가능) 단계

Application Server에 대한 소스 배포(업로드)를 수행한다. 별도의 배포 시스템이 있는 경우 이 단계는 생략 가능하다.
Application Server Start 단계

Application Server에 대한 Start를 수행한다. 기동 로그를 함께 조회할 수 있다.
Web Server를 Staging mode로 Start (생략 가능) 단계

Web Server를 Staging mode로 Start 한다. (본 단계는 생략 가능하다.) 이를 통해 일반 사용자에게 open 하기 전, 운영과 동일한 환경에서 staging port로 업무에 대한 테스트를 수행할 수 있다.
Web Server Start 단계

Web Server를 Staging mode로 Start 한다. (본 단계는 생략 가능하다.) 이를 통해 일반 사용자에게 open 하기 전, 운영과 동일한 환경에서 staging port로 업무에 대한 테스트를 수행할 수 있다.
Graceful Restart 완료

WAS

Server Cluster 내 Application Server의 목록 및 동기화 대상 정보를 관리하는 탭이다.

탭 상단의 서버 목록에 대한 상세 정보는 Overview와 동일하다.

동기화 대상 항목

서버 설정 파일 관리

Config 버튼 을 선택하면 제공되는 팝업창을 통해 Application Server의 Master Server 선택, 동기화 할 설정파일 지정 및 JDBC Driver 동기화 여부를 설정할 수 있다.

Master Server

Server Cluster내 Application Server 중 Master Server를 지정한다.
Server Configs for Synchronization

Server Cluster 내의 Application Server에서 동일한 내용으로 유지할 파일 목록이다. Server Cluster 생성시 기본적인 파일 목록이 등록되어 있으며 프로젝트 사정에 맞게 파일을 추가/삭제할 수 있다. 파일의 경로는 Application Server의 Home 하위의 상대 경로이다.
Sync JDBC Drivers

Manager Repository 경로/lib/datasource/폴더 하위 모든 jar파일을 동기화대상에 포함할지 여부를 선택한다.

JDBC Driver는 Runtime시 Jar파일 교체에 따른 오류를 방지하기 위해 Sync 대상 서버에 해당 JDBC Driver가 없을 경우에만 동기화 된다.

Application 관리

Application Server 목록에서 서버를 선택시 하단의 Application 탭을 통해 선택된 서버의 Application 상세 정보를 확인 할 수 있다. 제공되는 화면과 기능은 Application에서 기술한 내용과 동일하다. 따라서 기능에 대한 상세 설명은 본 장에서는 생략한다.

Resource 관리

Application Server 목록에서 서버를 선택시 하단의 DataSource, JMS, JTA 탭을 통해 선택된 서버의 DataSource, JMS, JTA의 상세 정보를 확인 할 수 있다.

제공되는 화면과 기능은 Datasource, JMS, JTA에서 기술한 내용과 동일하다. 따라서 기능에 대한 상세 설명은 본 장에서는 생략한다.

Session 관리

Application Server 목록에서 서버를 선택시 하단의 Session 탭을 통해 선택된 서버의 Session 상세 정보를 확인 할 수 있다.

제공되는 화면과 기능은 Session에서 기술한 내용과 동일하다. 따라서 기능에 대한 상세 설명은 본 장에서는 생략한다.

WAS 목록 관리

Clone 버튼, Join 버튼 또는 Unjoin 버튼 을 사용하여 Application Server를 Server Cluster에 포함 또는 제외시킬 수 있다.

Clone

Clone 버튼 을 클릭하면 Master서버와 동일한 설정을 가진 새로운 서버를 설치후 Server Cluster에 등록할 수 있다.

Table 122. Clone 팝업창 항목 설명
항목명	기능
Post Processing Options	Cloned Server Start: Clone후 서버 기동 여부 체크 All Web Server Sync: Clone후 Web Server와 연동 동기화 All Web Server Graceful Restart : Clone후 Web Server 재기동 여부
Node List	복제할 서버를 설치할 노드
Clone Server ID / Clone Service Port	복제할 Server의 ID와 Service Port 입력
Include External Source	복제하려는 서버의 application 소스가 서버 외부에 있는데 이 소스까지 복제하려는 경우 Y 선택

Join

Join 버튼 을 클릭하면 이미 생성한 Application Server 중 등록 가능한 Server를 Server Cluster에 추가한다.
Unjoin

Unjoin 버튼 을 클릭하면 Cluster에 등록된 Server를 Cluster목록에서 제거한다.

Application Server 동기화 및 비교

Compare

Compare 버튼 을 클릭하면 Server Cluster 내 Application Server의 동기화 상태를 비교한다.
Sync

Sync 버튼 을 클릭하면 Server Cluster 내 Application Server의 Server Config, Application, Resource, Session 설정을 동기화한다.

Rolling Restart

Rolling Restart는 Server Cluster내에서 Application Server들을 순차적으로 재기동 할 때 사용한다.

재기동할 서버를 대상으로 수행하는 기능이므로 정지된 서버는 제외한다. 서버 목록에서 대상 서버들을 선택한 후 Rolling Restart 버튼 을 클릭하면 Rolling Restart팝업창이 제공된다.

팝업창에서 사용자는 Rolling Restart 시작 전 Execution option 영역에서 서버와 서버 사이의 기동 시작 Interval과 Force Stop 여부를 설정 할 수 있다. Rolling Restart 영역에서는 선택된 서버들이 순차적으로 재기동을 수행하는 상태를 확인할 수 있다.

팝업창의 Action 항목에는 Force Restart 버튼 과 Next 버튼 이 제공된다.

Table 123. Rolling Restart 팝업창 항목 설명
Node	서버가 설치된 노드명
Server	서버명
Server Status	서버의 현재 기동상태
Stop Status	서버 정지 작업 상태
Start Status	서버 기동 작업 상태
Action	재기동 중인 서버의 경우 Force Restart 버튼 과 Next 버튼 이 제공된다.
Interval	서버에 남아있는 처리 시간. Execution Option 영역의 Interval에 설정된 값에서 시작하여 0까지 내려간 후 다음 서버의 재기동을 수행한다.
Elapsed time	재기동 처리 시간

Table 124. Rolling Restart 팝업창 버튼 설명
버튼명	기능
Start	팝업창에 보여지는 대상서버의 재기동을 시작한다. 테이블의 위에서부터 순차적으로 진행된다.
Pause	재기동작업을 일시 중지한다. 중지 / 기동을 수행중인 경우 수행중인 명령이 중단되지는 않으며, 다음 작업은 대기하게 된다.
Resume	재기동작업을 재개한다. Pause 전 완료한 작업 이후부터 시작된다.
Force Restart	중지가 정상적을 되지 않는경우 본 버튼을 통해 강제 중지후 기동할 수 있다. 재기동 수행중인 서버가 중지 완료될때까지만 화면에 보여진다.
Next	현재 재기동중인 서버의 작업이 완료되기 전, 다음 서버의 재기동작업을 바로 진행하고 싶은경우 Next 버튼을 통해 다음 서버의 재기동을 수행할 수 있다. Next 를 수행해도 앞 서버들의 재기동 작업은 계속 수행된다.

Web Server

Server Cluster 내 Web Server의 목록 및 동기화 대상 정보를 관리하는 탭이다.

탭 상단의 서버 목록에 대한 상세 정보는 Overview와 동일하다.

동기화 대상 항목

서버 설정 파일 관리

Config 버튼 을 선택하면 제공되는 팝업창을 통해 Web Server의 Master Server 선택, 동기화 할 설정파일목록을 설정할 수 있다.

Master Server :

Server Cluster내 Web Server 중 Master Server를 지정한다.
Server Configs for Synchronization :

Server Cluster 내의 Web Server에서 동일한 내용으로 유지할 파일 목록이다. Server Cluster 생성시 기본적인 파일 목록이 등록되어 있으며 프로젝트 사정에 맞게 파일을 추가/삭제할 수 있다. 파일의 경로는 Web Server의 Home 하위의 상대 경로이다.

Connector

Web Server의 상세 connector정보들을 확인 및 수정 할 수 있다.

Web Server 목록에서 서버를 선택시 하단의 Connector 탭을 통해 선택된 서버의 Connector 상세 정보를 확인 할 수 있다. 제공되는 화면과 기능은 Connector에서 기술한 내용과 동일하다. 따라서 기능에 대한 상세 설명은 본 장에서는 생략한다.

Web Server 목록 관리

Clone 버튼, Join 버튼 또는 Unjoin 버튼 을 사용하여 Web Server를 Server Cluster에 포함 또는 제외시킬 수 있다.

Clone

Clone 버튼 을 클릭하면 Master서버와 동일한 설정을 가진 새로운 서버를 설치후 Server Cluster에 등록할 수 있다.

Table 125. Clone 팝업창 항목 설명
항목명	기능
Post Processing Options	Cloned Server Start: Clone후 서버 기동 여부 체크
Node List	복제할 서버를 설치할 노드
Server ID / Clone Service Port	복제할 Server의 ID와 Service Port 입력
Include External Source	복제하려는 서버의 소스가 서버 외부에 있는데 이 소스까지 복제하려는 경우 Y 선택

Join

Join 버튼 을 클릭하면 이미 생성한 Web Server 중 등록 가능한 Server를 Server Cluster에 추가한다.
Unjoin

Unjoin 버튼 을 클릭하면 Cluster에 등록된 Server를 Cluster목록에서 제거한다.

Web Server 동기화 및 비교

Compare

Compare 버튼 을 클릭하면 Server Cluster 내 Web Server의 동기화 상태를 비교한다.
Sync

Sync 버튼 을 클릭하면 Server Cluster 내 Web Server의 Server Config를 동기화한다.
Clustering

Clustering 버튼 을 클릭하면 마스터 Web Server에 Server Cluster 내 WAS를 Full Mesh 구조로 반영하고, 슬레이브 Web Server에 전파한다.

Rolling Restart

Rolling Restart는 Server Cluster내에서 Web Server들을 순차적으로 재기동 할 때 사용한다.

Table 126. Rolling Restart 팝업창 항목 설명
Node	서버가 설치된 노드명
Server	서버명
Server Status	서버의 현재 기동상태
Stop Status	서버 정지 작업 상태
Start Status	서버 기동 작업 상태
Action	재기동 중인 서버의 경우 Force Restart 버튼 과 Skip 버튼 이 제공된다.
Interval	서버에 남아있는 처리 시간. Execution Option 영역의 Interval에 설정된 값에서 시작하여 0까지 내려간 후 다음 서버의 재기동을 수행한다.
Elapsed time	재기동 처리 시간

Snapshot

Overview Tab의 Snapshot 버튼을 클릭하면 Snapshot 생성을 위한 창이 출력되며 Save 버튼을 클릭하면 Server Cluster의 Snapshot이 생성된다.

Snapshot은 Server Cluster가 동기화 상태인 경우에만 생성할 수 있다.

Snapshot 탭을 통해 Snapshot 목록을 관리하는 화면을 제공한다. 일자를 입력 받아 Snapshot 이력을 조회한다. Snapshot이력에 대한 자세한 사항을 조회 할 수 있으며, 원하는 시점으로 복원하는 기능도 제공한다.

Snapshot 목록의 Detail 항목에 있는 목록 버튼 을 클릭하면 해당 snapshot에 대한 상세정보를 조회할 수 있다.

Snapshot 정보는 각 server별로 관리하므로 특정 Snapshot 생성 이후 Cluster에 추가된 server는 해당 Snapshot으로의 복원 대상에서 제외된다. (이 경우 Snapshot 복원 후 다시 Sync를 수행해야 모든 server가 동일한 구성을 가질 수 있다.) 또한 Snapshot 이후 Cluster에서 특정 server가 삭제되면 해당 server의 Snapshot 정보는 모두 삭제된다. Snapshot을 만들 때 소스코드는 Snapshot에 복사 되지 않으며 복사되는 설정파일은 기본설정파일 과 application설정파일, enterprise.xml 까지만 Snapshot에 포함된다.

Snapshot을 생성할 경우 디스크 용량에 부하를 줄 수 있으므로 주의하여 생성한다. 또한 생성된 Snapshot은 자동으로 삭제되지 않고 사용자가 직접 삭제해야 한다. 따라서 불필요한 Snapshot을 적절한 시기에 삭제하는 것을 권장한다.

6. Resource

6.1. Database

좌측 메뉴에서 Database를 선택하면 Database Resource 목록이 조회된다.

Figure 11. Database 목록 조회 화면

6.1.1. Database 등록

Database Resource 목록에서 New 버튼 을 클릭하면 신규 등록 화면이 출력된다.
입력 항목을 입력한다.
- Resource Name을 입력한다.
- DriverClassName을 확인 후 원하는 벤더의 드라이버를 선택한다.
- Address(host/Port) 정보를 입력한다.
Save 버튼 을 클릭해 저장한다.

6.1.2. Database 수정

Database Resource 목록에서 수정하려는 Database Resource의 체크박스를 선택한다.
Database Resource의 항목을 수정한 후 저장한다.

내용이 수정될 경우 해당 Database Resource에 연결된 DataSoruce Resource및 WAS의 설정에 전파되므로, 해당 Database Resource 하위에 연결된 DataSoruce Resource가 존재할 경우 입력창이 기본적으로 Disable 된다. Edit 버튼 을 클릭하면 수정할 수 있다.

6.2. DataSource

좌측 메뉴에서 DataSource를 선택하면 DataSource Resource 목록이 조회된다.

Figure 12. DataSource 목록 조회 화면

6.2.1. DataSource 등록

DataSource Resource 목록에서 New 버튼 을 클릭하면 신규 등록 화면이 출력된다.
Resource Name 필드에 논리적인 이름을 입력한다.
Server Type을 설정한다. Server Type은 Standard, Enterprise 중에 선택하여야 하며, 이 후 같은 Type의 서버에서만 Import하여 사용할 수 있다.
DataSource의 상세 설정을 한다(<Server DataSource 설정>>의 상세 항목 설명 참고)
Upload 버튼 을 클릭하여 해당 DataSource의 Driver를 Manager서버에 등록한다. 미리 등록된 Driver는 운영자가 Server에 Import하는 시점에 해당 Server로 전송된다.
Save 버튼 버튼을 클릭하여 저장한다.

Manager에 업로드 된 JDBC Driver는, 운영자가 Server에 해당 DataSource Resource를 Import하는 시점에 해당 Server로 전송된다. 전송된 JDBC Driver는 {서버홈경로}/lib/datasource 디렉토리에 위치하며 Classpath에 자동으로 등록된다.

6.2.2. DataSource 수정

DataSource Resource 목록에서 수정하고자 하는 행을 선택하면 DataSource Resource 수정 화면이 표시된다.
변경하고자 하는 설정을 변경한다.
Save 버튼 을 클릭하여 저장한다.

Figure 13. DataSource 상세 정보 화면

DataSource Resource 정보를 수정한 후 저장하면 해당 DataSource Resource가 사용되는 Server에 변경된 설정이 전파된다. 설정이 전파된 Server를 재기동하면 해당 설정이 적용된다.

Standard Type으로 설정한 DataSource Resource를 Standard 서버에 Import 한 후에 Server Type을 Enterprise로 변경할 수 없다.

Classpath 등록 후 DataSource Resource 삭제 시, Classpath는 삭제되지 않음에 유의해야 한다.

6.2.3. DataSource 삭제

DataSource Resource 목록에서 삭제할 DataSource Resource의 체크박스를 선택한다.
Delete 버튼 을 클릭하여 삭제한다.

Server 또는 Application에서 Import하여 Registered Server 또는 Registered Application이 존재하는 경우, 해당 DataSource Resource는 삭제할 수 없다.

6.2.4. JDBC Driver Upload

DataSource Resource 등록 혹은 수정 화면에서 Upload 버튼 을 클릭하면 Driver File을 Upload 할 수 있는 화면이 출력된다.
파일선택 버튼 을 클릭하여 Local PC에서 upload 하고자 하는 Driver File을 선택한다.
Upload 버튼 을 클릭하여 Manager로 Driver File을 Upload한다.

6.2.5. DataSource Import

생성한 DataSource Resource를 Import해서 사용하고 있는 Server 목록(Scope가 Context, Global, Global + Link인 경우) 또는 Application목록(Scope가 Application인 경우)은 DataSource Resource 상세 조회 시 하단 영역에 표시된다.

DataSource 상세 화면에서 DataSource Import 하기

Scope가 Context, Global, Global + Link인 DataSource Resource는 자신을 Import하는 Server를 등록할 수 있다.

DataSource 관리 화면에서 특정 DataSource Resource를 선택하여 상세 정보 화면으로 이동한다.
Edit Server List 버튼 을 클릭하면 Server를 등록 관리 할 수 있는 창이 출력된다.
해당 DataSource를 Import 할 Server를 지정해 우측 영역으로 이동시킨다.
Save 버튼 을 클릭하면 해당 Server에 DataSource Resource가 Import 된다.

Import된 DataSource Resource를 Server에서 삭제하려면, 대상 Server를 좌측 영역으로 이동시킨 후 Save 버튼 을 클릭한다.

개별 Server에서 DataSource Import 하기

LENA Manager 상단의 Servers 메뉴를 선택한다.
좌측에서 개별 Web Application Server > Resources > DataSource 탭을 클릭하면, 해당 Server의 DataSource Resource 목록 조회 및 DataSource Resource 추가를 할 수 있는 화면이 출력된다.
Import 버튼 을 클릭하면 팝업 창에 미리 정의된 DataSource Resource 목록이 조회된다.
Import 하고자 하는 DataSource Resource를 선택한다.
OK 버튼 을 클릭하여 해당 DataSource Resource를 Import 한다.

DataSource Resource를 Import 하게 되면 해당 DataSource Resource와 Server 간의 연결정보가 내부적으로 생성된다. 이 연결 정보를 기반으로 DataSource Resource 수정 시점에 설정 변경 사항이 해당 Server에 전달된다. 연결 정보는 Resource > DataSource 화면에서 조회할 수 있다.

Standard Server에서는 Enterprise Type의 DataSource Resource를 Import 할 수 없다.(목록에 표시되지 않음)

Import한 DataSource Resource 설정은 Server 설정에서 편집할 수 없다.(설정 정보는 볼 수 있지만 수정 불가) 설정을 변경하고자 한다면 Resource > DataSource 화면으로 이동하여 변경한다.

6.2.6. DataSource 비밀번호 암호화

ADMIN > Encryption 기능을 활성화한 경우, DataSource의 DB 비밀번호를 {ENC:AES256} 형태로 암호화하여 서버의 `lena-security.properties`에 보관할 수 있다.

사전 조건: ADMIN > Encryption > Key Management에서 Seed Key가 생성되고 대상 노드에 배포되어 있어야 한다.

DataSource 등록 또는 수정 화면에서 아래 항목을 설정한다.

항목

설명

Encryption Level

암호화 대상 범위를 선택한다. Password만 암호화하거나, URL·Username·Password 전체를 암호화하도록 선택할 수 있다.

Store in server security properties

체크 시 암호화된 접속 정보를 서버의 `lena-security.properties`에 저장하고 DataSource 설정에서는 참조 형태로 관리한다.

DataSource 등록 또는 수정 화면에서 Encryption Level을 선택한다.
Store in server security properties 체크박스를 선택한다.
비밀번호 필드에 평문 값을 입력한다.
Save 버튼 을 클릭하면 입력한 값이 자동으로 암호화되어 `lena-security.properties`에 저장된다.

6.3. JTA

좌측 메뉴에서 JTA를 선택하면 JTA Resource 목록이 조회된다.

Figure 14. JTA 목록 조회 화면

6.3.1. JTA 등록

JTA 목록에서 New 버튼 을 클릭하면 신규 등록 화면이 출력된다.
설정하고자 하는 값을 입력한다.(상세 설정 값은 "4.3.7 Server 설정 정보 관리" 참고)
Save 버튼 을 클릭하여 저장한다.

6.3.2. JTA 수정

JTA Resource 목록에서 수정하고자 하는 행을 선택하면 수정 화면이 표시된다.
변경하고자 설정을 입력한다.
Save 버튼 을 클릭하여 저장한다.

Figure 15. JTA 상세 정보 화면

JTA Resource 정보를 수정한 후 저장하게 되면 해당 JTA Resource가 사용되는 Server에 변경된 설정이 전파된다. 설정이 전파된 Server는 재기동하게 되면 해당 설정이 적용된다.

6.3.3. JTA 삭제

JTA 목록에서 삭제할 JTA Resource의 체크박스를 선택한다.
Delete 버튼 을 클릭하여 삭제한다.

Server에서 import하여 Registered Server가 존재하는 경우 해당 JTA Resource를 삭제할 수 없다.

6.3.4. JTA Import

생성한 JTA Resource를 Import해서 사용하고 있는 Server 목록은 JTA Resource 상세 조회 시 하단 영역에 표시된다.

JTA 상세 화면에서 JTA Import 하기

JTA 상세 화면에서 자신을 Import해서 사용하고 있는 Server 목록을 수정할 수 있다.

JTA 관리 화면에서 특정 JTA Resource를 선택하여 상세 정보 화면으로 이동한다.
Edit Server List 버튼 을 클릭하면 Server를 등록 관리할 수 있는 창이 출력된다.
해당 JTA Resource를 Import 할 Server를 지정해 우측 영역으로 이동시킨다.
Save 버튼 을 클릭하면 해당 Server에 JTA Resource가 Import 된다.

Import된 JTA Resource를 Server에서 삭제하려면, 대상 Server를 좌측 영역으로 이동시킨 후 Save 버튼 을 클릭한다.

개별 Server에서 JTA Import 하기

LENA Manager 상단의 Servers 메뉴를 선택한다.
좌측에서 개별 Web Application Server > Resources > JTA 탭을 클릭하면, 해당 Server의 JTA Resource 목록 조회 및 JTA Resource 추가를 할 수 있는 화면이 출력된다.
Import 버튼 을 클릭하면 팝업 창에 미리 정의된 JTA Resource 목록이 조회된다.
Import 하고자 하는 JTA Resource를 선택한다.
OK 버튼 을 클릭하여 해당 JTA Resource를 Import 한다.

JTA Resource를 Import 하게 되면 해당 JTA Resource와 Server 간의 연결정보가 내부적으로 생성된다. 이 연결 정보를 기반으로 JTA Resource 수정 시점에 설정 변경 사항이 해당 Server에 전달된다. 연결 정보는 Resource > JTA 화면에서 조회할 수 있다.

Import한 JTA Resource 설정은 Server 설정에서 편집할 수 없다.(설정 정보는 볼 수 있지만 수정 불가) 설정을 변경하고자 한다면 Resource > JTA 화면으로 이동하여 변경한다.

6.4. JMS

좌측 메뉴에서 JMS를 선택하면 JMS Resource 목록이 조회된다.

Figure 16. JMS 목록 조회 화면

6.4.1. JMS 등록

JMS 목록에서 New 버튼 을 클릭하면 신규 등록 화면이 출력된다.
등록할 JMS Resource의 유형을 선택하면 하단에 선택한 유형에 맞게 설정 정보가 표시된다.
설정하고자 하는 값을 입력한다.(상세 설정 값은 "4.3.7 Server 설정 정보 관리" 참고)
Save 버튼 을 클릭하여 저장한다.

6.4.2. JMS 수정

JMS Resource 목록에서 수정하고자 하는 행을 선택하면 수정 화면이 표시된다.
변경하고자 설정을 입력한다.
Save 버튼 을 클릭하여 저장한다.

Figure 17. JMS 상세 정보 화면

JMS Resource 정보를 수정한 후 저장하게 되면 해당 JMS Resource 가 사용되는 Server 에 변경된 설정이 전파된다. 설정이 전파된 Server는 재기동하게 되면 해당 설정이 적용된다.

6.4.3. JMS 삭제

JMS 목록에서 삭제할 JMS Resource의 체크박스를 선택한다.
Delete 버튼 을 클릭하여 삭제한다.

Server에서 import하여 Registered Server가 존재하는 경우 해당 JMS Resource를 삭제할 수 없다.

6.4.4. JMS Import

생성한 JMS Resource를 Import해서 사용하고 있는 Server 목록은 JMS Resource 상세 조회 시 하단 영역에 표시된다.

JMS 상세 화면에서 JMS Import 하기

JMS 상세 화면에서 자신을 Import해서 사용하고 있는 Server 목록을 수정할 수 있다.

JMS 관리 화면에서 특정 JMS Resource를 선택하여 상세 정보 화면으로 이동한다.
Edit Server List 버튼 을 클릭하면 Server를 등록 관리 할 수 있는 창이 출력된다.
해당 JMS를 Import 할 Server를 지정해 우측 영역으로 이동시킨다.
Save 버튼 을 클릭하면 해당 Server에 JMS Resource가 Import 된다.

Import된 JMS Resource를 Server에서 삭제하려면, 대상 Server를 좌측 영역으로 이동시킨 후 Save 버튼 을 클릭한다.

개별 Server에서 JMS Import 하기

LENA Manager 상단의 Servers 메뉴를 선택한다.
좌측에서 개별 Web Application Server > Resources > JMS 탭을 클릭하면, 해당 Server의 JMS Resource 목록 조회 및 JMS Resource 추가를 할 수 있는 화면이 출력된다.
Import 버튼 을 클릭하면 팝업 창에 미리 정의된 JMS Resource 목록이 조회된다.
Import 하고자 하는 JMS Resource를 선택한다.
OK 버튼 을 클릭하여 해당 JMS Resource를 Import 한다.

JMS Resource를 Import 하게 되면 해당 JMS Resource와 Server 간의 연결정보가 내부적으로 생성된다. 이 연결 정보를 기반으로 JMS Resource 수정 시점에 설정 변경 사항이 해당 Server에 전달된다. 연결 정보는 Resource > JMS 화면에서 조회할 수 있다.

Import한 JMS Resource 설정은 Server 설정에서 편집할 수 없다.(설정 정보는 볼 수 있지만 수정 불가) 설정을 변경하고자 한다면 Resource > JMS 화면으로 이동하여 변경한다.

6.5. Application

좌측 메뉴에서 Application를 선택하면 Application Resource 목록이 조회된다.

Figure 18. Application 목록 조회 화면

6.5.1. Application 등록

Application 목록에서 New 버튼 을 클릭하면 신규 등록 화면이 출력된다.
설정하고자 하는 값을 입력한다.
- Application Type이 WAR일 경우에는 추가로 설정할 수 있는 항목이 표시된다.(상세 설정 값은 Application Settings 참고)
Save 버튼 을 클릭하여 저장한다.

6.5.2. Application 수정

Application Resource 목록에서 수정하고자 하는 행을 선택하면 수정 화면이 표시된다.
변경하고자 설정을 입력한다.
Save 버튼 을 클릭하여 저장한다.

Figure 19. Application 상세 정보 화면

Application Resource 정보를 수정한 후 저장하게 되면 해당 Resource가 사용되는 Server에 변경된 설정이 전파된다. 설정이 전파된 Server는 재기동하게 되면 해당 설정이 적용된다.

6.5.3. Application 삭제

Application 목록에서 삭제할 Application Resource의 체크박스를 선택한다.
Delete 버튼 을 클릭하여 삭제한다.

Server에서 import하여 Registered Server가 존재하는 경우 해당 Application Resource를 삭제할 수 없다.

6.5.4. Application Upload

Application Resource 등록 혹은 수정 화면에서 Upload 버튼 을 클릭하면 Application File을 Upload 할 수 있는 화면이 출력된다.
파일선택 버튼 을 클릭하여 Local PC에서 upload 하고자 하는 Application File을 선택한다.
Upload 버튼 을 클릭하여 Manager로 Application File을 Upload한다.

Application Import

생성한 Application Resource를 Import해서 사용하고 있는 Server 목록은, Application Resource 상세 조회 하단 영역에 표시된다.

Application 상세 화면에서 Application Import 하기

Application 상세 화면에서 자신을 Import해서 사용하고 있는 Server 목록을 수정할 수 있다.

Application 관리 화면에서 특정 Application Resource를 선택하여 상세 정보 화면으로 이동한다.
Edit Server List 버튼 을 클릭하면 Server를 등록 관리할 수 있는 창이 출력된다.
해당 Application를 Import 할 Server를 지정해 우측 영역으로 이동시킨다.
Save 버튼 을 클릭하면 해당 Server에 Application Resource가 Import 된다.

Import된 Application Resource를 Server에서 삭제하려면, 대상 Server를 좌측 영역으로 이동시킨 후 Save 버튼 을 클릭한다.

개별 Server에서 Application Import 하기

LENA Manager 상단의 Servers 메뉴를 선택한다.
좌측에서 개별 Web Application Server > Applications 메뉴를 클릭하면, 해당 Server의 Application Resource 목록 조회 및 Application Resource 추가를 할 수 있는 화면이 출력된다.
Import 버튼 을 클릭하면 팝업 창에 미리 정의된 Application Resource 목록이 조회된다.
Import 하고자 하는 Application Resource를 선택한다.
OK 버튼 을 클릭하여 해당 Application Resource를 Import 한다.

Application Resource를 Import 하게 되면 해당 Application Resource와 Server간의 연결정보가 내부적으로 생성된다. 이 연결 정보를 기반으로 Application Resource 수정 시점에 설정 변경 사항이 해당 Server에 전달된다. 연결 정보는 Resource > Application 화면에서 조회할 수 있다.

Import한 Application Resource 설정은 Server 설정에서 편집할 수 없다.(설정 정보는 볼 수 있지만 수정 불가) 설정을 변경하고자 한다면 Resource > Application 화면으로 이동하여 변경한다.

6.6. Library Resources

좌측 메뉴에서 Library Resources를 선택하면 Library Resource 목록이 조회된다. Library Resources는 범용적인 JAR 파일이나 라이브러리를 서버에 배포하기 위한 기능을 제공한다.

6.6.1. Library Resources 개요

Library Resources 기능은 다음과 같은 용도로 사용된다:

공통 유틸리티 라이브러리 배포
서드파티 JAR 파일 일괄 배포
서버 간 라이브러리 버전 통일 관리

DataSource의 JDBC Driver 배포와 달리, Library Resources는 범용적인 라이브러리 파일을 관리한다.

6.6.2. Library Resources 등록

Library Resources 목록에서 New 버튼 을 클릭하면 신규 등록 화면이 출력된다.
Resource Name 필드에 논리적인 이름을 입력한다.
Library 파일의 배포 경로(Doc Base)를 설정한다.
Upload 버튼 을 클릭하여 라이브러리 파일을 Manager 서버에 등록한다.
Save 버튼 을 클릭하여 저장한다.

Table 127. 등록 시 설정 항목
항목	설명	비고
Resource Name	리소스의 논리적 이름	필수
Doc Base	라이브러리 파일의 배포 경로	서버 내 상대 경로
Library Path	업로드된 라이브러리 파일 경로	자동 생성
Description	리소스에 대한 설명	선택

6.6.3. Library Resources 수정

Library Resources 목록에서 수정하고자 하는 행을 선택하면 상세 정보 화면이 표시된다.
변경하고자 하는 설정을 변경한다.
Save 버튼 을 클릭하여 저장한다.

Library Resource 정보를 수정한 후 저장하면 해당 Resource가 Import된 서버에 변경된 설정이 전파된다. 설정이 전파된 서버를 재기동하면 해당 설정이 적용된다.

6.6.4. Library Resources 삭제

Library Resources 목록에서 삭제할 Resource의 체크박스를 선택한다.
Delete 버튼 을 클릭하여 삭제한다.

서버에서 Import하여 사용 중인 Library Resource는 삭제할 수 없다. 먼저 해당 서버에서 Library Resource를 제거한 후 삭제해야 한다.

6.6.5. Library Resources Import

등록된 Library Resource를 서버에 Import하여 사용할 수 있다.

Library Resources 상세 화면에서 Import 하기

Library Resources 관리 화면에서 특정 Resource를 선택하여 상세 정보 화면으로 이동한다.
Edit Server List 버튼 을 클릭하면 서버를 등록 관리할 수 있는 창이 출력된다.
해당 Library Resource를 Import할 서버를 지정해 우측 영역으로 이동시킨다.
Save 버튼 을 클릭하면 해당 서버에 Library Resource가 Import 된다.

개별 서버에서 Library Resources Import 하기

LENA Manager 상단의 Servers 메뉴를 선택한다.
좌측에서 개별 Web Application Server > Resources 탭을 클릭한다.
Import 버튼 을 클릭하면 팝업 창에 미리 정의된 Library Resources 목록이 조회된다.
Import 하고자 하는 Library Resource를 선택한다.
OK 버튼 을 클릭하여 해당 Resource를 Import 한다.

Import된 Library Resource는 서버의 classpath에 자동으로 등록된다. 서버 재기동 후 해당 라이브러리를 사용할 수 있다.

Library Resource Import 후 삭제 시, 서버의 classpath에서는 자동으로 제거되지 않을 수 있다. 필요한 경우 서버의 classpath 설정을 수동으로 확인해야 한다.

7. Diagnostics

7.1. Monitoring Dashboard

7.1.1. 현황 요약

Monitoring Dashboard 화면은 하단에 3개의 탭을 제공하고 있고 선택된 탭에 따라 상단에 제공되는 요약정보가 변경된다.

탭 별로 제공되는 정보는 다음과 같다.

Node 탭: 등록된 Node별 Server 모니터링 정보 제공
Server Cluster 탭: Server Cluster 그룹별로 등록된 Server 모니터링 정보 제공
Service Cluster 탭: Service Cluster 그룹별로 등록된 Container 모니터링 정보 제공

각 정보의 조회 주기를 설정할 수 있으며, WAS의 경우 Function 컬럼에 있는 팝업 버튼 을 클릭하면 상세 모니터링 화면으로 이동할 수 있다.

Monitoring Dashboard 화면은 다음과 같다.

Figure 20. Monitoring Dashboard의 Node 탭 화면(1/2)

Figure 21. Monitoring Dashboard의 Node 탭 화면(2/2)

Figure 22. Monitoring Dashboard의 Server Cluster 탭 화면

Figure 23. Monitoring Dashboard의 Service Cluster 탭 화면

Service Cluster 탭은 Container Edition에서 제공되는 기능이다.

Monitoring Dashboard 화면에서 사용된 속성들은 아래와 같다. 사용률 형태로 제공하는 정보의 색상은 Status Range 속성을 이용해 변경할 수 있다. (이 장의 하위 절인 모니터링 기본 설정 참고)

Table 128. Node 상태
항목	설명	비고
CPU	Node의CPU 사용률	Default 설정값은 60% 미만일 경우 Low, 80% 이상일 경우 High이다.
Memory	Node의 Memory 사용률	Default 설정값은 60% 미만일 경우 Low, 80% 이상일 경우 High이다.
Disk	Node의 Disk 사용률	Engine이 설치된 Disk 사용률로써 Default 설정값은 60% 미만일 경우 Low, 80% 이상일 경우 High이다.

Table 129. Application Server 상태
항목	설명	비고
Status	Server 기동여부, 진단결과발행여부(구급차 아이콘) 및 자동대응수행여부(방패 아이콘)	Unknown 상태는 Node Agent를 통해 서버의 상태를 가져올 수 없는 경우에 표시됨
Server Name	Server 이름
Heap Memory	Application Server에서 사용되는 Heap Memory 사용률
Thread Pool	Application Server가 Pool로 관리하는 Request Thread 사용률을 Connector(Ajp, Http) 별로 표시
DataSource	Application Server가 Pool로 관리하는 Datasource Connection 사용률
Session Clustering	Application Server에 설정된 Session Server의 정보 및 기동여부	붉은색은 정지상태, 초록색은 기동상태, 검은색은 시스템외부에 존재하는 서버를 의미

Table 130. Web Server 상태
항목	설명	비고
Status	Server 기동여부	Unknown 상태는 Node Agent를 통해 서버의 상태를 가져올 수 없는 경우에 표시됨
Server Name	Server 이름
CPU	Web Server 프로세스의 CPU 사용률
Memory	Web Server 프로세스의 Memory 사용률
Thread	Web Server의 Thread 수 (Active / Max)
Connected WAS	Web Server와 연결된 WAS 정보 및 기동여부	붉은색은 정지상태, 초록색은 기동상태, 검은색은 시스템외부에 존재하는 서버를 의미

Table 131. Session Server 상태
항목	설명	비고
Status	Server 기동여부	Unknown 상태는 Node Agent를 통해 서버의 상태를 가져올 수 없는 경우에 표시됨
Server Name	Server 이름
Heap	Session Server에서 사용되는 Heap Memory 사용률
Session Count	Active 상태인 Session 비율
Mirror Server	Mirror Server의 정보 및 기동여부	붉은색은 정지상태, 초록색은 기동상태, 검은색은 시스템외부에 존재하는 서버를 의미

Table 132. Memory Cache Server 상태
항목	설명	비고
Status	Server 기동여부, 진단결과발행여부(구급차 아이콘) 및 자동대응수행여부(방패 아이콘)	Unknown 상태는 Node Agent를 통해 서버의 상태를 가져올 수 없는 경우에 표시됨
Server Name	Server 이름
CPU	Server에서 사용되는 CPU 사용률
Memory	Server에서 사용되는 Memory 사용률
Connection	Client에서 접속 중인 Connection 수
Replicas	해당 서버에 연결한 replicas

각 서버를 즉시 제어할 수 있는 기능을 다음과 같이 함께 제공된다.

Table 133. Application Server 제어 기능
항목	설명	비고
Thread Dump	Thread Dump 생성	왼쪽 버튼(Server Snapshot(dump)) > Dump List 메뉴 선택 > Dump 파일 다운로드 가능
Active Service Dump	Active Service Dump 생성	왼쪽 버튼(Server Snapshot(dump)) > Dump List 메뉴 선택 > Dump 파일 다운로드 가능
Heap Dump	Heap Dump 생성	왼쪽 버튼(Server Snapshot(dump)) > Dump List 메뉴 선택 > Dump 파일 다운로드 가능
Forced Stop	서버 강제 종료	대기 시간 없이 즉시 강제 종료
Forced Restart	서버 강제 재시작	대기 시간 없이 즉시 강제 재시작
All Diagnostics Disable	해당 서버에 적용된 진단/대응 기능을 모두 Disable 처리

Figure 24. Dump 창

Heap Dump, Thread Dump, Active Service Dump를 생성하고 다운로드 할 수 있다. 일반적으로 Dump는 서버에서 Out Of Memory등의 오류, Thread Pool의 과다 사용, 서비스 지연 등이 발생한 경우 원인 파악을 위해 생성한다.

생성하려는 Dump 타입에 따라 Thread Dump 버튼 , Active Service Dump 버튼 , Heap Dump 버튼 을 클릭해 Dump를 생성한다. 생성된 Dump는 Web Application Server가 존재하는 Host내 저장되는데, Thread Dump는 {log_home}/logs/tdump, Active Service Dump는 {log_home}/logs/sdump, HeapDump 파일은 Dump파일은 {log_home}/logs/hdump 경로에 저장된다.

Delete 버튼 을 클릭하여 Dump 파일을 삭제할 수 있다. Download 버튼 을 클릭해 Dump 파일을 다운로드 할 수 있으며, 다운 로드 시 해당 Dump 파일이 시스템 현황 Dump 파일과 함께 zip 형태로 다운로드 된다.

Dump 관리 화면의 항목은 다음과 같다.

Table 134. Dump 화면 항목
항목	설명	비고
File Name	생성된 파일 이름	날짜를 포함한 문자열로 자동 생성된다
Size	생성된 파일의 사이즈
Status	Dump 수행 시점의 System 및 Server의 상태	Dump 생성 시점의 시스템의 CPU, Memory 정보 및 Web Application Server의 주요 리소스 사용량 정보도 Dump 생성 시 함께 생성한다. View 버튼 을 클릭하여 생성된 Status 값을 확인할 수 있다

Table 135. Web Server제어 기능
항목	설명	비고
Forced Stop	서버 강제 종료	대기 시간 없이 즉시 강제 종료
Graceful Stop	서버 Graceful 종료

Monitoring 정보가 표시되지 않는다면 등록된 Node/Server가 실제로 존재하는지, Node/Server와 통신이 잘 되는 상태인지 체크한다.

Table 136. Memory Cache Server 제어 기능
항목	설명	비고
Start	서버 시작
Stop	서버 종료

7.1.2. 현황 모니터링 상세

Monitoring Dashboard에서 Function 컬럼에 있는 가운데 버튼(View Detail Chart) 을 선택하면 상세한 Thread, Memory, 서비스 정보를 모니터링할 수 있다.

System 창

Web Application Server의 Memory, Thread, Service 정보를 확인할 수 있다.

Figure 25. System 탭

Memory Chart

실시간 Memory 사용량 정보가 표시된다. 제공하는 정보로는 GC Time(Garbage Collection 소요 시간), GC Count, Heap Used(Total Memory - Free Memory), Total Memory(서버에서 사용중인 총 메모리)가 있다. 차트의 붉은 점선은 사용 가능한 최대 Heap Memory를 의미한다. 따라서 차트에서 Heap Memory 사용량이 일반적인 GC패턴이 아닌 긴 시간동안 연속적으로 붉은 점선에 근접할 경우 유의해야 한다.

Request Thread의 최대값은 Server 메뉴에서 해당 Web Application Server의 maxThreads 속성을 통해 변경할 수 있다.

Thread Chart

Web Application Server가 사용자의 요청을 처리하기 위해 Pool 로 관리하고 있는 Request Thread 사용 현황을 볼 수 있는 Line Chart이다. 차트의 붉은 점선은 사용할 수 있는 Request Thread의 최대치를 의미한다. 때문에 차트에서 Request Thread 수가 붉은 점선에 근접할 경우 유의해야 한다.

Request Thread의 최대값은 Server 메뉴에서 해당 Web Application Server의 maxThreads 속성을 통해 변경할 수 있다.

Thread List

Web Application Server의 모든 Thread를 확인할 수 있다. 출력된 Thread 이름이나 Thread 상태를 기준으로 필터링 할 수 있다. Thread List의 항목은 아래와 같다.

Table 137. Thread List 항목
항목	설명	비고
Thread ID	고유 Thread ID
Name	Thread 이름
Stat	Thread 상태	총 세 가지의 상태가 존재함 RUNNABLE: 가용 Thread WAITING: 다른Thread의 특정 Action 을 수행하기 위해 대기 중인 Thread TIMED_WAITING: 명시된 대기시간이 있는 Thread
CPU	지정된 Thread에 대한 CPU 사용시간
Elapsed	Thread가 수행되는데 걸린 시간
Service Name	Thread가 수행한 서비스 이름

+ 버튼 을 눌러 다음과 같은 상세 정보를 확인할 수 있다.

Table 138. Thread 상세 정보 항목
항목	설명	비고
threadId	고유 Thread ID
threadName	Thread 이름
state	Thread 상태	총 세 가지의 상태가 존재함 RUNNABLE: 가용 Thread WAITING: 다른Thread의 특정 Action 을 수행하기 위해 대기 중인 Thread TIMED_WAITING: 명시된 대기시간이 있는 Thread
threadCpuTime	현재 Thread를 포함한 모든 Thread의 CPU 시간
threadUserTime	현재 Thread의 CPU 시간
blockedCount	Block된 합계
blockedTime	Block된 누적 경과시간
waitedCount	대기한 Thread의 합계
waitedTime	대기한 Thread의 누적 경과시간
lockOwnerId	lock된 Object를 소유한 Thread의 ID
lockName	lock된 Object이름
lockOwnerName	lock된 Object를 소유한 Thread의 이름
stackTrace	stackTrace

Active Service List

서비스 정보 및 해당 서비스를 처리하고 있는 Thread 정보를 확인할 수 있다. 해당 정보 내 항목은 Thread List 항목과 유사하며, 다음과 같은 추가 항목이 존재한다.

Table 139. Active Service List 항목
항목	설명	비고
Sql	현재 수행 중인 SQL문

DataSource 창

Application Server에 설정된 DataSource 정보를 확인할 수 있다.

Figure 26. DataSource 탭 화면

DataSource Chart

Active Connection 수와 Idle Connection 수가 Chart에 실시간으로 표시된다. 차트의 붉은 점선은 설정된 최대 Connection 수를 의미한다. Active Connections가 붉은 점선에 근접할 경우 유의해야 한다. 콤보박스에서 DataSource를 선택하여 다른 DataSource를 모니터링 할 수 있다.

최대 Connection 수는 DataSource 정보 등록화면의 maxConnection 속성을 통해 변경할 수 있다.

DataSource Information

지정한 Datasource의 설정 정보를 확인할 수 있다.

7.1.3. Memory Cache Server

Monitoring Dashboard에서 Function 컬럼에 있는 왼쪽 버튼(System) 을 선택하면 상세한 서비스 정보를 모니터링할 수 있다.

System 창

Memory Cache Server의 Memory, CPU, Service 정보를 확인할 수 있다.

CPU Chart

Memory Cache Server가 사용하는 CPU 사용률을 시계열로 확인 가능하다.

Command Processing

Memory Cache Server가 실시간으로 처리하고 있는 명령어들의 CPU 사용률을 모니터링 할 수 있다.

Memory Chart

Memory Cache Server가 사용하는 Memory 사용률을 시계열로 확인 가능하다. 메모리 관련해 모니터링 가능한 항목은 운영 중 최대 사용 메모리(Peak Memory), 사용 가능 최대 메모리(Max Memory), 현재 사용중인 메모리, 현재 사용중인 물리 메모리(RSS Memory), 사용 메모리 대비 실제 물리 메모리 사용률(RSS Ratio)이 있다.

Network Input/Output

Memory Cache Server에 실시간으로 들어오고 나가는 Network 패킷 사이즈를 모니터링 할 수 있다.

Hit Ratio

Client에서 요청한 데이터 조회 명령어 성공률을 보여준다.

Key

Memory Cache Server의 DB별 전체 Key개수를 확인할 수 있으며, 키 퇴출된 숫자와 마지막으로 퇴출된 시간을 확인할 수 있다.

Connected Client

Client에서 접속중인 Connection을 시계열로 확인 가능하며, 동시 접속 가능한 최대 Connection수와 Connection이 Reject된 수도 모니터링 가능하다.

Connected Client List

Retrieve버튼을 눌러 실시간 접속중인 Client의 목록, 마지막 성공한 명령어, 소요시간, Idle시간 등을 알 수 있다.

Slog Log

사전 정의한 시간을 초과하여 실행한 명령어를 볼 수 있다.

7.1.4. 모니터링 설정

DIAGNOSTICS > Policy > Common Rule Setting 메뉴에서 모니터링 기본 설정을 할 수 있다. 설정 항목은 다음과 같다.

Table 140. 모니터링 관련 기본 설정 항목
항목	설명	기본값
Status Range	Monitoring Dashboard 에서 Resource의 Low, Middle, High 기준을 설정한다.	60% 미만일 경우 Low, 60% 이상일 경우 Middle, 80% 이상일 경우 High를 의미한다
Diagnostics Interval	진단 주기를 설정한다.	10000(ms)
Dump Limit	각 서버의 Dump(Thread/ActiveService/Heap) 디렉토리 별 Dump 개수 제한(0은 무제한을 의미)	200(개)

7.2. Analysis Dashboard

Analysis Dashboard에서 시스템 단위로 실시간 장애 분석 현황 정보를 제공한다. 제공하는 정보 제공 유형은 아래와 같다.

Performance Map
Analysis Summary
Instance Map

Figure 27. Analysis Dashboard

7.2.1. Performance Map

Analysis Dashboard의 좌측 상단에 보이는 Performance Map은 "Thread & Elapsed", "Thread", "Elapsed" 기준으로 시스템의 상태 정보를 각각 제공한다. 각 시스템은 Chart상에서 색깔을 가진 원으로 표시된다. 시스템의 상태 별 색상은 다음과 같다.

Normal: 녹색
Anomaly: 주황색(진단 결과로 Anomaly 상황이 검출됨)
Fault: 붉은색(진단 결과로 Fault 상황이 검출됨)

Chart에서 X축과 Y축의 의미는 다음과 같다.

Table 141. Performance Map Chart의 X, Y축 의미
항목	설명	비고
Thread & Elapsed Chart	X축: 시스템 내 Web Application Server의 평균 Thread 사용률 Y 축: 시스템 내 Web Application Server에서 수행되는 서비스의 평균 응답시간
Thread Chart	X축: 10분 동안의 Time Line Y 축: 시스템 내 Web Application Server의 평균 Thread 사용률
Elapsed Chart	X축: 10분 동안의 Time Line Y 축: 시스템 내 Web Application Server에서 수행되는 서비스의 평균 응답시간

Chart 상단에 표시되는 System 상태 요약 정보는 다음과 같다.

Table 142. System 상태 요약 정보 항목
항목	설명	비고
Normal	정상 System의 수
Slow	응답 시간이 오래 걸리는 System의 수
Heavy	Thread pool사용량이 많은 System의 수
Slow & Heavy	Slow하고 Heavy한 System의 수

Chart 하단의 슬라이드 바를 조작해 이전 상태 정보를 볼 수 있으며, 이전 10분 아이콘, 다음 10분 아이콘, 일시 정지 아이콘, 재생 아이콘, 현재 시간 이동 아이콘 을 클릭해 시간을 이동할 수 있다. Dashboard에 처음 진입하면 전체 시스템이 표시되며, Chart 내에서 표시되는 시스템이나 범례를 클릭해서 특정 시스템만 선택해 볼 수 있다. 다시 전체 시스템 전체를 보려면 우측 상단의 All System 아이콘 을 클릭한다.

시스템 아이콘 위에서 마우스 우클릭을 하면 다음과 같은 기능을 수행할 수 있다.

Table 143. 시스템 아이콘에서 우클릭 시 사용 가능한 기능
항목	설명	비고
Topology View	Topology View 화면으로 이동
Service Analysis	System Detail 팝업 창 표시
Monitoring	Monitoring Dashboard 화면으로 이동
Statistics	Statistics 화면으로 이동

시스템 우클릭 기능 중에 Service Analysis 클릭 시 표시되는 팝업 창은 다음과 같다. Web Server, WAS, Session Server의 현재 상태가 좌측에 표시된다. 우측에는 Transaction Heat Map Chart를 볼 수 있으며, 영역을 드래그 하면 상세 정보를 확인할 수 있다.

Figure 28. System Detail 화면

Transaction 정보는 LENA Dashboard에서 Service Trace 기능을 통해 수집했던 경우에만 남는다.

다음은 Transaction Heat Map Chart내의 원하는 영역을 드래그 한 후 표시되는 Transaction 목록에서 특정 Transaction을 선택했을 때 볼 수 있는 상세 정보 화면이다.

Figure 29. Transaction 상세 정보 화면

상세 정보는 CLIENT(사용자 브라우저 관련), WEB(LENA Web Server 관련), WAS(LENA Web Application Server 관련) 측면의 데이터로 구성된다. 각 유형 별 정보에서 볼 수 있는 항목은 다음과 같다.

Table 144. CLIENT 관련 데이터의 항목
항목	설명	비고
domain lookup time	브라우저가 서버와 접속하기 위한 domain lookup 시간
connection time	브라우저가 서버와 connection 을 맺는 시간
server response time	브라우저가 서버에 요청을 하고 응답을 받은 전체 시간
rendering time	브라우저의 화면 rendering 시간
total complete time	브라우저에서 처리되는 전체 시간
error resource(line)	스크립트 에러 발생 시, 에러가 발생한 라인
error content	스크립트 에러 발생 시, 발생한 에러 내용

Table 145. WEB 관련 데이터의 항목
항목	설명	비고
elapsed time	WEB에서 처리 수행 시간

WAS 관련 데이터의 항목

기본 정보

Table 146. 기본정보
항목	설명	비고
objName	요청을 처리한 서버 명
endtime	요청 처리 완료 시간
elapsed	요청 처리 수행 시간
service	요청 서비스 명
ipaddr	호출한 아이피 정보
cpu	CPU 사용 시간
sqlCount	수행된 쿼리 수
sqlTime	쿼리 수행 시간

프로파일 정보

Table 147. 프로파일 정보
항목	설명	비고
#	프로파일 단계 순서를 나타내는 인덱스
p#	내부 단계인 경우 자신이 속한 부모 인덱스
TIME	해당 단계가 시작된 시간
T-GAP	현재 단계의 시작 시간과 이전 단계의 시작 시간의 차이
CPU	CPU 사용 시간
CONTENTS	각 단계의 내용

CLIENT 와 WEB 관련 정보는 E2E 기능이 ON되어 있어야 수집된다. 부하량을 최소화 하기 위해 기본적으로 OFF되어 있다.

프로파일 정보는 WAS에서 프로파일 설정이 ON되어 있어야 수집된다. 부하량을 최소화 하기 위해 기본적으로 OFF되어 있다.

7.2.2. Analysis Summary

현재 검출된 진단 결과 건수, 오늘 발생한 전체 진단 결과 건수, 지난 날(Default: 1일 전) 발생한 진단 결과 건수의 요약 정보를 보여준다.

Table 148. 분석 요약 정보 항목
항목	설명	비고
Anomaly	Fault 상태는 아니지만 주의 깊게 봐야 하는 진단 결과 건수
Fault	Fault 상태로 진단된 결과 건수

Recent Events는 가장 최근에 발생한 진단 결과를 보여주며, 해당 항목을 클릭하면 Report 정보를 확인할 수 있다.

7.2.3. Instance Map

Performance Map에서 특정 시스템을 선택하면, 화면 하단에서 시스템 내 서버 정보 및 진단 결과를 보여주는 Time Line Chart를 볼 수 있다. 서버는 상태에 따라 다른 색으로 표시되며, 특정 서버를 토글 해 우측 Time Line Chart에서 보이거나 안보이게 할 수 있다. 진단 후 Anomaly나 Fault 상황이 검출되면 Time Line에 주황색(Anomaly 상황)이나 붉은색(Fault)으로 표시되는데, 해당 영역을 더블 클릭하면 Report를 확인할 수 있다.

7.3. Event Dashboard

Event Dashboard를 통해 WAS에서 발생한 이벤트 현황 정보를 제공한다.

이벤트 정보는 WAS에서 생성되어 UDP로 Manager에 전달된다. WAS가 전송한 이벤트 정보는 Manager의 DB에 일정 기간(3달) 동안 보관되며, 해당 이벤트의 상세 SQL 및 Exception Trace 정보는 데이터 크기가 크므로 7일간만 보관된다.

7.3.1. Event 종류

다음과 같이 4가지 종류의 이벤트가 존재한다.

WAS의 Out Of Memory Error 발생 이벤트
WAS의 Full GC 발생 이벤트
WAS의 Stuck Thread 발생 이벤트
WAS의 Exception 발생 이벤트

WAS Exception 이벤트는 아래 두 가지 상황에서 생성되어 Manager로 전송된다.

사용자 요청에 대해 Servlet의 service 메서드 바깥까지 Exception 이 Throw 되는 경우
사용자가 설정한 타입의 Exception이 발생한 경우

7.3.2. Event Dashboard를 통한 Event 관리

LENA Manager 의 Event Dashboard에서 수집된 Event를 관리할 수 있다.

Figure 30. Event Dashboard

이벤트 발생 추세를 일자 별 바 차트로 확인할 수 있다. 모든 System 대상으로 볼 수 있으며 특정 System이나 Server 등을 지정해 조회할 수 있다. 달력 버튼 을 클릭해 날자를 변경할 수 있다.

이벤트 목록의 항목은 다음과 같다.

Table 149. Event List 항목
항목	설명	비고
Event Level	이벤트 수준	다음 유형이 존재함. 4가지 이벤트는 기본적으로 WARNING이며 변경할 수 있음. INFO WARNING(DEFAULT) ERROR CRITICAL
Event Type	이벤트 유형	다음 유형이 존재함 OUT-OF-MEMORY FULL-GC STUCK-THREAD ERROR
Target Name	대상 서버 이름	WAS 이름 또는 Service Cluster 이름
System Name	시스템 이름
Message	이벤트 메시지	Error 이벤트는 발생한 Exception 명을, Stuck Thread 이벤트는 Stuck Thread가 발생했음을 알리는 메시지를 남김
Event Date	이벤트 발생 시각
( 삭제 버튼 )	이벤트 삭제 시 선택하는 버튼

개별 이벤트 행을 클릭하면 아래와 같은 Event 상세 정보를 확인할 수 있다.

Figure 31. Event 상세 정보 화면

Event 상세 정보의 공통 항목은 다음과 같다.

Table 150. Event 상세 정보의 공통 항목(Event Common Info)
항목	설명	비고
Event Level	이벤트 수준	다음 유형이 존재함. WARNING INFO ERROR CRITICAL
Event Type	이벤트 유형	다음 유형이 존재함 OUT-OF-MEMORY FULL-GC STUCK-THREAD ERROR
Target Name	대상 서버 이름	WAS 이름 또는 Service Cluster 이름
Target Type	대상 서버 유형	다음 유형이 존재함 WAS SERVICE-CLUSTER
System Name	시스템 이름
Event Date	이벤트 발생 시각

Event 별로 서로 다른 상세 정보 항목은 다음과 같다.

Table 151. Out Of Memory 이벤트 상세 정보 항목(Event Detail Info)
항목	설명	비고
Heap Dump File Name	Out Of Memory Error 발생 시 자동 생성된 Heap Dump 파일 이름

Table 152. Full GC 이벤트 상세 정보 항목(Event Detail Info)
항목	설명	비고
Full GC Start Time	Full GC 시작 시각
Full GC End Time	Full GC 종료 시각
Previous Full GC Start Time	바로 직전 Full GC 시작 시각
Previous Full GC End Time	바로 직전 Full GC 종료 시각
Memory Usage Before Full GC (MB)	Full GC 수행 전 메모리 사용량
Memory Usage After Full GC (MB)	Full GC 수행 후 메모리 사용량

Table 153. Stuck Thread 이벤트 상세 정보 항목(Event Detail Info)
항목	설명	비고
Service	서비스 URL
Http Query	서비스 URL의 get 파라미터	post 데이터는 보이지 않음 get 파라미터 키는 표시되지만 값은 Masking 처리되어 표시됨
Threshold(ms)	LenaStuckThreadDetectionValve에 설정한 임계값
Active Time(ms)	Stuck Thread 감지 시점의 해당 서비스 처리 시간
Stack Trace	Stuck Thread 감지 시점의 Stack Trace

Table 154. Error 이벤트 상세 정보 항목(Event Detail Info)
항목	설명	비고
Service	서비스 URL
Http Query	서비스 URL의 get 파라미터	post 데이터는 보이지 않음 get 파라미터 키는 표시되지만 값은 Masking 처리되어 표시됨
Remote Addr	Client 리모트 주소
Custom Info	사용자 정의 코드 정보	사용자가 커스텀 Servlet Filter를 사용해 지정한 Key, Value
Exception Trace	발생한 Exception의 Trace

7.4. 통계

7.4.1. 연간 진단/대응 통계

DIAGNOSTICS > Analysis > Diagnostics Trend 메뉴에서 서버 별 연간 진단 결과를 차트를 통해 제공한다.

Figure 32. Statistics 화면

위 화면에서 다음과 같은 내용을 확인할 수 있다.

Diagnostics Calendar
- 한 칸이 하루를 의미하며, 연간 통계 차트의 일자에 Mouse Over를 하면 해당 일자에 발생한 진단 횟수를 확인할 수 있다.
Daily Diagnostics Detail
- Diagnostics Calendar에서 특정 일자를 클릭하면, 화면 하단에 선택한 일자의 시간대 별 진단 발생 그래프가 표시 된다.

7.4.2. 리포트

진단 및 대응 기능이 수행되면 Report가 자동으로 생성된다. Report는 7일간 보관되며 오래된 Report는 자동으로 삭제된다.

진단/대응 리포트 목록

DAIGNOSTICS > Analysis > Diagnostics Trend 화면에서 특정 서버를 선택한 후, Report List 버튼 을 클릭하면 진단/대응 리포트 목록 화면을 볼 수 있다. 진단/대응 리포트 목록 화면은 아래와 같다.

Figure 33. 진단/대응 리포트 목록 화면

View 버튼 을 선택하여 Report를 확인할 수 있다.

리포트 공통 정보

Report의 내용은 진단 결과에 따라 다르게 표시되지만, 다음과 같은 공통 정보를 가진다.

Figure 34. 진단/대응 리포트 화면

위와 같이 이상 현상이 지속된 기간 내에 검출된 진단 결과간의 인과 관계를 도식화해 제공하며, 화면 하단에는 각 진단 결과가 어느 시간대에 생성됐는지 보여준다.

Anomaly 상황은 진단/대응 Rule에 설정한 설정 내용의 일부만 충족된 상황을 의미하며 주황색으로 표시되고, Fault 상황은 진단/대응 Rule에 설정한 설정 내용의 모두를 만족한 상황을 의미하며 붉은색으로 표시된다.

리포트 상세 정보

Report 하단의 Time Line에서, 특정 시간대의 특정 진단 유형을 클릭하면 다음과 같이 상세 정보를 확인할 수 있다.

Figure 35. 진단/대응 리포트 상세 정보

Report 상세 정보의 항목은 다음과 같다.

Table 155. Report 상세 정보 항목
항목	설명	비고
Root Cause	원인이 되는 진단 항목	해당 진단 결과를 야기한 원인이 되는 진단 항목을 의미하며, 만약 해당 진단 결과의 원인이 되는 다른 진단 항목이 존재한다면 다른 진단 항목이 표시됨
Analysis Rule	진단/대응 Rule에 설정된 임계
Fault Analysis Raw Data	진단 근거가 되는 Back Data
Pre-Action for Fault Tolerance	수행된 Action 및 Dump 파일 명
Recommended Solution	조치 가능한 해결책

진단/대응 유형 별 Back Data 항목은 다음과 같다.

Request Full 진단 Report의 Back Data는, 가장 많이 호출된 5개의 서비스 정보이다.

Table 156. Request Full 진단 Report의 Back Data 항목
항목	설명	비고
Service Name	서비스 이름
Requested Count	해당 서비스 요청 수
Avg. Elapsed Time	해당 서비스 평균 응답 시간
Max Elapsed Time	해당 서비스 중에서 가장 오래 수행된 서비스의 응답 시간
Min Elapsed Time	해당 서비스 중에서 가장 짧게 수행된 서비스의 응답 시간

대량 DB Data 요청 진단 Report의 Back Data는, 대량 DB Data 요청을 가장 많이 한 5개의 서비스 정보이다.

Table 157. 대량 DB Data 요청 진단 Report의 Back Data 항목
항목	설명	비고
Service Name	서비스 이름
Count	해당 서비스 요청 수
Blocked Count	Block된 DB 데이터 조회 건수

DB Conn Full 진단 Report의 Back Data는, 과다 점유된 DataSource Connection Pool 정보이다.

Table 158. DB Conn Full 진단 Report의 Back Data 항목
항목	설명	비고
DataSource Name	DataSource 이름
DB Connection Pool Usage Rate	DB Connection Pool 사용률

Long Transaction 진단 Report의 Back Data는, 진단 대상 서비스 중에서 가장 오래 걸린 5개의 서비스이다.

Table 159. Long Transaction 진단 Report의 Back Data 항목
항목	설명	비고
Service Name	서비스 이름
Requested Count	해당 서비스 요청 수
Avg. Elapsed Time	해당 서비스 평균 응답 시간
Max Elapsed Time	해당 서비스 중에서 가장 오래 수행된 서비스의 응답 시간
Min Elapsed Time	해당 서비스 중에서 가장 짧게 수행된 서비스의 응답 시간

Peak Control 진단 Report의 Back Data는, 진단 대상 서비스 중에서 가장 오래 걸린 5개의 서비스이다.

Table 160. Peak Control 진단 Report의 Back Data 항목
항목	설명	비고
Service Name	서비스 이름
Requested Count	해당 서비스 요청 수
Avg. Elapsed Time	해당 서비스 평균 응답 시간
Max Elapsed Time	해당 서비스 중에서 가장 오래 수행된 서비스의 응답 시간
Min Elapsed Time	해당 서비스 중에서 가장 짧게 수행된 서비스의 응답 시간

OOM 진단 Report의 Back Data는, OOM 발생 여부 및 메모리 사용 정보이다.

Table 161. OOM 진단 Report의 Back Data 항목
항목	설명	비고
OOM Occurred	OOM 발생 여부
Heap Usage Rate	Heap Memory 사용률
Full GC Count	Full GC 발생 횟수
Memory Leak	Memory Leak 발생 여부
Heap Dump	Heap Dump가 생성된 경우 파일 이름

Hang 진단 Report의 Back Data는, 서버 상태 및 시스템 리소스 정보이다.

Table 162. Hang 진단 Report의 Back Data 항목
항목	설명	비고
Node CPU Rate	Node Agent가 측정한 시스템의 CPU 사용률
Node Memory Rate	Node Agent가 측정한 시스템의 Memory 사용률
Process CPU Rate	서버의 CPU 사용률
Full GC Count	서버의 Full GC 횟수

7.4.3. 알림

진단/대응을 통해 Report가 생성되면, 다음과 같이 LENA Manager 우측 상단의 종 아이콘 을 통해 확인 가능하다.

Figure 36. 진단/대응 결과 알림

알림 내용을 선택하면 생성된 Report를 바로 확인할 수 있으며, 알림 내용을 확인하고 더 이상 표시하지 않기를 원한다면 x 버튼 을 클릭한다. 알림이 많은 경우 Manager 우측 상단의 종 아이콘 을 선택한 후 Notifications 화면에서 일괄적으로 확인을 할 수 있다.

Figure 37. 진단/대응 결과 알림 목록 일괄 확인

Home 아이콘 을 클릭하면 선택한 알림에 대한 진단 이력 화면으로 이동한다. V 아이콘 을 클릭하는 것은 선택한 알림을 확인했다는 것을 의미하며, 이렇게 클릭한 알림은 Manager 우측 상단의 종 아이콘 에 더이상 표시되지 않는다.

Notifications 화면에서는 1개월 이내의 지난 알림에 대한 이력을 확인할 수 있다. 1개월이 지난 데이터는 자동으로 삭제된다.

7.4.4. Thread Dump Analysis

LENA Manager를 통해 생성된 Thread Dump를 분석하여 사용자가 이해하기 쉽게 보여준다.

사전 준비 사항으로 Server 혹은 Service-Cluster 내 Thread Dump 파일이 필요하다.

Report 생성

Figure 38. Thread Dump Analysis 초기 화면

LENA Manager의 상단 'DIAGNOSTICS' 메뉴를 선택하고 좌측 Analysis 내 Thread Dump Analysis를 클릭한다.

Figure 39. 분석할 Thread Dump를 선택해 Report를 생성하는 모달 창

Create Report 버튼을 눌러 모달 창을 확인한다.

Figure 40. Thread Dump 파일을 분석해 Report 생성에 성공한 화면

System Name, Target Type, Target Name을 순서 대로 선택하고 Search 버튼을 눌러 해당 Thread Dump 파일 목록을 확인한다.
분석할 Thread Dump 파일을 선택하고 Analyze 버튼을 눌러 Report를 생성한다.
생성한 Report의 경로는 아래와 같다.

(LENA-Manager 설치 경로)/repository/monitoringDB/report

(분석을 위해 3~5개의 Thread Dump 파일을 선택해야 한다.)

Overview

Figure 41. 분석한 Report 파일을 보여주는 화면

Thread Change Thrend
Thread Dump 파일 별 Thread의 상태(State) 변화 추이를 그래프로 확인할 수 있고 구체적인 개수를 테이블로 확인할 수 있다.
Unchanged Thread State
분석한 모든 Thread Dump 파일 내 상태가 변하지 않는 Thread의 개수를 파악하고 'More' 버튼을 클릭해 자세한 정보를 확인할 수 있다.

Figure 42. 각 상태 별 Thread의 정보

Dump Detail

Figure 43. 분석한 Dump 파일 별 Thread 정보를 보여주는 화면

Thread Dump List
분석한 Thread Dump 목록
Summary
해당 Thread Dump의 Thread 상태 분포도
Thread Group
Rule 파일에 정의한 workerThread로 그룹핑한 Thread의 개수
- Rule 파일 경로 : (LENA-Manager 설치 경로)/repository/conf/diagnostics/basic-parser.json
Thread State
해당 Thread Dump의 Thread 상태 개수, 'More' 버튼을 클릭해 자세한 정보를 확인할 수 있다.

Figure 44. 선택한 Thread Dump 파일 내 상태 별 Thread 정보

7.4.5. 진단 Pipeline

LENA Manager를 통해 생성된 Thread Dump를 자동으로 분석해 Thread Dump Analysis Report를 생성하고 알람을 통해 사용자에게 이상 현상을 신속하게 공유한다.

사전 준비 사항

Server Rule Setting 진단 룰 적용 (Thread Dump 생성을 위함)
manager.conf 내 설정 값 구성
- diagnostics.pipeline.enable=true (default: false)
- diagnostics.pipeline.dump.count=5 (default: 5, range: 3-5)
- diagnostics.pipeline.interval=300 (default: 300, sec)

동작 순서

서버 과부하로 Thread Dump 발생
Thread Dump Analysis Report 자동 생성 및 알림 생성
알림을 클릭해 Thread Dump Analysis 화면으로 이동
이상 현상 분석

Figure 45. Thread Dump Analysis Report 생성 알림

7.5. 진단 및 대응

진단 및 대응 기능을 사용하면, 장애 가능성을 사전에 진단하고 적절한 대응을 자동으로 수행하여 Server 안정성을 높일 수 있다.

진단 기능은 Rule기반으로 Server의 장애 가능성(또는 장애 상황)을 자동으로 판단하는 기능이다.
대응 기능은 진단 결과를 기반으로 적절한 Server 제어를 통해 장애 상황를 이겨내고 안정적인 서비스를 할 수 있도록 지원하는 기능이다.

진단 대상 유형은 다음과 같다.

Request Pool의 과다 사용(Reqeust Full)
- 과도한 서비스 요청으로 Server의 가용한 Request Thread가 모두 소진되면, 서비스 요청이 지연되거나 서비스 불가 상태에 빠질 수 있다. Request Thread 사용량 기반으로 과도한 서비스 요청 여부를 파악하고, 자동으로 해당 요청을 임시 페이지로 우회시켜 Server를 안정적인 상태로 유지한다.
대량 DB Data 요청(Bulk DB Data Request)
- 서비스가 대량 DB 데이터를 처리하는 경우, 메모리를 과도하게 사용하면서 OOM 현상, 잦은 Full GC에 의한 서버 Hang 현상 등이 발생할 수 있다. 서비스의 대량 DB 데이터 요청 여부를 파악하고, 해당 서비스를 강제로 종료시켜 Server를 안정적인 상태로 유지한다.
DB Connection Pool의 과다 사용(Db Conn Full)
- DB 처리 시간 지연, WAS-DB간 네트워크 지연, DB Lock 등에 의해 DB Connection이 과도하게 점유된 경우, 서비스는 가용 DB Connection을 할당 받을 때까지 지연된다. DB Connection 할당을 기다리는 서비스들이 누적되어 Request Thread Pool을 과도하게 점유하게 되면, 서비스 불능 상태까지 발생할 수 있다. 특정 DataSource의 DB Connection이 모두 소진된 경우, 할당 대기 시간을 짧게 줄이는 방법을 통해 장애를 격리함으로써 Server를 안정적인 상태로 유지한다.
수행 시간이 긴 서비스(Long Transaction)
- 일시적인 네트워크, 연계시스템 문제 등으로 서비스가 지연되거나 수행시간이 원래 긴 서비스가 존재하는 경우, 해당 서비스들이 Server의 가용한 Request Thread를 과도하게 점유하여 다른 서비스 수행에 지장을 줄 수 있다. 오래 걸리는 서비스들의 Request Thread 사용률을 제한하여 다른 서비스들의 QoS를 보장한다.
서버 동작 불능(Hang)
- Server가 동장 불능 상태인 Hang 상태가 되면 Server에서 수행되는 모든 작업이 중단되는 것은 물론 Server가 설치된 시스템 전체에 영향을 줄 수도 있다. Hang 상태가 검출되면 즉시 재기동해 Server의 장애 상황을 해소하고 시스템 전체 장애 발생을 방지한다.
Out of Memory 에러 발생(OOM)
- 서비스 로직의 오류 또는 과도한 Memory 사용에 의해 Out of Memory(OOM) 에러가 발생할 수 있다. OOM이 발생하면 Server의 정상적인 동작을 보장할 수 없으므로, OOM 발생 여부를 빠르게 파악하여 신속히 자동으로 재기동함으로써 Server 장애 상황을 극복한다.
사용자 폭주(Peak Control)
- Server의 처리 한계를 넘는 많은 사용자의 요청이 존재하는 경우, 서비스 지연 또는 불능 상태가 될 수 있다. 만약 사용자 요청이 특정 서비스에만 몰린다면 순서대로 진입하도록 요청을 제어하여 안정적인 서비스를 제공하면서도 사용자의 이탈을 막을 수 있다. 또한 다른 서비스 QoS도 보장할 수 있다.

7.5.1. 진단/대응 Rule 설정

DIAGNOSTICS > Policy > Diagnostics Rule Setting 메뉴에서 진단/대응 Rule을 설정할 수 있다.

Figure 46. Diagnostics Rule Setting 화면

진단/대응 유형 별로 Tab으로 구성되어 있으며, 기본적인 Default Rule 이 제공된다. New 버튼 을 클릭해 신규 Rule을 생성하거나, 기존의 Rule을 선택해 수정 및 삭제를 할 수 있다.

각 진단 항목별로 다음과 같이 두 개의 Default Rule이 제공된다.

진단 후 Report만 생성하는 Rule
진단 후 Report 및 Dump를 생성하는 Rule(Action은 Disable되어 제공됨)

진단 유형 별 Rule 설정 항목을 다음과 같다.

Table 163. Request Full 진단 Rule
항목	설명	기본값
Rule Name	Rule 이름
Request Pool(%)	Request Pool 사용률 임계	100
Report	Report 생성여부(항상 Enable)	Enable
Dump	이상으로 판단되면 생성할 Dump 유형 THREAD: Thread Dump SERVICE: Active Service Dump	Enable
Server Control	이상으로 판단되면 수행할 Action NONE: 수행 안함 FAKE-PAGE: 임시 페이지로 요청을 우회(우회 페이지 지정 가능)	NONE

Table 164. 대량 DB Data 요청 진단 Rule
항목	설명	기본값
Rule Name	Rule 이름
RS Count	서비스 내에서 요청한 DB Data 건수 임계	10000
Exceptional URI	진단에서 제외할 서비스 URI
Report	Report 생성여부(항상 Enable)	Enable
Dump	이상으로 판단되면 생성할 Dump 유형 THREAD: Thread Dump SERVICE: Active Service Dump	Enable
Server Control	이상으로 판단되면 수행할 Action NONE: 수행 안함 THROW-EXCEPTION: Exception을 발생시켜 서비스를 강제로 종료	NONE

Table 165. DB Conn Full 진단 Rule
항목	설명	기본값
Rule Name	Rule 이름
DB Connection Pool(%)	DB Connection Pool 사용량 임계	100
Report	Report 생성여부(항상 Enable)	Enable
Dump	이상으로 판단되면 생성할 Dump 유형 THREAD: Thread Dump SERVICE: Active Service Dump	Enable
Server Control	이상으로 판단되면 수행할 Action NONE: 수행 안함 DB-CONN-CONTROL: Datasource Connection 할당 대기 시간 동적 변경(대기 시간 설정 가능)	NONE

Table 166. Long Transaction 진단 Rule
항목	설명	기본값
Rule Name	Rule 이름
Elapsed Time(s)	진단 대상 서비스 수행 시간 임계	300
Service Allow Rate(%)	진단 대상 서비스에게 허용할 Request Thread 사용률 임계	50
Target URI	대상 서비스 URI
Report	Report 생성여부(항상 Enable)	Enable
Dump	이상으로 판단되면 생성할 Dump 유형 THREAD: Thread Dump SERVICE: Active Service Dump	Enable
Server Control	이상으로 판단되면 수행할 Action NONE: 수행 안함 SERVICE-CONTROL: 임시 페이지로 요청을 우회(우회 페이지 지정 가능)	NONE

Table 167. Hang 진단 Rule
항목	설명	기본값
Rule Name	Rule 명
Timeout(ms)	서버에 Health Check 시도 후, 응답 대기 시간 임계	3000(ms)
Retry Count	서버에 Health Check 실패 시, 재시도 횟수	3
FullGC Duration(s)	Full GC 횟수를 체크할 시간 간격	60
FullGC Count	Full GC 횟수	2
Report	Report 생성여부(항상 Enable)	Enable
Dump	이상으로 판단되면 생성할 Dump 유형 THREAD: Thread Dump	Enable
Server Control	이상으로 판단되면 수행할 Action NONE: 수행 안함 SHUTDOWN: 서버 종료 RESTART: 서버 재시작	NONE

Hang 진단 설정 항목간의 관계는 다음과 같다.

Fault 조건 : 서버 Hang에 의해 Health Check 시도 후 Timeout(s) 만큼 응답 없는 상황이 Retry Count 만큼 반복되면 Fault 상황으로 판단하여 Action을 수행함
Anomaly 조건 : FullGC Duration(s) 간격 내 FullGC Count 만큼 Full GC 발생 횟수가 많다면 Anomaly 상황으로 판단하여 Action 없이 Waning 리포트만 생성함

Table 168. OOM 진단 Rule
항목	설명	기본값
Rule Name	Rule 이름
OUT OF MEMORY	OOM 발생 여부(Fault 상황으로 판단함)	별도 설정 없이 발생 여부 검출
Memory Leak	Memory Leak 발생 여부(Anomaly 상황으로 판단함)	별도 설정 없이 발생 여부 검출
Report	Report 생성여부(항상 Enable)	Enable
Dump	이상으로 판단되면 생성할 Dump 유형 THREAD: Thread Dump SERVICE: Active Service Dump	Enable
Server Control	이상으로 판단되면 수행할 Action NONE: 수행 안함 SHUTDOWN: 서버 종료 RESTART: 서버 재시작	NONE

Table 169. Peak Control 진단 Rule
항목	설명	기본값
Rule Name	Rule 이름
Target URI	Peak Control 대상 서비스 URI
Service Allow Rate(%)	진단 대상 서비스에게 허용할 Request Thread 사용률 임계	50
Release Rate(%)	이상 상황 해제 조건이 되는 Request Thread 사용률 임계	10
Report	Report 생성여부(항상 Enable)	Enable
Dump	이상으로 판단되면 생성할 Dump 유형 THREAD: Thread Dump SERVICE: Active Service Dump	Enable
Server Control	이상으로 판단되면 수행할 Action NONE: 수행 안함 PEAK-CONTROL: 임시 페이지로 요청을 우회(우회 페이지 지정 가능)	NONE

7.5.2. Server Rule 설정

DIAGNOSTICS > Policy > Server Rule Setting 메뉴에서 진단/대응 Rule을 Server에 Mapping하고 Enable/Disable 할 수 있다.

최초에는 아무 진단 Rule도 Mapping되어 있지 않으므로, Enable/Disable 기능을 수행하기 전에 진단/대응 Rule을 먼저 Mapping해야 한다. 각 서버의 행을 클릭하여 다음과 같이 서버에 진단/대응 Rule을 Mapping 할 수 있다.

Figure 47. 진단 Rule Mapping 화면

진단/대응 Rule이 Mapping된 이후에는 다음과 같이 Server Rule Setting 화면에서 Rule을 Enable/Disable 할 수 있다.

Figure 48. Server Rule Setting 화면

Peak Control 진단 Rule만 DIAGNOSTICS > Policy > Peak Control Rule Setting 메뉴에서 설정한다.

7.6. Trace

Trace는 장애 진단을 위해 해당 Request가 LENA Server 간 이동 경로 및 시간을 기록해 원인을 진단 할 수 있게 해준다. LEAN 에서 제공하는 Trace유형은 아래와 같다.

Session Trace
Event Trace

DIAGNOSTICS > Trace 메뉴의 하위 메뉴를 통해 여러 기능을 사용할 수 있다.

7.6.1. Session ID Search

Session 의 Trace 정보(어느 Server에 해당 Session이 존재하는지)를 확인할 수 있다. Session을 찾기 위해서는 Cluster된 Session Server가 기동중이어야 한다.

Figure 49. Session Trace 화면

조회 결과 항목은 다음과 같다.

Table 170. Session Trace 조회 결과 항목
항목	설명	비고
Server Type	Server의 유형	Session Server: LENA Session Server LENA Server: LENA Application Server
Server Name	Server 이름	Session Server인 경우, 검색 대상 Server가 Primary이고 검색 대상 서버의 Slave Server가 Secondary 이다
Create Time	Session 생성 시각
Last Update Time	Session이 마지막으로 수정된 시각
Last Access Time	Server에 해당 Session을 마지막으로 호출한 시각
Attribute	Session Attribute
Context	Session의 Application Context

7.6.2. Event Trace

장애로 판단되는 이벤트가 발생되었을 때, 해당 Request의 Trace 정보를 확인 할 수 있다.

Figure 50. Event Trace 화면

Trace 정보는 일주일 동안만 보관된다. 이벤트가 발생한 날짜는 검색 조건의 Trace Date에 표시 된다. 검색 결과에서 Status 항목은 발생한 이벤트의 중요도를 의미한다.

Table 171. Event Trace 검색 결과 항목
항목	설명	비고
Trace Time	이벤트가 발생한 Request의 처리 종료 시각	Web Server의 종료 시각
UID	Request를 호출한 User ID. 한 User가 각각 다른 브라우저를 사용 할 경우 UID는 다르게 처리 됨.
WEB	Request를 처리한 Web Server
WAS	Request를 처리한 WAS
Event	발생한 Event
SESSION ID	해당 Request의 Session ID
Detail	상세정보를 확인할 수 있는 버튼

검색 결과의 Detail의 상세 조회 버튼 을 누르면 상세 정보를 확인할 수 있다. 각 항목은 다음과 같다.

Table 172. Event Trace 정보의 상세 정보 항목
항목	설명	비고
Trace Time	이벤트가 발생한 Request의 처리 종료 시각	Web Server의 종료 시각
UID	Request를 호출한 User ID. 한 User가 각각 다른 브라우저를 사용 할 경우 UID는 다르게 처리 됨.
WEB	Request를 처리한 Web Server
WAS	Request를 처리한 WAS
Event	발생한 Event
JVMRoute	Request를 처리한 WAS의 JVMRoute 값
SESSION ID	해당 Request의 SESSION ID
Session Server	Request를 처리한 Session Server	연결된 WAS의 Primary/Secondary Session Server로 표기됨
URL	Request의 URL

Trace되는 이벤트는 아래와 같다.(Event Code는 Log 파일을 보면 확인할 수 있다. 화면에서는 코드를 문장으로 풀이해 보여준다.)

Table 173. Trace되는 이벤트 코드 및 설명
Event Code	설명	비고
sywz	Session ID와 JVMRoute 정보가 다름.(WAS 장애로 Failover가 되었을 경우 발생 할 수 있음.)	Session ID does not match with JVMRoute.
wxso	WAS에 Session정보 없으나 Session Server Session정보 있음.(WAS 장애로 Failover가 되었을 경우 발생 할 수 있음.)	Session does not exist in Application Server.
wosx	WAS에 Session정보가 있으나 Session Server에 Session정보 없음.(Session Server 두 대를 재 기동 했을 경우 발생 할 수 있음.)	Session does not exist in Session Server.
wxsx	WAS에 Session정보 없고, Session Server에 Session정보 없음.(Session Server 두 대 모두 중지 시킨 경우 발생 할 수 있음)	Session does not exist in any Server.
woxx	WAS에 Session 정보가 있으나, Primary & Secondary session server와 연결 끊김.(Session Server 두 대 모두 중지 시킨 경우 발생 할 수 있음)	Session Server does not respond.
wxxx	WAS에 Session 정보가 없고, Primary & Secondary session server와 연결 끊김.(WAS에 해당 Session이 Timeout 및 Session Server 두 대 모두 중지 시킨 경우 발생 할 수 있음)	Session Server does not respond.

sywz 이벤트와 wxso 이벤트가 한 Request에서 중복 발생되는 경우, 하나의 검색 결과에 두 이벤트가 모두 표시 된다.

7.6.3. Trace Setting

다음은 Event/Time Trace 설정을 하는 화면이다.

Figure 51. Trace Setting 화면

Trace 설정 항목은 아래와 같다.

Table 174. Trace Setting 항목
항목	설명	비고
Trace On/Off	Trace 여부	재기동 없이 적용된다
Type	UDP: Trace 생성 조건이 되면, UDP로 Manager에 Trace 정보를 전송 LOG: Trace 생성 조건이 되면, Log로 Trace 정보 저장 ALL: Trace 생성 조건이 되면, UDP와 LOG 기능을 모두 사용
Data	EVENT: Event가 발생한 경우 Trace 기록 UID: 해당 UID인 Request만을 Trace로 기록
UID	입력된 UID인 Request만 Trace로 기록

7.7. TunA APM

TunA APM은 LENA와 TunA APM Tool을 쉽게 연동하여 사용자 애플리케이션의 성능을 편리하게 모니터링 할 수 있는 기능이다. LENA 1.3.2 버전을 기준으로 Linux/Unix OS 및 VM 설치 버전에서 사용할 수 있다.

DIAGNOSTICS > TunA APM 메뉴의 하위 메뉴를 통해 연동 및 환경 구성을 할 수 있다. TunA APM 메뉴의 구성은 아래와 같다.

Connection Management
Module Management
Install Management
Host Management

7.7.1. Connection Management

TunA 수집 서버 및 Web Server의 IP Address와 Port 정보를 관리한다.
유저가 입력한 IP Address와 Port 정보를 바탕으로, TunA 수집 서버에 연결이 가능한지 확인하는 테스트를 수행한다.

TunA 연결 정보 입력

Figure 52. TunA 연결 정보 입력 화면

항목

설명

①

TunA Address

TunA 수집 서버의 IP Address를 입력한다.

②

TCP Port

TunA 수집 서버의 TCP Port를 입력한다.

③

TunA Web Address

TunA Web Server IP Address를 입력한다.

④

HTTP Port

TunA Web Server HTTP Port를 입력한다.

⑤

Save 버튼

유저가 입력한 ① ~ ④ 항목들에 대한 연결 테스트를 수행하고 정보를 LENA Manager에 저장한다.

TunA 연결이 성공적으로 완료되면 Save 버튼 대신 화면에 출력되며, 각 버튼을 통해 앞서 입력했던 TunA 연결 정보를 수정 및 삭제할 수 있다.

Figure 53. TunA 연결 정보 입력 후 Action 컬럼

항목

설명

①

Edit 버튼

TunA 연결 정보를 수정한다.

②

Delete 버튼

TunA 연결 정보를 삭제한다.

TunA 사용자 정보 입력

Figure 54. TunA 사용자 정보 입력 화면

항목

설명

①

User ID

TunA에 생성할 계정을 입력한다. 입력한 계정에 Prefix로 'LENA_'가 붙는다.

계정 이름 규칙 : 계정 이름은 영문자, 숫자, Dash(-), Underscore(_)를 이용하여 구성할 수 있다.

②

Check 버튼

입력된 계정이 올바른지, 이미 TunA에 등록된 계정인지 검증한다.
새로 TunA에 등록된 계정이면 User Type 컬럼에 Owner가, 이미 TunA에 등록된 계정이면 Guest가 출력된다.
이 검증을 마친 후에 System Group을 입력 또는 지정할 수 있다. System Group은 TunA v2.6.0부터 사용되는 개념으로, 모니터링 대상을 그룹으로 관리하기 위해 사용한다. System Group은 모니터링의 기본 단위이다.

Figure 55. 신규 사용자의 TunA 시스템 그룹 입력 화면

항목

설명

①

User ID

사용자 정보에서 입력했던 ID이다.

②

User Type

유저의 타입은 Owner, Guest로 나누어지는데, 신규 사용자는 Owner로 출력된다. Owner 타입의 유저는 System Group을 목록을 생성, 삭제 그리고 변경할 수 있는 권한이 주어진다.

③

Default

기본으로 사용 할 System Group을 설정한다. 이곳에서 설정된 System Group은 Agent 설치 시 기본 System Group으로 설정된다.

④

Name

사용하고 싶은 System Group 이름을 기입한다.

System Group 이름 규칙 : System Group 이름은 영문자, 숫자, Dash(-), Underscore(_)를 이용하여 구성할 수 있다.

⑤

Add System Group

System Group을 추가한다.

⑥

Save

지정한 System Group 및 Default System Group 정보를 저장한다.

⑦

Cancel

현재의 저장되지 않은 정보를 취소하고 이전의 상태로 돌아간다.

Figure 56. 기존 사용자의 TunA 시스템 그룹 입력 화면

항목

설명

①

User ID

사용자 정보에서 입력했던 ID이다.

②

User Type

유저의 타입은 Owner, Guest로 나누어지는데, 기 등록된 사용자는 Guest로 출력된다. Guest 타입의 유저는 Owner 타입의 유저와는 다르게 System Group을 목록을 생성, 삭제 그리고 변경할 수 있는 권한이 주어지지 않으며 Default System Group만 선택할 권한을 가진다.

③

Default

기본으로 사용 할 System Group을 설정한다. 이곳에서 설정된 System Group은 Agent 설치 시 기본 System Group으로 설정된다.

④

Name

기존에 등록되어 있는 유저와 연결된 System Group이다.

⑤

Save

지정한 Default System Group 정보를 저장한다.

⑥

Cancel

현재의 저장되지 않은 정보를 취소하고 이전의 상태로 돌아간다.

TunA 연결 확인

Figure 57. Open TunA 버튼이 활성화 된 모습

TunA Connection Information과 TunA User Information을 통해 필요한 정보가 모두 입력되면 위 첨부된 화면과 같이 TunA와 연결되는 버튼을 사용할 수 있다.
버튼을 누르면 TunA 화면이 새 창으로 브라우저에 출력된다.

7.7.2. Module Management

TunA Agent 파일을 LENA Manager에 업로드하고 TunA Agent에 대한 환경 설정을 관리한다.
TunA 에서 제공되는 Agent 파일은 TunA Host Agent와 TunA Java Agent로 구성되어 있으며 각각 tar 압축 파일 형태로 제공되고 있다.

Figure 58. Agent Module Upload 버튼

항목

설명

①

Host Agent Upload 버튼

TunA Host Agent 파일을 업로드하기 위한 Upload File 다이얼로그를 연다. 파일을 다시 업로드 할 경우 기존에 업로드 되었던 파일을 덮어쓴다.

②

Java Agent Upload 버튼

TunA Java Agent 파일을 업로드하기 위한 Upload File 다이얼로그를 연다. 파일을 다시 업로드 할 경우 기존에 업로드 되었던 파일을 덮어쓴다.

Figure 59. Agent Module Upload 후의 화면

항목

설명

①

Last Updated

Agent 파일을 업로드한 시각이 표시된다.

②

Use Additional Config

각 Agent에 공통으로 지정할 설정 항목이 있다면 체크한다. 체크박스에 체크하면 본 항목 하단에 Additional Config 항목이 출력되며, 체크박스를 해제하면 Additional Config 항목이 출력되지 않는다.

③

Additional Config

Use Additional Config에 체크하면 활성화되는 텍스트박스로, 각 Agent에 공통으로 지정할 설정 항목을 작성한다. Install Management 단계에서 Agent 설치 시 본 텍스트박스에 작성된 내용이 환경 설정 파일에 포함되어 설치된다.

7.7.3. Install Management

TunA Host Agent와 TunA Java Agent를 설치할 대상 서버를 관리하고 Agent 파일을 서버에 Install한다.

Figure 60. Install Management 화면

항목

설명

①

Host List

TunA Host Agent 설치를 관리하는 목록이다. Host Agent를 설치 할 수 있는 목록과 Host Agent가 설치된 목록이 출력된다.

②

Add Host 버튼

Host List로 관리 될 목록을 조회 및 지정하기 위한 다이얼로그를 연다.

③

WAS List

TunA Java Agent 설치를 관리하는 목록이다. Java Agent를 설치 할 수 있는 목록과 Java Agent가 설치된 목록이 출력된다.

④

Add WAS 버튼

WAS List로 관리 될 목록을 조회 및 지정하기 위한 다이얼로그를 연다.

Install Management에서는 TunA Agent를 설치할 Host 또는 WAS를 먼저 선택하고 목록(Host List, WAS List)에 추가한다.

Host List의 추가 / 삭제 / 변경

TunA Host Agent는 Host 당 하나의 Agent를 설치할 수 있다. 따라서 Multi-node인 환경의 경우에는 특정 Node 하나를 선택하여 설치한다.
설치를 위해 Host List에 Host를 추가한다. Host List Table 하단의 Add Host 버튼을 클릭하여 진행한다.

Figure 61. Host 추가 다이얼로그 화면

항목

설명

①

Avaliable host list for TunA

Host Agent를 설치할 수 있는 Host 목록을 의미한다.
LENA Manager에 등록 또는 설치된 Node를 포함하는 Host만 확인 할 수 있다.

②

Action Checkbox

Host를 선택하기 위한 체크박스이다.

③

Node Selectbox

추가 / 삭제 / 변경 작업을 수행할 Node를 선택한다.

④

Action Status

Node Selectbox로 선택한 Node에서 어떤 기능이 수행될 지 표시된다. 표시되는 기능은 아래와 같다.

Add: Host의 Node를 지정하고 Host List에 추가한다.
Modify: 지정했던 Node를 다른 Node로 변경한다.
Remove: 해당 Node를 목록에서 삭제한다.

⑤

Save 버튼

선택 된 Node에 대해 지정한 Action을 수행한다.

WAS List의 추가 / 삭제

TunA Java Agent는 WAS 당 하나의 Agent를 설치할 수 있다. 설치를 위해 WAS List에 WAS를 추가한다. 이 작업은 WAS List 테이블 하단의 Add WAS 버튼을 눌러 진행한다.

Figure 62. WAS 추가 다이얼로그 화면

항목

설명

①

Available WAS list for TunA

WAS Agent를 설치할 수 있는 WAS 목록을 의미한다.
LENA Manager에 등록 또는 설치된 WAS만 확인 할 수 있다.

②

Action Checkbox

WAS를 선택하기 위한 체크박스이다.

③

Action Status

선택한 WAS에서 어떤 기능이 수행될 지 표시된다. 표시되는 기능은 아래와 같다.

Add: WAS를 WAS List에 추가한다.
Remove: 해당 WAS를 목록에서 지운다.

④

Save 버튼

선택 된 WAS에 대해 지정한 Action을 수행한다.

Agent 설치

TunA Agent를 설치하기 위해서는 아래 첨부된 화면과 같이 Host List, WAS List에 Agent가 설치 될 대상이 추가되어있어야 한다.

Figure 63. Host와 WAS가 설치 대상 목록에 추가된 Install Management 화면

항목

설명

①

Host List

TunA Host Agent 설치를 관리하는 목록이다. Host Agent를 설치 할 수 있는 목록과 Host Agent가 설치된 목록이 출력된다.

②

Install 버튼

Host에 TunA Host Agent를 설치한다. 설치가 정상적으로 완료되면 Agent가 설치된 시각이 출력된다.

③

WAS List

TunA Java Agent 설치를 관리하는 목록이다. Java Agent를 설치 할 수 있는 목록과 Java Agent가 설치된 목록이 출력된다.

④

Install 버튼

WAS에 TunA Java Agent를 설치한다. 설치가 정상적으로 완료되면 Agent가 설치된 시각이 출력된다.

7.7.4. Host Management

Install Management에서 설치 작업을 수행한 TunA Host Agent의 제어 및 개별 환경 설정 관리는 Host Management 에서 수행한다.

Figure 64. Host Management 화면

항목

설명

①

Host List

TunA Host Agent가 설치된 Host 목록을 출력한다.

②

Host Action 버튼

TunA Host Agent의 상태를 확인하고 제어를 수행하기 위한 다이얼로그를 연다.

③

Host Agent Status

TunA Host Agent의 상태를 표시한다. 표시될 수 있는 상태는 다음과 같다.

Started: TunA Host Agent가 기동된 상태이다.
Stopped: TunA Host Agent가 기동 중지상태이다.

④

Action 버튼

TunA Host Agent를 기동, 중지하거나 삭제한다. 삭제는 TunA Host Agent가 중지 상태일 때만 활성화된다.

⑤

System Group

Host Agent가 속할 System Group을 선택한다.

⑥

Configuration

Host Agent의 설정을 수정한다.

⑦

Save 버튼

수정된 Host Agent의 설정을 저장한다.

7.7.5. WAS에서의 TunA 설정

Install Management에서 설치 작업을 수행한 TunA Java Agent의 제어 및 개별 환경 설정 관리는 WAS 설정 관리 화면의 TunA 탭에서 수행한다.

Figure 65. WAS - TunA Tab 화면

항목

설명

①

TunA Tab

TunA Tab 화면에서는 TunA Java Agent를 관리한다. TunA Tab을 눌렀을 때 유저가 등록되지 않았거나 WAS에 TunA Java Agent가 설치되지 않으면 유저 등록 및 Agent 설치 요청 문구가 화면에 출력된다.

②

Enable TunA Checkbox

TunA Java Agent의 사용 여부를 체크한다. WAS 기동 시에 본 항목을 반영한다.

③

System Group

Java Agent가 속할 System Group을 선택한다.

④

Java Agent Config

TunA Java Agent의 설정을 확인하고 수정하는 기능을 제공한다.

⑤

Delete 버튼

TunA Java Agent를 삭제한다. WAS가 중지 상태일 때에만 활성화된다.

⑥

Save 버튼

TunA Java Agent 설정을 저장한다.

8. Topology

각 시스템의 구성현황을 한눈에 알아볼 수 있으며, 설치 및 설정기능을 제공하고, 자원 모니터링 및 기동/중지 제어를 할 수 있다.

Figure 66. Topolopgy 화면

8.1. 화면 구성

System 영역, 토폴로지 영역, 자원 모니터링 영역, 서비스 트레이싱 영역으로 구분된다.

System 영역

등록된 System 리스트를 카드 형태로 제공한다.

카드 내의 시스템 명 좌측의 아이콘은 시스템의 상태를 의미하는데 상태를 표시하는 기준은 시스템을 구성하는 Resource와 진단 결과에 따라 3단계로 나뉘어 나타낸다.
- 파란색 원 아이콘 : 시스템을 구성하는 모든 서버의 자원 사용량이 Low, 진단 프로세스가 수행되지 않은 상태
- 주황색 원 아이콘 : 시스템을 구성하는 모든 서버의 자원 사용량이 Middle 이하 또는 진단 프로세스 수행 결과가 Abnormal 상태
- 붉은색 원 아이콘 : 시스템을 구성하는 일부 서버의 자원 사용량이 High 인 경우 또는 진단 프로세스 수행 결과가 Fault 상태
  
  시스템 명 하단의 시계 아이콘 은 시스템 내의 WAS들의 평균 응답시간을 의미하고, 사용자 아이콘 은 현재 사용자 수(최근 5분 동안) / 오늘 전체 사용자 수를 의미한다.
  
  자원사용량의 Low, Middle, High에 대한 기준은 DIAGNOSTICS > Policy > Common Rule Setting > Dashboard 항목에서 변경 할 수 있다.
토폴로지 영역

시스템 별 노드와 서버 Instance 구성현황을 토폴로지 차트로 보여준다. 각 Node에 설치한 Web Server, WAS, Session Server를 설치 및 실행, clustering 을 할 수 있고, 서버 상태 정보를 확인 할 수 있다. 뿐만 아니라 Web Server-WAS 간 ,WAS-Session Server, WAS-Datasource간에 연동을 설정할 수 있다.
자원 모니터링 영역

Node와 Server의 CPU, Memory 등 상세 자원 모니터링 정보를 제공한다.
Service Tracing 영역

특정 Client IP와 요청 Service Pattern을 기준으로 서비스를 트레이싱하여 Request 수, 평균 응답시간, 서비스 응답 error 수를 확인 할 수 있다.

시스템목록 우측에 있는 설정 버튼 을 통해 다음의 사항을 변경 할 수 있다.

Chart

Refresh Interval : 토폴로지 영역의 데이터 조회 주기
Refresh Topology Chart : 토폴로지 영역의 차트 그리는 메타데이터 정합성 검증 및 복원

System List

System 목록에 보여줄 System 선택 및 순서 변경

Elements

Show Endpoint : Endpoint 영역 표시 여부 설정
Show Edge Info : Edge에 상세정보 표시 여부 설정
Show Server Name : Server명 표시 여부 설정

Transparency

Node : 토폴로지 영역의 Node 투명도를 설정
Edge : 토폴로지 영역의 Edge 투명도를 설정

8.2. 토폴로지 영역 상세

토폴로지에서 뷰 모드에 따라 정보를 구분하여 보여준다.

View All : 전체 정보를 보여준다.
Low : 서버의 자원 사용량이 Low 인 인스턴스만 구분하여 보여준다.
Middle : 서버의 자원 사용량이 Middle 인 인스턴스만 구분하여 보여준다.
High : 서버의 자원 사용량이 High 인 인스턴스만 구분하여 보여준다.
Stop/unknown : 중지된 인스턴스만 구분하여 보여준다.

또 Cluster로 단위로 인스턴스들을 활성화하여 보여준다.

진단기능이 설정되어 있는 WAS의 경우, 자원사용량을 체크하기 이전에 서버상태의 진단 결과가 Abnormal 또는 Fault 인지를 우선적으로 확인한다. 해당 상태로 판단되는 경우에는 High 상태로 표시해준다.

8.2.1. Control [Edit: OFF]

E2E (End to End)관점하에 Client부터 Database까지 상세한 모니터링 정보 및 제어 기능을 제공한다.

Figure 67. Topolopgy Control [Edit: OFF]

CLIENT 영역

Client는 사용자를 말하며, 사용자가 Web Server에 요청을 주고 받는 브라우저 화면 Rendering 시간 및 Script error 내용을 확인 할 수 있다.

WEB 영역

WEB 영역에서는 설치된 Web Node 와 Web Server 정보를 제공하고 서버의 제어 할 수있다.

구성정보

Web Node는 Web Server가 설치되는 영역으로 노드 별 서버 설치 현황을 확인 할 수 있다.
모니터링 정보

Web Node에서는 기본적으로 CPU, Memory, Disk 상태 정보를 제공한다.

Web Server에 마우스를 갖다 대면 팝업 형태로 서버의 CPU, Memory, Thread 상태 정보를 제공한다.

Web Node와 Server를 선택하면 토폴로지 영역 우측에 있는 자원 모니터링 영역에 각각의 실시간 상세 모니터링 정보가 제공된다.
- Node : CPU, Memory, Disc, Network와 기본 정보
- Server : CPU, Memory, Thread, QoS와 기본 정보

제어 기능

Server에 대해 크게 3가지 제어 기능을 제공한다.

Server Control : Start, Stop, Service Control

Service Control은 무중단 적시배포 기능을 제공한다. 이것은 오류 서비스 발생시 이를 수정한 소스를 WAS에 긴급 배포하고 이 WAS를 호출 할 Web Server(적시서버)를 구성한 후 오류가 발생된 서비스를 요청 받은 Web Server들이 적시서버로 서비스를 포워딩하여 서비스가 정상적으로 제공되게 하는 방식이다.

이 기능을 사용하려면 Web Server에서 LSC모듈이 사용되도록 설정이 되어 있어야 한다.(httpd-lsc.conf 파일에서 LscEnable을 On으로 변경 후 서버를 재기동한다.)

제어시간, 제어조건(Header, Cookie, URL) 및 요청을 forwarding 할 서버(http://IP:Port) 를 정의 후 저장하면 정의 된 내용에 따라 실시간으로 들어오는 요청을 해당 서버로 연결하여 서버 재기동 없이 서비스를 제공한다.

Move to : Configuration
Cluster : Compare, Sync, Snapshot, Graceful Restart

APPLICATION 영역

APPLICATION 영역에서는 설치된 WAS Node 와 WAS 정보를 제공하고 서버의 제어 할 수있다.

구성정보

WAS Node는 WAS가 설치되는 영역으로 노드 별 서버 설치 현황을 확인 할 수 있다.
모니터링 정보

WAS Node에서는 기본적으로 CPU, Memory, Disk 상태 정보를 제공한다.

WAS Server에 마우스를 갖다 대면 팝업 형태로 서버의 CPU, Thread, Heap 상태 정보를 제공한다.

WAS Node와 Server를 선택하면 토폴로지 영역 우측에 있는 자원 모니터링 영역에 각각의 실시간 상세 모니터링 정보가 제공된다.
- Node : CPU, Memory, Disc, Network와 기본 정보
- Server : Warning, CPU, Memory, Thread, QoS와 기본 정보
제어 기능

Server에 대해 크게 4가지 제어 기능을 제공한다.
1. Server Control : Start, Stop, Forced Stop
2. Dump : Thread Dump, Active Service Dump, Heap Dump
3. Move to : Configuration, Monitoring
4. Cluster : Compare, Sync, Snapshot, Graceful Restart

SESSION 영역

SESSION 영역에서는 설치된 Session Node 와 Session 서버 정보를 제공하고 서버의 제어 할 수있다.

구성정보

Session Node는 Session 서버가 설치되는 영역으로 노드 별 서버 설치 현황을 확인 할 수 있다.
모니터링 정보

Session Node에서는 기본적으로 CPU, Memory, Disk 상태 정보를 제공한다.

Session Server에 마우스를 갖다 대면 팝업 형태로 서버의 CPU, Session Count, Heap 상태 정보를 제공한다.

Session Node와 Server를 선택하면 토폴로지 영역 우측에 있는 자원 모니터링 영역에 각각의 실시간 상세 모니터링 정보가 제공된다.
- Node : CPU, Memory, Disc, Network와 기본 정보
- Server : CPU, Memory, Session Count와 기본 정보
제어 기능

Server에 대해 크게 2가지 제어 기능을 제공한다.
1. Server Control : Start, Stop
2. Move to : Configuration

DB 영역

DB 영역에서는 WAS와 연결된 Database 정보를 제공한다. Database는 RESOURCE 메뉴에서 등록되어 있어야 한다. 노드는 다른 영역과의 동일하게 표현하기 위해 가상의 노드로 표현하고 있다. 각 DB에 대한 모니터링 정보나 제어 기능은 제공하지 않는다.

Edge 정보

연결선은 각 인스턴스 간, 또는 인스턴스와 Database간의 연결을 의미하며, 서버 평균 응답시간 및 연결된 Connection 수를 나타낸다.

Client-WEB : Connection 수(Client 브라우저 렌더링 평균 완료 시간(ms)/Web Server 평균응답시간(ms))
WEB-APPLICATION : Active Connection 수(WAS 평균응답시간(ms))
APPLICATION-DB : Active Datasource 사용률 (%)

End to End 모니터링기능은 기본적으로 off상태로 설정되어 있다.

따라서 Client-WEB, WEB-APPLICATION 사이의 브라우저 렌더링 평균응답시간 또는 Server의 평균응답시간을 보기 위해서는 다음의 순서대로 설정을 해주어야한다.

manager.conf 파일에서 diagnostics.e2e.enable=true 로 설정

Web Server의 httpd.conf 파일에서 httpd-eum.conf 파일주석 해제

<IfDefine MOD_EUM>
 #LENA E2E Monitoring Extension settings
 Include ${INSTALL_PATH}/conf/extra/httpd-eum.conf <-- 이부분 주석 해제
</IfDefine>

Web Server의 eum/eum.properties파일에서 agent_enable값을 true로 수정

단, 이 기능은 window OS에서는 지원하지 않는다.

8.2.2. Control [Edit: ON]

토폴로지 영역 우측상단에 Edit 버튼 을 선택하면 편집모드로 전환된다. 여기에서는 시스템 내의 노드와 인스턴스 설치 기능을 제공한다.

버전 1.3.4.2부터 편집 컨트롤은 기본적으로 숨겨져 있습니다. 활성화하려면 관리자 > 환경설정 > 매니저 환경 > 매니저 설정 > 설정으로 이동하여 'lena.topology.edit.enable' 항목을 'true’로 설정하십시오.

Figure 68. Topology Control [Edit: ON]

Node

노드의 설치/수정/삭제 동작 방식은 Node와 동일하다. 따라서 이 장에서는 사용 방식만 설명한다.

설치
1. Node 버튼 을 선택 후 설치하고자 하는 영역 위에 마우스를 클릭한다.
2. 화면 우측의 설치 요소 상세정보 영역에 해당 정보를 입력한다.
3. Save 버튼 을 선택한다.
수정
1. 변경하고자 하는 노드를 선택한다.
2. 화면 우측의 설치 요소 상세정보 영역에 해당 정보를 변경한다.
3. Save 버튼 을 선택한다.
삭제
1. 삭제하고자 하는 노드를 선택한다.
2. 우클릭 버튼을 누르면 Hide, Unregister, Uninstall 메뉴 중 원하는 기능을 선택한다.
  
  노드 삭제시 노드 안에 설치된 서버는 한대도 없어야 한다.

Instance

서버의 설치/수정/삭제 동작 방식은 server와 동일하다. 따라서 이 장에서는 사용 방식만 설명한다.

설치

Instance 버튼 을 선택 후 설치하고자 하는 영역의 노드 위에 마우스를 클릭한다.
화면 우측의 설치 요소 상세정보 영역에 해당 정보를 입력한다.

Save 버튼 을 선택한다.

서버가 하나도 설치되어 있지 않은 노드 목록은 각 영역의 아래에 회색바탕 위에 있는 사각버튼으로 제공된다. 빈 노드에 서버를 설치하고 싶은 경우 해당 노드버튼을 더블클릭한다.

수정
1. 변경하고자 하는 서버를 선택한다.
2. 화면 우측의 설치 요소 상세정보 영역에 해당 정보를 변경한다.
3. Save 버튼 을 선택한다.
삭제
1. 삭제하고자 하는 서버를 선택한다.
2. 우클릭 버튼을 누르면 Unregister, Delete 메뉴 중 원하는 기능을 선택한다.

Edge

Edge는 서버와 서버의 연결을 의미하며 WEB-APPLICATION, APPLICATION-SESSION, APPLICATION-DB 영역 안의 서버들을 연결 할 수 있다.

연결
1. Edge 버튼 을 선택 후 연결하고자 하는 시작서버 선택 후 드래그하여 도착서버와 연결한다.
2. 화면 우측의 설치 요소 상세정보 영역에 해당 정보를 입력한다.
3. Save 버튼 을 선택한다.
  
  APPLICATION-SESSION 간에 연결하는 경우, 실선은 Primary Server, 점선은 Secondary Server를 의미한다.
연결 정보 변경
1. 변경하고자 하는 edge를 선택한다.
2. 화면 우측의 설치 요소 상세정보 영역에 해당 정보를 변경한다.
3. Save 버튼 을 선택한다.
연결 해제
1. 삭제하고자 하는 edge를 선택한다.
2. 우클릭 버튼의 메뉴인 Delete 버튼을 선택한다.

Cluster

CLUSTER 메뉴에서 제공하는 Server Cluster기능을 설정 할 수 있다.

생성
1. Cluster 버튼 을 선택한다.
2. 화면 우측의 설치 요소 상세정보 영역에 해당 정보를 입력한다.
3. Save 버튼 을 선택한다.
변경
1. Cluster 버튼 옆 select 박스에서 변경하고자 하는 server cluster를 선택한다.
2. 화면 우측의 설치 요소 상세정보 영역에 해당 정보를 변경한다.
3. Save 버튼 을 선택한다.
삭제
1. Cluster 버튼 옆 select 박스에서 변경하고자 하는 server cluster를 선택한다.
2. 화면 우측의 설치 요소 상세정보 영역의 Delete 버튼 을 선택한다.

8.3. 서비스 트레이싱 영역 상세

특정 서버의 IP 혹은 Service Pattern을 입력 후 Start 버튼 을 선택하면 입력한 정보를 기준으로 서비스를 트레이싱하여 Request 수, error를 확인 할 수 있다. 트레이싱 하는 동안 서비스 트레이싱 영역 우측에 Xlog 정보도 제공하므로 필요에 따라 xlog를 선택하여 상세한 정보를 확인할 수 있다.

서비스 트레이싱 기능을 사용하기 위해서는 다음의 순서대로 설정을 해주어야 한다.

manager.conf 파일에서 diagnostics.e2e.enable=true 로 설정

tracing 대상 Web Server의 httpd.conf 파일에서 httpd-eum.conf 파일주석 해제

<IfDefine MOD_EUM>
 #LENA E2E Monitoring Extension settings
 Include ${INSTALL_PATH}/conf/extra/httpd-eum.conf <-- 이부분 주석 해제
</IfDefine>

tracing 대상 Web Server의 eum/eum.properties파일에서 agent_enable값을 true로 수정
tracing 대상 WAS의 advertiser.conf파일에서 enable.send.profile.info값을 true로 수정

단, 이 기능은 window OS에서는 지원하지 않는다.

9. Admin

9.1. IAM

Manager의 사용자 관리 및 사용자 별 메뉴 권한 관리 기능을 제공한다.

9.1.1. Users

사용자 목록

ADMIN > Users 메뉴에서 Manager 사용자의 생성, 수정, 삭제 기능을 제공한다.

Figure 69. Users 화면

사용자 관리의 속성은 아래와 같다.

Table 175. 사용자 관리 속성
항목(*는 필수값)	설명	비고
Use ID(*)	사용자 식별자
User Name(*)	사용자 이름
Password(*)	사용자 비밀번호	비밀번호는 특수문자, 숫자, 영문자 혼합의 최소 8자 이상이어야 한다
Change User ID	사용자 데이터 수정 및 생성자
Last Password Update	사용자 비밀번호 수정일자
+ 아이콘	New 버튼, 수정 버튼 을 클릭하여 선택된 권한 정보가 변경 중임을 표시
- 아이콘	삭제 버튼 을 클릭하여 선택된 권한 정보가 삭제됨을 표시

기본적으로 관리자 권한을 가진 계정 두 개와 API 용용 계정을 제공한다. 제공되는 계정 외에 사용자를 추가하여 사용하기를 권장한다.

사용자 등록

New 버튼 을 클릭하여 신규 사용자 등록을 준비한다.
사용자 ID, 사용자 명, 사용자 패스워드를 입력한다.
- 사용자 패스워드는 암호화되어 저장된다.
- 패스워드는 글자수가8~20자, 영어 대소문자, 숫자, 특수문자(!@#$%^*+=-) 조합으로 작성한다.
Save 버튼 을 클릭하여 사용자 정보를 저장한다.

Password 암호화는 해쉬 알고리즘(SHA-512)을 사용한다.

사용자 수정

수정 버튼 을 클릭하여 사용자명, 사용자 패스워드를 변경한다.
- 사용자 패스워드는 암호화되어 저장된다.
Save 버튼 을 클릭하여 사용자 정보를 저장한다.

Manager 에 로그인시 7 번 이상 실패하면 해당아이디는 잠김 상태가 되어 사용할 수가 없다.
잠김 상태를 해제하기 위해서는 사용자 관리 화면에서 해당 아이디의 패스워드를 수정해주어야 한다.
패스워드 수정을 위해 Manager 에 로그인 한 계정이 없는 경우에는, $LENA_HOME/bin/reset-manager-pw.sh 를 실행하여 패스워드를 수정할 수 있다.

사용자 삭제

삭제할 사용자를 선택한다.
삭제 버튼 을 클릭하여 사용자를 삭제 가능한 상태로 변경한다.
Save 버튼 을 클릭하여 사용자 정보를 저장한다.

사용자가 1명 남은 경우는 삭제할 수 없다.

사용자 Role 조회

Manager 사용자는 메뉴 사용 Role 획득을 위해 최소한 1개의 그룹에 소속되어 있어야 한다. 사용자를 선택하면, Roles for [User ID] 테이블에 사용자에게 할당된 Role이 표시된다.

사용자 Role 추가

Role을 추가할 사용자를 클릭하여, 현재 사용자에 할당된 Role을 조회한다.
Add Role 을 클릭하여, Role 목록 팝업을 띄운다.
원하는 Role을 선택하여 추가한다.
Save 버튼 을 클릭하여, 사용자에게 맵핑된 Role을 저장한다.

사용자 Role 삭제

Role을 추가할 사용자를 클릭하여, 현재 사용자에 할당된 Role을 조회한다.
삭제 버튼 을 클릭하여 Role을 삭제 가능한 상태로 변경한다.
Save 버튼 을 클릭하여, 사용자로부터 Role을 해제한다.

9.1.2. Roles

Manager는 메뉴 별 권한 관리를 위해 Role을 생성해야 한다. ADMIN > Roles 메뉴를 통해 Role을 생성, 수정, 삭제할 수 있다.

Role 목록

Figure 70. Roles 화면

권한 관리의 속성은 아래와 같다.

Table 176. 권한 관리 속성
항목(*는 필수값)	설명	비고
Role ID(*)	Role 식별자
Role Name(*)	Role 이름
Description	등록된 Role에 대한 설명
Permissions	Role 에 허가된 권한
Change User ID	Role 데이터 수정 및 생성자
Last Update	Role 데이터 수정 및 생성일자
+ 아이콘	New 버튼, 수정 버튼 을 클릭하여 선택된 Role 정보가 변경 중임을 표시
- 아이콘	삭제 버튼 을 클릭하여 선택된 Role 정보가 삭제됨을 표시

Role 생성

New 버튼 을 클릭하여 신규권한 등록을 준비한다.
Role ID, Role 명, Role 설명을 입력한다.
Save 버튼 을 클릭하여 Role 정보를 저장한다

Role 수정

수정할 Role을 선택한다.
수정 버튼 을 클릭하여 Role 명, Role 설명을 변경 한다.
Save 버튼 을 클릭하여 Role 정보를 저장한다.

Role 삭제

삭제할 Role을 선택한다.
삭제 버튼 을 클릭하여 Role을 삭제 가능한 상태로 변경한다.
Save 버튼 을 클릭하여 Role 정보를 저장한다.

Role-Menu Mapping

LENA Manager에서 생성한 Role 별로 접근 가능한 메뉴를 설정할 수 있다. 메뉴를 권한을 설정할 하나의 Role을 선택한다. LENA Manager에 등록된 모든 메뉴를 보여주는 메뉴 목록 중 접근 제어를 설정할 메뉴를 선택하고 메뉴권한을 설정한다.

메뉴 권한 조회

Role 목록에서 원하는 Role 을 선택하면, 하단에 선택된 Role 에 대한 Menu 접근 권한 이 보여진다.

"SERVER", "CLUSTER", "RESOURCE" 메뉴의 하위 화면에서 Node, Server, Server Cluster, Resource 을 추가할 경우 자동으로 "메뉴 권한 관리" 화면의 메뉴 목록에 추가한 항목이 조회된다.

따라서 신규 메뉴를 추가하고 싶을 경우 "SERVER", "CLUSTER", "RESOURCE" 하위 화면에서 각 항목을 등록 및 생성하면 된다.

Server에 대한 권한을 변경해야 할 경우 아래 메뉴에 동일하게 권한을 반영해야 한다.

"SERVER" 하위의 해당 Server
"CLUSTER" 하위의 해당 Server

만약 이를 지키지 않고, Server Cluster 하위의 일부 Server 메뉴에 대해 다음과 같이 권한을 설정할 경우를 고려해보자.(예시, 권장사항 아님)

"SERVER" 하위의 해당 Server : 권한 있음
"CLUSTER" 하위의 해당 Server : 권한 없음

이 경우 메뉴 및 Server Cluster, Server 권한은 아래와 같이 표현된다.

Server Cluster를 구성하는 Server 개수 : "CLUSTER" 하위 Server 권한 기준으로 권한이 있는 Server 개수
Server Cluster의 하위 메뉴 : "CLUSTER" 하위 Server의 메뉴 권한 기준으로 권한이 있는 Server만 보임
Server Cluster의 Overview, Application Server, Web Server 탭에서의 Server 목록 : Server Cluster의 구성 정보를 나타내야 하므로, "CLUSTER" 하위 권한과 무관하게 모든 Server 목록 조회
Server Cluster의 Overview, Application Server, Web Server 탭에서의 Server 상세 링크 : 개별 Server에 대한 접근이므로, "SERVER" 메뉴 하위의 Server 권한이 없는 Server에 대한 접근을 막음

메뉴 권한 맵핑

권한을 설정할 메뉴를 선택한다.
- 권한 선택 시 메뉴에 대한 권한까지 조회된다.
메뉴 목록에서 권한을 설정할 메뉴를 선택한다.
- 메뉴 선택 시 메뉴 권한 목록에 메뉴 권한이 표시된다
권한 변경이 필요할 경우 Y 혹은 N을 선택한다.
Save 버튼 을 클릭하여 메뉴 권한 정보를 저장한다.

9.1.3. Action Trace (사용자 활동 추적)

Manager는 사용자의 주요 활동을 추적하여 감사 로그를 기록한다. 권한 관리, 사용자 관리, 메뉴 권한 관리 등 IAM 관련 모든 조회 및 변경 작업이 기록된다.

추적 대상 활동

Table 177. 추적되는 IAM 활동 목록
대상	활동 내용	활동 유형
Users	사용자 목록 조회	READ
Users	사용자 정보 수정/삭제	WRITE
Roles	권한 목록 조회	READ
Roles	권한 생성/수정/삭제	WRITE
Menu Auth	메뉴 권한 조회	READ
Menu Auth	메뉴 권한 변경	WRITE
User Auth	사용자 권한 조회	READ
User Auth	사용자 권한 변경	WRITE

Action Trace 로그 조회

사용자 활동 로그는 REST API를 통해 조회할 수 있다.

Request URL

Method

설명

/rest/admin/actionTraceLogList/{date}

GET

특정 날짜의 활동 로그 조회

Action Trace 로그는 manager.conf의 userHistory 설정이 활성화된 경우에만 파일로도 기록된다.

9.2. License

Manager를 통해 각 Node별 현재 적용된 라이선스를 조회하고 갱신할 수 있는 기능을 제공한다.

9.2.1. License 목록

License화면을 열면 Node별로 현재 적용된 License의 목록을 조회할 수 있다.

License의 상태는 Status 항목을 살펴보면 확인 할 수 있다.

Figure 71. License의 목록 화면

9.2.2. License 상세

License의 목록을 클릭하면 License의 상세 정보를 확인할 수 있다.

상세 정보 항목은 아래와 같다.

Table 178. License의 상세 정보 항목
항목	설명	비고
Node Name	Node 명
Type	라이선스 구분	Trial, Standard
Customer Name	구매 고객사 명
System Name	설치된 시스템 명
Issue No	라이선스 발행번호
Issue Date	라이선스 발행일자
License Term	라이선스 허용 기간
Lena Home	Lena Home 경로
IP Address	Node의 IP 주소
Hardware ID	H/W를 인식하는 ID	MAC Address 또는 Host명
Contract CPU Core Limit	계약된 최대 Core 개수
CPU Core Limit	실제 측정된 Core 개수
Contract Instance Limit	계약된 최대 Instance개수
Instance Limit	실제 측정된 Instance 개수
Contract Type	계약 유형	Subscription, Perpetual
Node Type	노드 유형	WEB, WAS, MDS
LENA Version	LENA 버전
Status	라이선스 유효성 여부

라이선스의 만료기간 15일 전부터 알림메세지를 제공한다. 알림메세지는 Manager 우측 상단의 종 아이콘 에서 확인 할 수 있다.

9.2.3. License 업로드 / 복구

업로드

노드목록에서 신규 License 를 적용하고자 하는 노드를 선택하고 목록 하단의 Upload 버튼 을 사용한다. 해당 버튼을 클릭하면 License 업로드 팝업창이 열리는데 이 창에서 발급받은 License 파일을 찾아 업로드 하면 선택한 노드들에 License가 적용된다.

복구

노드목록에서 License 를 복구하고자 하는 노드를 선택하고 목록 하단의 Restore 버튼 을 사용한다. 해당 버튼을 클릭하면 백업해 두었던 파일로 License가 복구된다.

9.2.4. License 관련 시스템 현황 체크

License 목록조회 화면에서 Node를 선택하고 Check System Info 버튼 을 클릭하면, License 발급에 필요한 시스템 현황을 확인할 수 있다.

Figure 72. System Information

Total System Info 조회

여러 노드를 선택한 후 Check Total Info 버튼 을 클릭하면, 선택한 노드들의 시스템 정보를 종합하여 조회할 수 있다.

Total System Info 조회 결과 예시

=== Aggregated System Information ===

Selected Nodes: 5
Total CPU Cores: 40
HyperThreading ENABLED: 2 nodes
HyperThreading DISABLED: 3 nodes

=== Node Details ===
node1: CPU Core: 8, HyperThreading: DISABLED
node2: CPU Core: 8, HyperThreading: ENABLED
node3: CPU Core: 8, HyperThreading: DISABLED
node4: CPU Core: 8, HyperThreading: ENABLED
node5: CPU Core: 8, HyperThreading: DISABLED

Table 179. Total System Info 항목
항목	설명
Selected Nodes	선택한 노드의 총 개수
Total CPU Cores	선택한 노드들의 CPU 코어 총합
HyperThreading ENABLED	HyperThreading이 활성화된 노드 수
HyperThreading DISABLED	HyperThreading이 비활성화된 노드 수
Node Details	각 노드별 CPU 코어 수와 HyperThreading 상태

이 기능은 라이선스 계약 시 필요한 전체 CPU 코어 수를 빠르게 산정하는 데 유용하다.

CLI환경에서도 각 Node별 License 현황을 조회하기 위한 Shell Script를 제공한다. Shell 파일은 ${LENA_HOME}/bin/check-license.sh 이다. 이 Script를 실행한 결과의 사례는 아래와 같다.

check-license.sh 실행 예

[bin]$ ./check-license.sh
****************************************************************************
[System Information]
 Hostname : solweb2
 HostAddress : 127.0.0.1
 Hardware ID : 52:54:00:E9:AC:A1 ( 52:54:00:E9:AC:A1 )
 Engine Path(LENA_HOME) : /engn001/lena/dev
 Node UUID : e46da220-db50-3854-84a0-7b61e1b6e7cd
 Manager Address : 127.0.0.1:7700
 CPU Core : 4
 HyperThreading : DISABLED
 Current Date : 20180705

[License Information]
 License Status : true [License is valid.]
 Node Type : lena-enterprise
 ISSUE_NO : 201807041532438300001
 TYPE : Standard
 CUSTOMER_NAME : LG
 SYSTEM_NAME : CNS
 SYSTEM_TYPE : PROD
 HARDWARE_ID : 52:54:00:E9:AC:A1
 LENA_HOME : /engn001/lena/dev
 CONTRACT_CPU_CORE_LIMIT : 8
 CPU_CORE_LIMIT : 8
 CONTRACT_INSTANCE_LIMIT : 8
 INSTANCE_LIMIT : 8
 MANAGER_ADDRESS : UNLIMITED
 WEB_CONTRACT_CPUCOREDAY_LIMIT :
 WEB_CPUCOREDAY_LIMIT : N
 WAS_CONTRACT_CPUCOREDAY_LIMIT :
 WAS_CPUCOREDAY_LIMIT : N
 RE_ISSUEANCE :
 USE_POSTPAID :
 START_DATE : 20180501
 END_DATE : 20190531
 LICENSE_KEY :
H2VaDEE9fjFlvHBRsQeGXasYT5l4tBc6ebayNIdtVZ5/lj4/EM0mYf38karMTKgcLLmPMMFa8BOEFt5zRfBc/IiOxlmDgy
j0+iq30ABfJoyAhY3nWBVJhBy7h0U3hzJWr1hyCuZMFAHquL4dinwWAqmJeL+jntJKFufD38vdF2YwKEoRNH9dGQnqXZHO
U8wQZmN4UHk5YB5/O6YIUfFNGU3wyzjfKCfF9Golu9zQAsSZ358ptjC/TBUy+ccvLa75H32XPxiNSSxytn0hGFbcVc61kv
zi7YMNUgnuEyDEQ/dhFKxJ17ijUQBZj5xbFQ9qUTzL1QKGLl+cbYVsr6kvZg==
****************************************************************************

출력되는 항목은 앞 절에서의 설명과 동일하며, License 발급에 필요한 기본정보를 출력하므로 License 발급 요청 시에 활용된다.

출력 항목 중 "HyperThreading" 은 HyperThreading 사용여부를 체크하는 것으로, HyperThreading 사용 시 물리 Core의 2배수로 Core수를 산정한다.

9.2.5. Host기반 License 체크 설정

License는 계약에 따라 Mac Address 또는 Host명으로 발급대상 H/W를 체크한다. 기본 설정은 Mac Address 기준이므로, Host명 기준으로 License 체크를 실행하기 위해서는 Linux/Unix OS를 기준으로 ${LENA_HOME}/bin에 위치한 start-agent.sh, check-license.sh파일과 각 Application Server의 setenv.sh 파일을 열어서 다음과 같이 수정한다.

start-agent.sh 파일 설정 (변수 $JAVA_OPTS에 추가)

JAVA_OPTS="$\{JAVA_OPTS} -Dlicense.check-type=hostname"

check-license.sh 파일 설정 (다음 항목 주석 해제)

_JAVA_OPTS="$\{_JAVA_OPTS} -Dlicense.check-type=hostname"

각 Application Server의 setenv.sh 파일 설정 (다음 항목 주석 해제)

CATALINA_OPTS=" $\{CATALINA_OPTS} -Dlicense.check-type=hostname"

9.2.6. 시간 정보 조회

라이선스 목록에서 시간정보를 조회하고 싶은 노드를 선택 후, Check Time Info 버튼 을 클릭하면 선택한 노드들에 대한 시간과 타임존 의 정보를 확인 할 수 있다.

9.3. Security (서비스 제어)

Application Server에 IP또는 URL기반으로 사용자 요청을 제한하는 기능이다.

9.3.1. Rule Setting (Rule 설정)

특정 IP나 URL에서 요청을 제어하고 싶은 경우 화면을 통해 신규 Rule을 설정한다. 신규 Rule 설정 및 Rule 삭제의 편의성을 제공하기 위해 검색기능을 제공한다. 전체 Application에 적용되는 Server속성은 에러페이지로 처리할 수 있다

Figure 73. Rule Setting 화면

Rule 목록의 Use 컬럼은 해당 Rule이 Application Server에 적용되어 있는지 여부를 나타낸다.

Rule 추가 시 설정 가능한 속성은 아래와 같다.

Table 180. Rule 추가 시 설정 가능한 속성
항목(*는 필수값)	설명	비고
Rule Name(*)	추가하는 Rule의 이름
Description	추가하는 Rule에 대한 설명
Rule Type	제어할 단위	IP, URL
Allow IP(*)	허가할 요청 IP	정규식 형태로 입력 가능
Deny IP(*)	거부할 요청 IP	정규식 형태로 입력 가능
Control Time(*)	Rule을 적용할 시간단위
Error Message(HTML)(*)	제어로 인해 Filtering된 요청에 대한 출력할 에러 페이지

제어유형이 "IP with DateTime"인 Rule에 Proxy Server로 중계되는 Application Server 를 적용한다면, Proxy Server의 보안적 특성으로 인해 User IP를 구할 수 없어 Rule 적용이 되지 않을 수 있다.

생성된 Rule 중 적용된 Rule은 삭제 할 수 없다.

9.3.2. Rule Applying (Rule 적용)

추가된 Rule 중 하나를 선택하여 Application Server에 적용한다. 적용 편의성을 위해 Rule유형, 적용단위, Rule명에 대한 검색기능을 제공한다.

Rule 목록에서 하나를 선택하여 Rule 적용에서 셔플 버튼 들을 이용하여 적용 대상을 선택하고, On/Off 버튼 을 클릭하여 적용 및 저장한다. 적용 대상에서 제외를 하고 싶을 경우에도 셔플 버튼 들을 이용하여 제외시킨다.

Figure 74. Rule Applying 화면

Rule 현황 및 적용 화면에서 사용되는 속성들은 Rule설정 화면과 유사하며 아래의 속성들은 추가적인 속성들이다.

Table 181. 추가적인 속성
항목	설명	비고
Node Name	등록된 System 하위의 Node 명
Server Name	등록된 Node 하위의 Server 명

선택한 Rule에 신규 대상이 추가될 경우 적용 단위에 따라 server.xml 혹은 context.xml 에 추가되고, 적용된 대상에서 제외할 경우 위의 설정 파일에 추가된 Rule 설정이 삭제된다.

9.3.3. Service Control Log (Rule 적용결과 조회)

Rule이 적용된 항목들에 대한 처리 결과가 목록으로 출력된다. 처리 결과 확인의 편의성을 위해 Rule유형, 적용단위, Rule명, 로그시간에 대한 검색기능을 제공한다.

Figure 75. Service Control Log 화면

처리 목록에서 사용되는 속성들은 아래와 같다.

Table 182. 로그 정보의 항목
항목	설명	비고
Controlled Date	Rule설정이 적용된 요청의 처리시간
Address	처리된 원격지 주소
Request URL	처리된 요청의 URL
HTTP Method	처리된 요청의 HTTP Method
Rule Name	요청을 처리하는데 적용된 Rule 이름

Rule 이력의 경우 Manager의 /conf/manager.conf 설정파일 내 access filter log 취합 Listener 사용여부를 true로 설정해야 한다. Log의 경우 각 서버의 logs 폴더 내 access_filter.log."날짜".txt 파일에 기록되며 주기적으로 Manager 가 각 server 의 log 를 취합하여 Database 에 저장한다. (이때 취합된 Log 는 access_filter_log."날짜".txt.gathered 파일에 backup된다) Database에 취합된 Log는 처리목록 화면에서 확인 가능하다.

manager.conf 내 설정 파일 항목의 설정 예는 아래와 같다.

#access filter log 취합 리스너 사용여부 및 동작주기(초) default는 false, 60
accessfilter.listener=false
accessfilter.interval=60

9.4. Notification 설정

Manager에 표시할 Notification과 Notifcation을 연동할 SNS정보를 설정할 수 있다.

9.4.1. Manager Notification

Manager Notification 메뉴를 열면 현재 활성화 되어있는 Notification을 확인할 수 있으며, Level은 Critical, Warning, Info으로 구분된다.

Notification의 체크박스를 해제하고 Save할 경우 Notification이 발생하여도 종모양 아이콘에 표시되지 않는다.

아이콘에 표시되지 않는 Notification은 종모양 아이콘을 클릭하여 나타나는 팝업의 우측상단의 Notification Detail 버튼을 클릭하여 확인할 수 있다.

9.4.2. SNS Notification

Manager에서 발생하는 Notification을 연동할 SNS정보를 관리할 수 있다.

WebHook 기반으로 동작하며, System 단위로 SNS와 연동이 가능하다.

Table 183. 연동할 SNS의 상세 정보 항목
항목	설명
Name	사용자가 지정한 이름
System	연동할 System의 이름
DuplicateTime(s)	동일한 Notification이 연속으로 DuplicateTime(s)이내에 발생한 경우 SNS로 연동을 하지 않음.
Request	요청을 보낼 Method
Encoding	요청의 Encoding
Header	요청의 Header를 입력할 수 있으며 여러 개의 Header를 사용할 경우 개행으로 구분함.
Body	요청의 Body를 입력할 수 있으며 치환되는 파라미터는 다음과 같음. ${alarmLevel} - 발생한 알림의 Level, ${message} - 메세지 내용
Webhook URL	요청을 보낼 URL
SSL	SSL인증 여부

Table 184. SNS로 연동할 Notification의 종류
항목	설명
AUDIT	서버의 Audit 설정에서 지정한 항목에서 Notification이 발생한 경우
DIAGNOSTICS	서버에 설정한 DIAGNOSTICS Rule에 위배되는 Notification이 발생한 경우
LICENSE	LICENSE 관련 Notification이 발생한 경우
INFO	서버의 정보에 관련 Notification이 발생한 경우

설정 항목을 입력한 후 Test 버튼을 통해 해당 요청이 정상작동 하는지 확인할 수 있다.

Test에 성공한 경우 Save를 통해 저장한 후, 항목의 on/off 토글을 on으로 설정하여 연동이 가능하다.

9.5. Patch

설치된 LENA에 대한 기능 개선 및 버그 수정을 위한 패치를 제공한다.

Patch는 압축파일 형태로 제공되며, 독립적으로 동작하는 Java프로세스로 동작한다.

Patch 기능은 CLI 및 Management UI를 통하여 실행이 가능하며, 패치 시 서비스에 문제가 발생하는 경우 Restore 기능을 통하여 원복 할 수 있다.

패치 순서는 다음과 같다.

패치파일 업로드
Manager 패치 적용
Node 패치 적용
서버(Application Server, Session Server) 패치 적용
패치 Commit

복구 순서는 다음과 같다.

서버 패치 복구
Node 패치 복구
Manager 패치 복구
복구 Commit

CLI로 패치하는 방식은 Appendix를 참고한다.

9.5.1. Overview

패치파일의 업로드 기능을 제공하며, Manager와 각 Node별 Node Agent의 패치 반영상태 정보를 조회한다.

Patch 파일 업로드

Patch Info 영역에서는 매니저에 업로드 된 패치파일 중, 최상위 버전의 상세정보를 표시한다.

Table 185. Patch Info 항목
항목	설명	비고
Patch File Ver.	패치파일의 버전 정보
Release Date	패치파일의 배포 일자
Patch Note	상세(노트) 버튼 을 눌러 상세한 패치노트 내용을 조회한다.	패치노트 팝업표시

패치파일을 업로드하는 과정은 다음과 같다.

패치 대상 엔진 타입을 선택한다.

Table 186. 엔진 타입별 패치 파일
엔진 타입	설명	패치 파일 접두사
Manager & Agent	Manager/Node Agent 패치	LENA-*
WAS	Application Server 패치	EN7-, EN8-, EN9-, EN10-
Session Server	Session Server 패치	ENZ-EN7-, ENZ-EN8-, ENZ-EN9-, ENZ-EN10-
WEB Server	Web Server 패치	ENA-* , ENN-*

선택한 엔진 타입과 일치하지 않는 패치 파일을 업로드하면 오류가 발생한다.

업로드 버튼 을 클릭한다.

패치 가능 상태인지를 확인 후 정상이면 패치파일 업로드를 위한 팝업을 띄운다

패치 가능 상태 조건

Manager에 등록된 Node가 모두 기동상태여야한다.
patch가 commit상태여야 한다.
manager 기준으로 node와 server가 모두 같은 버전이어야 한다.
manager에 등록되지 않은 서버가 존재하지 않는다.
1. unregister된 서버존재시 manager에 등록
2. 노드엔진 하위 servers폴더에 서버가 존재시 해당 폴더 삭제

업로드 할 패치파일을 선택하면 자동으로 업로드가 실행된다.

업로드 가능한 파일은 zip과 tar.gz이며 이외의 파일을 업로드 할 경우 에러메시지가 출력된다.

Manager Patch

Manager Info 영역에서는 Manager의 패치상태를 표시하고, Manager의 패치 및 복구를 실행할 수 있다.

화면에 표시되는 각 항목에 대한 설명은 아래와 같다.

Table 187. Manager Info 항목
항목	설명	비고
Patch Status	Manager의 패치 적용 상태 해 아이콘 : Manager가 최신패치를 적용한(up to date) 상태 구름 아이콘 : Manager가 최신 패치를 적용하지 않은(patch available) 상태
Current Ver.	Manager의 현재 버전
Patch Ver.	Patch 버전
History	Patch history를 조회하는 버튼	Handwork 작업이 필요시, 상세(노트) 버튼 은 붉은색으로 표시된다.

Manager Info화면의 History 항목에 표시된 상세(노트) 버튼 을 클릭하면 팝업창을 통해 패치 실행 이력을 확인할 수 있다.

화면에 표시되는 각 항목에 대한 설명은 아래와 같다.

Table 188. History 항목
항목	설명	비고
Action	패치/복원 이력을 표시
Patch Version	패치/복원을 수행한 패치파일의 버전
Pervious Version	패치/복원을 적용하기 이전의 서버버전
Timestamp	패치/복원을 적용한 시간
Log/Handwork	상세(노트) 버튼 선택시 실행 결과 로그를 제공한다. 수작업(스페너) 버튼 선택시 Handwork(추가적으로 필요한 수작업) 내용을 제공한다. Handwork 작업 필요시 해당 버튼은 붉은색으로 표시된다.

Patch

Manager Info 하단에 있는 Patch 버튼 을 클릭하면 최신 패치를 적용한다.

Handwork에 기술된 내용 패치실행 후 필요한 수작업이므로, 기술된 내용을 실행하여 반영하여야 한다. Handwork 작업 후 팝업창 하단의 체크박스를 해제하면 Manager Patch Info화면의 Handwork 버튼 이 흰색으로 변경된다.

Manager 패치를 적용하면 Node와 Server의 패치 적용 후 Commit 버튼 을 누르기 전까지 Node의 설치/등록, Server의 설치/등록/복제 등의 기능을 수행 할 수 없다.

패치 후 반드시 브라우저 캐시를 삭제하여야 패치버전의 Manager를 사용할 수 있다.

Rollback

Manager Info 하단에 있는 Rollback 버튼 을 클릭하면 패치 이전 버전으로 복구된다.

기존 Restore 버튼이 Rollback으로 명칭이 변경되었다.

복구는 Manager에 등록된 모든 노드의 패치 상태가 Patch Available 인 경우에 수행한다.

Commit

Manager, Node, Server의 모든 패치를 적용 후 Commit버튼 을 눌러 확정한다. 확정 이후에는 이전버전으로 되돌릴 수 없다.

Node Patch

Node Patch Status 영역은 매니저에 등록된 node에 대해서, 최신패치가 적용된 서버의 개수와 패치가 적용되지 않은 서버의 개수를 종합해서 보여준다.

화면에 표시되는 각 항목에 대한 설명은 아래와 같다

Table 189. Node Patch Status 항목
항목	설명	비고
Status	node의 패치 적용 상태 해 아이콘 : 모든 서버가 최신패치를 적용한(up to date) 상태 구름 아이콘 : Node Agent가 최신 패치를 적용하지 않은(patch available) 상태 반구 아이콘 : Node Agent는 최신 패치를 적용하였으나, Node 에 설치된 Server에는 최신 패치가 적용되지 않은 상태 느낌표 아이콘 : Node agent가 lena-manager와 호환이 되지 않는 상태.
Node name	node명
Address	node의 IP
Node Ver.	Node의 현재 버전
Node Hotfix.	Node의 Hotfix 버전
History	Patch history를 조회하는 버튼	Handwork 작업이 필요시, 상세(노트) 버튼 은 붉은색으로 표시된다.
WAS	Web Application Server의 패치상태 정보 Up To Date : 최신패치가 적용된 서버의 개수 Patch Available : 최신패치가 적용되지 않은 서버의 개수
Session Server	Session Server의 패치상태 정보 Up To Date : 최신패치가 적용된 서버의 개수 Patch Available : 최신패치가 적용되지 않은 서버의 개수

Node Patch 버튼 을 클릭하면 제공되는 팝업창에서 Node 선택 후 해당 Node에 대한 패치 또는 복구를 진행 할 수 있다.

Window OS 환경에 설치되어 있는 Node는 Manager가 아닌 CLI를 통해 패치를 수행한다.

Server Cluster Patch Status

Server Cluster 별 Patch 현황을 표시한다.

화면에 표시되는 각 항목에 대한 설명은 다음과 같다.

Table 190. Server Cluster Patch Status 항목
항목	설명	비고
Status	cluster의 패치 적용 상태 해 아이콘 : 모든 서버가 최신패치를 적용한(up to date) 상태 구름 아이콘 : 일부 서버가 최신 패치를 적용하지 않은(patch available) 상태
Cluster Group	cluster그룹명
Cluster Name	cluster이름
LENA Patch	Application Server의 패치상태 정보 Up To Date : 최신패치가 적용된 서버의 개수 Patch Available : 최신패치가 적용되지 않은 서버의 개수

9.5.2. WAS

Node/Cluster에 포함된 Application Server에 대해서, 매니저에 업로드 된 최신 패치파일로 패치를 진행하며, 문제발생시 패치 적용 바로 전의 상태로 복원할 수 있는 기능을 제공한다.

패치를 적용할 서버를 그룹별 조건(node단위, cluster 단위)으로 검색한다.

Table 191. Application Server Patch Status 항목
항목	설명	비고
Patch Status	Application Server의 패치 적용 상태 해 아이콘 : 최신패치가 적용된(up to date) 상태 구름 아이콘 : 최신패치를 적용할 수 있는(patch available) 상태
Node	Application Server가 설치되어있는 Node명
Name	Application Server 이름
Type	Application 서버 타입 Standard : Application Server Standard Edition Enterprise : Application Server Enterprise Edition
Address	Application Server가 설치된 Node의 IP
HTTP Port	Application Server의 HTTP Connector port
AJP Port	Application Server의 AJP Connector port
Start/Stop	Application Server의 기동 및 중지 실행
Current Version	Application Server의 현재 설치된 버전정보
Hotfix	Hotfix 버전 정보
Patch Version	패치를 적용할 버전정보. 최신패치가 적용 된 상태일 경우 ‘N/A’로 표시된다.	매니저에 upload된 최신 패치버전
History	Server에 적용한 patch/restore의 이력정보조회

Node Agent process kill 등의 이유로 동작이 정상적이지 않을 경우는, 해당 node의 Server 정보는 조회되지 않는다.

Patch

패치적용 전 서버의 중지상태를 확인하고(Start 버튼 활성화된 상태), 중지상태가 아닐 경우 Stop 버튼 을 클릭하여 서버를 중지시킨다.
패치를 적용할 서버의 체크박스를 체크한다.(복수 체크 가능)
Patch 버튼 을 클릭하여 패치를 진행한다. 이때 로그 팝업이 뜨게 되며 패치종료 후 수작업을 진행해야 할 사항이 있을 경우 Handwork 컬럼에 수작업(스페너) 버튼 이 붉은색으로 표기된다.
로그 팝업을 닫으면 서버의 patch status 상태가 해 아이콘 으로 변경되고, current ver., patch ver.에는 각각 적용한 현재패치버전과 N/A가 표시된다.
Validation
1. 서버가 기동상태일 때는 패치 적용 불가
2. 이미 최신 패치가 적용된 서버에 다시 패치를 적용 불가

서버에 패치적용 시 해당 Node에 패치를 처음 적용할 경우, 내부적으로 해당 Node의 패치를 먼저 진행 한 뒤에 서버패치를 진행하게 된다.

Restore

복구적용 전 서버의 중지상태를 확인하고(Start 버튼 활성화된 상태), 중지상태가 아닐 경우 Stop 버튼 을 클릭하여 서버를 중지시킨다.
복원을 적용할 서버의 체크박스를 체크한다.(복수 체크 가능)
Restore 버튼 을 클릭하여 복구를 진행한다. 이때 로그 팝업이 뜨게 된다.
로그 팝업을 닫으면 서버의 patch status 상태가 구름 아이콘 으로 변경되고, current ver., patch ver.에는 각각 이전 버전과 패치파일버전이 표시된다.
Validation
1. 서버가 기동상태일 때 복원을 적용 불가
2. 복원을 한 뒤에, 다시 복원은 불가(매니저를 통한 복원은 1단계만 지원한다.)

서버에 복원 진행 후 Node에 패치가 적용된 서버가 하나도 없을 경우, 내부적으로 해당 Node의 복원도 함께 진행한다.

이력조회

상세(노트) 버튼 을 클릭하여 패치/복원에 대한 이력을 가장 최근의 이력부터 5개를 조회한다.

Table 192. History 항목
항목	설명	비고
Action	패치/복원 이력을 표시
Patch Version	패치/복원을 수행한 패치파일의 버전
Previous Version	패치/복원을 적용하기 이전의 서버버전
Timestamp	패치/복원을 적용한 시간
Log/Handwork	상세(노트) 버튼 선택시 실행 결과 로그를 제공한다. 수작업(스페너) 버튼 선택시 Handwork(추가적으로 필요한 수작업) 내용을 제공한다. Handwork 작업 필요시 해당 버튼은 붉은색으로 표시된다.

9.5.3. Session Server

Session Server들에 대해서, 매니저에 업로드 된 최신 패치파일로 패치를 진행하며, 문제발생시 패치 적용 바로 전의 상태로 복원할 수 있는 기능을 제공한다.

패치를 적용할 서버를 그룹별 조건(node단위)으로 검색한다.

Table 193. Session Server Patch Status 항목
항목	설명	비고
Patch Status	Session Server의 패치 적용 상태 해 아이콘 : 최신패치가 적용된(up to date) 상태 구름 아이콘 : 최신패치를 적용할 수 있는(patch available) 상태
Node	Session Server가 설치되어있는 Node명
Name	Session Server 이름
Type	Session 서버 타입
Address	Session Server의 주소
Port	Session Server의 port
Start/Stop	Session Server의 기동 및 중지 실행
Current Version	Session Server의 현재 설치된 버전정보
Hotfix	Hotfix 버전 정보
Patch Version	패치를 적용할 버전정보. 최신패치가 적용 된 상태일 경우 ‘N/A’로 표시된다.	매니저에 upload된 최신 패치버전
History	Server에 적용한 patch/restore의 이력정보조회

Node Agent process kill 등의 이유로 동작이 정상적이지 않을 경우는, 해당 node의 Server 정보는 조회되지 않는다.

Patch

패치적용 전 서버의 중지상태를 확인하고(Start 버튼 활성화된 상태), 중지상태가 아닐 경우 Stop 버튼 을 클릭하여 서버를 중지시킨다.
패치를 적용할 서버의 체크박스를 체크한다.(복수 체크 가능)
Patch 버튼 을 클릭하여 패치를 진행한다. 이때 로그 팝업이 뜨게 되며 패치종료 후 수작업을 진행해야 할 사항이 있을 경우 Handwork 컬럼에 수작업(스페너) 버튼 이 붉은색으로 표기된다.
로그 팝업을 닫으면 서버의 patch status 상태가 해 아이콘 으로 변경되고, current ver., patch ver.에는 각각 적용한 현재패치버전과 N/A가 표시된다.
Validation
1. 서버가 기동상태일 때는 패치 적용 불가
2. 이미 최신 패치가 적용된 서버에 다시 패치를 적용 불가

서버에 패치적용 시 해당 Node에 패치를 처음 적용할 경우, 내부적으로 해당 Node의 패치를 먼저 진행 한 뒤에 서버패치를 진행하게 된다.

Restore

복구적용 전 서버의 중지상태를 확인하고(Start 버튼 활성화된 상태), 중지상태가 아닐 경우 Stop 버튼 을 클릭하여 서버를 중지시킨다.
복원을 적용할 서버의 체크박스를 체크한다.(복수 체크 가능)
Restore 버튼 을 클릭하여 복구를 진행한다. 이때 로그 팝업이 뜨게 된다.
로그 팝업을 닫으면 서버의 patch status 상태가 구름 아이콘 으로 변경되고, current ver., patch ver.에는 각각 이전 버전과 패치파일버전이 표시된다.
Validation
1. 서버가 기동상태일 때 복원을 적용 불가
2. 복원을 한 뒤에, 다시 복원은 불가(매니저를 통한 복원은 1단계만 지원한다.)

서버에 복원 진행 후 Node에 패치가 적용된 서버가 하나도 없을 경우, 내부적으로 해당 Node의 복원도 함께 진행한다.

이력조회

상세(노트) 버튼 을 클릭하여 패치/복원에 대한 이력을 가장 최근의 이력부터 5개를 조회한다.

Table 194. History 항목
항목	설명	비고
Action	패치/복원 이력을 표시
Patch Version	패치/복원을 수행한 패치파일의 버전
Previous Version	패치/복원을 적용하기 이전의 서버버전
Timestamp	패치/복원을 적용한 시간
Log/Handwork	상세(노트) 버튼 선택시 실행 결과 로그를 제공한다. 수작업(스페너) 버튼 선택시 Handwork(추가적으로 필요한 수작업) 내용을 제공한다. Handwork 작업 필요시 해당 버튼은 붉은색으로 표시된다.

9.6. Preferences

9.6.1. Action Trace

Manager를 통해 각 사용자가 수행하는 추가/수정/삭제 작업의 수행 이력은 로그로 남는다. Action Trace에서는 이러한 수행이력을 조회/추적하는 기능을 제공한다.

Figure 76. Action Trace 화면

이력 조회

조회 조건을 입력 후 클릭하면 이력을 조회할 수 있다. 목록 중 하나를 선택하면 상세정보도 확인할 수 있다.

조회 화면에 표기되는 항목은 아래와 같다.

Table 195. 이력 상세 정보 항목
항목	설명	비고
Trace Date	Action을 수행한 시간
Status	Action 수행 결과	성공 : Success, 실패 : Fail
Client IP	Action을 수행한 사용자의 IP 주소
User ID	Action을 수행한 사용자 ID
Action	수행한 활동(Action) 명
Method	Action에 사용된 Method 이름
Request	LENA Manager HTTP Request URL
Input	Http Request Input 파라미터

위 항목 중 "Input" 은 Request 파라미터를 그대로 저장하기 때문에, Server ID, Node ID, Server Cluster ID가 데이터 관리용 Key값 (일련번호, 캡쳐화면에서 "serverID=31"로 표시된 부분)으로 보여진다. 해당 Server/Node/Cluster의 상세정보를 조회하기 위해서는 "Action Trace Detail" 정보 하단에 있는 "Search ID" 기능을 활용한다. 이 기능의 입출력 항목은 아래와 같다.

Table 196. Search ID 기능의 입출력 항목
항목	설명	비고
ID	좌측 Combo : serverId / nodeId / serverClusterId 중 택일 우측 : Input 에 있는 ID 값을 입력	입력항목
Data	검색된 Server/Node/Cluster 정보	출력항목

9.6.2. Documentation

LENA 소개자료와 매뉴얼을 다운로드 받을 수 있다.

9.6.3. Manager Environment

Manager 환경 설정을 위한 정보를 제공한다.

Manager Environment

Manager 환경 설정 정보 중 env-manager.sh/bat에 저장하는 정보를 제공한다.

Manager Allow IPs : Manager에 접근 가능한 IP항목을 설정한다.
Java Home Path : Manager에서 사용하는 java home 경로를 설정한다.

Manager Configuration

Manager 환경 설정 정보 중 manager.conf에 저장하는 정보를 제공한다.

기본적으로 제공하는 2가지 항목을 제공한다.

use JMX for Server Status : JMX를 통해 서버 상태 정보를 조회할지 여부(default : false)

Table 197. JMX for Server Status: true 사용시 WAS Status 표시
Status	Status 명	설명
	Started	WAS 및 Application 모두 정상 기동 상태
	Started(Warning)	WAS 정상 기동, Application 일부(또는 전체) 기동 안 된 상태
	Stopped	WAS 중지 상태
	Error	WAS Status 확인 불가 상태

use Server Delete Protection : Manager에서 서버 삭제 기능 사용금지 여부(default : false)

화면 우측의 설정 버튼 을 클릭하면 상세 정보를 확인 및 변경 할 수 있다.

OpenID Connect Configuration

OpenID Connect 표준을 따르는 OpenID Provider 를 통한 로그인 기능을 설정한다. Enable 하면, 로그인 화면에서 OpenID Connect Toggle 버튼을 확인할 수 있다.

항목

설명

비고

Enable

OpenID Connect 로그인 기능 활성화 여부

Enable Auto User Creation

인증 제공자에서 인증에 성공했으나, LENA 에 해당 계정인 존재하지 않는경우, 계정생성 여부

Provider

인증 제공자

Grant Type

client 가 토큰을 요청하는 방법

authorization_code, password

Client ID

OpenID Connect 클라이언트 애플리케이션에 대한 고유 식별자

Client Secret

클라이언트 애플리케이션과 인증 서버 간 인증에 사용되는 비밀 키.

Key for Login

LENA Manager User ID 와 맵핑되는 UserInfo 의 키 명.

Authorization URL

사용자가 인증을 위해 인증 제공자로 리다이렉트 할때 사용되는 URL

Redirect URL

인증 제공자에서 로그인 후, Manager 로 리다이렉트 할때 사용되는 URL

Token URL

인증 제공자에 토큰을 요청할때 사용되는 URL

Userinfo URL

인증 제공자에 사용자정보를 요청할때 사용되는 URL

End Session URL

인증 제공자에 세션종료를 요청할때 사용되는 URL

Metadata Refresh

Topology 메뉴에서 시스템 별 구성정보를 topology 차트로 그리기 위해 사용되는 메타데이터의 정합성 검증 및 복원 기능을 수행한다.

Reset manager address of all registered nodes

Manager에 등록된 노드들에게 변경된 Manager Address를 일괄적으로 변경시켜주는 기능을 제공한다.

Operation Verification

서버 시작/중지 작업의 상태를 실시간으로 추적하고 검증하는 기능을 제공한다. SSE(Server-Sent Events)를 통해 UI에 실시간 상태 업데이트를 제공하며, 작업 완료 여부를 자동으로 검증한다.

항목

설명

기본값

operation.system.enabled

Operation 시스템 활성화 여부. false로 설정 시 레거시 모드로 동작하며, 모든 Operation API가 비활성화됨

true

operation.verification.enabled

작업 검증 기능 전체 활성화 여부

false

operation.verification.enabled.was

WAS 서버에 대한 작업 검증 활성화 여부

true

operation.verification.enabled.web

Web 서버에 대한 작업 검증 활성화 여부

false

operation.verification.enabled.cache

Cache 서버에 대한 작업 검증 활성화 여부

false

operation.verification.pollIntervalMs

서버 상태 확인 주기(ms). 낮은 값일수록 상태 변화 감지가 빠름

5000

operation.verification.requiredConsecutive

작업 완료 판정에 필요한 연속 성공 횟수. 1은 빠른 응답, 2 이상은 안정성 향상

operation.verification.maxConsecutiveFailures

작업 실패 판정을 위한 연속 실패 횟수. 0은 무제한 재시도(타임아웃까지)

operation.verification.timeout.startSec

서버 시작 작업의 타임아웃(초). 0 또는 음수는 무제한

300

operation.verification.timeout.stopSec

서버 중지 작업의 타임아웃(초). 정상적인 종료를 위해 충분한 시간 필요

600

operation.verification.broadcastThrottleMs

SSE 진행 상태 이벤트 브로드캐스트 최소 간격(ms). SUCCEEDED/FAILED 이벤트는 항상 즉시 전송됨

3000

operation.stale.maxAgeMs

오래된 작업 자동 정리 시간(ms). 기본값은 24시간

86400000

Operation Verification 기능은 서버 시작/중지 시 UI에서 실시간 상태를 확인할 수 있게 해주며, 작업이 정상적으로 완료되었는지 자동으로 검증한다.

UI Polling Configuration

Manager UI의 서버 상태 폴링 주기를 설정한다.

항목

설명

기본값

ui.polling.server.status.interval

일반 서버 상태 폴링 주기(ms). 높은 값은 시스템 부하를 줄이지만 UI 업데이트가 느려짐. 반응성 향상: 10000-15000 권장

20000

ui.polling.active.operation.interval

활성 작업 모니터링 폴링 주기(ms). SSE가 지연될 때 fallback으로 동작. 반응성 향상: 2000-3000 권장

5000

ui.polling.intensive.stop.interval

서버 중지 중 집중 폴링 주기(ms). 서버가 중지되는 동안 빠른 상태 확인 수행. 반응성 향상: 1000-2000 권장

3000

User History Management

사용자 활동 이력을 파일로 기록하는 기능을 설정한다.

항목

설명

기본값

userHistory.enabled

사용자 이력 로깅 활성화 여부

false

userHistory.filePath

사용자 이력 로그 파일 경로

./logs/user-history

userHistory.retentionDays

사용자 이력 로그 파일 보관 일수

365

Server Status Display Configuration

서버 상태 표시 관련 설정을 제공한다.

항목

설명

기본값

serverstatus.statename.enable

서버 상태명 표시 활성화 여부

false

serverstatus.request.interval

서버 상태 요청 간격(ms). 0은 기본 간격 사용

SSH Terminal Configuration

Node Agent SSH Terminal 기능의 보안 및 동작 설정을 제공한다.

항목

설명

기본값

ssh.enabled

Node Agent 페이지에서 SSH Terminal 버튼 표시 여부

true

ssh.cmdCheck.mode.isWhiteList

명령어 필터링 모드. true는 화이트리스트 모드, false는 블랙리스트 모드

true

ssh.cmdCheck.idleTimeout

미사용 시 연결 종료 시간(초). 최소 30초 이상 설정 필요

600

ssh.cmdCheck.whitelist.view

화이트리스트 모드에서 허용할 view 계열 명령어

view

ssh.cmdCheck.whitelist

화이트리스트 모드에서 허용할 일반 명령어 목록

cd,clear,echo,ll,ls,ps,tail,exit

ssh.cmdCheck.blacklist

블랙리스트 모드에서 차단할 명령어 목록

alias,chmod,chown,cp,dd,export,rm,mkdir,mv,kill,sed,source,sudo,touch,vi

SSH Terminal은 보안상 민감한 기능이므로, 운영 환경에서는 화이트리스트 모드를 사용하고 허용할 명령어를 최소화하는 것을 권장한다.

Server Log Viewer Configuration

서버 로그 뷰어 기능의 설정을 제공한다.

항목

설명

기본값

logViewer.readRowSize

한 번에 읽어올 로그 라인 수 (최대: 10000)

1000

logViewer.filter.enable

로그 뷰어에서 표시할 파일 필터링 활성화 여부

true

logViewer.filter.fileExtensionsToShow

로그 뷰어에서 표시할 파일 확장자 목록

log,txt

Node Agent Call Timeout Configuration

Manager와 Node Agent 간 통신 타임아웃 설정을 제공한다.

항목

설명

기본값

nodeAgent.connectionTimeout

Node Agent 연결 타임아웃(ms). 모든 Manager-Node Agent 연결에 적용

1000

agent.timeout.default

기본 타임아웃(초)

agent.timeout.serverControl

서버 시작/중지 타임아웃(초)

agent.timeout.fileTransfer

Application, JDBC Driver, SSL 인증서 파일 전송 타임아웃(초)

agent.timeout.wasApplicationControl

Application deploy/undeploy/start/stop 타임아웃(초)

300

agent.timeout.dumpFileGenerate

Heap/Thread/Active Service dump 생성 타임아웃(초)

agent.timeout.sessionStatus

세션 상태 정보 조회 타임아웃(초)

agent.timeout.serverClusterSnapshotCreate

Server Cluster 스냅샷 생성 타임아웃(초)

300

Multi Server Control Restriction

복수 서버 동시 제어 시 제한 설정을 제공한다.

항목

설명

기본값

server.start.maxCountOfNode

노드당 동시 시작 가능한 최대 서버 수. 0은 제한 없음

server.start.interval

서버 순차 시작 간격(ms). 0은 즉시 시작

server.restart.killDelay

재시작 시 kill 후 대기 시간(초)

9.7. Encryption (민감정보 암호화)

DB 비밀번호, API 키 등 설정값을 암호화하여 `lena-security.properties`에 보관하고, WAS 기동 시 자동으로 복호화하여 애플리케이션에 주입하는 보안 기능이다.

접근 경로: ADMIN > Encryption

암호화 기능은 두 가지 메뉴로 구성된다.

메뉴 설명

Key Management

Seed Key 생성·배포·교체 관리

Encryption Tools

노드별 lena-security.properties 편집 및 값 암호화

9.7.1. Key Management

Seed Key의 생성·배포·교체를 관리한다. Seed Key는 모든 암호화 값의 복호화에 사용되는 마스터 키이다.

Figure 77. Key Management 화면

화면은 두 섹션으로 구성된다.

섹션

설명

Seed Key Status

Manager에 생성된 Seed Key 존재 여부와 상태 표시

Node Sync Status

등록된 노드별 Key 배포 상태 테이블

Node Sync Status 테이블에 표시되는 항목은 아래와 같다.

Table 198. Node Sync Status 항목
항목	설명	비고
Status	노드 온라인 상태 아이콘
Node Name	노드 이름
Node IP	노드 서버 IP
Agent Port	LENA Agent 포트
Engine	LENA Engine 버전	EN-7, EN-9 등
Key Status	노드에 배포된 Seed Key 상태	Synced: 최신 Seed Key가 배포되어 있음 Outdated: Seed Key가 배포되어 있지만 최신이 아님 Not Deployed: Seed Key가 한 번도 배포되지 않음 -: Seed Key 자체가 존재하지 않음 (미생성)

Seed Key 생성 (Generate Key)

최초 1회 또는 키 교체 전 신규 키를 생성할 때 수행한다.

Key Management 화면에서 Generate Key 버튼을 클릭한다.
확인 다이얼로그에서 OK 를 클릭한다.
Seed Key Status 섹션에서 상태가 Active로 변경됨을 확인한다.

Generate Key 실행 후 노드에 자동 배포되지 않는다. 반드시 아래 배포 절차를 이어서 진행한다.

Seed Key 노드 배포 (Deploy Key)

생성된 Seed Key를 각 노드에 배포한다. 배포가 완료되어야 해당 노드에서 암호화·복호화가 동작한다.

Node Sync Status 테이블에서 배포할 노드의 체크박스를 선택한다.
- 전체 배포: 테이블 헤더 체크박스 선택
- 선택 배포: 개별 노드 체크박스 선택
Deploy Key 버튼을 클릭한다.
확인 모달에서 대상 노드를 확인한 후 Deploy 를 클릭한다.
- Synced 상태의 노드는 재배포가 차단된다.
- Outdated 상태의 노드는 동의 모달 확인 후 진행된다.
Close 클릭 후 Node Sync Status 테이블에서 Key Status = Synced 를 확인한다.

Seed Key 교체 (Rotate Key Wizard)

보안 정책에 따라 주기적으로 Seed Key를 교체할 때 사용한다. 기존 암호화된 값을 새 키로 자동 재암호화한다.

Rotate Key Wizard는 5단계로 구성된다.

Table 199. Rotate Key Wizard 단계
단계	이름	설명
1	Generate New Key	새 Seed Key 생성
2	Scan Properties	노드별 암호화 프로퍼티 파일 스캔
3	Preview Changes	스캔 결과 요약 확인 후 실행 여부 결정
4	Re-encrypt & Deploy	새 키로 재암호화 후 노드 배포
5	Result	성공/실패 결과 표시

Rotate Key 버튼을 클릭한다.
로그인 비밀번호를 입력하고 Confirm 을 클릭한다.
Step 1에서 Generate Key 를 클릭한다.
Step 2, 3이 자동 진행된다. Step 3에서 스캔 결과를 확인하고 Execute 를 클릭한다.
Step 5에서 결과를 확인하고 Close 를 클릭한다.

사전 조건: 모든 노드 Key Status = Synced

9.7.2. Encryption Tools

노드별 lena-security.properties 파일을 편집하고, 평문 값을 {ENC:AES256} 형태로 암호화하여 배포하는 기능이다.

Figure 78. Encryption Tools 화면

화면은 두 영역으로 구성된다.

영역 설명

좌측 트리

노드 > 인스턴스 계층 구조. 클릭 시 해당 파일 로드

우측 에디터

선택한 인스턴스의 lena-security.properties 내용 표시

에디터는 읽기 전용 모드와 편집 모드 두 가지 상태로 동작한다.

상태

표시

버튼

읽기 전용

주황색 텍스트

Edit

편집 모드

검정 텍스트 + 라인별 체크박스

Encrypt Selected / Save & Deploy

프로퍼티 값 암호화 및 배포

평문 값을 {ENC:AES256}… 형태로 암호화하고 노드에 배포한다.

좌측 트리에서 대상 인스턴스를 클릭하여 에디터에 파일 내용을 로드한다.
- Global: 노드 전체에 적용되는 공통 프로퍼티
- 인스턴스명: 해당 인스턴스에만 적용되는 프로퍼티
Edit 버튼을 클릭해 편집 모드로 전환한다.
MANAGED SECTION 위 빈 영역에 암호화할 프로퍼티를 입력한다.
암호화할 라인의 체크박스를 선택하고 Encrypt Selected 를 클릭한다.
Save & Deploy 를 클릭한다.
Review Changes 모달에서 변경 내용을 확인하고 Confirm & Deploy 를 클릭한다.

MANAGED SECTION 내 항목은 자동 관리 영역이므로 직접 편집하지 않는다.

10. Appendix

10.1. LENA 시스템 요구사항

LENA를 설치하고 사용하기 위한 최소 요구사항은 다음과 같다.

구분

JVM

CPU

Memory

Disk

Support OS

비고

기본 설치 패키지

JDK 1.8 이상

2 Core 이상

4 GB 이상

root를 제외한 용량 10GB 이상

Linux (centos7 이상) 또는 Windows 7이상

각 구성요소 설치 파일 제공

10.2. Manager 지원 브라우저

Manager의 기능을 사용할 수 있는 브라우저로는 Chrome/Edge(버전 70 이상), Firefox(버전 62 이상) 이 있다. IE의 경우 일부기능이 정상적으로 동작하지 않기 때문에 다른 브라우저를 사용하기를 권장한다. 브라우저 권장 최소 사이즈는 1680*900 이다.

10.3. 지원 Spec별 버전

Specification	Version	비고
Java Development Kit (JDK)	1.8~
Java Servlet	3.1
Java Server Pages (JSP)	2.3
Expression Language (EL)	2.2
JavaServer Pages Standard Tag Library (JSTL)	1.2
Enterprise JavaBeans (EJB)	3.2
Java Message Service (JMS)	1.1
Java Transaction API (JTA)	1.2
Java API for RESTful Services (JAX-RS)	2.0
Java API for XML Web Services (JAX-WS)	2.2

10.4. Manager DB파일 백업

Manager의 내부데이터 관리를 위한 HSQL DB의 파일은 주기적으로(1일) 백업파일을 생성하고 있다. 생성위치는 ${LENA_HOME}/repository/backup/database 이다.

기본적으로 30일 이전 백업정보는 삭제하도록 되어 있는데 보관기간을 변경하고 싶은 경우, ${LENA_HOME}/repository/conf 폴더 하위에 manager.conf 파일을 열고, dbbackup.size=보관기간 을 입력 후 Manager를 재 기동하면 보관기간을 변경할 수 있다.

10.5. Manager 의 내부이력 삭제

Manager가 내부적으로 남기는 이력은 주기적으로 삭제하도록 스케쥴링이 되어 있다. 삭제하는 정보는 Action Trace 이력과 Server History 이력이다.

기본적으로 Action Trace이력은 30일까지만 보관하고, Server History 이력은 90일까지 보관하고 있다. 이 보관기간을 변경하고 싶은 경우 ${LENA_HOME}/repository/conf 폴더 하위에 manager.conf 파일을 열고, actiontrace.size=보관기간, serverhistory.size=보관기간을 입력 후 Manager를 재 기동하면 보관기간을 변경할 수 있다.

10.6. Manager 의 admin 패스워드 초기화

Manager의 admin사용자 패스워드를 분실하거나 비밀번호 오류횟수가 초과하였을 경우에는 console를 통하여 패스워드를 초기화해야 한다.

Manager가 설치된 장비에 console(telnet or ssh)로 접속한다.
$LENA_HOME/bin/reset_manager_pw.sh 파일을 실행한다.
패스워드를 초기화 할 user인 admin을 입력한다.
초기화할 패스워드를 입력한다. 단, 패스워드는 8자리이상, 알파벳/숫자/특수문자의 조합으로 입력한다. 패스워드는 보안을 위해 console에 표시되지 않는다.

[bin]$ ./reset-manager-pw.sh

 *******************************
* LENA Server Install ! *
 *******************************

+-------------------------------------------------------------------------------
| 1. USER_ID is the user id to reset
| ex : admin
| 2. NEW_PASSWORD is the password to change
| - password rule #1 : more than 8 length
| - password rule #2 : inclusion of one or more alphabet characters
| - password rule #3 : inclusion of one or more numerical digits
| - password rule #4 : inclusion of one or more special characters
+-------------------------------------------------------------------------------

Input USER_ID for installation. (q:quit)
administrator

Input NEW_PASSWORD for installation. (q:quit)

The password has been changed successfully.

Execution is completed.!!

10.7. LENA 설치 권장 OS파라미터(CentOS기준)

LENA 설치 시 OS파라미터는 max user processes 값을 8192 이상으로 설정하는 것을 권장한다.

parameter	권장값	기본값
max user processes	8192	1024
open files	8192	1024

CentOS기준으로 max user processes 설정은 다음과 같이 ‘ulimit –a’ 명령어를 실행하여 확인을 할 수 있다.

$ ulimit -a
core file size          (blocks, -c) 0
data seg size           (kbytes, -d) unlimited
scheduling priority             (-e) 0
file size               (blocks, -f) 8192
pending signals                 (-i) 14891
max locked memory       (kbytes, -l) 64
max memory size         (kbytes, -m) unlimited
open files                      (-n) 1024
pipe size            (512 bytes, -p) 8
POSIX message queues     (bytes, -q) 819200
real-time priority              (-r) 0
stack size              (kbytes, -s) 10240
cpu time               (seconds, -t) unlimited
*max user processes              (-u) 1024*
virtual memory          (kbytes, -v) unlimited
file locks                      (-x) unlimited

CentOS를 기준으로 명령어 ‘ulimit –u’와 ‘ulimit –n’로 프로세스 수와 오픈파일 개수를 설정할 수 있다. 위 변경사항을 영구적으로 반영하기 위해서는 각 유저의 profile (.profile, .bash_profile)에 ulimit 실행명령을 추가하거나, 강제 설정할 수 있다 (CentOS 기준).

*$ cat $HOME/.bash_profile

*.. (생략)*

*ulimit -u 8192

*ulimit -n 8192

또 다른 설정 방법으로는 /etc/security/limits.conf (CentOS 기준) 파일을 열어서 프로세스 최대수(nproc)와 오픈파일 최대수(nofile)를 설정한다.

*$ cat /etc/security/limits.conf

*.. (생략)*

** soft nproc 8192

** hard nproc 8192

** soft nofile 8192

** hard nofile 8192

10.8. LENA 주기적으로 증가하는 파일

항목

경로

삭제주기

월 예상 증가량

비고

Manager정기점검로깅

LENA_HOME/repository/monitoringDB/maintenance

6개월

10MB

서버 6대 기준의 예상 증가량
자동삭제

Manager모니터링, 진단리포트

LENA_HOME/repository/monitoringDB/{yyyyMMdd}

7일

N/A

자동삭제

Manager진단통계

LENA_HOME/repository/monitoringDB/statistics

영구

1MB 이하

ManagerDB백업파일

LENA_HOME/repository/backup/database

30일

100MB 이하

자동삭제

Manager로그

LENA_HOME/logs/lena-manager

30일

100MB 이하

자동삭제

Agent로그

LENA_HOME/logs/lena-agent

30일

N/A

자동삭제

Installer로그

LENA_HOME/logs/lena-installer

영구

1MB 이하

Patch적용파일

LENA_HOME/etc/patch

영구

N/A

패치시에만 생성됨
패치완료후 삭제가능

Patch백업파일

LENA_HOME/etc/backup/lena-patcher

영구

N/A

패치시 생성됨
패치완료후 삭제가능

Patch로그

LENA_HOME/logs/lena-patcher

영구

N/A

패치시 생성됨
패치완료후 삭제가능

서버인스턴스로그

서버인스턴스설치경로
LENA_HOME/servers/server_id/logs

영구

부하에 따라 판단

경로변경가능

서버인스턴스 히스토리

서버인스턴스설치경로
LENA_HOME/servers/server_id/history

영구

N/A

Manager를 통해 서버설정 변경시에 설정파일 변경분만 생성

서버인스턴스 스냅샷

서버인스턴스설치경로
LENA_HOME/servers/server_id/snapshot

영구

N/A

Manager를 통해 Cluster Snapshot을 생성하는 경우만 생성

WAS 덤프파일

LENA_HOME/repository/monitoringDB/dump

영구

N/A

Manager를 통해 WAS 덤프를 수행하는 경우에만 생성

10.9. Patch CLI (Command Line Interface)

Patch는 설치된 LENA에 대한 기능 개선 및 버그 수정을 위해 제공되는 기능이다. 압축파일 형태로 제공되며, 독립적으로 동작하는 Java프로세스로 동작한다.

Management UI를 통해 실행하는 방법은 patch 에서 제공한다. 여기에서는 CLI를 통해 패치 및 복원하는 방법에 대해 설명한다.

10.9.1. 패치파일 업로드 및 압축해제

전달받은 패치파일을 LENA가 설치된 서버로 FTP등을 이용하여 개별적으로 업로드 한다.

업로드 한 파일은 아래와 같은 위치에 압축을 해제하고 버전명으로 디렉토리의 명칭을 변경한다.Manager를 통하여 업로드하면 자동으로 해당 경로에 압축이 해제된다.

노드/서버 패치파일 경로: /engn001/lena/1.3/etc/patch/{패치버전}
Manager 패치파일 경우: /engn001/lena/1.3/repository/patch/{패치버전}

10.9.2. Patch

Node Patch

patch.sh를 실행하여 Node를 패치한다.

<패치파일압축해제경로>/bin/patch.sh lena-node

Node 패치과정에서 Node는 재기동 된다.

[bin]$ ./patch.sh lena-node

*******************************
* LENA Server Patch ! *
*******************************

2018-05-28 14:06:43:915 [INFO] Patch started to lena-node
2018-05-28 14:06:47:075 [INFO] Stopping node-agent
...
2018-05-28 14:06:52:595 [INFO] Starting node-agent
2018-05-28 14:06:52:748 [INFO] Patch completed to lena-node

 ========================= Execution Result ========================
MESSAGE : Patch succeeded
RESULT : Success
PATCH_HISTORY_ID : patch-20180528140643905
PATCH_TARGET : lena-node
PATCH_VERSION : 1.3.1.1
 ===================================================================
patch is completed.!!

Manager Patch

patch.sh를 실행하여 Manager를 패치한다.

manager 패치

<패치파일압축해제경로>/bin/patch.sh lena-manager

Manager 패치과정에서 Manager는 재기동 된다.

[bin]$ ./patch.sh lena-manager

*******************************
* LENA Server Patch ! *
*******************************

2018-05-28 14:05:32:752 [INFO] Patch started to manager
2018-05-28 14:05:36:032 [INFO] Stopping manager
...
2018-05-28 14:05:46:062 [INFO] Starting manager
2018-05-28 14:05:47:066 [INFO] Patch completed to manager

 ========================= Execution Result ========================
MESSAGE : Patch succeeded
RESULT : Success
PATCH_HISTORY_ID : patch-20180528140532668
PATCH_TARGET : lena-manager
PATCH_VERSION : 1.3.1.1
 ===================================================================

patch is completed.!!

Server Patch

patch.sh를 실행하여 개별적인 서버를 패치한다.

node가 설치된 서버에서 실행하여야 하고, LENA 서버 설치 유형별로 별도로 실행한다. 서버 패치를 위해서는 노드패치가 선행되어야 한다.

WAS standard type 패치

<패치파일압축해제경로>/bin/patch.sh lena-se

WAS enterprise type 패치

<패치파일압축해제경로>/bin/patch.sh lena-ee

Session Server 패치

<패치파일압축해제경로>/bin/patch.sh lena-session

Table 200. patch.sh의 입력 인수 및 입력 항목
항목	설명	비고
PATCH_TARGET	패치 타겟 (patch.sh의 인수로 입력)	lena-node lena-manager lena-se lena-ee lena-session
SERVER_ID	패치 타겟에 해당하는 서버 ID	lena-node, lena-manager 패치에는 불필요

[bin]$ ./patch.sh lena-ee

*******************************
* LENA Server Patch ! *
*******************************

2018-05-28 14:17:18:840 [INFO] Patch started to lena-se

Input SERVER_ID for execution. (q:quit)
wasEE_9100
...
2018-05-28 14:17:26:820 [INFO] Saving patch history
2018-05-28 14:17:26:842 [INFO] Patch completed to lena-se

 ========================= Execution Result ========================
MESSAGE : Patch succeeded
RESULT : Success
PATCH_HISTORY_ID : patch-20180528141639064
PATCH_TARGET : lena-ee
PATCH_VERSION : 1.3.1.1
 ===================================================================

patch is completed.!!

10.9.3. History

history.sh를 실행하여 패치 이력을 확인한다. 기본이력은 원복된 이력은 제외하고 보여주며, 전체이력은 모든 이력을 보여준다.

기본이력

<패치파일압축해제경로>/bin/history.sh

전체이력

<패치파일압축해제경로>/bin/history.sh all

[bin]$ ./history.sh

*******************************
* LENA Server Patch ! *
*******************************

LENA Patch History
1 lena-node / patch-20180528140643905
- action : PATCH
- id : patch-20180528140643905
- target : lena-node
- serverId : lena-node
- oldVersion : 1.3.1.0
- patchVersion : 1.3.1.1
- backupRoot:
/engn001/lena/1.2/etc/backup/lena-patcher/backup-20180528140643903
- timestamp : 20180528140643905
- restored : false
- handwork-status : NO_WORK

2 lena-manager / patch-20180528140532668
- action : PATCH
- id : patch-20180528140532668
- target : lena-manager
- serverId : lena-manager
- oldVersion : 1.3.1.0
- patchVersion : 1.3.1.1
- backupRoot:
/engn001/lena/1.2/etc/backup/lena-patcher/backup-20180528140532666
- timestamp : 20180528140532668
- restored : false
- handwork-status : NEED_WORK
- start of handwork-detail
...
- end of handwork-detail

3 lena-ee / patch-20180528141639064
- action : PATCH
- id : patch-20180528141639064
- target : lena-ee
- serverId : wasEE_9100
- oldVersion : 1.3.1.0
- patchVersion : 1.3.1.1
- backupRoot:
/engn001/lena/1.2/etc/backup/lena-patcher/backup-20180528141639062
- timestamp : 20180528141639064
- restored : false
- handwork-status : NO_WORK

history is completed.!!

10.9.4. Restore

restore.sh를 실행하여 적용한 패치에 대한 원복을 진행한다. (패치 적용 문제 발생 시)

Restore를 실행하면 패치 시점에 변경된 파일을 변경이전 상태로 복원한다.

<패치파일압축해제경로>/bin/restore.sh <PATCH_HISTORY_ID>

(PATCH_HISTORY_ID는 ./ history.sh 로 조회되는 id 값이다.)

[bin]$ ./restore.sh patch-20180423130610713

*******************************
* LENA Server Patch ! *
*******************************

2018-05-28 14:40:05:404 [INFO] Restore started to lena-ee
...
2018-05-28 14:40:05:532 [INFO] Restore completed to lena-ee

 ========================= Execution Result ========================
MESSAGE : Restore succeeded
RESULT : Success
 ===================================================================

restore is completed.!!

10.9.5. Version 확인

version.sh를 실행하여 현재 설치된 서버에 대한 패치상태를 확인할 수 있다.

<패치파일압축해제경로>/bin/version.sh

[bin]$ ./version.sh

*******************************
* LENA Server Patch ! *
*******************************

LENA Patch Information
1. Base Information
- Version : 1.3.1.1 (Up to date)
- LENA_HOME : /engn001/lena/1.3.1

2. lena-manager
2.1 - id : lena-manager / version : 1.3.1.1 (Up to date)

3. lena-se
3.1 - id : wasSE_9100 / version : 1.3.1.1 (Up to date)
3.2 - id : wasSE_9200 / version : 1.3.1.1 (Up to date)

4. lena-ee
4.1 - id : wasEE_9300 / version : 1.3.1.0 (Patch available to 1.3.1.1)
4.2 - id : wasEE_9400 / version : 1.3.1.0 (Patch available to 1.3.1.1)

5. lena-session
5.1 - id : session_5000 / version : 1.3.1.0 (Patch available to 1.3.1.1)
5.2 - id : session_5500 / version : 1.3.1.0 (Patch available to 1.3.1.1)

version is completed.!!

10.10. DBCP 부가 기능

Database 연결 테스트를 통해 Application Server 를 제어하거나, DBCP 에서 수행되는 작업들의 로그를 생성한다.

환경변수나 JVM Option 으로 설정하며, JVM Option 설정을 우선한다.
(동일한 옵션이 환경변수와 JVM Option 으로 모두 설정된 경우 JVM Option 값을 따름)

윈도우 서비스에 Application Server 를 등록하여 사용하는 경우 JVM Option 으로만 설정가능

10.10.1. Application Server 제어

Application Server 기동시 Database 에 접속 불가하거나, pool 생성, validation 쿼리 실패 등의 이상상태가 감지되면 서버를 종료한다.

Table 201. DBCP 부가기능, Application Server 제어
환경변수	JVM Option	설명	Default
SHUTDOWN_IF_DBCONN_FAIL	lena.shutdownIfDbConnFail	true 일 경우 Database 연결 / Pool 생성 실패 / validation 쿼리 실패 상황에 서버 종료	false

10.10.2. DBCP 로깅

Datasource 생성, Connection 생성, Validation 쿼리 수행, Borrow Connection, Return Connection 에 대한 로깅 / 상세 Stack Trace 로깅

환경변수

JVM Option

설명

Default

DBCPLOG_ON

lena.dbcplogOn

true 일 경우 Datasource 생성, Connection 생성시 로깅

false

DBCPLOG_ON_DETAIL

lena.dbcplogOnDetail

true 일 경우 Validation 쿼리 수행, Borrow Connection, Return Connection 로깅 (DBCPLOG_ON 이 false 이면 작동하지 않음)

false

DBCPLOG_ON_STACKTRACE

lena.dbcplogOnStacktrace

true 일 경우 로그에 Stack Trace 정보를 추가한다.

false

DBCPLOG_MAX_TRACE

lena.dbcplogMaxTrace

로그에 출력할 Stack Trace 최대 갯수

DBCPLOG_EXC_DBCP_PACKAGE

lena.dbcplogExcDbcpPackage

Stack Trace 에서 dbcp 관련 package 정보 로깅 제외 여부

true

10.11. Manager 언어 설정 변경

LENA Manager 의 언어 설정을 변경 할 수 있다.

Table 202. LENA Manager 설정 가능 언어
언어	Default
영문(US)	O
한글(KR)

10.11.1. 언어 설정 변경 방법

언어설정 변경 기능을 켜기위해 먼저 다음 메뉴로 진입한다.

ADMIN > Preference > Manager Environment
(기본 영문 설정 기준)

Manager Configuration 의 톱니바퀴 버튼을 클릭하여 세부 설정을 열어 다음과 같이 수정한다.

...
 9 # i18n On/off
10 lena.i18n.enable=true # false -> true
...

이제 Login Page 에서 언어설정을 변경할 수 있다. 로그인한 상태라면 로그아웃 하여 Login 페이지로 이동한다.

사용할 언어를 선택 한 뒤 로그인하면 변경 된 언어로 LENA Manager를 사용할 수 있다.

10.12. Session Server 상세

Application Server의 Session Clustering은 별도의 Session Server를 설치하여 Session을 공유해 Clustering 한다. Session Server는 별도 VM위에서 작동하는 Standalone 모드와 Application Server에 Session Server 모듈을 탑재한 Embedded 모드가 있다.

10.12.1. Session Server Standalone 모드

설치

설치방법은 Install 항목을 참조한다.

기동/중지 및 기동여부 확인

기동/중지 및 기동여부 확인은 Start/Stop 에서 확인한다.

환경설정

Session Server가 설치된 위치를 ${ZODIAC_HOME}이라 칭한다. Session Server는 LENA home 하위 /servers 폴더에 위치한다.

환경설정 정보는 ${ZODIAC_HOME}/session.conf 에 관리한다. 환경설정으로 변경 가능한 설정 항목은 아래와 같다.

항목

설명

server_id

server ID

server_name

server Name

primary_port

해당 Session Server의 TCP listening port

session_max_count

최대 HTTP세션수

server_recv_queue_size

Secondary Server나 Application Server로부터 수신한 Session 정보 처리 요청 (최신 정보 변경 / 신규등록, Logout처리) Queue size

server_req_queue_size

타 Server로부터 수신한 Session정보 요청 (Session정보 요청, 최신 정보 확인 등)을 담는 Queue size

resp_queue_size

타 Server가 요청한 Session 정보에 대한 응답을 담는 Queue size

send_queue_size

타 Server로 전송할 Session 정보를 담는 Queue size

keep_alive_time

Application Server와 Session Server 간의 TCP연결을 유지하기 위해 더미 메세지를 보내는 간격, so_timeout보다 작아야 한다. 각 Application Server 의 설정과 일치시키는 것이 좋다.

so_timeout

Application Server와의 연결에서 read timeout

thread_request_handler

request Queue 에 쌓은 데이터 처리하는 Thread 개수.

thread_data_handler

receive Queue 에 쌓은 데이터 처리하는 Thread 개수.

debug_clustering

Debug용 Log를 남길지 여부

enable_auto_was_sync

true로 설정 했을때, 장애 등으로 재 연결된 WAS에 Sync 요청을 보내 WAS의 Session 데이터를 Sync 한다.

enable_auto_peer_sync

(장애 등으로) 재 연결된 Secondary Session Server에 Sync 요청을 보내 Slave Session Server의 Session 데이터를 Sync 할지 여부

server_expire_sec

서버에서 HTTP세션 정보를 expire 시키는 시간 (Session Timeout)

0인 경우, Application에서 설정한 session의 timeout 시간을 사용

server_expire_check_sec

Session Timeout 체크 주기. (단위 : 초)

secondary_host

Secondary 세션서버의 주소

secondary_port

Secondary 세션서버의 주소

enable_ready_after_sync

Secondary Server와 Session 데이터를 동기화를 수행한 후에, 연결된 WAS에 Clustering 서비스 제공 가능 상태(Ready)로 전송할지 여부 (true는 동기화 후 ready 상태 전송)

wait_server_ready_timeout

해당 시간 이 될 때까지 ready상태(Session Clustering서비스 제공가능 상태) 가 안되면 자동으로 ready 상태를 만들어준다.

server_ready_time

기동 시 Secondary Server와의 연결 대기 시간 (해당 값 * 100 ms).

max_logoutset

최대 로그아웃 된 HTTP 세션 수

enable_auto_logout_sync

true 인 경우, session entry 정보를 sync 할 때, logout 정보도 같이 sync 한다. (sticky가 아닌 round-robin일 경우 필요하다)

로그

로그는 ${LENA_HOME}/logs/session-server/lena-[Session Server Name]_[YYYYMMDD].log 로 남는다. 로그를 확인하고자 한다면 ${ZODIAC_HOME}/log.sh 파일을 실행시켜 확인 할 수도 있다.

[session_5002]$ ./log.sh

5월 09, 2018 02:55:50 오후 [ZODIAC] TCP listen 5002
5월 09, 2018 02:55:54 오후 [ZODIAC] ACCEPT NODE(Tomcat) /127.0.0.1:33138
5월 09, 2018 02:55:55 오후 [ZODIAC] SERVER_READY, no peer, time=5000
5월 09, 2018 02:59:57 오후 [ZODIAC] Zodiac Stop
5월 09, 2018 03:00:00 오후 [ZODIAC] Zodiac Session Server 1.3.0 20160420
5월 09, 2018 03:00:01 오후 [ZODIAC] TCP listen 5002
5월 09, 2018 03:00:01 오후 [ZODIAC] ACCEPT NODE(Tomcat) /127.0.0.1:33359
5월 09, 2018 03:00:03 오후 [ZODIAC] ACCEPT SERVER /127.0.0.1:46818
5월 09, 2018 03:00:04 오후 [ZODIAC] SYNC[session_5002] recv bulk
sessions : #0 recv bulk logout sessions : #0 recv bulk dupInfo : #0 2ms
5월 09, 2018 03:00:04 오후 [ZODIAC] SERVER_READY sync is done
5월 09, 2018 03:00:05 오후 [ZODIAC] TCP Primary name=session_5002
/127.0.0.1:5002
5월 09, 2018 03:00:05 오후 [ZODIAC] SYNC start 127.0.0.1:5002
5월 09, 2018 03:00:05 오후 [ZODIAC] SYNC Send bulk sessions send to
127.0.0.1:5002 #0 and logout session send : 0 and dupInfo send : 0

Console

Zodiac Session Server는 JMX를 통해 Session Server 정보 조회 및 Application Server Sync 명령을 수행 할 수 있다. ${ZODIAC_HOME} 의 console.sh 파일을 실행시켜 Zodiac Session Server의 JMX 기능을 사용한다.

[session_5002]$ ./console.sh

 =====zodiac session server JMX Console=====

 ------------------------------------------------------------

- Usage: ./console.sh <COMMAND> -
- <COMMAND> is one of the following: -
- 1. was_list -
- 2. status -
- 3. was_serverq -
- 4. was_sync -
- It needs WAS ID -
- example: ./console.sh was_sync <was id> -
- 5. search -
- It needs SESSION ID. -
- example: ./console.sh search <session id> -

 ------------------------------------------------------------

다음은 console.sh의 명령어에 대한 설명이다.

Application Server List

현재 Session Server에 연결된 Application Server List를 보여준다.

Shell명령어 console.sh was_list 를 실행하면 된다.

[session_5002]$ ./console.sh was_list

 =====zodiac session server JMX Console=====

RUN OPERATION: getServerInfo

RESULT:server=\{addr:/127.0.0.1:54001,name:wasEE7_29100,
info:\{server_name=wasEE7_29100,pid=24915,hostname=solwas4,jvmName=bde0fbb29e8100285,context=/jpetstoreJTA;ROOT;/lena;/EPS;/HelloWorldWeb,type=INSTANCE}}server=
\{addr:/127.0.0.1:33912,name:wasEE3_29100,
info:\{server_name=wasEE3_29100,pid=10607,hostname=solmanager,jvmName=2b2451dd049f00285,context=/jpetstoreJDBC;ROOT;/jpetstore3,type=INSTANCE}}

Session Server Status

현재 Session Server의 상태 값을 보여준다.

Shell명령어 console.sh status 를 실행하면 된다.

[session_5002]$ ./console.sh status

 =====zodiac session server JMX Console=====

RUN OPERATION:

getStatusString\{request_getfresh_logout:0,session_count:0,req_lost:0,request_
getfresh_not_new:0,request_getfresh_nodata:0,request_getnew_secondary:0,session_expired:0,request_getnew_logout:0,session_timeout:1800,request_getnew_nodata:0,session_max_count:2000000
,logout_from_nodes:0,pid:32705,session_recv_lost:0,logout_from_secondary:0,request_getfresh_secondary:0,request_getfresh:0,request_getnew:0,logout_count:0,data_from_nodes:0,resp_lost:0,request_getfresh_data:0,data_from_secondary:0}

Session Server ServerQ Status

Zodiac Session Server의 ServerQ 상태를 보여준다. ServerQ는 Session Server에 연결된 Application Server의 접속을 관리하는 모듈이다. 여기서 보여주는 데이터는 Application Server 에서 보내는 Session 정보(data)와 Request 정보(Request)를 담는 Queue 정보이다.

Shell명령어 console.sh was_serverq 를 실행하면 된다.
```
[session_5002]$ ./console.sh was_serverq

=====zodiac session server JMX Console=====

PRINT ATTRIBUTEdataQ.size: 0requestQ.size: 0dataQ.overCnt:
0requestQ.overCnt: 0
```

Session Id Search

입력한 Session ID와 일치하는 Session을 가지고 있는 Application Server List 를 보여준다.

Shell명령어 console.sh search [Session ID] 를 실행하면 된다.

[session_5002]$ ./console.sh search
B38E30BDE5223BAA0221B9479AF3DDAF.6ef7931859a200285
 =====zodiac session server JMX Console=====

RUN OPERATION: search

RESULT:\{'AE4_29100'=\{lastAccessTime='2018-05-24
15:55:48.503',context='ROOT',attributeNames=[sessiontest.counter,
ARGO_DUPLICATION_STATUS],lastUpdateTime='2018-05-24
15:55:48.501',addr='/127.0.0.1:44568',id=B38E30BDE5223BAA0221B9479AF3DDAF.6ef7931859a200285,createTime='2018-05-24
15:55:43.241'}}

Application Server Session Sync

Application Server의 Session 정보를 Session Server로 sync하는 경우 실행한다.

Shell명령어 console.sh was_sync [Application Server jvmName(was_list에서 jvmName으로 출력되는 값)] 를 실행하면 된다.

[session_5002]$ ./console.sh was_list

 =====zodiac session server JMX Console=====

RUN OPERATION: getServerInfo

RESULT:server=\{addr:/127.0.0.1:54001,name:wasEE7_29100,
info:\{server_name=wasEE7_29100,pid=24915,hostname=solwas4,jvmName=bde0fbb29e8100285,context=/jpetstoreJTA;ROOT;/lena;/EPS;/HelloWorldWeb,type=INSTANCE}}server=
\{addr:/127.0.0.1:33912,name:wasEE3_29100,
info:\{server_name=wasEE3_29100,pid=10607,hostname=solmanager,jvmName=2b2451dd049f00285,context=/jpetstoreJDBC;ROOT;/jpetstore3,type=INSTANCE}}}

[session_5002]$ ./console.sh was_sync bde0fbb29e8100285

 =====zodiac session server JMX Console=====

RUN OPERATION: serverSyncsync complete

Session Server failover

Session Server는 Primary/Secondary로 구성되어있고, 실시간으로 Session 정보를 동기화 한다. Application Server는 Primary/Secondary Session Server와 접속을 유지하고 있기 때문에 Primary Session Server 장애가 생겼을 경우, 장애 감지 시점 이후부터 Secondary Session Server로 Failover 된다.

10.12.2. Session Server Embedded 모드

Session Server Embedded 모드는, Application Server 내에 Session Server Module을 내장하는 방식이다.

환경 설정

Embedded 모드로 Session Server 설정을 하려면 Manager의 Application Server 설정 화면에서 설정하거나 ${LENA_HOME}/servers/[ApplicationServer명]/conf/session.conf 를 수정한다.

화면에 표시되는 항목에 대한 설명은 아래와 같다.

항목

설명

비고

Session Server Mode

Embedded 또는 Standalone Session Server의 Client 모드 선택

Embedded Host

Session Cluster의 Primary서버의 노드명 과 서버명

Embedded Port

Session Cluster의 Primary서버의 서비스 포트

Secondary Server Host

Session Cluster의 Secondary 서버의 노드명 과 서버명

Secondary Server Port

Session Cluster의 Secondary 서버의 서비스 포트

Multi Login Control

다중 로그인 체크 여부

false

Logout Page when Multi Login check (Multi Login)

다중 로그인시 먼저 로그인 한 사용자에게 표시되는 로그아웃 결과 페이지

Logout Message when Multi Login check (Multi Login)

다중 로그인시 로그아웃 결과 메시지, ajax Client에게 JSON 타입으로 제공됨

Expected Page When Multi Login Check (Multi Login)

Manager 에서는 설정할 수 있는 설정 값은 정해져 있다. 기본적으로 default 설정을 따르도록 한다.

아래는 session.conf 파일로 변경 가능한 환경설정 값이다.

항목

설명

기본값

enable_clustering

Session clustering 할지 여부. False면 Session Server에서 session을 find하지 않는다.

TRUE

debug_clustering

debug 할지 여부

FALSE

primary_host

Primary Session Server의 주소

Embedded 모드인 경우에는 Embedded Host 값

127.0.0.1

primary_port

Primary Session Server의 port

Embedded 모드인 경우에는 Embedded Port 값

5005

secondary_host

Secondary Session Server의 주소,
Application Server와 Primary Session Server의 연결이 끊어진 경우에만 사용된다.

Embedded 모드인 경우에는 Slave Server Host 값

127.0.0.1

secondary_port

Secondary Session Server의 port,
Application Server와 Primary Session Server의 연결이 끊어진 경우에만 사용

Embedded 모드인 경우에는 Slave Server Port 값

5006

recv_queue_size

타 Server로부터 수신한 Session 정보 처리 요청 (최신 정보 변경 / 신규등록, Logout처리) Queue size

512

req_queue_size

타 Server로부터 수신한 Session정보 요청 (Session정보 요청, 최신 정보 확인 등) Queue size

512

resp_queue_size

타 Server로부터 수신한 Session 정보 요청에 대한 응답을 담는 Queue size

512

send_queue_size

타 Server로 전송할 Session 정보를 담는 Queue size

512

keep_alive_time

Application Server와 Session Server 간의 TCP연결을 유지하기 위해 더미 메세지를 보내는 간격, so_timeout보다 작아야 한다.

3000

so_timeout

Session Server와의 연결에서 read timeout

8000

tcp_open_try_interval

Session Server에 연결이 끊어진 경우 재 연결 시도를 위한 간격

5000

find_timeout

Application Server에서 트랜잭션이 세션을 검색할 때 서버 응답을 기다리는 시간 이 시간 동안 서버가 응답이 없으면 Application Server은 해당 세션을 서버가 가지고 있지 않은 것으로 간주한다

500

wait_server_ready_cnt

Server와 통신연결은 되었으나, Server 상태가 ready가 아닌 경우 최대 설정 초만큼 기다린다. -1인 경우 무한대로 기다린다.

-1

server_embedded

session server 모듈을 embedded 할지 여부. True면 session server 모듈을 embedded 한다.

false

max_logoutset

로그아웃된 HTTP 세션을 보관하는 set 크기

20000

check.duplication.login

중복 로그인 체크 여부

false

주1) 타 Server : 연결된 Session Server 또는 Cluster된 Application Server