7.14.3 インストール情報設定ファイルの定義内容
インストール情報設定ファイルで定義する内容について,次に示します。
セクション[INSTALLATION_SETTINGS]
installhdlmユーティリティーの動作情報を定義します。このセクション名はインストール情報設定ファイルの先頭行に指定してください。ただし,セクション[INSTALLATION_SETTINGS]の前に空行またはコメント行が存在してもかまいません。
セクション[INSTALLATION_SETTINGS]で定義するキーの一覧を次の表に示します。
キー名※1 |
説明※2 |
定義の要否 |
指定できる長さ (文字) |
|
---|---|---|---|---|
新規インストール |
アップグレードインストールまたは再インストール |
|||
installfile_location |
DVD-ROM をマウントしたディレクトリーまたはDVD-ROM をコピーしたディレクトリーのどちらかの中で,DLManager.mpio.bffファイルがあるディレクトリーを絶対パス名称で指定します。 |
省略不可 |
省略不可 |
60 |
logdir |
ログ情報のファイルを出力するディレクトリーを,絶対パス名称で指定します。 デフォルトは「/var/tmp」です。ログファイルについては,「7.14.4 ログファイルについて」を参照してください。 |
省略可 |
省略可 |
60 |
licensekeyfile※3 |
ホストに格納されているライセンスキーファイル名を,絶対パス名称で指定します。指定したファイルはサイレントインストール後に削除されません。 デフォルトは「/var/tmp/hdlm_license」です。 なお,ライセンスを更新しないでアップグレードインストールまたは再インストールを行う場合は,licensekeyfileキーと設定値を削除してください。 |
省略可※4 |
省略可※4 |
60 |
licensekey※3 |
ホストに格納されているライセンスキーが記載されたファイルを,絶対パス名称で指定します。指定したファイルはサイレントインストール後に削除されません。 デフォルトは「/var/DLM/dlm.lic_key」です。 なお,ライセンスを更新しないでアップグレードインストールまたは再インストールを行う場合は,licensekeyキーと設定値を削除してください。 |
省略可※4 |
省略可※4 |
60 |
driver_config |
HDLMドライバーの構成を行うかどうかを,次の値で指定します。 y:HDLMドライバーを構成します(デフォルト)。 n:HDLMドライバーを構成しません。 なお,ブートディスク環境では,指定値に関わらず実行されません。 |
省略可 |
省略可 |
1 |
restart |
インストール終了後に,ホストの再起動を行うかどうかを,次の値で指定します。 y:再起動します。 n:再起動しません(デフォルト)。 |
省略可 |
省略可 |
1 |
- (凡例)
- 省略可:キーと設定値を指定しない場合,デフォルト値が適用されます。
ただし,アップグレードインストールまたは再インストールの場合,licensekeyfileキーとlicensekeyキーは以前のライセンス情報が引き継がれます。
- 省略不可:キーと設定値の指定は必須です。
- 注※1
キーと設定値は,1行につき1つの情報を記載してください。
- 注※2
定義できる内容以外を指定した場合は,エラーとなります。
- 注※3
licensekeyキーを指定する場合は,licensekeyfileキーを削除する必要があります。licensekeyfileキーを指定する場合は,licensekeyキーを削除する必要性はありません。
どちらにも値を指定しなかった場合は,次に示すファイルが順に読み込まれます。
ライセンスキーファイル(/var/tmp/hdlm_license)
ライセンスキーが記載されたファイル(/var/DLM/dlm.lic_key)
なお,新規インストールの場合でこれらのファイルが存在しないときは,サイレントインストールがエラー終了します。
- 注※4
HDLMを新規インストールする場合,またはライセンスの有効期限が過ぎている状態でアップグレードインストールする場合は,ライセンスキーまたはライセンスキーファイルを用意してください。
セクション[DISK_DEFAULT_SETTINGS]
HDLMデフォルト設定変更ユーティリティー(dlmchpdattr)の動作情報を定義します。このセクションは省略できます。セクション名を省略した場合,またはセクション内のキーを1つも定義しなかった場合は,dlmchpdattrユーティリティーによる設定は行われません。
dlmchpdattrユーティリティーについては,「7.3 dlmchpdattr HDLMデフォルト設定変更ユーティリティー」を参照してください。
セクション[DISK_DEFAULT_SETTINGS]で定義するキーの一覧を次の表に示します。
キー名※1 |
説明※2 |
定義の要否 |
指定できる長さ (文字) |
|
---|---|---|---|---|
新規インストール |
アップグレードインストールまたは再インストール |
|||
reserve_policy |
ディスクのリザーブポリシーを指定します。 no_reserve:リザーブの要求を無視し,LUをリザーブしません。 PR_exclusive:リザーブとしてパーシステントリザーブ(排他ホスト方式)を使用します(デフォルト)。 PR_shared:リザーブとしてパーシステントリザーブ(共用ホスト方式)を使用します。 |
省略可 |
省略可 |
12 |
- (凡例)
- 省略可:キーと設定値を指定しない場合,次の値が適用されます。
新規インストールの場合
デフォルト値が適用されます。
アップグレードインストールまたは再インストールの場合
以前の設定値が引き継がれます。
- 注※1
キーと設定値は,1行につき1つの情報を記載してください。
- 注※2
定義できる内容以外を指定した場合は,エラーとなります。
セクション[ODM_SETTINGS]
HDLM動作ODM設定ユーティリティー(dlmodmset)の動作情報を定義します。このセクションは省略できます。セクション名を省略した場合,またはセクション内のキーを1つも定義しなかった場合は,dlmodmsetユーティリティーによる設定は行われません。
dlmodmsetユーティリティーについては,「7.6 dlmodmset HDLM動作ODM設定ユーティリティー」を参照してください。
セクション[ODM_SETTINGS]で定義するキーの一覧を次の表に示します。
キー名※1 |
説明※2 |
定義の要否 |
指定できる長さ (文字) |
|
---|---|---|---|---|
新規インストール |
アップグレードインストールまたは再インストール |
|||
odm_lun_reset |
LUN RESETオプションを有効,または無効にするかを,次の値で指定します。 on:有効(デフォルト) off:無効 |
省略可 |
省略可 |
3 |
odm_online_e_io_block |
Online(E)状態のパスに対し,I/Oアクセスを抑止する機能を有効,または無効にするかを,次の値で指定します。 on:有効 off:無効(デフォルト) |
省略可 |
省略可 |
3 |
odm_npiv_option |
NPIV オプションを有効,または無効にするかを,次の値で指定します。 on:有効 off:無効(デフォルト) |
省略可 |
省略可 |
3 |
odm_os_error_log |
OSエラーログへHDLMのメッセージを出力するかどうかを,次の値で指定します。 on:出力する off:出力しない(デフォルト) |
省略可 |
省略可 |
3 |
- (凡例)
- 省略可:キーと設定値を指定しない場合,次の値が適用されます。
新規インストールの場合
デフォルト値が適用されます。
アップグレードインストールまたは再インストールの場合
以前の設定値が引き継がれます。
- 注※1
キーと設定値は,1行につき1つの情報を記載してください。
- 注※2
定義できる内容以外を指定した場合は,エラーとなります。
設定する機能の詳細については,「7.6 dlmodmset HDLM動作ODM設定ユーティリティー」を参照してください。
セクション[ENVIRONMENT_SETTINGS]
HDLMコマンドのsetオペレーションでの動作情報を定義します。このセクションは省略できます。セクション名を省略した場合,またはセクション内のキーを1つも記載しなかった場合は,HDLMコマンドのsetオペレーションによる設定は行われません。
setオペレーションについては,「6.6 set 動作環境を設定する」を参照してください。
セクション[ENVIRONMENT_SETTINGS]で定義するキーの一覧を次の表に示します。
キー名※1 |
説明※2 |
定義の要否 |
指定できる長さ (文字) |
|
---|---|---|---|---|
新規インストール |
アップグレードインストールまたは再インストール |
|||
load_balance |
ロードバランス機能を有効,または無効にするかを,次の値で指定します。 on:有効(デフォルト) off:無効 |
省略可 |
省略可 |
3 |
load_balance_type |
ロードバランスのアルゴリズムを,次の値で指定します。 rr:ラウンドロビン exrr:拡張ラウンドロビン lio:最少I/O数 exlio:拡張最少I/O数(デフォルト) lbk:最少ブロック数 exlbk:拡張最少ブロック数 |
省略可 |
省略可 |
5 |
load_balance_same_path_use_times |
ロードバランスのアルゴリズムに,ラウンドロビン(rr),最少I/O数(lio),または最少ブロック数(lbk)を適用する場合,I/Oに同一のパスを使用する回数を指定します。 回数は,「0~999999」の値を設定できます。デフォルトは「20」です。 |
省略可 |
省略可 |
6 |
lbex_usetimes_limit |
ロードバランスのアルゴリズムに,拡張ラウンドロビン(exrr),拡張最少I/O数(exlio),または拡張最少ブロック数(exlbk)を適用する場合,シーケンシャルI/Oに同一のパスを使用する回数を指定します。 回数は,「0~999999」の値を設定できます。デフォルトは「100」です。 「0」を指定した場合,無制限(パスを切り替えない)となります。 |
省略可 |
省略可 |
6 |
lbex_random_io_usetimes_limit |
ロードバランスのアルゴリズムに,拡張ラウンドロビン(exrr),拡張最少I/O数(exlio),または拡張最少ブロック数(exlbk)を適用する場合,ランダムI/Oに同一のパスを使用する回数を指定します。 回数は,「0~999999」の値を設定できます。デフォルトは「1」です。 「0」を指定した場合,無制限(パスを切り替えない)となります。 |
省略可 |
省略可 |
6 |
error_log_level |
障害ログとして採取する障害情報のレベルを設定します。 レベルは,「0~4」が設定できます。デフォルトは「3」です。 |
省略可 |
省略可 |
1 |
error_log_size |
障害ログファイル(dlmmgr[1-16].log)のサイズをKB単位で設定します。 サイズは,「100~2000000」の値を設定できます。デフォルトは「9900」です。 |
省略可 |
省略可 |
7 |
error_log_number |
障害ログファイル(dlmmgr[1-16].log)の数を設定します。 ファイル数は,「2~16」の値を設定できます。デフォルトは「2」です。 |
省略可 |
省略可 |
2 |
trace_level |
トレースの出力レベルを設定します。 レベルは,「0~4」が設定できます。デフォルトは「0」です。 |
省略可 |
省略可 |
1 |
trace_file_size |
トレースファイル(hdlmtr[1-64].log)のサイズをKB単位で設定します。 サイズは,「100~16000」の値を設定できます。デフォルトは「1000」です。 |
省略可 |
省略可 |
5 |
trace_file_number |
トレースファイル(hdlmtr[1-64].log)の数を設定します。 ファイル数は,「2~64」の値を設定できます。デフォルトは「4」です。 |
省略可 |
省略可 |
2 |
path_health_check |
パスヘルスチェック機能を有効,または無効にするかを,次の値で指定します。 on:有効(デフォルト) off:無効 |
省略可 |
省略可 |
3 |
path_health_check_interval |
パスヘルスチェックのチェック間隔を,分単位で指定します。 チェック間隔は,「1~1440」の値を設定できます。デフォルトは「30」です。 |
省略可 |
省略可 |
4 |
auto_failback |
障害パスの自動フェールバック機能を有効,または無効にするかを,次の値で指定します。 on:有効 off:無効(デフォルト) |
省略可 |
省略可 |
3 |
auto_failback_interval |
パスの状態確認の終了から,次回のパスの状態確認を開始するまでのチェック間隔を,分単位で指定します。 チェック間隔は,「1~1440」の値を設定できます。デフォルトは「60」です。 |
省略可 |
省略可 |
4 |
intermittent_error_monitor※3※4 |
間欠障害監視を有効,または無効にするかを,次の値で指定します。 on:有効 off:無効(デフォルト) |
省略可 |
省略可 |
3 |
intermittent_error_monitor_interval※4 |
間欠障害の監視時間を分単位で指定します。 チェック間隔は,「1~1440」の値を設定できます。デフォルトは「210」です。 |
省略可 |
省略可 |
4 |
intermittent_error_monitor_number※4 |
間欠障害と見なす障害の発生回数を指定します。 発生回数は,「1~99」の値を設定できます。デフォルトは「3」です。 |
省略可 |
省略可 |
2 |
- (凡例)
- 省略可:キーと設定値を指定しない場合,次の値が適用されます。
新規インストールの場合
デフォルト値が適用されます。
アップグレードインストールまたは再インストールの場合
以前の設定値が引き継がれます。
- 注
監査ログの設定は未サポートです。
- 注※1
キーと設定値は,1行につき1つの情報を記載してください。
- 注※2
定義できる内容以外を指定した場合は,エラーとなります。
設定する機能の詳細については,「6.6 set 動作環境を設定する」を参照してください。
- 注※3
次に示す場合だけ,キーを指定できます。
新規インストールの場合
インストール情報設定ファイルのauto_failbackキーに「on」を指定している。
アップグレードインストールまたは再インストールの場合
インストール情報設定ファイルのauto_failbackキーに「on」を指定しているか,またはインストール前の設定で,自動フェールバック機能を有効にしている。
- 注※4
間欠障害監視を有効にする場合は,auto_failbackキー,およびauto_failback_intervalキーのあとに指定してください。
インストール情報設定ファイルの編集例を,次に示します。
[INSTALLATION_SETTINGS] installfile_location=/dev/cd0 logdir=/var/tmp licensekeyfile=/var/tmp/hdlm_license licensekey=/var/DLM/dlm.lic_key driver_config=y restart=n [DISK_DEFAULT_SETTINGS] reserve_policy=PR_exclusive [ODM_SETTINGS] odm_lun_reset=on odm_online_e_io_block=off odm_npiv_option=off odm_os_error_log=off [ENVIRONMENT_SETTINGS] load_balance=on load_balance_type=exlio load_balance_same_path_use_times=20 lbex_usetimes_limit=100 lbex_random_io_usetimes_limit=1 error_log_level=3 error_log_size=9900 error_log_number=2 trace_level=0 trace_file_size=1000 trace_file_number=4 path_health_check=on path_health_check_interval=30 auto_failback=off # auto_failback_interval=60 # intermittent_error_monitor=off # intermittent_error_monitor_interval=210 # intermittent_error_monitor_number=3
- 注意事項
インストール情報設定ファイルで,行の先頭に「#」がある場合は,その行をコメント行と見なします。
キーを指定しない場合は,キーを定義している行の先頭に「#」を付けてください。