1. Oracle Data Integratorのインストールと構成
  2. スタンドアロン・コロケート・エージェントのドメインの構成

7 スタンドアロン・コロケート・エージェントのドメインの構成

標準インストール・トポロジでスタンドアロン・コロケート・エージェントのWebLogicドメインを作成および構成します。

データベース・スキーマの作成

Oracle Data Integratorドメインを構成する前に、このリリースのOracle Fusion Middlewareでの使用について動作保証されているデータベースに、マスター・リポジトリおよび作業リポジトリ(ODI_REPO)スキーマを作成する必要があります。

マスター・リポジトリおよび作業リポジトリ・スキーマの作成の手順に従って必要なスキーマを作成します。

ODI Studioを使用したマスター・リポジトリでのエージェントの作成

物理エージェントは、単一のスタンドアロン・エージェントまたはJava EEエージェントに対応し、トポロジで一意の名前を持つ必要があります。ODI Studioを使用してマスター・リポジトリでODIエージェントを作成します。

起動順序の一部としてエージェントがマスター・リポジトリに接続し、その名前でマスター・リポジトリに定義された物理エージェントがあるか確認します。そのエントリが見つかった場合、エージェントは起動を続行し、起動した後、それ自体のスケジュール済ジョブをすべてリポジトリから読み取って処理を開始します。エージェントに対する物理エージェント・エントリが見つからない場合、起動は失敗します。

ODIエージェントを作成する前に、まずODI Studioを起動してODI Studioでマスター・リポジトリに接続する必要があります。参照:

ODI Studioを使用してマスター・リポジトリで物理エージェントを作成するには:

  1. 左側のナビゲーション・ペインで「トポロジ」タブを選択し、「エージェント」を右クリックしてから「新規エージェント」を選択します。
  2. 次の表に要約するように、新規エージェントの詳細を指定します。
    フィールド 説明

    名前

    エージェント名としてOracleDIAgent1を指定します。

    この名前はシステム・コンポーネント名と一致する必要があります。

    ホスト

    エージェントが稼働しているマシンのIPアドレスまたは名前を入力します。localhostを使用しないでください。

    ポート

    エージェントがリスニングしているポート番号を入力します。

    ノート:

    使用中の環境にクラスタに対するフロントエンドとしてOracle HTTP Serverが機能しているクラスタが含まれている場合、かわりにOracle HTTP Serverホストのホスト名およびポートを指定します。名前は、OracleDIAgent1ではなく、OracleDIAgentにする必要があります。

  3. 「ODI Studio」メニューから「ファイル」→「すべて保存」を選択して変更を保存します。

ドメインの構成

構成ウィザードを使用して、ドメインを作成および構成します。

ドメインを作成するその他の方法の詳細は、『構成ウィザードによるWebLogicドメインの作成』のWebLogicドメインの作成、拡張および管理のためのその他のツールに関する項を参照してください。

構成ウィザードの起動

構成ウィザードを起動して、ドメインの構成を開始します。

構成ウィザードを起動するには:

  1. 次のディレクトリに変更します。

    (UNIX) ORACLE_HOME/oracle_common/common/bin

    (Windows) ORACLE_HOME\oracle_common\common\bin

    ここでORACLE_HOMEは、14c (14.1.2.0.0) Oracleホームになります。

  2. 次のコマンドを入力します。

    (UNIX) ./config.sh

    (Windows) config.cmd

ドメインを作成および構成するための構成ウィザード画面のナビゲート

構成ウィザード画面に必要な情報を入力して、トポロジ用のドメインを作成および構成します。

ノート:

この手順を使用して既存のドメインを拡張できます。この手順の説明では要件が満たされない場合は、その要件に応じた選択を行うか、サポート・ドキュメントで追加の詳細を参照してください。

構成タイプとドメイン・ホームの場所の選択

「構成タイプ」画面を使用して、ドメイン・ホーム・ディレクトリの場所を選択します。Oracleホーム・ディレクトリの外部が適しています。

ドメイン・ホームの場所は、Oracle Fusion Middlewareの理解のOracle Fusion Middlewareの主要ディレクトリのディレクトリ構造に従って、Oracleホーム・ディレクトリの外に配置することをお薦めします。このディレクトリ構造は、ソフトウェアのアップグレードや再インストールが必要になった場合に問題が発生しないようにするのに役立ちます。

ドメイン・タイプおよびドメインのホーム・ディレクトリを指定するには:

  1. 「構成タイプ」画面で、「新規ドメインの作成」を選択します。
  2. 「ドメインの場所」フィールドで、ドメイン・ホームのディレクトリを指定します。

この画面の詳細は、『Oracle Fusion Middleware構成ウィザードによるWebLogicドメインの作成』の構成タイプに関する項を参照してください。

構成テンプレートの選択

「テンプレート」画面で、必要なテンプレートを選択します。

「テンプレート」画面で、次のテンプレートを選択します。

  • Oracle Data Integrator - スタンドアロン・コロケート・エージェント

    このテンプレートを選択すると、次の項目が依存関係として自動的に選択されます。

    • Oracle JRF

    • Oracle Coherenceクラスタ拡張

この画面の詳細は、構成ウィザードを使用したWebLogicドメインの作成のテンプレートを参照してください。

管理者アカウントの構成

「管理者アカウント」画面を使用して、ドメインに対するデフォルトのWebLogic管理者アカウントのユーザー名とパスワードを指定します。

この画面に入力するユーザー名とパスワードは、ノートにとっておいてください。これらの資格証明は、このドメインの管理サーバーの起動とそのサーバーへの接続で、後で必要になります。

ドメイン・モードとJDKの指定

「ドメイン・モードおよびJDK」画面を使用して、本番環境のドメイン・モードおよびJava Development Kit (JDK)を指定します。

「ドメイン・モードおよびJDK」画面では、次の操作を実行します。

  • 「ドメイン・モード」フィールドで、「本番」を選択します。

    ノート:

    WebLogic Server 14.1.2.0.0では、「本番」モードを選択すると、WebLogic Serverは「保護された本番」のセキュリティ構成の一部を自動的によりセキュアな値に設定します。ただし、手動構成を必要とする特定のセキュリティ構成(SSL/TLSなど)があります。『Oracle WebLogic Serverセキュリティの管理』の保護された本番モードの使用に関する項を参照してください。

    よりセキュアなデフォルト設定を無効にする場合は、「セキュア・モードの無効化」を選択できます。こうすると、非SSLリスニング・ポートが有効になります。

    一般的にセキュア本番モードのよりセキュアなデフォルト設定を保持するが、ドメインでデフォルトで有効にするポート(リスニング・ポート、SSLリスニング・ポートまたは管理ポート)を変更する場合は、次の操作を実行できます。
    • 「セキュア・モードの無効化」の選択は解除したままにします
    • 「ドメインのデフォルト・ポートの有効化または無効化」でデフォルトのポート選択を変更します

    詳細は、『Oracle WebLogic Server本番環境の保護』のドメイン・モードがデフォルトのセキュリティ構成に与える影響の理解に関する項を参照してください。

  • 「JDK」フィールドで、Oracle HotSpot JDKを選択します。

この画面の詳細は、『構成ウィザードによるWebLogicドメインの作成』のドメイン・モードとJDKに関する項 を参照してください。
データベース構成タイプの指定

「データベース構成タイプ」画面を使用して、データベースとデータベース・スキーマの詳細を指定します。

「データベース構成タイプ」画面で、「RCUデータ」を選択します。このオプションでは、構成ウィザードに対して、データベースおよびサービス表(STB)スキーマに接続し、ドメインの構成に必要なスキーマのスキーマ情報を自動的に取得するように指示します。

ノート:

この画面で「手動構成」を選択する場合、次の画面で、スキーマのパラメータを手動で指定する必要があります。

「RCUデータ」を選択したら、次のフィールドに詳細を指定します。

フィールド 説明

ホスト名

データベースをホストするサーバーの名前を入力します。

例: examplehost.exampledomain.com

DBMS/サービス

データベースのDBMS名(サービス・タイプ・ドライバを選択している場合はサービス名)を入力します。

例: orcl.exampledomain.com

ポート

データベースがリスニングするポート番号を入力します。

例: 1521

スキーマの所有者

スキーマ・パスワード

データベースのサービス表スキーマに接続するためのユーザー名とパスワードを入力します。これは、RCUの「スキーマ・パスワード」画面でサービス表コンポーネントに入力したスキーマ・ユーザー名とパスワードです(スキーマのパスワードの指定を参照)。

デフォルトのユーザー名はprefix_STBで、prefixは、RCUで定義したカスタム接頭辞です。

Autonomous Transaction Processingデータベース(Autonomous Transaction Processing専用(ATP-D)とAutonomous Transaction Processing共有(ATP-S)の両方)の場合、接続URL文字列オプションのみを使用して接続資格証明を指定し、Autonomous Transaction Processingデータベースの接続資格証明で説明されている次の形式で接続文字列を入力します。

データベース接続情報の指定を完了したら、「RCU構成の取得」をクリックします。「接続結果ログ」の次の出力は、操作が成功したことを示しています。 

Connecting to the database server...OK
Retrieving schema data from database server...OK
Binding local schema components with retrieved data...OK

Successfully Done.

RCUの実行時にインストールされるスキーマの詳細は、リポジトリ作成ユーティリティによるスキーマの作成のサービス表スキーマについてを参照してください。

『Oracle Fusion Middleware構成ウィザードによるWebLogicドメインの作成』のデータベース構成タイプに関する項を参照してください。

JDBCコンポーネント・スキーマ情報の指定

「JDBCコンポーネント・スキーマ」画面を使用してデータベース・スキーマの詳細を指定します。

「JDBCコンポーネント・スキーマ」画面に示される値が、すべてのスキーマに対して適切であることを確認します。前の画面で「RCUデータ」を選択した場合、スキーマ表はすでに適切に移入されている必要があります。

Autonomous Transaction Processingデータベース(Autonomous Transaction Processing専用(ATP-D)とAutonomous Transaction Processing共有(ATP-S)の両方)の場合、「接続URL文字列」オプションのみを使用して接続資格証明を指定し、次の形式で接続文字列を入力します: 

@TNS_alias?TNS_ADMIN=<path of the wallet files, ojdbc.properties, and tnsnames.ora>

接続文字列で、tnsnames.oraにあるデータベース・サービス名としてのTNS_aliasと、TNS_ADMINプロパティを、ウォレット・ファイルojdbc.propertiesおよびtnsnames.oraの場所に渡す必要があります。

Autonomous Transaction Processing専用(ATP-D)データベースの接続文字列の例:

@dbname_tp?TNS_ADMIN=/users/test/wallet_dbname/

Autonomous Transaction Processing共有(ATP-S)データベースの接続文字列の例:

@dbname_tp?TNS_ADMIN=/users/test/wallet_dbname/

高可用性環境の場合は、Oracle RACデータベースのデータ・ソース構成に関する追加情報について、『高可用性ガイド』の次の項を参照してください。

この画面の詳細は、『Oracle Fusion Middleware構成ウィザードによるWebLogicドメインの作成』のJDBCコンポーネント・スキーマに関する項を参照してください。

JDBC接続のテスト

「JDBCコンポーネント・スキーマ・テスト」画面を使用してデータ・ソース接続をテストします。

「ステータス」列に示される緑色のチェック・マークは、テストが成功したことを表します。問題が発生した場合は、この画面の「接続結果ログ」セクションに示されるエラー・メッセージを確認し、問題を修正してから接続テストを再試行してください。

デフォルトでは、スキーマの作成時に指定したパスワードが、各スキーマ・コンポーネントのスキーマ・パスワードです。

この画面の詳細は、構成ウィザードを使用したWebLogicドメインの作成のJDBCコンポーネント・スキーマ・テストを参照してください。

拡張構成の選択

「拡張構成」画面を使用して、ドメイン構成を完了します。

「拡張構成」画面で、次を選択します。

  • 管理サーバー — 管理サーバーのリスニング・アドレスを適切に構成するために必要です。

  • ノード・マネージャ — ノード・マネージャを構成するために必要です。

  • システム・コンポーネント — スタンドアロン・エージェントを構成するために必要です。

オプションで、目的のインストール環境での必要に応じて、使用可能な他のオプションを選択します。このガイドのステップでは、標準インストール・トポロジを説明していますが、異なるステップに従うこともできます。インストール要件が、このガイドの範囲を超える追加のオプションに及ぶ場合には、そのオプションを構成する追加の画面が表示される場合があります。構成ウィザードのすべての画面の詳細は、構成ウィザードによるWebLogicドメインの作成の構成ウィザードの画面を参照してください。

管理サーバーのリスニング・アドレスの構成

「管理サーバー」画面を使用して、「リスニング・アドレス」を選択し、管理サーバー・ポートを構成します。

ノート:

デフォルトのポート値は、ドメインの構成方法によって異なります。「SSLリスニング・ポートの有効化」はデフォルトで有効ですが、デフォルト値は変更される可能性があります。デフォルト値のリストについては、「製品およびコンポーネント別のポート番号」を参照してください。

  1. 管理サーバーの名前を入力します。「名前」フィールドはnullまたは空にできず、特殊文字を含めることはできません。
  2. 「リスニング・アドレス」の横のドロップダウン・リストを選択し、管理サーバーが置かれるホストのIPアドレスを選択するか、単一のIPアドレスにマップされたシステム名またはDNS名を使用します。「すべてのローカル・アドレス」を使用しないでください。
  3. ポート設定を確認します。ドメイン・タイプが「本番」に設定されている場合、「SSLリスニング・ポートの有効化」オプションがデフォルトで有効になります。管理サーバーにサーバー・グループは指定しないでください。

    ノート:

    ポート値は必要に応じて変更できますが、一意である必要があります。異なるポートに同じポート番号が使用されている場合は、構成ウィザードの次のステップに移動できません。

詳細は、構成ウィザードによるWebLogicドメインの作成のリスニング・アドレスの指定を参照してください。

ノード・マネージャの構成

「ノード・マネージャ」画面を使用して、構成するノード・マネージャのタイプおよびノード・マネージャ資格証明を選択します。

ノード・マネージャのタイプとして「ドメインごとのデフォルトの場所」を選択して、ノード・マネージャの資格証明を指定します。

この画面の詳細は、構成ウィザードを使用したWebLogicドメインの作成のノード・マネージャを参照してください。

ノード・マネージャ・タイプの詳細は、『Oracle WebLogic Serverノード・マネージャの管理』のノード・マネージャについてを参照してください。

新しいODIシステム・コンポーネントの作成

「システム・コンポーネント」画面を使用して、新しいODIシステム・コンポーネントを作成します。

「システム・コンポーネント」画面で、「追加」をクリックして、次のようにします。

  1. 「システム・コンポーネント」の下では、デフォルトのODIコンポーネント(OracleDIAgent1)の名前を受け入れるか、好きな名前を指定します。

  2. 「コンポーネント・タイプ」の下では、ドロップダウン・リストから「ODI」が選択されていることを確認します。

この画面の詳細は、『構成ウィザードによるWebLogicドメインの作成』のシステム・コンポーネントに関する項を参照してください。

ODIサーバー・アクセスの構成

「ODIサーバー構成」画面を使用して、ODIサーバーへのアクセスを構成します。

次の表に示すように、ODIサーバーの構成値を設定します。

フィールド 説明

システム・コンポーネント

ODIシステム・コンポーネント(OracleDIAgent1)を選択します。

サーバー・リスニング・アドレス

ODIサーバーがリスニングする必要があるサーバーのIPアドレスを指定します。localhostを使用しないでください。

サーバー・リスニング・ポート

ODIサーバーがリスニングするポート番号を入力します。

スーパーバイザ・ユーザー名

ユーザー名としてSUPERVISORを指定します。

スーパーバイザ・パスワード

スキーマ作成時に指定したスーパーバイザ・ユーザー名を指定します。

優先データソース

デフォルトのOdiMasterRepositoryを使用します。このフィールドを変更しないでください。

この画面上のオプションの詳細は、構成ウィザードによるWebLogicドメインの作成のODIサーバー構成を参照してください。

ノード・マネージャ・ホスト・アドレスの指定

「マシン」画面を使用して、ノード・マネージャが稼働するホストのIPアドレスを選択します。

作成したシステム・コンポーネントは自動的にLocalODIMachineと呼ばれるマシンに割り当てられます。「マシン」画面には、このマシンがすでに作成済であることが示されます。

「ノード・マネージャ・リスニング・アドレス」フィールドで、ノード・マネージャが稼働するホストのIPアドレスを選択します。localhostを使用しないでください。

この画面に示されるオプションの詳細は、構成ウィザードによるWebLogicドメインの作成のマシンを参照してください。

システム・コンポーネントのマシンへの割当

「マシンへのシステム・コンポーネントの割当」画面を使用して、システム・コンポーネントをODIマシンに割り当てます。

「マシンへのシステム・コンポーネントの割当」画面で、システム・コンポーネントOracleDIAgent1がLocalODIMachineに割り当てられていることを確認します。

この画面に示されるオプションの詳細は、構成ウィザードによるWebLogicドメインの作成のマシンへのシステム・コンポーネントの割当を参照してください。

構成の指定内容の確認とドメインの構成

「構成サマリー」画面に、これから作成するドメインの詳細な構成情報が表示されます。

画面上の各項目を検討し、情報が正しいことを確認します。変更するには、「戻る」ボタンをクリックするか、ナビゲーション・ペインの画面を選択していずれかの画面に戻ります。ドメインの作成は、「作成」をクリックするまで開始されません。

この画面上のオプションの詳細は、『Oracle Fusion Middleware構成ウィザードによるWebLogicドメインの作成』の構成サマリーに関する項を参照してください。

ドメイン・ホームと管理サーバーURLの記録

「構成の終了」画面に、構成したばかりのドメインの情報が表示されます。

後で必要になるので、次の項目をノートにとります。

  • ドメインの場所

  • 管理サーバーURL

ドメインの場所はノード・マネージャおよび管理サーバーを起動するスクリプトにアクセスするため、URLは管理サーバーにアクセスするために必要です。

「終了」をクリックして、構成ウィザードを閉じます。

スタンドアロン・コロケート・エージェントへのライブラリの追加

スタンドアロン・コロケート・エージェントを構成した後、必要に応じて追加ライブラリを指定できます。

ODIスタンドアロン・コロケート・エージェントにライブラリを追加するには:

  1. エージェントを起動する前に、環境変数ODI_ADDITIONAL_CLASSPATHを設定して追加のjarsを配置します。たとえば:

    ODI_ADDITIONAL_CLASSPATH=/share/libs/mytool.jar:/share/libs/drivers/mydriver.jar

  2. 次のいずれかの操作を行います。

    • 追加ライブラリをDOMAIN_HOME/libディレクトリにコピーします。ODIスタンドアロン・コロケート・エージェントによって、これらのライブラリがエージェントのクラスパスに自動的に追加されます。
    • DOMAIN_HOME/config/fmwconfig/components/ODI/エージェント名/bin/instance.sh/cmdコマンドを編集して、ライブラリをODI_POST_CLASSPATH変数に追加します。

ノード・マネージャを使用したスタンドアロン・コロケート・エージェントの起動

ノード・マネージャを起動してから、スタンドアロン・コロケート・エージェントを起動します。

ノート:

マスター・リポジトリで物理エージェントをまだ構成していない場合は、「ODI Studioを使用したマスター・リポジトリでのエージェントの作成」を参照してください。

ノード・マネージャの起動

ドメインごとにノード・マネージャを起動するには:

    • (UNIX) DOMAIN_HOME/binディレクトリに移動します。

    • (Windows) DOMAIN_HOME\binディレクトリに移動します。

  2. 次のコマンドを入力します。

    • (UNIX) nohupとnm.outをサンプル出力ファイルとして使用します。 

      nohup ./startNodeManager.sh > LOG_DIR/nm.out&

      ここで、LOG_DIRは、ログ・ファイルを格納するディレクトリの場所になります。

    • (Windows) startNodeManager.cmd

      ノート:

      Windowsオペレーティング・システムでは、ノード・マネージャをスタートアップ・サービスとして、ノード・マネージャを構成することをお薦めします。これによって、システムが再起動されるたびに、ノード・マネージャが自動で起動されます。

      Oracle WebLogic Serverノード・マネージャの管理の起動サービスとしてのノード・マネージャの実行を参照してください。

スタンドアロン・コロケート・エージェントの起動

ノード・マネージャを使用してODIスタンドアロン・コロケート・エージェントを起動するには:

  1. DOMAIN_HOME/binディレクトリに移動します。

  2. エージェントを起動します。

    • (UNIX) ./startComponent.sh OracleDIAgent1

    • (Windows) startComponent.cmd OracleDIAgent1

  3. プロンプトで、ドメインの管理者パスワードを入力します。

エージェントが正常に起動したことを確認するには、ブラウザで次のURLに移動します。

http://examplehost.exampledomain.com:port/oraclediagent

ノード・マネージャなしでのスタンドアロン・コロケート・エージェントの起動

agentコマンドを使用して、ノード・マネージャを使用せずにスタンドアロン・コロケート・エージェントを起動します。

ノード・マネージャなしでスタンドアロン・エージェントを起動するには:

  1. DOMAIN_HOME/binディレクトリに移動します。

  2. エージェントを起動します。

    • (UNIX) ./agent.sh -NAME=OracleDIAgent1

    • (Windows) agent.cmd -NAME=OracleDIAgent1

    -NAMEはすべて大文字で入力する必要があり、エージェントの名前(この例ではOracleDIAgent1)は大文字と小文字を区別します。

構成の確認

すべての構成ステップが完了したら、追加のステップを実行して、ドメインが適切に構成されていることを検証できます。

ドメインが適切に構成されていることを確認するには、「追加ドメイン構成タスクの実行」を参照してください。

ノート:

作業リポジトリ名がデフォルト名WORKREP以外の場合は、パラメータODI_SECU_WORK_REPの値を編集して、実際の作業リポジトリ名をinstance.propertiesファイルに含める必要があります。この追加構成は、スタンドアロン・エージェントとスタンドアロン・コロケート・エージェントの両方に必要です。