機械翻訳について

接続性エージェント・インストーラのダウンロードおよび実行

エージェントをローカル環境にインストールするには、エージェント・グループを作成し、接続エージェント・インストーラをダウンロードして実行する必要があります。

エージェント・グループの作成

接続エージェント・インストーラを実行する前に、Oracle Integrationでエージェント・グループを作成する必要があります。 ご使用の環境に接続エージェントをインストールするときは、接続エージェントをエージェント・グループ識別子に関連付けます。 最大2つの接続エージェントを1つのエージェント・グループに関連付けることができます。 単一のOracle Integrationインスタンスの場合、最大5つのエージェント・グループを作成できます。 エージェント・グループを作成すると、メッセージ交換に必要なアーティファクトも作成されます。

エージェント・グループを作成するには:

  1. 左側のナビゲーション・ペインで、「ホーム」>「統合」>「エージェント」をクリックします。

  2. 「エージェント・グループの作成」をクリックします。

    新規エージェント・グループの作成が表示されます。

  3. 次の情報を入力し、「Create」をクリックします。

    フィールド 説明

    名前

    他のユーザーがエージェント名を理解できるように意味のある名前を入力します。 名前は、システム内のすべてのエージェント名の間で一意である必要があります。 名前には、次を含めることができます。

    • 文字(A-Z、a-z)

    • 数字(0-9)

    • 空白( )

    • 特殊文字( _ - )

    名前は、先頭または末尾にスペースを使用することはできず、50文字を超えることもできません。

    識別子

    必要に応じて、デフォルトの識別子値のままにするか、変更します。 識別子は最初、指定したエージェント・グループ名と同じですが、ただし、大文字です。 エージェントをインストールするときは、識別子の値を指定する必要があります。

    ノート: エージェント・グループを作成した後、エージェント・グループ識別子を編集することはできません。 代わりに、別のエージェント・グループを削除して再作成し、別のエージェント・グループ識別子に関連付ける必要があります。

    タイプ

    「接続エージェント・グループ」が表示され、編集できません。 接続性エージェントは、オンプレミス・システムとの統合をサポートしています。 エージェント・グループは、接続性エージェントのみを参照します。

    説明

    他のユーザーがエージェント・グループの処理内容を理解できるように意味のある説明を入力します。

システム要件

オンプレミス接続エージェントをインストールする前に、次のシステム要件を満たしていること。

JDKのバージョン、オペレーティング・システムおよびヒープ・サイズの要件の理解

  • JDKバージョン17をインストールして使用します。

    ノート:

    Oracleセキュリティ標準に準拠するために、JDK 8およびJDK 11は、オンプレミス接続エージェントで使用するために非推奨となっています。 できるだけ早くJDK 17にアップグレードし、JKSキーストアをPKCS12キーストアに同時に変換する必要があります。 「Oracle Integration 3のプロビジョニングと管理」の「アップグレードの前提条件の完了」を参照してください。

    次の重要な期限を確認してください:

    • JDK 8およびJDK 11での接続エージェントのサポートは、2023年12月31日に終了します。 どちらのバージョンも使用し続けると、接続性エージェントの四半期ごとの更新および接続性エージェントを含む送信済サービス・リクエストのサポートは受信されなくなります。
    • 接続エージェントに依存するサービスの中には、2024年1月15日以降に正常に機能しないものがあります。 つまり、JDK 8およびJDK 11上の接続エージェント・トラフィックは、Oracleによってブロックされる可能性があります。
    ホーム・ページの新しいお知らせバナーには、JDK 8および11の非推奨に関する情報も表示されます。

    ノート:

    JDK 17およびPKCS12キーストアにアップグレードしても、お知らせバナーは表示されません。 バナーを閉じるには:
    1. ナビゲーション・ペインで、「設定」、「アップグレード」の順にクリックします。
    2. アップグレードの準備をしているかどうかに関係なく、アップグレード資格プログラムを実行します。

      バナーは間もなく消える。

    次の詳細に注意してください。
    • 「Oracle WebLogic JMSアダプタ」を使用する場合、JDK 11およびJDK 17の制限があります。 「接続エージェントの制限事項」を参照してください。
    • 接続エージェントでJDK 8を使用している場合は、JDK 8に最新の更新が含まれていることを確認します。 これらの更新を適用したら、エージェントを再起動します。 古いバージョンのJDK 8の証明書の有効期限が切れることがあり、エージェントの接続の問題が発生します。

      JDK 17に移動します。 JDK 17は、エージェントをOracle Integration Generation 2からOracle Integration 3にアップグレードするために必要な最小バージョンです。 お客様は、最新のJDKパッチをJDK 17に移行した後、定期的に取り込むことを計画する必要があります。

    • エージェントのインストールまたは実行(あるいはその両方)のみを目的として、JDKライセンスを購入する必要はありません。 「OIC Connectivity AgentのJDKライセンスとサポート(Doc ID 2611142.1)」を参照してください。
    • JDKインストールは、同じホストにインストールされている他の製品と同じものにできます。 ただし、エージェントの使用以外のJavaの使用には、個別のJDKライセンスが必要になる場合があります。 JDKインストールが、これらの他の製品で使用できるように変更されていないことを確認します。
  • 次のいずれかの動作保証されたオペレーティング・システムに接続エージェントをインストールします:

    • Oracle Enterprise Linux 6.x

    • Oracle Enterprise Linux 7.x

    • Oracle Enterprise Linux 8.x

    • RedHat Enterprise Linux 6.6

    • RedHat Enterprise Linux 7.x

    • RedHat Enterprise Linux 8.x

    • Suse Linux Enterprise Edition 12 SP2

    • Windows標準エディション2016

    • Windows 2019

    ノート:

    • 接続エージェントは、Kubernetes (K8s)で認証されていません。
    • IBMまたはOpen JDKはサポートされていません。

  • 最小8GB(エージェントJVM専用のヒープ・サイズとして4GB)のメモリーを用意します。 オンプレミス・エージェントに加えて他のプロセスをそのホストに含める場合は、物理メモリーを8GBより大きくすることをお薦めします。

接続エージェントのバージョンがJDK 17と互換性があることを確認してください

agenthomeディレクトリから次のコマンドを実行して、接続エージェントがJDK 17と互換性があるかどうかを確認します。 JDK 17の互換性には、Oracle Integration Generation 2の次の最小バージョンが必要です。 
$ cat version
230505.0528.4033
JDK 17へのアップグレード後に接続エージェントの起動時に次のエラーが表示された場合は、互換性のあるバージョンの接続エージェントを実行していません:
Agent is only supported on Java version 8 or 11. Please set JAVA_HOME and PATH to the location
for Java (JDK 8 or 11). This error occurs because you are using an older version of the connectivity agent.
次の理由で、古いバージョンの接続エージェントを実行している可能性があります:
  • 以前の接続エージェントのアップグレード試行が失敗しました
  • エージェントは、次のオプションを使用して起動しました:
    -DenableAutoUpgrade=false
この問題を解決するには:
  1. 以前のJDKバージョン(JDK 8またはJDK 11)で接続エージェントを1回起動します。
  2. 接続エージェントのアップグレードが終了するまで待ちます。 agenthome/logs/agent-upgrade.logファイルでアップグレードを監視できます。
  3. 接続性エージェントを停止します。
  4. JDK 17で接続エージェントを再起動します。

既存のJDK 8またはJDK 11エージェントをJDK 17エージェントにアップグレード

  1. JDK 17をインストールします。
  2. 既存の接続エージェントを停止します。
  3. JAVA_HOMEおよびPATHをJDK17に設定します。
  4. 接続エージェントを再起動します。

問題の場合にJDK 8またはJDK 11エージェントに戻す

  1. 接続性エージェントを停止します。
  2. JAVA_HOMEおよびPATHをJDK8またはJDK11に設定します。
  3. 接続エージェントを再起動します。

接続エージェントの制限事項

次の接続エージェントの制限に注意してください。

  • 「Oracle WebLogic JMSアダプタ」が12.2.1.4より前のバージョンのOracle WebLogic Serverとともに使用されている場合、JDK 11およびJDK 17はサポートされていません。 Oracle WebLogic Serverのバージョンを知るには、次のステップを実行します:
    1. Oracle WebLogic Server URLを入力します。 たとえば: 
      http://abcweblogic.oracle.com:7001/console
    2. 左下のバージョンを確認します。 たとえば: 
      WebLogic Server Version: 12.2.1.4.0
  • Windowsホストにインストールされている場合、NT LAN Manager (NTLM)認証を使用するプロキシでは接続エージェントは機能しません。

エージェントのダウンロードおよびインストール

エージェントをダウンロードし、ローカル・ホストにインストールする必要があります。 必要に応じて、セキュリティ証明書をローカル・ホストにインストールすることもできます。 必要に応じて、エージェント・インストーラをバックグラウンド・プロセスとして実行することもできます。

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

接続エージェント・インストーラをインストールして、ローカル環境にエージェントをインストールします。 インストール中に、Oracle Integrationでエージェント・グループを作成するときに生成したエージェント・グループ識別子に接続エージェントを関連付けます。

ノート:

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

    ノート:

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

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

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

  2. 左側のナビゲーション・ペインで、「ホーム」>「統合」をクリックし、「エージェント」をクリックします。

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

  4. オンプレミス・ホストのディレクトリに、Connectivity Agentインストーラをダウンロードします。

  5. oic_connectivity_agent.zipを解凍します。

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

    ノート:

    接続性エージェントのインストール後にこのステップを実行する場合、エージェントを再起動する必要があります。

    「エージェントの再起動」を参照してください。

  7. InstallerProfile.cfgを次の情報を含むように変更します:
    # Required Parameters
# oic_URL format should be https://hostname:sslPort
oic_URL=https://oic_host:ssl_port
agent_GROUP_IDENTIFIER=

#Optional Parameters
oic_USER=
oic_PASSWORD=

#Proxy Parameters
proxy_HOST=
proxy_PORT=
proxy_USER=
proxy_PASSWORD=
proxy_NON_PROXY_HOSTS=

    説明:

    パラメータ 説明
    oic_URL このパラメータは必須です。 これは、Oracle IntegrationホストのHTTPS URLです。 ポートは443です。
    agent_GROUP_IDENTIFIER このパラメータは必須です。 これは、Oracle Integrationで作成された接続エージェント・グループの識別子です。 識別子名では大文字と小文字が区別されます。

    「エージェント・グループの作成」を参照してください。

    oic_USER このオプション・パラメータは、Oracle Integrationユーザー名を指定します。 エージェントが初めて実行されるとき、このフィールドはプロパティ・ファイルで暗号化されています(指定されている場合)。 このフィールドを指定しない場合、エージェントの起動時にユーザー名を入力するように求められ、永続化されません。 「Oracle Integration Generation 2のプロビジョニングと管理」の「ロール別統合設計セクションでユーザーが実行できる操作」を参照してください。 接続エージェントは基本認証をサポートしています。 Oracle Cloud Infrastructure APIキーまたはOAuthパラメータは使用できません。
    oic_PASSWORD このオプション・パラメータは、Oracle Integrationパスワードを提供します。 エージェントが初めて実行されるとき、このフィールドはプロパティ・ファイルで暗号化されています(指定されている場合)。 このフィールドが指定されていない場合、エージェントの起動時にパスワードの入力を求められ、そのパスワードは永続化されません。
    Proxy Parameters これらのパラメータは、接続エージェントをオンプレミス環境でプロキシとともに使用する場合にのみ必要です。
    • 非プロキシ・ホスト環境で構成する必要があるホストが複数ある場合は、proxy_NON_PROXY_HOSTSパラメータで各IPアドレスまたはホストをパイプ記号(|)で区切る必要があります。 たとえば: 
      proxy_NON_PROXY_HOSTS=localhost|127.0.0.1|*.myorg.com
    • Windowsにプロキシ・ユーザーを使用する場合は、ユーザー名の前にMSドメイン名を含めて、ユーザー名の前に二重のバックスラッシュ(MS_domain \\ usernameなど)を含める必要があります。 二重のバックスラッシュを指定しない場合、407 Proxy Authentication Requiredエラーが発生します。

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

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

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

    java –jar connectivityagent.jar
  11. プロンプトが表示されたら、Oracle Integration資格証明を入力します。
    Proceeding to install a new agent ...
Enter your OIC username : 
Enter password for username :
  12. 正常にインストールされるまで待ちます。
    Done with Agent installation & configuration... Starting agent for message processing.
Agent started successfully... listening for new messages...

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

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

  13. エージェント環境によっては、証明書のインストールが必要になる場合もあります。

    「エージェント・ホストに証明書をインストール」を参照してください。

エージェント・ホストに証明書をインストール

エージェント・ホストに証明書を追加する必要がある場合は、keytoolを使用して証明書をkeystore.jksにインポートします。 証明書をインストールすると、自己署名証明書を使用してホストにアクセスできます。 通常は必要ありません。

ノート:

接続性エージェントのインストール後に証明書をインストールした場合、エージェントを再起動する必要があります。

「エージェントの再起動」を参照してください。

エージェント・キーストアで証明書をインポートする必要があるシナリオは次のとおりです:

  • 接続エージェントはSSLプロキシで使用されます。

  • 接続エージェントは、セキュア(SSL)オンプレミスのエンドポイントを起動するために使用されます。

  1. agenthome/agent/cert/ディレクトリに移動します。(keystore.jksはこちらから入手できます)。

  2. 次のコマンドを実行します。
    keytool -importcert -keystore keystore.jks -storepass password -alias alias_name -noprompt -file certificate_file

    説明:

    • -storepass password: エージェント・キーストアのデフォルトの初期パスワード。 デフォルトのstorepassパスワードについては、keytoolのドキュメントを参照してください。 keytoolを参照してください。
    • -alias alias_name: キーストア内のインポートされた証明書を一意に識別する名前。
    • -file certificate_file: 証明書ファイルの絶対パス。

Linuxシステムでバックグラウンド・プロセスとして接続性エージェント・インストーラを実行

接続エージェント・インストーラを実行すると(java -jar connectivityagent.jarを使用)、プロセスは作業中のターミナル・ウィンドウに関連付けられ、ウィンドウが閉じられると終了します。 バックグラウンドでプロセスを実行する場合は、次のいずれかのオプションを使用します:

接続性エージェント・インストーラをバックグラウンド・プロセスとして実行

  1. InstallerProfile.cfgをoic_USERとoic_PASSWORDの値で更新し、次にnohupを使用してエージェント・プロセスを実行します。 たとえば: 
    nohup java -jar connectivityagent.jar &

または

  1. InstallerProfile.cfgにパスワードを公開しない場合は、次のステップを実行します:

    1. コマンド・プロンプトでjava -jar connectivityagent.jarと入力します。

    2. プロンプトが表示されたら、ユーザー名とパスワードを入力します。

    3. Ctrl+Zと入力して処理を中断します。

    4. bgと入力します(バックグラウンドでプロセスを実行します)。

    5. jobsを入力してjobidを取得します。

    6. 所有シェルからプロセスの関連付けを解除するには、disown -a %jobid(ステップeから)を入力します。

Windowsでは接続性エージェントはRun as a Serviceにできない

Windowsでのサービスとしての接続エージェントの実行はサポートされていません。 Windowsホストにログインする必要があります。 それ以外の場合は、ログオフするとエージェントは機能しなくなります。 次の推奨オプションを検討してください。
  1. Windowsで新しいサービス・アカウントを作成します。
  2. そのアカウントを使用して、Windowsホストにログインし、そのアカウントでログインしたままにします。
  3. Windowsホストに接続性エージェントをインストールします。
  4. このエージェントを使用して、WindowsでアクセスしたMS SQL Serverまたはその他のエンドポイントと通信します。
または
  1. 接続性エージェントは、Windowsホストにインストールするのではなく、そのエージェントが対話する必要のあるWindowsシステムにアクセスできるLinux仮想マシンにインストールします。