4장 노드 에이전트 구성

이 장에서는 Application Server의 노드 에이전트를 설명합니다. 이 장은 다음 내용으로 구성되어 있습니다.

노드 에이전트 정보

노드 에이전트

노드 에이전트 자리 표시자

노드 에이전트 배포

노드 에이전트 및 DAS 동기화

노드 에이전트 로그 보기

관리 콘솔 및 asadmin 도구를 통해 사용 가능한 작업

노드 에이전트

노드 에이전트는 DAS(Domain Administration Server)를 호스트하는 시스템을 포함하여 서버 인스턴스를 호스트하는 모든 시스템에서 필요한 경량의 에이전트입니다. 노드 에이전트는

DAS(Domain Administration Server)에서 지시하는 대로 서버 인스턴스를 시작, 중지, 작성 및 삭제합니다.

실패한 서버 인스턴스를 다시 시작합니다.

실패한 서버의 로그 파일 보기를 제공합니다.

각 서버 인스턴스의 로컬 구성 저장소를 DAS의 중앙 저장소와 동기화합니다. 각 로컬 저장소에는 해당 서버 인스턴스나 노드 에이전트에 관련된 정보만 포함되어 있습니다.

다음 그림에서는 전반적인 노드 에이전트 구조를 설명합니다.

자동으로 만든 노드 에이전트

Application Server를 설치하면 기본적으로 시스템의 호스트 이름으로 노드 에이전트가 만들어집니다. 이 노드 에이전트는 로컬 시스템에서 수동으로 시작해야 작동합니다.

노드 에이전트 및 서버 인스턴스 관리

노드 에이전트를 실행하지 않더라도 서버 인스턴스를 만들고 삭제할 수 있습니다. 그러나, 노드 에이전트를 실행해야 노드 에이전트를 사용하여 서버 인스턴스를 시작 및 중지할 수 있습니다.

노드 에이전트를 중지하면 노드 에이전트가 관리하는 서버 인스턴스도 중지됩니다.

추가 노드 에이전트

노드 에이전트 하나는 한 도메인만 지원합니다. 한 시스템이 여러 도메인에서 실행하는 인스턴스를 호스트할 경우 복수 노드 에이전트를 실행해야 합니다.

노드 에이전트 자리 표시자

노드 에이전트 자리 표시자를 사용하여 기존 노드 에이전트 없이 서버 인스턴스를 만들고 삭제할 수 있습니다. 자리 표시자는 노드 에이전트의 로컬 시스템에 노드 에이전트를 만들기 전에 DAS(Domain Administration Server)에 만든 노드 에이전트 구성입니다.



주	자리 표시자 노드 에이전트를 만들었으면 이를 사용하여 해당 도메인에 인스턴스를 만들 수 있습니다. 그러나 인스턴스를 시작하기 전에 `asadmin` 명령을 사용하여 인스턴스가 상주하는 시스템에서 로컬로 실제 노드 에이전트를 만들고 시작해야 합니다. 자세한 내용은 "노드 에이전트 만들기" 및 "노드 에이전트 시작"을 참조하십시오.

노드 에이전트 배포

다음 두 가지 방법 중 하나로 노드 에이전트를 구성하고 배포합니다.

온라인 배포 - 구성하기 전에 사용자 토폴로지를 알고 있고 도메인에 맞는 하드웨어를 갖고 있는 경우

오프라인 배포 - 전체 환경을 설정하기 전에 도메인 및 서버 인스턴스를 구성할 경우

노드 에이전트를 배포하기 전

DAS(Domain Administration Server)를 설치합니다.

DAS를 시작합니다.

온라인 배포

구성을 시작하기 전에 토폴로지를 알고 있고 도메인에 맞는 하드웨어를 갖고 있는 경우 도메인을 구성하려면 온라인 배포를 사용합니다.

다음 그림에서는 노드 에이전트의 온라인 배포를 요약합니다.

서버 인스턴스를 호스트할 모든 시스템에 노드 에이전트를 설치합니다.

설치 프로그램이나 asadmin 명령 create-node-agent를 사용합니다. 시스템에 둘 이상의 노드 에이전트가 필요할 경우 asadmin 명령 create-node-agent를 사용하여 노드 에이전트를 만듭니다.

자세한 내용은 "노드 에이전트 만들기"를 참조하십시오.

asadmin 명령 start-node-agent를 사용하여 노드 에이전트를 시작합니다.

노드 에이전트를 시작하면 노드 에이전트는 DAS(Domain Administration Server)와 통신합니다. 노드 에이전트가 DAS에 연결되면 노드 에이전트의 구성이 DAS에 만들어집니다. 구성이 존재하면 관리 콘솔에서 그 노드 에이전트를 볼 수 있습니다.

자세한 내용은 "노드 에이전트 시작"을 참조하십시오.

서버 인스턴스 및 클러스터 작성과 응용 프로그램 배포 등 도메인을 구성합니다.

오프라인 배포

오프라인 방법을 사용하면 개별 로컬 시스템을 구성하기 전에 도메인의 항목을 쉽게 정의하고 재배열할 수 있습니다.

로컬 시스템에 노드 에이전트를 설치하기 전에 도메인과 서버 인스턴스를 구성하려면(오프라인 구성) 다음 단계를 수행합니다.

DAS에 자리 표시자 노드 에이전트를 만듭니다.

자세한 내용은 "노드 에이전트 자리 표시자 만들기"를 참조하십시오.

서버 인스턴스와 클러스터를 만들고 응용 프로그램을 배포합니다.

서버 인스턴스를 호스트할 모든 시스템에 노드 에이전트를 설치합니다.

설치 프로그램이나 asadmin 명령 create-node-agent를 사용합니다. 노드 에이전트의 이름은 이전에 만든 자리 표시자 노드 에이전트와 동일해야 합니다.

자세한 내용은 "노드 에이전트 만들기"를 참조하십시오.

asadmin 명령 start-node-agent를 사용하여 노드 에이전트를 시작합니다.

노드 에이전트가 시작되면 DAS에 바인딩되고 이전에 연관된 모든 서버 인스턴스를 만듭니다.

자세한 내용은 "노드 에이전트 시작"을 참조하십시오.

노드 에이전트 및 DAS 동기화

구성 데이터가 DAS의 저장소(중앙 저장소)에 저장되고 노드 에이전트의 로컬 시스템에도 캐시되기 때문에 이 둘을 동기화해야 합니다.

노드 에이전트 동기화

노드 에이전트를 처음 시작하면 중앙 저장소의 최신 정보에 대한 요청을 DAS에 전송합니다. DAS에 연결하여 구성 정보를 가져오면 노드 에이전트는 그 DAS에 바인딩됩니다.

DAS에 자리 표시자 노드 에이전트를 만든 경우 노드 에이전트를 처음 시작하면 DAS의 중앙 저장소에서 구성을 가져옵니다.

초기 시작 중에 DAS가 실행되지 않아서 노드 에이전트가 DAS에 연결할 수 없는 경우 노드 에이전트가 중지되고 바인딩되지 않습니다.

도메인에서 노드 에이전트 구성을 변경하면 노드 에이전트를 실행 중일 때 로컬 시스템의 노드 에이전트와 자동으로 통신합니다.

DAS에서 노드 에이전트 구성을 삭제하면 다음에 노드 에이전트가 동기화할 때 스스로 중지하고 삭제 대기로 표시합니다. 로컬 asadmin 명령 delete-node-agent를 사용하여 수동으로 삭제합니다.

서버 인스턴스 동기화

관리 콘솔이나 asadmin 도구를 사용하여 서버 인스턴스를 명시적으로 시작하면 서버 인스턴스는 중앙 저장소와 동기화됩니다. 이 동기화가 실패하면 서버 인스턴스가 시작되지 않습니다.

관리 콘솔이나 asadmin 도구를 통한 명시적인 요청 없이 노드 에이전트가 서버 인스턴스를 시작하면 서버 인스턴의 저장소 캐시가 동기화되지 않습니다. 서버 인스턴스는 해당 캐시에 저장된 구성으로 실행됩니다.

대용량 응용 프로그램 동기화

환경에 동기화할 대용량 응용 프로그램이 포함되거나 사용 가능한 메모리가 제한된 경우 JVM 옵션을 조정하여 메모리 사용을 제한할 수 있습니다. 이렇게 조정하면 메모리 부족 오류 발생 가능성이 줄어듭니다. 인스턴스 동기화 JVM은 기본 설정을 사용하지만 JVM 옵션을 구성하여 변경할 수 있습니다.

INSTANCE-SYNC-JVM-OPTIONS 등록 정보를 사용하여 JVM 옵션을 설정합니다. 등록 정보를 설정하는 명령은 다음과 같습니다.

이 예에서 노드 에이전트는 node0이고 JVM 옵션은 -Xmx32m -Xss2m입니다.

노드 에이전트 로그 보기

모든 노드 에이전트에는 고유한 로그 파일이 있습니다. 노드 에이전트에 문제가 생기면 다음 위치에 있는 로그 파일을 참조하십시오.

노드 에이전트 로그에서 서버의 로그를 확인하여 문제점에 대한 자세한 메시지를 확인할 것을 권장할 때도 있습니다.

관리 콘솔 및 asadmin 도구를 통해 사용 가능한 작업

노드 에이전트의 경우 일부 작업은 노드 에이전트가 실행되는 시스템에서 로컬로 실행해야 하지만, 일부 작업은 DAS에서 실행할 수 있습니다. 로컬로 실행해야 하는 작업은 노드 에이전트가 상주하는 시스템에서 asadmin 도구를 통해서만 작업이 가능합니다. DAS에서 실행되는 작업은 관리 콘솔과 asadmin 도구를 통해 할 수 있습니다.


주	구성에서 등록 정보를 추가하거나 변경한 경우 노드 에이전트가 자동으로 동기화되지 않으므로 INSTANCE-SYNC-JVM-OPTIONS 등록 정보를 변경한 후 노드 에이전트를 다시 시작합니다.

표 4-1 관리 콘솔과 asadmin 명령을 통해 사용 가능한 작업
작업	관리 콘솔	asadmin 명령
DAS에 노드 에이전트 자리 표시자/구성 만들기	노드 에이전트 자리 표시자 만들기 페이지	create-node-agent-config
노드 에이전트 만들기	사용할 수 없음	create-node-agent
노드 에이전트 시작	사용할 수 없음	start-node-agent
노드 에이전트 중지	사용할 수 없음	stop-node agent
DAS에서 노드 에이전트 구성 삭제	노드 에이전트 페이지	delete-node-agent-config
로컬 시스템에서 노드 에이전트 삭제	사용할 수 없음	delete-node-agent
노드 에이전트 구성 편집	노드 에이전트 페이지	set
노드 에이전트 나열	노드 에이전트 페이지	list-node-agents

노드 에이전트에 대한 관리 콘솔 작업

JMX에 대해 노드 에이전트 Listener 편집

일반 노드 에이전트 정보 보기

노드 에이전트나 노드 에이전트 자리 표시자를 만든 경우 설정을 보려면 다음 작업을 수행합니다.

트리 구성 요소에서 노드 에이전트 노드를 선택합니다.

노드 에이전트 이름을 누릅니다.

노드 에이전트가 이미 있지만 여기에 표시되지 않는 경우 asadmin start-node-agent를 사용하여 노드 에이전트의 호스트 시스템에서 노드 에이전트를 시작합니다. 자세한 내용은 "노드 에이전트 시작"을 참조하십시오.

노드 에이전트의 호스트 이름을 확인합니다.

호스트 이름이 알 수 없는 호스트일 경우 노드 에이전트가 DAS와 초기 연결하지 않았기 때문입니다.

노드 에이전트 상태를 확인합니다.

실행 중. 노드 에이전트를 제대로 만들었고 현재 실행 중입니다.

실행 중이 아님. 다음 조건 중 하나가 존재합니다.

로컬 시스템에서 노드 에이전트를 만들었지만 시작한 적이 없습니다.

노드 에이전트를 시작했지만 중지되었습니다.

랑데부 대기 중. 노드 에이전트가 로컬 시스템에 작성된 적이 없는 자리 표시자입니다.

노드 에이전트 작성 및 시작에 대한 자세한 내용은 "노드 에이전트 만들기" 및 "노드 에이전트 시작"을 참조하십시오.

시작 시 인스턴스를 시작할지 여부를 선택합니다.

노드 에이전트를 시작할 때 노드 에이전트와 연관된 서버 인스턴스를 자동으로 시작하려면 예를 선택합니다. 인스턴스를 수동으로 시작하려면 아니오를 선택합니다.

노드 에이전트가 DAS와 연결했는지 여부를 확인합니다.

노드 에이전트가 DAS에 연결하지 않았으면 성공적으로 시작되지 않습니다.

노드 에이전트와 연결된 서버 인스턴스를 관리합니다.

노드 에이전트가 실행 중일 경우 인스턴스 이름 옆에 있는 확인란을 선택하고 시작이나 중지를 눌러 인스턴스를 시작하거나 중지합니다.

노드 에이전트 자리 표시자 만들기

노드 에이전트를 호스트하는 시스템에서 로컬로 노드 에이전트를 만들어야 하기 때문에 관리 콘솔을 통해서만 노드 에이전트의 자리 표시자를 만들 수 있습니다. 이 자리 표시자는 노드 에이전트가 아직 없는 노드 에이전트 구성입니다.

자리 표시자를 만든 후 노드 에이전트를 호스트하는 시스템에서 asadmin 명령 create-node-agent를 사용하여 작성을 완료합니다. 자세한 내용은 "노드 에이전트 만들기"를 참조하십시오.

트리 구성 요소에서 노드 에이전트 노드를 선택합니다.

노드 에이전트 페이지에서 새로 만들기를 누릅니다.

현재 노드 에이전트 자리 표시자 페이지에서 새로운 노드 에이전트의 이름을 입력합니다.

도메인의 모든 노드 에이전트 이름, 서버 인스턴스 이름, 클러스터 이름 및 구성 이름에서 이름이 고유해야 합니다.

확인을 누릅니다.

노드 에이전트 페이지에 새로운 노드 에이전트의 자리 표시자가 나열됩니다.

노드 에이전트 구성 삭제

관리 콘솔을 통해서만 도메인에서 노드 에이전트 구성을 삭제할 수 있습니다. 실제 노드 에이전트는 삭제할 수 없습니다. 노드 에이전트 자체를 삭제하려면 노드 에이전트의 로컬 시스템에서 asadmin 명령 delete-node-agent를 실행합니다. 자세한 내용은 "노드 에이전트 삭제"를 참조하십시오.

노드 에이전트 구성을 삭제하기 전에 노드 에이전트를 중지해야 하고 연관된 인스턴스가 없어야 합니다. 노드 에이전트를 중지하려면 asadmin 명령 stop-node-agent를 사용합니다. 자세한 내용은 "노드 에이전트 중지"를 참조하십시오.

트리 구성 요소에서 노드 에이전트 노드를 선택합니다.

노드 에이전트 페이지에서 삭제할 노드 에이전트 옆에 있는 확인란을 선택합니다.

삭제를 누릅니다.

노드 에이전트 구성 편집

트리 구성 요소에서 노드 에이전트 노드를 확장합니다.

편집하려면 노드 에이전트 구성을 선택합니다.

노드 에이전트 일반 정보 페이지에서 에이전트를 시작할 때 에이전트의 서버 인스턴스를 시작할지 여부를 선택합니다. 이 페이지에서 인스턴스를 수동으로 시작 및 중지할 수도 있습니다.

이 구성이 자리 표시자 노드 에이전트를 위한 것일 경우 asadmin create-node-agent를 사용하여 실제 노드 에이전트를 만들 때 이 구성을 사용합니다. 노드 에이전트 만들기에 대한 자세한 내용은 "노드 에이전트 만들기"를 참조하십시오.

이 구성이 기존 노드 에이전트를 위한 것일 경우 노드 에이전트 구성 정보가 자동으로 동기화됩니다.

노드 에이전트 영역 편집

노드 에이전트에 연결하는 사용자를 위한 인증 영역을 설정합니다. 관리 사용자만 노드 에이전트에 액세스해야 합니다.

트리 구성 요소에서 노드 에이전트 노드를 확장합니다.

편집하려면 노드 에이전트 구성을 선택합니다.

인증 영역 탭을 누릅니다.

노드 에이전트 영역 편집 페이지에서 영역을 입력합니다.

노드 에이전트를 만들 때 만들어진 admin-realm이 기본값입니다. 다른 영역을 사용하려면 도메인에서 제어하는 모든 구성 요소의 영역을 대체합니다. 그렇지 않으면 구성 요소가 제대로 통신하지 못합니다.

클래스 이름 필드에서 영역을 구현하는 Java 클래스를 지정합니다.

필수 등록 정보를 모두 추가합니다.

인증 영역에는 공급자 관련 등록 정보가 필요한데, 특정 구현에서 요구하는 내용에 따라 다릅니다.

JMX에 대해 노드 에이전트 Listener 편집

노드 에이전트에서는 JMX를 사용하여 DAS와 통신합니다. 따라서 JMX 요청을 수신하려면 포트와 다른 listener 정보가 있어야 합니다.

트리 구성 요소에서 노드 에이전트 노드를 확장합니다.

편집하려면 노드 에이전트 구성을 선택합니다.

JMX 탭을 누릅니다.

Listener가 고유한 포트 값을 사용하여 서버에 대한 모든 IP 주소에서 수신할 경우 주소 필드에 0.0.0.0을 입력합니다. 그렇지 않으면 서버에 대한 유효한 IP 주소를 입력합니다.

포트 필드에서 노드 에이전트의 JMX 커넥터가 수신하는 포트 값을 입력합니다. IP 주소가 0.0.0.0일 경우 포트 번호가 고유해야 합니다.

JMX 프로토콜 필드에서 JMX 커넥터가 지원하는 프로토콜을 입력합니다.

기본값은 rmi_jrmp입니다.

모든 IP 주소에 대한 연결을 허용하려면 모든 주소 허용 옆에 있는 확인란을 누릅니다.

노드 에이전트는 네트워크 카드에 연결된 특정 IP 주소에서 수신하거나 모든 IP 주소에서 수신합니다. 모든 주소를 허용하면 "listening host address" 등록 정보에 0.0.0.0 값이 입력됩니다.

영역 이름 필드에서 Listener에 대한 인증을 처리하는 영역 이름을 입력합니다.

이 페이지의 보안 섹션에서 Listener가 SSL, TLS 또는 SSL 및 TLS 보안을 둘 다 사용하도록 구성합니다.

보안 필드에서 사용 가능 확인란을 선택합니다.

보안은 기본적으로 활성화되어 있습니다.

이 Listener를 사용할 때 클라이언트가 자신을 서버에 인증하도록 하려면 클라이언트 인증 필드에서 사용 가능 확인란을 선택합니다.

인증서 별명 필드에 기존 서버의 키 쌍과 인증서를 입력합니다. 자세한 내용은 보안 장을 참조하십시오.

SSL3/TLS 섹션:

Listener에서 활성화할 보안 프로토콜을 선택합니다. SSL3, TLS 또는 두 가지 프로토콜을 모두 선택해야 합니다.

프로토콜이 사용하는 암호 제품군을 선택합니다. 모든 암호 제품군을 사용하려면 지원되는 모든 암호화 제품군을 선택합니다.

저장을 누릅니다.

asadmin 도구에서 노드 에이전트에 대한 작업

노드 에이전트 만들기

노드 에이전트를 만들려면 노드 에이전트가 실행 중인 시스템에서 로컬로 asadmin 명령 create-node-agent를 실행합니다.

$ asadmin create-node-agent --host myhost --port 4849 ---user admin nodeagent1

여기에서 myhost는 DAS 호스트 이름, 4849는 DAS 포트 번호, admin은 DAS 사용자, nodeagent1은 만들려는 노드 에이전트 이름입니다.

노드 에이전트의 기본 이름은 노드 에이전트가 만들어지는 호스트 이름입니다.

노드 에이전트 자리 표시자를 이미 만든 경우 노드 에이전트 자리 표시자와 동일한 이름을 사용하여 연관된 노드 에이전트를 만듭니다. 노드 에이전트 자리 표시자를 만들지 않았지만 DAS를 실행 중이고 연결할 수 있는 경우 create-node-agent 명령으로도 DAS에 노드 에이전트 구성(자리 표시자)을 만들 수 있습니다.

명령 구문에 대한 자세한 설명은 명령에 대한 온라인 도움말을 참조하십시오.



주	다음 상황에서는 DNS에 연결 가능한 호스트 이름을 지정해야 합니다. 1. 도메인이 서브넷 경계에 걸쳐 있을 경우(즉, 노드 에이전트와 DAS가 서로 다른 도메인(예: sun.com 및 java.com)에 있을 경우) 2. DNS에 등록되지 않은 호스트 이름의 DHCP 시스템을 사용할 경우 도메인과 노드 에이전트를 만들 때 이들에 대한 호스트 이름을 명시적으로 지정하여 DNS 연결 가능한 호스트 이름을 지정합니다. `create-domain --domainproperties domain.hostName=`DAS-host-name `create-node-agent --host` DAS-host-name `--agentproperties remoteclientaddress=`node-agent-host-name 다른 방법은 플랫폼에 관련된 `hosts` hostname/IP 결정 파일을 업데이트하여 호스트 이름이 올바른 IP 주소로 변환될 수 있도록 하는 것입니다. 그러나 DHCP를 사용하여 다시 연결할 경우 다른 IP 주소가 지정될 수 있습니다. 그럴 경우 각 서버에서 호스트 결정 파일을 업데이트해야 합니다.

노드 에이전트 시작

노드 에이전트가 실행 중이어야 노드 에이전트로 서버 인스턴스를 관리할 수 있습니다. 노드 에이전트가 상주하는 시스템에서 asadmin 명령 start-node-agent를 로컬로 실행하여 노드 에이전트를 시작합니다.

여기에서 admin은 관리 사용자, nodeagent1은 시작하려는 노드 에이전트입니다.

명령 구문에 대한 자세한 설명은 명령에 대한 온라인 도움말을 참조하십시오.

노드 에이전트 중지

실행 중인 노드 에이전트를 중지하려면 노드 에이전트가 상주하는 시스템에서 asadmin 명령 stop-node-agent를 실행합니다. stop-node-agent 명령은 노드 에이전트가 관리하는 모든 서버 인스턴스를 중지합니다.

명령 구문에 대한 자세한 설명은 명령에 대한 온라인 도움말을 참조하십시오.

노드 에이전트 삭제

노드 에이전트 파일을 삭제하려면 노드 에이전트가 상주하는 시스템에서 asadmin 명령 delete-node-agent를 실행합니다.

노드 에이전트를 삭제하기 전에 노드 에이전트를 중지해야 합니다. 시작하지 않았거나 DAS에 연결하지 못했던(즉 바인딩되지 않은) 노드 에이전트를 삭제할 수도 있습니다.

명령 구문에 대한 자세한 설명은 명령에 대한 온라인 도움말을 참조하십시오.

노드 에이전트를 삭제할 경우 관리 콘솔이나 asadmin delete-node-agent-config 명령을 사용하여 DAS에서 노드 에이전트의 구성도 삭제해야 합니다.