JEUS 사용 가이드
    • PDF

    JEUS 사용 가이드

    • PDF

    기사 요약

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

    사용하기 전에

    Q. JEUS는 무엇인가요?

    • 국내 시장 점유율 1위 WAS(Web Application Server)인 JEUS를 Server 설치형으로 제공합니다.
    • 세계 상용 최초로 국제 표준인 J2EE 1.4, Java EE 5, Java EE 6, Java EE 7 인증을 획득했습니다.
    • 어플리케이션의 트랜잭션 관리, 세션 유지, 부하 분산 등 다양한 기능을 제공합니다.

    Q. JEUS에는 어떤 특징이 있나요?

    • 인메모리 JSP Compilation: 변경된 JSP 애플리케이션에 대하여 메모리상에서 컴파일을 수행하는 방식을 채택하여 최초 서비스 시간을 줄일 수 있습니다. JSP를 파일로 쓰지 않고 메모리를 통해 함으로써 파일 I/O 동작으로 인한 부하를 줄일 수 있습니다.
    • JEUS Hot Swap: 어플리케이션 기능 변경 시, 전체 클래스를 리로드할 필요 없이 변경된 클래스만 재정의하여 개발 생산성을 획기적으로 향상시키는 기능입니다. 클래스 생성자 추가 및 제거, 메소드 바디 변경에 효과적으로 활용이 됩니다.

    Q. JEUS 서버는 어떻게 생성하나요?

    • 콘솔의 Compute > Server 메뉴에서 JEUS 서버 이미지를 선택하여 생성할 수 있습니다.
    • 원하는 사양의 서버를 생성하고 필요에 따라 스토리지를 추가합니다.
    • 월 요금제와 시간 요금제로 청구되며, 서버를 생성한 후 접속 환경을 설정하여 이용할 수 있습니다.
    • JUES 웹 서비스를 이용하기 위해서 공인 IP 주소를 신청하고 ACG 설정에서 Server Port 포트를 추가해야 합니다.(Port는 변경 가능합니다.)
    • 콘솔에 접속한 후 다음의 단계를 통해 쉽게 서버를 생성할 수 있습니다.

    Q. JEUS Web 서비스에 접속할 수 없습니다.

    • JEUS Web 서비스를 사용하기 위해서는 공인 IP 주소를 신청하여 서버에 할당해야 하며, ACG에 Web Server Port 포트가 추가되어 있어야 합니다.
    • 공인 IP 주소와 ACG를 확인한 후에도 접속되지 않는 경우 웹 서버 프로세스가 정지된 상태일 수 있으니, 터미널에서 재시작 명령어를 실행하여 프로세스를 다시 시작하십시오.

    JEUS 서버 생성

    JEUS 서버 생성 및 접속 과정은 아래의 절차를 순서대로 따라해주시면 됩니다.

    Step 1. 콘솔 접속

    콘솔에 접속해서 Compute > Server 메뉴를 선택합니다.

    ① 서버를 생성하려면 [서버 생성] 버튼을 클릭합니다.

    Step 2. 서버 이미지 선택

    JEUS 서버 이미지를 선택해서 서버를 생성합니다.

    ① 이미지타입 Application, Application 이미지타입 JEUS를 선택합니다.

    Step 3. 서버 설정

    스토리지 종류, 서버 타입, 요금제, Zone을 선택하고, 서버 이름을 입력합니다.

    ① Zone을 선택합니다.

    • 네이버 클라우드 플랫폼[공공기관용]은 1개의 Region을 제공합니다.

    ② 부팅 스토리지로 사용할 스토리지 종류를 선택합니다.

    ③ 원하는 서버 타입을 선택합니다.

    • 일부 서버 스펙은 부팅 디스크 타입에 따라 지원되지 않을 수 있습니다.
    • 사용 용량에 따라 서버 타입 중 하나를 선택하세요.

    ④ 요금제는 월요금제 또는 시간 요금제 중 선택할 수 있습니다.

    ⑤ 서버 이름을 입력합니다.

    • 고객이 서버를 구별하기 위한 명칭으로, 중복해서 사용할 수 없습니다.

    ⑥ 이외 필요한 정보를 입력합니다.

    [다음] 버튼을 클릭합니다.

    Step 4. 인증키 설정

    보유하고 있는 인증키가 있는 경우 [보유하고 있는 인증키 이용] 을 선택하고, 없는 경우 아래의 절차대로 새로운 인증키를 생성합니다.

    [새로운 인증키 생성] 을 선택합니다.

    ② 인증키 이름을 입력합니다.

    [인증키 생성 및 저장] 버튼을 클릭하여 로컬 PC에 인증키 파일을 저장합니다.

    • 새로운 인증키를 발급받습니다.
    • 저장 후 인증키는 고객의 PC 안전한 위치에 보관해 주십시오.
    • 인증키는 최초의 관리자 비밀번호를 가져올 때 이용됩니다.

    [다음] 버튼을 클릭합니다.

    Step 5. ACG 설정

    보유하고 있는 ACG를 이용하거나 신규 ACG를 생성하여 방화벽을 설정할 수 있습니다.

    보유하고 있는 ACG 이용

    보유하고 있는 ACG를 이용하여 방화벽을 설정하는 방법은 다음과 같습니다.

    ① ACG는 필수로 선택해야 하며, 기본으로 제공하는 ‘ncloud-default-acg’를 포함하여 보유하고 있는 ACG 중에서 하나를 선택합니다.

    • 보유하고 있는 ACG는 최대 5개까지 선택할 수 있습니다.
    • 필수로 ACG를 선택해야 [다음] 버튼이 활성화되어 설정을 진행할 수 있습니다.

    ② 보유하고 있는 ACG 외에 신규 ACG를 생성하여 설정하고 싶다면, [신규 ACG 생성] 을 선택합니다.

    [다음] 버튼을 클릭합니다.

    새로 ACG 생성

    새로 ACG를 생성하여 방화벽을 설정하는 방법은 다음과 같습니다.

    ① 신규 ACG 생성에서 [ACG 생성] 버튼을 클릭합니다.

    ② ACG 이름을 입력합니다.

    ③ ACG 설정에서 프로토콜, 접근 소스, 허용 포트를 입력하고 생성합니다.

    • 프로토콜 : TCP, UDP, ICMP에서 선택
    • 접근 소스 : IP 주소 또는 ACG명 입력
    • 허용 포트 : 단일 포트 또는 범위 지정
    • 터미널 접속을 위해서는 접속하려는 서버의 ACG에 SSH 'TCP/22'에 대한 규칙이 설정되어 있어야 하고,
      규칙을 추가하려면 프로토콜, 접근 소스, 허용 포트를 기재하고 [추가] 버튼을 클릭합니다.

    ④ 서비스 포트가 모두 추가된 경우 [생성] 버튼을 클릭합니다.

    Step 6. 최종 확인

    설정한 내용을 최종 확인합니다.

    ① 서버 이미지, 서버, 인증키, ACG가 정상적으로 설정되었는지 확인합니다.

    ② 최종 확인 후에는 서버 생성 버튼을 클릭합니다.

    • 서버가 생성되기까지는 수 분에서 수십 분이 소요됩니다.

    서버 목록에서 확인

    생성한 서버를 목록에서 확인합니다.

    ① 생성한 서버가 목록에 표시됩니다.

    ② 서버가 생성되고 JEUS가 설치 완료되어 서버 상태가 운영중이 될 때까지 대기합니다.

    접속 환경 설정

    공인 IP 주소 사용 신청

    JEUS를 사용하려면 반드시 공인 IP 주소를 이용해서 접속해야 하며, 공인 IP 주소 사용에 대한 요금이 별도로 부과됩니다.

    ① 좌측 메뉴에서 Server > PUBLIC IP 메뉴를 선택합니다. 공인 IP 주소를 할당받으려면 [공인 IP 신청] 버튼을 클릭합니다.

    적용 서버 선택에서 공인 IP 주소를 할당할 JEUS 서버를 선택합니다.

    [확인] 버튼을 클릭합니다. 적용 서버 이름을 확인하고 다시 [확인] 버튼을 클릭합니다.

    포트 포워딩 설정

    터미널 프로그램(PuTTY 등)으로 서버에 접속하려면 Classic 환경의 경우 포트 포워딩 설정이 필수입니다. (VPC 환경은 공인 IP 등으로 접속)

    ① 좌측 메뉴에서 Server > Server 메뉴를 선택합니다. 서버에 접속하려면 [포트 포워딩 설정] 버튼을 클릭합니다.

    ② 포트 포워딩 설정 화면에서 외부 포트 번호를 설정합니다. 외부 포트 번호의 입력 범위는 1024~65,534로, 서버 접속을 위한 기능 외에 서비스 용도로 사용할 수 없습니다.(내부 포트 번호는 22로 정해져 있습니다.)

    [추가] 버튼을 클릭하면 설정 내역이 하단에 추가되며 [수정], [삭제] 버튼을 클릭하여 설정 내역을 수정, 삭제할 수 있습니다.

    [적용] 버튼을 클릭하면 설정한 외부 포트로 터미널 프로그램을 이용하여 SSH 접속을 할 수 있습니다.

    ACG 생성

    ACG에 터미널 접속 SSH('TCP/22') 및 JEUS 서비스('TCP/UDP' 설정) 규칙을 추가합니다.
    서버 생성 시 규칙을 이미 추가한 경우는 이 단계의 ACG 설정 작업을 수행할 필요가 없습니다.

    ① 좌측 메뉴에서 Server > ACG 메뉴를 선택합니다.

    ② 상단의 [ACG 생성] 버튼을 클릭합니다.

    ③ ACG 이름을 입력합니다.

    ④ 설정이 완료되면 [생성] 버튼을 클릭합니다.

    ACG 설정

    ① 생성한 ACG를 선택합니다.

    ② 상단 [ACG 설정] 버튼을 클릭합니다.

    ③ ACG 규칙 설정에서 프로토콜, 접근 소스, 허용 포트를 입력하고 생성합니다.

    • 프로토콜: TCP, UDP, ICMP에서 선택

    • 접근 소스: IP 주소 또는 ACG명 입력

    • 허용 포트: 단일 포트 또는 범위 지정

    • 터미널 접속을 위해서는 접속하려는 서버의 ACG에 SSH 'TCP/22'에 대한 규칙이 설정되어 있어야 합니다.

    • 규칙을 추가하려면 프로토콜, 접근 소스, 허용 포트를 기재하고 [추가] 버튼을 클릭합니다.

    ④ 설정이 완료되면 [적용] 버튼을 클릭합니다.

    서버 관리자 비밀번호 확인

    터미널 프로그램(PuTTY 등)으로 서버에 접속하려면 관리자 비밀번호를 알아야 합니다.

    ① 좌측 메뉴에서 Server > Server 메뉴를 선택합니다.

    ② 해당 서버를 선택하고, 서버 관리 및 설정 변경에서 [관리자 비밀번호 확인] 을 선택합니다.

    [마우스로 파일을 끌고 오거나 여기를 클릭하세요] 버튼을 클릭해 서버 생성 시 개인 PC에 저장한 인증키 파일(.pem)을 첨부합니다.

    ④ 첨부 후 [비밀번호 확인] 버튼을 클릭하면 터미널 프로그램으로 최초 서버 접속 시 사용할 비밀번호를 얻을 수 있습니다.

    • 서버에 접속 후 관리자가 기억할 수 있는 비밀번호로 변경하여 사용하는 것을 권장합니다.

    터미널 접속

    터미널 프로그램(PuTTY 등)으로 서버에 접속해서 JEUS 프로세스를 관리할 수 있습니다.

    터미널 프로그램으로 서버 접속

    lamp-1-1-21_ko4

    ① 터미널 프로그램(PuTTY 등)을 실행합니다.

    ② 서버 리스트 또는 내용 보기에서 확인한 '서버 접속용 공인 IP'와 '외부 포트'의 값을 입력하고 [Open] 버튼을 클릭하면 서버에 접속됩니다.

    • 서버 접속용 공인 IP 확인: 콘솔의 Server > Server 메뉴에서 서버 선택 후 상세정보에서 포트 포워딩 정보서버 접속용 공인 IP 값 확인
    • 외부 포트 번호 확인: 콘솔의 Server > Server 메뉴에서 서버 선택 후 상세정보에서 포트 포워딩 정보외부 포트 값 확인

    ③ 사용자 정보 및 암호를 입력하고 로그인합니다.

    • login as: ncloud
    • password: 위에서 확인한 관리자 비밀번호

    ④ 로그인 후에는 ncloud 계정의 비밀번호를 기억할 수 있는 비밀번호로 변경할 것을 권장합니다.
    passwd ncloud 명령어를 입력한 후 새 비밀번호를 입력합니다.

    JEUS 구성요소와 아키텍처

    JEUS는 서로 다른 많은 모듈로 구성되어 있습니다. JEUS WAS의 아키텍처는 아래와 같습니다.

    JEUS

    그림에서 JEUS WAS Layer는 Java EE 7 스펙을 인증받은 JEUS 8 제품을 나태내며 구성요소는 다음과 같습니다.

    • JEUS Domain Administration Server (DAS)
      도메인 내에는 Domain Administrtaion Server(DAS)라는 특별한 서버가 항상 존재합니다. DAS는 도메인 내 서버들간의 설정과 도메인 내의 모든 애플리케이션 및 리소스를 중앙에서 관리하고, 서버들을 제어 및 모니터링하는 관리 툴 (WebAdmin, jeusadmin) 과 통신합니다.
    서비스설명
    Domain Configuration도메인 전체의 설정을 관리한다.
    Application Management도메인 전체의 애플리케이션을 관리한다.
    AdministrationWebAdmin과 jeusadmin을 통해 도메인 내의 모든 서버, 서비스, 애플리케이션 및 리소스를 한 번에 모니터링 및 제어할 수 있다.
    • JEUS Managed Server (MS)
      Managed Server(MS)는 JEUS 시스템에서 구성될 수 있는 다양한 형태의 엔진과 서비스에 대한 기반을 제공합니다.
    엔진 / 서비스설명
    EJB EngineEJB 비즈니스 애플리케이션을 구동한다.
    Servlet Engine웹 컨테이너로 정적인 콘텐츠(HTML)뿐만 아니라 JSP/Servelet 애플리케이션을 구동한다.
    JMS EngineJMS 기반 구조를 제공한다.
    Web Services EngineJEUS 웹 서버의 인스턴스로서 서블릿 엔진의 front-end로 구동된다.
    JNDI ServiceNaming 시스템이다.
    Security Service인증과 권한 서비스이다.
    JTA웹 애플리케이션 서버에서 구동되는 다양한 애플리케이션들에 대한 완전한 트랜잭션을 제공한다.
    Scheduler미리 정해진 시간에 이벤트를 발생시키는 타이머 기능을 제공한다.
    Session Manager클러스터링이 필요한 경우 신뢰성있는 방식으로 클라이언트의 세션 정보를 저장한다.
    JDBC데이터베이스 Connection Pool이 설정될 수 있다.
    LoggingJEUS 실행 중에 시스템에서 수행되었던 일련의 작업들에 대한 내용을 순서대로 보관 및 기록한다.
    JMXNMS/JMX 클라이언트가 JEUS 시스템을 관리할 수 있도록 한다.
    JCAJCA(Java EE Connector Architecture)는 JCA를 지원하는 EAI(Enterprise Application Integration) 솔루션들에게 JEUS의 JCA를 통한 Legacy EIS 연결을 지원한다.
    • JEUS Administration Tools
      JEUS는 다음과 같은 2가지의 주요한 관리 툴이 있습니다.
    설명
    WebAdmin웹 브라우저에서 사용하며 JEUS의 모듈 패키징, 설정 이외의 모든 구성 요소들을 관리할 수 있는 웹 툴이다.
    콘솔 툴(jeusadmin)그래픽 툴을 통해 사용될 수 있는 모든 기능은 명령행 기반의 콘솔 툴을 사용해서 수행될 수 있다. 이 툴은 그래픽 환경을 사용하지 않을 때 사용한다.

    JEUS 기동 및 중지

    설치된 기본 인스턴스에 대해서 Linux 서비스로 등록해두어 아래 명령어를 root 계정에서 기동 및 종료를 수행할 수 있습니다.
    (JEUS 계정으로 진행할 경우의 명령어에 해당합니다.)

    • 기동 : systemctl start jeus8.service

    • 중지 : systemctl stop jeus8.service

    • 상태확인 : systemctl status jeus8.service

    최초 서버 생성 후, 아래와 같은 페이지를 호출하여 정상 설치 여부를 판단 할 수 있습니다. (공인IP 연결 및 ACG 설정을 진행한 경우)

    jeus-sample.png

    /root/script 에 환경변수 등록 및 기동/중지를 위해 작성해둔 스크립트를 참고하시어 운영환경에 맞는 형태로 활용이 가능합니다.

    WebAdmin 접속

    JEUS WebAdmin은 웹 브라우저를 통해 JEUS의 모든 요소를 관리할 수 있는 서비스를 제공합니다.

    JEUS를 기동할 때 WebAdmin을 시작하려면 domain.xml 파일의 항목을 true로 설정해야 합니다. Jeus WebAdmin의 기본포트는 9736번이며, 관련한 ACG 등록이 필요합니다. (초기 password 변경 전까지는 ACG에 접속이 필요한 IP만 등록함을 권장합니다.)
    최초 admin 페이지 계정은 ID: administrator, Password : jeusadmin 이며 서버 생성이 완료된 직후에 반드시 바로 수정 하여 사용하길 권장합니다. 기본 계정 변경은 $JEUS_HOME/script/start.sh, stop.sh 파일을 backup 후 각각의 파일을 수정 하시면 됩니다.
    (해당 ID와 Password를 그대로 사용할 경우 심각한 보안 침해를 초래할 수 있습니다. password는 서버의 WebAdmin에서 User 및 Group 관리에서 변경하실 수 있습니다.)

    <domain xmlns="http://www.tmaxsoft.com/xml/ns/jeus" version="8.0">
       ...
       <admin-server-name>adminServer</admin-server-name>
       <system-clustering-framework>
          <heartbeat-address>230.30.1.1</heartbeat-address>
          <heartbeat-port>3030</heartbeat-port>
       </system-clustering-framework>
       <enable-webadmin>true</enable-webadmin>
       <servers>
       ...
    </domain>
    
    주의
    • JEUS의 이미지는 주기적으로 갱신되기 때문에 기존 사용자는 서버 이미지를 활용하여 서버를 생성해야 JEUS 패치 버전에 따른 호환성 문제가 발생하지 않습니다.
    • $JEUS_HOME/logs 하위는 서버 복제 시 초기화되는 디렉터리이기 때문에 사용자 로그는 별도 경로를 사용할 것을 권장합니다.
    • JEUS의 MS(Managed Server)의 이름은 VM의 Hostname으로 생성됩니다.
    • JEUS의 webadmin 화면에서 JVM Option은 반영되지 않습니다. 각 OS 계정의 환경 파일( .profile 또는 .bash_profile)에 정의되어 있는 환경 변수(JEUS_JVM_HEAP, JEUS_JVM_GC, JEUS_JVM_OOM, JEUS_JVM_SYS)를 수정한 후 JEUS를 재기동해야 반영됩니다.
    • JEUS admin 접속 후 User 및 Group 관리에서 Password를 변경할 수 있습니다.
    • 초기 비밀번호 변경 전에 ACG는 접속이 필요한 IP만 등록해야 안전합니다.

    연관 정보 바로가기

    네이버 클라우드 플랫폼[공공기관용] JEUS에서 사용되는 소프트웨어에 대한 자세한 내용은 다음 웹페이지를 확인하십시오.


    이 문서가 도움이 되었습니까?

    Changing your password will log you out immediately. Use the new password to log back in.
    First name must have atleast 2 characters. Numbers and special characters are not allowed.
    Last name must have atleast 1 characters. Numbers and special characters are not allowed.
    Enter a valid email
    Enter a valid password
    Your profile has been successfully updated.