Sun Java System Web Server 7.0 Update 3 관리자 설명서

2장 구성, 인스턴스 및 노드

앞의 장에서는 Web Server 7.0에 도입된 몇 가지 새로운 개념에 대해 소개했습니다. 관리자의 기본적인 작업은 서버의 런타임 서비스를 구성하고 관리하는 것입니다. 이 장에서는 구성을 관리하는 여러 가지 방법과 구성을 배포하여 노드에서 인스턴스를 시작하는 방법에 대해 설명합니다.

개요

인스턴스는 지정된 노드에서 웹 서버 데몬의 환경을 나타내며, 해당 구성 및 로그 파일을 비롯하여 잠금 데이터베이스, 캐시, 임시 파일 등과 같은 다른 런타임 아티팩트를 포함합니다.

노드는 서버 또는 호스트와 같은 네트워크 자원입니다. 일반적인 데이터 센터에서 노드 네트워크는 서버 팜이라고 합니다. 이 절에서는 관리 콘솔 GUI를 사용하여 노드를 구성하는 방법에 대해 설명합니다.

노드에 하나 이상의 인스턴스를 배포할 수 있습니다. 같은 인스턴스를 여러 노드에 배포하여 서로 다른 클러스터의 부분을 형성할 수도 있습니다.

관리 용도로 인스턴스를 시작, 중지, 다시 시작하거나 동적으로 다시 구성할 수 있습니다.

구성 관리

구성 만들기

웹 서버를 사용하기 시작하려면 구성을 만들어야 합니다.

새 구성을 만들려면 다음 작업을 수행하십시오.

구성 탭을 누릅니다.
새로 만들기 버튼을 누릅니다.

마법사가 나타나며 구성 만들기에 사용할 수 있는 설정을 안내합니다. 다음 절에서는 마법사 페이지에서 사용할 수 있는 필드에 대해 설명합니다.

단계 1 – 구성 정보 설정

이 마법사 페이지에서는 새 구성에 대한 일반 정보를 설정할 수 있습니다.

마법사 페이지에서 다음 매개 변수를 설정합니다.

구성 이름 — 구성에 고유한 새 이름을 추가합니다.
서버 이름 — 새 구성에 서버 이름을 추가합니다. 이 이름은 구성 이름과 동일할 수 있습니다.
문서 루트 — 배포된 모든 웹 응용 프로그램이 해당 디렉토리를 유지 관리하는 유효한 문서 루트를 입력합니다. 기본값은 ../docs입니다. 서버의 유효한 모든 디렉토리 경로를 입력할 수 있습니다.
64비트 — 웹 서버의 64비트 지원을 활성화/비활성화 합니다. 기본값은 비활성화입니다.
서버 사용자 — UNIX 기반 시스템에서 서버가 실행 중인 경우 서버 프로세스에 대해 유효한 사용자 이름을 입력합니다. 예: root

단계 2 — 구성에 대한 수신기 만들기

이 마법사 페이지에서는 새 구성에 대해 HTTP Listener 등록 정보를 설정할 수 있습니다.

마법사 페이지에서 다음 매개 변수를 설정합니다.

포트 — 구성을 바인드하고 요청을 수신하는 포트 번호를 입력합니다.
IP 주소 — 호스트 시스템의 IP 주소입니다. 사용 가능한 모든 IP 주소를 설정하려면 *를 입력합니다.

단계 3 — Java, CGI 및 SHTML 구성

이 마법사 페이지에서는 Java/CGI 및 SHTML과 관련된 등록 정보를 구성할 수 있습니다.

마법사 페이지에서 다음 매개 변수를 설정합니다.

Java — 활성화. 기본적으로 Java는 사용 가능하도록 설정되어 있습니다.경고: 이 구성을 사용하여 Java 기반 웹 응용 프로그램을 배포하려면 Java를 비활성화하지 마십시오. Java SE 디렉토리의 홈을 설정합니다. 기본값은 번들된 Java SE 디렉토리를 가리키는 디렉토리입니다. 기본 Java SE 디렉토리를 선택하거나 새 경로를 지정할 수 있습니다.

주 –
Web Server 인스턴스가 Java 웹 응용 프로그램을 수행하지 않으면 disable-java CLI 명령을 사용하거나 관리 콘솔을 통해 Java를 비활성화할 수 있습니다. 예를 들어 FastCGI와 역방향 프록시 플러그인은 Java를 기반으로 하지 않는 응용 프로그램입니다. Java를 비활성화하면 Web Server 인스턴스의 메모리 사용량이 감소합니다. 기본적으로 인스턴스는 Java를 사용 가능하도록 설정되어 있습니다.

Java 비활성화에 대한 자세한 내용은 CLI 참조 disable-java(1) 및 enable-java(1)를 참조하십시오.
CGI — 없음(CGI 지원 비활성화), 파일 유형으로 활성화(CGI 지원 활성화) 및 디렉토리(CGI 문서가 저장되는 URI 및 경로 지정).
SHTML — 기본적으로 SHTML은 비활성화되어 있습니다.

구성 복원

이 절에서는 이전에 배포된 구성을 복원하는 방법을 설명합니다.

주 –

최근 7개의 구성만 복원할 수 있습니다.

구성을 복원하는 방법

구성 탭을 누릅니다.

일반 하위 탭 > 복원 하위 탭을 누릅니다.

구성 백업 목록에서 구성을 선택합니다.

복원 버튼을 누릅니다.

관리 콘솔 페이지 오른쪽 상단에 있는 보류 중인 배포 링크를 눌러 복원된 구성을 배포합니다.

새 팝업 창이 열립니다.

배포 버튼을 누릅니다.

단계 4 — 인스턴스 만들기

이 마법사 페이지에서는 새 구성에 대한 인스턴스를 만들 수 있습니다.

마법사 페이지에서 다음 매개 변수를 설정합니다.

구성 — 새 구성의 이름입니다.
노드 선택 — 새 구성의 인스턴스를 만들기 위해 노드를 선택합니다. 사용 가능한 목록에서 노드를 선택하고 추가 또는 모두 추가 버튼을 눌러 노드를 추가합니다.

주 –

CLI 사용

CLI를 통해 구성을 만들려면 다음 명령을 실행합니다.

wadm> create-config --doc-root=[DOCROOT] --jdk-home=[JAVAHOME] 
--server-user=[SERVERUSER]  [--document-root=serverdocroot] [--platform=32|64] 
--http-port=port --server-name=servername CONFIGNAME

config1은 새 구성의 이름입니다.

CLI 참조 create-config(1)를 참조하십시오.

서버 구성 복제

서버 구성을 복사하여 새 구성을 만들 수 있습니다. 새로 복사된 구성은 기존 구성과 동일합니다. 하지만 원본 구성에 인스턴스가 있었던 경우에도 새 구성에는 인스턴스가 없습니다.

구성을 복제하려면 다음 작업을 수행하십시오.

구성 탭을 누릅니다.
목록에서 구성을 선택합니다.
복제 버튼을 누릅니다.
팝업 창에서 새 구성 이름을 입력하고 확인을 누릅니다.

주 –

CLI 사용

CLI를 통해 작업을 수행하려면 다음 명령을 실행합니다.

wadm> copy-config --user=admin --password-file=admin.pwd --host=serverhost 
--port=8989 --config=config1 copyconfig1

copyconfig1은 새 구성의 이름입니다.

CLI 참조 copy-config(1)를 참조하십시오.

서버 구성 배포

노드에 구성을 배포하려면 먼저 구성을 만들어야 합니다.

기존 구성을 배포하려면 다음 작업을 수행하십시오.

구성 탭을 누릅니다.
구성 확인란을 선택하여 구성을 확인합니다.
배포 버튼을 누릅니다.
새 창이 열리면 배포 버튼을 눌러 구성을 배포합니다.

서버 구성 삭제

주 –

구성 인스턴스가 노드에 배포되어 있으면 구성을 삭제할 수 없습니다. 인스턴스가 배포되어 있으면 실행 중이 아니라도 서버 구성을 삭제할 수 없습니다. 구성을 삭제하려면 실행 중인 인스턴스를 중지하고 배포를 해제합니다.

구성을 삭제하려면 다음 작업을 수행하십시오.

구성 탭을 누릅니다.
구성 확인란을 선택하여 구성을 확인합니다.
삭제 버튼을 누릅니다.
새 창이 열리면 확인 버튼을 눌러 구성을 삭제합니다.

구성 변경 사항을 Administration Server로 가져오기

구성을 수동으로 변경할 경우 변경 사항을 Administration Server 저장소로 다시 복제해야 합니다.

서버 인스턴스의 구성 파일을 이전 버전의 Web Server에서 작업하는 것 같이 수동으로 편집합니다(권장되지 않음).
Administration Server를 시작합니다.
변경 사항을 Administration Server 저장소로 다시 가져오려면 다음 명령을 실행합니다.
wadm> pull-config --user=admin --config=CONFIG_NAME

주 –

구성에 따라 이 작업은 시간이 좀 걸릴 수 있습니다.

주 –

반드시 관리 콘솔이나 wadm CLI를 사용하여 설정을 편집합니다. pull-config를 호출할 경우 <instance_dir>/config 디렉토리의 내용만 Web Server 구성 저장소로 가져옵니다.

서버에서 관리 노드 제거

서버에서 관리 노드를 제거하는 방법

일반 작업 페이지에서 노드 탭을 누릅니다.

관리 노드를 선택합니다.

목록에서 관리 노드를 선택합니다.

제거 버튼을 누릅니다.

서버 인스턴스 관리

서버 인스턴스 만들기

새 서버 인스턴스를 만들기 전에 다음 확인 작업을 수행하십시오.

구성을 만들었는지 확인합니다. 새 서버 인스턴스를 만들려면 기존 인스턴스 구성을 지정해야 합니다.
서버 팜에서 사용 가능한 모든 노드에 필요한 구성 인스턴스가 있는지 확인합니다. 중복 인스턴스는 만들 수 없습니다.

다음 작업을 수행하여 새 서버 인스턴스를 만듭니다.

구성 탭을 누르고 인스턴스를 만들 구성 링크를 누릅니다.
새 인스턴스 마법사 페이지에서 인스턴스를 만들 구성을 선택합니다. 이 인스턴스에 대한 서비스를 만들려는 경우 SMF Service를 선택하고 다음 버튼을 누릅니다.
선택한 구성의 인스턴스 [단계 2]가 존재해야 할 노드를 선택합니다. 다음 버튼을 누릅니다.
선택 항목의 요약을 봅니다. 다음 버튼을 눌러 작업 결과를 봅니다.

주 –

CLI 사용

서버 인스턴스를 만들려면 다음 명령을 실행합니다.

wadm> create-instance --user=admin --password-file=admin.pwd 
--host=serverhost --port=8989 --config=config1 serverhost

CLI 참조 create-instance(1)를 참조하십시오.

서버 인스턴스 시작

노드 탭을 눌러 서버에 구성된 노드 목록을 봅니다.
노드 이름 확인란을 선택하여 노드를 선택합니다.
인스턴스 시작 버튼을 눌러 페이지 창을 열고 해당 노드에서 제어하는 모든 인스턴스를 나열합니다.
인스턴스를 선택하고 인스턴스 시작 버튼을 눌러 인스턴스를 시작합니다.
인스턴스 상태가 실행중인지 확인하고 창을 닫습니다.

주 –

CLI 사용

CLI를 통해 서버 인스턴스를 시작하려면 다음 명령을 실행합니다.

wadm> start-instance --user=admin --password-file=admin.pwd --host=serverhost 
--port=8989 --config=config1 nodehost1

CLI 참조 start-instance(1)를 참조하십시오.

서버 인스턴스 중지

노드 탭을 눌러 서버에 구성된 노드 목록을 봅니다.
노드 이름 확인란을 선택하여 노드를 선택합니다.
인스턴스 중지 버튼을 눌러 페이지 창을 열고 해당 노드에서 제어하는 모든 인스턴스를 나열합니다.
인스턴스를 선택하고 인스턴스 중지 버튼을 눌러 인스턴스를 중지합니다.
인스턴스의 상태가 정지됨인지 확인하고 창을 닫습니다.

주 –

CLI 사용

CLI를 통해 서버 인스턴스를 중지하려면 다음 명령을 실행합니다.

wadm> stop-instance --user=admin --password-file=admin.pwd --host=serverhost 
--port=8989 --config=config1 nodehost1

CLI 참조 stop-instance(1)를 참조하십시오.

서버 인스턴스 다시 시작

노드 탭을 눌러 서버에 구성된 노드 목록을 봅니다.
노드 이름 확인란을 선택하여 노드를 선택합니다.
인스턴스 다시 시작 버튼을 눌러 페이지 창을 열고 해당 노드에서 제어하는 모든 인스턴스를 나열합니다.
인스턴스를 선택하고 인스턴스 다시 시작 버튼을 눌러 인스턴스를 다시 시작합니다.
인스턴스 상태가 실행중인지 확인하고 창을 닫습니다.

주 –

CLI 사용

wadm> restart-instance --user=admin --password-file=admin.pwd 
--host=serverhost --port=8989 --config=config1 nodehost1

CLI 참조 restart-instance(1)를 참조하십시오.

서버 인스턴스 다시 구성

구성을 변경할 때 인스턴스를 다시 시작할 필요가 없는 경우도 있습니다. Administration Server에서는 서버 인스턴스를 다시 구성하여 변경 사항을 구성 저장소로 가져오는 기능을 지원합니다. 이 구성에서는 서버를 다시 시작하지 않아도 변경 사항이 인스턴스에 반영됩니다. 구성에서 동적으로 다시 구성할 수 있는 변경 사항만 영향을 받습니다.

reconfig 명령에 대한 자세한 내용은Sun Java System Web Server 7.0 Update 3 Administrator’s Configuration File Reference의 Dynamic Reconfiguration을 참조하십시오.

주 –

user, temp-path, log, thread-pool, pkcs11, statistics, CGI, DNS, DNS-cache, file-cache, ACL-cache, SSL-session-cache, access-log-buffer 및 JVM(log-level 제외) 설정의 변경 사항은 다시 구성한 후에 적용되지 않습니다. 다시 시작해야 하는 이러한 변경은 다시 구성을 수행하면 기록됩니다. 파일 캐시를 다시 구성하려면 서버를 다시 시작해야 합니다.

노드 탭을 눌러 서버에 구성된 노드 목록을 봅니다.
노드 이름 확인란을 선택하여 노드를 선택합니다.
인스턴스 다시 구성 버튼을 눌러 페이지 창을 열고 해당 노드에 배포된 모든 인스턴스를 나열합니다.
인스턴스를 선택하고 인스턴스 다시 구성 버튼을 클릭하여 인스턴스를 다시 구성합니다.
인스턴스 상태가 실행중인지 확인하고 창을 닫습니다.

주 –

CLI 사용

CLI를 통해 서버 인스턴스를 다시 구성하려면 다음 명령을 실행합니다.

wadm> reconfig-instance --user=admin --password-file=admin.pwd 
--host=serverhost --port=8989 --config=config1 serverhost

CLI 참조 reconfig-instance(1)를 참조하십시오.

서버 인스턴스 삭제

주 –

서버 인스턴스를 삭제하려면 실행 중이 아니어야 합니다.

구성 탭을 눌러 사용 가능한 구성 목록을 봅니다.
구성 목록에서 구성을 선택합니다.
인스턴스 하위 탭을 누릅니다.
노드 섹션 아래에 있는 배포된 인스턴스 목록에서 인스턴스를 선택합니다.
작업 드롭다운 목록에서 인스턴스 삭제를 선택하여 선택한 인스턴스를 삭제합니다.

주 –

CLI 사용

CLI를 통해 서버 인스턴스를 삭제하려면 다음 명령을 실행합니다.

wadm> delete-instance --user=admin --password-file=admin.pwd --host=serverhost 
--port=8989 --config=config1 serverhost

CLI 참조 delete-instance(1)를 참조하십시오.

인스턴스 자동 구성

예약된 이벤트를 기준으로 인스턴스를 다시 구성하거나 다시 시작할 수 있습니다. 자동 인스턴스 재구성 예약에 대해 특정 시간과 간격을 설정할 수 있습니다.

이벤트를 예약하려면 다음 작업을 수행하십시오.

구성 탭을 누르고 구성을 선택합니다.
일반 하위 탭 > 예약된 이벤트 하위 탭을 누릅니다.

예약된 이벤트 추가

구성을 선택합니다.

구성 탭을 누른 후에 표시되는 목록에서 구성을 선택합니다.

일반 > 예약된 이벤트 하위 탭을 누릅니다.

새로 만들기 버튼을 누릅니다.

다음 등록 정보를 구성합니다.
- 이벤트
  - 인스턴스 다시 시작 — 이 예약된 이벤트는 구성에 대해 배포되어 실행 중인 모든 인스턴스를 다시 시작합니다.
  - 인스턴스 다시 구성 — 이 예약된 이벤트는 구성에 대해 배포되어 실행 중인 모든 인스턴스를 다시 구성합니다.
  - 사용자 정의 명령줄 — 실행할 파일의 절대 경로를 제공합니다.
- 일정
  
  이벤트를 시작하도록 구성된 시간입니다. 드롭다운 상자에서 시간 및 분 값을 선택합니다.
  - 매일 — 지정된 이벤트를 매일 지정된 시간에 시작합니다.
  - 특정 일 — 지정된 이벤트를 특정 날짜에 시작합니다.
    
    1. 요일 — 일요일부터 토요일까지의 요일을 지정합니다.
    
    2. 날짜 — 쉼표로 항목을 구분하여 1일부터 31일까지의 날짜를 지정합니다. (예: 4,23,9).
  - 특정 월 — 지정된 이벤트를 특정 시간 및 월에 시작합니다. 1월부터 12월까지의 월을 지정합니다.
  - 간격
    
    지정된 이벤트를 이 기간 후에 시작합니다.
    
    1. 1시간마다 — 드롭다운 상자에서 시간 단위를 선택합니다.
    
    2. 1초마다 — 텍스트 필드에 초 값을 입력합니다.
주 –
CLI 사용

CLI를 통해 이벤트를 예약하려면 다음 명령을 실행합니다.
wadm> create-event --user=admin --password-file=admin.pwd --host=serverhost --port=8989 --config=config1 --time=10:10 --command=restart
CLI 참조 create-event(1)를 참조하십시오.

예약된 이벤트를 제거하는 방법

구성을 선택합니다.

구성 탭을 누른 후에 표시되는 목록에서 구성을 선택합니다.

일반 > 예약된 이벤트 하위 탭을 누릅니다.

예약된 이벤트를 선택하고 삭제 버튼을 누릅니다.

Administration Server에 대한 LDAP 인증 구성

Administration Server에는 사전 정의된 관리자 한 명만 로그인할 수 있으며 사용자 그룹 관리를 허용하지 않습니다. 따라서 여러 명의 사용자가 Administration Server에 로그인해야 하는 경우 LDAP 인증을 사용합니다. 관리 콘솔이나 CLI에서 LDAP 사용자 아이디와 비밀번호를 사용하여 Administration Server에 로그인할 수 있습니다.

주 –

기본적으로 Administration Server에서는 wsadmin 그룹에 속하는 사용자만 로그인할 수 있습니다. 그러므로 LDAP 인증을 활성화하는 동안 관리자는 wsadmin이 아닌 다른 그룹 목록을 정의하여 해당 구성원의 로그인을 허용할 수 있습니다.

아래와 같이 Administration Server에서 LDAP로 인증할 수 있도록 LDAP auth-db를 수동으로 구성할 수도 있습니다.

<default-auth-db-name>ldap</default-auth-db-name>

<auth-db>
<name>ldap</name>
<url>ldap://ooooxxxxooooo.india.sun.com:389/dc963dindia,dc963dsun,dc963dcom</url>
<property>
<name>bindpw</name>
<value>YWRtaW5hZG1pbg==</value>
<encoded>true</encoded>
</property>
<property>
<name>binddn</name>
<value>cn=Directory Manager</value>
</property>
</auth-db>

LDAP 인증을 구성하는 방법

관리 콘솔에 로그인합니다.

노드 탭을 눌러 서버에 구성된 노드 목록을 확인합니다.

목록에서 관리 노드를 누릅니다.

Administration Server - 일반 설정 페이지에서 인증을 선택합니다.

LDAP 인증 사용 버튼을 선택합니다.

주 –
LDAP 인증 사용은 Administration Server인 경우에만 활성화됩니다.

LDAP 인증 정보를 입력합니다.

관리자는 허용된 그룹 텍스트 필드에 사용자 그룹을 입력하여 그룹에 대해 LDAP 인증을 활성화하거나 비활성화합니다.

저장 버튼을 누릅니다.

주 –

CLI 사용

Administration Server에서 LDAP 서버에 대한 인증을 활성화하려면 다음 명령을 실행합니다.

wadm enable-admin-ldap-auth --user=admin --host=serverhost 
--password-file=../admin.passwd --port=8989 --ssl=true --no-prompt rcfile=null 
--ldap-url=ldap://serverhost.com:3950/dc=xyz,dc=xyz,dc=xyz 
--bind-dn=cn="Directory Manager"

wadm enable-admin-ldap-auth --user=admin --host=serverhost 
--password-file=../admin.passwd --port=8989 --ssl=true 
--ldap-url=ldap://serverhost:port/dc=acme,dc=com 
--allow-group="group1,group2,group3"

CLI 참조 enable-admin-ldap-auth(1)를 참조하십시오.

LDAP 서버에 대한 Administration Server 인증을 비활성화하려면 다음 명령을 실행합니다.
wadm disable-admin-ldap-auth --user=admin --host=serverhost --password-file=../admin.passwd --port=8989 --ssl=true --no-prompt --rcfile=null
CLI 참조 disable-admin-ldap-auth(1)를 참조하십시오.

Administration Server LDAP 인증 등록 정보를 보려면 다음 명령을 실행합니다.

wadm get-admin-ldap-auth-prop --user=admin --host=serverhost 
--password-file=../admin.passwd --port=8989 --ssl=true --no-prompt rcfile=null

wadm get-admin-ldap-auth-prop --user=admin 
--host=serverhost --password-file=../admin.passwd --port=8989 --ssl=true 
--no-prompt rcfile=null allow-group

CLI 참조 get-admin-ldap-auth-prop(1)를 참조하십시오.