定義ファイル（servers）では，サーバごとの環境設定を定義します。HA Toolkit Exで監視するすべてのサーバをこの定義ファイル（servers）で定義します。

サーバ対応の環境設定を設定する定義ファイル（servers）の形式を次に示します。

server  name          "サーバのホームディレクトリ名"
　　　　　　　　　　　 またはHiRDB識別子/ユニット識別子
        ,alias         サーバ識別名
       [,actcommand    "サーバ起動コマンドの完全パス名"]
       [,termcommand   "サーバ停止コマンドの完全パス名"]
        ,patrol         サーバ障害監視時間
       [,actpatrol    ｛サーバ起動監視時間｜60｝]
       [,termpatrol   ｛サーバ停止監視時間｜180｝]
       [,switchtype   ｛switch｜manual｜restart[:サーバ再起動監視時間]｝]
       [,switch_nosby ｛act｜actfail｝]
       [,onl_timming  ｛actend｜act｝]
;

サーバの定義をします。server定義文のオペランドを，次に示します。

• nameオペランド　〜<1〜1000文字のパス名>
  サーバを特定するために，サーバのホームディレクトリ名を"　"で囲んで指定します。OpenTP1の場合は環境変数%DCDIR%，HiRDBの場合は環境変数%PDDIR%を指定します。
  

  HiRDBのスタンバイレス型系切り替えの場合

  HiRDBのHiRDB識別子とユニット識別子を，"/"で組み合わせて指定します。

• aliasオペランド　〜<1〜8文字の英数字>
  HA Toolkit Ex内でサーバを識別するためのサーバ識別名を指定します。MSCSのサーバに対応するリソース名称およびグループ名称と同値にすることを推奨します。
  
• actcommandオペランド　〜<1〜1000文字のパス名>
  サーバの起動コマンドを完全パス名で"　"で囲んで指定します。
  ここで指定するサーバの起動コマンドは，MSCSを使用してサーバをオンラインにしたときに，自動で実行されます。
  actcommandオペランドを省略した場合，サーバの起動コマンドは実行されません。MSCSからのオンライン操作の延長では，サーバが自動起動されないので，オペレーターがサーバの起動コマンドを実行する必要があります。
  サーバの起動コマンドの設定については，「8.2.4　サーバの起動コマンドの設定」を参照してください。
  

  任意のタイミングでサーバを起動したい場合

  任意のタイミングでサーバを起動したい場合，actcommandオペランドを省略しておくと，オペレーターが任意のタイミングでサーバの起動コマンドを実行できます。ただし，待機サーバが起動していない状態で系切り替えが発生した場合も，実行サーバは自動起動されませんので注意してください。系切り替えが発生した場合，オペレーターは，サーバの起動コマンドを実行して実行サーバを起動してください。

  HiRDBの影響分散スタンバイレス型系切り替えの場合

  actcommandオペランドは指定しないでください。

• termcommandオペランド　〜<1〜1000文字のパス名>
  サーバの強制停止コマンドを完全パス名で指定します。正常停止コマンドを指定した場合，正しく系切り替えできません。
  ここで指定するサーバの停止コマンドは，MSCSを使用してサーバをオフラインにしたときに，自動的に実行されます。
  サーバの停止コマンドの設定については，「8.2.5　サーバの停止コマンドの設定」を参照してください。
  

  任意のタイミングでサーバを停止したい場合

  任意のタイミングでサーバを停止するには，環境設定でtermcommandオペランドを省略しておき，オペレーターが任意のタイミングでサーバの停止コマンドを実行します。ただし，MSCSでのオフライン操作，移動操作などのオフラインするタイミングごとに，オペレーターがサーバを停止する必要があります。

• patrolオペランド　〜<符号なし整数>　((10〜600))　（単位：秒）
  スローダウンなどのサーバ障害の監視時間を秒単位で指定します。
  
• actpatrolオペランド　〜<符号なし整数>　((0〜600))　《60》　（単位：秒）
  MSCSでのオンライン操作やサーバの起動コマンドを実行した時点から，サーバが起動完了するまでの監視時間を，秒単位で指定します。指定した監視時間を過ぎてもサーバが起動完了しない場合は，起動失敗と判断します。0秒を指定した場合は（MSCSの待ちのタイムアウト値-9）秒を，オペランドを省略した場合は60秒を仮定します。なお，MSCSのタイムアウト検知よりも早く起動失敗を判断するために，実際のタイマ監視時間は，actpatrol値と（MSCSの待ちのタイムアウト値-9）のどちらか小さい方となります。
  

  HiRDBの1:1スタンバイレス型系切り替えの場合

  actpatrolオペランドには0秒を指定してください。

• termpatrolオペランド　〜<符号なし整数>　((0〜600))　《180》　（単位：秒）
  MSCSからのオフライン操作，サーバの停止コマンドの実行またはHA Toolkit Ex本体の停止をした時点から，サーバが停止完了するまでの監視時間を，秒単位で指定します。0秒を指定するとサーバの停止を監視しません。指定した監視時間を過ぎてもサーバが停止完了しない場合は，サーバを強制停止します。
  termpatrolオペランドを省略した場合は，180秒を仮定します。
  
• switchtypeオペランド　〜《switch》
  サーバの障害を検知した場合のHA Toolkit Exの動作を指定します。すべての系で同じ指定にしてください。
  

  HiRDBのスタンバイレス型系切り替えの場合

  switchtypeオペランドは指定しないことを推奨します。

  switchtypeオペランドは，サーバの開始形態によって指定できる値が異なります。サーバの開始形態とswitchtypeオペランドで指定できる値を次に示します。
  

  表8-2　サーバの開始形態とswitchtypeオペランドで指定できる値（Windows）

  switchtypeオペランドで指定できる値	サーバの開始形態
  	AUTO	MANUAL1	MANUAL2
  switch	×	×	○
  manual	×	○	×
  restart	×	○	×

  （凡例）○：指定できる　　×：指定できない

  
  サーバの開始形態については，マニュアル「OpenTP1 システム定義」およびマニュアル「HiRDB システム定義（Windows(R)用）」を参照してください。なお，サーバがOpenTP1の場合は，サーバの開始形態にAUTOしか指定できません。
  switchtypeオペランドで指定できる値について説明します。
  
  • switch
    サーバを停止して，系切り替えをします。
    
  • manual
    サーバを再起動待ち状態にして，サーバが自動で再起動するのを待ちます。系切り替えはしません。
    サーバの再起動が失敗した場合は，サーバ自身で再起動を再試行します。サーバで定義されているサーバの再起動試行回数を超えると，サーバを停止して，オペレーターの操作を待ちます。
    manualを指定したサーバでスローダウンを検知した場合，HA Toolkit Exは何もしないでサーバの監視を続けます。
    
  • restart　[:サーバ再起動監視時間]〜<符号なし整数>((60〜3600))　（単位：秒）
    サーバを再起動待ち状態にして，サーバが自動で再起動するのを待ちます。
    サーバの再起動が失敗した場合は，サーバ自身で再起動を再試行します。サーバで定義されているサーバの再起動試行回数を超えた場合またはサーバ再起動監視時間を超えてもサーバが再起動しない場合は，系切り替えをします。
    restartを指定した場合は，「:」で区切ってサーバの再起動監視時間を指定できます。再起動監視時間には，60秒から3,600秒の範囲で指定します。サーバの再起動監視時間を超えてもサーバが再起動しない場合は，系切り替えをします。サーバの再起動監視時間を省略した場合は，サーバが再起動するまでの時間を監視しません。
    
• switch_nosbyオペランド　〜《act》
  待機サーバが起動していない系で，系切り替えのときは系切り替えを続行するかどうかを，MSCSからサーバのグループのオンライン操作をするときはオンライン操作を続行するかどうかを，switch_nosbyオペランドで指定します。
  switch_nosbyオペランドで指定できる値について説明します。
  
  • act
    系切り替え時，切り替え先の系で待機サーバが起動していない場合に，actcommandオペランドに指定されたコマンドを実行して，実行サーバとして起動処理を続行します。actcommandオペランドが指定されていない場合は，実行サーバの起動を待ちます。
    
  • actfail
    系切り替え時，切り替え先の系で待機サーバが起動していない場合に，起動失敗とします。actfailを指定した場合，待機サーバがない系でMSCSからオンラインにしたいときは，事前に待機サーバがない系でhateactonl -eコマンドを実行し，実行サーバの起動を許可しておく必要があります。
    

  HiRDBの影響分散スタンバイレス型系切り替えの場合

  actfailを指定してください。actfailを指定しないで，影響分散スタンバイレス型系切り替えをすると，切り替え先の系で待機サーバが起動していない場合に，MSCSのタイムアウト検知まで待ってから系切り替えをします。

• onl_timmingオペランド　〜《actend》
  MSCSがオンライン化の完了を認識するタイミングを指定します。HiRDBの影響分散スタンバイレス型系切り替えの場合だけ，onl_timmingオペランドを指定してください。
  onl_timmingオペランドで指定できる値について説明します。
  
  • actend
    実行サーバが起動完了した時点で，オンライン化が完了したとしてMSCSに通知します。
    
  • act
    実行サーバの起動完了前に，オンライン化が完了したとしてMSCSに通知します。通知するのは，HA Toolkit Exのサービスプロセスが起動して実行サーバを起動する準備ができた時点です。
    actが指定された場合，actpatrolオペランドで指定した間隔ごとに警告メッセージ（KAME475-W）を出力し，サーバの起動を促します。起動タイムアウトにはなりません。
    

  HiRDBの影響分散スタンバイレス型系切り替えの場合

  自動起動運用を設定したときは，actを指定してください。自動起動運用を設定しないで，独自の運用を設定するとき，または手動で運用するときは，onl_timmingオペランドの指定は必須ではありません。