機械翻訳について
  1. IBM Tivoli Netcool/OMNIbus REST Connectorインストールおよび構成ガイド
  2. コネクタのインストール

2 コネクタのインストール

この章の以降の項では、次の項目について説明します。

前提条件

IBM Tivoli Netcool/OMNIbus RESTイベント・コネクタは、IBM Tivoli Netcool/OMNIbusのREST APIを介して通信します。 IBM Tivoli Netcool/OMNIbus RESTイベント・コネクタを使用する前に、次の前提条件を満たしていることを確認してください:

  • IBM Tivoli Netcool/OMNIbusでHTTPインタフェースを有効にするには:

    1. ObjectServerプロパティに移動し、NRestOS.Enableをtrueに設定

    2. HTTPを使用する場合は、次のプロパティも設定します:

      • NHttpd.EnableHTTPからtrue
      • NHttpd.ListeningPortから<port>

    3. HTTPSを使用する場合は、次のプロパティも設定します:

      • NHttpd.SSLEnableからtrue
      • NHttpd.SSLListeningPortから<port>
      • NHttpd.SSLCertificateから<certificate label>
      • NHttpd.SSLCertificatePwdから<password>

    ノート:

    ObjectServer HTTPインタフェースの有効化の詳細は、「ObjectServerでのHTTPインタフェースおよびOSLCインタフェースの有効化」を参照してください

  • My Oracle Supportの優先資格証明が設定されていること。 資格証明を設定するには、次のステップを実行します。

    1. Enterprise Managerコンソールの「設定」メニューから「My Oracle Support」、「資格証明の設定」の順に選択します。
    2. ユーザー名とパスワード情報を入力し、「適用」をクリックします。
    3. Enterprise Managerコンソールの「設定」メニューから「拡張性」、「自己更新」の順に選択します。
    4. 「自己更新」ページで、表リストのIBM Tivoli Netcool/OMNIbus RESTイベント・コネクタを探します。 表示されていない場合は、次のステップに進みます。
    5. 次の図に示すように、「更新の確認」をクリックして、コネクタのメタデータを収集するジョブをスケジュールします。

    コネクタの前提条件のインストール

    ノート:

    「自己更新」はオフライン・モードでも設定できます。 詳細は、「Oracle Enterprise Manager Cloud Control管理者ガイド」の「オフライン・モードでの更新の適用」を参照してください。

Enterprise Managerへのコネクタのインストール

この項では、コネクタをダウンロードしてインストール(適用)するために必要な手順を説明します。 IBM Tivoli Netcool/OMNIbus RESTイベント・コネクタはすぐに使用できないため、Oracle Enterprise Managerストアからダウンロードする必要があります。 Enterprise Managerストア内のすべてのコネクタは「自己更新」ページからダウンロードできます。

コネクタをインストール(適用)するには:

  1. Enterprise Managerコンソールの「設定」メニューから「設定」を選択し、「拡張性」、「自己更新」の順に選択します。

  2. 「タイプ」列の「管理コネクタ」リンクをクリックします。 IBM Tivoli Netcool/OMNIbus RESTイベント・コネクタが、「使用可能」のステータスでリストに表示されます。

  3. 適切なIBM Tivoli Netcool/OMNIbus RESTイベント・コネクタをクリックして選択し、「ダウンロード」をクリックします。

    ダウンロードを実行する時期を決定できる「スケジュール・ダウンロード」ウィンドウが表示されます。

  4. すぐにダウンロードするには、「選択」をクリックします。

    後でダウンロードするようにスケジュールする場合は、ダウンロードを実施する日時を指定し、「選択」をクリックします。 その場合は、スケジュールしたダウンロード日時より後に、この手順に戻って残り部分を完了する必要があります。

  5. 必要に応じて、コネクタのステータスが「ダウンロード済」に変わるまで画面をリフレッシュします。

  6. IBM Tivoli Netcool/OMNIbus RESTイベント・コネクタをクリックして選択し、「適用」をクリックします。

    操作の確認を求めるプロンプトに応答すると、リクエストが送信されたことを示すページが表示されます。

  7. コネクタのステータスが「適用スケジュール済み」から「適用」に変わるまで、画面をリフレッシュします。

コネクタ・インスタンスの作成

IBM Tivoli Netcool/OMNIbus RESTイベント・コネクタを使用するには、このコネクタ・タイプのインスタンスを1つ以上作成する必要があります。 コネクタ・インスタンスは、コネクタの構成済インスタンスを、コネクタ名、Webサービス・エンドポイントなど、Tivoli Netcool/OMNIbusインスタンスの詳細とともに参照します。 同じコネクタ・タイプの複数のコネクタ・インスタンスがサポートされており、Enterprise Managerで複数のTivoli Netcool/OMNIbusインスタンスを構成できる柔軟性があります。

たとえば、Enterprise Managerは本番ターゲットおよびテスト・ターゲットを監視しているので、コネクタのインスタンスを2つ作成して、本番ターゲットのインシデントが1つめのコネクタ・インスタンスでチケットを作成し、テスト・ターゲットのインシデントが2つめのコネクタ・インスタンスでチケットを作成するようにEnterprise Managerを構成することができます。

コネクタ・インスタンスを作成するには、次の手順を実行します。

  1. Enterprise Managerコンソールで、「設定」をクリックします。
  2. ペインで拡張性を選択します。
  3. 左ペインで「管理コネクタ」を選択します。
  4. 「コネクタの作成」ドロップダウン・リストからコネクタ・タイプを選択して、実行ボタンをクリックします。

  5. 次の画面で、コネクタの名前と説明を入力し、「OK」をクリックします。

    次の図に示すように、コネクタ・インスタンスが「管理コネクタ」ページに未構成として表示されます。


管理コネクタ・パネル

コネクタの構成

基本的な構成の場合、次のステップを実行します。

  1. スーパー管理者として、Enterprise Managerコンソールで「設定」をクリックします。

  2. 拡張性」、「管理コネクタ」の順にクリックします。

    「管理コネクタ」ページには、すべての作成済コネクタ・インスタンスのリストが表示されます。

    ノート: 緑色のチェックマークが付いたステータス列は、コネクタがすでに構成されていることを示します。

  3. IBM Tivoli Netcool/OMNIbus RESTイベント・コネクタの「構成」ボタンをクリックします。 「管理コネクタの構成」ページの「一般」タブが表示されます。
  4. 必要な設定を行います。 詳細は、「一般設定の指定」を参照してください。
  5. 「OK」をクリックします。

  6. 「管理コネクタ」ページが再度表示されます。 IBM Tivoli Netcool/OMNIbus RESTイベント・コネクタの行では、次の図に示すように、ステータス列にチェック・マークが付いている必要があります。

ノート:

Netcool/OMNIbusとEnterprise Manager間の接続を確立するためのプロトコルとしてHTTPSを選択した場合は、「HTTPSのSSLの有効化」で指定されたステップを実行していることを確認してください。


管理コネクタの確認メッセージ

コネクタの有効化と無効化

システムからコネクタを再構成または削除することなく、コネクタ・インスタンスを有効または無効にできます。

「管理コネクタ」ページからコネクタを有効化または無効化するには、コネクタを選択し、「有効化」または「無効化」ボタンをクリックします。 コネクタが無効化されると、「ステータス」列の下に xアイコン アイコンが表示されます。 デフォルトでは、コネクタ・インスタンスが構成されるとすぐに有効になります。

ノート:

イベントの転送には、有効なコネクタのみを使用できます。

一般設定の指定

ここからの各項では、次の図に示す「管理コネクタの構成」ページの「一般」タブで各種構成の詳細を指定する方法について説明します。


コン・ネスト設定パネル

IBM Tivoli Netcool/OMNIbus REST Event Connectorは、IBM Tivoli Netcool/OMNIbusのREST APIを介してNetcool/OMNIbusと通信します。 次のすべてのフィールドは必須です。

  • Webサービス・エンドポイント: IBM Tivoli Netcool/OMNIbusでアラートを作成および更新するときに使用するURL。

    IBM Tivoli Netcool/OMNIbusのwebサービスがHTTPまたはHTTPSのどちらを使用して設定されているかに基づいて、両方の操作のURLを変更します。

    HTTPの場合:

    • プロトコルをhttpsからhttpに変更します。
    • URLの[Hostname]をIBM Tivoli Netcool/OMNIbusシステムのホスト名またはIPアドレスに置き換えます。
    • ポート番号を8443から8080に変更します。
    • URLの[Hostname]を、IBM Tivoli Netcool/OMNIbusのwebサービスがインストールされたシステムのホスト名またはIPアドレスに置き換えます。

    HTTPSの場合:

    • URLの[Hostname] を、IBM Tivoli Netcool/OMNIbusのwebサービスがインストールされたシステムのホスト名またはIPアドレスに置き換えます。

    ノート:

    使用されているポートがデフォルトではない可能性があります。 ObjectServerで、「前提条件」で定義されているポート番号を確認します。

    例:

    ホスト名がomnibusのシステムにIBM Tivoli Netcool/OMNIbusがインストールされている場合は、次のURLがさまざまなプロトコルに構成されます:

    HTTPの場合: 
    http://omnibus:8080/objectserver/restapi/alerts/status
    HTTPSの場合: 
    https://omnibus:8443/objectserver/restapi/alerts/status/kf/#EVT_ID#

  • Omnibusユーザー名: IBM Tivoli Netcool/OMNIbusにアクセスするユーザーのユーザー名。

  • Omnibusパスワード: IBM Tivoli Netcool/OMNIbusにアクセスするユーザーのパスワード。

再試行

コネクタ構成ページにある「再試行」セクションでは、失敗した操作を構成可能な有効期限内に再試行する必要があるかどうかを指定できます。

「再試行」オプションを有効にすると、作成リクエストまたは更新リクエストが初めて失敗した場合にそのリクエストを再送信するかどうかを指定し、さらに再試行の破棄を開始するまでの期間を指定できます。 Enterprise Managerは、リクエストが正常に完了するか、または再試行間隔が経過するまで、5分ごとに再試行します。

デフォルトでは、「再試行」は無効化されています。 この設定は、Netcool/OMNIbusコネクタが処理するすべてのイベントに適用されます。 再試行間隔では、時間数を1や2のように任意の整数値として指定できます。

イベント・テンプレートの使用

Enterprise Managerでコネクタ・インスタンスを作成すると、関連するすべてのテンプレートをチケットの作成または更新操作に使用できます。

次の各項では、イベント・テンプレートの追加、表示、削除および置換について説明します。

イベント・テンプレートの追加

イベント・テンプレートは、Enterprise Managerで認識される前に追加する必要があります。 コネクタは、コネクタ・インスタンスが作成されたときに自動的に登録される即時利用可能なテンプレートを提供します。 これらを編集する場合は、Enterprise Managerで直接編集できます。 ただし、新規の(即時利用可能のものではない)テンプレートを使用する必要がある場合は、emctlコマンドを使用して新規のテンプレートを登録する必要があります。 そうすれば、Enterprise Managerでテンプレートを編集できます。 詳細は、「テンプレートの編集」を参照してください。

テンプレートを追加して登録するには:

  1. emctlに対する実行権限と、イベント・テンプレートを読み取る機能があることを確認します。
  2. テンプレートごとに、次のemctl register_template connectorコマンドを実行します。
$ORACLE_HOME/bin/emctl register_template connector
[-t<template.xml>]
[-repos_pwd <repos password>]
[-cname <connectorName>]
[-iname <internalName>]
[-tname <templateName>]
[-ttype <templateType>]
[-d <description>]

説明:

-t Template(full path)
-repos_pwd   Enterprise Manager Root (SYSMAN) Password
-cname Connector Name
-iname Template Internal Name
-tname Template Name Displayed
-ttype Template Type
       <templateType> 1 - inbound transformation
       <templateType> 2 - outbound transformation
       <templateType> 3 - XML outbound transformation
-d Description

例2-1 テンプレートの登録

次のコマンドは、Omnibus Connector Instanceという名前のコネクタ・インスタンスの新しいアウトバウンド・テンプレート(newTemplate.xsl)を追加します:

emctl register_template connector
-t <template.xml>
-repos_pwd <repos password>
-cname "Omnibus Connector Instance"
-iname "newTemplate"
-tname "newTemplateOutbound"
-ttype 2
-d "Demo template"

テンプレート・コードの表示

テンプレート・コードを表示するには、次の手順を実行します。

  1. コネクタ・インスタンスを選択し、「管理コネクタの構成」ページに移動します。
  2. 次の図に示すように、「テンプレート」タブを選択します。
  3. テンプレートのXSLTコードを表示するには、テンプレート名か「表示」をクリックします。

イベント・テンプレートはXSLT形式です。 コードを理解するには、XSLTの基礎知識が必要です。


管理コネクタのテンプレート・パネル

テンプレートの削除

テンプレートを削除するには、次の手順を実行します。

  1. コネクタ・インスタンスを選択し、「管理コネクタの構成」ページに移動します。
  2. 「テンプレート」タブを選択します。
  3. テンプレートを選択して「削除」をクリックします。
  4. 「はい」をクリックして削除操作を確認します。

ノート:

削除するテンプレートにインシデント・ルールが関連付けられている場合は、削除後、この特定のインシデント・ルールに対するチケット発行が機能しなくなります。

テンプレートの編集

テンプレートは、EM CLIコマンドライン・インタフェースを使用するかわりに、Enterprise Managerコンソールを使用することで直接編集できます。

  1. コネクタ・インスタンスを選択し、「管理コネクタの構成」ページに移動します。
  2. 「テンプレート」タブを選択します。
  3. テンプレートを選択して「編集」をクリックします。
  4. 必要に応じて「説明」および「テンプレート・コンテンツ」フィールドを編集し、「保存」をクリックします。

イベント・テンプレートは自動的に登録されます。 登録されているテンプレートを保存すると、リポジトリ内でテンプレートが更新されます。

テンプレートのリストア

テンプレートの編集後またはカスタマイズ後に、Enterprise Managerを使用して次のステップを実行すると、テンプレートは以前のデフォルト・コンテンツに必要に応じてリストアできます。

ノート:

編集またはカスタマイズした可能性のある即時利用可能なテンプレートは、そのテンプレートのデフォルト値にリストアできます。
  1. コネクタ・インスタンスを選択し、「管理コネクタの構成」ページに移動します。
  2. 「テンプレート」タブを選択します。
  3. テンプレートを選択して「リストア」をクリックします。
  4. リストアするために表示される確認のページで「はい」をクリックします。

コネクタのアンインストール

コネクタをアンインストールするには、定義されているコネクタのインスタンスをすべて削除した後に、コネクタを「自己更新」ページから削除する必要があります。

  1. 「設定」メニューで、「拡張性」、「管理コネクタ」の順に選択します。
  2. 削除するコネクタのインスタンスを選択し、「削除」をクリックします。
  3. 「確認」ページで、「はい」をクリックします。
  4. コネクタのすべてのインスタンスが削除されるまでステップ2と3を繰り返します。
  5. 「設定」メニューで、「拡張性」、「自己更新」の順に選択します。
  6. 「タイプ」列の「管理コネクタ」リンクをクリックします。 管理コネクタの最新のリストが表示されます。
  7. 削除するコネクタをクリックし、「アクション」、「削除」の順に選択します。 「更新の削除」ウィンドウが表示されます。
  8. 「削除」をクリックしてコネクタを削除します。 確認を求めるポップアップ・ウィンドウが表示されます。
  9. 「OK」をクリックして、コネクタの削除を確定します。