Go to main content

Oracle® Solaris Cluster 4.4 のリファレンス

印刷ビューの終了

更新: 2018 年 8 月
 
 

clsnmphost (8CL)

名前

clsnmphost - Oracle Solaris Cluster SNMP ホストのリストの管理

形式

/usr/cluster/bin/clsnmphost -V
/usr/cluster/bin/clsnmphost [subcommand] -?
/usr/cluster/bin/clsnmphostsubcommand [[options]] -v [host]
/usr/cluster/bin/clsnmphost add [-c community[,…]] 
[-n node[,…]] host […]
/usr/cluster/bin/clsnmphost add -i {- | clconfigfile} 
[-ccommunity[,…]] [-n node[,…]] host […]
/usr/cluster/bin/clsnmphost export [-o {- | clconfigfile}] 
[-c community[,…]] [-n node[,…]] [+ | host…]
/usr/cluster/bin/clsnmphost list [-c community[,…]] 
[-n node[,…]] [+ | host…]
/usr/cluster/bin/clsnmphost remove [-c community[,…]] 
[-n node[,…]] {+ | host…}
/usr/cluster/bin/clsnmphost show [-c community[,…]] 
[-n node[,…]] [+ | host…]

説明

clsnmphost コマンドは、SNMP (Simple Network Management Protocol) ホストおよび SNMP イベントの通知を受信するコミュニティー名を管理します。SNMP ホストはクラスタの管理情報ベース (MIB) を使用してアクセス制御メカニズムを提供します。MIB が SNMP トラップ通知を送信すると、このコマンドで構成された SNMP ホストはトラップ通知を送信するホストを特定できます。クラスタ MIB の詳細は、clsnmpmib(8CL) のマニュアルページを参照してください。

このコマンドに短形式はありません。

このコマンドの一般的な形式は次のとおりです。

clsnmphost [subcommand] [options] [operands]

subcommand は、options でオプション –? または –V が指定されている場合にのみ省略できます。

このコマンドの各オプションには、長い形式と短い形式があります。各オプションの両方の形式は、このマニュアルページの「オプション」セクションのオプションの説明で紹介されています。

詳細は、Intro(8CL) のマニュアルページを参照してください。

��コマンド��大域ゾーン���使用����。

サブコマンド

サポートされるサブコマンドには次のものがあります。

add

クラスタの MIB のトラップ通知を受信し、MIB のテーブルにアクセスできるホストのリストに SNMPホストを追加します。

��サブコマンド��大域ゾーン���使用����。

add サブコマンドを –n オプションなしで使用すると、現在のノードだけが影響を受けます。add–c オプションなしで使用すると、このサブコマンドは public をデフォルトのコミュニティー名として使用します。IP アドレスまたはホスト名のいずれかを使用してホストを指定します。

指定されたコミュニティー名が存在しない場合、このコマンドはそのコミュニティーを作成します。–clconfigfile から 1 つ以上のホスト構成をインポートするには、i オプションを使用します。

root 役割以外のユーザーがこのサブコマンドを使用するには、承認 solaris.cluster.modify が必要です。rbac(7) のマニュアルページを参照してください。

export

指定されたノードの SNMP ホスト情報をエクスポートします。

��サブコマンド��大域ゾーン���使用����。

SNMP ホスト情報をエクスポートする 1 つ以上のノードを指定するには、–n オプションを使用します。export–n オプションなしで使用すると、このサブコマンドは現在のノードの SNMP ホスト情報だけをエクスポートします。

export サブコマンドからの出力形式については、clconfiguration(7CL) のマニュアルページを参照してください。デフォルトでは、すべての出力が標準出力に送信されます。出力先をファイルに変更するには、–o オプションを使用して、そのあとにファイル名を指定します。

–c オプションを使用することで、export サブコマンドからの出力を特定のコミュニティー内のホストの情報だけに制限できます。これらのホストだけに出力情報を制限するには、1 つ以上のホストをオペランドとして指定します。

root 役割以外のユーザーがこのサブコマンドを使用するには、承認 solaris.cluster.read が必要です。rbac(7) のマニュアルページを参照してください。

list

指定されたノード上で構成されている SNMP ホストを一覧表示します。

��サブコマンド��大域ゾーン���使用����。

list サブコマンドを –n オプションなしで使用すると、現在のノード上の SNMP ホストだけが一覧表示されます。デフォルトでは、このサブコマンドはノード上のすべてのホストを一覧表示します。特定のホストについての情報に出力を制限するには、1 つ以上のホストをオペランドとして指定します。また、–c オプションを使用して、指定されたコミュニティー内のホストだけを一覧表示することもできます。

root 役割以外のユーザーがこのサブコマンドを使用するには、承認 solaris.cluster.read が必要です。rbac(7) のマニュアルページを参照してください。

remove

SNMP ホストをノード構成から削除します。

��サブコマンド��大域ゾーン���使用����。

構成からホストを削除するには、ホスト名をオペランドとして指定します。remove サブコマンドを –n オプションなしで使用すると、現在のノード上の SNMP ホストだけが削除されます。すべてのホストを削除するには、正符号 (+) を使用します。1 つ以上のホストを特定のコミュニティーから削除するには、–c オプションを使用します。

root 役割以外のユーザーがこのサブコマンドを使用するには、承認 solaris.cluster.modify が必要です。rbac(7) のマニュアルページを参照してください。

show

指定されたノード上の SNMP ホスト情報を表示します。

��サブコマンド��大域ゾーン���使用����。

show サブコマンドを –n オプションなしで使用すると、現在のノード上の SNMP ホストの情報だけが表示されます。デフォルトでは、show サブコマンドはすべてのホストおよびそのコミュニティーの情報を表示します。コミュニティー内の特定のホストの情報に出力を限定するには、–c オプションを使用するか、1 つ以上のホストの名前をオペランドとして指定します。

root 役割以外のユーザーがこのサブコマンドを使用するには、承認 solaris.cluster.read が必要です。rbac(7) のマニュアルページを参照してください。

オプション

次のオプションがサポートされています。

–?
–-help

ヘルプ情報を出力します。

このオプションはサブコマンド付きでもサブコマンドなしでも指定できます。

  • このオプションをサブコマンドなしで使用すると、使用可能なサブコマンドのリストが表示されます。

  • このオプションをサブコマンドとともに使用すると、サブコマンドの使用オプションが表示されます。

このオプションを使用する場合、ほかの処理は実行されません。

–c community
–-communitycommunity

ホスト名とともに使用される SNMP コミュニティー名を指定します。このオプションは、サブコマンド操作の範囲を絞り込むためにほかのサブコマンドとともに使用される場合もあります。たとえば、remove サブコマンドとともに使用すると、–c オプションは特定の community から 1 つまたは多数のホストを削除するために使用できます。add サブコマンドを –c オプションなしで使用すると、このサブコマンドは public をデフォルトのコミュニティー名として使用します。

–i {- | clconfigfile}
–-input {- | clconfigfile}

SNMP ホスト構成を検証または変更するために使用できる構成情報を指定します。この情報は、clconfiguration(7CL) のマニュアルページに定義されている形式に準拠している必要があります。この情報は、ファイルに含めることも、標準入力を介して指定することもできます。標準入力を指定するには、ファイル名の代わりにマイナス記号 (-) を指定します。

–n node[,…]
–-node[s] node[,…]

ノードまたはノードリストを指定します。各ノードは、ノード名またはノード ID として指定できます。clsnmphost コマンドのすべての形式で、このオプションが許可されます。

–o {- | clconfigfile}
–-output {- | clconfigfile}

クラスタの SNMP ホスト構成情報を、clconfiguration(7CL) のマニュアルページで定義されている形式で書き込みます。この情報は、ファイルまたは標準出力のどちらにでも書き込むことができます。

標準出力に書き込むには、ファイル名の代わりにマイナス記号 (-) を指定します。標準出力を指定すると、該当コマンドにおける他のすべての標準出力は抑制されます。

ファイル名を指定すると、構成はその名前の新しいファイルにコピーされます。

–o オプションは、export サブコマンドとともに使用するときのみに有効になります。–o オプションを指定しない場合、出力は標準出力に出力されます。

–V
–-version

コマンドのバージョンを出力します。

このオプションは、サブコマンド、オペランド、またはその他のオプションと一緒に指定しないでください。指定すると、一緒に指定されたサブコマンド、オペランド、またはその他のオプションは無視されます。–V オプションは、コマンドのバージョンだけを表示します。その他の処理は行いません。

–v
–-verbose

詳細情報を標準出力に出力します。

このオプションはどの形式のコマンドととも指定できますが、一部のサブコマンドは拡張出力を発生させないことがあります。たとえば、export サブコマンドは、詳細オプションを指定しても拡張出力を発生させません。

オペランド

次のオペランドがサポートされています。

+

すべての SNMP ホストエントリを指定します。

host

クラスタ上の SNMP MIB へのアクセスを提供されているホストの IP アドレス、IPv6 アドレス、またはホスト名を指定します。

終了ステータス

指定������オペランド�コマンド��功�る��コマンド�ゼロ (CL_NOERR) を返���。�るオペランド�エラー�発生�る��コマンド�オペランドリスト�次�オペランドを処����。戻り値�常��最��発生��エラーを�映���。

このコマンドは、次の終了ステータスコードを返します。

0 CL_NOERR

エラー��

実行��コマンド�正常�終了����。

1 CL_ENOMEM

�分�スワップ空間��り��ん。

クラスタノード�スワップメモリー�����他�オペレーティングシステムリソースを使�果�����。

3 CL_EINVAL

無効�引数

コマンドを間é�•ã�£ã�¦å…¥åŠ›ã�—ã�Ÿã�‹ã€�–i オプションã�§æŒ‡å®šã�—ã�Ÿã‚¯ãƒ©ã‚¹ã‚¿æ§‹æˆ�情報ã�®æ§‹æ–‡ã�Œé–“é�•ã�£ã�¦ã�„ã�¾ã�—ã�Ÿã€‚

6 CL_EACCESS

アクセス権��り��ん

指定��オブジェクト�アクセス����ん。��コマンドを発行�る���root 役割���承��必���る�能性��り��。詳細��rbac(7) �マニュアルページを�照������。

18 CL_EINTERNAL

内部エラー�発生����

内部エラー��ソフトウェア�欠陥�����他�欠陥を示�����。

35 CL_EIO

I/O エラー

物�的�入出力エラー�発生����。

36 CL_ENOENT

��よ��オブジェクト��り��ん。

次ã�®ã�„ã�šã‚Œã�‹ã�®ç�†ç”±ã�§ã€�指定ã�—ã�Ÿã‚ªãƒ–ジェクトã�Œè¦‹ã�¤ã�‹ã‚Šã�¾ã�›ã‚“: (1) オブジェクトã�Œå­˜åœ¨ã�—ã�ªã�„。 (2) –o オプションã�§ä½œæˆ�ã�—よã�†ã�¨ã�—ã�Ÿæ§‹æˆ�ファイルã�®ãƒ‘スã�«å�«ã�¾ã‚Œã�¦ã�„るディレクトリã�Œå­˜åœ¨ã�—ã�ªã�„。 (3) –i オプションã�§ã‚¢ã‚¯ã‚»ã‚¹ã�—よã�†ã�¨ã�—ã�Ÿæ§‹æˆ�ファイルã�«ã‚¨ãƒ©ãƒ¼ã�Œã�‚る。

使用例 1 ホスト名の指定によるホストの追加

次のコマンドは、ホスト myhost を現在のノード private のコミュニティーの SNMP ホストリストに追加します。

# clsnmphost add -c private phys-schost-1

ホストを public 以外のコミュニティーに追加する場合は、コミュニティー名を指定してください。

使用例 2 ホスト IP と IPv6 アドレスの指定によるホストの追加

次のコマンドは、現在のノード上にある public コミュニティーの SNMP ホストリストにホストを追加します。コマンドの 1 番目のバージョンは、ホストの IP アドレスを指定することによってホストを追加します。コマンドの 2 番目のバージョンは、ホストの IPv6 アドレスを指定することによってホストを追加します。

# clsnmphost add -c public 192.168.12.12
または
# clsnmphost add -c public fe:1::5
使用例 3 ホストの削除

次のコマンドは、private コミュニティーからすべてのホストを削除します。

# clsnmphost remove -c private +
使用例 4 現在のノード上のホストの一覧表示

次のコマンドは、現在のノード上にあるすべてのホストを一覧表示します。

# clsnmphost list
phys-schost-1
192.168.12.12
使用例 5 ホストとホストのコミュニティー名の一覧表示

次のコマンドは、詳細オプション –v を使用して、現在のノード上のすべてのホストとそれらのコミュニティー名を一覧表示します。

# clsnmphost list -v

--- SNMP hosts on node phys-schost-1 ---

Host Name           Community
---------           ---------
phys-schost-1       private
192.168.12.12       public
使用例 6 SNMP ホスト構成の表示

次のコマンドは、ノード phys-cluster-2 上の SNMP ホストのすべての構成情報を表示します。

# clsnmphost show -n phys-schost-2

--- SNMP Host Configuration on phys-schost-2 ---

SNMP Host Name:                                 phys-schost-2
  Community:                                       private

属性

次の属性については、attributes(7) を参照してください。

属性タイプ
属性値
使用条件
ha-cluster/system/core
インタフェースの安定性
発展中

関連項目

scha_calls(3HA)clconfiguration(7CL)attributes(7)rbac(7)Intro(8CL)clsnmpmib(8CL)cluster(8CL)

root 役割はこのコマンドのすべての形式を実行できます。

すべてのユーザーがこのコマンドに –? (ヘルプ) オプションまたは –V (バージョン) オプションを指定して実行できます。

root 役割以外のユーザーが clsnmphost コマンドにほかのサブコマンドを付けて実行するには、承認が必要です。次の表を参照してください。

サブコマンド
承認
add
solaris.cluster.modify
export
solaris.cluster.read
list
solaris.cluster.read
remove
solaris.cluster.modify
show
solaris.cluster.read