startrsrc コマンド

目的

定義済みのリソースを開始します (すなわち、定義済みのリソースをオンラインにします)。

説明

startrsrc コマンドは、Resource Monitoring and Control (RMC) サブシステムが 1 つ以上のリソースをオンラインにすることを要求します。 要求は該当するリソース・マネージャーによって実行されます。

1 つ以上のリソースを開始するには、 -sフラグを使用して、指定した選択文字列に一致するすべてのリソースをオンラインにします。

selection_stringに複数のノード名を指定する代わりに、 -N node_file フラグを使用して、ノード名がファイル内にあることを示すことができます。 標準入力からノード名を読み取るには、 -N "-" を使用します。

特定のリソースを開始するには、 -r フラグを使用して、その特定のリソースを表すリソース・ハンドルを指定します。

指定されたリソース・クラスが追加のコマンド引数を受け入れるかどうかを判別するには、 -l フラグを使用します。

システムにクラスター・システム・マネージメント (CSM) がインストールされている場合は、CSM 定義のノード・グループをノード名の値として使用して、複数のノードを参照できます。 CSM ノード・グループの処理および CSM nodegrp コマンドの使用については、「 CSM: Administration Guide 」および「 CSM: Command and Technical Reference」を参照してください。

 lsrsrc -s 'Name == "/filesys1"' -t IBM.FileSystem Name OpState

パラメーター

リソース・クラス

オンラインにしたいリソースがあるリソース・クラスの名前を指定します。

リソース・ハンドル

オンラインにしたいリソースに対応するリソース・ハンドルを指定します。 有効なリソース・ハンドルのリストを取得するには、 lsrsrc コマンドを使用します。 リソース・ハンドルは、二重引用符で囲む必要があります。例えば、次のとおりです。

"0x4017 0x0001 0x00000000 0x0069684c 0x0d4715b0 0xe9635f69"

arg=値 ...

コマンド引数の名前と値のペアを 1 つ以上指定します。

引数

引数の名前を指定します。

value

この引数の値を指定します。 値のデータ・タイプは引数のデータ・タイプの定義と一致しなければなりません。

コマンドの引数はオプションです。 arg=value のペアを入力する場合は、指定されたリソース・クラスのオンライン関数に定義されたコマンド引数ごとに、1 つの arg=value のペアがなければなりません。

特定のリソース・クラスのコマンド引数名とデータ・タイプのリストを取得するには、 startrsrc -l を使用します。

フラグ

--f resource_data_input_file

リソースの引数情報が含まれているファイルの名前を指定します。 ファイルの内容は次のようになります。

PersistentResourceArguments::                            
argument1 = value1                                    
argument2 = value2 

-l

コマンド引数とデータ・タイプをリストします。 一部のリソース・マネージャーは、オンライン要求に渡される追加の引数を受け入れます。 このフラグを使用して定義済みのコマンド引数とコマンド引数値のデータ・タイプをリストします。

-ノード名

リソースがオンラインにされるノードの名前を指定します。 node_name は NodeNameList 属性値です。 このフラグを使用して、別のノード上の浮動リソースをオンラインにします (リソースがオンラインであったノードがダウンしている可能性がある場合)。

リソースが既知のリソースであるノード上でそのリソースをオンラインにしたい場合は、このフラグを指定しないでください。

--N { node_file │"-"}

ファイルまたは標準入力からノード名を読み取ることを指定します。 ノード名がファイル内にあることを示すには、 -N node_file を使用します。

• node_file では 1 行に 1 つのノード名を指定します。
• 1 桁目の番号記号 (#) は、その行がコメントであることを示します。
• ノード名の左のブランク文字はすべて無視されます。
• ノード名の右のブランク文字はすべて無視されます。

標準入力からノード名を読み取るには、 -N "-" を使用します。

CT_MANAGEMENT_SCOPE 環境変数は、クラスターの有効範囲を決定します。 CT_MANAGEMENT_SCOPE が設定されていない場合、コマンドにとって有効な範囲になるまで、最初に管理ドメイン有効範囲 (存在する場合) を選択し、次にピア・ドメイン有効範囲 (存在する場合) を選択し、次にローカル有効範囲を選択します。 コマンドは、最初に見つかった有効範囲に対して、1 回実行されます。 例えば、管理ドメインとピア・ドメインの両方が存在する場合に CT_MANAGEMENT_SCOPE が設定されていないと、このコマンドは管理ドメインに適用されます。 このコマンドをピア・ドメインに適用する場合は、CT_MANAGEMENT_SCOPE を 2に設定してください。

--s"selection_string"

選択文字列を指定します。 選択文字列はすべて、 二重または単一の引用符で囲まなければなりません。 選択文字列の中に二重引用符が含まれている場合は、選択文字列全体を単一の引用符で囲んでください。 次に例を示します。

           
-s 'Name == "testing"'                                   
           
-s 'Name ?= "test"'                                      

永続属性のみを選択文字列にリストすることができます。

-h

コマンドの使用方法の文を標準出力に書き込みます。

-T

標準エラーにコマンドのトレース・メッセージを書き込みます。 これはソフトウェア・サービス組織専用です。

-V

コマンドの詳細メッセージ (使用可能なメッセージがある場合) を標準出力に書き込みます。

環境変数

CT_CONTACT

CT_CONTACT 環境変数をホスト名または IP アドレスに設定すると、コマンドは指定されたホストの RMC (Resource Monitoring and Control) デーモンにアクセスします。 この環境変数を設定しないと、コマンドは、そのコマンドが実行されているローカル・システムの RMC デーモンにアクセスします。 コマンドによって表示または変更されるリソース・クラスやリソースは、接続が確立されたシステム上にあります。

CT_IP_AUTHENT

CT_IP_AUTHENT 環境変数が存在する場合、RMC デーモンは、IP ベース・ネットワーク認証を使用して、CT_CONTACT 環境変数が設定されている IP アドレスで指定されたシステム上の RMC デーモンにアクセスします。 CT_IP_AUTHENT は、CT_CONTACT が IP アドレスに設定されている場合にのみ意味を持ちます。ドメイン・ネーム・システム (DNS) サービスには依存しません。

CT_MANAGEMENT_SCOPE

RMC デーモンがリソースおよびリソース・クラスをモニターし、制御するための セッションに使用する管理有効範囲を指定します。 この管理有効範囲により、リソースおよびリソース・クラスをモニターおよび制御できる候補ターゲット・ノードのセットが決定します。 有効な値は以下のとおりです。

0

local 有効範囲を指定します。

1

local 有効範囲を指定します。

2

peer domain (ピア・ドメイン) 有効範囲を指定します。

3

management domain (管理ドメイン) 有効範囲を指定します。

この環境変数が設定されていない 場合は、local 有効範囲が使用されます。

標準出力

-h フラグを指定すると、このコマンド使用状況ステートメントが標準出力に書き込まれます。 -V フラグを指定すると、このコマンドの詳細メッセージ (使用可能なメッセージがある場合) が標準出力に書き込まれます。

標準エラー

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

終了状況

0

コマンドは正常に実行されました。

1

RMC 内でエラーが発生しました。

2

コマンド・ライン・インターフェース (CLI) スクリプトでエラーが発生しました。

3

コマンド・ラインに間違ったフラグが指定されました。

4

コマンド・ラインに不正なパラメーターが指定されました。

5

不正なコマンド・ライン入力に基づく RMC により、エラーが発生しました。

6

指定された選択文字列に一致するリソースが見つかりませんでした。

セキュリティー

startrsrcを実行するには、 startrsrc で指定された resource_class に対する書き込み権限が必要です。 権限は、相手のシステムのアクセス制御リスト (ACL) ファイルに指定します。 ACL ファイルおよびその変更方法について詳しくは、「Administering RSCT」ガイドを参照してください。

実行の特性

このコマンドは'AIX®オペレーティングシステム用の'rsct.core.rmcファイルセット、'Linux®、Solaris、Windowsオペレーティングシステム用の'rsct.core-3.1.0.0-0.'プラットフォーム'.rpmパッケージの一部であり、'プラットフォーム'は'i386、'ppc、'ppc64、's390、または'x86_64である。

場所

/opt/rsct/bin/startrsrc

例