3.2.8 HAモニタ kitの設定
Oracleが使用する共有リソースの設定が完了したら,HAモニタ kitの設定をします。HAモニタ kitの設定には,サーバの起動・停止・監視コマンドの設定,および制御用定義ファイルの設定があります。
- 〈この項の構成〉
(1) サーバの起動・停止・監視コマンドの設定
HAモニタ kitでは,サーバの起動・停止・監視コマンドのサンプルファイルを提供しています。サーバの数だけ,これらのファイルを任意のディレクトリにコピーし,環境に合わせて設定します。HAモニタの環境設定用ディレクトリ(/opt/hitachi/HAmon/etc)下にコピーすることを推奨します。
HAモニタ kitが提供するサーバの起動・停止コマンドのサンプルファイルの格納ディレクトリを,次の表に示します。
コマンド |
格納ディレクトリ |
---|---|
サーバの起動コマンド |
/opt/hitachi/HAmonOra/lib/actcommand |
サーバの停止コマンド |
/opt/hitachi/HAmonOra/lib/termcommand |
HAモニタ kitが提供するサーバの監視コマンドのサンプルファイルの格納ディレクトリを,次の表に示します。格納ディレクトリはOracleのデータベース構成によって異なります。
- 注※
-
ORACLE_USER環境変数に指定するOracleユーザのユーザシェル環境がbash以外の場合は,必ず01-05以降で提供するpatrol.shを使用してください。
コピーしたファイルの名称は,コピー元のファイルと同一にする必要はありません。構築するサーバが複数存在し,単純にコピーするとファイル名が重複する場合は,コピー先のディレクトリを変更するか,重複しないようにファイル名を変更してください。
サーバの起動・停止・監視コマンド,およびサーバの監視コマンド実行シェルは,次の表に示すユーザで読み込みと実行を行います。アクセス権をサンプルファイルから変更する場合は,読み込みと実行を行うユーザにアクセス権を付与してください。アクセス権がない場合,各コマンドの実行に失敗します。
ファイル名 |
読み込みと実行を行うユーザ |
|
---|---|---|
サーバの起動コマンド |
スーパユーザ |
|
サーバの停止コマンド |
スーパユーザ |
|
HAモニタのサーバ対応の環境設定のptrlcmd_exオペランドでサーバの監視コマンドを指定する場合(推奨) |
サーバの監視コマンド |
スーパユーザ |
HAモニタのサーバ対応の環境設定のpatrolcommandオペランドでサーバの監視コマンド実行シェルを指定する場合 |
サーバの監視コマンド |
サーバの監視コマンド実行シェルのORACLE_USER環境変数に指定するOracleユーザ |
サーバの監視コマンド実行シェル |
スーパユーザ |
それぞれのコマンドの詳細な設定方法については,「4. サーバの起動・停止・監視コマンドの設定」を参照してください。
(2) 制御用定義ファイルの設定
HAモニタ kitが制御するOracleインスタンスまたはOracleリスナーごとに,制御用定義ファイルを設定する必要があります。HAモニタ kitが提供する制御用定義ファイルのサンプルファイルを,Oracleのデータベース構成に合わせてコピーしてリネームし,必要に応じて,ファイル内のパラメタの値の変更や,任意の環境変数の設定などを行ってください。また,監視するOracleインスタンスまたはOracleリスナーが複数存在する場合は,OracleインスタンスまたはOracleリスナーの数だけ制御用定義ファイルを設定してください。
制御用定義ファイルのコピー元ファイルとコピー先ディレクトリを,次の表に示します。
それぞれのファイルは,次のようにリネームしてください。ファイル名の太字の部分は,それぞれ該当する値に置き換えてください。
-
Oracleインスタンス制御用定義ファイル:インスタンス識別子.env
-
Oracleリスナー制御用定義ファイル:リスナー名.env
コピーする際は,コピー先の設定済みのファイルを誤って上書きして消去しないように注意してください。また,コピーしたファイルのアクセス権は,コピー元ファイルのアクセス権と同じにして,そのあとはアクセス権を変更しないでください。
以降,ファイルの詳細について説明します。
記述形式
パラメタを「パラメタ名=値」の形式で1行に一つずつ記述します。パラメタ,イコール(=),および値の前後に空白を記述しないでください。なお,パラメタの記述は順不同です。
任意の環境変数を設定したい場合は,「環境変数名=値」の形式で1行に一つずつ記述します。
パラメタの詳細
指定できるパラメタの詳細について,次に示します。
記述例
制御用定義ファイルの記述例を示します。この記述例は,サンプルファイルの内容と同様です。各パラメタは,実際の環境に合わせて設定してください。
- Oracleインスタンス制御用定義ファイル(/opt/hitachi/HAmon/etc/HAmonOra_etc/instance/orcl1.env)の場合
-
-
シングル構成
ORACLE_SID=orcl1 ORACLE_BASE=/home/oracle ORACLE_HOME=/home/oracle/product/18.0.0/dbhome_1 ORACLE_USER=oracle PATROL=120 ABORT_LIMIT=180
-
CDB(シングルテナント)構成
ORACLE_SID=orcl1 ORACLE_BASE=/home/oracle ORACLE_HOME=/home/oracle/product/18.0.0/dbhome_1 ORACLE_USER=oracle PATROL=120 ABORT_LIMIT=180 CDB=yes PDB_NAME=orcl_pdb
-
- Oracleリスナー制御用定義ファイル(/opt/hitachi/HAmon/etc/HAmonOra_etc/listener/LISTENER.env)の場合
LISTENER_NAME=LISTENER ORACLE_BASE=/home/oracle ORACLE_HOME=/home/oracle/product/18.0.0/dbhome_1 ORACLE_USER=oracle PATROL=120 ABORT_LIMIT=180
注意事項
-
OracleインスタンスまたはOracleリスナーの稼働中に,定義済みの制御用定義ファイルを変更しないでください。
-
定義の指定方法を誤ると,HAモニタ kitのコマンドが異常終了し,OracleインスタンスまたはOracleリスナーの制御に失敗します。この結果,サーバの起動や停止に失敗したり,OracleインスタンスまたはOracleリスナーの異常をHAモニタが検出したりします。