DLA の構成

ディスカバリー・ライブラリー・アダプター (DLA) には、接続先のデータ・ソースを決定するための構成プロパティー・ファイル、 照会するドメイン、ディスカバリー・ライブラリー・ブックのターゲット・ディレクトリー、 およびロギング・パラメーターが必要です。

DLA プロパティーを構成する必要があるのは、別の GUI サーバーを保持している場合、または インストール時に指定されたデフォルト以外の別の NCIM インスタンスを DLA で使用する場合です。

事前構成された ncp_dla.properties 構成ファイルは、DLA インストール・ディレクトリーの $NMGUI_HOME/adapters/ncp_dlaにあります。 構成ファイル内にある 'XXXXXX' または<'word'>は、ユーザーがパラメーターを指定する必要があることを示しています。 構成ファイルでは、ほとんどのオプションに便利なデフォルト値が提供されていますが、 環境に適した値に置き換える必要があります。

注: デフォルトでは、DLA を使用するために必要な NCIM アクセス・パラメーターは、 Network Manager GUI アクセス・プールから派生します。 この設定は ncp.dla.datasource.autoConnect パラメーターで指定されており、 デフォルト値は true です。 この値を false に変更する場合は、ステップ 7にリストされているパラメーターの値を指定する必要があります。 接続プールにアクセスできない場合、またはインストール時に設定されるデフォルト以外の NCIM インスタンスを使用する場合、NCIM データベースへの接続を手動で設定すると便利です。
  1. $NMGUI_HOME/adapters/ncp_dla に移動し、 ncp_dla.properties ファイルの名前にドメイン名を付加して、そのファイルをドメイン固有のバージョンにコピーします (例: ncp_dla.properties.NCOMS)。
  2. ncp.dla.precisionDomain プロパティーに値を割り当てることにより、 Network Manager ドメイン・ネームを指定します。
    デフォルトのドメイン名は NCOMS です。
  3. オプション: DLA のクロスドメイン・インベントリーを有効にするには、以下のプロパティーを構成します。

    このプロパティーを trueに設定します。

    ncp.dla.crossDomains=true

    1 つ以上のドメインをコンマ区切りリストで追加します。

    
ncp.dla.crossDomains=Domain1,Domain2
    制限事項制限：クロスドメインのインベントリ情報を取得するには、クロスドメインディスカバリを有効にし、少なくとも2回のクロスドメインディスカバリを実行する必要がある。
    V4.2 フィックスパック21：注： Fix Pack 21では、 -genmore コマンドラインオプションがクロスドメインの検出に対応しています。 このコマンドは ComputerSystem用のスタックスイッチを含むエンティティを生成します。
  4. オプション: オペレーティング・システムのデフォルトの一時ディレクトリーを使用しない場合は、出力の生成時に DLA が使用する一時ディレクトリーへのパスを設定できます。 ncp.dla.scratchDirectory パラメーターを使用して、一時ディレクトリーへの絶対パスを設定します (例: ncp.dla.scratchDirectory=/opt/space/temp)。 DLAは存在しない限りディレクトリを作成しようとします。
  5. データを生成する対象の CDM オブジェクトを設定します。 ncp.dla.generationFilter パラメーターを使用して、コンマ区切りのリストで値を指定します。 有効な値は、以下のとおりです。
    • ComputerSystem - デバイスの以下のデータを生成します。
      • ComputerSystem
      • SnmpSystemGroup
      • OperatingSystem
      • IpDevice (SNMP アクセス権のないデバイス) の IpInterface
      • ルーター
      • ブリッジ
    • LTE - LTE クラスの以下のデータを生成します。
      • 機能
      • HomogeneousCollection
      • Zone
      • カード
      • NetworkInterface
    • Networking - ネットワークの以下のデータを生成します。
      • L2Interface
      • IpInterface
      • IpV4Address
      • IpV6Address
      • IpNetwork
    • Physical - 物理クラスの以下のデータを生成します。
      • PowerSupply
      • ファン
      • シャーシ
      • センサー
      • PhysicalPackage
      • カード
      • ドーター・カード
    データを生成するには、以下の形式を使用した値を ncp.dla.generationFilter パラメーターに追加する必要があります。
    ncp_dla.generationFilter=ComputerSystem[,data]
    ここで、data はこの手順に示したデータの特定のタイプのいずれかです。
    例:
    • システム・データを生成するには、パラメーターに以下の値を追加します。
      ncp_dla.generationFilter=ComputerSystem
      注: 少なくとも、この値を指定する必要があります。 ncp.dla.generationFilter パラメーターに何も値を指定しない場合、DLA はデータ生成しません。
    • システム・データと LTE データを生成するには、パラメーターに以下の値を追加します。
      ncp_dla.generationFilter=ComputerSystem,LTE
    • システム・データとネットワーク接続に関連するデータを生成するには、パラメーターに以下の値を追加します。
      ncp_dla.generationFilter=ComputerSystem,Networking
  6. オプション： 他システムへのコンテキスト起動に使用する URLを定義できます。 ncp.dla.contextualLaunchURL パラメーターを、この起動に使用するトポロジーの値に設定し、Topoviz トポロジー・サーバーのホスト名およびポートを指定します。 デフォルトでは、ホップ・ビューでの起動が行われます。
    例えば、構造ブラウザーでのコンテキスト起動をセットアップするには、以下のようにします。
    ncp.dla.contextualLaunchURL=https://hostname:16316/ibm/console/ncp_structureview/Launch.do?entityId=
  7. オプション: ncp.dla.datasource.autoConnect の値を false に変更する場合、ディスカバリー・ライブラリー・ブックを生成するために DLA が接続するデータベースを定義する以下のパラメーターを編集して、RDBMS アクセスの詳細を指定します。
    ncp.dla.datasource.type
    RDBMS タイプを指定します。デフォルトは Db2®です。
    • Db2:Db2
    • Oracle:Oracle
    ncp.dla.datasource.driver
    使用する JDBC ドライバーを指定します。
    • Db2:com.ibm.db2.jcc.Db2Driver
    • Oracle:oracle.jdbc.driver.OracleDriver
    ncp.dla.datasource.url
    NCIM database データベースに接続するための JDBC URL を指定します。
    • Db2:jdbc:db2://host_name:port_number/database_name
    • Oracle:jdbc:oracle:thin:@//host_name:port_number/service_name ここで service_nameは、サーバー上で稼動している データベースインスタンスを指す サービス名です。 Oracle Oracle
    ncp.dla.datasource.schema
    NCIM データベース・スキーマ名、通常は ncim
    ncp.dla.datasource.ncpgui.schema
    NCPGUI データベース・スキーマ名、通常は ncpgui
    ncp.dla.datasource.username
    データベース・ユーザー名、通常は ncim
    ncp.dla.datasource.password
    データベース・ユーザー・パスワード
    ncp.dla.datasource.encrypted
    データベース・パスワードを暗号化するかどうか [true|false]
    true に設定する場合は、 ncp.dla.datasource.keyFileに有効な値を指定する必要があります。また、 $NMGUI_HOME/profile/etc/tnm/tnm.properties ファイルで参照される暗号化されたパスワードを使用する必要があります。
    ncp.dla.datasource.keyFile
    $NMGUI_HOME/profile/etc/tnm/tnm.properties ファイルで使用される暗号鍵ファイルの絶対パスと名前を指定します。
    ncp.dla.datasource.loginTimeout
    ログイン・タイムアウト、デフォルトは 5 秒
  8. ncp.dla.refresh.book パラメーターを使用して、DLA が既存のディスカバリー・ライブラリー・ブックをリフレッシュするか、新規作成するかを指定します。 デフォルト・オプションは falseです。このデフォルト・オプションでは、新規インスタンスが作成されます。
    ncp.dla.refresh.book=false
  9. ncp.dla.lte.topology パラメーターを使用して、LTE コントロール・プレーンおよびユーザー・プレーンのトポロジーをエクスポートします。 このオプションは、大規模ネットワークの場合、非常に大量のデータを生成する可能性があります。 生成されるデータのボリュームによっては、TADDM デプロイメント環境に悪影響を及ぼす可能性があります。 デフォルト・オプションは falseです。
    ncp.dla.lte.topology=false
  10. オプション: ncp.dla.network.view パラメーターを設定して、選択したネットワーク・ビューのデータのみをフィルタリングすることにより、データ収集の範囲を 1 つ以上のネットワーク・ビューに制限できます。
    標準の SQL 演算子を使用して、DLA 照会で networkView.name フィールドに付加される SQL セグメントを定義します。 このパラメーターの値は、以下のいずれかの SQL 演算子で始まる必要があります。
    • =
    • <>
    • !=
    • IN
    • NOT IN
    • LIKE
    • NOT LIKE

    例えば、以下は、データ収集の有効範囲として BGP Networks ネットワーク・ビューのみを使用するように有効範囲を定義します。

    ncp.dla.network.view=='BGP Networks'
    注: DLA は二重引用符をサポートしません。 前の例において、最初の等号に続くすべての内容は、2 番目の等号 (=) も含め、定義されている値の一部です。

    以下に、別の例を示します。データ収集の範囲は、Cisco という名前が含まれるすべてのネットワーク・ビューとして定義されています (標準の SQL ワイルドカード文字 % が使用されています)。

    ncp.dla.network.view=LIKE 'Cisco%'
  11. ncp.dla.entity.details パラメーターを使用して、DLA がエンティティー詳細データを照会し、そのデータを拡張属性としてエクスポートするかどうかを指定します。 デフォルト・オプションは falseです。
    ncp.dla.entity.details=false
  12. 署名生成アルゴリズムから特定の MAC アドレスを除外するには、 ncp.dla.signatureGenExcludeMAC パラメーターを使用します。
    これが役立つのは、ネットワーク・デバイス上にある MAC アドレスがネットワーク上で重複しているため、シグニチャー生成プロセスによって同じシグニチャーが不必要に何度も生成されるのを回避する場合です。

    この機能を使用するには、ネットワーク内で重複している可能性がある MAC アドレスごとに、signatureGenExcludeMAC プロパティーを入力する必要があります。 このプロパティーの形式は以下のとおりです。ncp.dla.signatureGenExcludeMAC.n=MAC

    それぞれの意味は以下のとおりです。
    • n は、1 から始まる除外ごとの増分数です。
    • MAC は、シグニチャー生成プロセスから除外する、コロンで区切られた MAC アドレスです。
    例えば、ncp_dla.properties ファイル内のデフォルト値は、以下の MAC アドレスをシグニチャー生成プロセスから除外することを指定します。
    • 00:00:00:00:00:00。これは、すべてゼロのデフォルトの MAC アドレスです。
    • 02:00:00:00:00:04。これは、Juniper fpx1 内部インターフェースの MAC アドレスです。
    • 00:0B:CA:FE:00:00。これは、Juniper bme0 管理インターフェースの MAC アドレスです。
    ncp.dla.signatureGenExcludeMAC.1=00:00:00:00:00:00
ncp.dla.signatureGenExcludeMAC.2=02:00:00:00:00:04
ncp.dla.signatureGenExcludeMAC.3=00:0B:CA:FE:00:00
  13. ncp.dla.signatureOverride パラメーターを使用して、DLA によって使用される署名をデバイスごとに手動で構成します。これにより、自動署名生成がバイパスされます。
    これは、DLA によってエクスポートされたデバイスが TADDM内で適切に調整されない場合 (同じデバイスのシグニチャー属性が異なる場合など) に役立ちます。
    この機能を使用するには、オーバーライド対象のシグニチャーを持つデバイスごとに以下の情報を把握する必要があります。
    1. ネットワーク・マネージャー entityName
    2. TADDM signature
    3. SignatureOverride プロパティー

    このプロパティーの形式は以下のとおりです。ncp.dla.signatureOverride.n=entityName=signature

    それぞれの意味は以下のとおりです。
    • n は、1 から始まるオーバーライドごとの増分数です。
    • entityName は、署名を適用するデバイスの Network Manager entityName です。
    • signature は、IP アドレス(MAC アドレス) または IP アドレスの形式の有効な CDM シグニチャーです。
    注: この機能を使用する場合は、必ず、指定されたデバイスに関連する署名 IP と MAC アドレスを選択する必要があります。
    例えば、デバイス「fred」および「barney」のシグニチャーをオーバーライドするには、以下の構成プロパティーを追加します。
    ncp.dla.signatureOverride.1=fred=172.20.1.6(00:21:28:FF:1A:3A)
ncp.dla.signatureOverride.2=barney=172.20.1.7(00:21:EE:6B:1A:2A)
  14. 以下のパラメーターを指定して、DLA によって生成されたディスカバリー・ライブラリーを転送する方法を指定します。
    ncp.dla.datasink.type
    ディスカバリー・ライブラリー・ブックの転送方法を指定します。 オプションは以下のとおりです。
    FILE
    ディスカバリー・ライブラリー・ブックが、ターゲット・ディレクトリー /opt/IBM/netcool/core/var/precision/ccmdb にローカルにコピーされます。 このオプションを指定する場合は、ステップ 15 をスキップして、ステップ 18に進みます。
    FTP
    ディスカバリー・ライブラリー・ブックは FTP によって リモート・サーバーに転送されます。 このオプションを指定する場合は、ステップ 15 を実行する必要があります。
    ncp.dla.datasink.targetDirectory
    ディスカバリー・ライブラリー・ブック・ファイルのターゲット・ディレクトリー
    注: GUI サーバー以外のサーバーで DLA を実行していて、生成されたブックをそのサーバーに配置する場合は、 ncp.dla.datasink.targetDirectoryの周囲のパラメーターのコメントを外して編集することにより、 ncp_dla.properties ファイルに接続パラメーターを指定できます。
  15. オプション: ncp.dla.datasink.type プロパティーにオプション FTP を指定した場合は、以下の追加パラメーターを指定します。
    ncp.dla.datasink.server
    リモート FTP サーバーの IP アドレスまたはホスト名
    ncp.dla.datasink.port
    使用する TCP ポート、デフォルトは 21
    ncp.dla.datasink.binary
    バイナリー FTP 転送を使用するかどうか [true|false]
    ncp.dla.datasink.passive
    受動の FTP 転送を行うかどうか [true|false]
    ncp.dla.datasink.username
    使用する FTP ユーザー名
    ncp.dla.datasink.password
    使用する FTP ユーザー・パスワード
    ncp.dla.datasink.encrypted
    FTP パスワードを暗号化するかどうか [true|false]
    ncp.dla.datasink.keyFile
    $NMGUI_HOME/profile/etc/tnm/tnm.properties ファイルで使用される暗号鍵ファイルの絶対パスと名前を指定します。
  16. オプション: シャーシ ID で結果をフィルタリングすることで、データ収集の範囲を制限できます。 これを行うには、 ncp.dla.chassis.ids パラメーター内に SQL 照会を指定します。
    ncp.dla.chassis.ids プロパティーを使用してフィルターを指定することで、SQL 照会で返されるエンティティー ID に一致する ComputerSystem レコードのみを取得することができます。
    注: このフィルタリング方式は、対象のシャーシをより正確に指定できるため、 ncp.dla.network.view パラメーターを使用したフィルタリングよりも推奨されます。
    以下に、ネットワーク・エッジにタグ付けされたシャーシ ID を返す SQL 照会の例を示します。
    注: 読みやすくするために、この SQL 照会は複数行にインデントされて表示されます。 ただし、ncp_dla.properties 構成ファイルでは、SQL 照会全体を単一の行に記述する必要があります。そうしないと、操作でエラーが返されます。
    ncp.dla.chassis.ids=SELECT e.mainNodeEntityId 
                    FROM entity e 
                    INNER JOIN domainMgr  d ON d.domainMgrId = e.domainMgrId 
                    WHERE d.domainName = 'NCPPUP' AND EXISTS
                         (SELECT ed.entityId FROM entityDetails ed 
                          WHERE ed.entityId = e.entityId 
                          AND ed.keyName = 'NetworkEdge' 
                          AND ed.keyValue = 1)
                    GROUP BY e.mainNodeEntityId
  17. オプション: ncp.dla.ExcludeModel パラメーターおよび ncp.dla.ExcludeManufacturer パラメーターを使用して、モデルおよび製造元情報を出力から除外できます。
    これらのパラメーターのフォーマットを以下に示します。
    ncp.dla.ExcludeModel.N=MODEL_NAME
ncp.dla.ExcludeManufacturer.N=MANUFACTURER_NAME
    それぞれの意味は以下のとおりです。
    • N は、除外ごとにインクリメントする数値で、1 から開始します。
    • MODEL_NAME は、除外するモデルの名前です。
    • MANUFACTURER_NAME は、除外する製造元の名前です。
    一致した値が出力から抑制されます。
    以下の例は、製造元の Windows および net-snmp を除外する方法を示しています。
    ncp.dla.ExcludeManufacturer.1=Windows
ncp.dla.ExcludeManufacturer.2=net-snmp
  18. オプション: ncp_dla.log.level プロパティーと ncp_dla.trace.level プロパティーの値を指定して、DLA のログとトレースのレベルを指定します。
    ncp_dla.log.level のデフォルトは WARNING です。 ncp_dla.trace.level のデフォルトは ALL です。 以下の値が認められています：
    オプション 説明
    CONFIG

    構成変更を含むすべてのイベントをログに記録します。
    INFO

    システム状態変更のみをログに記録します。 これはデフォルト設定です。
    警告

    復旧可能なシステム・エラーをログに記録します。
    SEVERE

    復旧不能なシステム・エラーをログに記録します。
    FINE

    最小レベルのトレース。 大部分のスタック・トレースはこのレベルに該当し、トレース・ファイルに書き込まれます。 トレース・ファイルには、すべてのログ・メッセージも含まれます。

    注: ロギング・レベルを FINE、FINER、FINEST、または ALL に設定すると、ログ・ファイルとトレース・ファイルの両方に情報が含まれ、トレース・ファイルには、操作のより技術的な詳細に加えて、ログ・ファイルからのすべてのメッセージが含まれます。 上記以外のロギング・レベルに設定した場合、トレース・ファイルは空のままです。
    FINER

    中程度のレベルのトレース。より詳細なデバッグ・メッセージを提供します。
    FINEST

    最大レベルのトレース。非常に詳細な技術情報を生成します。
    ALL

    アプリケーションのロギングとトレースがすべてのレベルで有効になります。
    OFF

    アプリケーションのロギングとトレースがすべて無効になります。
  19. オプション: ncp_dla.log.directory プロパティーの値を指定して、ログ・ファイルとトレース・ファイルが作成されるディレクトリーを指定します。

    デフォルトは /tmp/ncp_dla_logs です。

    注: Network Managerのバージョン 4.2フィックスパック 15 以降では、DLA は GUI コンポーネントと同じロギング・インフラストラクチャーを使用します。 その他のロギングの設定については、 GUIのロギングの設定を参照してください。
  20. 編集した構成ファイルに任意の名前を付けて、ファイルのコピーを作成します。
  21. ディスカバリー・ライブラリー・ブックを作成する Network Manager ドメインごとに、構成のコピーを作成します。
    注意: ディスカバリー・ライブラリー・ブックを生成する Network Manager ドメインごとに構成ファイルを作成し、構成ファイルの名前にドメイン名を付加します (例: ncp_dla.properties.NCOMS)。
IBM Tivoli Application Dependency Discovery Manager GUI を Network Managerから開始する場合は、追加の構成タスクを実行してメニュー・オプションを Network Manager GUI に追加し、JSP インベントリー・レポートを TADDMに追加します。