付録G.38 nnmnodegroup.ovpl
ノードグループおよびノードグループ階層を管理します。
SYNOPSIS
nnmnodegroup.ovpl -h | -help
nnmnodegroup.ovpl -add -group (<name>|<uuid>) [-file <file>|-node <nodeList>] [-deviceType <deviceType>] [-u <username> -p <password>] [-quiet]
nnmnodegroup.ovpl -create -name <name> [-file <file>|-node <nodeList>] [-filter <filter>] [-notes <notes>] [-parent <parent> [-expand (true|false)]] [-uuid <uuid>] [-addToViewFilterList (true|false)] [-calculateStatus (true|false)] [-deviceType <deviceType>] [-u <username> -p <password>] [-quiet]
nnmnodegroup.ovpl -delete -group (<name>|<uuid>) [-u <username> -p <password>] [-quiet]
nnmnodegroup.ovpl -list [-fields <fields>] [-format <format>] [-u <username> -p <password>] [-quiet]
nnmnodegroup.ovpl -listChildGroups -group <group> [-fields <fields>] [-format <format>] [-u <username> -p <password>] [-quiet]
nnmnodegroup.ovpl -listMembers -group (<name>|<uuid>) [-deep] [-fields <fields>] [-format <format>] [-u <username> -p <password>] [-quiet]
nnmnodegroup.ovpl -listParentGroups -group <group> [-fields <fields>] [-format <format>] [-u <username> -p <password>] [-quiet]
nnmnodegroup.ovpl -printNodes <group name> [ -hostName | -shortName | -uuid | -ip ] [-u <username> -p <password>]
nnmnodegroup.ovpl -relate -child <child> -parent <parent> [-expand (true|false)] [-u <username> -p <password>] [-quiet]
nnmnodegroup.ovpl -reload [-u <username> -p <password>] [-quiet]
nnmnodegroup.ovpl -remove -group (<name>|<uuid>) [-file <file>|-node <nodeList>] [-deviceType <deviceType>] [-u <username> -p <password>] [-quiet]
nnmnodegroup.ovpl -unrelate -child <child> -parent <parent> [-u <username> -p <password>] [-quiet]
nnmnodegroup.ovpl -update -group (<name>|<uuid>) [-addToViewFilterList (true|false)] [-calculateStatus (true|false)] [-deviceType <deviceType>] [-filter <filter>] [-name <newName>] [-notes <notes>] [-u <username> -p <password>] [-quiet]
DESCRIPTION
ノードグループおよびノードグループの階層を管理するために,nnmnodegroup.ovplコマンドを使用します。このコマンドによって,ノードグループの作成,更新,および削除や,ノードグループの階層の作成および削除することができます。また,ノードの追加またはノードグループフィルタの設定により,ノードグループに関連付けられているノードを管理することができます。
nnmnodegroup.ovplコマンドは,次を含む,複数の一覧表示の機能を提供します。
-
子ノードグループまたは親ノードグループのどちらかを一覧表示することによって,ノードグループの情報と階層を一覧表示します。
-
ノードグループ内のノードを一覧表示するには,-listMembersオプションを使用します。
-
データベース内のすべてのノードグループを一覧表示するには,-listオプションを使用します。
-printNodesオプションは,特定のノードグループに属するノード属性を出力します。ノード属性を出力する場合,グループ名は必須の引数です。ほかの引数が与えられていない場合,各ノードのホスト名,短縮名,UUID,および管理IPアドレス属性がダンプされます。ノードごとに一つのカンマで行が区切られます。-printNodesオプションは,以前のバージョンのNNMiで提供されていた,非推奨/従来のコマンドであることに注意してください。この使用法は,後方互換性のために残してあります。このため,行頭にダッシュ記号を指定する必要があります。すなわち,-printNodesは動作しますが,printNodesは動作しません。新しいlistMembersオプションはprintNodesに置き換わるものです。
Parameters
nnmnodegroup.ovplコマンドは,次のオプションをサポートします。
- -add -group (<name>|<uuid>) [-file <file>|-node <nodeList>] [-deviceType <deviceType>]
-
ノードグループにノードまたはデバイスタイプのフィルターを追加します。-group に加えて,少なくとも一つの追加の引数を指定する必要があります。
-
- -group (<name>|<uuid>)
-
ノードグループの名前またはUUIDです。
- -file <file>
-
ノード名,UUID,およびIPアドレスを含むテキストファイルです。
- -node <nodeList>
-
ノード名,UUID,およびIPアドレスのカンマ区切りリストです。
- -deviceType <deviceType>
-
ノードグループのノードを選択するために使用します。 デバイスタイプのパラメータは,文字列をコロンで区切ったリストです。各カテゴリの形式は次のとおりです。
category:vendor:family:profile
- -create -name <node group name> [-addToViewFilterList (true|false)] [-calculateStatus (true|false)] [-deviceType <deviceType>] [-expand (true|false)] [-file <file>|-node <nodeList>] [-filter <filter>] [-notes <notes>] [-parent <parent>] [-uuid <uuid>]
-
新しいノードグループを作成します。
-
- -name <name>
-
作成されるノードグループの名前です。
- -addToViewFilterList (true|false)
-
テーブルを表示するときに,ドロップダウンフィルターリストにノードグループが含まれます。
- -calculateStatus (true|false)
-
ノードグループのステータスを計算します。
- -deviceType <deviceType>
-
ノードグループのノードを選択するために使用します。 デバイスタイプのパラメータは,文字列をコロンで区切ったリストです。各カテゴリの形式は次のとおりです。
category:vendor:family:profile
- -expand (true|false)
-
親マップでノードグループを展開します。-parentオプションを指定する必要があります。
- -file <file>
-
ノード名,UUID,およびIPアドレスを含むテキストファイルです。
- -filter <filter>
-
ノードグループ内のノードを選択するために使用されるフィルター式です。属性が式に一致するノードがグループに含められます。
- -node <nodeList>
-
ノード名,UUID,およびIPアドレスのカンマ区切りリストです。
- -notes <notes>
-
ノードグループに添付する注記です。
- -parent <parent>
-
追加しようとしているノードグループが,子ノードグループとして追加される場合の,親ノードグループの名前です。
- -uuid <uuid>
-
ノードグループに割り当てる UUID です。
- -delete -group (<name>|<uuid>)
-
ノードグループを削除します。
-
- -group (<name>|<uuid>)
-
削除するノードグループの名前またはUUIDです。
- -list [-fields <fields>] [-format <format>]
-
データベース内のノードグループの名前を出力します。
-
- -fields <fields>
-
表データを出力するフィールドを選択します。
-
- -format <format>
-
テーブルデータの出力形式を設定します;有効な値はTEXT,LIST,CSVまたはXMLです。
- -listChildGroups -group <group> [-fields <fields>] [-format <format>]
-
指定されたノードグループの子ノードグループを一覧表示します。
-
- -group <group>
-
子ノードグループを一覧表示するためのノードグループ名です。
- -fields <fields>
-
表データを出力するフィールドを選択します。
- -format <format>
-
テーブルデータの出力形式を設定します;有効な値はTEXT,LIST,CSVまたはXMLです。
- -listMembers -group (<name>|<uuid>) [-deep] [-fields <fields>] [-format <format>]
-
指定されたノードグループのノードを出力します
-
- -group (<name>|<uuid>)
-
ノードグループの名前またはUUIDです。
- -deep
-
デフォルトでは,listMembersはノードグループのノードだけを出力します。-deepオプションは,ノードグループのすべてのノードとすべての子ノードグループのノードが一覧表示されます。
- -fields <fields>
-
表データを出力するフィールドを選択します。
- -format <format>
-
テーブルデータの出力形式を設定します;有効な値は TEXT,LIST,CSVまたはXMLです。
- -listParentGroups -group <group> [-fields <fields>] [-format <format>]
-
指定されたノードグループの親ノードグループを一覧表示します。
-
- -group <group>
-
親グループを一覧表示するためのノードグループ名です。
- -fields <fields>
-
表データを出力するフィールドを選択します。
- -format <format>
-
テーブルデータの出力形式を設定します;有効な値はTEXT,LIST,CSVまたはXMLです。
- -printNodes <node group name> [-hostName | -shortName | -uuid | -ip]
-
指定したノードグループに属するノードの属性を出力します。追加のパラメータが指定されていない場合,各ノードのホスト名,短縮名,UUID,および管理IPアドレス属性が出力されます。ノードごとに一つのカンマで行が区切られます。
-
必要に応じて,次のパラメータの一つを指定することができます。指定した属性だけが出力されます。
-
- -hostName
-
ノードグループに属する各ノードのホスト名を出力します。
- -shortName
-
ノードグループに属する各ノードの短縮名を出力します。
- -uuid
-
ノードグループに属する各ノードのUUIDを出力します。
- -ip
-
ノードグループに属する各ノードの管理 IP アドレスを出力します。管理IPアドレスが決定できない場合は,nullが出力されます。
- -relate -child <child> -parent <parent> [-expand (true|false)]
-
親と子の関係を作成するために,別のノードグループにノードグループをリンクします。
-
- -child <child>
-
子ノードグループの名前です。
- -parent <parent>
-
親ノードグループの名前です。
- -expand (true|false)
-
親マップでノードグループを展開します。
- -reload
-
ノードグループのキャッシュを再ロードします。追加ノードのリストまたはノードグループのフィルターを更新することによって,ノードを追加または削除した場合,数分間はキャッシュに変更が反映されないことがあるため,この操作が必要になることがあります。
- -remove -group (<name>|<uuid>) [-file <file>|-node <nodeList>] [-deviceType <deviceType>]
-
ノードグループからノードを削除します。-groupに加えて,少なくとも一つの追加の引数を指定する必要があります。
-
- -group (<name>|<uuid>)
-
ノードグループの名前またはUUIDです。
- -file <file>
-
ノード名,UUID,およびIPアドレスを含むテキストファイルです。
- -node <nodeList>
-
ノード名,UUID,およびIPアドレスのカンマ区切りリストです。
- -deviceType <deviceType>
-
ノードグループのノードを選択するために使用します。 デバイスタイプのパラメータは,文字列をコロンで区切ったリストです。各カテゴリの形式は次のとおりです。
category:vendor:family:profile
- -unrelate -child <child> -parent <parent>
-
子と親のノードグループ間のノードグループ階層を削除します。
-
- -child <child>
-
子ノードグループの名前です。
- -parent <parent>
-
親ノードグループの名前です。
- -update -group (<name>|<uuid>) [-addToViewFilterList (true|false)] [-calculateStatus (true|false)] [-deviceType <deviceType>] [-filter <filter>] [-name <newName>] [-notes <notes>]
-
ノードグループの属性を設定します。-groupに加えて,少なくとも一つの追加の引数を指定する必要があります。
-
- -group (<name>|<uuid>)
-
ノードグループの名前またはUUIDです。
- -addToViewFilterList (true|false)
-
テーブルを表示するときに,ドロップダウンフィルターリストにノードグループが含まれます。
- -calculateStatus (true|false)
-
ノードグループのステータスを計算します。
- -deviceType <deviceType>
-
ノードグループのノードを選択するために使用します。 デバイスタイプのパラメータは,文字列をコロンで区切ったリストです。各カテゴリの形式は次のとおりです。
category:vendor:family:profile
- -filter <filter>
-
ノードグループ内のノードを選択するために使用されるフィルター式です。属性が式に一致するノードがグループに含められます
- -name <newName>
-
ノードグループの名前を,指定したnewNameに変更します。
- -notes <notes>
-
ノードグループに添付する注記です。
- -h | -help
-
コマンドの使用方法を表示します。
- -u <username>
-
コマンドの実行に必要なNNMiの管理者名を指定します。nnm.propertiesファイルが存在していない限り,これが必要になります。詳細はnnm.propertiesリファレンスページを参照してください。
- -p <password>
-
コマンドの実行に必要なNNMiの管理者パスワードを指定します。nnm.properties ファイルが存在していない限り,これが必要になります。詳細はnnm.propertiesリファレンスページを参照してください。
- -quiet
-
通常の出力を抑制し,エラーだけを表示します。
EXAMPLES
"mygroup"という名前のノードグループを作成する場合:
nnmnodegroup.ovpl -create -name mygroup
ノード"a"と"b"を含む"mygroups2"という名前のノードグループを作成する場合:
nnmnodegroup.ovpl -create -name mygroup2 -node "a,b"
親として"mygroup",子として"mygroup2"を持つノードグループ階層を作成する場合:
nnmnodegroup.ovpl -relate -parent mygroup -child mygroup2
ノードグループ"ルーター"に属するすべてのノードのホスト名,短縮名,UUID,および管理IPアドレスを出力する場合:
nnmnodegroup.ovpl -printNodes ルーター
ノードグループ"Non-SNMP Devices"に属するすべてのノードのホスト名だけを出力する場合:
nnmnodegroup.ovpl -printNodes "Non-SNMP Devices" -hostName
データベース内のノードグループ名を一覧表示する場合:
nnmnodegroup.ovpl -list
既存のノードグループの名前を変更し,ステータスの計算をfalseに変更する場合:
nnmnodegroup.ovpl -update -group myGroup -name newName -calculateStatus false
RETURN VALUE
エラーが発生しなかった場合はステータス0(ゼロ),それ以外の場合は1で終了します。
AUTHOR
nnmnodegroup.ovpl was developed by Micro Focus.
FILES
-
Windows:%NNM_BIN%\nnmnodegroup.ovpl
-
Linux:$NNM_BIN/nnmnodegroup.ovpl