<book_title> を検索 ...

Cluster Server 7.3.1 Agent for DB2 インストール/設定ガイド - Solaris

Last Published: 2018-01-17

Product(s): InfoScale & Storage Foundation (7.3.1)

Db2udb リソースタイプの定義と属性の定義について

DB2 エージェント属性の説明を確認します。エージェント属性は必須、オプション、内部に分類されます。

表: DB2 用エージェントの必須属性に、DB2 用エージェントの必須属性を示します。必須属性には値を割り当てる必要があります。

表: DB2 用エージェントの必須属性

必須属性	説明
DB2InstHome	DB2 インスタンスの設定ファイルと重要データが格納されている DB2 UDB インスタンスホームディレクトリへのパス。データ形式と値のタイプ: 文字列 - スカラー
DB2InstOwner	DB2 UDB インスタンスを起動するインスタンス所有者のユーザー ID。各インスタンスには、一意のユーザー ID が必要です。データ形式と値のタイプ: 文字列 - スカラーメモ: この属性に不正な変更を加えると、DB2 が一貫性のない状態になる可能性があります。

必須属性

説明

DB2InstHome

DB2 インスタンスの設定ファイルと重要データが格納されている DB2 UDB インスタンスホームディレクトリへのパス。

データ形式と値のタイプ: 文字列 - スカラー

DB2InstOwner

DB2 UDB インスタンスを起動するインスタンス所有者のユーザー ID。各インスタンスには、一意のユーザー ID が必要です。

データ形式と値のタイプ: 文字列 - スカラー

メモ:

この属性に不正な変更を加えると、DB2 が一貫性のない状態になる可能性があります。

表: DB2 用エージェントのオプションの属性は DB2 用エージェントのオプションの属性を示します。

表: DB2 用エージェントのオプションの属性

オプションの属性	説明
データベース名（DatabaseName）	詳細監視用のデータベースの名前。詳細監視が有効な場合（IndepthMonitor = 1）に必要です。データベースのすべてのパーティションで障害が発生するのでデータベース名の属性を変更するときに注意します。無効か不正な値に DataBaseName の属性を変更しないでください。メモ: DatabaseName で指定されたデータベースが、Db2udb エージェントリソースが設定されたパーティションと同じパーティションに作成されていることを確認してください。データ形式と値のタイプ: 文字列 - スカラー
NodeNumber	データベースのノード番号またはパーティション番号。特定のデータベースのパーティションを監視した場合使われます。デフォルト: 0 データ形式と値のタイプ: 整数 - スカラー
StartUpOpt	起動オプションを提供します。許可される値は START、ACTIVATEDB、CUSTOM です。次のオプションを確認します。 START（デフォルト） DB2 インスタンスまたはパーティションを起動します。 ACTIVATEDB db2 プロセスの起動後にデータベースをアクティブにするコマンドを実行します。 CUSTOM エージェントは、StartUpOpt 属性が CUSTOM に設定されている場合、すべてのオンライン機能をユーザーに完全に任せます。 /opt/VRTSagents/ha/bin/Db2udb ディレクトリの start_custom_$db2instance_$nodenum というファイルを見つけます。このファイルが存在し、実行可能である場合、エージェントは代わりに、カスタマイズされたこのオンラインファイルを実行します。例: パーティションのオンライン機能か db2 インスタンス db2inst1 の nodenum 1 をカスタマイズするには、DB2 エージェントでこのカスタマイズされたファイル start_custom_db2inst1_1 を実行します。/opt/VRTSagents/ha/bin/Db2udb のディレクトリの下でこのファイルを実行します。データ形式と値のタイプ: 文字列 - スカラー
ShutDownOpt	この属性で許可される値は STOP と CUSTOM です。次のオプションを確認します。 STOP（デフォルト） DB2 インスタンスまたはパーティションを通常の方法でシャットダウンします。 CUSTOM ShutDownOpt 属性が CUSTOM に設定されている場合、すべてのオフライン処理をユーザーに完全に任せます。 /opt/VRTSagents/ha/bin/Db2udb ディレクトリの stop_custom_$db2instance_$nodenum というファイルを見つけます。このファイルが存在し、実行可能である場合、エージェントは代わりに、カスタマイズされたこのオフラインファイルを実行します。例: パーティションのオフライン機能か db2inst1 という db2 インスタンスの nodenum 0 をカスタマイズするとします。 DB2 エージェントでカスタマイズされたファイル: stop_custom_db2inst1_0 を実行します。このファイルは、/opt/VRTSagents/ha/bin/Db2udb ディレクトリにあります。データ形式と値のタイプ: 文字列 - スカラー
IndepthMonitor	詳細監視を有効にする場合は、IndepthMonitor 属性の値を 1 に設定します。現在、エージェントは、/opt/VRTSagents/ha/bin/Db2udb ディレクトリで monitor_custom_$db2instance_$nodenum ファイルを検索します。ファイルが存在し、実行可能な場合、エージェントはカスタマイズされたこの詳細監視ファイルを実行します。 sample_db2udb ディレクトリに、カスタム監視スクリプトの例があります。データ形式と値のタイプ: 文字列 - 整数
Encoding	DB2 UDB の出力表示で使うエンコードに対応する、オペレーティングシステムのエンコードを指定します。たとえば Solaris システムで、環境変数 LANG に「ja」を設定すると、「eucJP」が Encoding の Solaris 値になります。対応するエンコード値については、DB2 UDB と Solaris のマニュアルを参照してください。デフォルトは "" です。データ形式と値のタイプ: 文字列 - スカラー
AgentDebug	この属性の値が 1 のとき、エージェントで追加のデバッグメッセージがログに記録されます。データ形式と値のタイプ: ブール - スカラー
WarnOnlyIfDBQueryFailed	この属性では、SQL エラーをログに記録するか、特別な処理が必要なエラーを確認するかを指定します。 WarnOnlyIfDBQueryFailed 属性の値を 1 に設定すると有効になります。この属性が有効であるとき、すべての SQL エラーは無視され、1 日に 1 回警告メッセージがエージェントログに記録されます。 WarnOnlyIfDBQueryFailed 属性の値を 0 に設定すると無効になります。無効にすると、db2error.dat ファイルでエラーコードに対して特別な処理が必要かどうかが確認されます。 db2error.dat ファイル内にそのエラーコードが存在しない場合は、監視のために OFFLINE が返されます。そのエラーコードが存在する場合は、db2error.dat ファイルに記載されたそのエラーコードのアクションが実行されます。データ形式と値のタイプ: ブール - スカラー
UseDB2start	DB マネージャを起動するための代替方法を選択できます。エージェントは、UseDBStart が 1 に設定されている場合は db2start を実行しますが、UseDBStart が 0 に設定されている場合は db2gcf を使います。設定が非 MPP の場合、UseDB2start 属性の値を 1 に設定する必要があります。設定が MPP の場合、UseDB2start 属性の値を 0 に設定する必要があります。MPP の場合は、VCS は実際のホスト名を使い、各パーティションを開始、停止できる必要があります。このため、VCS は db2gcf コマンドを使い、UseDB2start 属性の値を 0 にする必要があります。データ形式と値のタイプ: ブール - スカラーデフォルト: 0 UseDB2start 属性の使用方法について詳しくは、VCS の DB2 の設定についてを参照してください。

表: DB2 用エージェントの内部属性は DB2 用エージェントのリソース属性を示します。

表: DB2 用エージェントのリソース属性

内部属性	説明
ContainerOpts	このエージェントはゾーンに対応しています。このタイプの ContainerOpts リソースタイプ属性では、RunInContainer のデフォルト値は 1、PassCInfo のデフォルト値は 0 です。これらの値は変更しないことをお勧めします。詳しくは『Veritas InfoScale 7.3.1 仮想化ガイド』を参照してください。

表: DB2 用エージェントの内部属性は DB2 のエージェントの内部属性を示します。

表: DB2 用エージェントの内部属性

内部属性	説明
AgentDirectory	エージェントに関連するその他のファイルとスクリプトの場所を示します。使用しないでください。内部使用の属性です。
IMF	このリソースタイプレベルの属性は、DB2 エージェントがインテリジェントなリソース監視を実行する必要があるかどうかを決定します。この属性は次のキーを含んでいます。 Mode: この属性を定義して、インテリジェントなリソースの監視を有効または無効にします。有効な値は次のとおりです: 0 - インテリジェントなリソースの監視を実行しない 1 - オフラインリソースについてはインテリジェントなリソースの監視を実行し、オンラインリソースについてはポーリングベースの監視を実行する 2 - オンラインリソースについてはインテリジェントなリソースの監視を実行し、オフラインリソースについてはポーリングベースの監視を実行する 3 - オンラインリソースとオフラインリソースの両方についてインテリジェントなリソースの監視を実行するデフォルト: 2 MonitorFreq: このキー値は、エージェントが監視エージェント関数を呼び出す頻度を指定します。このキーの値は整数です。デフォルト: 5 エージェントがポーリングベースの監視とインテリジェントなリソースの監視の両方を実行する必要がある場合は、このキーをゼロ以外の値に設定できます。値が 0 の場合、エージェントはポーリングベースのプロセスチェック監視を実行しません。リソースが AMF カーネルドライバに登録されると、エージェントは次のように監視エージェント関数を呼び出します。オンラインリソースの場合は（MonitorFreq x MonitorInterval）秒おきオフラインリソースの場合は（MonitorFreq x OfflineMonitorInterval）秒おき RegisterRetryLimit: インテリジェントなリソース監視を有効にすると、エージェントは imf_register エージェント関数を呼び出して、リソースを AMF カーネルドライバに登録します。RegisterRetryLimit キーの値によって、エージェントがリソースの登録を再試行する必要がある回数が決まります。エージェントが、指定された制限内にリソースを登録できない場合、リソースの状態が変化するか、Mode キーの値が変更されるまで、インテリジェントな監視は無効になります。デフォルト: 3. Db2udb リソースに対するインテリジェントなリソースの監視の有効化と無効化を参照してください。

内部属性

説明

AgentDirectory

エージェントに関連するその他のファイルとスクリプトの場所を示します。

使用しないでください。内部使用の属性です。

IMF

このリソースタイプレベルの属性は、DB2 エージェントがインテリジェントなリソース監視を実行する必要があるかどうかを決定します。

この属性は次のキーを含んでいます。

Mode: この属性を定義して、インテリジェントなリソースの監視を有効または無効にします。
有効な値は次のとおりです:
- 0 - インテリジェントなリソースの監視を実行しない
- 1 - オフラインリソースについてはインテリジェントなリソースの監視を実行し、オンラインリソースについてはポーリングベースの監視を実行する
- 2 - オンラインリソースについてはインテリジェントなリソースの監視を実行し、オフラインリソースについてはポーリングベースの監視を実行する
- 3 - オンラインリソースとオフラインリソースの両方についてインテリジェントなリソースの監視を実行する
デフォルト: 2
MonitorFreq: このキー値は、エージェントが監視エージェント関数を呼び出す頻度を指定します。このキーの値は整数です。
デフォルト: 5
エージェントがポーリングベースの監視とインテリジェントなリソースの監視の両方を実行する必要がある場合は、このキーをゼロ以外の値に設定できます。
値が 0 の場合、エージェントはポーリングベースのプロセスチェック監視を実行しません。リソースが AMF カーネルドライバに登録されると、エージェントは次のように監視エージェント関数を呼び出します。
- オンラインリソースの場合は（MonitorFreq x MonitorInterval）秒おき
- オフラインリソースの場合は（MonitorFreq x OfflineMonitorInterval）秒おき
RegisterRetryLimit: インテリジェントなリソース監視を有効にすると、エージェントは imf_register エージェント関数を呼び出して、リソースを AMF カーネルドライバに登録します。RegisterRetryLimit キーの値によって、エージェントがリソースの登録を再試行する必要がある回数が決まります。エージェントが、指定された制限内にリソースを登録できない場合、リソースの状態が変化するか、Mode キーの値が変更されるまで、インテリジェントな監視は無効になります。
デフォルト: 3.

Db2udb リソースに対するインテリジェントなリソースの監視の有効化と無効化を参照してください。