付録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