Go to main content

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

印刷ビューの終了

更新: 2018 年 8 月
 
 

clsnmpuser (8CL)

名前

clsnmpuser - Oracle Solaris Cluster SNMP ユーザーの管理

形式

/usr/cluster/bin/clsnmpuser -V
/usr/cluster/bin/clsnmpuser [subcommand] -?
/usr/cluster/bin/clsnmpuser [subcommand] [options] -v [operand]
/usr/cluster/bin/clsnmpuser create -i {- | clconfigfile} 
[-a authentication] -f passwdfile [-n node[,…]] {+ | user …}
/usr/cluster/bin/clsnmpuser delete [-a authentication] [-n node[,…]] 
{+ | user …}
/usr/cluster/bin/clsnmpuser export [-o {- | clconfigfile}] 
[-a authentication] [-n node[,…]] [{+ | user …}]
/usr/cluster/bin/clsnmpuser list [-a authentication] [-n node[,…]] 
{-d | + | user …}
/usr/cluster/bin/clsnmpuser set [-a authentication] [-n node[,…]] 
{+ | user …}
/usr/cluster/bin/clsnmpuser set-default {-l seclevel[,…]} 
{+ | user …}
/usr/cluster/bin/clsnmpuser show [-a authentication] [-n node[,…]] 
[-d | + | user …]

説明

clsnmpuser コマンドは、クラスタの管理情報ベース (MIB) 上の制御メカニズムを管理できる SNMP (Simple Network Management Protocol) ユーザーの役割を管理します。クラスタ MIB の詳細は、clsnmpmib(8CL) のマニュアルページを参照してください。クラスタが SNMP バージョン 3 (SNMPv3) を使用するように構成されている MIB を含む場合は、SNMP ユーザーを定義します。SNMP ユーザーは Solaris OS ユーザーと同じユーザーではありません。SNMP ユーザーは既存の OS ユーザーと同じユーザー名を持つ必要はありません。

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

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

clsnmpuser [subcommand] [options] [operands]

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

このコマンドの各オプションには、長い形式と短い形式があります。各オプションの両方の形式は、OPTIONS セクションにオプションの説明とともに記載されています。

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

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

サブコマンド

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

create

ユーザーを作成し、指定されたノードの SNMP ユーザー構成に追加します。

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

SNMP ユーザー を作成するクラスタノードを指定するには、このサブコマンドとともに –n オプションを使用します。–n オプションを指定しない場合は、ユーザーが作成され、現在のノード上の SNMP 構成にのみ追加されます。

clconfiguration ファイル内に構成されているすべてのユーザーを作成および追加するには、–i オプションと –n オプションを使用します。

作成している SNMP ユーザーに認証タイプを割り当てるには、–a オプションを指定します。

SNMP ユーザーのパスワードは、–f オプションを指定することで含められます。–i オプションを使用している場合は、–f オプションが必要です。

–i オプションを指定した場合は、clconfiguration(7CL) ファイルの構成情報が使用されます。–i オプションを指定すると、正符号の + オペランドまたはユーザーのリストも指定できます。

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

delete

SNMPv3 ユーザーを指定されたノードから削除します。

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

delete サブコマンドを使用してユーザー名だけを指定すると、このサブコマンドは、そのユーザーのすべてのインスタンスを削除します。認証タイプ別にユーザーを削除するには、–a オプションを使用します。–n オプションを使用しないと、ユーザーは現在のノードからのみ削除されます。

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

export

SNMP ユーザー情報を指定されたノードからエクスポートします。

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

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

–a オプションを使用して、特定の認証タイプのユーザーだけの出力を提供することもできます。1 人以上のユーザーをオペランドとして指定すると、出力は指定したユーザーについての情報に制限されます。

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

list

指定されたノードで構成されている SNMPv3 ユーザーのリストを出力します。

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

デフォルトでは、list サブコマンドは指定されたノード上のすべての SNMPv3ユーザーを表示します。デフォルト SNMP ユーザーだけを表示するには、–d オプションをオペランドなしで指定します。指定した認証タイプに出力を制限するには、–a オプションを使用します。

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

set

指定されたノード上のユーザーの構成を変更します。

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

–n オプションを指定しないと、現在のノード上でのみユーザーの構成が変更されます。

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

set-default

デフォルトの SNMP ユーザーの名前と MIB がトラップ通知を送信するときに使用されるセキュリティーレベルを指定します。

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

セキュリティーレベルを指定するには、–l オプションを使用します。

MIB が SNMPv3 を使用するように構成されている場合は、具体的なユーザー名とトラップを認証するセキュリティーレベルを指定します。構成が複数のユーザーを含む場合は、MIB がトラップ通知を送信するときに使用するデフォルトユーザーを指定します。

構成が 1 人のユーザーしか含まない場合は、そのユーザーが自動的にデフォルトの SNMP ユーザーになります。デフォルトの SNMP ユーザーが削除されると、存在する場合は別の既存のユーザーがデフォルトになります。

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

show

指定されたノード上のユーザーについての情報を出力します。

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

デフォルトでは、show サブコマンドはそのノード上のすべてのユーザーについての情報を表示します。デフォルトの SNMP ユーザーについての情報だけを表示するには、オペランドを指定せずに –d オプションを指定してください。特定の認証タイプに出力を制限するには、–a オプションを使用します。–n オプションを使用しないと、このコマンドは現在のノードのユーザー情報だけを表示します。

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

オプション

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

–?
–-help

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

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

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

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

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

–a authentication
–-authentication authentication

ユーザーの承認に使用する認証プロトコルを指定します。認証プロトコルの値は、SHA または MD5 です。

–d
–-default

MIB がトラップ通知を送信するときに使用されるデフォルトの SNMP ユーザーを指定します。

–f passwdfile
–-file passwdfile

1 つ以上の SNMP ユーザーパスワードを含むファイルを指定します。新しいユーザーを作成する際にこのオプションを指定しないと、コマンドはパスワードを求めるプロンプトを表示します。このオプションは、create サブコマンドとともに使用するときにのみ有効になります。

ユーザーパスワードは次の形式で別々の行で指定します。

user:password

パスワードには次に示す文字または空白文字を含めることはできません。

  • ; (セミコロン)

  • : (コロン)

  • \ (バックスラッシュ)

  • \n (改行)

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

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

–l seclevel
–-securitylevel seclevel

ユーザーのセキュリティーレベルを指定します。次に示す値のいずれかを seclevel に指定してください。

  • noAuthNoPriv

  • AuthNoPriv

  • authPriv

SNMP セキュリティーレベルの詳細は、snmpcmd(1) のマニュアルページを参照してください。

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

ノードまたはノードリストを指定します。各ノードはノード名またはノード ID で指定できます。

このコマンドのすべての形式は、このオプションを受け付けます。

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

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

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

–V
–-version

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

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

–v
–-verbose

詳細メッセージと情報を出力します。

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

オペランド

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

+

すべての SNMP ユーザーを指定します。

user

SNMP ユーザー名を指定します。

終了ステータス

指定������オペランド�コマンド��功�る��コマンド�ゼロ (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 SNMPv3 ユーザーの作成

次のコマンドは、新しいユーザー newuser1 を作成し、現在のノード上の構成にそのユーザーを追加します。認証タイプは SHA です。

# clsnmpuser create -a SHA newuser1
Enter password for user 'newuser1':

この例では、作成されるユーザーのパスワードを入力する必要があります。プロセスを自動化するには、–f オプションを使用します。

使用例 2 ユーザーの一覧表示

次のコマンドは、認証タイプが MD5 のすべてのユーザーを一覧表示します。

# clsnmpuser list -a MD5 +
user1
mySNMPusername

正符号 (+) はデフォルトなので、指定してもしなくてもかまいません。

使用例 3 ユーザーの表示

次のコマンドは、現在のノード上のすべてのユーザーのユーザー情報を表示します。

# clsnmpuser show

--- SNMP User Configuration on phys-schost-1 ---

SNMP User Name:                                 newuser1
  Authentication Protocol:                         SHA
  Default User:                                    Yes
  Default Security Level:                          authPriv
使用例 4 ユーザーの認証プロトコルとステータスの変更

次のコマンドは、ユーザー newuser1 の認証プロトコルとデフォルトのユーザーのステータスを変更します。

# clsnmpuser set -a MD5 newuser1
使用例 5 SNMP ユーザーの削除

次のコマンドは、すべての SNMP ユーザーを削除します。

# clsnmpuser delete +

この例では、すべてのユーザーを指定するために正符号 (+) が使用されます。

属性

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

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

関連項目

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

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

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

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

サブコマンド
承認
create
solaris.cluster.modify
delete
solaris.cluster.modify
export
solaris.cluster.read
list
solaris.cluster.read
set
solaris.cluster.modify
set-default
solaris.cluster.modify
show
solaris.cluster.read