hb-diskd - Linux-HA Japan Wiki - Linux-HA Japan

ディスク監視デーモン (hb-diskd)

このプログラムはディスクの状態を監視するものです。pingdによるネットワーク監視の方式をディスク監視に応用しています。
バージョン 1.10-1 からは、rpmによるインストールが可能になっています。
作成、テストはHeartbeat-2.1.4 で行っています。問題があれば [e-mail] にご報告ください。

このリリースのファイルを表示

diskdは一定間隔で指定されたディスクにアクセスすることによりディスクの正常性を監視しています。
以下の2種類のディスクアクセス方法があり、オプションによって指定可能です。

• readによる監視 : 指定されたデバイスに対して、read()関数を用いて読み込みを行い、ディスクの正常性を確認します。
• writeによる監視 : 指定されたデバイスに対して、write()関数を用いて書き出しを行い、ディスクの正常性を確認します。

diskdは複数のインスタンスを起動することができます。監視対象ディスクが複数ある場合には複数起動するように指定してください。 詳細はオプション、使用方法を参照してください。
以下に、インストール、使用方法を記述します。ここでの記述は64bit環境のものです。32bit環境ではインストールされるディレクトリが異なりますので、環境に合わせて読み替えてください。

1. インストール

1.1. rpmパッケージからのインストール

本ツールのパッケージ hb-diskd-1.10-1.hb214.x86_64.rpm をダウンロードします。その後、以下のようにrpmコマンドを使ってインストールします。

# rpm -ivh hb-diskd-1.10-1.hb214.x86_64.rpm
Preparing...                ########################################### [100%]
   1: hb-diskd              ########################################### [100%]

2. 起動オプション

diskdを起動する際に指定できるオプションを以下に示します。

• 基本オプション
  • -N <device_name> :読み取りによるディスク正常性チェック時にアクセスするデバイス名。必須項目。^※1
  • -w ファイル書き込みによるディスク正常性チェックを有効にするオプション。必須項目。^※1
  • -d <directory_name> :書き込み用ファイルを作成するディレクトリ名。デフォルト:/tmp^※2
  • -i <intarval>:ディスクアクセスする間隔。デフォルト:30秒　指定可能範囲:1～3600秒
  • -D デーモン化の指定
  • -a <attribute>:status内の属性名。デフォルト:diskd
• 詳細設定オプション
  • -t <timeout>:タイムアウト タイムアウトの値を設定する。指定範囲は1〜3600秒デフォルトは30秒。なお、本オプションは正常性確認で用いているread()/write()システムコールがEAGEINでエラーとなった場合に、再度read()/write()処理を行うまでの最大待ち時間である。
  • -r <retry>:ディスク確認失敗時の内部のリトライ回数。デフォルト:1回　指定可能範囲:0～10 retry=2とすると、最大3回の確認を行うことになる。
  • -I <retry_interval>:リトライする場合のリトライ間隔。デフォルト:5秒 指定可能範囲:1～3600秒
• ※1．"-w"と"-N"オプションは同時指定不可
• ※2．"-N"オプションと同時指定時は無効

3. 使用方法

diskdを使って、ディスクの正常性の監視および、監視結果によりリソースの配置を制御するためにはha.cfとcib.xmlへの設定が必要となります。

• ha.cfへの設定追加
  Heartbeatの起動時にdiskdを起動するように設定を追加します。監視方法(read/write)、監視間隔等はオプションとして指定します。

  例1) readによる監視 : "-N"オプション指定時
  respawn root /usr/lib64/heartbeat/diskd -N /dev/sdc -a diskcheck_status -i 10
  例2) writeによる監視 :"-w"オプション指定時
  respawn root /usr/lib64/heartbeat/diskd -w -a diskcheck_status -i 10
  例3) writeによる監視 : "-w"と"-d"オプション指定時
  respawn root /usr/lib64/heartbeat/diskd -w -d /tmp/diskd -a diskcheck_status -i 10
  

• cib.xmlへの設定追加
  ha.cf記述内の-a オプションで指定した値に対しての制約(constraints)を記述します。
  diskdは監視対象ディスクに不具合を検知した場合、-a オプションで指定した属性の値を"ERROR"に変更します(不具合がない状況での値は"normal")。
  属性の値が"ERROR"に変更された場合にリソースをどのように動作させるかのルールを記述します。
  以下の記述例では、故障が検知され属性diskcheck_statusが"ERROR"に変更された場合にはリソース:grp_pgsqlを故障が検知されたノードでは動作させないという制約の記述を行っています。

    (..略..)
  <constraints>
    (..略..)
     <rsc_location id="rul_DK_dsc" rsc="grp_pgsql">
        <rule id="prefered_rul_DK_dsc" score="-INFINITY" boolean_op="and">
            <expression attribute="diskcheck_status" id="dkstatus1" operation="defined"/>
            <expression attribute="diskcheck_status" id="dkstatus2" operation="eq" value="ERROR"/>
        </rule>
      </rsc_location>
    (..略..)
  </constraints> 
  

設定例

図1の場合(共有ディスクをreadによる監視、ローカルディスクをwriteによる監視を実施)の設定例を以下に示します。

• ha.cf

    (..略..)
    respawn root /usr/lib64/heartbeat/diskd -N /dev/sdc -a diskcheck_status -i 10
    respawn root /usr/lib64/heartbeat/diskd -w -a diskcheck_status_internal -i 10
  

• cib.xml

  <constraints>
    (..略..)
     <rsc_location id="rul_DK_shard" rsc="grp_pgsql">
        <rule id="prefered_rul_DK_shard" score="-INFINITY" boolean_op="and">
            <expression attribute="diskcheck_status" id="dkstatus1" operation="defined"/>
            <expression attribute="diskcheck_status" id="dkstatus2" operation="eq" value="ERROR"/>
        </rule>
      </rsc_location>
      <rsc_location id="rul_DK_internal" rsc="grp_pgsql">
        <rule id="prefered_rul_DK_internal" score="-INFINITY" boolean_op="and">
            <expression attribute="diskcheck_status_internal" id="dkstatus_internal1" operation="defined"/>
            <expression attribute="diskcheck_status_internal" id="dkstatus_internal2" operation="eq" value="ERROR"/>
        </rule>
      </rsc_location>
    (..略..)
  </constraints> 
  

注意事項

• readによる監視における監視先指定方法に関する注意
  
  • 監視先のデバイス名はディスクのデバイス名指定(例: /dev/sdc)でもパーティション指定(例: /dev/sdc2)でも設定可能ですが、通常はディスクのデバイス名指定で問題ありません。
  • 同一物理ディスク上にある複数のパーティションに対して個別のdiskd監視設定を行っても、故障検知できる範囲はほとんど変わらないため意味はありません。

• writeによる監視に関する注意
  • writeによる監視で書き出し先として用いるのはファイルであるため、diskdを起動する前に監視先ファイルに正しくアクセスできる必要があります。
  • Filesysem RAを使い、Active/Standbyのノード間でマウントを制御する共有ディスクをdiskdのwriteによる監視の監視対象とした場合、diskd起動時にはFilesystem RAによるマウント処理が行われていないため、diskdでは正しく監視できません(図2参照)
  • writeによる監視はローカルディスクに対する監視とすることをお勧めします。
    

4. エラーコード

レベル	出力内容	意味	出力関数
err	Could not send update	更新をattrdに送信できなかった。	send_update
err	permission denied. diskd shuld be execute by root.	rootで本プログラムが実行されていない	main
err	Argument code 0<arg> (<arg>) is not (?yet?) supported	実装されていないコマンドライン引数が指定された	main
err	non-option ARGV-elements: <arg>	必要なオプションが指定されていない	main
err	attrd registration failed	attrdに登録できなかった	main
err	Could not allocate memory	メモリの確保ができなかった	main
err	Could not open <filename>	書き込み用ファイルがオープンできない	diskcheck_wt
err	select failed on file <filename>	select関数でfdを監視していたが、エラーとなった	diskcheck_wt
err	select time out on file <filename>	select関数でfdを監視していたがタイムアウトとなった	diskcheck_wt
err	Could not write to file <filename>	write関数で書き込みに失敗した	diskcheck_wt
err	Could not open device <devicename>	指定されたデバイスがオープンできない	diskcheck
err	ioctl error, Could not flush buffer	ioctlにてバッファをフラッシュしようとしたが失敗した	diskcheck
err	Could not read from device <devicename>	read関数で読み込みに失敗した。	diskcheck
err	select failed on device <devicename>	select関数でfdを監視していたが、エラーとなった	diskcheck
err	select timeout on device <devicename>	select関数でfdを監視していたがタイムアウトとなった	diskcheck
warn	failed to remove file <filename>	書き込み用ファイルの削除に失敗した	diskcheck_wt
warn	write function return errno:EAGAIN	write関数にて書き込みを行ったがEAGAINが返却された	diskcheck_wt
warn	select ok, write again	select関数で監視していたfdが書き込み可能となった	diskcheck_wt
warn	Error(s) occurred in diskcheck function.	diskcheck関数でなんらかのエラーが検出された	diskcheck
warn	read function return errno:EAGAIN	read関数にて読み込みを行ったがEAGAINが返却された	diskcheck
warn	non-defined status, new_status = <num>	規程されていないstatusが指定された	check_old_status
warn	disk status is changed, new_status = <STATUS>	ディスクの状態が変わった時。normal->ERROR / ERROR->normal	check_old_status
info	Exiting	本関数がコールされ、プログラムが終了段階にあることをログ出力する	diskd_shutdown
info	Starting <system_name>	diskdを開始し、mainloopに入る	main
info	Exiting <system_name>	diskdを終了する	main
debug	attrd registration attempt: <times>	attrdに登録を試みている。回数を含めて表示	main
debug2	diskcheck_wt start	書き込み用ディスクチェック関数が開始されたことを示すデバッグログ	diskcheck_wt
debug2	data writing is OK	書き込み用ディスクチェック関数により、ディスクの正常状態が確認されたことを示すデバッグログ	diskcheck_wt
debug2	Diskcheck function start	ディスクチェック関数が開始されたことを示すデバッグログ	diskcheck
debug2	Reading form data is OK	ディスクの正常状態が確認されたことを示すデバッグログ	diskcheck