8장 노드 에이전트 구성

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

• 노드 에이전트란?

• 노드 에이전트 실패 후 서버 인스턴스 동작

• 노드 에이전트 배포

• 노드 에이전트 및 도메인 관리 서버 동기화

• 노드 에이전트 로그 보기

• 노드 에이전트 작업

노드 에이전트란?

노드 에이전트는 DAS(Domain Administration Server)를 호스트하는 시스템을 비롯한 서버 인스턴스를 호스트하는 모든 시스템에 필요한 경량 프로세스입니다. 노드 에이전트는 다음과 같습니다.

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

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

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

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

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

  

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

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

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

노드 에이전트 실패 후 서버 인스턴스 동작

소프트웨어 오류 또는 기타 오류 때문에 노드 에이전트가 예기치 않게 중지될 수 있습니다. 이런 상황에서는 노드 에이전트가 관리하던 모든 서버 인스턴스가 더 이상 관리되지 않습니다. 하지만 이러한 서버 인스턴스는 계속 실행되며 DAS에서 액세스할 수 있습니다. 서버 인스턴스에 대한 정보를 여전히 Application Server 관리 인터페이스에서 확인할 수 있으며 서버 인스턴스에 배포된 응용 프로그램에도 계속 액세스할 수 있습니다.

노드 에이전트가 다시 시작되면 관리되지 않는 서버 인스턴스는 관리되지 않는 상태로 유지됩니다. 노드 에이전트는 이러한 서버 인스턴스의 관리를 다시 시작하지 않습니다. 소프트웨어 오류나 기타 오류로 인해 관리되지 않는 서버 인스턴스가 예기치 않게 중지되는 경우 노드 에이전트는 서버 인스턴스를 다시 시작할 수 없습니다.

관리되지 않는 서버 인스턴스가 계속 실행되어야 하는 경우 노드 에이전트를 통한 서버 인스턴스 관리를 다시 시작할 수 없습니다. 관리되지 않는 서버 인스턴스의 관리를 다시 시작하는 유일한 방법은 노드 에이전트 다시 시작 후 서버 인스턴스를 중지했다가 다시 시작하는 것입니다.

노드 에이전트 배포

다음의 두 가지 방법으로 노드 에이전트를 구성하고 배포할 수 있습니다.

• 온라인 배포 - 토폴로지를 알고 있으며 도메인에 맞는 하드웨어가 이미 준비된 경우

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

노드 에이전트를 온라인으로 배포

도메인 토폴로지를 이미 알고 있고 도메인에 맞는 하드웨어가 준비된 경우 온라인 배포를 사용합니다.

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

시작하기 전에

Domain Administration Server를 설치 및 시작합니다. DAS를 실행하고 온라인 또는 오프라인 배포를 시작합니다.

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

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

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

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

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

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

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

노드 에이전트를 오프라인으로 배포

개별 로컬 시스템을 구성하기 전에 도메인에 노드 에이전트를 배포하려면 오프라인 배포를 사용합니다.

다음 그림에서는 오프라인 배포를 요약하여 설명합니다.

시작하기 전에

Domain Administration Server를 설치 및 시작합니다. DAS를 실행하고 온라인 또는 오프라인 배포를 시작합니다.

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

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

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

   서버 인스턴스를 만들 때는 아직 사용되고 있지 않은 포트 번호를 지정해야 합니다. 구성이 오프라인 상태에서 수행되므로 도메인은 작성 시에 포트 충돌을 확인할 수 없습니다.

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

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

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

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

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

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

노드 에이전트 및 도메인 관리 서버 동기화

구성 데이터가 Domain Administration Server의 저장소(중앙 저장소)에 저장되고 노드 에이전트의 로컬 시스템에도 캐시되므로 두 위치를 동기화해야 합니다. 캐시 동기화는 항상 관리 도구를 통한 명시적인 사용자 작업에서 수행됩니다.

이 절은 다음 내용으로 구성되어 있습니다.

• 노드 에이전트 동기화

• 서버 인스턴스 동기화

• 라이브러리 파일 동기화

• 고유한 설정 및 구성 관리

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

노드 에이전트 동기화

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

기본적으로 asadmin start-node-agent 명령은 DAS와 동기화되지 않고 원격 서버 인스턴스를 자동으로 시작합니다. DAS에서 관리되는 중앙 저장소와 동기화된 원격 서버 인스턴스를 시작하려면 asadmin start-node-agent 명령의 --startinstances=false 옵션을 지정합니다. 그런 다음 asadmin start-instance 명령을 사용하여 원격 서버 인스턴스를 시작합니다.

DAS에 자리 표시자 노드 에이전트를 만든 경우 노드 에이전트를 처음 시작하면 DAS의 중앙 저장소에서 구성을 가져옵니다. 초기 시작 중에 DAS가 실행되지 않아서 노드 에이전트가 DAS에 연결할 수 없는 경우 노드 에이전트가 중지되고 바인딩되지 않습니다.

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

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

서버 인스턴스 동기화

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

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

원격 서버 인스턴스의 구성은 캐시(nodeagents/na1/server1 아래의 모든 파일)로 처리되며 Application Server가 소유합니다. 사용자가 원격 서버 인스턴스의 모든 파일을 제거하고 노드 에이전트를 다시 시작하는 극단적인 경우에는 원격 서버 인스턴스(예: server1)가 다시 만들어지고 필요한 모든 파일이 동기화됩니다.

다음 파일과 디렉토리는 Application Server에 의해 동기화된 상태로 유지됩니다.

라이브러리 파일 동기화

응용 프로그램에 대한 --libraries 배포 시간 속성을 사용하여 응용 프로그램의 런타임 종속성을 지정할 수 있습니다. 상대 경로가 지정된 경우(jar 이름만) Application Server는 domain-dir /lib/applibs에서 지정된 라이브러리 찾기를 시도합니다.

전체 도메인에서 라이브러리를 사용할 수 있게 하려면 JAR 파일을 domain-dir/lib 또는 domain-dir/lib/classes에 둘 수 있습니다. 자세한 내용은 Sun Java System Application Server 9.1 Developer’s Guide 의 Using the Common Class Loader를 참조하십시오. 이 작업은 도메인의 모든 응용 프로그램에서 공유하는 JDBC 드라이버 및 기타 유틸리티 라이브러리에 일반적으로 적용됩니다.

클러스터 전체 또는 독립 실행형 서버 전체에서 사용하는 경우에는 jar을 domain-dir/domain1/config/xyz-config/lib 디렉토리에 복사합니다. 그런 다음 jar를 xyz-config의 classpath-suffix 또는 classpath-prefix 요소에 추가합니다. 이렇게 하면 xyz-config를 사용하는 모든 서버 인스턴스에 대해 jar가 동기화됩니다.

요약하면 다음과 같습니다.

• domains/domain1/lib - 도메인 전체 범위, 일반 클래스 로더. jar을 자동으로 추가합니다.

• domains/domain1/config/cluster1, config/lib - 구성 전체 범위. classpath-prefix 또는 classpath-suffix를 업데이트합니다.

• domains/domain1/lib/applibs - 응용 프로그램 범위, 응용 프로그램 클래스 로더에 자동으로 추가됩니다.

• domains/domain1/config/cluster1, config/lib/ext - http://java.sun.com/j2se/1.5.0/docs/guide/extensions/extensions.html에 자동으로 추가됩니다.

고유한 설정 및 구성 관리

구성 파일(domains/domain1/config에 있음)은 도메인에서 동기화됩니다. 독립 실행행 서버 인스턴스(server1)에 사용되는 server1-config에 대한 server.policy 파일을 사용자 정의하려면 수정된 server.policy 파일을 domains/domain1/config/server1-config 디렉토리에 둡니다.

수정된 이 server.policy 파일은 독립 실행형 서버 인스턴스인 server1에 대해서만 동기화됩니다. jvm-option을 업데이트해야 합니다. 예를 들면 다음과 같습니다. <java-config> ... <jvm-options>-Djava.security.policy=${com.sun.aas.instanceRoot}/config/server1-config/server.policy</jvm-options></java-config>

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

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

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

asadmin set 
domain.node-agent.node_agent_name.property.INSTANCE-SYNC-JVM-OPTIONS="JVM_options"

예를 들면 다음과 같습니다.

asadmin set 
domain.node-agent.node0.property.INSTANCE-SYNC-JVM-OPTIONS="-Xmx32m -Xss2m"

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

자세한 내용은 http://java.sun.com/docs/hotspot/VMOptions.html을 참조하십시오.

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

doNotRemoveList 플래그 사용

응용 프로그램이 Application Server가 동기화하는 디렉토리(applications, generated, docroot, config, lib, java-web-start)에서 파일을 저장하고 읽어야 하는 경우 doNotRemoveList 플래그를 사용합니다. 이 속성은 쉼표로 구분된 파일 또는 디렉토리 목록을 사용합니다. 응용 프로그램 종속 파일은 DAS가 관리하는 중앙 저장소에 없는 경우에도 서버 시작 도중에 제거되지 않습니다. 중앙 저장소에 동일한 파일이 있는 경우에는 응용 프로그램 종속 파일이 동기화 중에 덮어써집니다.

INSTANCE-SYNC-JVM-OPTIONS 등록 정보를 사용하여 doNotRemoveList 속성을 전달합니다.

예를 들면 다음과 같습니다.

<node-agent name="na1" ...>

...

<property name="INSTANCE-SYNC-JVM-OPTIONS" value="-Dcom.sun.appserv.doNotRemoveList=applications/j2ee-modules/<webapp_context>/logs,generated/mylogdir"/>

</node–agent>

노드 에이전트 로그 보기

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

node_agent_dir /node_agent_name/agent/logs/server.log

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

서버 로그는 다음 위치에 있습니다.

node_agent_dir/node_agent_name/ server_name/logs/server.log

node_agent_dir의 기본 위치는 install_dir/nodeagents입니다.

노드 에이전트 작업

• 노드 에이전트 작업을 수행하는 방법

• 노드 에이전트 자리 표시자

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

• 노드 에이전트 만들기

• 노드 에이전트 시작

• 노드 에이전트 중지

• 노드 에이전트 삭제

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

• 노드 에이전트 구성 삭제

• 노드 에이전트 구성 편집

• 노드 에이전트 영역 편집

• JMX에 대해 노드 에이전트 수신기 편집

노드 에이전트 작업을 수행하는 방법

일부 노드 에이전트 작업에서는 노드 에이전트가 실행되는 시스템에서 asadmin 도구를 로컬로 사용해야 합니다. 다른 작업은 관리 콘솔 또는 asadmin을 사용하여 원격으로 수행할 수 있습니다.

다음 표에서는 작업과 작업이 실행되는 위치를 요약하여 설명합니다.

노드 에이전트 자리 표시자

노드 에이전트 자리 표시자를 사용하여 기존 노드 에이전트 없이도 서버 인스턴스를 만들고 삭제할 수 있습니다. 노드 에이전트 자리 표시자는 노드 에이전트의 로컬 시스템에 노드 에이전트를 만들기 전에 도메인 관리 서버(DAS)에 만들어집니다.

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

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

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

노드 에이전트는 원격 시스템에서 실행 중인 서버 인스턴스에 대한 로컬 워치독입니다. 따라서 노드 에이전트는 서버 인스턴스가 호스팅되는 시스템에서 생성되어야 합니다. 이러한 요구 사항 때문에 관리 콘솔을 사용하여 노드 에이전트에 대한 자리 표시자만 만들 수 있습니다. 이 자리 표시자는 노드 에이전트가 아직 없는 노드 에이전트 구성입니다.

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

노드 에이전트 작성 및 사용과 관련된 작업 단계를 보려면 노드 에이전트 배포를 참조하십시오.

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

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

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

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

4. 확인을 누릅니다.

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

해당 asadmin 명령

create-node-agent-config

노드 에이전트 만들기

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

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

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

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

DAS 및 노드 에이전트가 보안 통신을 수행하도록 구성되었을 수 있습니다. 이런 경우 노드 에이전트가 시작될 때 DAS가 노드 에이전트에 전송하는 인증서를 검증해야 합니다. 인증서를 검증하기 위해 노드 에이전트는 마스터 비밀번호로 보호되는 노드 에이전트의 로컬 truststore에서 인증서를 찾습니다. 노드 에이전트가 비밀번호를 묻지 않고 시작되게 하려면 노드 에이전트를 만들 때 노드 에이전트의 마스터 비밀번호를 파일에 저장합니다. 노드 에이전트의 마스터 비밀번호를 파일에 저장하지 않으면 노드 에이전트를 시작할 때마다 마스터 비밀번호를 묻는 메시지가 나타납니다.

상황에 따라 DNS를 통해 연결할 수 있는 호스트의 이름을 지정해야 할 수 있습니다. 자세한 내용은 DNS 연결 가능 호스트에 대한 노드 에이전트 만들기를 참조하십시오.

노드 에이전트 만들기

1. 다음 명령을 입력합니다.

   asadmin create-node-agent --host das-host --port port-no --user das-user [--savemasterpassword=true] nodeagent

   노드 에이전트가 비밀번호를 묻지 않고 시작되게 하려면 노드 에이전트의 마스터 비밀번호를 파일에 저장합니다. 노드 에이전트의 마스터 비밀번호를 파일에 저장하려면 노드 에이전트를 만드는 명령에서 --savemasterpassword 옵션을 true로 설정합니다.

   --savemasterpassword를 true로 설정한 경우 마스터 비밀번호를 묻는 메시지가 나타납니다. 그렇지 않은 경우에는 비밀번호를 묻는 메시지가 나타나지 않습니다.

   --host das-host

   DAS(Domain Administration Server)를 실행 중인 호스트 이름을 지정합니다.

   -port port-no

   도메인 관리를 위한 HTTP 또는 HTTPS 포트 번호를 지정합니다.

   --user das-user

   DAS 사용자를 지정합니다.

   nodeagent

   만들 노드 에이전트의 이름을 지정합니다. 이 이름은 도메인에서 고유해야 합니다.

예 8–1 노드 에이전트 만들기

asadmin create-node-agent --host myhost --port 4848 --user admin nodeagent1

이 명령은 이름이 nodeagent1인 노드 에이전트를 만듭니다. 노드 에이전트가 통신하는 DAS는 시스템 myhost에서 실행 중입니다. 에이전트의 도메인을 관리하기 위한 HTTP 포트는 4848이고 DAS 사용자 이름은 admin입니다.

DNS 연결 가능 호스트에 대한 노드 에이전트 만들기

DAS가 실행 중인 호스트는 다음과 같은 경우 DNS를 통해 연결할 수 있어야 합니다.

• 도메인이 서브넷 경계를 벗어난 경우. 즉, 노드 에이전트와 DAS가 sun.com 및 java.com과 같이 다른 도메인에 있는 경우

• 호스트 이름이 DNS에 등록되지 않은 DHCP 시스템을 사용하는 경우

1. 도메인을 만드는 create-domain 명령에서 --domainproperties domain.hostName=das-host-name 옵션을 지정합니다.

   das-host-name은 DAS를 실행하는 시스템 이름입니다.

2. 노드 에이전트를 만드는 create-node-agent 명령에서 다음 옵션을 지정합니다.

   • --host das-host-name. 여기서 das-host-name은 단계 1에서 지정한 DAS 호스트 이름입니다. 이 옵션은 as-install/nodeagents/nodeagentname/agent/config/das.properties 파일의 agent.das.host 등록 정보에 해당합니다.

   • --agentproperties remoteclientaddress=node-agent-host-name. 여기서 node-agent-host-name은 DAS가 노드 에이전트에 연결하기 위해 사용하는 호스트 이름입니다. 이 옵션은 as-install/nodeagents/nodeagentname/agent/config/nodeagent.properties 파일의 agent.client.host 등록 정보에 해당합니다.

hosts 파일을 업데이트하여 호스트 지정

다른 방법으로는 플랫폼과 관련된 hosts hostname/IP 결정 파일을 업데이트하여 호스트 이름이 올바른 IP 주소로 변환될 수 있도록 하는 것입니다. 그러나 DHCP를 사용하여 다시 연결할 경우 다른 IP 주소가 지정될 수 있습니다. 그럴 경우 각 서버에서 호스트 결정 파일을 업데이트해야 합니다.

노드 에이전트 시작

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

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

예를 들면 다음과 같습니다.

asadmin start-node-agent --user admin --startinstances=false nodeagent1

여기서 admin은 관리 사용자이고 nodeagent1은 시작할 노드 에이전트입니다.

기본적으로 노드 에이전트 인스턴스의 캐시 저장소는 노드 에이전트가 다시 시작될 때 중앙 저장소에서 동기화되지 않습니다. 인스턴스의 캐시 저장소를 중앙 저장소와 강제로 동기화하려면 asadmin start-node-agent 명령에서 --syncinstances 옵션을 true로 설정합니다.

--syncinstances 옵션을 true로 설정하면 노드 에이전트가 다시 시작될 때 모든 인스턴스의 저장소가 동기화됩니다.

노드 에이전트를 다시 시작한 후 asadmin start-instance 명령을 사용하여 서버 인스턴스를 시작합니다.

노드 에이전트 중지

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

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

예를 들면 다음과 같습니다.

asadmin stop-node-agent nodeagent1

여기서 nodeagent1은 노드 에이전트의 이름입니다.

노드 에이전트 삭제

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

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

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

예를 들면 다음과 같습니다.

asadmin delete-node-agent nodeagent1

여기서 nodeagent1은 노드 에이전트입니다.

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

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

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

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

   노드 에이전트가 이미 존재하지만 여기에 나타나지 않으면 asadmin start-node-agent를 사용하여 노드 에이전트의 호스트 시스템에서 노드 에이전트를 시작합니다. 노드 에이전트 시작을 참조하십시오.

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

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

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

   상태는 다음과 같을 수 있습니다.

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

   • 실행 중이 아님: 노드 에이전트가 로컬 시스템에서 만들어졌으나 시작되지 않았거나 노드 에이전트가 시작되었으나 중지되었습니다.

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

   노드 에이전트 만들기 및 노드 에이전트 시작을 참조하십시오.

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

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

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

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

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

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

노드 에이전트 구성 삭제

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

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

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

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

3. 삭제를 누릅니다.

해당 asadmin 명령

delete-node-agent-config

노드 에이전트 구성 편집

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

2. 편집하려면 노드 에이전트 구성을 누릅니다.

3. 시작 시 인스턴스 시작을 선택하여 에이전트가 시작될 때 에이전트의 서버 인스턴스를 시작합니다.

   이 페이지에서 인스턴스를 수동으로 시작 및 중지할 수도 있습니다.

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

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

노드 에이전트 영역 편집

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

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

2. 편집하려면 노드 에이전트 구성을 누릅니다.

3. 인증 영역 탭을 누릅니다.

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

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

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

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

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

JMX에 대해 노드 에이전트 수신기 편집

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

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

2. 편집하려면 노드 에이전트 구성을 누릅니다.

3. JMX 탭을 누릅니다.

4. 주소 필드에 IP 주소 또는 호스트 이름을 입력합니다.

   수신기가 고유한 포트 값을 사용하여 서버에 대한 모든 IP 주소에서 수신할 경우 주소 필드에 0.0.0.0을 입력합니다. 또는 서버에 대한 유효한 IP 주소를 입력합니다.

5. 포트 필드에서 노드 에이전트의 JMX 커넥터가 수신하는 포트를 입력합니다.

   IP 주소가 0.0.0.0일 경우 포트 번호가 고유해야 합니다.

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

   기본값은 rmi_jrmp입니다.

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

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

8. 영역 이름 필드에 수신기에 대한 인증을 처리하는 영역 이름을 입력합니다.

   이 페이지의 보안 섹션에서 SSL 또는 TLS(또는 SSL, TLS 모두) 보안을 사용하도록 수신기를 구성합니다.

   보안 수신기를 설정하려면 다음 작업을 수행합니다.

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

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

10. 클라이언트 인증을 설정합니다.

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

11. 인증서 별명을 입력합니다.

    인증서 별명 필드에 기존 서버 키 쌍 및 인증서의 이름을 입력합니다.

    인증서 및 SSL 작업에 대한 자세한 내용은 관리 콘솔 온라인 도움말을 참조하십시오.

12. SSL3/TLS 섹션:

    1. 수신기에서 활성화할 보안 프로토콜을 선택합니다.

       SSL3, TLS 또는 두 가지 프로토콜을 모두 선택해야 합니다.

    2. 프로토콜이 사용하는 암호화 제품군을 선택합니다.

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

13. 저장을 누릅니다.