lsrpnode コマンド

目的

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

構文

lsrpnode [ [ I ] [ - | T | -d 年 | -D 区切り文字 ] - | -O (O) | -L (L) ] -P ] -キュー ] [ -B ] [ -x (X) ] [-h] [-テレビ] [ノード名]

lsrpnode -p peer_domain [ -l | -t | -d | -D 区切り文字 ] [-x] [-h] [-TV]

説明

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

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

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

デフォルトでは、 lsrpnode コマンドは情報を表形式 (-t) で表示します。

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

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

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

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

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

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

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

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

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

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

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

フラグ

-d: 区切り文字を使用して情報を表示します。デフォルトの区切り文字はコロン (:) です。デフォルトの区切り文字を変更する場合は、 -D フラグを使用します。
--D デリミタ: 指定した区切り文字を使用して情報を表示します。このフラグを使用して、デフォルトのコロン (:) 以外の区切り文字を指定します。例えば、表示する情報にコロンが含まれている場合などです。このフラグを使用すると、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: コマンドの詳細メッセージを標準出力に書き込みます。

パラメーター

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

セキュリティー

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®用の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
```

場所

/opt/rsct/bin/lsrpnode