付録G.29　nnmloadattributes.ovpl

SYNOPSIS

nnmloadattributes.ovpl [-h | -help] [-r <true | false>] -t <type> (-f <path & filename of csv file>) | (-s <"csv formatted line">) [-u <username> -p <password>]

DESCRIPTION

nnmloadattributes.ovplは，CSVファイルからカスタム属性をロードします。 外部データストアに定義されている多くのノード，インタフェースまたは物理コンポーネントがあり，NNMiにこれらの属性をロードしたい場合，このコマンドは有用です。ノードについては，NNMiへロードした後に，それらのカスタム属性によってノードをグループ化するためにノードグループ形式を使用することができます。

Parameters

nnmloadattributes.ovplコマンドは，次のオプションをサポートします。

-h | -help

コマンドの使用方法を表示します。

-u <username>

コマンドの実行に必要なNNMiの管理者名を指定します。nnm.propertiesファイルが存在していない限り，これが必要になります。詳細はnnm.propertiesリファレンスページを参照してください。

-p <password>

コマンドの実行に必要なNNMiの管理者パスワードを指定します。nnm.propertiesファイルが存在していない限り，これが必要になります。詳細はnnm.propertiesリファレンスページを参照してください。

-r <true | false>

この引数が値trueで指定されていない場合，既存の属性値は変更されません。

-t <type>

ロード対象のオブジェクトタイプを指定します。"node"，"interface" または "physcomp"です。

-f <path & filename of csv file>

ロードするカスタム属性を含むCSVファイル名（パス名。例：/tmp/csvfile.csv）を指定します。

-s <"csv formatted line">

CSV形式の1行を指定します。小さな変更に対してファイル作成を省略できます。

Syntax of Comma Separated File For Node Attributes

ノードにカスタム属性を追加するときに指定するCSVファイルの構文は次のとおりです。

空の行は無視されます。

"#"で始まる行は無視されます。

• Column 1(A)：Node DNS|IP Address

  ノードのDNS名か，IPアドレスを指定します。このフィールドは必須です。

• Column 2(B)：Attribute Name

  カスタム属性の名前。

• Column 3(C)：Attribute Value

  カスタム属性の値。

追加のカスタム属性の名前と値の組み合わせは，同じ行に指定できます。または，別の行で同じノードを指定します。

例）

192.168.1.1,Location,Building Five Upper,Service Type,eCommerce

192.168.1.1,Asset Tracking,N1234

192.168.2.2,Location,Fort Collins,Service Type,IT,Asset Tracking,F4321

Syntax of Comma Separated File For Interface Attributes

インタフェースにカスタム属性を追加するときに指定するCSVファイルの構文は次のとおりです。

空の行は無視されます。

"#" で始まる行は無視されます。

• Column 1(A)：Node DNS|IP Address

  ノードのDNS名か，IPアドレスを指定します。このフィールドは必須です。

• Column 2(B)：Interface Id

  前のフィールドで指定したノードのインタフェースの識別子を指定します。インタフェースのインデックス，エイリアス，インタフェース名，または説明が指定でき，この順序で検索されます。すべての一致するインタフェースに対して，属性がロードされます。このフィールドは必須です。

• Column 3(C)：Attribute Name

  カスタム属性の名前。

• Column 4(D)：Attribute Value

  カスタム属性の値。

追加のカスタム属性の名前と値の組み合わせは，同じ行に指定できます。または，別の行で同じノードとインタフェース識別子を指定します。

例）

192.168.1.1,1001,Location,Building Five Upper,Service Type,eCommerce

192.168.1.1,1001,Asset Tracking,N1234

192.168.2.2,A1,Location,Fort Collins,Service Type,IT,Asset Tracking,F4321

Syntax of Comma Separated File For PhysComp Attributes

物理コンポーネント（カード/シャーシ）にカスタム属性を追加するときに指定するCSVファイルの構文は次のとおりです。

空の行は無視されます。

"#"で始まる行は無視されます。

• Column 1(A)：Node DNS | IP Address

  ノードのDNS名か，IPアドレスを指定します。このフィールドは必須です。

• Column 2(B)：PhysComp Id

  前のフィールドで指定したノードの物理コンポーネントの識別子を指定します。物理コンポーネントの物理インデックス，名前，または説明が指定でき，この順序で検索されます。 すべての一致する物理コンポーネントに対して，属性がロードされます。このフィールドは必須です。

• Column 3(C)：PhysComp Type

  物理コンポーネントのタイプを識別する名前。"card"と"chassis"が有効なタイプです。

• Column 4(D)：Attribute Name

  カスタム属性の名前。

• Column 5(E)：Attribute Value

  カスタム属性の値。

追加のカスタム属性の名前と値の組み合わせは，同じ行に指定できます。 または，別の行で同じノードと物理コンポーネント識別子，物理コンポーネントタイプを指定します。

例）

192.168.1.1,7,chassis,Location,Building Five Upper,Service Type,eCommerce

192.168.1.1,7,chassis,Asset Tracking,N1234

192.168.2.2,/AmdFE,card,Location,Fort Collins,Service Type,IT,Asset Tracking,F4321

Error Codes

問題を特定するのに役立ついくつかのエラーコードがあります：

• INFO：情報メッセージ。

• ATTR_ERROR：指定された属性で問題が見つかりました。

• DEL_FAIL_ERROR：指定された属性の削除に失敗しました。

• OBJECT_ERROR：指定されたオブジェクトが見つかりませんでした。

• BAD_LINE_ERROR：指定された行のフォーマットが正しくありません。

• IO_ERROR：CSVファイルが見つからないか，読めませんでした。

• BAD_NAME_WARNING：指定された属性名が長すぎます(最大50文字)。

• BAD_VALUE_WARNING：指定された値が長すぎます(最大2000文字)。

EXAMPLES

CSVファイル(/tmp/test.csv)の内容例は次のようになります (ノードの場合)：

192.168.2.2,Location,Fort Collins,Service Type,IT,Asset Tracking,F4321

CSVファイルからノードのカスタム属性を既存の値を上書きしてロードする場合：

nnmloadattributes.ovpl -t node -f /tmp/test.csv -r true

コマンドに指定したノードのカスタム属性を一つロードする場合：

nnmloadattributes.ovpl -t node -s "192.168.1.1,Project,IT Update of Building Five"

CSVファイル(/tmp/test.csv)の内容例は次のようになります(インタフェースの場合)：

192.168.2.2,A1,Location,Fort Collins,Service Type,IT,Asset Tracking,F4321

CSVファイルからインタフェースのカスタム属性を既存の値を上書きしてロードする場合：

nnmloadattributes.ovpl -t interface -f /tmp/test.csv -r true

コマンドに指定したインタフェースのカスタム属性を一つロードする場合：

nnmloadattributes.ovpl -t interface -s "192.168.1.1,1001,Project,IT Update of Building Five"

CSVファイル (/tmp/test.csv) の内容例は次のようになります(物理コンポーネントの場合)：

192.168.2.2,7,chassis,Location,Fort Collins,Service Type,IT,Asset Tracking,F4321

CSVファイルから物理コンポーネントのカスタム属性を既存の値を上書きしてロードする場合：

nnmloadattributes.ovpl -t physcomp -f /tmp/test.csv -r true

コマンドに指定した物理コンポーネントのカスタム属性を一つロードする場合：

nnmloadattributes.ovpl -t physcomp -s "192.168.1.1,/AmdFE,card,Project,IT Update of Building Five"

AUTHOR

nnmloadattributes.ovpl was developed by Micro Focus.

FILES

• Windows：%NNM_BIN%\nnmloadattributes.ovpl

• Linux：$NNM_BIN/nnmloadattributes.ovpl

SEE ALSO

nnmdeleteattributes.ovpl, nnmloadnodegroups.ovpl, nnm.properties.