機械翻訳について
  1. Oracle Integration 3での統合の使用
  2. 接続エージェントのインストールおよび管理
  3. 接続エージェントのインストール
  4. 接続エージェントのダウンロードとインストール

接続エージェントのダウンロードとインストール

接続エージェントをローカル・ホスト(通常はコンピュータまたは仮想マシン)にダウンロードしてインストールします。 必要に応じて、エージェント・インストーラをバックグラウンド・プロセスとして実行し、ローカル・ホストにセキュリティ証明書をインストールできます。

インストール要件

  • 最小限の権限で接続エージェントをインスタンスにインストールします。 rootとしてインストールしないでください。

  • 実行する必要がある権限で接続エージェントをインストールしてください。

  • 指定した頻度で指定したディレクトリのみをスキャンするように接続エージェントを構成します。

  • Oracle Cloud Infrastructureへの接続エージェント接続のみを許可するようにポートまたはプロキシが正しく設定されていることを確認します。

  • 接続エージェントを正常にインストールした後、インストール・キーを削除します。

エージェントのダウンロードとインストール

インストール中に、Oracle Integrationでエージェント・グループを作成するときに生成したエージェント・グループ識別子に接続エージェントを関連付けます。 接続エージェントをインストールするフォルダへのアクセスを、エージェントを停止および起動する必要があるユーザーのみに制限してください。

接続エージェントには、Oracle Integrationインスタンスへのアクセスに必要な資格証明が事前にシードされています。
前提条件:

  • 1つ以上のエージェント・グループを作成します。 「エージェント・グループの作成」を参照してください。

  • ターゲットIPアドレスに基づいてインターネットへのアクセスを制限する場合は、接続エージェントをインストールする前に、Oracle Integrationランタイムおよび設計時IPアドレスとOracle Identity Cloud Service IPアドレスを許可リストに登録する必要があります。

  • poll/read/writeファイルへのディレクトリ・パスが、エージェント・グループ内の任意のエージェントからアクセスできることを確認する必要があります。

エージェントをダウンロードしてインストールするには:

  1. 接続性エージェントをインストールするために必要なロールと権限があることを確認します。

  2. オンプレミス・ホストに接続エージェントをインストールするためのディレクトリを作成します。

    次の制限に注意してください。

    • /tmpを含むディレクトリ・パスにエージェントをインストールしないでください。

      /tmpにエージェントをインストールすることはできません。 ファイルシステム階層Standardバージョン3.0に従って、/tmpは一時ファイル用です。 インストールおよびエージェントは動作しますが、システムまたはエージェントの仮想マシンを再起動したあとに/tmp内のディレクトリが削除される可能性があるため、エージェントのインストールに関する推奨のロケーションではありません。

    • エージェントのインストールは、SSLプロキシの使用ではサポートされていません。

  3. ナビゲーション・ペインで、「設計」、「エージェント」の順にクリックします。

  4. 「ダウンロード」をクリックし、次に「接続性エージェント」をクリックします。

  5. 接続エージェント・インストーラをオンプレミス・ホストのディレクトリにダウンロードします。

  6. oic_conn_agent_installer.zipを抽出します。

  7. サード・パーティJAR (SiebelアダプタやMySQLアダプタなど)を追加する必要がある場合は、agenthome/thirdparty/libディレクトリの下にそれらをコピーします。

    ノート:

    接続性エージェントのインストール後にこのステップを実行する場合、エージェントを再起動する必要があります。 「接続エージェントの再起動」を参照してください。

  8. エージェント・グループにマウスを重ねます。

  9. 「アクション」 「アクション」アイコンをクリックし、「構成のダウンロード」を選択します。

    このステップでは、インストール中に使用する事前構成済のInstallerProfile.cfgファイルがダウンロードされます。 次のメッセージが表示されます。 
    BootStrap configuration downloaded for Agent Group agent_group_name. 
Replace the file in agent install location before proceeding with agent setup.

  10. ステップ5でエージェント・インストール・ファイルを抽出したときに作成されたoic_conn_agent_installerディレクトリの既存のInstallerProfile.cfgテンプレート・ファイルを、ステップ7でダウンロードした事前構成済のInstallerProfile.cfgファイルに置き換えます。

    事前構成されたInstallerProfile.cfgファイルには、クライアントID、クライアント・シークレット、スコープなど、oic_URL、agent_GROUP_IDENTIFIERおよびOAuth 2.0トークン・ベースの認証パラメータなど、すべての必須パラメータの値が自動的に含まれます。 これにより、これらのパラメータの値を手動で指定する必要がなくなります。

    1. オプションで、プロキシ・パラメータ値を設定します。 これらのパラメータは、接続エージェントをオンプレミス環境でプロキシとともに使用する場合にのみ必要です。

    2. 非プロキシ・ホスト環境で構成する必要があるホストが複数ある場合は、proxy_NON_PROXY_HOSTSパラメータで各IPアドレスまたはホストをパイプ記号(|)で区切る必要があります。 たとえば: 

      proxy_NON_PROXY_HOSTS=localhost|127.0.0.1|*.myorg.com

    3. Windowsにプロキシ・ユーザーを使用する場合、ユーザー名の前にMSドメイン名を、ユーザー名の前に二重バックスラッシュとともに含める必要があります(たとえば、MS_domain \\ username)。 二重バックスラッシュを指定しないと、407 Proxy Authentication Requiredエラーが表示されます。

  11. JAVA_HOMEプロパティをJDKインストールの場所に設定します。

  12. PATHプロパティを設定します。 たとえば、cshがあなたのシェルである場合: 
    setenv PATH = $JAVA_HOME/bin:$PATH

  13. コマンド・プロンプトから接続エージェント・インストーラを実行します。 このコマンドをコピーして貼り付ける場合は、特殊文字がないことを確認してください。 

    java –jar connectivityagent.jar
  14. 正常にインストールされるまで待ちます。
    Done with Agent installation & configuration... Starting agent for message processing.
Agent started successfully... listening for new messages...

    この接続エージェントに関連付けられたエージェント・グループには、Oracle Identity Cloud Serviceに独自のInstallerProfile.cfgファイルおよびOAuthクライアント・アプリケーションがあります。 エージェント・グループを削除すると、OAuthクライアント・アプリケーションもOracle Identity Cloud Serviceで削除されます。

    エラーが発生した場合は、エージェント診断ログを確認してください。

    「エージェントのモニター」を参照してください。

インストール後

接続エージェントのインストール後、エージェントを使用する接続を作成し、エージェントをサービスとして実行し、証明書をインストールできます。