Hitachi

 Hitachi Dynamic Link Manager ユーザーズガイド（AIX用）

7.14.3　インストール情報設定ファイルの定義内容

インストール情報設定ファイルで定義する内容について，次に示します。

セクション[INSTALLATION_SETTINGS]

installhdlmユーティリティーの動作情報を定義します。このセクション名はインストール情報設定ファイルの先頭行に指定してください。ただし，セクション[INSTALLATION_SETTINGS]の前に空行またはコメント行が存在してもかまいません。

セクション[INSTALLATION_SETTINGS]で定義するキーの一覧を次の表に示します。

表7‒6　セクション[INSTALLATION_SETTINGS]のキー

キー名※1

説明※2

定義の要否

指定できる長さ

（文字）

新規インストール

アップグレードインストールまたは再インストール

installfile_location

DVD-ROMをマウントしたディレクトリーまたはDVD-ROMをコピーしたディレクトリーのどちらかの中で，DLManager.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

driver_migration

installhdlm開始時にHDLMデバイスが構成済みの場合，HDLMデバイスの構成情報と属性値を引き継ぐかどうかを，次の値で指定します。

y：引き継ぎます。

n：引き継ぎません（デフォルト）。

省略可

省略可

1

restart

インストール終了後に，ホストの再起動を行うかどうかを，次の値で指定します。

y：再起動します。

n：再起動しません（デフォルト）。

省略可

省略可

1
（凡例）
省略可：キーと設定値を指定しない場合，デフォルト値が適用されます。

ただし，アップグレードインストールまたは再インストールの場合，licensekeyfileキーとlicensekeyキーは以前のライセンス情報が引き継がれます。

省略不可：キーと設定値の指定は必須です。

注※1

キーと設定値は，1行につき1つの情報を記載してください。

注※2

定義できる内容以外を指定した場合は，エラーとなります。

注※3

licensekeyキーを指定する場合は，licensekeyfileキーを削除する必要があります。licensekeyfileキーを指定する場合は，licensekeyキーを削除する必要性はありません。

どちらにも値を指定しなかった場合は，次に示すファイルが順に読み込まれます。

  1. ライセンスキーファイル（/var/tmp/hdlm_license）

  2. ライセンスキーが記載されたファイル（/var/DLM/dlm.lic_key）

    なお，新規インストールの場合でこれらのファイルが存在しないときは，サイレントインストールがエラー終了します。

注※4

HDLMを新規インストールする場合，またはライセンスの有効期限が過ぎている状態でアップグレードインストールする場合は，ライセンスキーまたはライセンスキーファイルを用意してください。

セクション[ODM_SETTINGS]

HDLM動作ODM設定ユーティリティー（dlmodmset）の動作情報を定義します。このセクションは省略できます。セクション名を省略した場合，またはセクション内のキーを1つも定義しなかった場合は，dlmodmsetユーティリティーによる設定は行われません。

dlmodmsetユーティリティーについては，「7.10　dlmodmset HDLM動作ODM設定ユーティリティー」を参照してください。

セクション[ODM_SETTINGS]で定義するキーの一覧を次の表に示します。

表7‒7　セクション[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_inquiry_log

ログ取得を有効，または無効にするかを，次の値で指定します。

on：有効（デフォルト）

off：無効

省略可

省略可

3

odm_inquiry_log_size

ログファイルサイズをKBで指定します。

サイズは，「100～9900」の値を設定できます。デフォルトは「1000」です。

省略可

省略可

4

odm_hdisk_error_check_flag

hdiskを指定する操作に対するエラーチェック機能を有効，または無効にするかを，次の値で指定します。

on：有効（デフォルト）

off：無効

省略可

省略可

3

odm_hdlm_pbuf_count

HDLMで同時に発行できるI/Oの数を指定します。

I/Oの数は，「16384～1000000」の値を設定できます。デフォルトは「16384」です。

省略可

省略可

7

odm_hdlm_subclass

HDLMがODMに登録したuniquetypeのSubclass（HDLM Subclass）を設定します。

node：HDLM Subclassにnodeを設定します（デフォルト）。

fcp：HDLM Subclassにfcpまたはscsi を設定します。

省略可

省略可

4

odm_io_statistics

HDLMデバイスを入出力統計情報の出力対象に含むかを次の値で指定します。

on：有効

off：無効（デフォルト）

省略可

省略可

3

odm_npiv_option

NPIV オプションを有効，または無効にするかを，次の値で指定します。

on：有効

off：無効（デフォルト）

省略可

省略可

3

odm_os_error_log

OSエラーログへHDLMのメッセージを出力するかどうかを，次の値で指定します。

on：出力する

off：出力しない（デフォルト）

省略可

省略可

3

odm_reserve_lock_output

HDLMデバイスのlsattrコマンドの結果に，attribute=reserve_lockの情報を出力する，または出力しないを次の値で指定します。

on：出力する（デフォルト）

off：出力しない

省略可

省略可

3
（凡例）

省略可：キーと設定値を指定しない場合，次の値が適用されます。

  • 新規インストールの場合

    デフォルト値が適用されます。

  • アップグレードインストールまたは再インストールの場合

    以前の設定値が引き継がれます。

注※1

キーと設定値は，1行につき1つの情報を記載してください。

注※2

定義できる内容以外を指定した場合は，エラーとなります。

設定する機能の詳細については，「7.10　dlmodmset HDLM動作ODM設定ユーティリティー」を参照してください。

注意事項

dlmodmsetユーティリティーの機能であるunique_id方式の使用可否は設定できません。unique_id方式の使用可否を設定する場合は，HDLMのサイレントインストールが終了したあとに，dlmodmsetユーティリティーを実行して設定してください。

セクション[ENVIRONMENT_SETTINGS]

HDLMコマンドのsetオペレーションでの動作情報を定義します。このセクションは省略できます。セクション名を省略した場合，またはセクション内のキーを1つも記載しなかった場合は，HDLMコマンドのsetオペレーションによる設定は行われません。

setオペレーションについては，「6.6　set 動作環境を設定する」を参照してください。

セクション[ENVIRONMENT_SETTINGS]で定義するキーの一覧を次の表に示します。

表7‒8　セクション[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

reserve_level

ディスクに対するリザーブレベルを設定します。

0：リザーブ無視

2：パーシステントリザーブ（デフォルト）

省略可

省略可

1
（凡例）

省略可：キーと設定値を指定しない場合，次の値が適用されます。

  • 新規インストールの場合

    デフォルト値が適用されます。

  • アップグレードインストールまたは再インストールの場合

    以前の設定値が引き継がれます。

注

監査ログの設定は未サポートです。

注※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
 driver_migration=n
 restart=n
[ODM_SETTINGS]
 odm_lun_reset=on
 odm_online_e_io_block=off
 odm_inquiry_log=on
 odm_inquiry_log_size=1000
 odm_hdisk_error_check_flag=on
 odm_hdlm_pbuf_count=16384
 odm_hdlm_subclass=node
 odm_io_statistics=off
 odm_npiv_option=off
 odm_os_error_log=off
 odm_reserve_lock_output=on
[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
 reserve_level=2
注意事項

  • インストール情報設定ファイルで，行の先頭に「#」がある場合は，その行をコメント行と見なします。

  • キーを指定しない場合は，キーを定義している行の先頭に「#」を付けてください。

ページの先頭へ

All Rights Reserved. Copyright © 2014, 2024, Hitachi, Ltd.