コマンドセットの移行 ( CmdSetMigration )

オンライン編集

新規ドライバーのインストール後にコマンド・セットを更新するには、 CmdSetMigration ユーティリティーを使用します。 CmdSetMigration ユーティリティーを実行するには、 icosutil ユーティリティーの実行時に CmdSetMigration キーワードを指定します。 このキーワードは、コマンド行で指定されたオプションを使用して CmdSetMigration ユーティリティーを実行します。

構文

./icosutil CmdSetMigration -f /opt/IBM/tivoli/netcool/ncm/config/properties/
cmdSetMigration.properties

説明

CmdSetMigration ユーティリティーは、 cmdSetMigration.properties ファイルに指定された基準に基づいて、ドライバーが更新されたコマンド・セットを評価します。 デフォルトでは、 cmdSetMigration.properties ファイルは /opt/IBM/tivoli/netcool/ncm/config/properties ディレクトリーにあります。

コマンド・セット・マイグレーション・ツールは、ドライバーの更新後に使用する必要があります。 このツールは、更新されたドライバーで作成されたコマンド・セットを検査し、最新のドライバー・スキーマで使用するためにコマンド・セットがまだ有効であることを検証します。 コマンド・セット XML を最新のスキーマに照らして検証します。 コマンド・セット XML が有効でなくなると、問題のあるノードがコマンド・ラインに報告され、そのコマンド・セットは GUI で非互換としてマークされます。 この方法でマークされたコマンド・セットは再作成する必要があります。 コマンド・セット XML がまだ有効である場合、将来オープンまたは編集されるときに、最新バージョンのドライバー/スキーマを使用するようにコマンド・セットがツールによってマイグレーションされます。

CmdSetMigration ユーティリティーは、以下の基準に基づいてコマンド・セットを更新できます。

  • realm
  • subrealmsFlag
  • realmCmdSetnameFilter
  • realmVendorFilter
  • realmTypeFilter
  • realmModelFilter
  • realmOsFilter
  • reportOnlyFlag
  • performOldSchemaComparisons

パラメーター

CmdSetMigration
CmdSetMigration ユーティリティーを実行するように icosutil ユーティリティーに指示するキーワードを指定します。 CmdSetMigration ユーティリティーは、 cmdSetMigration.properties ファイルに指定された基準に基づいてコマンド・セットの更新を続行します。
-f
CmdSetMigration キーワードを使用する場合にファイル・オプションを指定します。
cmdSetMigration プロパティ
ドライバーが古いコマンド・セットを更新するために CmdSetMigration ユーティリティーが使用する基準を定義する cmdSetMigration.properties ファイルを指定します。

cmdSetMigration.properties は、特定のレルム内のコマンド・セット、特定の VTMOS を持つコマンド・セット、または特定の名前を持つコマンド・セットに対して実行するように更新できます。 このファイル内の performOldSchemaComparisons フラグを使用して、記述が変更されたノードを検査できます。 ユーザーがこのシナリオでコマンド・セットの検証に失敗しないようにするには、このフラグを false に設定したままにします。

以下に、ツールの実行時に発生する可能性があるエラーの例を 2 つ示します。

1秒.
ERROR: Xpath "configuration||interfaces||interface_20sp-  
||unit||service-domain||inside" not found in schema
これは、このノードが新しいスキーマに存在しなくなったことを意味します。 ノードの名前が変更されたか、移動されたか、新規スキーマから完全に削除された可能性があります。
2
ERROR: Invalid value "64000" found for element at xpath "configuration||  
logging||buffered||ARG.002" with description "0-7 -  Logging severity level"
これは、このノードの値が新しいスキーマで有効でなくなったか、新しい妥当性検査が追加されたか、既存の妥当性検査が変更された可能性があることを意味します。

ユーザーによっては、コマンド・セットの一部が非常に大きいためにツールがメモリー不足になることがあります。その場合は、 /opt/IBM/tivoli/netcool/ncm/bin/icosutil を編集し、 MAXHEAP を大きい値 e.g.: MAXHEAP=-Xmx1024m を MAXHEAP=-Xmx1750mに変更することで、ツールのメモリーを増やすことができます。