機械翻訳について

接続エージェントのトラブルシューティング

この項では、Oracle Integrationの接続エージェントの問題のトラブルシューティングおよび解決方法について説明します。

トピック:

エージェント使用不可のトラブルシューティング

接続エージェントのステータスを確認するには、「モニタリング」 > 「統合」 > 「エージェント」を選択してエージェント・ページにアクセスします。 エージェント・ステータスが使用不可と表示された場合は、このトラブルシューティング・ワークフローに従います。


agent_unavailable_workflow.pngの説明は以下のとおりです
「図agent_unavailable_workflow.pngの説明」

数値 ステップ 詳細
1

エージェント・プロセスが実行中であることを確認してください

エージェントが実行中かどうかを確認します。 エージェントがインストールされているホストから、これらのコマンドのいずれかを実行します。

リストされたプロセスとしてconnectivityagent.jarが表示されない場合は、エージェントは実行されていません。 たとえば: 19054 connectivityagent.jar

Linux: 

 ps –ef | grep connectivityagent.jar

Windows: 

jps -l
エージェント・プロセスが実行されていない場合は、起動します:

Linux:

接続エージェントをバックグラウンド・プロセスとして起動します: 

nohup java -jar connectivityagent.jar &

Windows: 

java -jar connectivityagent.jar

ノート:

Windowsサービスとしてエージェントの起動はサポートされていません。

エージェントを起動しようとしたが起動しない場合は、ネットワーク接続の確認を続行します。

エージェント・プロセスが実行されている場合は、再起動します:

次の「エージェントを再起動するステップ」に従います。

2 ネットワーク接続の確認

エージェント・ホストがOracle Integrationインスタンスに接続できることを確認します:

エージェントがインストールされているホストで、独自のパスに置き換えて次のコマンドを実行します: 

curl https://myoic-tenancy-ia.integration.ocp.oraclecloud.com/ic/home

「レスポンスが302の場合」:エージェントはOracle Integrationインスタンス・ホストを解決できます。 ネットワーク接続があります。 ユーザー資格証明の確認を続行します。

「レスポンスが302ではない場合」:ネットワークに問題がある可能性があります。 /etc/hostsファイルを確認します:

  1. Oracle Integrationインスタンスの正しいIPアドレスとホスト名を確認します。
  2. ネットワーク管理者に連絡して、インスタンスへの接続を確認するためのトラブルシューティングは、ファイアウォールまたはプロキシによってブロックされません。 「エージェントのトラブルシューティング情報」です。
3 ユーザー資格証明の確認 エージェントの実行に使用されるユーザー・アカウントに、有効なユーザー名とパスワードがあることを確認します:
  1. エージェントの実行に使用されるユーザー・アカウントとパスワードを使用してOracle Integrationにサインインします。 これにより、ユーザー・アカウントとパスワードが有効であることが確認されます。
  2. エージェントが使用するユーザー資格証明が有効であることを確認します。 エージェントがインストールされているホストで、Oracle Integrationへのサインインに使用した資格証明を使用してこのコマンドを実行し、OIC_HOSTNAMEをホスト名に置き換えます: 
     curl -v -k -X GET -u user_name:password https://OIC_HOSTNAME/icsapis/v2/environment

「ユーザー資格証明のチェックに対するレスポンスが200の場合」:エージェントによって使用されるユーザー名とパスワードが有効です。 何か他の間違いがあるかもしれません。 診断ログでエラーを確認します: 

AGENT_INSTALL_LOCATION/agenthome/logs/agent-diagnostic0.log

  • ログ401 Unauthorized、またはAgent startup failed: Unable to get agent status、またはAgent Instance status check failed. Response receivedで表示される場合、エージェントInstallerProfile.cfgファイルで構成されたユーザー、ユーザー・アカウントがロックされているか、パスワードが期限切れになっている可能性があります。 「ユーザー資格証明のチェックへのレスポンスが200でない場合」のステップに従います。

「ユーザー資格証明のチェックへのレスポンスが200でない場合」。エージェントが使用している資格証明は無効です。 ユーザーがロックされているか、パスワードの有効期限が切れているか、InstallerProfile.cfgが破損している可能性があります。

ユーザー資格証明をリセットし、エージェントを起動します:

  1. ユーザーがロックされているかどうかを確認し、ロックされている場合は、ユーザーのロックを解除して新しいパスワードを設定します。 次の「エージェントのユーザー・アカウントのロックを解除するステップ」に従います。
  2. 新しい資格証明を使用してOracle Integrationにサインインし、機能していることを確認します。
  3. エージェントがインストールされているホストのInstallerProfile.cfgファイルのユーザー名とパスワードを更新します。 
    oic_USER=Oracle_Integration_username
oic_PASSWORD=Oracle_Integration_password
  4. エージェントを起動します。

    Linux:

    接続エージェントをバックグラウンド・プロセスとして起動します: 

    nohup java -jar connectivityagent.jar &

    Windows: 

    java -jar connectivityagent.jar

    ノート:

    Windowsサービスとしてエージェントの起動はサポートされていません。
4

サービス・リクエストを記録

トラブルシューティング・ステップを完了している場合は、診断ログで何も見つからず、エージェント・ステータスが引き続き使用できない「Oracle Supportを使用したサービス・リクエストの作成」。 ログインして「サービス・リクエスト」タブを選択し、「技術的SRの作成」をクリックします。

サービス・リクエストに診断ログを含めます。

エージェント・ステータスを取得できないため、接続エージェントを起動できません

接続エージェントの起動が次のエラーで失敗する可能性があります:
java -jar connectivityagent.jar &

[Logger: oracle.cloud.cpi.agent.util.CpiUtils] [SRC Class: oracle.cloud.cpi.agent.util.CpiUtils; 
 Method: checkIfAlreadyRunning] Agent Instance status check failed. Response received -  

[Logger: oracle.cloud.cpi.agent.ProxyCpiAgentLoader] [SRC Class: oracle.cloud.cpi.agent.ProxyCpiAgentLoader; 
Method: initialize] Agent Startup Failed java.lang.RuntimeException: Unable to get agent status  :
at oracle.cloud.cpi.agent.util.CpiUtils.checkIfAlreadyRunning(CpiUtils.java:1058)
at oracle.cloud.cpi.agent.ProxyCpiAgentLoader.initialize(ProxyCpiAgentLoader.java:114)
at oracle.cloud.cpi.agent.ProxyCpiAgentLoader.runAgent(ProxyCpiAgentLoader.java:53)
at sun.reflect.NativeMethodAccessorImpl.invoke0(Native Method)
at sun.reflect.NativeMethodAccessorImpl.invoke(NativeMethodAccessorImpl.java:62)
at sun.reflect.DelegatingMethodAccessorImpl.invoke(DelegatingMethodAccessorImpl.java:43)
at java.lang.reflect.Method.invoke(Method.java:498)
at oracle.cloud.cpi.agent.CpiAgentLoader.startAgent(CpiAgentLoader.java:27)
at sun.reflect.NativeMethodAccessorImpl.invoke0(Native Method)
at sun.reflect.NativeMethodAccessorImpl.invoke(NativeMethodAccessorImpl.java:62)
at sun.reflect.DelegatingMethodAccessorImpl.invoke(DelegatingMethodAccessorImpl.java:43)
at java.lang.reflect.Method.invoke(Method.java:498)
at oracle.cloud.cpi.agent.CpiBootstrapLoader.startAgent(CpiBootstrapLoader.java:183)
at oracle.cloud.cpi.agent.AgentStartCommandTask.run(CpiBootstrapLoader.java:427)
at java.util.concurrent.Executors$RunnableAdapter.call(Executors.java:511)
at java.util.concurrent.FutureTask.run(FutureTask.java:266)
at java.util.concurrent.ScheduledThreadPoolExecutor$ScheduledFutureTask.access$201(ScheduledThreadPoolExecutor.java:180)
at java.util.concurrent.ScheduledThreadPoolExecutor$ScheduledFutureTask.run(ScheduledThreadPoolExecutor.java:293)
at java.util.concurrent.ThreadPoolExecutor.runWorker(ThreadPoolExecutor.java:1149)
at java.util.concurrent.ThreadPoolExecutor$Worker.run(ThreadPoolExecutor.java:624)
at java.lang.Thread.run(Thread.java:748)

 [Logger: oracle.cloud.cpi.agent.AgentStartCommandTask] [SRC Class: oracle.cloud.cpi.agent.AgentStartCommandTask; Method: run] 
 Error during agent install/startup or while re-starting agent after upgrade:  java.lang.reflect.InvocationTargetException
at sun.reflect.NativeMethodAccessorImpl.invoke0(Native Method)
at sun.reflect.NativeMethodAccessorImpl.invoke(NativeMethodAccessorImpl.java:62)
at sun.reflect.DelegatingMethodAccessorImpl.invoke(DelegatingMethodAccessorImpl.java:43)
at java.lang.reflect.Method.invoke(Method.java:498)
at oracle.cloud.cpi.agent.CpiBootstrapLoader.startAgent(CpiBootstrapLoader.java:183)
at oracle.cloud.cpi.agent.AgentStartCommandTask.run(CpiBootstrapLoader.java:427)
at java.util.concurrent.Executors$RunnableAdapter.call(Executors.java:511)
at java.util.concurrent.FutureTask.run(FutureTask.java:266)
at java.util.concurrent.ScheduledThreadPoolExecutor$ScheduledFutureTask.access$201(ScheduledThreadPoolExecutor.java:180)
at java.util.concurrent.ScheduledThreadPoolExecutor$ScheduledFutureTask.run(ScheduledThreadPoolExecutor.java:293)
at java.util.concurrent.ThreadPoolExecutor.runWorker(ThreadPoolExecutor.java:1149)
at java.util.concurrent.ThreadPoolExecutor$Worker.run(ThreadPoolExecutor.java:624)
at java.lang.Thread.run(Thread.java:748)
Caused by: java.lang.reflect.InvocationTargetException
at sun.reflect.NativeMethodAccessorImpl.invoke0(Native Method)
at sun.reflect.NativeMethodAccessorImpl.invoke(NativeMethodAccessorImpl.java:62)
at sun.reflect.DelegatingMethodAccessorImpl.invoke(DelegatingMethodAccessorImpl.java:43)
at java.lang.reflect.Method.invoke(Method.java:498)
at oracle.cloud.cpi.agent.CpiAgentLoader.startAgent(CpiAgentLoader.java:27)
... 13 more
Caused by: java.lang.RuntimeException: Agent Startup Failed - Unable to get agent status
このエラーは、接続エージェントがOracle Integrationサーバーからエージェント・ステータスを問い合せることができないために発生します。 一般的な原因としては、接続エージェント構成ファイル内の接続の問題および不正な/期限切れの資格証明が含まれます。
  1. 接続エージェントのインストール中にInstallerProfile.cfgファイルに指定された資格証明を使用して、次のコマンドを実行します:
    curl -v -k -X GET -u uid:pwd  https://Oracle_Integration_URL:443/icsapis/v2/environment

    curlコマンドが401 Unauthorizedエラーを返す場合、これは、サーバーが到達可能であり、無効な資格証明がサーバーに送信されたことを示すレスポンスが返されたことを意味します。

  2. InstallerProfile.cfgファイルの資格証明を更新します:
    1. InstallerProfile.cfgをバックアップします。
    2. ユーザー名とパスワード・フィールドを、以前のRESTテストで使用される値に変更します。 これらの資格証明を使用してOracle Integrationにログインできることを確認します。 
      oic_USER=Oracle_Integration_username
oic_PASSWORD=Oracle_Integration_password
  3. ファイルを保存します。
  4. 接続エージェントを再起動します。

    再起動に成功すると、接続エージェントは暗号化された値でエントリを更新します。

接続エージェントの起動が" java.lang.RuntimeExceptionで失敗: エージェントの起動に失敗しました - エージェント・ステータスを取得できません"エラー

接続エージェントの起動が次のエラーで失敗する可能性があります:

[2021-06-19T10:06:06.567Z] [SEVERE] [ThreadID: 1] [Logger: oracle.cloud.cpi.agent.CpiBootstrapLoader] 
[SRC Class: oracle.cloud.cpi.agent.CpiBootstrapLoader; Method: main] Error encountered !!! java.lang.RuntimeException: 
 java.lang.reflect.InvocationTargetException
at oracle.cloud.cpi.agent.AgentStartCommandTask.run(CpiBootstrapLoader.java:452)
at java.util.concurrent.Executors$RunnableAdapter.call(Executors.java:511)
at java.util.concurrent.FutureTask.run(FutureTask.java:266)
at java.util.concurrent.ScheduledThreadPoolExecutor$ScheduledFutureTask.access$201(ScheduledThreadPoolExecutor.java:180)
at java.util.concurrent.ScheduledThreadPoolExecutor$ScheduledFutureTask.run(ScheduledThreadPoolExecutor.java:293)
at java.util.concurrent.ThreadPoolExecutor.runWorker(ThreadPoolExecutor.java:1149)
at java.util.concurrent.ThreadPoolExecutor$Worker.run(ThreadPoolExecutor.java:624)
at java.lang.Thread.run(Thread.java:748)
Caused by: java.lang.reflect.InvocationTargetException
at sun.reflect.NativeMethodAccessorImpl.invoke0(Native Method)
at sun.reflect.NativeMethodAccessorImpl.invoke(NativeMethodAccessorImpl.java:62)
at sun.reflect.DelegatingMethodAccessorImpl.invoke(DelegatingMethodAccessorImpl.java:43)
at java.lang.reflect.Method.invoke(Method.java:498)
at oracle.cloud.cpi.agent.CpiBootstrapLoader.startAgent(CpiBootstrapLoader.java:192)
at oracle.cloud.cpi.agent.AgentStartCommandTask.run(CpiBootstrapLoader.java:436)
...
...
Caused by: java.lang.reflect.InvocationTargetException
at sun.reflect.NativeMethodAccessorImpl.invoke0(Native Method)
at sun.reflect.NativeMethodAccessorImpl.invoke(NativeMethodAccessorImpl.java:62)
at sun.reflect.DelegatingMethodAccessorImpl.invoke(DelegatingMethodAccessorImpl.java:43)
at java.lang.reflect.Method.invoke(Method.java:498)
at oracle.cloud.cpi.agent.CpiAgentLoader.startAgent(CpiAgentLoader.java:27)
...
...
Caused by: java.lang.RuntimeException: Agent Startup Failed - Unable to get agent status :
at oracle.cloud.cpi.agent.ProxyCpiAgentLoader.initialize(ProxyCpiAgentLoader.java:151)
at oracle.cloud.cpi.agent.ProxyCpiAgentLoader.runAgent(ProxyCpiAgentLoader.java:53)
...
...

接続エージェント用に構成されたユーザー・アカウントがロックされているか、パスワードが期限切れであるため、問題が発生します。

  1. 次のcurlコマンドを入力し、ステータス200レスポンスを受信するかどうかを確認します。 接続エージェントの構成に使用したものとまったく同じユーザー名とパスワードを使用してください。 
    curl -v -k -X GET -u uid:pwd https://Oracle_Integration_URL:443/icsapis/v2/environment

    前述のcurlコマンド・レスポンスが200でない場合、InstallerProfile.cfgファイルで構成されたユーザーに問題があります。

  2. Oracle Cloud Infrastructureコンソールでユーザー・アカウントを確認し、ユーザーがロックされているか、パスワードが期限切れかどうかを確認します。 正確なユーザー名およびパスワード資格証明を使用してOracle Integrationにログインし、ユーザーがOracle Integrationにアクセスできることを確認します。
  3. ユーザーがOracle Integrationにアクセスできるようになったら、InstallerProfile.cfgファイルのoic_USERおよびoic_PASSWORDパラメータを正しい値で更新し、エージェントを再起動します。 これは問題に対処する必要があります。

/etc/hostsファイルが構成されていない場合の接続エージェントのインストール・エラー

接続性エージェントのインストール時に、エージェント・インストーラがエージェントがインストールされているホスト名/仮想マシン(VM)の詳細を検出できない場合、次のエラーが表示されることがあります:
Caused by: java.net.UnknownHostException: : Unknown
name or service

このエラーを解決するには、ホスト名/VMの/etc/hostsファイルにIPアドレスとホスト名のエントリを追加します。

接続エージェントでステージ・ファイル・アクションを使用する場合の制限

接続エージェントでステージ・ファイル・アクションの一部の操作を使用する場合は、いくつかの制限に注意してください。 「アタッチ・エージェントのファイル/添付ファイル機能でステージ・ファイル・アクション操作を使用する場合の制限」を参照してください。

フェデレーテッド・ユーザーとして実行している場合の接続性エージェントのインストールに失敗

フェデレーテッド・ユーザーとして実行した場合、接続エージェントのインストールは失敗します。 ユーザー・フェデレーションに依存している場合は、特に接続エージェントのインストールに使用するフェデレーテッド・ユーザーを作成する必要があります。 このユーザーは、接続エージェントがOracle Integrationと通信できるようにします。

ノート:

接続エージェントを再起動する必要がある場合は、このユーザーのユーザー名/パスワード資格証明がまだ有効であることを確認する必要があります。

Javaのメモリー・エラー

エージェントJava Virtual Machineは、メモリー不足のエラーが発生したように思われるメモリーを割り当てる際に実行を停止できます:
There is insufficient memory for the Java Runtime Environment to continue.
-----------------------------
Java HotSpot(TM) 64-Bit Server VM warning: INFO:
os::commit_memory(0x00007f6847afd000, 12288, 0) failed; error='Cannot
allocate memory' (errno=12)
#
# There is insufficient memory for the Java Runtime Environment to continue.
# Native memory allocation (mmap) failed to map 12288 bytes for committing
reserved memory.
# An error report file with more information is saved as:

ただし、この問題はメモリー不足エラーとは無関係で、Javaヒープのサイズが不足していると発生することがあります。

このエラーは、Javaがオペレーティング・システムに次の存在しないメモリーをリクエストした場合に発生します:
# There is insufficient memory for the Java Runtime Environment to continue.
# Native memory allocation (mmap) failed to map

これは、エージェントが実行されている物理マシン/仮想マシン/サーバー上の物理マシン、サーバーまたは仮想マシンのリソースに関連している可能性があります。 たとえば、エージェントがデータベースと同じ仮想マシン上で実行されており、データベースがほとんどのリソースを消費している場合があります。 Oracleでは、エージェントを別のコンピュートで設定することをお薦めします。

エージェントの再起動時の認可エラー

エージェントを手動で停止して再起動を試行し、認可エラーが表示された場合は、InstallerProfile.cfgファイルでエージェントを起動するために使用したユーザー名とパスワードが正しいことを確認します。 このエラーは、このユーザー名のパスワードが期限切れになり、管理者によってOracle Cloud Infrastructureコンソールで変更されたものの、InstallerProfile.cfgファイルでは更新されていない場合に発生します。 エージェントを手動で停止して再起動する場合に「のみ」、このタスクは必要です。 このタスクは、エージェントのアップグレードには必要ありません。エージェントのアップグレードは自動的に実行され、これらの資格証明は使用されません。

CpiAgent.propertiesファイルへのインストール後の非プロキシ・ホスト構成の追加または変更

エージェントのインストール後に非サンドボックス・ホストの構成を追加、変更またはバイパスする必要がある場合は、InstallerConfing.cfgファイルを編集しないでください。 エージェント・インストール後にこのファイルに対して行われたプロキシ・ホストの変更は有効になりません。 変更を有効にするには、Agent_Installation_Location/agenthome/agent/config/CpiAgent.propertiesファイルのproxy_nonProxyHostsパラメータを使用してホストを更新してください。 このファイルを編集した後、エージェントを再起動します。

JDKインスタンスを別の製品と共有する際のクラスのロードの競合

接続エージェントを使用すると、JDKインスタンスが、JARファイルがJDKのエンドース・ディレクトリに追加されている別の製品と共有されるため、次のエラーが発生します。 これにより、クラス読み込みがエージェントと競合します: 
ClassCastException: com.sun.xml.messaging.saaj.soap.ver1_1.Message1_1Impl
cannot be cast to oracle.j2ee.ws.saaj.soap.MessageImpl
他の製品との使用のために変更されていないJDKインストールで、接続エージェントが実行されていることを確認します。

接続性エージェント・ログ・ファイルのロケーション

接続エージェントagent-diagnostic0.logファイルは、agenthome/logsの下で使用できます。

Oracle Integration Classic (ユーザー管理)環境で接続エージェントを使用する際のエラー

Oracle Integration Classic (ユーザー管理)を使用していて、エージェント・インタラクションが次のエラーで失敗した場合: 

java.sql.SQLException: ORA-03146: Invalid buffer length for TTC field

Oracle Integrationインスタンスで使用されるOracle Database Cloud Serviceインスタンスに、次のパッチを適用する必要があります。

  1. http://support.oracle.comに移動し、パッチ26482376を取得します。

  2. Oracle Database Cloud Serviceインスタンスにパッチを適用します。

  3. データベースに対して次のコマンドを実行します。 (このコマンドを実行すると、パッチを適用することなく有効になります。) 

    alter system set events '24921 trace name context forever, level=105989

廃止されたインスタンスまたはHTTP404/401エラー・レスポンス・コードでのエージェント動作

ログ内の次のコードは、エージェント・ランタイムのメッセージ処理が停止したことを示しています。 これは、24時間の連続した期間にHTTP 404/401エラー・コードをエージェントが受信した場合に発生します。 Oracle Integrationインスタンスの廃止により、この動作もトリガーされます。 このエラーの原因となる条件が解決されている場合、エージェントは手動で再起動する必要があります。 「エージェントの再起動」を参照してください。 
[2018-10-13T04:30:13.501Z] [SEVERE] [ThreadID: 18] [Logger:
oracle.cloud.cpi.agent.transport.AQRuntimeConsumer] [SRC Class:
oracle.cloud.cpi.agent.transport.AQRuntimeConsumer; Method: run] Terminate
flag activated. Signalling termination of agent runtime poller thread with Id

CPI_RUNTIME_REQ_RES_CHANNEL_worker_0.

エージェントがプロキシ・ホストとともにインストールされた場合のエンドポイントのアクセシビリティの検証

エージェントがプロキシ・ホストにインストールされている場合、エージェントを介してアクセスするエンドポイントがプロキシ・ホストを経由して到達可能であることを慎重に確認します。 プロキシ・ホストを介して到達できない場合は、Agent_Installation_Location/agenthome/agent/config /CpiAgent.propertiesファイルのproxy_NON_PROXY_HOSTSパラメータでオンプレミス・エンドポイント・ホストを構成する必要があります。

エージェント・グループのロック解除

エージェント・グループが編集モードのときに、ブラウザがクラッシュした場合、エージェント・グループはロックされ、編集できなくなります。 これにより、次のエラーが発生します: 

ICS-10507: The agent group cannot be updated because it is locked.

エージェント・グループをロック解除するには:

  1. ブラウザがクラッシュしたときにエージェント・グループを編集していたユーザーと同じユーザーで再度ログインしてからログアウトします。 このアクションにより、エージェント・グループのロックが解除されます。

または

  1. タイムアウトの開始後にロックが期限切れになるまで30分待ってください。

java.net.SocketExceptionによるレスポンスの送信に失敗しました: 接続リセット・エラー

Oracle Integration Classic VMで実行されている接続エージェントのインストールおよびOracle Integrationへの接続(Oracle Cloud Infrastructureで実行)では、接続エージェントに関連する設計時間とランタイム操作がjava.net.SocketException: Connection resetエラーで失敗します。

これは最大転送単位(MTU)の不一致が原因で発生する可能性があります。

完全なエラーを次に示します:

[2019-01-03T16:35:12.670Z] [SEVERE] [ThreadID: 50] [Logger:
oracle.cloud.cpi.agent.transport.CpiAgentAQTransporter] [SRC Class:
oracle.cloud.cpi.agent.transport.CpiAgentAQTransporter; Method:
sendOneWayPacket] Exception while sending response back to
ICSjava.net.SocketException: Connection reset
com.sun.jersey.api.client.ClientHandlerException: java.net.SocketException:
Connection reset
at
com.sun.jersey.client.urlconnection.URLConnectionClientHandler.handle(URLConne
 
ctionClientHandler.java:155)
at com.sun.jersey.api.client.Client.handle(Client.java:652)
at com.sun.jersey.api.client.WebResource.handle(WebResource.java:682)
at com.sun.jersey.api.client.WebResource.access$200(WebResource.java:74)

この接続を機能させるには、Oracle Integration Classic VM (エージェントがインストールされている場所)のMTUを8900の現在の値から1500に設定します。

次のステップを実行します。

  1. ルート・ユーザー(sudo)としてifconfig -aを実行し、ネットワーク・インタフェースをノートします。
  2. ネットワーク・インタフェースのルート・ユーザー(sudo)として次のコマンドを実行します(ネットワーク・インタフェースがeth0):の場合):
    ifconfig eth0 mtu 1500

エージェントVMの再起動が行われるたびに(エージェントの再起動ではなく、エージェントがインストールされているホスト)、エージェントを再起動する前にネットワーク・インタフェースの変更を行う必要があります。

winscpを使用してインストーラをコピーした場合のLinux上でのエージェント・インストール

Linux環境での接続性エージェントのインストール時に、次のエラーが発生した場合があります:

On premise agent is throwing the following error: java.lang.RuntimeException:

Agent Startup Failed - java.lang.IllegalArgumentException: URI is not
absolute

インストール失敗は次の理由で発生します:

  1. エージェントはLinux環境にインストールされます。
  2. エージェント・インストーラのZIPファイルは、Windows環境にダウンロードされ、winscpというWindowsツールを使用して、Linux環境に転送されます。
  3. winscpツールでバイナリ・オプションが有効になっていても、エージェントの実行やインストールに使用されたインストーラのZIPは、上記のエラーで失敗します。

回避策として、次のステップを実行します。

  1. エージェント・インストーラを直接Linux環境にダウンロードし、Windows環境から転送しないでください。
  2. Linux環境からOracle Integrationユーザー・インタフェースにアクセスできる場合は、エージェント・ページに用意されているダウンロード・インストール・オプションを使用します。
  3. Oracle Integrationユーザー・インタフェース・インスタンスにアクセスできない場合は、次のRESTコマンドを使用してインストーラをLinux環境にダウンロードします:
    curl -k -v -X GET -u OIC_user:OIC_password 
-H 'Content-Type:application/json'
'https://OIC_URL:443/icsapis/v1/agent/binaries/connectivity' 
-o download_location/oic_connectivity_agent.zip

エージェントのパフォーマンス・チューニング

追加のロードを処理するためにOracle Integrationがスケール・アウトされた場合のみ、Agent_Installation_Location/agenthome/agent/config/CpiAgent.propertiesファイルのagentWorkerThreadsプロパティを変更します。 その場合は、agentWorkerThreadsプロパティの値を変更することで、エージェントをチューニングして追加のロードを処理できます。 各エージェントに割り当てることができる最大値は10です。

JDKのロケーションの変更による統合アクティブ化エラー

統合のアクティブ化が次のエラーで失敗した場合、ロケーションが変更されたJDKを使用したエージェントのインストール結果が考えられます(削除など)。 これは、エージェントがインストールされ、JDKのロケーションが削除されたバージョンで実行されており、新しいバージョンが別の場所にインストールされている場合に発生する可能性があります。 エージェントとともにインストールされたJDKが削除された場合は、JDKの新しいバージョン(およびロケーション)でエージェントを再起動してください。 
Caused by: java.lang.Error: Circular loading of installed providers 
detected at 
java.nio.file.spi.FileSystemProvider.installedProviders(FileSystemProvider.jav 
a:161)
at java.nio.file.FileSystems.newFileSystem(FileSystems.java:324)
at java.nio.file.FileSystems.newFileSystem(FileSystems.java:276)
at
oracle.cloud.cpi.agent.store.StoreUtils.extractZipBundle(StoreUtils.java:49)
at
oracle.cloud.cpi.agent.store.FileAgentStore.addActivation(FileAgentStore.java:
40)
at
oracle.cloud.cpi.agent.ActivationCpiCommand.doRequest(ActivationCpiCommand.jav 
a:80)

Oracle Integrationが休止または使用不可のため、接続エージェントのポーリング・フローが非アクティブ化されました

Oracle Integrationが休止または使用不可の場合、トリガーとして使用される接続エージェント(データベース、JMS、ファイルなど)のポーリング・フローは非アクティブ化されます。 その後、Oracle Integrationが休止解除されるか、メッセージ処理に再び使用可能になると、フローが再アクティブ化されます。 ただし、Oracle Integrationが5分以上使用できない場合、エージェント側でポーリング・フローが非アクティブ化されます。 トリガー・エンドポイントを再アクティブ化し、EISエンドポイントのポーリングを再開するには、接続性エージェントを再起動する必要があります。

ネットワーク接続の問題のトラブルシューティング

Oracle Integrationインスタンスで永続的な接続障害が発生したときに、ネットワーク接続が適切に機能していることを確認します。

ノート:

接続エージェントが一時的な状態に対して回復可能であり、状況が解消されたときに回復するため、これは断続的な障害には適用されません。
  • 次のコマンドを実行します。
    nslookup hostname
  • 次のコマンドを5分間実行して、一時的な障害も取得します:
    while true;
do
curl https://Oracle_Integration_hostname/ic/home >> file.txt 2>&1;
sleep 1;
echo "trying again";
done;

接続エージェントのインストール中にHTTP 401の未認可エラーが発生しました

接続性エージェントのインストールまたは再起動がHTTP 401 Unauthorizedエラーで失敗した場合、接続性エージェントのブートストラップに使用されたユーザー名/パスワードが不正であることを意味します。 接続エージェントのインストール/再起動に使用するユーザー名/パスワード資格証明が有効であることを確認してください。 postmanまたはcurlを使用して、次のAPIにアクセスし、指定したユーザー名/パスワードに対するHTTP 200レスポンスで成功することを確認できます。 これにより、現在使用している不正なユーザー名とパスワードの組合せがすべて排除されます。

  • オプション1 - postmanまたはcurlを使用します: 

    curl -k -X GET -u user:password https://Oracle_Integration_Host/icsapis/v2/environment

    前述のAPIがHTTP 200レスポンスにより成功した場合、同じユーザー名とパスワードを使用して接続エージェントもブートストラップします。

  • オプション1 - Chromeブラウザまたは他のブラウザを使用して、次の内容を実行します: 
    https://Oracle_Integration_Host/icsapis/v2/environment