Cluster Server 7.3.1 管理者ガイド - Linux

ActiveCount

(システムのみ使用)

AdministratorGroups

(ユーザー定義)

サービスグループに管理者権限を持つオペレーティングシステムのユーザーアカウントグループのリストです。

Administrators

(ユーザー定義)

このサービスグループの管理権限を持つ VCS ユーザーのリストです。

Authority

(ユーザー定義)

ローカルクラスタがサービスグループをオンラインにできるかどうかを示します。 0 を設定した場合、オンラインにすることはできません。1 を設定した場合、オンラインにすることが可能です。 グローバルサービスグループについて、この属性に 1 を設定できるのは、1 クラスタだけです。

AutoClearCount

(システムのみ使用)

障害が発生し、フェールオーバー対象が存在しないサービスグループの状態を消去する VCS エンジンの試行回数を示します。この属性は、サービスグループに AutoClearLimit 属性を設定する場合にのみ使います。

AutoClearInterval

(ユーザー定義)

障害が発生し、フェールオーバー対象が存在しないサービスグループを自動的に消去した後の間隔 (秒) を示します。サービスグループの状態は、AutoClearLimit をゼロ以外の値に設定した場合にのみ消去されます。

デフォルト: 0

AutoclearLimit

(ユーザー定義)

サービスグループの障害状態を消去する試行回数を定義します。ゼロに設定すると自動消去機能が無効になります。

AutoDisabled

(システムのみ使用)

VCS がサービスグループ（またはパラレルサービスグループがオンラインとなる予定のシステム）の状態を認識していないことを示します。 SystemList 属性で定義されたシステム（パラレルグループの場合は、パラレルグループがオンラインとなる予定のシステム）でグループのプローブが完了していないため、この状態が起きることがあります。 または、VCS エンジンが SystemList 属性で指定されたノード上で起動していないが、ノードが表示できます。

VCS がノード上でサービスグループの状態を認識していない場合に、サービスグループが有効であることを VCS に認識させるには、次のコマンドを実行して AutoDisabled の値を 0 に変更します。

hagrp -autoenable grp -sys sys1

AutoFailOver

(ユーザー定義)

サービスグループに障害が発生した場合、VCS が自動的にフェールオーバーを開始するかどうかを指定します。

属性は次の値をとることができます。

AutoRestart

(ユーザー定義)

障害の発生した永続的リソースがオンラインとなった後にサービスグループを再起動するかどうかを指定します。

属性は次の値をとることができます。

AutoStart

(ユーザー定義)

AutoStartIfPartial

(ユーザー定義)

AutoStartList

(ユーザー定義)

特定の状況（通常はシステム起動時）下で、VCS が起動したときに、サービスグループを自動的にオンラインにするシステムを定義します。 たとえば、この属性に定義されているシステムで VCS を起動したときに、フェールオーバーサービスグループの AutoStart 属性に定義されている他のシステム上で、いまだサービスグループがオンラインになっていない場合、自動的にこのシステムでサービスグループをオンラインにします。

VCS は AutoStartPolicy 属性を使って、サービスグループをオンラインにするシステムを決定します。

AutoStartPolicy

(ユーザー定義)

複数のシステムが利用可能な場合に、どのシステム上で AutoStart の動作中にサービスグループをオンラインにするかを決定するポリシーを設定します。

この属性に定義できるのは、次の 3 種のいずれかです。

Order（デフォルト） - システムは、AutoStartList 属性で定義された順に選択されます。

Load - システムは、システム属性の AvailableCapacity で示されたシステムの処理能力によって、選択されます。 処理能力が最も高いシステムから順に選択されます。

CapacityReserved

(システムのみ使用)

サービスグループをオンラインに切り替えるか、フェールオーバーするための容量が予約されているかどうかを示します。サービスグループの属性の FailOverPolicy を BiggestAvailable に設定している場合のみ容量が予約されます。

この属性はローカライズされています。

可能な値は次のとおりです。

1: 容量は予約されます。

0: 容量は予約されません。

この値は、hagrp -flush コマンドを使用してリセットすることができます。

この属性を一覧表示するには、hagrp -display コマンドに -all オプションを合わせて使います。

ClusterFailOverPolicy

(ユーザー定義)

クラスタまたはグローバルグループで障害が発生したときのグローバルサービスグループの動作を決定します。属性は次の値をとることができます。

Manual - サービスグループを別のクラスタに自動的にフェールオーバーしません。

Auto - ローカルクラスタ内にサービスグループをフェールオーバー可能なノードがないか、そのクラスタ全体に障害が発生した場合に、サービスグループを別のクラスタに自動的にフェールオーバーします。

ClusterList

(ユーザー定義)

ContainerInfo

(ユーザー定義)

次のように属性の範囲をローカルからグローバルに変更できます。

# hagrp -local <service_group_name> <attribute_name>

次のように属性の範囲をグローバルからローカルに変更できます。

# hagrp -global <service_group_name> <attribute_name>
<value> ... | <key> ... | {<key> <value>} ...

-local オプションと -global オプションについて詳しくは、hagrp コマンドに関連するマニュアルページを参照してください。

CurrentCount

(システムのみ使用)

DisableFaultMessages

(ユーザー定義)

VCS エンジンのログファイルに記録されたグループとそのリソースの障害やフェールオーバーのメッセージを非表示にします。この属性は、ログファイルに記録されている情報メッセージは非表示にしません。

DeferAutoStart

(システムのみ使用)

Enabled

(ユーザー定義)

サービスグループをフェールオーバーまたはオンラインにできるようになります。

Evacuate

(ユーザー定義)

Evacuating

(システムのみ使用)

EvacList

(システムのみ使用)

優先度の低いサービスグループとそれらのサービスグループが排除されるシステムのペアのリストを含みます。

次に例を示します。

Grp1 EvacList  grp2 Sys0  grp3 Sys0  grp4 Sys4

データ形式と値のタイプ: 文字列 - 関連

デフォルト: 適用不可能

EvacuatingForGroup

(システムのみ使用)

排除が進行中の高優先度サービスグループの名前を表示します。サービスグループ名は排除の進行中にのみ表示されます。

データ形式と値のタイプ: 文字列 - スカラー

デフォルト: 適用不可能

フェールオーバー

(システムのみ使用)

FailOverPolicy

(ユーザー定義)

グループのフェールオーバー先のシステムを決定するために、VCS によって使われるフェールオーバーポリシーを定義します。 また、手動での操作時に、どのシステム上でサービスグループをオンラインにするかを決定するために使うこともできます。

このポリシーは、複数のシステムがあるクラスタ用にのみ定義されます。

Priority - SystemList 属性で優先度が最も高い、すなわち設定された値が小さいシステムが選択されます。

Load - AvailableCapacity 値の最も高いシステムが選択されます。

RoundRobin - ホストしているオンラインのサービスグループに基づいてシステムが選択されます。オンラインとなっているサービスグループが最も少ないシステムから選択されます。

BiggestAvailable - SystemList 内のすべてのシステムに対して予測された利用可能容量に基づいてシステムが選択されます。 予測された利用可能容量が最も多いシステムが選択されます。

FaultPropagation

(ユーザー定義)

VCS が、リソースに障害が発生した場合に親リソースにも障害を伝播してサービスグループ全体をオフラインにするかどうかを指定します。

FromQ

(システムのみ使用)

Frozen

(システムのみ使用)

GroupOwner

(ユーザー定義)

この属性は、VCS の電子メール通知機能とログ機能に使います。 VCS は、サービスグループに関連するイベントが発生すると、この属性で指定された担当者に電子メールで通知します。 VCS はほとんどのイベントをログに記録しますが、すべてのイベントが通知をトリガするとは限らないことに注意してください。

GroupOwner に、または NotifierMngr エージェントの SmtpRecipients 属性で定義されている 1 人以上の受信者に通知を送信するときの、重要度レベルを必ず設定してください。

GroupRecipients

(ユーザー定義)

この属性は VCS の電子メール通知に使われます。 VCS は、サービスグループに関連するイベントが起きたときと、イベントの重要度レベルが属性で指定されているレベル以上のときに、この属性で指定されているユーザーに電子メール通知を送信します。

GroupRecipients に、または NotifierMngr エージェントの SmtpRecipients 属性で定義されている 1 人以上の受信者に通知を送信するかどうかを決める重要度レベルを必ず設定してください。

Guests

(ユーザー定義)

サービスグループに Guest 権限を持つオペレーティングシステムのユーザーアカウントのリストです。

IntentOnline

(システムのみ使用)

サービスグループがその時点でオンラインとなっているべきか、または、オフラインとなっているべきかを定義します。

VCS は、サービスグループのオンライン化を試みた場合は、この属性を 1 に設定します。

フェールオーバーグループの場合、グループがオフラインになると、この属性には 0 が設定されます。

パラレルグループの場合、グループがオフラインになるか、グループに障害が発生して別のシステムにフェールオーバー可能な場合に、そのシステムのこの属性に 0 が設定されます。

IntentionalOnlineList

(システムのみ使用)

LastSuccess

(システムのみ使用)

Load

(ユーザー定義)

システム上のサービスグループによる負荷を表す多次元値を示します。

クラスタ属性 Statistics が Enabled の場合、使用できるキーの値は CPU、Mem、Swap です。 MeterUnit（クラスタ属性）で指定した対応する単位によるこれらのキーの値。

クラスタ属性 Statistics が Enabled でない場合、使用できるキーの値は Units です。

ManageFaults

(ユーザー定義)

VCS がリソースに対して clean 機能を呼び出すことにより、サービスグループ内のリソース障害を管理するかどうかを指定します。 この属性は次の値をとることができます。

NONE - VCS はグループ内のリソースに対して clean 機能を呼び出しません。 手動でリソースのエラーを処理する必要があります。

ManualOps

(ユーザー定義)

MeterWeight

(ユーザー定義)

複数のシステムがグループ属性の Load 要件に適合する場合に、サービスグループのターゲットシステムを判別するために指定されたクラスタ属性の HostMeters キーの重みを表します。

MigrateQ

(システムのみ使用)

NumRetries

(システムのみ使用)

OnlineAtUnfreeze

(システムのみ使用)

OnlineClearParent

たとえば、親グループと子グループの両方で障害が発生し、両方のグループがフェールオーバーできないと想定します。その後、VCS が再び子グループをオンラインにしようとしたり、グループがオンラインにされたかオンラインであることが検出されたりすると、VCS エンジンは親グループの障害状態を解消し、VCS で親グループも再起動できるようにします。

OnlineRetryInterval

(ユーザー定義)

OnlineRetryLimit

(ユーザー定義)

別のノードにサービスグループをフェールオーバーさせる前に、障害が発生したシステム上で、サービスグループの再起動を VCS エンジンが試行する回数を定義します。0 を定義した場合、再起動を試行しません。

OperatorGroups

(ユーザー定義)

Operators

(ユーザー定義)

グループを操作する権限を持つ VCS ユーザーのリストです。 Group Operator は、特定のグループに関してオンライン/オフライン、および、一時的なフリーズ/アンフリーズ操作のみ実行できます。

パラレル（Parallel）

(ユーザー定義)

PathCount

(システムのみ使用)

PCVAllowOnline

(システムのみ使用)

同時性違反の防止についてを参照してください。

PolicyIntention

(システムのみ使用)

PreOnline

(ユーザー定義)

手動によるグループのオンライン、グループの自動起動、またはグループのフェールオーバーに応じて、VCS エンジンがすぐにサービスグループのオンライン化を行わないことを示します。 その代わり、エンジンが PreOnline トリガを実行する必要があります。

次のように属性の範囲をローカルからグローバルに変更できます。

# hagrp -local <service_group_name> <attribute_name>

次のように属性の範囲をグローバルからローカルに変更できます。

# hagrp -global <service_group_name> <attribute_name>
<value> ... | <key> ... | {<key> <value>} ...

-local オプションと -global オプションについて詳しくは、hagrp コマンドに関連するマニュアルページを参照してください。

PreOnlining

(システムのみ使用)

PreonlineTimeout

(ユーザー定義)

前提条件

(ユーザー定義)

サービスグループをオンラインにするために必要なリソースを表す、name ＝ value のペアのリストです。 必要条件を満たさない場合、そのサービスグループはオンラインになれません。 必要条件（Prerequisites）の書式は次のとおりです。

Prerequisites() = { Name=Value, name2=value2 }。

Prerequisites の設定に使われる名前は自由に付けることができます。システム名を指定することはできません。 Prerequisites のリストに含まれる name=value のペアは Limits 属性の name=value のペアと揃える必要があります。

PreSwitch

(ユーザー定義)

手動サービスグループの切り替え操作に応じて、VCS エンジンが PreSwitch アクションを呼び出す必要があるかどうかを示します。

この属性は、リモートクラスタのグローバルグループ定義で定義する必要があります。 この属性は次の値になります。

0 - VCS エンジンは、通常とおりサービスグループを切り替えます。

1 - VCS エンジンは、リソースの PreSwitch アクションの出力に基づいてサービスグループを切り替えます。

値を 1 に設定すると、VCS エンジンは PreSwitch アクションをサポートするサービスグループのリソースを探します。 アクションがどのリソースに対しても定義されていない場合、VCS エンジンは通常とおりサービスグループを切り替えます。

1 つまたは複数のリソースに対してアクションが定義されている場合、VCS エンジンはそれらのリソースの PreSwitch アクションを呼び出します。 すべてのアクションが成功すると、エンジンはサービスグループを切り替えます。 いずれかのアクションが失敗した場合、エンジンは切り替え操作を中止します。

エンジンは、並行して PreSwitch アクションを呼び出し、すべてのアクションが完了するのを待って、切り替え操作を実行すべきかどうかを判断します。 VCS エンジンは、エンジンのログにアクションの出力を報告します。 PreSwitch アクションで、設定やクラスタの状態が変わることはありません。

PreSwitching

(システムのみ使用)

PrintTree

(ユーザー定義)

リソースの依存関係ツリーを設定ファイルに書き込みます。 1 という値はツリーが書き込まれていることを示します。

Priority

(ユーザー定義)

ユーザーがサービスグループを特定条件で実行させたり、グループの優先順位を設定します。 VCS エンジンは、この属性に定義されている数値を解釈しませんが、この属性を設定することで、ユーザーはサービスグループの優先度および特定のイベントに対する応答で必要となるアクションを設定することが可能となります。

PreferredFencingPolicy のクラスタレベル属性値を Group に設定すると、VCS はこの Priority 属性値を使ってノードの重みを計算し、I/O フェンシングの競合中に存続するサブクラスタを決定します。

VCS は、サービスグループの優先度に基づいて次のようにノードの重みを割り当てます。

Priority     Node weight
1            625
2            125
3            25
4            5
0 or >=5     1

ノードの重みが大きいほど優先度の高い値が関連付けられます。 ノードの重みは ONLINE/PARTIAL のサービスグループのノードの重みの値の合計です。

優先フェンシングについてを参照してください。

Probed

(システムのみ使用)

ProbesPending

(システムのみ使用)

ProPCV

(ユーザー定義)

同時性違反の防止についてを参照してください。

Responding

(システムのみ使用)

Restart

(システムのみ使用)

SourceFile

(ユーザー定義)

設定ファイルを定義します。 main.cf ではこの属性を設定しないでください。

この属性を設定するコマンドを実行する前に、パスがすべてのノード上に存在することを確認します。

状態（State）

(システムのみ使用)

各システム上のグループの状態です。

OFFLINE - 非永続的なリソースがすべてオフラインです。

ONLINE - AutoStart 属性が 1 のリソースすべてがオンラインです。

FAULTED - グループ内の Critical 属性が定義されているリソースに障害が発生したか、障害の影響を受けています。

PARTIAL - Operation 属性に OnOff が設定されているリソースの内のどれかがオンライン（ただしグループ内のすべてではない）であり、AutoStart のリソースがすべてオンラインになっていません。

STARTING - グループは、オンラインに遷移中です。

STOPPING - グループは、オフラインに遷移中です。

MIGRATING - グループは移行元システムから移行先システムへのリソースの移行を試みています。 この状態は、ONLINE|STOPPING|MIGRATING、OFFLINE|STARTING|MIGRATING、OFFLINE|MIGRATING などの複数の状態の組み合わせとしてのみ表れます。

SysDownPolicy

(ユーザー定義)

システムが停止しているときにサービスグループが自動無効化されるかどうか、またシステムが再ブートされたか正常にシャットダウンされたときにサービスグループがオフラインになるかどうかを決定します。

有効な値: 空のキーリストまたは AutoDisableNoOffline キー

デフォルト: 空のキーリスト

SystemList

(ユーザー定義)

サービスグループを実行するよう設定されているシステムのリストと、これらのシステムの優先度です。 数値が小さいほうが、優先度が高くなり、優先的にフェールオーバー先に選択されます。

SystemZones

(ユーザー定義)

Tag

(ユーザー定義)

TargetCount

(システムのみ使用)

TFrozen

(ユーザー定義)

ToQ

(システムのみ使用)

TriggerEvent

(ユーザー定義)

TriggerPath

(ユーザー定義)

トリガパスをカスタマイズできます。

トリガが有効で、トリガパスが "" （デフォルト）の場合、VCS は $VCS_HOME/bin/triggers のディレクトリからトリガを呼び出します。 代替ディレクトリを指定すると、VCS はそのパスからトリガを呼び出します。 値の大文字と小文字は区別されます。 VCS は、トリガパスの値の先頭または末尾のスペースを取り除きません。 パスの先頭または末尾にスペースが含まれていると、トリガの実行に失敗する可能性があります。

指定するパスは次の形式にする必要があります。

$VCS_HOME/TriggerPath/Trigger

たとえば、TriggerPath が mytriggers/sg1 に設定されていると、VCS は $VCS_HOME/mytriggers/sg1/preonline/ ディレクトリで PreOnline トリガスクリプトを探します。

TriggerResFault

(ユーザー定義)

リソースに障害が起きた場合に、VCS が resfault トリガを呼び出すかどうかを定義します。 値 0 は VCS がトリガを呼び出さないことを示します。

TriggerResRestart

(ユーザー定義)

リソースが再起動した場合に resrestart トリガを呼び出すかどうを指定します。

resrestart イベントトリガについてを参照してください。

特定のリソースの resrestart トリガを呼び出すには、リソースレベルでこの属性を有効にします。

リソース属性を参照してください。

TriggerResStateChange

(ユーザー定義)

リソースの状態が変化した場合に resstatechange トリガを実行させます。

特定のリソースについて resstatechange トリガを実行するには、リソースレベルでこの属性を有効にします。

リソース属性を参照してください。

TriggersEnabled

(ユーザー定義)

特定のトリガを有効にするかどうかを指定します。

トリガはデフォルトでは無効になります。 特定のトリガをすべてのノードで有効にすることも、選択したノードで有効にすることもできます。 有効な値は VIOLATION、NOFAILOVER、PREONLINE、POSTONLINE、POSTOFFLINE、RESFAULT、RESSTATECHANGE、RESRESTART です。

ノードでトリガを有効にするには、次の形式でトリガキーを追加します。

TriggersEnabled@node1 = {POSTOFFLINE, POSTONLINE}

postoffline トリガと postonline トリガは、ノード 1 で有効です。

クラスタ内のすべてのノードでトリガを有効にするには、次の形式でトリガキーを追加します。

TriggersEnabled = {POSTOFFLINE, POSTONLINE}

postoffline トリガと postonline トリガは、すべてのノードで有効です。

次のように属性の範囲をローカルからグローバルに変更できます。

# hagrp -local <service_group_name> <attribute_name>

次のように属性の範囲をグローバルからローカルに変更できます。

# hagrp -global <service_group_name> <attribute_name>
<value> ... | <key> ... | {<key> <value>} ...

-local オプションと -global オプションについて詳しくは、hagrp コマンドに関連するマニュアルページを参照してください。

TypeDependencies

(ユーザー定義)

UnSteadyCount

(システムのみ使用)

オンラインまたはオフライン操作が保留されているリソースの合計数を表します。 これはローカライズされた属性です。

この属性を一覧表示するには、hagrp -display コマンドに -all オプションを合わせて使います。

hagrp -flush コマンドはこの属性をリセットします。

UserAssoc

(ユーザー定義)

次のように属性の範囲をローカルからグローバルに変更できます。

# hagrp -local <service_group_name> <attribute_name>

次のように属性の範囲をグローバルからローカルに変更できます。

# hagrp -global <service_group_name> <attribute_name>
<value> ... | <key> ... | {<key> <value>} ...

-local オプションと -global オプションについて詳しくは、hagrp コマンドに関連するマニュアルページを参照してください。

UserIntGlobal

(ユーザー定義)

UserStrGlobal

(ユーザー定義)

UserIntLocal

(ユーザー定義)

UserStrLocal

(ユーザー定義)