registerNode 명령
registerNode 명령을 사용하여 관리 에이전트에서 노드를 관리할 수 있도록 관리 에이전트에 독립형 노드를 등록하십시오.
관리 에이전트 서버의 bin 디렉토리에서 registerNode 명령을 실행하여 관리 에이전트에 노드를 등록하십시오. 명령을 실행하면, 독립형 노드가 관리 에이전트에서 관리되는 노드로 변환됩니다.
관리 에이전트 및 관리되는 노드는 동일한 컴퓨터에 있어야 합니다.
관리 에이전트는 개발, 단위 테스트 또는 서버 팜 환경 등에 있는 여러 비연합(독립형) 애플리케이션 서버 노드를 관리하는 단일 인터페이스를 제공합니다. 애플리케이션 서버를 관리하는 단일 인터페이스를 사용하면 모든 애플리케이션 서버에서 관리 서비스를 실행하는 오버헤드를 줄일 수 있습니다.
관리 에이전트의 관리 콘솔을 사용하여 관리 에이전트를 구성하고 관리 에이전트에 등록된 노드의 특성을 보고 변경하며, 작업 관리자에 애플리케이션 서버 노드를 등록 및 등록 해제하고 등록된 노드의 작업 관리자 구성을 보고 변경할 수 있습니다. 작업 관리자에서는 관리 에이전트에 등록되고 작업 관리자에도 등록된 노드의 작업을 비동기적으로 제출 및 관리할 수 있습니다.관리 에이전트 하위 시스템에 대한 세부사항은 관리 개선사항의 개요 developerWorks 문서의 관리 에이전트 절을 참조하십시오.
연합되지 않은 노드에서만 이 명령을 실행할 수 있습니다. 연합 노드에서 이 명령을 실행하는 경우 오류와 함께 명령이 종료됩니다.
registerNode 명령을 실행하면, 노드에서 실행 중인 모든 애플리케이션 서버가 중지됩니다. registerNode 명령을 실행하기 전에 등록 중인 애플리케이션 서버를 선택적으로 중지시킬 수 있습니다.
등록할 애플리케이션 서버에서 관리 콘솔 또는 관리 EJB(Enterprise JavaBeans) 애플리케이션이 사용 중인 경우 노드 등록 프로세스가 이들을 사용하지 않도록 설정합니다.
구문
registerNode 명령 구문은 다음과 같습니다.
registerNode [options]
매개변수
다음 옵션은 registerNode 명령에 대해 사용 가능합니다.
- -conntype<JSR160RMI|IPC|RMI|SOAP>
- 관리 에이전트에 연결하여 노드 등록을 초기화하는 데 사용되는 선택적 커넥터
유형입니다. 기본값은 SOAP입니다.
제거된 기능: RMI 커넥터에 대한 지원이 더 이상 사용되지 않으므로 궁극적으로는 RMI 커넥터를 JSR160RMI 커넥터로 변환해야 합니다.depfeat
- -host host_name
- 관리 에이전트의 호스트 이름을 지정하는 선택적 매개변수입니다.
- -name managed_node_name
- 관리 에이전트에 노드를 등록한 후 관리 노드의 이름을 지정하는 선택적 매개변수입니다.
- -nodepassword node_password
- 등록할 노드에 대한 비밀번호를 지정하는 선택적 매개변수입니다. 노드에 보안을 설정하고 비밀번호가 관리 에이전트 비밀번호와 다른 경우, 이 매개변수를 지정하십시오. 이 매개변수는 -nodeusername 매개변수와 함께 사용하십시오. -nodeusername 및 -nodepassword 매개변수는 노드 상의 모든 서버를 중지하는 데 사용됩니다.
- -nodeusername node_user_name
- 등록할 노드에 대한 사용자 이름을 지정하는 선택적 매개변수입니다. 노드에 보안을 설정하고 사용자 이름이 관리 에이전트 사용자 이름과 다른 경우, 이 매개변수를 지정하십시오. 이 매개변수는 -nodepassword 매개변수와 함께 사용하십시오. -nodeusername 및 -nodepassword 매개변수는 노드 상의 모든 서버를 중지하는 데 사용됩니다.
- -openConnectors connectors
- 관리 에이전트에서 여는 커넥터를 쉼표로 구분하여 커넥터 목록으로 지정하는 선택적 매개변수입니다. 기본적으로 모든 커넥터가 열립니다.
- -port port_number
- 관리 에이전트 커넥터 포트의 포트 번호를 지정하는 선택적 매개변수입니다.
관리 에이전트의 기본 SOAP 포트에 대한 기본 포트 번호는 8878입니다. 명령에 대한 SOAP는 기본 JMX(Java™ Management Extensions) 커넥터 유형입니다. 여러 제품 설치 또는 여러 프로파일이 있는 경우, SOAP 포트는 8878와 다를 수 있습니다. 관리 에이전트 SystemOut.log 파일을 검토하여 현재 사용 중인 포트를 확인하십시오.
참고: 이 주제는 하나 이상의 애플리케이션 서버 로그 파일을 참조합니다. 권장되는 대안은 분배 및 IBM® i 시스템에서 SystemOut.log, SystemErr.log, trace.log 및 activity.log 파일을 사용하는 대신 HPEL(High Performance Extensible Logging) 로그를 사용하고 인프라를 추적하도록 서버를 구성하는 것입니다. 원시 z/OS® 로깅 기능과 연계하여 HPEL을 사용할 수도 있습니다. HPEL을 사용하는 경우 서버 프로파일 바이너리 디렉토리의 LogViewer 명령행 도구를 사용하여 모든 로그에 액세스하고 정보를 추적할 수 있습니다. HPEL 사용에 대한 자세한 정보는 HPEL을 사용한 애플리케이션 문제점 해결 정보를 참조하십시오. - -profilePath profile_path
- 등록할 애플리케이션 서버 노드에 대한 프로파일의 경로를 지정하는 필수 매개변수입니다.
- -trace
- registerNode 명령에 대한 추적 출력을 제공하는 선택적 매개변수입니다.
- -portsFile ports_file
- 새로 등록된 노드에 대한 포트 설정값을 정의하는 파일의 경로를 지정하는
선택적 매개변수입니다.
노드 등록 시, -portsFile 매개변수를 지정하지 않을 경우 registerNode은 자동으로 생성되는 권장 포트 세트를 사용합니다. 기본 포트의 가용성에 따라 권장되는 포트 값은 기본 포트 값과 다를 수 있습니다.
지정하는 ports_file 파일의 형식은 portdef.props 파일과 동일합니다. 단, SOAP_CONNECTOR_ADDRESS, RMI_CONNECTOR_ADDRESS, JSR160RMI_CONNECTOR_ADDRESS 및 IPC_CONNECTOR_ADDRESS 포트만 사용된다는 점이 다릅니다.
- -profileName profile_name
- 관리 에이전트의 프로파일 이름을 지정하는 선택적 매개변수입니다.
- -username username
- 관리 에이전트에 로그온할 사용자 ID를 지정하는 선택적 매개변수입니다.
- -password password
- 관리 에이전트에 로그온할 비밀번호를 지정하는 선택적 매개변수입니다.
- -help
- 명령문 사용법을 출력하는 선택적 매개변수입니다.
- -?
- 명령문 사용법을 출력하는 선택적 매개변수입니다.
시나리오 사용법
다음 예제는 올바른 구문을 보여줍니다. 명령문은 인쇄를 위해 여러 줄로 표시됩니다.
![[z/OS]](../images/ngzos.gif)
registerNode.sh -conntype SOAP -port 8878
-profilePath app_server_root/profiles/default
![[AIX]](../images/aixlogo.gif)
![[HP-UX]](../images/hpux.gif)
![[Linux]](../images/linux.gif)
![[Solaris]](../images/solaris.gif)
registerNode.sh -conntype SOAP -port 8878
-profilePath app_server_root/profiles/AppSrv01
![[Windows]](../images/windows.gif)
registerNode.bat -conntype SOAP -port 8878
-profilePath app_server_root\profiles\AppSrv01
![[IBM i]](../images/iseries.gif)
registerNode -conntype SOAP -port 8878
-profilePath user_data_root/profiles/AppSrv01