第 3 章 高可用性データベースの管理

この章では、Sun Java System Application Server Enterprise Edition 環境における高可用性データベース (HADB) について説明します。HADB を設定および管理する方法について解説します。HADB の作成および管理をする前に、まずシステムのトポロジを決定して、各種マシンに HADB ソフトウェアをインストールする必要があります。

この章では、次ののトピックについて説明します。

• 「HADB 管理エージェントの使用法」

• 「hadbm 管理コマンドの使用法」

• 「HADB の設定」

• 「HADB の管理」

• 「HADB の拡張」

• 「HADB の監視」

• 「HADB マシンの管理」

HADB 管理エージェントの使用法

管理エージェント ma は HADB ホスト上で管理コマンドを実行します。HADB ノードスーパーバイザプロセスが失敗すると、管理エージェントはそのプロセスを再起動して、その可用性を確保します。

• 「管理エージェントコマンドの構文」

• 「管理エージェント設定のカスタマイズ」

• 「管理エージェントの起動」

管理エージェントコマンドの構文

管理エージェント ma コマンドの構文は、次のとおりです。

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

説明:

• common-options は、「管理エージェントコマンドの構文」で説明されている 1 つ以上の共通オプションです。

• service-options は、「管理エージェントコマンドの構文」で説明されている Windows サービスオプションのいずれかです。

• config-file は、管理エージェント設定ファイルへのフルパスです。詳細については、「管理エージェント設定のカスタマイズ」を参照してください。

「管理エージェントコマンドの構文」では、管理サービスを Windows サービスとして起動するためのオプションを説明しています。-i、-r、および -s オプションは相互に排他的であるため、一度に 1 つだけを使用してください。

Windows では、設定ファイルまたはコマンド行にプロパティー値のパスを指定する際に、スペースを含むファイルパスを二重引用符 ( ") で囲んでエスケープします。コロン (:) ドライブセパレータと円記号 (\) ディレクトリセパレータは、二重引用符と円記号を用いて "\: および "\\ のようにエスケープします。

管理エージェント設定のカスタマイズ

HADB には設定ファイルが組み込まれており、管理エージェント設定のカスタマイズに使用できます。設定ファイルを指定せずに管理エージェントを起動した場合は、デフォルト値が使用されます。設定ファイルを指定した場合、管理エージェントはそのファイルの設定を使用します。同じ設定ファイルをドメイン内のすべてのホストで繰り返し使用することができます。

HADB ホストごとに管理エージェント設定をカスタマイズするには

1. 管理エージェント設定ファイルを編集して、希望する値を設定します。

2. カスタマイズした設定ファイルを引数に指定して、管理エージェントを起動します。

設定ファイル

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 。

次の表で、設定ファイルの設定値について説明します。

console.loglevel

logfile.loglevel

logfile.name

ma.server.type

ma.server.
jmxmp.port

ma.server.
mainternal.interfaces

ma.server.
dbdevicepath

ma.server.
dbhistorypath

ma.server.
dbconfigpath

repository.dr.path

管理エージェントの起動

管理エージェントは 2 とおりの方法で起動できます。

• サービスとして本稼働環境で使用する場合。「サービスとしての管理エージェントの起動」を参照してください。 管理エージェントの有効性を確保するには、システムの再起動時に管理エージェントが自動的に起動することを確認してください。「管理エージェントの自動再起動の実現」を参照してください。

• コンソールモードで、評価、テスト、または開発における通常のプロセスとして使用する場合。「コンソールモードでの管理エージェントの起動」を参照してください。

  いずれの場合も、使用しているのが 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 で自動再起動を設定するには

始める前に

この節は、オペレーティングシステムの初期化と実行レベルについての基本を理解していることを前提としています。これらのトピックについては、使用しているオペレーティングシステムのマニュアルを参照してください。

1. システムのデフォルト実行レベルが 3 または 5 であることを確認します。

   システムのデフォルト実行レベルを確認するには、/etc/inittab ファイルを調べ、ファイル上部にある次のような行を探します。

   id:5:initdefault:

   この例は、デフォルト実行レベル 5 を示しています。

2. ファイル /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

3. マシンを再起動します。

次の手順

エージェントの自動起動および停止を解除するには、これらのリンクを削除するか、リンク名中の文字 K とS を小文字に変更します。

Solaris または Linux 上のスタンドアロン Application Server で自動再起動を設定するには

1. シェルで、カレントディレクトリを HADB_install_dir /bin に変更します。

2. シェルスクリプト ma-initd を編集します。

   スクリプト内の HADB_ROOT および HADB_MA_CFG のデフォルト値を確認して、インストールを反映させます。

   • HADB_ROOT は HADB インストールディレクトリ HADB_install_dir です。

   • HADB_MA_CFG は管理エージェント設定ファイルのある場所です。詳細については、「管理エージェント設定のカスタマイズ」を参照してください。

3. ma-initd をディレクトリ /etc/init.d にコピーします。

4. ファイル /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 です。

管理エージェントを停止するには、プロセスを終了するか、またはシェルウィンドウを閉じます。

hadbm 管理コマンドの使用法

hadbm コマンド行ユーティリティーを使用して、HADB ドメイン、そのデータベースインスタンス、およびノードを管理します。hadbm ユーティリティー (管理クライアントとも呼ばれる) は、管理サーバーとして動作している、指定された管理エージェントに管理要求を送信します。管理エージェントにはリポジトリからデータベース設定へのアクセスがあります。

この節では、次のトピックで、hadbm コマンド行ユーティリティーについて説明します。

• 「コマンド構文」

• 「セキュリティーオプション」

• 「汎用オプション」

• 「環境変数」

コマンド構文

hadbm ユーティリティーは、HADB_install_dir /bin ディレクトリにあります。hadbm コマンドの汎用構文は次のとおりです。

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

サブコマンドで実行する操作またはタスクを識別します。サブコマンドは大文字と小文字を区別します。ほとんどのコマンドはオペランドを 1 つ (通常は dbname) とりますが、オペランドをとらないコマンドやオペランドを 2 つとるコマンドもあります。

オプションを指定することにより、hadbm がサブコマンドを実行する方法を変更できます。オプションは大文字と小文字を区別します。各オプションには長い書式と短い書式があります。省略形の場合はダッシュ 1 つ (-) を前に付け、長い書式の場合はダッシュ 2 つ (--) を前に付けます。boolean 型のオプションを除くほとんどのオプションは引数値を必要とし、この引数値により機能がオンに切り替わります。オプションを指定しないとコマンドが正常に実行されないということではありません。

サブコマンドにデータベース名が必要な場合にデータベース名を指定しないと、hadbm はデフォルトデータベース hadb を使用します。

例 3–1 hadbm コマンドの例

次に示すのは、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 セキュリティーコマンド行オプションの要約を示します。

汎用オプション

汎用コマンドオプションは、どの hadbm サブコマンドにも使用できます。すべてが boolean 型オプションで、デフォルトは false です。次の表で、hadbm 汎用コマンドオプションについて説明します。

環境変数

便宜上、コマンドオプションを指定する代わりに、環境変数を設定することもできます。次の表で、hadbm コマンドオプションに対応する環境変数について説明します。

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 リソース設定を要約します。

HADB の管理

通常、ネットワーク、ハードウェア、オペレーティングシステム、または HADB ソフトウェアを交換またはアップグレードする際には、管理オペレーションを実行する必要があります。次の節では、さまざまな管理オペレーションについて説明します。

• 「ドメインの管理」

• 「ノードの管理」

• 「データベースの管理」

• 「データセッション破損からの回復」

ドメインの管理

HADB ドメインで、次の操作を実行できます。

• ドメインの作成。詳細については、「管理ドメインの作成」を参照してください。

• 「ドメインの拡張」

• 「ドメインの削除」

• 「ドメイン内のホストの一覧表示」

• 「ドメインからのホストの削除」

コマンドオプションの説明は、「セキュリティーオプション」および 「汎用オプション」を参照してください。

ドメインの拡張

extenddomain を使用して、既存の管理ドメインにホストを追加します。コマンド構文は次のとおりです。

hadbm extenddomain  
[--adminpassword=password | --adminpasswordfile=file]  
[--agent=maurl]  
hostlist

HADB ホストの IP アドレスは、IPv4 アドレスである必要があります。

詳細については、hadbm-extenddomain(1)を参照してください。

ドメインの削除

deletedomain を使用して、管理ドメインを削除します。コマンド構文は次のとおりです。

hadbm deletedomain  
[--adminpassword=password | --adminpasswordfile=file]  
[--agent=maurl]

詳細については、hadbm-deletedomain(1)を参照してください。

ドメインからのホストの削除

reducedomain を使用して、管理ドメインからホストを削除します。コマンド構文は次のとおりです。

hadbm reducedomain  
[--adminpassword=password | --adminpasswordfile=file]  
[--agent=maurl]  
host_list

詳細については、hadbm-reducedomain(1)を参照してください。

ドメイン内のホストの一覧表示

listdomain を使用して、管理ドメイン内に定義されているすべてのホストを一覧表示します。コマンド構文は次のとおりです。

hadbm listdomain  
[--adminpassword=password | --adminpasswordfile=file]  
[--agent=maurl]

詳細については、hadbm-listdomain(1)を参照してください。

ノードの管理

個々のノードに対して、次の操作を実行できます。

• 「ノードの起動」

• 「ノードの停止」

• 「ノードの再起動」

ノードの起動

ハードウェアやソフトウェアのアップグレードや交換のためにホストをオフラインにしたために、停止した HADB ノードを手動で起動する必要がある場合があります。また、二重障害以外の何らかの理由でノードが再起動に失敗すると、手動でのノードの起動が必要な場合があります。二重障害から回復する方法の詳細については、「データベースの解除」を参照してください。

たいていの場合には、まず normal 起動レベルを使用してノードの起動を試行することをお勧めします。normal 起動レベルで失敗するかまたはタイムアウトになる場合には、repair 起動レベルを使用する必要があります。

データベース内のノードを起動するには、hadbm startnode コマンドを使用します。構文は次のとおりです。

hadbm startnode
 [--adminpassword=password | --adminpasswordfile=file]
 [--agent=maurl]
 [--startlevel=level]
 nodeno
 [dbname]

dbname オペランドにはデータベース名を指定します。デフォルトは hadb です。

nodeno オペランドには起動するノードの番号を指定します。hadbm status を使用すると、データベース内のすべてのノードの番号を表示できます。

詳細については、hadbm-startnode(1)を参照してください。

起動レベルオプション

hadbm startnode コマンドには、ノードの起動レベルを指定する、1 つの特別なオプション --startlevel (省略形 -l) があります。

ノード起動レベルは次のとおりです。

• normal (デフォルト): ノード上 (メモリー内およびディスク上のデータデバイスファイル内) でローカルに検出されたデータを使用してノードを起動し、欠落している最新の更新内容をミラーとの間で同期します。

• repair: ノードに対して、ローカルデータの破棄およびミラーからのそのデータのコピーを強制します。

• clear: ノードのデバイスを再初期化し、ミラーノードから強制的にデータを修復します。デバイスファイルが損傷を受けたかまたはデバイスファイルを含むディスクを交換したため、デバイスファイルを初期化する必要がある場合に使用します。

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

例 3–6 ノードを起動する例

hadbm startnode 1

ノードの停止

ホストマシンのハードウェアやソフトウェアを修復またはアップグレードするために、ノードの停止が必要な場合があります。ノードを停止するには、hadbm stopnode コマンドを使用します。コマンド構文は次のとおりです。

hadbm stopnode  
[--adminpassword=password | --adminpasswordfile=file]  
[--agent=maurl]  
[--no-repair]  
nodeno  
[dbname]

nodeno オペランドには停止するノードの番号を指定します。このノード番号のミラーノードが実行中でなければなりません。hadbm status を使用すると、データベース内のすべてのノードの番号を表示できます。

dbname オペランドにはデータベース名を指定します。デフォルトは hadb です。

hadbm stopnode コマンドには、停止したノードを置き換えるスペアノードがないことを示す、1 つの特別なオプション --no-repair (省略形 -R) があります。このオプションを使用しない場合は、スペアノードが起動して、停止したノードの機能を引き継ぎます。

その他のコマンドオプションの説明は、「汎用オプション」を参照してください。詳細については、hadbm-stopnode(1)を参照してください。

例 3–7 ノードを停止する例

hadbm stopnode 1

ノードの再起動

CPU の過剰な消費など異常な動作が見られる場合には、ノードの再起動が必要なこともあります。

データベース内のノードを再起動するには、hadbm restartnode コマンドを使用します。コマンド構文は次のとおりです。

hadbm restartnode  
[--adminpassword=password | --adminpasswordfile=file]  
[--agent=maurl]  
[--startlevel=level]  
nodeno  
[dbname]

dbname オペランドにはデータベース名を指定します。デフォルトは hadb です。

nodeno オペランドには再起動するノードの番号を指定します。hadbm status を使用すると、データベース内のすべてのノードの番号を表示できます。

hadbm restartnode コマンドには、ノードの起動レベルを指定する、1 つの特別なオプション --startlevel (省略形 -l) があります。詳細については、「起動レベルオプション」を参照してください。

その他のコマンドオプションの説明は、「汎用オプション」を参照してください。詳細については、hadbm-restartnode(1)を参照してください。

例 3–8 ノードを再起動する例

hadbm restartnode 1

データベースの管理

HADB データベースで、次の操作を実行できます。

• 「データベースの起動」

• 「データベースの停止」

• 「データベースの再起動」

• 「データベースの一覧表示」

• 「データベースの解除」

• 「データベースの削除」

データベースの起動

データベースを起動するには、hadbm start コマンドを使用します。このコマンドは、データベースが停止する前に実行していたすべてのノードを起動します。停止後にデータベースを起動しても、個別に停止されてオフラインになっているノードは起動されません。

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

hadbm start  
[--adminpassword=password | --adminpasswordfile=file]  
[--agent=maurl]  
[dbname]

dbname オペランドにはデータベース名を指定します。デフォルトは hadb です。

コマンドオプションの説明は、「汎用オプション」を参照してください。詳細については、hadbm-start(1)を参照してください。

例 3–9 データベースを起動する例

hadbm start

データベースの停止

データベースを停止してから起動するまでの、データベースが停止している間は、データを使用することができません。データを使用可能にするために、「データベースの再起動」で説明されているようにデータベースを再起動できます。

次の目的で、データベースを停止します。

• データベースを削除する。

• すべての HADB ノードに影響するシステム保守を実行する。

データベースを停止する前に、そのデータベースを使用する依存 Application Server インスタンスを停止するか、またはそれらのインスタンスが ha 以外の「持続型」を使用するように設定します。

データベースを停止すると、データベース内で実行中のすべてのノードが停止し、データベースの状態が「停止中」になります。データベースの状態の詳細については、「HADB の状態の取得」を参照してください。

データベースを停止するには、hadbm stop コマンドを使用します。コマンド構文は次のとおりです。

hadbm stop  
[--adminpassword=password | --adminpasswordfile= file]  
[--agent=maurl]  
[dbname]

dbname オペランドにはデータベース名を指定します。デフォルトは hadb です。

コマンドオプションの説明は、「汎用オプション」を参照してください。詳細については、hadbm-stop(1)を参照してください。

例 3–10 データベースを停止する例

hadbm stop

データベースの再起動

タイムアウトの問題が解消されないなどの異常な動作が見られる場合には、データベースの再起動が必要なこともあります。再起動で問題が解決する場合もあります。

データベースを再起動すると、データベースとそのデータは引き続き使用可能です。HADB を停止してから起動するまでの、HADB が停止している間は、データおよびデータベースサービスを使用することができません。これは、デフォルトで hadbm restart がノードの順次再起動を実行するためです。このときノードは 1 つずつ順番に停止して起動します。一方、hadbm stop を実行した場合には、すべてのノードが同時に停止します。

データベースを再起動するには、hadbm restart コマンドを使用します。コマンド構文は次のとおりです。

hadbm restart  
[--adminpassword=password | --adminpasswordfile=file]  
[--agent=maurl]  
[--no-rolling]  
[dbname]

dbname オペランドにはデータベース名を指定します。デフォルトは hadb です。

このコマンドには特別なオプションが 1 つあります。それは --no-rolling (省略形 -g) で、すべてのノードの一括再起動を指定するオプションですが、サービスの低下を招きます。このオプションを使用しない場合は、データベース内の各ノードが現在の状態またはよりよい状態で再起動されます。

その他のコマンドオプションの説明は、「汎用オプション」を参照してください。詳細については、hadbm-restart(1)を参照してください。

次に例を示します。

hadbm restart

データベースの一覧表示

HADB インスタンス内のすべてのデータベースを一覧表示するには、hadbm list コマンドを使用します。コマンド構文は次のとおりです。

hadbm list  
[--agent=maurl] 
[--adminpassword=password | --adminpasswordfile=file]

コマンドオプションの説明は、「汎用オプション」を参照してください。詳細については、hadbm-list(1)を参照してください。

データベースの解除

次の場合には、データベースを解除します。

• hadbm status コマンドから、データベースが稼働していないことがわかる。「HADB の状態の取得」を参照してください。

• 複数のノードが応答せず、長時間待機状態である。

• セッションデータ破損から回復している。「データセッション破損からの回復」を参照してください。

hadbm clear コマンドはデータベースノードを停止し、データベースデバイスを解除してから、ノードを起動します。このコマンドは HADB 内の Application Server スキーマデータストア (テーブル、ユーザー名、パスワードを含む) を消去します。hadbm clear を実行した後で、asadmin configure-ha-cluster を使用してデータスキーマを再作成し、JDBC 接続プールを再設定し、セッション持続性ストアを再ロードしてください。

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

hadbm clear  [--fast]  [--spares=number]  
[--dbpassword=password | --dbpasswordfile= file]  
[--adminpassword=password | --adminpasswordfile= file]  
[--agent=maurl] 
[dbname]

dbname オペランドにはデータベース名を指定します。デフォルトは hadb です。

次の表で、hadbm clear の特別なコマンドオプションについて説明します。その他のオプションの説明は、「汎用オプション」を参照してください。

詳細については、hadbm-clear(1)を参照してください。

次に例を示します。

hadbm clear --fast --spares=2 --dbpassword secret123

データベースの削除

既存のデータベースを削除するには、hadbm delete コマンドを使用します。このコマンドは、データベースの設定ファイル、デバイスファイル、および履歴ファイルを削除し、共用メモリーリソースを解放します。削除対象のデータベースは、存在していてかつ停止している必要があります。「データベースの停止」を参照してください。

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

hadbm delete  
[--adminpassword=password | --adminpasswordfile=file]  
[--agent=maurl]  
[dbname]

dbname オペランドにはデータベース名を指定します。デフォルトは hadb です。

コマンドオプションの説明は、「汎用オプション」を参照してください。詳細については、hadbm-delete(1)を参照してください。

例 3–11 データベースを削除する例

コマンド

hadbm delete

は、デフォルトのデータベース hadb を削除します。

データセッション破損からの回復

次のような症状が見られる場合、セッションデータが破損している可能性があります。

• アプリケーションがセッション状態を保存しようとするたびに、Application Server システムログ (server.log ) にエラーメッセージが表示される。

• サーバーログのエラーメッセージに、セッションが見つからなかったり、セッションアクティベーション中にセッションをロードできなかったことが示されている。

• 以前非アクティブにされていたセッションをアクティブにしたところ、そのセッションに空のセッションデータまたは不正なセッションデータが含まれている。

• インスタンスに障害が発生する際に、処理を継続したセッションに、空のまたは不正なセッションデータが含まれている。

• インスタンスに障害が発生し、処理を継続したセッションをロードしようとするインスタンスがエラーを起こし、サーバーログに、セッションが見つからなかったりロードできなかったことが示されている。

セッションストアを一貫性のある状態に戻すには

セッションストアが破損していると判断する場合には、次の手順に従って一貫性のある状態に戻します。

1. セッションストアを消去します。

   この処置で問題が正されたかどうかを判定します。問題が正された場合は、これで処置は終わりです。引き続きサーバーログにエラーが表示されるなど、問題が正されていない場合は、処置を継続します。

2. すべてのノード上のデータスペースを再初期化して、データベース内のデータを消去します。

   「データベースの解除」を参照してください。

   この処置で問題が正されたかどうかを判定します。問題が正された場合は、これで処置は終わりです。引き続きサーバーログにエラーが表示されるなど、問題が正されていない場合は、処置を継続します。

3. データベースを削除して再作成します。

   「データベースの削除」および 「データベースの作成」を参照してください。

HADB の拡張

元の HADB 設定を拡張する 2 つの理由があります。

• 保存されているセッションデータのボリュームが増えて、データデバイス内の既存の記憶スペースを超過している。データデバイスが満杯になったために、トランザクションが異常終了し始める可能性があります。

• ユーザー側の負荷が増えて、システムリソースが使い果たされる。さらにホストを追加することが必要です。

この節では、Application Server クラスタまたはデータベースを停止せずに HADB を拡張する方法について説明します。特に、次の点を扱います。

• 「既存ノードへの記憶スペースの追加」

• 「マシンの追加」

• 「ノードの追加」

• 「データベースの再断片化」

• 「データベースの再作成によるノードの追加」

「HADB マシンの管理」にある関連情報も参照してください。

既存ノードへの記憶スペースの追加

次のような場合に、HADB 記憶スペースを追加します。

• ユーザートランザクションが、次のいずれかのエラーメッセージを出して繰り返し異常終了する。

  • 4592: データデバイスに空きブロックがありません

  • 4593: データデバイスに未予約ブロックがありません

• hadbm deviceinfo コマンドが終始空きサイズの不足を報告する。「デバイス情報の取得」を参照してください。

ノードに使用されていないディスクスペースがある場合やディスク容量を追加する場合は、既存のノードに記憶スペースを追加することもできます。推奨されているデータデバイスサイズについては、「デバイスサイズの指定」を参照してください。

ノードに記憶スペースを追加するには、hadbm set コマンドを使用してデータデバイスサイズを増やします。

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

hadbm set DataDeviceSize=size

ここで、size は M バイト単位でのデータデバイスサイズです。

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

FaultTolerant またはそれ以上のシステム状態にあるデータベースでは、データデバイスサイズを変更することによって、データや可用性を犠牲にすることなくシステムはアップグレードされます。再設定の間も、データベースは稼働状態を維持します。FaultTolerant またはそれ以上の状態ではないシステムでデバイスサイズを変更すると、データの喪失が生じます。データベースの状態の詳細については、「データベースの状態」を参照してください。

例 3–12 データデバイスサイズを設定する例

次に示すのは、データデバイスサイズを設定するコマンドの例です。

hadbm set DataDeviceSize=1024

マシンの追加

HADB が処理能力や記憶容量をさらに必要としている場合には、マシンを追加します。HADB を実行するマシンを新たに追加するには、第 2 章「高可用性 (HA) データベースのインストールと設定」で説明されている手順に従って、HADB パッケージをインストールします。このとき、Application Server を一緒にインストールしてもしなくてもかまいません。ノードトポロジの代替手段については、『Sun Java System Application Server Enterprise Edition 8.1 2005Q2 Deployment Planning Guide』の第 3 章「Selecting a Topology」を参照してください。

既存の HADB インスタンスに新たなマシンを追加するには

1. 新規ノード上で管理エージェントを起動します。

2. 管理ドメインを新規ホストへ拡張します。

   詳細については、hadbm extenddomain コマンドを参照してください。

3. この新規ホスト上で新規ノードを起動します。

   詳細については、「ノードの追加」を参照してください。

ノードの追加

HADB システムの処理能力と記憶容量を増やすには、新規ノードを作成してデータベースに追加します。

ノードを追加した後で、HADB JDBC 接続プールの次のプロパティーを更新します。

• serverlist プロパティー。

• 通常プールサイズ。一般には、新規ノードにつき 8 つの接続を追加します。詳細については、『Sun Java System Application Server Enterprise Edition 8.1 2005Q2 Deployment Planning Guide』の「System Sizing」を参照してください。

ノードを追加するには、hadbm addnodes コマンドを使用します。コマンド構文は次のとおりです。

hadbm addnodes  [--no-refragment]  [--spares=sparecount]  
[--historypath=path]  
[--devicepath=path]  
[--set=attr-name-value-list]  
[--dbpassword=password | --dbpasswordfile=file ]  
[--adminpassword=password | --adminpasswordfile=file]  
--hosts=hostlist  [dbname]

dbname オペランドにはデータベース名を指定します。デフォルトは hadb です。データベースの状態は、HAFaultTolerant またはFaultTolerant である必要があります。データベースの状態の詳細については、「HADB の状態の取得」を参照してください。

--devicepath と --historypath オプションを指定しない場合、新規ノードは既存データベースと同じデバイスパスを持ち、同じ履歴ファイルを使用します。

ノードを追加すると、既存データの再断片化と再配布が実行されて、システムに新規ノードが組み込まれます。オンラインで再断片化を実行するには、再断片化が終了するまで古いデータと新しいデータを同時に保持できるだけの十分なスペースが HADB ノードのディスクに必要です。つまり、ユーザーデータサイズは、ユーザーデータに使用可能なスペースの 50% を超えてはいけません。詳細については、「デバイス情報の取得」を参照してください。

システムが軽くロードされるときにノードを追加するのが最善です。

例 3–13 ノードを追加する例

次に例を示します。

hadbm addnodes --dbpassword secret123 -adminpassword=
password --hosts n6,n7,n8,n9

次の表で、hadbm addnodes の特別なコマンドオプションについて説明します。その他のオプションの説明は、「汎用オプション」を参照してください。

データベースの再断片化

データベースを再断片化して、新たに作成したノードにデータを格納します。再断片化により、すべてのアクティブなノードにデータが均一に分散します。

データベースを再断片化するには、hadbm refragment コマンドを使用します。コマンド構文は次のとおりです。

hadbm refragment  [--dbpassword=password | --dbpasswordfile=file]  
[--adminpassword=password | --adminpasswordfile=file]  
[--agent=maurl]  
[dbname]

dbname オペランドにはデータベース名を指定します。デフォルトは hadb です。データベースの状態は、HAFaultTolerant またはFaultTolerant である必要があります。データベースの状態の詳細については、「HADB の状態の取得」を参照してください。

コマンドオプションの説明は、「汎用オプション」を参照してください。詳細については、hadbm-refragment(1)を参照してください。

オンラインで再断片化を実行するには、再断片化が終了するまで古いデータと新しいデータを同時に保持できるだけの十分なスペースが HADB ノードのディスクに必要です。つまり、ユーザーデータサイズは、ユーザーデータに使用可能なスペースの 50% を超えてはいけません。詳細については、「デバイス情報の取得」を参照してください。

システムが軽くロードされるときにデータベースを再断片化するのが最善です。

何回試してもこのコマンドが失敗する場合は、「データベースの再作成によるノードの追加」を参照してください。

例 3–14 データベースを再断片化する例

次に例を示します。

hadbm refragment --dbpassword secret123

データベースの再作成によるノードの追加

新規ノードを追加して、データデバイススペースの不足やその他の理由からオンラインでの再断片化が何度も失敗する場合は、新規ノードを持つデータベースを再作成します。これは、既存のユーザーデータとスキーマデータの喪失を招きます。

データベースの再作成によりノードを追加するには

次の手順により、プロセス全体の HADB 可用性を維持することができます。

1. 各 Application Server インスタンスに対して、次のようにします。

   1. ロードバランサの Application Server インスタンスを無効にします。

   2. セッション持続性を無効にします。

   3. Application Server インスタンスを再起動します。

   4. ロードバランサの Application Server インスタンスを再度有効にします。

   可用性を維持する必要がない場合は、ロードバランサのすべてのサーバーインスタンスを無効にしてすぐに再度有効にできます。こうすることで、時間を節約するとともに、古いセッションデータのフェイルオーバーを防ぎます。

2. 「データベースの停止」で説明されている手順に従って、データベースを停止します。

3. 「データベースの削除」で説明されている手順に従って、データベースを削除します。

4. 「データベースの作成」で説明されている手順に従って、追加のノードでデータベースを再作成します。

5. 「JDBC 接続プールの設定」で説明されている手順に従って、JDBC 接続プールを再設定します。

6. セッション持続性ストアを再ロードします。

7. 各 Application Server インスタンスに対して、次のようにします。

   1. ロードバランサの Application Server インスタンスを無効にします。

   2. セッション持続性を有効にします。

   3. Application Server インスタンスを再起動します。

   4. ロードバランサの Application Server インスタンスを再度有効にします。

   可用性を維持する必要がない場合は、ロードバランサのすべてのサーバーインスタンスを無効にしてすぐに再度有効にできます。こうすることで、時間を節約するとともに、古いセッションデータのフェイルオーバーを防ぎます。

HADB の監視

次の方法で、HADB のアクティビティーを監視できます。

• 「HADB の状態の取得」

• 「デバイス情報の取得」

• 「ランタイムリソース情報の取得」

これらの節では、hadbm status、hadbm deviceinfo、および hadbm resourceinfo コマンドについて簡潔に説明します。HADB 情報の解釈については、『Sun Java System Application Server Enterprise Edition 8.1 2005Q2 Performance Tuning Guide』の「Performance」を参照してください。

HADB の状態の取得

hadbm status コマンドを使用して、データベースまたはそのノードの状態を表示します。コマンド構文は次のとおりです。

hadbm status  
[--nodes]  
[--adminpassword=password | --adminpasswordfile=file]  
[--agent=maurl] 
[dbname]

dbname オペランドにはデータベース名を指定します。デフォルトは hadb です。

--nodes オプション (省略形 -n) は、データベース内の各ノードに関する情報を表示します。詳細については、「ノードの状態」を参照してください。その他のコマンドオプションの説明は、「汎用オプション」を参照してください。

詳細については、hadbm-status(1)を参照してください。

例 3–15 HADB 状態を取得する例

次に例を示します。

hadbm status --nodes

データベースの状態

データベースの状態には、データベースの現在の状況が要約されます。次の表で、データベースが取りうる状態の種類について説明します。

ノードの状態

--nodes オプションを使用して、hadbm status コマンドでデータベース内の各ノードに関する次の情報を表示させます。

• ノード番号

• ノードが実行中であるマシンの名前

• ノードのポート番号

• ノードのロール。ロールとその意味のリストについては、「ノードのロール」を参照してください。

• ノードの状態。状態とその意味のリストについては、「ノードの状態」を参照してください。

• 対応するミラーノードの番号。

次の節に説明されているように、ノードのロールと状態は変更される場合があります。

• 「ノードのロール」

• 「ノードの状態」

ノードのロール

ノードには作成時にロールが割り当てられます。次ののいずれかのロールを担います。

• アクティブ:データを格納し、クライアントアクセスを許可します。アクティブノードはミラー化されたペアになっています。

• スペア:クライアントアクセスを許可しますが、データを格納しません。データデバイスを初期化した後に、他のデータノードを監視して、あるノードが使用不能であれば修復を開始します。

• オフライン:ロールが変更されるまでサービスを提供しません。再びオンラインになったときに、元のロールに戻される場合があります。

• シャットダウン:アクティブとオフラインの中間の段階で、スペアノードによる機能の引き継ぎを待機している状態です。スペアノードによる引き継ぎが完了すると、ノードはオフラインになります。

ノードの状態

ノードは次のいずれかの状態になります。

• 起動中:ノードは起動中です。

• 待機中:ノードは起動レベルを決定できず、オフラインになっています。ノードがこの状態のまま 2 分を経過した場合は、そのノードを停止し、repair レベルで起動してください。「ノードの停止」、「ノードの起動」、および 「データベースの解除」を参照してください。

• 実行中:ノードはロールに応じたすべてのサービスを提供しています。

• 停止中:ノードは停止処理を行なっています。

• 停止:ノードは停止しています。停止したノードの修復は禁止されています。

• 回復中:ノードは回復処理を行っています。ノードに障害が発生した場合、ミラーノードがそのノードの機能を引き継ぎます。障害が発生したノードは、メインメモリーまたはディスク内のデータとログレコードを使用して回復を試行します。また、ミラーノードのログレコードを使用して、障害発生時に実行していたトランザクションの回復に努めます。回復に成功した場合には、そのノードが再びアクティブになります。回復が失敗した場合は、ノードの状態が「修復中」に変更されます。

• 修復中:ノードは修復処理を行っています。この操作で、ノードは再初期化され、ミラーノードからデータとログレコードがコピーされます。修復には回復より時間がかかります。

デバイス情報の取得

次の目的で、HADB データ (ディスク記憶装置) デバイスの空き領域を監視します。

• ディスク容量の使用傾向を定期的にチェックする。

• 予防保守の一環として。ユーザー側の負荷が増え、データベース設定の大きさの変更やスケールを考慮している場合。

• データベースを拡大する操作の一部として。hadbm addnodes を実行して新規ノードをシステムに追加する前に、十分なデバイス空間があるかどうかをチェックします。ノードを追加するには、既存のノード上に 40 〜 50% ほどの空き領域が必要となることを念頭に置いてください。

• 履歴ファイルや server.log ファイルに次のようなメッセージが表示された場合。

  • No free blocks on data devices

  • No unreserved blocks on data devices .

hadbm deviceinfo コマンドを使用して、データデバイス内の空き領域に関する情報を取得します。このコマンドを実行すると、データベースの各ノードについて次の情報が表示されます。

• 割り当て済みの合計デバイスサイズ (Totalsize)。単位は M バイト。

• 空き領域 (Freesize)。単位は M バイト。

• 現在使用されているデバイスの比率 (Usage)

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

hadbm deviceinfo  [--details]  
[--adminpassword=password | --adminpasswordfile=file]  
[--agent=maurl]  [dbname]

dbname オペランドにはデータベース名を指定します。デフォルトは hadb です。

--details オプションを指定すると、次の追加情報が表示されます。

• デバイスが実行した読み取り操作の数。

• デバイスが実行した書き込み操作の数。

• デバイスの名前。

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

詳細については、hadbm-deviceinfo(1)を参照してください。

ユーザーデータ用に使用可能な空き容量を算定するには、合計デバイスサイズから HADB 用に予約済みの容量 (LogBufferSize の 4 倍 + デバイスサイズの 1%) を減算します。ログバッファーのサイズがわからない場合は、コマンド hadbm get logbufferSize を使用してください。たとえば、合計デバイスサイズが 128M バイトで LogBufferSize が 24M バイトの場合、ユーザーデータ用に使用可能な容量は 128 – (4 x 24) = 32M バイトです。この 32M バイトのうち、半分はレプリケートデータ用に使用され、約 1 % が索引用に使用されるため、実ユーザーデータに使用できるのは 25 % だけです。

ユーザーデータに使用可能な容量は、合計サイズと予約済みサイズの差です。将来的にデータを再断片化するのであれば、空き容量がユーザーデータに使用可能な領域の 50% にほぼ等しくなるようにする必要があります。再断片化がふさわしくない場合は、データデバイスを最大限度まで活用することができます。システムのデバイス容量が不足すると、リソース消費警告が履歴ファイルに書き込まれます。

HADB の調整に関する詳細については、『Sun Java System Application Server Performance Tuning Guide』を参照してください。

例 3–16 デバイス情報を取得する例

コマンド

hadbm deviceinfo --details

を実行すると、次の例のような結果が表示されます。

NodeNO Totalsize Freesize Usage NReads NWrites DeviceName
0      128       120      6%    10000  5000    C:\Sun\SUNWhadb\hadb.data.0
1      128       124      3%    10000  5000    C:\Sun\SUNWhadb\hadb.data.1
2      128       126      2%     9500  4500    C:\Sun\SUNWhadb\hadb.data.2
3      128       126      2%     9500  4500    C:\Sun\SUNWhadb\hadb.data.3

ランタイムリソース情報の取得

hadbm resourceinfo コマンドは、HADB ランタイムリソース情報を表示します。この情報を使用して、リソースの競合を識別し、パフォーマンス上のボトルネックを削減するのに役立てることができます。詳細については、『Sun Java System Application Server Enterprise Edition 8.1 2005Q2 Performance Tuning Guide』の「Tuning HADB」を参照してください。

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

hadbm resourceinfo  [--databuf]  [--locks]  [--logbuf]  [--nilogbuf]  
[--adminpassword=password | --adminpasswordfile=file]  
[--agent=maurl]  
[dbname]

dbname オペランドにはデータベース名を指定します。デフォルトは hadb です。

次の表で、hadbm resourceinfo の特別なコマンドオプションについて説明します。その他のコマンドオプションの説明は、「汎用オプション」を参照してください。

詳細については、hadbm-resourceinfo(1)を参照してください。

データバッファープール情報

データバッファープール情報には、次の内容が含まれます。

• NodeNo: ノード番号。

• Avail: プール内の使用可能容量の合計。単位は M バイト。

• Free: 使用可能な空き容量。単位は M バイト。

• Access: 起動時から現在までにデータベースがデータバッファーにアクセスした累積回数。

• Misses: データベース起動時から現在までに発生したページフォルトの累積回数。

• Copy-on-Write: チェックポイントのためにデータバッファーに内部的にコピーされたページの累積数。

ユーザートランザクションがレコードに対して操作を実行するときには、そのレコードを含むページはデータバッファープール内になければなりません。そのようになっていないと、ミス またはページフォルトが生じます。すると、ディスク上のデータデバイスフィルからページが取り出されるまで、トランザクションは待機する必要があります。

ミスの比率が高い場合は、データバッファープールを増やしてください。ミスのカウントは累積回数なので、定期的に hadbm resourceinfo を実行し、二回分のカウントの差を調べて、ミスの比率の傾向を確認します。空き容量が非常に少ないとしても、チェックポイントメカニズムによって新たに使用可能なブロックが作成されるので、心配する必要はありません。

例 3–17 データバッファープール情報の例

次に例を示します。

NodeNO Avail Free Access Misses Copy-on-Write
0 256 128 100000 50000 10001 256 128 110000 45000 950

ロック情報

ロック情報には、次の内容が含まれます。

• NodeNo: ノード番号。

• Avail: ノード上で使用可能なロックの合計数。

• Free: 使用されていないロックの数。

• Waits: ロックの獲得を待機しているトランザクションの数。これは累積数です。

1 つのトランザクションが、ノード上で利用可能なロックの 25% を超えて使用することはできません。そのため、規模の大きい操作を実行するトランザクションは、この制限を認識している必要があります。そのようなトランザクションはバッチ処理で実行するのが最善です。その場合、それぞれのバッチは別個のトランザクションとして扱われ、バッチごとにコミット操作を行うことになります。このようにする必要があるのは、繰り返し可能な読み取り遮断レベルで実行する読み取り操作、および削除、挿入、更新操作が、トランザクション終了後にのみ解放されるロックを使用するからです。

NumberOfLocks を変更するには、「履歴ファイルの消去と保存」を参照してください。

例 3–18 ロック情報の例

次に例を示します。

NodeNO Avail Free Waits
0 50000 20000 101 50000 20000 0

ログバッファー情報

ログバッファー情報には、次の内容が含まれます。

• NodeNo: ノード番号。

• Available: ログバッファー用に割り当てられたメモリーの容量。単位は M バイト。

• Free: 空きメモリーの容量。単位は M バイト。

空き容量が非常に少ないとしても、HADB がログバッファーの圧縮を開始するので、心配する必要はありません。HADB は、リングバッファの先頭から圧縮を開始し、連続するログレコードに対して圧縮を実行します。ノードが実行していないのにミラーノードが受信しているログレコードを HADB が検出すると、圧縮は続行できなくなります

例 3–19 ログバッファ情報の例

次に例を示します。

NodeNO Avail Free
0 16 21 16 3

ノード内部ログバッファー情報

ノード内部ログバッファー情報には、次の内容が含まれます。

• ノード番号。

• Available: ログデバイス用に割り当てられたメモリーの容量。単位は Mバイト。

• Free: 空きメモリーの容量。単位は M バイト。

例 3–20 内部ログバッファ情報の例

次に例を示します。

NodeNO Avail Free

0 16 21 16 3

HADB マシンの管理

HADB は、ミラーノードにデータをレプリケートすることによって耐障害性を実現します。『Sun Java System Application Server Enterprise Edition 8.1 2005Q2 Deployment Planning Guide 』に説明されているように、本稼働環境では、ミラーノードはミラーリング対象のノードとは別個の DRU 上に配置されます。

障害とは、ハードウェアの故障、停電、オペレーティングシステムの再起動など予期しない出来事のことです。HADB は、単一の障害に対する耐性を備えています。したがって、単一のノード、ミラーノードペアを持たない単一のマシン、同一の DRU に属する 1 つ以上のマシン、単一の DRU 全体などが対象となります。しかし HADB は、二重障害、すなわち 1 つ以上のミラーノードペアで同時に起きた障害からは自動的に回復しません。二重障害が起きた場合は、HADB を解除してセッションストアを再作成する必要があり、このとき HADB のデータはすべて消去されます。

対象のマシンが 1 つか複数かに応じて、保守手順は異なります。

単一のマシンに対して保守を実行するには

この手順は計画的な保守と予定外の保守の両方に適用でき、それによって HADB の利用が中断されることはありません。

1. 保守手順を実行し、マシンを稼働状態にします。

2. ma が実行中であることを確認します。

   ma が Windows サービスとして実行されているか、または init.d スクリプトの下で実行されている場合 (配備環境で推奨されている方法)、おそらくそれはオペレーティングシステムによって起動されています。そうでない場合は ma を手動で起動します。「管理エージェントの起動」を参照してください。

3. マシン上のすべてのノードを起動します。

   詳細については、「ノードの起動」を参照してください。

4. ノードがアクティブで実行状態であるかどうかを確認します。

   詳細については、「HADB の状態の取得」を参照してください。

すべての HADB マシンに対して計画的な保守を実行するには

計画的な保守には、ハードウェアとソフトウェアのアップグレードなどの操作が含まれます。この手順によって HADB の利用が中断されることはありません。

1. 1 つ目の DRU 内の各スペアマシンに対して、「単一のマシンに対して保守を実行するには」で説明されている手順に従って、単一マシン用の手順を順番に繰り返します。

2. 1 つ目の DRU 内のアクティブな各マシンに対して、「単一のマシンに対して保守を実行するには」で説明されている手順に従って、単一マシン用の手順を順番に繰り返します。

3. 2 番目の DRU に対して、ステップ 1 と 2 を繰り返します。

すべての HADB マシンに対して計画的な保守を実行するには

この手順は、HADB が 1 つまたは複数のマシン上に配置されている場合に適用されます。保守手順の実行中は、HADB サービスが中断されます。

1. HADB を停止します。「データベースの停止」を参照してください。

2. 保守手順を実行し、すべてのマシンを稼働状態にします。

3. ma が実行中であることを確認します。

4. HADB を起動します。

   詳細については、「データベースの起動」を参照してください。

   最後のステップを完了した後に、HADB は再び利用可能になります。

障害発生時に予定外の保守を実行するには

1. データベースの状態を確認します。

   「HADB の状態の取得」を参照してください。

   • データベースの状態が「稼働」またはそれよりよい場合は、次のようにします。

     予定外の保守を必要とするマシンに、ミラーノードは含まれません。DRU 別に、障害の発生した各マシンに対して、単一マシン用の保守手順を行います。HADB サービスは中断されません。

   • データベースの状態が「非稼働」の場合は、次のようにします。

     予定外の保守を必要とするマシンに、ミラーノードが含まれます。たとえば、HADB 全体が障害の発生した単一のマシンに置かれているようなケースです。まず、すべてのマシンを稼働状態にします。次に、HADB を解除して、セッションストアを再作成します。「データベースの解除」を参照してください。この手順により、HADB サービスは中断されます。

履歴ファイルの消去と保存

HADB 履歴ファイルには、すべてのデータベース操作とエラーメッセージが記録されます。HADB は既存の履歴ファイルの末尾に記録を追加していくため、時間の経過とともにファイルのサイズは大きくなります。ディスク容量を節約し、ファイルが大きくなりすぎないようにするために、履歴ファイルを定期的に消去および保存します。

データベースの履歴ファイルを消去するには、hadbm clearhistory コマンドを使用します。

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

hadbm clearhistory  
[--saveto=path]  
[dbname]  
[--adminpassword=password | --adminpasswordfile=file]  
[--agent=maurl]

dbname オペランドにはデータベース名を指定します。デフォルトは hadb です。

--saveto オプション (省略形 -o) は、古い履歴ファイルを格納するディレクトリを指定します。このディレクトリには適切な書き込み権が必要です。その他のコマンドオプションの説明は、「汎用オプション」を参照してください。

詳細は、hadbm-clearhistory(1)を参照してください。

hadbm create コマンドの --historypath オプションは、履歴ファイルの場所を特定します。履歴ファイルの名前は dbname.out.nodeno という形式です。hadbm createについては、「データベースの作成」を参照してください。

履歴ファイルの書式

履歴ファイルの各メッセージには、次の情報が含まれています。

• メッセージを生成した HADB プロセスの省略名。

• メッセージの種類:

  • INF - 一般情報

  • WRN - 警告

  • ERR - エラー

  • DBG - デバッグ情報

• 時刻表示。時刻は、ホストマシンのシステムクロックから取得されます。

• ノードが停止または起動したときにシステムで生じるサービスセットの変更。

リソースの不足に関するメッセージには、文字列「HIGH LOAD」が含まれています。

履歴ファイルに含まれるすべての項目に関する詳しい知識は必要ありません。何らかの理由で履歴ファイルを詳細に分析する必要がある場合には、Sun カスタマサポートにご連絡ください。