HADB 구성

이 절에서는 다음과 같은 기본 HADB 구성 작업에 대해 설명합니다.

• 관리 도메인 만들기

• 데이터베이스 만들기

• 구성 속성 보기 및 수정

• JDBC 연결 풀 구성

관리 도메인 만들기

hadbm createdomain 명령은 지정된 HADB 호스트가 포함된 관리 도메인을 만들고 호스트 및 지속성 구성 저장소 간의 내부 통신 채널을 초기화합니다.

명령 구문은 다음과 같습니다.

hadbm createdomain
 [--adminpassword=password |--adminpasswordfile=
file | --no-adminauthentication] [--agent=maurl]
 hostlist

hostlist 피연산자는 쉼표로 구분된 HADB 호스트의 목록이며 각 호스트는 유효한 IPv4 네트워크 주소입니다. 새 도메인에 원하는 모든 호스트를 hostlist에 포함시킵니다.

명령 옵션에 대한 설명은 일반 옵션을 참조하십시오.

이 명령을 사용하기 전에 hostlist의 모든 호스트에 HADB 관리 에이전트가 실행되고 있는지 확인하십시오. 또한 관리 에이전트는 다음 조건에 맞아야 합니다.

• 기존 도메인의 구성원이 아니어야 합니다.

• 동일한 포트를 사용하도록 구성되어야 합니다.

• UDP, TCP를 통해, 그리고 IP 멀티캐스트를 사용하여 서로 통신할 수 있어야 합니다.

hadbm은 관리 도메인을 만든 후에 도메인의 모든 호스트를 활성화합니다. 그런 다음 관리 에이전트는 데이터베이스를 관리할 수 있게 됩니다. HADB 도메인을 만들고 나면, 다음 단계에서 HADB 데이터베이스를 만듭니다. HADB 데이터베이스 만들기에 대한 자세한 내용은 데이터베이스 만들기를 참조하십시오.

예 3–2 HADB 관리 도메인 만들기

다음 예에서는 네 개의 지정된 호스트에 관리 도메인을 만듭니다.

hadbm createdomain --adminpassword= password host1,host2,host3,host4

hadbm이 명령을 성공적으로 실행하면 다음 메시지가 표시됩니다.

Domain host1,host2,host3, host4 created.

HADB 도메인을 만든 후에는 HADB 패키지의 경로와 버전을 관리 에이전트에 등록합니다.

데이터베이스 만들기

hadbm create 명령을 사용하여 데이터베이스를 수동으로 만듭니다.

이 명령을 사용하여 데이터베이스를 만들기 전에 관리 도메인을 만들고 HADB 패키지를 등록합니다. hadbm create를 실행할 때 이 두 단계를 수행하지 않은 경우 이 명령은 해당 단계를 암시적으로 수행합니다. 거의 동작하지 않는 것처럼 보일 수 있지만 이 명령 중 하나라도 실패하면 디버깅이 어려워질 수 있습니다. hadbm create는 기본 단위가 아닙니다. 즉, 암시적 명령 중 하나가 실패하면 성공적으로 실행된 명령이 롤백되지 않습니다. 따라서 도메인을 만들고 HADB 패키지를 등록한 후에만 데이터베이스를 만드는 것이 가장 좋습니다.

예를 들어 hadbm createdomain 및 hadbm registerpackage는 성공적으로 실행되지만 hadbm create database가 실패한 경우 hadbm createdomain 및 hadbm registerpackage에 의한 변경 사항은 지속됩니다.

데이터베이스를 만드는 방법

1. 관리 도메인을 만듭니다.

   자세한 내용은 관리 도메인 만들기를 참조하십시오.

2. HADB 패키지를 등록합니다.

   자세한 내용은 HADB 패키지 등록을 참조하십시오.

3. hadbm create 명령을 사용하여 데이터베이스를 만듭니다.

   명령 구문에 대한 자세한 내용은 다음 절을 참조하십시오.

hadbm create 명령 구문

dbname 피연산자는 고유해야 하는 데이터베이스 이름을 지정합니다. 데이터베이스 이름이 고유한지 확인하려면 hadbm list 명령을 사용하여 기존 데이터베이스 이름을 나열합니다. 여러 데이터베이스를 만들 필요가 없으면 기본 데이터베이스 이름을 사용합니다. 예를 들어 동일한 HADB 시스템 집합에 독립적인 데이터베이스가 있는 여러 클러스터를 만들려면 각 클러스터에 별도의 데이터베이스 이름을 사용합니다.

hadbm create 명령은 로그 파일이 아닌 콘솔에 오류 메시지를 기록합니다.

표 3–7에서는 특수한 hadbm create 명령 옵션에 대해 설명합니다. 추가적인 명령 옵션에 대한 설명은 일반 옵션을 참조하십시오.

예 3–3 데이터베이스 만들기의 예

다음 명령은 데이터베이스를 만드는 예입니다.

hadbm create --spares 2 --devicesize 1024 --dbpassword secret123
 --hosts n0,n1,n2,n3,n4,n5

호스트 지정

--hosts 옵션을 사용하여 데이터베이스의 노드에 대한 호스트 이름 또는 IP 주소의 쉼표로 구분된 목록을 지정합니다. hadbm create 명령은 목록의 각 호스트 이름(또는 IP 주소)에 대해 한 개의 노드를 만듭니다. 노드 수는 짝수여야 합니다. 중복되는 호스트 이름을 사용하여 동일한 시스템에 포트 번호가 다른 여러 노드를 만듭니다. 동일한 시스템의 노드가 미러 노드가 아닌지 확인합니다.

노드에는 이 옵션에 나열된 순서로 0부터 시작하여 번호가 지정됩니다. 첫 번째 미러되는 쌍은 노드 0과 1이고, 두 번째는 2와 3 등의 순서입니다. 홀수 번호가 지정된 노드는 한 DRU에 있고, 짝수 번호가 지정된 노드는 다른 DRU에 있습니다. --spares 옵션을 사용하는 예비 노드는 숫자가 가장 큽니다.

이중 네트워크 인터페이스 구성에 대한 자세한 내용은 네트워크 중복 구성을 참조하십시오.

장치 크기 지정

--devicesize 옵션을 사용하여 장치 크기를 지정합니다. 권장하는 장치 크기는 다음과 같습니다.

(4x / nd + 4l/d) / 0.99

여기서,

• x는 사용자 데이터의 총 크기입니다.

• n은 노드 수(--hosts 옵션으로 제공됨)입니다.

• d는 노드당 장치 수(--datadevices 옵션으로 제공됨)입니다.

• l은 로그 버퍼 크기(속성 LogBufferSize로 제공됨)입니다.

  재조각화가 발생할 수 있는 경우(예: hadbm addnodes 사용) 권장하는 장치 크기는 다음과 같습니다.

  (8x / nd + 4l/d) / 0.99

이기종 장치 경로 설정

각 노드 또는 서비스에 대해 서로 다른 장치 경로를 설정하려면 hadbm create의 -- set 옵션을 사용합니다. 장치 유형에는 DataDevice, NiLogDevice(노드 내부 로그 장치), RelalgDevice(관계형 algebra 쿼리 장치) 및 NoManDevice(노드 관리자 장치)의 네 가지 유형이 있습니다. 각 name =value 쌍의 구문은 다음과 같습니다. 여기서 -devno는 device가 DataDevice인 경우에만 필수입니다.

node-nodeno.device-devno.Devicepath

예를 들면 다음과 같습니다.

--set Node-0.DataDevice-0.DevicePath=/disk0,
Node-1.DataDevice-0.DevicePath=/disk 1

다음과 같이 내역 파일에 이기종 경로를 설정할 수도 있습니다.

node-nodeno.historypath=path

내역 파일에 대한 자세한 내용은 내역 파일 지우기 및 아카이브를 참조하십시오.

특정 노드 또는 장치로 설정되지 않은 장치 경로의 기본값은 --devicepath입니다.

hadbm set 및 hadbm addnodes 명령을 사용하여 내역 파일의 위치와 장치 경로를 변경합니다.

문제 해결

데이터베이스를 만들 때 문제가 발생하는 경우 다음을 확인하십시오.

• 모든 호스트에서 관리 에이전트를 시작했으며 HADB 도메인을 정의했는지 확인합니다. 자세한 내용은 관리 에이전트 시작을 참조하십시오.

• 다음 사용자에 대해 설치, 내역, 장치 및 구성 경로에 대한 읽기, 쓰기 및 실행 액세스 권한이 허용되도록 파일 및 디렉토리 권한을 설정해야 합니다.

  • Sun Java System Application Server 관리 사용자(설치 도중 설정됨)

  • HADB 시스템 사용자

    사용자 권한 설정에 대한 자세한 내용은 HADB 설정 준비를 참조하십시오.

  Application Server 및 HADB 포트 할당은 동일한 시스템의 다른 포트 할당과 충돌하지 않아야 합니다. 권장하는 기본 포트 할당은 다음과 같습니다.

  • Sun Java SystemMessage Queue: 7676

  • IIOP: 3700

  • HTTP 서버: 80

  • 관리 서버: 4848

  • HADB 노드: 각 노드는 6개의 연속되는 포트를 사용합니다. 예를 들어 기본 포트 15200의 경우, 노드 0은 15200부터 15205까지 사용하고 노드 1은 15220부터 15225까지 사용합니다.

  디스크 공간이 충분해야 합니다. Sun Java System Application Server 릴리스 노트를 참조하십시오.

구성 속성 보기 및 수정

속성 hadbm get 및 hadbm set 명령을 각각 사용하여 데이터베이스 구성을 보고 수정할 수 있습니다.

구성 속성의 값 가져오기

구성 속성의 값을 가져오려면 hadbm get 명령을 사용합니다. 유효한 속성 목록은 구성 속성을 참조하십시오. 명령 구문은 다음과 같습니다.

hadbm get attribute-list | --all  
[dbname]  
[--adminpassword=password | --adminpasswordfile=file]  
[--agent=maurl]

dbname 피연산자는 데이터베이스 이름을 지정합니다. 기본값은 hadb입니다.

attribute-list 피연산자는 쉼표로 구분되거나 따옴표가 붙은 공백으로 구분된 속성 목록입니다. --all 옵션은 모든 속성의 값을 표시합니다. hadbm get에 대한 모든 속성의 목록은 구성 속성을 참조하십시오.

명령 옵션에 대한 설명은 일반 옵션을 참조하십시오.

예 3–4 hadbm get 사용의 예

hadbm get JdbcUrl,NumberOfSessions

구성 속성의 값 설정

구성 속성의 값을 설정하려면 hadbm set 명령을 사용합니다. 유효한 속성 목록은 구성 속성을 참조하십시오.

hadbm set [dbname] attribute
=value[,attribute=
value...]
 [--adminpassword=password | --adminpasswordfile=file]
 [--agent=maurl]

dbname 피연산자는 데이터베이스 이름을 지정합니다. 기본값은 hadb입니다.

attribute=value 목록은 쉼표로 구분되거나 따옴표가 붙은 공백으로 구분된 속성 목록입니다.

명령 옵션에 대한 설명은 일반 옵션을 참조하십시오.

이 명령이 성공적으로 실행되면 데이터베이스가 이전 상태 또는 이전보다 향상된 상태로 다시 시작됩니다. 데이터베이스 상태에 대한 자세한 내용은 HADB 상태 가져오기를 참조하십시오. 데이터베이스 재시작에 설명된 대로 HADB를 다시 시작합니다.

hadbm set으로는 다음 속성을 설정할 수 없습니다. 대신, 데이터베이스를 만들 때 해당 속성을 설정합니다( 데이터베이스 만들기 참조).

• DatabaseName

• DevicePath

• HistoryPath

• NumberOfDatadevices

• Portbase

• JdbcUrl(값은 --hosts 및 --portbase 옵션을 기반으로 데이터베이스 작성 도중 설정됨)

hadbm set을 사용하여 ConnectionTrace 또는 SQLTraceMode를 제외한 구성 속성을 설정하면 HADB의 롤링이 재시작됩니다. 롤링 재시작에서 각 노드가 중지되고 한 번에 하나씩 새 구성으로 시작됩니다. HADB 서비스는 인터럽트되지 않습니다.

ConnectionTrace 또는 SQLTraceMode를 설정하면 롤링 재시작이 발생하지 않지만 변경 내용은 Application Server 인스턴스에서 만든 새 HADB에만 적용됩니다.

구성 속성

다음 표에서는 hadbm set으로 수정하고 hadbm get으로 검색할 수 있는 구성 속성을 나열합니다.

JDBC 연결 풀 구성

Application Server는 JDBC(Java Database Connectivity) API를 사용하여 HADB와 통신합니다. asadmin configure-ha-cluster 명령은 cluster-name 클러스터에 대해 HADB와 함께 사용할 JDBC 연결 풀을 자동으로 만듭니다. 연결 풀의 이름은 cluster-name-hadb-pool입니다. JDBC 자원의 JNDI URL은 jdbc/cluster-name -hastore입니다.

일반적으로 연결 풀의 초기 구성이면 충분합니다. 노드를 추가할 때 각 HADB 활성 노드에 8개의 연결이 있도록 고정 풀 크기를 변경합니다. 노드 추가를 참조하십시오.

이 장은 다음 내용으로 구성되어 있습니다.

• JDBC URL 가져오기

• 연결 풀 만들기

• 예 3–5

• JDBC 자원 만들기

  연결 풀과 JDBC 자원에 대한 일반 정보는 관리 설명서를 참조하십시오.

JDBC URL 가져오기

JDBC 연결 풀을 설정하려면 먼저 다음과 같이 hadbm get 명령을 사용하여 HADB의 JDBC URL을 확인해야 합니다.

hadbm get JdbcUrl [dbname]

예를 들면 다음과 같습니다.

hadbm get JdbcUrl

이 명령은 다음과 같은 형식의 JDBC URL을 표시합니다.

jdbc:sun:hadb:host:port,
host:port,...

jdbc:sun:hadb: 접두어를 제거하고 host:port, host:port... 부분을 표 3–10에 설명된 대로 serverList 연결 풀 등록 정보의 값으로 사용합니다.

연결 풀 만들기

다음 표에서는 HADB에 필요한 연결 풀 설정을 요약하여 설명합니다. 노드를 추가할 때 고정 풀 크기를 변경합니다. 그러나 다른 설정은 변경하지 마십시오.

com.sun.hadb.jdbc.ds.HadbDataSource

다음은 HADB에 필요한 연결 풀 등록 정보를 요약한 표입니다. 노드를 추가할 때 serverList를 변경합니다. 그러나 다른 등록 정보는 변경하지 마십시오.

예 3–5 연결 풀 만들기

HADB JDBC 연결 풀을 만드는 asadmin create-jdbc-connection-pool 명령의 예는 다음과 같습니다.

asadmin create-jdbc-connection-pool
--user adminname --password secret 
--datasourceclassname com.sun.hadb.jdbc.ds.HadbDataSource
--steadypoolsize=32
--isolationlevel=repeatable-read
--isconnectvalidatereq=true
--validationmethod=meta-data
--property username=storename:password=secret456:serverList=
host\:port,host\:port,
host\\:port,host\:port,
host\:port,host\:port
:cacheDatabaseMetaData=false:eliminateRedundantEndTransaction=true hadbpool

Solaris에서는 등록 정보 값 내의 콜론 문자(:)에 이중 백슬래시(\\)를 이스케이프 문자로 사용합니다. Windows에서는 콜론 문자(:)에 단일 백슬래시(\)를 이스케이프 문자로 사용합니다.

JDBC 자원 만들기

다음 표에서는 HADB에 필요한 JDBC 자원 설정을 요약하여 설명합니다.