LENA WAS 사용 가이드

VPC 환경에서 이용 가능합니다.

LENA Web Application Server는 클라우드 환경과 데이터센터 운영 노하우가 결집된 서비스입니다.
Java 웹 어플리케이션을 안정적으로 구동할 수 있는 미들웨어로 편리한 관리, 안정성 및 고가용성을 위한 다양한 기능을 제공합니다.
세부적으로는 Application Server(WAS)와 세션 서버로 구성되어 있으며 이를 통합 관리 할 수 있는 웹 콘솔을 제공해 보다 편리하고 효율적으로 웹 어플리케이션을 운영할 수 있습니다.

대규모 트랜잭션 처리에 적합하도록 설계되었으며 장애 진단/대응 기능을 통해 서버 장애에 효율적으로 대응합니다. 자매 솔루션인 LENA Web Server와 함께 구성하면 통합 운영을 할 수 있어 운영 편의성과 효율성을 더욱 강화할 수 있습니다.

사용하기 전에

Q. LENA WAS를 사용하면 어떤 이점이 있나요?

• 관리 도구를 통해 운영 중인 WEB/WAS/Session 서버를 통합해 관리함으로써 운영 편의성과 효율성을 증대할 수 있습니다. Topology View를 통해 전사적 운영 가시성을 확보할 수 있으며 모니터링 및 장애 진단/대응 기능을 통해 서버 장애에 효율적으로 대응할 수 있습니다.

Q. JDK는 직접 설치해야 하나요?

• LENA 서버에는 Open JDK 8이 설치되어 있으나 이는 LENA의 기술지원 대상이 아닙니다. 고객사 아키텍처 표준/정책에 부합되는 JDK를 별도로 설치해야 합니다.
  JDK를 설치한 후 LENA Manager(관리 콘솔)에서 서버의 JDK 설정을 쉽게 변경 할 수 있습니다. 자세한 내용은 서비스 매뉴얼을 참고해 주십시오.

Q. WAS를 자동으로 기동을 자동으로 하기 위해 서비스 등록을 하고 싶을 땐 어떻게 해야 하나요?

• WAS 또는 Session Server를 서비스로 등록하려면 서버 설치 경로 (/engn001/lena/{version}/servers/{server_id})에 있는 service.sh을 실행해 서비스를 등록해 주십시오.
  Node Agent를 서비스로 등록하려면 WAS Node 경로(/engn001/lena/{version}/bin)에 있는 service-agent.sh을 실행해 서비스를 등록해 주십시오.
  Manager를 서비스로 등록하려면 WAS Node 경로(/engn001/lena/{version}/bin)에 있는 service-manager.sh을 실행해 서비스를 등록해 주십시오.

Q. LENA Manager 웹 콘솔 계정 비밀번호를 분실했습니다.

• 계정 비밀번호를 초기화 해야 합니다. 네이버 클라우드 플랫폼은 사용자 계정 비밀번호를 위한 script를 제공하므로 LENA 기술지원에 문의 후 가이드를 받아 조치할 수 있습니다.

Q. 직접 생성한 Image로 생성된 서버가 LENA Manager에 Node 등록이 되지 않습니다.

• Node는 고유 식별자를 가지고 있습니다. 서버 이미지를 복제하면 Node의 고유 식별자도 복제되므로 LENA Manager에 이중으로 등록을 시도하면 오류가 발생합니다.
  LENA Home 경로에서 ./etc/info/node-uuid.info 파일을 삭제한 뒤 Node를 다시 기동하면 정상적으로 등록할 수 있습니다.

Q. 현재 사용 중인 LENA의 상세 버전은 어디에서 확인할 수 있나요?

• LENA 설치경로인 /engn001/lenaw/{version}/bin에 있는 version.sh 을 실행하거나 LENA Manager 웹 콘솔 에 접속 후 Admin > Patch 메뉴에서 구성 요소별 상세 버전을 확인할 수 있습니다

설치하기 전에

LENA구성 Architecture 예시

다음은 자주 사용되는 LENA 구성에 대한 예시입니다.

• 단일형: 테스트나 소규모 서비스에서 주로 사용되며, 단일 VM에 WEB, WAS를 함께 구성하는 방식
• 이중화형: WEB 및 WAS를 이중화하여 서비스 가용성을 높일 수 있도록 구성하는 방식
• 확장형: WEB / WAS 구성을 다중화하고 Session 및 Manager를 별도 VM에 구성하여 확장이 용이하도록 구성한 방식

클라우드 환경에서는 유연한 확장을 위해 WEB-WAS 구간을 Load-Balancer로 연결하는 구성 방식도 사용되며 서비스의 아키텍처 특성이나 규모에 맞도록 구성방식을 유연하게 적용할 수 있습니다.

구성 요소

용량 산정 가이드

클라우드 서비스를 통해 VM을 생성하기 전에 사용할 Core 수 및 Memory 용량을 산정해야 합니다. 필요 용량 보다 부족한 용량으로 VM(서버)을 생성하게 되면 VM을 다시 생성해야 하는 불편함이 발생할 수 있습니다.

다음은 LENA의 기본 Memory 설정 및 Disk 사용량에 대한 설명입니다. 사용자는 이를 참조해 필요한 자원 사용량을 산정할 수 있습니다.

JDK의 결정

LENA 서버에는 Open JDK 8이 설치되어 있으나 이는 LENA의 기술지원 대상이 아니며, 고객사 아키텍처 표준/정책에 부합되는 JDK를 별도로 설치하여야 합니다.
새로운 JDK를 설치 후 LENA Manager(관리콘솔)에서 Node 및 서버의 JDK 설정을 손쉽게 변경할 수 있습니다.

LENA 서버 생성

LENA 서버 생성 및 서비스 접속 과정은 네이버 클라우드 플랫폼의 Application 설치형 서비스와 같습니다.
설치형 서비스의 서버 생성 과정을 참고하여 LENA 서버를 생성하고 서비스에 접속할 수 있습니다.

Step 1. 서버 생성

서버를 생성할 때 Application 이미지타입의 LENA 이미지를 선택합니다.
자세한 내용은서버 생성 가이드를 참고해 주십시오.

Step 2. 접속 환경 설정

LENA를 사용하려면 공인 IP 주소를 이용해서 접속해야 합니다. 공인 IP 주소 사용하면 요금이 별도로 부과됩니다.
자세한 내용은공인 IP 사용 가이드를 참고해 주십시오.

Step 3. 포트 포워딩 설정

터미널 프로그램(PuTTY 등)으로 서버에 접속하려면 포트 포워딩을 설정해야 합니다.
자세한 내용은 포트 포워딩 이용 가이드를 참고해 주십시오.

Step 4. ACG 생성 및 설정

ACG에 터미널 접속 SSH('TCP/22') 및 LENA 서비스('TCP/UDP' 설정) 규칙을 추가합니다.
서버를 생성하면서 이미 규칙을 추가했다면 이 단계의 ACG 설정 작업을 생략해도 됩니다.
자세한 내용은 ACG 사용 가이드를 참고해 주십시오.

LENA WAS 서버를 사용할 때 오픈해야 하는 통신 정보는 다음와 같습니다.

Step 5. 서버 접속

터미널 프로그램(PuTTY 등)을 통해 서버 접속을 진행합니다.
자세한 내용은 리눅스 서버 접속 가이드를 참고해 주십시오.

LENA Package 설치

개요

LENA Package 설치를 진행합니다. 서버를 신규 생성하면 서버 내에 여러 버전의 LENA 가 미설치 상태로 제공됩니다.
사용자는 LENA Package 설치 과정을 통해, 사용할 버전을 선택하게 됩니다. 신규 사용자는 최신 버전을 사용하고, 기존 사용자는 사용 중인 LENA Manager 와 동일한 버전의 LENA 를 설치하여 사용합니다.

작업 절차

계정 전환

LENA 설치 / 기동을 위해 lena 계정으로 전환하여 진행합니다.

Package 설치/Version 선택

LENA 의 기본 설치 경로는 /engn001 입니다.
LENA Package 설치 script를 수행하기 위해 /engn001 디렉토리로 이동 후, 'start_lena.sh' 을 수행합니다.
'start_lena.sh' 은 사용자로부터 몇 가지 문답을 통해 사용할 버전을 결정하고, LENA Package 를 설치합니다.

Q1) [LENA 를 처음 사용하는지 확인] Is it your first time using LENA? [Y/N]
Y : 최신버전 설치
N : 'Q2' 로 이동

Q2) [신규서버를 사용중인 Manager 에 등록할지 확인] Would you like to add this server to the LENA Manager you are using? [Y/N]:
Y : 'Q3' 로 이동
N : 최신버전 설치

Q3) [Manager 버전 확인을 위한 ip:port 입력] Please enter LENA Manager address. [ ip:port ]:
통신 가능 : Manager 와 동일한 버전으로 설치
통신 불가 : 설치 가능한 버전 목록이 보여지며, 번호를 입력하여 버전 선택
(사용중인 Manager 가 1.3.1c.3 버전인 경우 버전목록을 통한 선택만 가능)

WAS 서버 생성

Step 1. LENA Manager 설치

LENA Manager는 여러 개의 Node를 관리할 수 있는 통합형 관리 웹 콘솔입니다.
각 Node에 Server Instance를 설치, 제어하거나 설정을 변경할 수 있는 기능을 제공합니다.
LENA Manager는 WAS Node에서 설치할 수 있습니다.

설정 항목

작업 절차

1. LENA 설치를 위해 계정을 lena 계정으로 전환해 주십시오.

2. Manager 설치를 위해 /engn001/lena/{version}/bin디렉터리로 이동해 주십시오.

   • LENA 기본 설치 경로는 /engn001/lena/{version} 입니다.

   ubuntu@lena-svr:~$ sudo su - lena
   lena@lena-svr:~$ cd /engn001/lena/1.3/bin/
   lena@lena-svr:/engn001/lena/1.3/bin$
   

3. "./install.sh create lena-manager"명령을 통해 설치를 진행해 주십시오.

   • Service Port, Monitoring Port, Run User를 선택할 수 있습니다.
   • Enter key를 입력하면 default 값으로 진행됩니다. 별도의 제약 사항이 없다면 default 값을 권장합니다.

   lena@lena-svr:/engn001/lena/1.3/bin$ ./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
   +-------------------------------------------------------------------------------------
   Input SERVICE_PORT for execution. (q:quit)
   Default value is '7700'                            # Enter key 입력
   
   Input MONITORING_PORT for execution. (q:quit)
   Default value is '16100'                           # Enter key 입력
   
   Input RUN_USER for execution. (q:quit)
   Default value is 'lena'                            # Enter key 입력
   
   ..
   ========================= Execution Result ========================
   RESULT : Success
   MESSAGE : create succeeded
   LENA_HOME : /engn001/lena/1.3
   JAVA_HOME : /usr/lib/jvm/java
   SERVER_ID : lena-manager
   SERVICE_PORT : 7700
   MONITORING_PORT : 16100
   INSTALL_PATH : /engn001/lena/1.3/modules/lena-manager
   ===================================================================
   
   Execution is completed.!!
   

4. ./start-manager.sh을 통해 Manager 를 기동해 주십시오.

   lena@lena-svr:/engn001/lena/1.3/bin$ ./start-manager.sh
   --------------------------------
        LENA Application Server
   --------------------------------
   Using LENA_HOME :     /engn001/lena/1.3
   Using JRE_HOME:        /usr/lib/jvm/java
   Using SERVER_PID:    /engn001/lena/1.3/modules/lena-manager/lena-manager_lena-svr.pid
   Using SERVER_HOME :   /engn001/lena/1.3/modules/lena-manager
   Using SERVER_ID :     lena-manager
   Using INSTANCE_NAME : lena-manager_lena-svr
   LENA started.
   

5. 기동을 확인해 주십시오.

   • 프로세스 정상 기동 확인: 동일 Directory 내에서 ps-manager.sh 파일을 실행하면 LENA Manager Process를 확인할 수 있습니다.
   • 네트워크 확인: netstat -an | grep 7700 으로 port LISTEN 확인할 수 있습니다.

Step 2. Node Agent 기동

Node는 LENA 모듈들을 포함하고 있는 단위로 포함된 모듈 종류에 따라 WAS Node, WEB Node로 구분할 수 있습니다.
LENA WEB 이미지로 서버를 생성할 때는WEB Node가 기본 설치되어 있고 LENA WAS 이미지로 서버를 생성할 때는 WAS Node가 기본 설치되어 있는 상태로 제공됩니다.
각 Node에는 LENA Manager와의 통신을 위해 Node Agent가 기본 설치되어 있습니다.

설정 항목

Node Agent가 사용하는 기본 Port는 다음과 같습니다.

작업 절차

1. LENA 설치 및 기동을 위해 lena 계정으로 전환해 주십시오.

   • LENA의 기본 설치 경로는 다음과 같습니다.
     WAS Node : /engn001/lena/{version}

2. Node 기동을 위해 설치 경로 하위에 있는 bin 디렉터리로 이동해 주십시오.

   ubuntu@was-svr:~$ sudo su - lena
   lena@was-svr:~$ cd /engn001/lena/1.3/bin/
   lena@was-svr:/engn001/lena/1.3/bin$
   

3. ./start-agent.sh을 통해 Node Agent 를 기동해 주십시오.

   lena@was-svr:/engn001/lena/1.3/bin$ ./start-agent.sh
   
   --------------------------------
              LENA Agent
   --------------------------------
   Using LENA_HOME    : /engn001/lena/1.3
   Using JAVA_HOME    : /usr/lib/jvm/java-8-openjdk-amd64/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         : 648c32c4-c7a5-3a08-ad0e-8fbbf4be2edf
   LENA Agent is started.
   
   

4. 기동을 확인해 주십시오.

   • 동일 Directory 내에서 ps-agent.sh 파일을 실행하면 Node Process를 확인할 수 있습니다.
   • netstat -an | grep 16800 으로 WAS Node port LISTEN 확인할 수 있습니다.

Step 3. LENA Manager 접속

WAS, Session 서버 등을 설치 및 관리하기 위해서는 LENA Manager 웹 콘솔로 접속해야 합니다.

사전 조건

접속하려는 사용자 PC에서 LENA Manager서버의 TCP 7700 포트로 접속할 수 있도록 방화벽을 오픈해야 합니다.

작업 절차

• 접속 주소
  http://{LENA Manager IP}:7700

• 접속 계정
  id : admin
password : !admin1234

Step 4. Node 등록

위에서 기동된 Node Agent를 LENA Manager에 등록하는 절차입니다.

사전 조건

LENA Manager서버에서 등록하려는 Node Agent의 포트로 접속할 수 있도록 방화벽을 오픈해야 합니다.
Node 및 Server Instance 모니터링을 위해서는 Node → Manager로 모니터링 UDP 포트(기본 16100) 가 오픈되어 있어야 합니다.

작업 절차

1. Server 메뉴에서 [Register] 버튼을 클릭해 주십시오.
2. Node 정보를 입력해 주십시오.
3. [Save] 버튼을 클릭해 주십시오.

WEB Node와 WAS Node 등록 방법은 같고 Type으로 Node유형을 구분합니다.

5. 정상으로 등록된 것을 확인해 주십시오.
   • Status값이 로 되어 있으면 LENA Manager에 등록된 Node Agent가 기동 중임을 의미합니다.
   • 일 경우에는 LENA Manager에 등록된 Node Agent가 기동 상태가 아님을 의미합니다.

Step 5. Server 설치 및 기동

LENA Manager 화면에서 손쉽게 Web, WAS, Session 서버를 설치할 수 있습니다.

사전 조건

WAS를 설치하기 위해서는 WAS Node Agent가 기동된 상태여야 합니다.

작업 절차

1. Server > WAS Node 메뉴를 차례대로 클릭해 주십시오.
2. WAS List에 있는 [Install] 버튼을 클릭해 서버를 생성해 주십시오.

각 입력 항목에 대한 설명은 다음와 같습니다.

3. WAS List에 추가된 서버 목록을 확인해 주십시오.

4. [Start] 버튼을 클릭해 기동할 수 있습니다.

   • 서버가 정상적으로 기동되면 Status가 에서 로 변경됩니다.

5. Server > WAS Node를 차례대로 클릭해 주십시오.

6. Session Server List에 있는 [Install] 버튼을 클릭하여 서버를 생성해 주십시오.

입력 항목은 아래와 같습니다.

7. [Start] 버튼을 클릭해 서버를 기동할 수 있습니다.
   • 서버가 정상적으로 기동되면 Status가 에서 로 변경됩니다.

Step 6. Server 삭제

LENA Manager 화면에서 손쉽게 WAS 를 삭제할 수 있습니다.

사전 조건

WAS를 삭제하기 위해서는 WAS Node Agent가 기동된 상태여야 합니다.

작업 절차

1. WAS 삭제

1. Server > WAS Node를 차례대로 클릭해주십시오.
2. 서버 목록 오른쪾에 있는 휴지통 버튼을 클릭해 주십시오.
3. 아래에 있는 [Save] 버튼을 클릭해 주십시오.
   • Uninstall 과 Unregister를 선택할 수 있습니다.
   • Uninstall은 VM 에서 WAS를 삭제합니다.
   • Unregister는 Manager에서 WAS를 등록 해제합니다. 단, Unregister를 선택해도 VM에서 WAS가 삭제되지 않습니다.

Auto Scaling 설정 가이드

LENA Manager와 Server Cluster를 생성하면 CSP 또는 Cloud 플랫폼이 제공하는 Auto-Scaling(Infra Scaling)에 따른 서비스 Scaling를 지원합니다.
VM의 Scaling은 전적으로 Cloud 플랫폼 정책에 따라 작동합니다. LENA는 Cloud 플랫폼에서 새로운 VM 이 생성되었을 때 정상적인 서비스가 되도록 지원합니다.
LENA의 Auto Scaling 기능을 사용하려면 Server Cluster가 구성되어 있어야 하며 Scale Out 된 VM에서 Init Script를 통해 scale.sh 를 호출해야 합니다.
LENA에서는 Init Script에 작성된 정보와 Server Cluster에 세팅된 정보에 따라 설정파일 동기화, Web / WAS 간 연동 설정, 서버 기동 등의 작업을 수행합니다.

Linux계열의 OS를 사용하고 Init Script 기능이 제공되는 환경에서 사용할 수 있습니다.

LENA Manager 설정

Server Cluster 생성

1. Cluster 메뉴에서 Server Cluster 내 System을 선택해 주십시오.
2. [New] 버튼을 클릭해 Server Cluster를 생성해 주십시오.
   • Scaling 사용하려면 Server Cluster를 생성할 때 Enable Scaling 항목을 true로 선택해 주십시오.
   • 고정으로 기동되어 서비스하는 VM이 있다면 Application Server in server cluster, Web Server in server cluster에서 서버를 선택해 Cluster에 포함합니다.

Server Cluster 설정

1. 생성한 Server Cluster를 클릭해 상세 화면으로 이동해 주십시오.
2. Scaling 탭을 클릭해 Scaling 상세 설정을 할 수 있습니다.

Scaling 탭은 Policy, Was Scaling Template, Web Scaling Template, History 탭으로 구성되어 있습니다. Policy 탭에서는 Web-Was Connection Scope를 반드시 확인해 주십시오.

• Web / WAS 간에 Load Balancer를 이용하여 연동했다면 None(Using Proxy) 를 선택합니다.
• Web / WAS 간에 AJP 방식으로 직접 연결했다면 JK Mesh - Cluster Servers 를 선택합니다.

JK Mesh - Cluster Servers를 사용하면 새로운 WAS가 Scale Out 되었을 때 기존에 등록된 Web 서버에 자동으로 등록을 진행합니다.

CSP Scaling 설정

이미지 생성

현재 서비스 중인 서버를 선택하고 이미지 생성합니다.

Init Script 생성

Scale Out 시 사용할 Init Script를 생성합니다.
서버의 Scale Out후 각종 설정 및 서비스 기동 명령이 수행되어야 Scale Out된 서버를 통해 정상적으로 서비스 할 수 있습니다.

LENA 에서는 서버 기동 시 아래와 같은 스크립트를 입력하면 신규 서버에 대한 각종 설정 및 서비스 기동이 자동으로 수행됩니다.

```
#!/bin/bash
export JAVA_HOME=/engn001/java                            # java home path
export LENA_MANAGER_ADDRESS={MANAGER_IP}:{MANAGER_PORT}   # LENA manager ip:port
export LENA_CLUSTER_NAME={SERVER_CLUSTER_NAME}            # LENA Manager 에서 생성한 Server Cluster 명
export LENA_USER=lena                                     # LENA 서비스용 계정
export LENA_GROUP=lena                                    # LENA 서비스용 그룹
export LENA_WAS_SCALING=Y                                 # WAS 스케일링 여부
export LENA_WAS_HOME=/engn001/lena/1.3                    # WAS HOME 경로
export LENA_WAS_AGENT_PORT=16800                          # WAS Agent Port  
export LENA_WEB_SCALING=N                                 # WEB 스케일링 여부
export LENA_WEB_HOME=/engn001/lenaw/1.3                   # WEB Home 경로
export LENA_WEB_AGENT_PORT=16900                          # WEB Agent Port
if [ "$LENA_WAS_SCALING" = "Y" ]; then $LENA_WAS_HOME/bin/scale.sh; fi
if [ "$LENA_WEB_SCALING" = "Y" ]; then $LENA_WEB_HOME/bin/scale.sh; fi
```

Launch Configuration 생성

앞에서 생성한 서버 이미지와 Init Script를 포함하여 Launch Configuration을 생성합니다.

Auto Scaling Group 생성

Auto Scaling Group을 생성합니다.
신규로 Scale Out된 서버가 정상적으로 서비스 되는지 확인합니다.

연관 정보 바로가기

LENA 공식 매뉴얼에서 더 상세한 정보를 확인할 수 있습니다.