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

hadbm 관리 명령 사용

HADB 도메인, 데이터베이스 인스턴스 및 노드를 관리하려면 hadbm 명령줄 유틸리티를 사용합니다. hadbm 유틸리티(관리 클라이언트라고도 함)는 지정된 관리 에이전트에 관리 요청을 보내고, 저장소의 데이터베이스 구성에 대한 액세스 권한이 있는 관리 서버의 역할을 합니다.

이 절에서는 다음 항목이 있는 hadbm 명령줄 유틸리티에 대해 설명합니다.

명령 구문

hadbm 유틸리티는 HADB_install_dir /bin 디렉토리에 있습니다. hadbm 명령의 일반 구문은 다음과 같습니다.

hadbm subcommand  
[-short-option [option-value]] 
[--long-option [option-value]] 
[operands]

하위 명령은 수행할 연산 또는 작업을 식별하며 대소문자를 구분합니다. 대부분의 명령에는 한 개의 피연산자(일반적으로 dbname)가 있지만 피연산자가 없거나 두 개인 명령도 있습니다.

옵션은 hadbm이 하위 명령을 수행하는 방식을 수정하며 대소문자를 구분합니다. 각 옵션에는 긴 형식과 짧은 형식이 있습니다. 짧은 형식 앞에는 한 개의 대시(-)를 붙이고 긴 형식 앞에는 두 개의 대시(--)를 붙입니다. 기능을 사용하기 위해 있어야 하는 부울 옵션을 제외하고 대부분의 옵션에는 인수 값이 필요합니다. 옵션은 명령을 성공적으로 실행하기 위해 필요합니다.

하위 명령에는 데이터베이스 이름이 필요한데 이 데이터베이스 이름을 지정하지 않으면 hadbm은 기본 데이터베이스인 hadb를 사용합니다.


예 3–1 hadbm 명령의 예

다음은 status 하위 명령의 예입니다.

hadbm status --nodes

보안 옵션

보안상의 이유로, 모든 hadbm 명령에는 관리자 암호가 필요합니다. 데이터베이스나 도메인을 만들 때 암호를 설정하려면 --adminpassword 옵션을 사용합니다. 그런 다음 데이터베이스나 도메인에 대해 작업을 수행할 때 해당 암호를 지정해야 합니다.

보안 기능을 향상시키려면 --adminpasswordfile 옵션을 사용하여 명령줄에 암호를 입력하는 대신 암호가 포함된 파일을 지정합니다. 다음 행을 사용하여 암호 파일에 암호를 정의합니다.

HADBM_ADMINPASSWORD=password

password를 암호로 바꿉니다. 파일의 다른 내용은 모두 무시됩니다.

--adminpassword--adminpasswordfile 옵션을 모두 지정하면 --adminpassword가 우선합니다. 암호가 필요하지만 명령에 암호를 지정하지 않으면 hadbm은 암호를 지정하라는 메시지를 표시합니다.


주 –

관리자 암호는 데이터베이스나 도메인을 만들 때만 설정할 수 있으며 나중에 변경할 수 없습니다.


HADB에는 관리자 암호 이외에 데이터베이스 스키마를 수정하는 작업을 수행하기 위한 데이터베이스 암호도 필요합니다. 명령 hadbm create, hadbm addnodeshadbm refragment를 사용할 때는 두 암호를 모두 사용해야 합니다.

--dbpassword 옵션을 사용하여 명령줄에 데이터베이스 암호를 지정합니다. 관리자 암호와 마찬가지로, 파일에 암호를 넣고 파일 위치를 지정하여 --dbpasswordfile 옵션을 사용할 수 있습니다. 다음 행을 사용하여 암호 파일에 암호를 설정합니다.

HADBM_DBPASSWORD=password

테스트나 평가에서는 데이터베이스나 도메인을 만들 때 --no-adminauthentication 옵션으로 암호 인증을 해제할 수 있습니다. 자세한 내용은 데이터베이스 만들기 관리 도메인 만들기를 참조하십시오.

다음 표에서는 hadbm 보안 명령줄 옵션을 요약하여 설명합니다.

표 3–4 hadbm 보안 옵션

옵션(짧은 형식) 

설명 

--adminpassword=password

-w 

데이터베이스나 도메인에 대한 관리자 암호를 지정합니다. 데이터베이스나 도메인을 만들 때 이 옵션을 사용하면 hadbm을 사용하여 데이터베이스나 도메인 관련 작업을 수행할 때마다 암호를 지정해야 합니다. 

이 옵션 또는 --adminpasswordfile 중 하나만 사용할 수 있으며, 둘 다 사용할 수는 없습니다. 

--adminpasswordfile=filepath

-W 

데이터베이스나 도메인에 대한 관리자 암호가 포함된 파일을 지정합니다. 데이터베이스나 도메인을 만들 때 이 옵션을 사용하면 hadbm을 사용하여 데이터베이스나 도메인 관련 작업을 수행할 때마다 암호를 지정해야 합니다.  

이 옵션 또는 --adminpassword 중 하나만 사용할 수 있으며, 둘 다 사용할 수는 없습니다. 

--no-adminauthentication 

-U 

데이터베이스나 도메인을 만들 때 관리자 암호가 필요하지 않음을 지정하는 옵션입니다. 보안상의 이유로, 프로덕션 배포에서는 이 옵션을 사용하지 마십시오. 

--dbpassword= password

-p 

데이터베이스 암호를 지정합니다. 데이터베이스를 만들 때 이 옵션을 사용하면 hadbm 명령을 사용하여 데이터베이스 관련 작업을 수행할 때마다 암호를 지정해야 합니다. HADB 시스템 사용자에 대한 암호를 만듭니다. 암호는 8자 이상이어야 합니다. 이 옵션 또는 --dbpasswordfile 중 하나만 사용할 수 있으며, 둘 다 사용할 수는 없습니다.

--dbpasswordfile= filepath

-P 

HADB 시스템 사용자에 대한 암호가 포함된 파일을 지정합니다. 이 옵션 또는 --dbpassword 중 하나만 사용할 수 있으며, 둘 다 사용할 수는 없습니다.

일반 옵션

일반 명령 옵션은 모든 hadbm 하위 명령에 사용할 수 있습니다. 모두 기본적으로 false인 부울 옵션입니다. 다음 표에서는 hadbm 일반 명령 옵션에 대해 설명합니다.

표 3–5 hadbm 일반 옵션

옵션(짧은 형식) 

설명 

--quiet 

-q 

하위 명령을 설명 메시지 없이 자동으로 실행합니다. 

--help 

-? 

이 명령 및 지원되는 모든 하위 명령에 대한 간략한 설명을 표시합니다. 하위 명령이 필요하지 않습니다. 

--version 

-V 

hadbm 명령의 버전 세부 정보를 표시합니다. 하위 명령이 필요하지 않습니다.

--yes 

-y 

하위 명령을 비대화식 모드에서 실행합니다. 

--force 

-f 

명령을 비대화식으로 실행하고 명령의 사후 조건이 이미 달성되면 오류가 발생하지 않습니다. 

--echo 

-e 

모든 옵션 및 사용자 정의된 값이나 기본값과 함께 하위 명령을 표시한 다음 하위 명령을 실행합니다. 

--agent=URL

-m 

관리 에이전트에 대한 URL입니다. URL: hostlist:port. 여기서 hostlist는 쉼표로 구분된 호스트 이름 또는 IP 주소의 목록이며, port는 관리 에이전트가 작동 중인 포트 번호입니다.

기본값은 localhost:1862입니다. 

참고: 이 옵션은 hadbm addnodes에 유효하지 않습니다.

환경 변수

편의상 명령 옵션을 지정하는 대신 환경 변수를 설정할 수 있습니다. 다음 표에서는 hadbm 명령 옵션에 해당하는 환경 변수에 대해 설명합니다.

표 3–6 HADB 옵션 및 환경 변수

긴 형식 

짧은 형식 

기본값 

환경 변수 

--adminpassword 

-w 

없음 

$HADBM_ADMINPASSWORD 

--agent 

--m 

localhost:1862 

$HADBM_AGENT 

--datadevices 

-a 

1

$HADBM_DATADEVICES 

dbname 

없음 

hadb

$HADBM_DB 

--dbpassword 

-p 

없음 

$HADBM_DBPASSWORD 

--dbpasswordfile 

-P 

없음 

$HADBM_DBPASSWORDFILE 

--devicepath 

-d 

Solaris 및 Linux: /var/opt/SUNWhadb

Windows: C:\Sun\AppServer\SUNWhadb\vers. 여기서 vers는 HADB 버전 번호입니다.

$HADBM_DEVICEPATH 

--devicesize 

-z 

없음 

$HADBM_DEVICESIZE 

--echo 

-e 

False 

$HADBM_ECHO 

--fast 

-F 

False 

$HADBM_FAST 

--force 

-f 

False 

$HADBM_FORCE 

--help 

-? 

False 

$HADBM_HELP 

--historypath 

-t 

Solaris 및 Linux: /var/opt/SUNWhadb

Windows: REPLACEDIR(런타임에 실제 URL로 바뀜) 

$HADBM_HISTORYPATH 

--hosts 

-H 

없음 

$HADBM_HOSTS 

--interactive 

-i 

True 

$HADBM_INTERACTIVE 

--no-refragment 

-r 

False 

$HADBM_NOREFRAGMENT 

--portbase 

-b 

15200 

$HADBM_PORTBASE 

--quiet 

-q 

False 

$HADBM_QUIET 

--repair 

-R 

True 

$HADBM_REPAIR 

--rolling 

-g 

True 

$HADBM_ROLLING 

--saveto 

-o 

없음 

$HADBM_SAVETO 

--set 

-S 

없음 

$HADBM_SET 

--spares 

-s 

$HADBM_SPARES 

--startlevel 

-l 

normal 

$HADBM_STARTLEVEL 

--version 

-V 

False 

$HADBM_VERSION 

--yes 

-y 

False 

$HADBM_YES