その他の情報 - トラブルシューティングと参照情報 135

パート IV トラブルシューティングと参照情報 135

15.4 その他の情報

LinuxおよびHeartbeatの、クラスタリソースの設定、およびHeartbeatクラスタ

の管理とカスタマイズなど、高可用性に関するその他の情報については、

『http://clusterlabs.org/wiki/Documentation』を参照してください。

16

クラスタ管理ツール

High Availability Extensionにはクラスタをコマンドラインから管理する際に役

立つ、包括的なツールセットが付属しています。この章では、CIBおよびクラスタリソースでのクラスタ構成を管理するために必要なツールを紹介します。

リソースエージェントを管理するためのその他のコマンドラインツール、またはセットアップのデバッグおよびトラブルシューティングに使用するツールについては、第15章トラブルシューティング

(137 ページ)で説明していま

す。

次のリストは、クラスタ管理に関連するいくつかのタスクを示しており、これらのタスクを実行するために使用するツールを簡単に説明しています。

クラスタの状態の監視

crm_monコマンドでは、クラスタの状態と構成を監視できます。出力に

は、ノード数、uname、uuid、状態、クラスタで構成されたリソース、それぞれの現在の状態が含まれます。crm_monの出力は、コンソールに表示したり、HTMLファイルに出力したりできます。statusセクションのないクラスタ設定ファイルが指定された場合、crm_monはファイルに指定されたノードとリソースの概要を作成します。このツールの使用方法とコマンド構文の詳細については、crm_mon(8) (168 ページ)を参照してください。

CIBの管理

cibadminコマンドは、Heartbeat CIBを操作するための低レベル管理コマ

ンドです。CIBのすべてまたは一部のダンプ、CIBのすべてまたは一部の更新、すべてまたは一部の変更、CIB全体の削除、その他のCIB管理操作

に使用できます。このツールの使用方法とコマンド構文の詳細については、cibadmin(8) (146 ページ)を参照してください。

設定の変更の管理

crm_diffコマンドは、XMLパッチの作成と適用をサポートします。クラ

スタ設定の2つのバージョン間の差異を表示する、または後でcibadmin(8)

(146

ページ)を使用して適用できるように変更を保存する場合に有効です。

このツールの使用方法とコマンド構文の詳細については、crm_diff(8)

(159 ページ)を参照してください。

CIB属性の操作

crm_attributeコマンドで、CIBで使用されているノード属性およびク

ラスタ構成オプションを問い合わせて操作できます。このツールの使用方法とコマンド構文の詳細については、crm_attribute(8) (156 ページ)を参照してください。

クラスタ構成の検証

crm_verifyコマンドは、構成データベース(CIB)の整合性およびその他

の問題を確認します。構成を含むファイルを確認したり、実行中のクラスタに接続したりできます。2種類の問題を報告します。エラーは、解決しないとHeartbeatが正常に機能できず、警告の解決は管理者が担当します。

cm_verifyは新規または変更された構成の作成を支援します。実行中の

クラスタのCIBのローカルコピーを作成し、編集し、crm_verifyを使用して検証し、新規構成をcibadminを使用して適用できます。このツールの使用方法とコマンド構文の詳細については、crm_verify(8) (197 ページ)を参照してください。

リソース構成の管理

crm_resourceコマンドは、クラスタ上でリソース関連のさまざまなア

クションを実行します。構成されたリソースの定義の変更、リソースの開始と停止、リソースの削除およびノード間での移行を実行できます。このツールの使用方法とコマンド構文の詳細については、crm_resource(8)

(172 ページ)を参照してください。

リソースの失敗回数の管理

crm_failcountコマンドは、所定のノードのリソースごとの失敗回数を

問い合わせます。このツールは、失敗回数のリセットにも使用でき、リソースが頻繁に失敗したノード上で再度実行できるようにします。このツールの使用方法とコマンド構文の詳細については、crm_failcount(8)

(162 ページ)を参照してください。

ノードのスタンバイ状態の管理

crm_standbyコマンドは、ノードのスタンバイ属性を操作します。スタ

ンバイモードのノードはすべて、リソースをホストすることができず、そのノードにあるリソースは削除する必要があります。スタンバイモードはカーネルアップデートなどの保守タスクに有効です。ノードからスタンバイ属性を削除すると、クラスタの完全なアクティブメンバーに戻ります。

このツールの使用方法とコマンド構文の詳細については、crm_standby(8)

(194 ページ)を参照してください。

cibadmin (8)

cibadmin — クラスタの環境設定に直接アクセスできるようにします

書式

環境設定、またはその一部のクエリ、変更、置換、削除を行えるようにします。

cibadmin (--query|-Q) -[Vrwlsmfbp] [-i xml-object-id|-o xml-object-type] [-t t-flag-whatever] [-h hostname]

cibadmin (--create|-C) -[Vrwlsmfbp] [-X xml-string]

[-x xml- filename] [-t t-flag-whatever] [-h hostname]

cibadmin (--replace-R) -[Vrwlsmfbp] [-i xml-object-id|

-o xml-object-type] [-X xml-string] [-x xml-filename] [-t t-flag- whatever] [-h hostname]

cibadmin (--update|-U) -[Vrwlsmfbp] [-i xml-object-id|

-o xml-object-type] [-X xml-string] [-x xml-filename] [-t t-flag- whatever] [-h hostname]

cibadmin (--modify|-M) -[Vrwlsmfbp] [-i xml-object-id|

-o xml-object-type] [-X xml-string] [-x xml-filename] [-t t-flag- whatever] [-h hostname]

cibadmin (--delete|-D) -[Vrwlsmfbp] [-i xml-object-id|

-o xml-object-type] [-t t-flag-whatever] [-h hostname]

cibadmin (--delete_alt|-d) -[Vrwlsmfbp] -o

xml-object-type [-X xml-string|-x xml-filename]

[-t t-flag-whatever] [-h hostname]

cibadmin --erase (-E) cibadmin --bump (-B) cibadmin --ismaster (-m) cibadmin --master (-w) cibadmin --slave (-r) cibadmin --sync (-S) cibadmin --help (-?)

説明

cibadminコマンドは、Heartbeat CIBを操作するための低レベル管理コマンド

です。CIBのすべて、または一部のダンプ、更新、変更、CIB全体の削除、その他各種のCIB管理操作を実行するために使用します。

cibadminはCIBのXMLツリーに対して機能します。ほとんどの場合、実行す

る更新やクエリの意味は把握していません。つまり、XMLツリー要素の意味を理解している人には自然に思えるショートカットも、cibadminでは利用できません。これにはあいまいな点がまったくない状態でなければなりません。そのため、入出力の両方で有効なXMLサブツリー(タグおよび要素)のみ扱うことができます。

注意

cibadminは、手動によるcib.xmlファイルの編集に常に優先して使用す

る必要があります。特にクラスタがアクティブな場合はその必要があります。クラスタは手動編集の検出とその回避にあらゆる手段を駆使してユーザのデータを紛失、または破壊しないようにしています。

オプション

--obj_type object-type, -o object-type

操作実行対象のオブジェクトタイプを指定します。有効な値はnodes、

resources、constraints、crm_status、およびstatusです。

--verbose, -V

デバッグモードを有効にします。-Vオプションを追加すると、詳細な出力が得られます。

--help, -?

cibadminからヘルプメッセージを入手します。

--xpath PATHSPEC, -A PATHSPEC

obj_typeの代わりに使用する有効なXPathを提供します。

コマンド

--bump, -B

CIBのepochバージョンカウンタを増やします。通常この値は、新しい

リーダーを選出するとクラスタが自動的に増分します。古い環境設定(使用していないクラスタノードのものなど)を廃止する場合には、手動で増やす方法は便利です。

--create, -C

引数のXMLコンテンツから新しいCIBを作成します。

--delete, -D

たとえば<op id="rsc1_op1" name="monitor"/>のように、指定した基準と一致する最初のオブジェクトを削除します。要素を削除するには、タグ名とすべての属性が一致しなければなりません。

--erase, -E

CIB全体のコンテンツを削除します。

--ismaster, -m

CIBソフトウェアのローカルインスタンスがマスタインスタンスかどうか

を示すメッセージを印刷します。マスタインスタンスであればリターンコード0を、それ以外の場合は35を返して終了します。

--modify, -M

CIBのXMLツリーでオブジェクトを検索して更新します。

--query, -Q

CIBの一部をクエリします。

--replace, -R

CIB内のXMLオブジェクトを反復置換します。

--sync, -S

特定ホスト(-h使用時)、またはDC(-h未使用時)で、CIBのすべてのノードの再同期化を強制的に実行します。

XMLデータ

--xml-text string, -X string

crmadminを実行するXMLタグまたはXML断片を指定します。完全なタグ

またはXML断片でなければなりません。

--xml-file filename, -x filename

cibadminを実行するファイルからXMLを指定します。完全なタグまたは XML断片でなければなりません。

--xml_pipe, -p

cibadminを実行するXMLを、標準入力からのものとして指定します。完

全なタグまたはXML断片でなければなりません。

詳細オプション

--host hostname, -h hostname

指定されたホストにコマンドを送信します。queryおよびsyncコマンドにのみ適用されます。

--local, -l

コマンドをローカルに適用します(ほとんど使用されない高度なオプション)。

--no-bcast, -b

CIBを変更した場合でも、コマンドはブロードキャストされません。

重要項目

別なクラスタを発生しないように、このオプションは注意して使用してください。

--sync-call, -s

呼び出しが完了するまで待って復帰します。

例

stdoutに配信されたアクティブなCIB(ステータスセクションなどを含む)全体の

コピーを入手するには、このコマンドを実行します。

cibadmin -Q

IPaddr2リソースをresourcesセクションに追加するには、最初に、次のコンテ

ンツを含んだfooファイルを作成します。

<primitive id="R_10.10.10.101" class="ocf" type="IPaddr2"

provider="heartbeat">

<instance_attributes id="RA_R_10.10.10.101">

</attributes>

</instance_attributes>

</primitive>

そして次のコマンドを実行します。

cibadmin --obj_type resources -U -x foo

すでに追加されているIPaddr2リソースのIPアドレスを変更するには、次のコマンドラインを実行します。

cibadmin -M -X '<nvpair id="R_ip_P_ip" name="ip" value="10.10.10.102"/>'

注意

これは、リソース名を新しいIPアドレスに変更するものではありません。追加するには、一旦削除して、新しいIDタグで再度リソースを追加してください。

過去に追加されたIPアドレスリソースを削除せずに停止(無効に)するには、次のコンテンツを含むbarと呼ばれるファイルを作成します。

<instance_attributes id="RA_R_10.10.10.101">

</attributes>

</instance_attributes>

</primitive>

ドキュメント内 High Availability ガイド (ページ 151-200)