LENA WEB 사용 가이드

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

LENA Web Server는 웹상에서 대규모 트랜잭션 처리에 적합하도록 설계된 웹서버로 안정성 및 고가용성을 위한 기능을 다양하게 제공합니다.
LENA Web Server는 LENA Web Application Server에서 기본으로 제공하는 통합 관리 콘솔(Manager)을 통해 편리하게 웹 애플리케이션을 운영할 수 있고 실시간 모니터링을 통해 서버 장애에 효율적으로 대응할 수 있습니다.

사용하기 전에

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

• LENA Web Server는 Enterprise 요건을 충족시키며 대규모 트랜잭션 처리를 위한 Load Balancing 및 LENA WAS Fail-Over 기능을 제공합니다.
• LENA Web Application Server와 함께 사용하면 통합 관리 콘솔을 통해 편리하게 웹 애플리케이션을 운영할 수 있고 모니터링을 통해 서버 장애에 효율적으로 대응할 수 있습니다.

Q. Web 서버에서 80(1024 이하) port를 사용해 서비스하려면 어떻게 해야하나요?

• LENA 설치 경로인 /engn001/lenaw/{version}/bin 디렉터리에 setcap.sh 을 이용해 주십시오.
  root 계정으로 전환 후 ./setcap.sh enable 명령을 수행하면 80(1024 이하) port 를 사용하여 web 서버를 기동할 수 있습니다.

Q. LENA Web 서버에 JDK가 필요한가요?

• 필요합니다. 다만 생성된 서버에 Open JDK8 이 설치되어 있으므로 따로 설치할 필요는 없습니다.
  JDK는 LENA에 설치되어 있는 Web서버의 설치/환경설정 변경 등 관리를 편리하게 도와주는 Node Agent를 사용하기 위해 필요합니다.

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

• Web 서버는 경로 /engn001/lenaw/{version}/servers/{server_id}의 service.sh을 실행하여 서비스로 등록해 주십시오.
  Node Agent는 Web Node 경로(/engn001/lenaw/{version}/bin)에 있는 service-agent.sh을 실행하여 서비스로 등록해 주십시오.

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

• 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 메뉴에서 구성 요소별 상세 버전을 확인할 수 있습니다.

Q. LENA Web Server 와 LENA WAS 는 어떻게 연동하나요?

• LENA Manager 의 설정 화면을 통해 연동할 수 있습니다.
  자세한 내용은 공식 매뉴얼 사이트에서 Installation 매뉴얼의 3.1.5 Web Server 설치 / 실행 - Web Server - WAS 연동 을 참고해 주십시오.

설치하기 전에

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 사용량에 대한 설명입니다. 사용자는 이를 참조해 필요한 자원 사용량을 산정할 수 있습니다.

LENA 서버 생성

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

Step 1. 서버 생성

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

Step 2. 접속 환경 설정

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

Step 3. 포트 포워딩 설정

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

Step 4. ACG 생성 및 설정

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

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

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 버전인 경우 버전목록을 통한 선택만 가능)

Web 서버 생성/삭제 - Case 1. LENA Manager 사용

Step 1. Node Agent 기동

LENA 모듈을 포함하고있는 단위로서 포함된 모듈의 종류에 따라 WAS Node, WEB Node로 구분됩니다.
LENA Web 서버를 생성할 때는 Web Node가 기본 설치되어 있는 상태로 제공됩니다.

설정 항목

각 Node에는 Node Agent가 포함됩니다. Node Agent가 LENA Manager와 통신하기 위해 사용하는 Node 유형별 기본 Port는 다음과 같습니다.

작업 절차

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

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

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

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

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

```
lena@web-svr:/engn001/lenaw/1.3/bin$ ./start-agent.sh

--------------------------------
           LENA Agent
--------------------------------
Using LENA_HOME    : /engn001/lenaw/1.3
Using JAVA_HOME    : /usr/lib/jvm/java-8-openjdk-amd64/jre
Using CONF_FILE    : /engn001/lenaw/1.3/conf/agent.conf
Using LOG_HOME     : /engn001/lenaw/1.3/logs/lena-agent
Using RUN_USER     : lena
Using PORT         : 16900
Using UUID         : a6aad2dd-6984-33ce-9bfd-0a112d9e3f2b
LENA Agent is started.

```

4. 기동을 확인해 주십시오.
   • 동일 Directory 내에서 ps-agent.sh 파일을 실행하면 Node Process를 확인할 수 있습니다.
   • netstat -an | grep 16900 으로 Web Node port LISTEN를 확인해 주십시오.

Step 2. LENA Manager 접속

LENA Manager가 WAS Node에 설치되어 있어야 합니다.

사전 조건

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

작업 절차

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

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

Step 3. Web Node 등록

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

사전 조건

LENA Manager에서 등록하려는 Node Agent로 접속할 수 있도록 TCP 16900 포트의 방화벽을 오픈해야 합니다.

작업 절차

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

WEB Node, WAS Node 등록 방법은 동일하며 Type으로 Node유형을 구분합니다.

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

Step 4. Server 설치 및 기동

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

사전 조건

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

작업 절차

1. Server > WEB Node 메뉴를 차례대로 클릭해 주십시오.
2. [Install] 버튼을 클릭하여 서버를 생성해 주십시오.

3. Web Server List에 추가된 서버 목록을 확인해 주십시오.
4. [Start] 버튼을 클릭해 기동합니다.
   • 정상적으로 기동된다면 Status가 에서 로 변경됩니다.

Step 5. Server 삭제

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

사전 조건

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

작업 절차

1. Server 메뉴에서 [WEB Node] 를 클릭하여 서버 목록 화면으로 이동해 주십시오.
2. 서버목록에서 오른쪽에 있는 휴지통 버튼을 클릭해 주십시오.
3. 아래에 있는 [Save] 버튼을 클릭해 주십시오.
   • Uninstall과 Unregister를 선택할 수 있습니다.
     • Uninstall은 VM 에서 Web Server를 삭제합니다.
     • Unregister는 Manage 에서 Web Server를 등록 해제합니다. 단, Unregister를 선택해도 VM에서 Web Server는 삭제되지 않습니다.

Web 서버 생성/삭제 - Case 2. Shell Script 사용

LENA Manager 없이 서버의 터미널을 통해 Web 서버를 설치하는 방법입니다.

Step 1. Server 설치 및 기동

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

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

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

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

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

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

   lena@lena-svr:/engn001/lenaw/1.3/bin$ ./install.sh create lena-web
   *******************************
   *  LENA Server Install !      *
   *******************************
   +-------------------------------------------------------------------------------------
   | 1. SERVER_ID means business code of system and its number of letter is from 3 to 5.
   |    ex : webd-lena_7180, webd-lena, lena01
   | 2. SERVICE_PORT is the port number used by HTTP Connector.
   |    ex : 7180
   | 3. RUN_USER is user running web-server
   |    ex : lenaw, webadm
   | 4. APACHE_ENGINE_PATH is the path of LENA Web Server engine
   |    ex : /engn001/lenaw/1.3
   | 5. INSTALL_ROOT_PATH is LENA Web Server root directory in filesystem.
   |    ex : /engn001/lenaw/1.3/servers
   | 6. LOG_HOME is LENA Web Server's log directory in filesystem.
   |    If you don't want to use default log directory input your custom log home prefix.
   |    ex : /logs001/lenaw/1.3
   | 7. DOCUMENT_ROOT_PATH is Apache Server's contents directory in filesystem.
   |    ex : /engn001/lenaw/1.3/servers/webd_lena_7180/htdocs
   +-------------------------------------------------------------------------------------
   Input SERVER_ID for execution. (q:quit)
   web-7180
   Input SERVICE_PORT for execution. (q:quit)
   Default value is '80'
   7180
   Input RUN_USER for execution. (q:quit)
   Default value is 'lena'
   
   Input APACHE_ENGINE_PATH for execution. (q:quit)
   Default value is '/engn001/lenaw/1.3/modules/lena-web-pe'
   
   Input INSTALL_ROOT_PATH for execution. (q:quit)
   Default value is '/engn001/lenaw/1.3/servers'
   
   Input LOG_HOME for execution. (q:quit)
   Default value is '/engn001/lenaw/1.3/servers/web-7180/logs'
   
   Input DOCUMENT_ROOT_PATH for execution. (q:quit)
   Default value is '/engn001/lenaw/1.3/servers/web-7180/htdocs'
   
   
   ========================= Execution Result ========================
   RESULT : Success
   MESSAGE : create succeeded
   LENA_HOME : /engn001/lenaw/1.3
   JAVA_HOME : /engn001/java/jdk8
   SERVER_ID : web-7180
   SERVICE_PORT : 7180
   RUN_USER : lena
   APACHE_ENGINE_PATH : /engn001/lenaw/1.3/modules/lena-web-pe
   INSTALL_ROOT_PATH : /engn001/lenaw/1.3/servers
   INSTALL_PATH : /engn001/lenaw/1.3/servers/web-7180
   LOG_HOME : /engn001/lenaw/1.3/servers/web-7180/logs
   DOCUMENT_ROOT_PATH : /engn001/lenaw/1.3/servers/web-7180/htdocs
   ===================================================================
   
   Execution is completed.!!
   

4. ./start.sh 를 통해 Web Server 를 기동해 주십시오.

   참고

   1024 이하 Port를 사용하려면 추가 작업이 필요합니다.
   자세한 내용은 본페이지 상단에 있는 사용하기 전에를 참고해 주십시오.

   lena@lena-svr:/engn001/lenaw/1.3/servers/web-7180$ ./start.sh
   Start LENA [web] ... web-7180
   

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

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

Step 2. Server 삭제

1. /engn001/lenaw/{version}/bin 디렉터리로 이동해 주십시오.
2. './install.sh delete lena-web {서버명}' 명령을 수행해 삭제를 진행해 주십시오.

lena@lena-svr:/engn001/lenaw/1.3/bin$ ./install.sh delete lena-web web-7180
*******************************
*  LENA Server Install !      *
*******************************
 
========================= Execution Result ========================
RESULT : Success
MESSAGE : delete succeeded
LENA_HOME : /engn001/lenaw/1.3
JAVA_HOME : /usr/lib/jvm/java
SERVER_ID : web-7180
DELETE_PATH : /engn001/lenaw/1.3/servers/web-7180
===================================================================
 
Execution is completed.!!

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=N                                 # WAS 스케일링 여부
export LENA_WAS_HOME=/engn001/lena/1.3                    # WAS HOME 경로
export LENA_WAS_AGENT_PORT=16800                          # WAS Agent Port  
export LENA_WEB_SCALING=Y                                 # 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 공식 매뉴얼에서 더 상세한 정보를 확인할 수 있습니다.