노드 에이전트 작업

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

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

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

• 노드 에이전트 만들기

• 노드 에이전트 시작

• 노드 에이전트 중지

• 노드 에이전트 삭제

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

• 노드 에이전트 구성 삭제

• 노드 에이전트 구성 편집

• 노드 에이전트 영역 편집

• 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. 저장을 누릅니다.