#WebSphere

[WebSphere] addNode 명령어: 노드 연합(Federation) 및 Dmgr 연동 가이드

addNode 명령어는 Standalone 형태의 프로파일(Profile)을 Deployment Manager(Dmgr)가 관리하는 셀(Cell)에 포함시키는 '연합(Federation)' 작업을 수행합니다. 이를 통해 중앙 집중식 관리가 가능해집니다.

1. 구문 (Syntax)

기본적으로 Dmgr의 호스트와 포트 정보를 필요로 하며, 보안이 설정된 경우 인증 정보가 추가로 요구됩니다.

addNode [Dmgr_Host] [Dmgr_SOAP_Port] [-options]

2. 주요 옵션 (Parameters)

자주 사용되는 핵심 옵션들을 기능별로 분류하였습니다.

필수 및 연결 옵션

  • -profileName [name]: (권장) 명령을 수행할 로컬 프로파일의 이름을 명시합니다. 다중 프로파일 환경에서는 필수입니다.
  • -conntype [type]: Dmgr 연결 방식(SOAP, RMI 등). 기본값은 SOAP입니다.
  • -username [uid] / -password [pwd]: Dmgr에 보안이 설정된 경우 관리자 계정 정보를 입력합니다.

애플리케이션 및 리소스 포함 여부

  • -includeapps: 노드에 이미 설치된 애플리케이션을 Dmgr 셀 구성에 포함시킵니다. (기본값: 포함 안 함)
  • -includebuses: 노드의 버스(Bus) 구성을 셀에 포함시킵니다.

노드 설정 옵션

  • -nodeagentshortname [name]: 생성될 NodeAgent의 이름을 지정합니다.
  • -startingport [port]: 포트 충돌 방지를 위해 노드 내 서버들의 포트를 지정된 번호부터 시작하도록 변경합니다.
  • -registerservice: (Windows 전용) NodeAgent를 윈도우 서비스로 등록합니다.

기타 옵션

  • -noagent: 연합 후 NodeAgent 프로세스를 구동하지 않습니다.
  • -trace: 디버깅을 위해 상세 트레이스 정보를 출력합니다.
  • -logfile [filename]: 로그 파일 경로를 지정합니다.

3. 작업 절차 (Procedure)

Step 1: 사전 점검

작업을 수행하기 전, 대상 Deployment Manager(Dmgr)가 반드시 구동(Running) 상태여야 합니다.

Step 2: 경로 이동

연합할 노드(Profile)의 bin 디렉토리로 이동합니다.

# 예시
cd /opt/IBM/WebSphere/AppServer/profiles/AppSrv01/bin

Step 3: addNode 실행

Dmgr의 IP와 SOAP 포트(기본값 8879)를 확인하여 명령어를 실행합니다.

# 1. 기본 실행 (보안 미설정 시)
./addNode.sh 192.168.1.10 8879

# 2. 보안 설정 시 (ID/PW 포함)
./addNode.sh 192.168.1.10 8879 -username wasadmin -password wasadmin -includeapps

* Windows 환경에서는 addNode.bat를 사용하십시오.

Step 4: 상태 확인

작업이 성공하면 NodeAgent가 자동으로 시작됩니다. serverStatus 명령어로 상태를 확인합니다.

./serverStatus.sh -all -username [ID] -password [PW]

Next Step:
노드 연합이 완료되었다면, 관리 콘솔에서 '전체 동기화(Full Resynchronize)'를 수행하여 Dmgr과 노드 간의 설정 정보를 일치시키는 것이 좋습니다.