HADB の設定

この節では、次の基本的な HADB 設定作業について説明します。

• 「管理ドメインの作成」

• 「データベースの作成」

• 「設定属性の表示と変更」

• 「JDBC 接続プールの設定」

管理ドメインの作成

コマンド hadbm createdomain を実行すると、指定した HADB ホストを含む管理ドメインが作成されます。このコマンドは、ホストと持続性設定ストアとの間の内部通信チャネルを初期化します。

コマンドの構文は次のとおりです。

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

hostlist オペランドは、それぞれが有効な IPv4 ネットワークアドレスである HADB ホストのコンマ区切りリストです。新規ドメインに組み込むすべてのホストを hostlist に含めてください。

コマンドオプションの説明は、「汎用オプション」を参照してください。

このコマンドを使用する前に、HADB 管理エージェントが hostlist に含まれているすべてのホスト上で実行中であるかを確認してください。さらに、管理エージェントは次の条件を満たしている必要があります。

• 既存のドメインのメンバーではない。

• 同一のポートを使用するように設定されている。

• UDP や TCP を介して、および IP マルチキャストを使用して相互に通信できる。

hadbm が管理ドメインを作成すると、ドメイン内のすべてのホストが使用可能になります。これで、管理エージェントがデータベースを管理する用意は整いました。HADB ドメインを作成したら、次のステップは、HADB データベースの作成です。HADB データベースの作成に関する詳細については、「データベースの作成」を参照してください。

例 3–2 HADB 管理ドメインの作成

次の例では、指定した 4 つのホスト上に管理ドメインが作成されます。

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

hadbm がコマンドを正常に実行すると、次のメッセージが表示されます。

「ドメイン host1、host2、host3、host4 が作成されました。」

HADB ドメインを作成した後、HADB パッケージのパスとバージョンを管理エージェントに登録します。

データベースの作成

hadbm create コマンドを使用して、データベースを手動で作成します。

このコマンドを使用してデータベースを作成する前に、管理ドメインを作成し、HADB パッケージを登録します。hadbm create を実行する時点でこの 2 つのステップをまだ行なっていない場合は、コマンドによってそれらのステップが暗黙に実行されます。このようにすれば行う作業は減るように思えますが、いずれかのコマンドでエラーが生じたときに、デバッグが困難になる場合があります。さらに、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 アドレス) ごとに 1 つのノードを作成します。ノードの数は偶数でなければなりません。重複するホスト名を使用すると、同じマシン上に異なるポート番号が指定された複数のノードが作成されます。同じマシン上のノードがミラーノードではないことを確認してください。

ノードには、このオプションでリストされている順番で、ゼロから始まる番号が付けられます。最初のミラー化されたペアはノード 0 と 1、2 番目のミラーペアはノード 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 (関係代数クエリーデバイス)、および NoManDevice (ノードマネージャーデバイス) の 4 種類があります。各 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 の順次再起動が実行されます。順次再起動では、各ノードが停止し、一度に 1 つずつ新規の設定で起動します。このとき HADB サービスは中断されません。

ConnectionTrace または SQLTraceMode を設定した場合、順次再起動は実行されませんが、変更は Application Server インスタンスから作成された新規の HADB 接続に対してのみ反映されます。

設定属性

次の表に、hadbm set での変更と hadbm get での検出が可能な設定属性を一覧表示します。

JDBC 接続プールの設定

Application Server は Java Database Connectivity (JDBC) API を使用して HADB と通信します。asadmin configure-ha-cluster コマンドは、クラスタ cluster-name 用に JDBC 接続プールを自動的に作成して HADB と共用します。接続プールの名前は 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 では、プロパティー値に含まれるコロン文字 (:) は 2 つの円記号 (\\) でエスケープします。Windows では、コロン文字 (:) を 1 つの円記号 (\) でエスケープします。

JDBC リソースの作成

次の表に、HADB 用に必須の JDBC リソース設定を要約します。