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를 사용합니다.
다음은 status 하위 명령의 예입니다.
hadbm status --nodes
보안상의 이유로, 모든 hadbm 명령에는 관리자 암호가 필요합니다. 데이터베이스나 도메인을 만들 때 암호를 설정하려면 --adminpassword 옵션을 사용합니다. 그런 다음 데이터베이스나 도메인에 대해 작업을 수행할 때 해당 암호를 지정해야 합니다.
보안 기능을 향상시키려면 --adminpasswordfile 옵션을 사용하여 명령줄에 암호를 입력하는 대신 암호가 포함된 파일을 지정합니다. 다음 행을 사용하여 암호 파일에 암호를 정의합니다.
HADBM_ADMINPASSWORD=password
password를 암호로 바꿉니다. 파일의 다른 내용은 모두 무시됩니다.
--adminpassword 및 --adminpasswordfile 옵션을 모두 지정하면 --adminpassword가 우선합니다. 암호가 필요하지만 명령에 암호를 지정하지 않으면 hadbm은 암호를 지정하라는 메시지를 표시합니다.
관리자 암호는 데이터베이스나 도메인을 만들 때만 설정할 수 있으며 나중에 변경할 수 없습니다.
HADB에는 관리자 암호 이외에 데이터베이스 스키마를 수정하는 작업을 수행하기 위한 데이터베이스 암호도 필요합니다. 명령 hadbm create, hadbm addnodes 및 hadbm refragment를 사용할 때는 두 암호를 모두 사용해야 합니다.
--dbpassword 옵션을 사용하여 명령줄에 데이터베이스 암호를 지정합니다. 관리자 암호와 마찬가지로, 파일에 암호를 넣고 파일 위치를 지정하여 --dbpasswordfile 옵션을 사용할 수 있습니다. 다음 행을 사용하여 암호 파일에 암호를 설정합니다.
HADBM_DBPASSWORD=password
테스트나 평가에서는 데이터베이스나 도메인을 만들 때 --no-adminauthentication 옵션으로 암호 인증을 해제할 수 있습니다. 자세한 내용은 데이터베이스 만들기 및 관리 도메인 만들기를 참조하십시오.
다음 표에서는 hadbm 보안 명령줄 옵션을 요약하여 설명합니다.
표 3–4 hadbm 보안 옵션
일반 명령 옵션은 모든 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 |
0 |
$HADBM_SPARES |
--startlevel |
-l |
normal |
$HADBM_STARTLEVEL |
--version |
-V |
False |
$HADBM_VERSION |
--yes |
-y |
False |
$HADBM_YES |