lsrpnode コマンド

目的

オンライン・ピア・ドメインで定義された 1 つ以上のノードについての情報を表示します。

構文

lsrpnode [ [ -i ] [ -l | -t | -d | -D delimiter ] -o | -O | -L ] -P ] -Q ] [ -B ] [ -x ] [-h] [-TV] [node_name]

lsrpnode -p peer_domain [ -l │ -t │ -d │ -D delimiter ] [-x] [-h] [-TV]

説明

lsrpnode コマンドは、オンライン・ピア・ドメインで定義された 1 つ以上のノードについての情報を表示します。このコマンドのフラグおよびパラメーターを使用して、表示する情報とその表示方法を指定します。ノード名を指定すると、コマンドはそのノードのみについての情報を表示します。

-o、-O、および -L フラグもまた、このコマンドが表示する情報を制限します。 -o フラグは、オンラインのノードに関する情報を表示します。 -O フラグは、オフラインのノードに関する情報を表示します。-L フラグは、ローカル・ノード、つまりコマンドが実行されるノードに関する情報を表示します。

-P フラグは、グループ・サービスのグループ・リーダー選択に関連した追加のノード構成情報を表示します。-Q フラグは、クォーラム決定に関連した追加のノード構成情報を表示します。-B フラグは、タイ・ブレーカー・メカニズムに関連した追加のノード構成情報を表示します。

デフォルトでは、lsrpnode コマンドはテーブル・フォーマット (-t) で情報を表示します。

表示されるノード情報の一部を以下に示します。

フィールド	説明
Name	ピア・ドメイン内のノードの名前。
OpState	ノードの操作状態。
RSCTVersion	ノードでアクティブな RSCT のバージョン。

-i フラグを指定すると、次のフィールドが表示されます。

フィールド	説明
NodeNum	トポロジー・サービスおよびグループ・サービスによって使用されるノード番号。この番号は、クラスター内で固有の番号です。
NodeID	固有のノード ID。

他のフィールド (指定されたフラグによって決まります) と同様に、このフィールドは、-P フラグを指定すると、表示されます。

フィールド	説明
Preferred	ノードがグループ・サービスのグループ・リーダー候補であるかどうかを示します。

他のフィールド (指定されたフラグによって決まります) と同様に、このフィールドは、-Q フラグを指定すると、表示されます。

フィールド	説明
Quorum	ノードがクォーラム決定に参加するかどうかを示します。

他のフィールド (指定されたフラグによって決まります) と同様に、このフィールドは、-B フラグを指定すると、表示されます。

フィールド	説明
Tiebreaker	ノードがピア・ドメインのタイ・ブレーカー・メカニズムにアクセス権限を持っているかどうかを示します。

グループ・サービスのグループ・リーダー選択、クォーラム決定、およびタイ・ブレーカー・メカニズムについて詳しくは、「Administering RSCT」ガイドを参照してください。

フラグ

-d: 区切り文字を使用して情報を表示します。デフォルトの区切り文字はコロン (:) です。デフォルトの区切り文字を変更したい場合は、-D フラグを使用します。
-D delimiter: 指定した区切り文字を使用して情報を表示します。このフラグを使用して、デフォルトのコロン (:) 以外の区切り文字を指定します — 例えば、表示する情報にコロンが含まれている場合などです。このフラグを使用すると、1 文字以上の区切り文字を指定できます。
-i: ノードのノード番号とノード ID を表示します。ノード番号は、トポロジー・サービスとグループ・サービスによって使用される、クラスター内で固有の番号です。ノード ID は固有のノード ID です。
-l: 情報を別々の行に表示します (長形式)。
-L: ローカル・ノード、つまりコマンドが実行されるノードに関する情報だけを表示します。
-o: ピア・ドメイン内のオンラインのノードについての情報を表示します。
-O: ピア・ドメイン内のオフラインのノードについての情報を表示します。
-p peer_domain: ローカル・ノードが属するオフライン・ピア・ドメイン内で定義されたノードについての情報を表示します。(デフォルトでは、lsrpnode コマンドは、ユーザーが現在オンライン のドメイン内で定義されたノードに関する情報を表示します。) ただし、この情報はローカル・ノードがオフラインにされた後のドメインへの変更を反映していない可能性があります。なぜなら、オフライン・ノードの構成が最新でない可能性があるためです。
-p フラグは、CT_CONTACT 環境変数を無視します。-p フラグを使用するには root アクセスを持つ必要があります。
-P: ノードがグループ・サービスのグループ・リーダー候補であるかどうかを示します。ノードがグループ・サービスのグループ・リーダーになりうる場合は、yes が表示されます。ノードがグループ・サービスのグループ・リーダーになりえない場合は、no が表示されます。グループ・サービスのグループ・リーダー選択について詳しくは、「Administering RSCT」を参照してください。
-Q: ノードがクォーラム決定に参加するかどうかを示します。ノードがクォーラム決定に参加する場合は、「yes」が表示されます。ノードがクォーラム決定に参加しない場合は、「no」が表示されます。クォーラム決定について詳しくは、「Administering RSCT」を参照してください。
-B: ノードがピア・ドメインのタイ・ブレーカー・メカニズムにアクセス権限を持っているかどうかを示します。ノードがピア・ドメインのタイ・ブレーカー・メカニズムにアクセス権限を持っている場合は、「yes」が表示されます。ノードがピア・ドメインのタイ・ブレーカー・メカニズムにアクセス権限を持っていない場合は、「no」が表示されます。タイ・ブレーカー・メカニズムについて詳しくは、「Administering RSCT」を参照してください。
-t: 情報を別々の列に表示します (テーブル形式)。これは、デフォルトのフォーマットです。
-x: ヘッダーを除外します (ヘッダーの印刷を抑止します)。
-h: コマンドの使用方法の文を標準出力に書き込みます。
-T: コマンドのトレース・メッセージを標準エラーに書き込みます。これは、ソフトウェア保守部門専用の機能です。
-V: コマンドの詳細メッセージを標準出力に書き込みます。

パラメーター

node_name: 情報を表示する対象のノードの名前を指定します。このパラメーターには、ノード名またはノード名のサブストリングを指定できます。サブストリングを指定した場合、コマンドは、そのサブストリングを含む名前を持つすべての定義済みのノードの情報を表示します。

セキュリティー

lsrpnode コマンドのユーザーには、このコマンドが実行されるノード上の IBM.PeerNode リソース・クラスの読み取り許可が必要です。デフォルトでは、ピア・ドメイン内のどのノードの root にも、構成リソース・マネージャーを介してこのリソース・クラスへの読み取りおよび書き込みアクセス権があります。

終了状況

0: コマンドは正常に実行されました。
1: RMC でエラーが発生しました。
2: コマンド・ライン・インターフェース・スクリプトでエラーが発生しました。
3: コマンド・ラインに間違ったフラグが入力されました。
4: コマンド・ラインに間違ったパラメーターが入力されました。
5: コマンド・ライン入力の間違いが原因のエラーが発生しました。

環境変数

CT_CONTACT: Resource Monitoring and Control (RMC) デーモンとのセッションが発生するシステムを決定します。 CT_CONTACT にホスト名または IP アドレスが設定されていると、このコマンドは指定されたホスト上の RMC デーモンと連絡を取ります。CT_CONTACT が設定されていない場合、このコマンドは、コマンドが実行されているローカル・システムの RMC デーモンと連絡を取ります。RMC デーモン・セッションのターゲットおよび管理有効範囲によって、処理されるリソース・クラスまたはリソースが決定されます。
CT_IP_AUTHENT: CT_IP_AUTHENT 環境変数が存在する場合は、RMC デーモンは、IP ベース・ネットワーク認証を使用して、CT_CONTACT 環境変数が設定されている IP アドレスで指定されるシステム上の RMC デーモンと連絡を取ります。 CT_IP_AUTHENT が意味をもつのは、CT_CONTACT が IP アドレスに設定されている場合のみです。つまり、この環境変数はドメイン・ネーム・システム (DNS) サービスには依存しません。

制限

このコマンドは、ピア・ドメインでオンラインのノードで実行する必要があります。

実装上の固有な条件

このコマンドは、AIX® 用の高信頼性スケーラブル・クラスター・テクノロジー (RSCT) (Reliable Scalable Cluster Technology (RSCT)) ファイルセットに含まれます。

標準入力

-f "-" または -F "-" フラグを指定すると、このコマンドは標準入力から 1 つ以上のノード名を読み取ります。

標準出力

-h フラグが指定されている場合は、このコマンドの使用方法の説明文が標準出力に書き込まれます。詳細メッセージはすべて、標準出力に書き込まれます。

標準エラー

トレース・メッセージはすべて、標準エラーに書き込まれます。

例

nodeA が属するオンライン・ピア・ドメイン内のノードについての一般情報を表示するには、次のコマンドを nodeA で実行します。
```
lsrpnode 
```
出力は次のようになります。
```
Name    OpState   RSCTVersion 
nodeA   Online    3.1.4.0   
nodeB   Online    3.1.4.0     
nodeC   Offline   3.1.4.0   
```
nodeA が属するオンライン・ピア・ドメイン内のノードについての一般情報を、デフォルトの区切り文字を使用して (見出しなしで) 表示するには、次のコマンドを nodeA で実行します。
```
lsrpnode -xd 
```
出力は次のようになります。
```
nodeA:Online:3.1.4.0: 
nodeB:Online:3.1.4.0: 
nodeC:Offline:3.1.4.0:
```
nodeA が属するオンライン・ピア・ドメイン内のノードについての一般情報を長形式で表示するには、次のコマンドを nodeA で実行します。
```
lsrpnode -l 
```
出力は次のようになります。
```
Name        = nodeA 
OpState     = Online 
RSCTVersion = 3.1.4.0 

Name        = nodeB
OpState     = Online 
RSCTVersion = 3.1.4.0   

Name        = nodeC
OpState     = Offline 
RSCTVersion = 3.1.4.0  
```
nodeA が属するオンライン・ピア・ドメイン内のノードについての一般情報 (ノード番号およびノード ID を含む) を表示するには、次のコマンドを nodeA で実行します。
```
lsrpnode -i
```
出力は次のようになります。
```
Name    OpState   RSCTVersion   NodeNum   NodeID           
nodeA   Online    3.1.4.0       2         40a514bed9d82412 
nodeB   Online    3.1.4.0       1         47fe57098f4ec4d9      
```
nodeA が属するオンライン・ピア・ドメイン内のノードについての一般情報 (優先グループ・サービスのグループ・リーダー情報を含む) を表示するには、nodeA 上でこのコマンドを次のように実行します。
```
lsrpnode -P
```
出力は次のようになります。
```
Name    OpState   RSCTVersion   Preferred
nodeA   Online    3.1.4.0       yes 
nodeB   Online    3.1.4.0       no
```
nodeA が属するオンライン・ピア・ドメイン内のノードについての一般情報 (クォーラム情報を含む) を表示するには、nodeA 上でこのコマンドを次のように実行します。
```
lsrpnode -Q
```
出力は次のようになります。
```
Name    OpState   RSCTVersion   Quorum
nodeA   Online    3.1.4.0       no 
nodeB   Online    3.1.4.0       yes
nodeC   Online    3.1.4.0       yes
```
nodeA が属するオンライン・ピア・ドメイン内のノードについての一般情報 (クォーラムおよびタイ・ブレーカー情報を含む) を表示するには、nodeA 上でこのコマンドを次のように実行します。
```
lsrpnode -QB
```
出力は次のようになります。
```
Name    OpState   RSCTVersion   Quorum		Tiebreaker
nodeA   Online    3.1.4.0       no 			no
nodeB   Online    3.1.4.0       yes			yes
nodeC   Online    3.1.4.0       yes			yes
```

Location

/opt/rsct/bin/lsrpnode