Sun Java System Application Server Enterprise Edition 8.1 2005Q2 고가용성 관리 설명서

HADB 관리 에이전트 사용

관리 에이전트 ma는 HADB 호스트에서 관리 명령을 실행합니다. 또한 관리 에이전트는 HADB 노드 수퍼바이저 프로세스가 실패한 경우 다시 시작하여 HADB의 가용성을 보장합니다.

관리 에이전트 명령 구문

관리 에이전트 ma 명령의 구문은 다음과 같습니다.

ma [common-options] 
[ service-options] 
config-file

여기서,

common-options는 관리 에이전트 명령 구문에서 설명하는 공통 옵션 중 하나 이상입니다.
service-options는 관리 에이전트 명령 구문에서 설명하는 Windows 서비스 옵션 중 하나입니다.
config-file은 관리 에이전트 구성 파일에 대한 전체 경로입니다. 자세한 내용은 관리 에이전트 구성 사용자 정의를 참조하십시오.

표 3–1 관리 에이전트 공통 옵션


옵션	설명	기본값
--define name=value-D	value를 등록 정보 name에 할당합니다. 여기서 등록 정보는 구성 파일에 정의된 등록 정보 중 하나입니다. 이 옵션은 여러 번 반복하여 사용할 수 있습니다.	없음
--help-?	도움말 정보를 표시합니다.	False
--javahome `path`-j	`path`에 있는 Java Runtime Environment(1.4 이상)를 사용합니다.	없음
--systemroot `path`-y	일반적으로 %SystemRoot%에 설정된 운영 체제 루트에 대한 경로입니다.	없음
--version-V	버전 정보를 표시합니다.	False

관리 에이전트 명령 구문에서는 관리 에이전트를 Windows 서비스로 시작하기 위한 옵션에 대해 설명합니다. -i, -r 및 -s 옵션은 상호 배타적입니다. 즉 함께 사용할 수 없습니다.

Windows에서는 구성 파일 또는 명령줄에 등록 정보 값에 대한 경로를 지정할 때, 공백이 포함된 파일 경로에 큰따옴표(")를 이스케이프 문자로 사용합니다. 콜론(:) 드라이브 구분자와 백슬러시(\) 디렉토리 구분자는 "\: 및 "\\과 같이 큰따옴표와 백슬러시가 포함된 구분자를 이스케이프 문자로 사용합니다.

표 3–2 관리 에이전트 서비스 옵션(Windows에만 해당)


옵션	설명	기본값
--install-i	에이전트를 Windows 서비스로 설치하고 서비스를 시작합니다. -i, -r 및 -s 옵션 중 하나만 사용합니다.	False
--name `servicename`-n	호스트에 여러 에이전트를 실행하는 경우 서비스에 대해 지정된 이름을 사용합니다.	HADBMgmtAgent
--remove-r	Windows 서비스 관리자에서 서비스를 중지하고 에이전트를 삭제합니다. -i, -r 및 -s 옵션 중 하나만 사용합니다.	False
--service-s	에이전트를 Windows 서비스로 실행합니다. -i, -r 및 -s 옵션 중 하나만 사용합니다.	False

관리 에이전트 구성 사용자 정의

HADB에는 관리 에이전트 설정을 사용자 정의할 때 사용할 수 있는 구성 파일이 포함되어 있습니다. 구성 파일을 지정하지 않고 관리 에이전트를 시작하면 기본값이 사용됩니다. 구성 파일을 지정하는 경우 관리 에이전트는 해당 파일의 설정을 사용합니다. 도메인의 모든 호스트에 있는 구성 파일을 다시 사용할 수 있습니다.

각 HADB 호스트의 관리 에이전트 구성을 사용자 정의하는 방법

관리 에이전트 구성 파일을 편집하고 값을 원하는 대로 설정합니다.

사용자 정의된 구성 파일을 인수로 지정하여 관리 에이전트를 시작합니다.

구성 파일

Java Enterprise System을 사용할 경우 구성 파일의 모든 항목이 주석으로 처리되어 있습니다. 기본 구성을 사용할 때는 변경할 필요가 없습니다. 관리 에이전트 구성을 사용자 정의하려면 파일에서 주석을 제거하고, 값을 원하는 대로 변경한 다음 구성 파일을 인수로 지정하여 관리 에이전트를 시작합니다.

관리 에이전트 구성 파일은 다음 위치에 설치됩니다.

Solaris 및 Linux: /etc/opt/SUNWhadb/mgt.cfg
Windows: install_dir \lib\mgt.cfg

독립 실행형 설치 프로그램을 사용하면 관리 에이전트 구성 파일은 다음 위치에 설치됩니다.

Solaris 및 Linux: HADB_install_dir /bin/ma.cfg
Windows: HADB_install_dir \bin\ma.cfg

다음 표에서는 구성 파일의 설정에 대해 설명합니다.

표 3–3 구성 파일 설정


설정 이름	설명	기본값
console.loglevel	콘솔 로그 수준. 유효한 값은 SEVERE, ERROR, WARNING, INFO, FINE, FINER, FINEST입니다.	WARNING
logfile.loglevel	로그 파일 로그 수준. 유효한 값은 SEVERE, ERROR, WARNING, INFO, FINE, FINER, FINEST입니다.	INFO
logfile.name	로그 파일의 이름 및 위치. 읽기/쓰기 액세스 권한이 있는 유효한 경로여야 합니다.	Solaris 및 Linux:`/var/opt/SUNWhadb/ma/ma.log` Windows: `HADB_install_dir\ma.log`
ma.server.type	클라이언트 프로토콜. JMXMP만 지원됩니다.	jmxmp
ma.server. jmxmp.port	내부(UDP) 및 외부(TCP) 통신을 위한 포트 번호. 양의 정수여야 합니다. 권장 범위는 1024-49151입니다.	1862
ma.server. mainternal.interfaces	인터페이스가 여러 개인 시스템의 내부 통신을 위한 인터페이스. 유효한 IPv4 주소 마스크여야 합니다. 도메인의 모든 관리 에이전트는 동일한 서브넷을 사용해야 합니다. 예를 들어, 호스트에 10.10.116.61과 10.10.124.61의 두 인터페이스가 있는 경우 첫 번째 인스턴스를 사용하려면 10.10.116.0/24를 사용합니다. 슬래시 뒤의 숫자는 서브넷 마스크의 비트 수를 나타냅니다.	없음
ma.server. dbdevicepath	HADB 장치 정보를 저장하기 위한 경로	Solaris 및 Linux: `/var/opt/SUNWhadb/4` Windows: `HADB_install_dir` `\device`
ma.server. dbhistorypath	HADB 내역 파일을 저장하기 위한 경로	Solaris 및 Linux: `/var/opt/SUNWhadb` Windows: REPLACEDIR(런타임에 실제 URL로 바뀜)
ma.server. dbconfigpath	노드 구성 데이터를 저장하기 위한 경로	Solaris 및 Linux: `/var/opt/SUNWhadb/dbdef` Windows: `C:\Sun\SUNWhadb\dbdef`
repository.dr.path	도메인 저장소 파일에 대한 경로	Solaris 및 Linux: `/var/opt/SUNWhadb/repository` Windows: `C:\Sun\SUNWhadb\repository`

관리 에이전트 시작

다음 두 가지 방법으로 관리 에이전트를 시작할 수 있습니다.

프로덕션 사용을 위해 서비스로 시작합니다. 관리 에이전트를 서비스로 시작을 참조하십시오. 관리 에이전트의 가용성을 위해, 시스템을 재부트할 때 자동으로 다시 시작되는지 확인하십시오. 관리 에이전트의 자동 재시작 확인을 참조하십시오.
평가, 테스트 또는 개발을 위해 일반 프로세스로(콘솔 모드에서) 시작합니다. 콘솔 모드에서 관리 에이전트 시작을 참조하십시오.

각 경우 절차는 Java Enterprise System과 독립 실행형 Application Server 중 무엇을 사용하는지에 따라 다릅니다.

관리 에이전트를 서비스로 시작

관리 에이전트를 서비스로 시작하면 시스템이 종료되거나 관리 에이전트를 명시적으로 중지하기 전까지는 계속 실행됩니다.

Solaris 또는 Linux에서 Java Enterprise System을 사용하여 관리 에이전트를 서비스로 시작

관리 에이전트를 서비스로 시작하려면 다음 명령을 사용합니다.

/etc/init.d/ma-initd start

서비스를 중지하려면 다음 명령을 사용합니다.

/etc/init.d/ma-initd stop

Windows에서 Java Enterprise System을 사용하여 관리 에이전트를 서비스로 시작

관리 에이전트를 Windows 서비스로 시작하려면 다음 명령을 사용합니다. HADB_install_dir\bin\ma -i [config-file ]

선택 인수 config-file은 관리 에이전트 구성 파일을 지정합니다. 구성 파일은 기본 관리 에이전트 구성을 변경하려는 경우에만 사용합니다.

관리 에이전트를 서비스로 중지하고 제거(등록 해제)하려면 다음 명령을 사용합니다. HADB_install_dir\bin\ma -r [ config-file ]

관리를 수행하려면 관리 도구 | 서비스를 선택합니다. 이렇게 하면 서비스를 시작하고 중지하거나, 자동 시작을 비활성화하는 등의 작업을 할 수 있습니다.

Solaris 또는 Linux에서 독립 실행형 Application Server를 사용하여 관리 에이전트를 서비스로 시작

관리 에이전트를 서비스로 시작하려면 다음 명령을 사용합니다.

HADB_install_dir/bin/ma-initd start

서비스를 중지하려면 다음 명령을 사용합니다.

HADB_install_dir/bin/ma-initd stop

Windows에서 독립 실행형 Application Server를 사용하여 관리 에이전트를 서비스로 시작

관리 에이전트를 Windows 서비스로 시작하려면 다음 명령을 사용합니다. HADB_install_dir\bin\ma -i [config-file ]

선택 인수 config-file은 관리 에이전트 구성 파일을 지정합니다. 구성 파일은 기본 관리 에이전트 구성을 변경하려는 경우에만 사용합니다.

관리 에이전트를 서비스로 중지하고 제거(등록 해제)하려면 다음 명령을 사용합니다. HADB_install_dir\bin\ma -r [ config-file ]

관리 에이전트의 자동 재시작 확인

Windows 플랫폼에서는 관리 에이전트를 서비스로 시작하고 나면 Windows 관리 도구를 사용하여 서비스 시작 유형을 “자동”으로 설정하고 원하는 복원 옵션을 설정합니다.

Solaris 및 Linux 플랫폼에서는 이 절의 절차를 사용하여 ma 프로세스가 실패하거나 운영 체제를 재부트하는 경우 관리 에이전트의 가용성을 보장합니다. 프로덕션 배포 시에는 이렇게 하는 것이 좋습니다.

다음 절차는 시스템이 다음 절차에 들어갈 때만 관리 에이전트가 시작되도록 합니다.

Solaris 실행 수준 3(기본값)
RedHat Linux 실행 수준 5(그래픽 모드 기본값)

다른 실행 수준에 들어가면 관리 에이전트가 중지됩니다.

Solaris 또는 Linux에서 Java Enterprise System을 사용하여 자동 재시작을 구성하는 방법

시작하기 전에

이 절에서는 사용자가 운영 체제 초기화 및 실행 수준에 대한 기본 사항을 이해하고 있는 것으로 가정합니다. 이 항목의 내용에 대해서는 운영 체제 설명서를 참조하십시오.

시스템의 기본 실행 수준이 3 또는 5인지 확인합니다.

시스템의 기본 실행 수준을 확인하려면 /etc/inittab 파일을 검사하여 맨 위 근처의 행에서 다음과 비슷한 내용을 찾습니다.
```
id:5:initdefault:
```
이 예에서는 기본 실행 수준 5를 보여줍니다.

/etc/init.d/ma-initd 파일에 대해 다음 소프트 링크를 만듭니다.

/etc/rc0.d/K20ma-initd
/etc/rc1.d/K20ma-initd
/etc/rc2.d/K20ma-initd
/etc/rc3.d/S99ma-initd
/etc/rc5.d/S99ma-initd
/etc/rcS.d/K20ma-initd

시스템을 재부트합니다.

다음 순서

에이전트의 자동 시작 및 중지를 비활성화하려면 링크를 제거하거나 링크 이름의 문자 K와 S를 소문자로 변경합니다.

Solaris 또는 Linux에서 독립 실행형 Application Server를 사용하여 자동 재시작을 구성하는 방법

쉘에서 현재 디렉토리를 HADB_install_dir /bin으로 변경합니다.

쉘 스크립트 ma-initd를 편집합니다.

스크립트의 HADB_ROOT 및 HADB_MA_CFG 기본값에 설치가 반영되어 있는지 확인합니다.
- HADB_ROOT는 HADB 설치 디렉토리 HADB_install_dir입니다.
- HADB_MA_CFG는 관리 에이전트 구성 파일의 위치입니다. 자세한 내용은 관리 에이전트 구성 사용자 정의를 참조하십시오.

ma-initd를 /etc/init.d 디렉토리로 복사합니다.

/etc/init.d/ma-initd 파일에 대해 다음 소프트 링크를 만듭니다.

/etc/rc0.d/K20ma-initd
/etc/rc1.d/K20ma-initd
/etc/rc2.d/K20ma-initd
/etc/rc3.d/S99ma-initd
/etc/rc5.d/S99ma-initd
/etc/rcS.d/K20ma-initd

다음 순서

에이전트의 자동 시작 및 중지를 비활성화하려면 링크를 제거하거나 링크 이름의 문자 K와 S를 소문자로 변경합니다.

콘솔 모드에서 관리 에이전트 시작

평가나 테스트를 위해 관리 에이전트를 콘솔 모드에서 수동으로 시작해야 하는 경우가 있습니다. ma 프로세스는 시스템 또는 프로세스 실패 후 다시 시작되지 않고 명령 창을 닫으면 종료되므로 프로덕션 환경에서는 관리 에이전트를 이 방법으로 시작하지 마십시오.

Solaris 또는 Linux에서 Java Enterprise System을 사용하여 콘솔 모드에서 관리 에이전트 시작

HADB 관리 에이전트를 콘솔 모드에서 시작하려면 다음 명령을 사용합니다.

opt/SUNWhadb/bin/ma [config-file]

기본 관리 에이전트 구성 파일은 /etc/opt/SUNWhadb/mgt.cfg입니다.

관리 에이전트를 중지하려면 프로세스를 종료하거나 쉘 창을 닫습니다.

Windows에서 Java Enterprise System을 사용하여 콘솔 모드에서 관리 에이전트 시작

관리 에이전트를 콘솔 모드에서 시작하려면 다음 명령을 사용합니다.

HADB_install_dir\bin\ma [config-file]

선택 인수 config-file은 관리 에이전트 구성 파일의 이름입니다. 구성 파일에 대한 자세한 내용은 관리 에이전트 구성 사용자 정의를 참조하십시오.

에이전트를 중지하려면 프로세스를 종료합니다.

Windows에서 독립 실행형 Application Server를 사용하여 콘솔 모드에서 관리 에이전트 시작

관리 에이전트를 콘솔 모드에서 시작하려면 다음 명령을 사용합니다.

HADB_install_dir\bin\ma [config-file]

선택 인수인 config-file은 관리 에이전트 구성 파일의 이름입니다. 자세한 내용은 관리 에이전트 구성 사용자 정의를 참조하십시오.

관리 에이전트를 중지하려면 프로세스를 중지합니다.

Solaris 또는 Linux에서 독립 실행형 Application Server를 사용하여 콘솔 모드에서 관리 에이전트 시작

HADB 관리 에이전트를 콘솔 모드에서 시작하려면 다음 명령을 사용합니다.

HADB_install_dir/bin/ma [config-file]

기본 관리 에이전트 구성 파일은 HADB_install_dir /bin/ma.cfg입니다.

관리 에이전트를 중지하려면 프로세스를 종료하거나 쉘 창을 닫습니다.