機械翻訳について

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

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

トピック:

OAuthクライアント・アプリケーションのデフォルトのトークン有効期限値を変更しないでください

OAuthクライアント・アプリケーションのデフォルトのトークン有効期限値を変更しないでください。 この値は、デフォルトで3600秒(1時間)に設定されます。 接続性エージェントは、トークンの有効期限が切れる直前にトークン有効期限の値を再生成し、トークンの有効期限が切れるのを待機するのではなく、処理中のリクエストの失敗を回避します。 この値を1時間未満に手動で設定すると、401エラーが発生し、統合が断続的に失敗する可能性があります。

エージェント・グループに関連付けられたInstallerProfile.cfgファイルの変更後に接続エージェントが起動に失敗

あるエージェント・グループ(AGENT_GROUP_1など)に関連付けられたInstallerProfile.cfgファイルを別のエージェント・グループ(AGENT_GROUP_2など)とともに使用することはできません。

たとえば、次のステップを実行することを考えてみます:

  1. 特定のエージェント・グループのInstallerProfile.cfgファイルをローカル・ホストのoic_conn_agent_installerディレクトリにダウンロードします。
  2. 接続性エージェントをインストールして起動します。
  3. 接続エージェントを停止し、oic_conn_agent_installerディレクトリのInstallerProfile.cfgファイルを、別のエージェント・グループに関連付けられた別のInstallerProfile.cfgに置き換えます。
  4. 接続エージェントを再起動します。
    $ java -jar connectivityagent.jar

起動時に次のエラーが発生します:


Existing Agent installation found... Starting Agent for message processing.
Checking for already running instances of this agent. This might take up to 15 seconds ...
Initializing the credential store ...
Error encountered. See logs for more details.
Shutting down ...

エージェント診断ログには、次のエラー・メッセージも表示されます。

[2025-03-17T18:29:01.286Z] [SEVERE] [ThreadID: 24] [Logger: oracle.cloud.cpi.agent.util.CpiUtils] [SRC Class: oracle.cloud.cpi.agent.util.CpiUtils; Method: getKey] Issue when retrieving agent instance specific key Unable to retrieve key for agent instance CA-SHADOWFAX-1742233228361. Secret not found in secure credential store Http Status 500
[2025-03-17T18:29:01.287Z] [SEVERE] [ThreadID: 24] [Logger: oracle.cloud.cpi.agent.ProxyCpiAgentLoader] [SRC Class: oracle.cloud.cpi.agent.ProxyCpiAgentLoader; Method: initialize] Agent Startup Failed java.lang.Exception: /key endpoint returned a null or empty response.
at oracle.cloud.cpi.agent.util.CpiUtils.getKey(CpiUtils.java:749)
at oracle.cloud.cpi.agent.util.CpiUtils.initializeCredentialStore(CpiUtils.java:693)
at oracle.cloud.cpi.agent.ProxyCpiAgentLoader.initialize(ProxyCpiAgentLoader.java:121)
at oracle.cloud.cpi.agent.ProxyCpiAgentLoader.runAgent(ProxyCpiAgentLoader.java:48)
at java.base/jdk.internal.reflect.NativeMethodAccessorImpl.invoke0(Native Method)
at java.base/jdk.internal.reflect.NativeMethodAccessorImpl.invoke(NativeMethodAccessorImpl.java:77)
at java.base/jdk.internal.reflect.DelegatingMethodAccessorImpl.invoke(DelegatingMethodAccessorImpl.java:43)
at java.base/java.lang.reflect.Method.invoke(Method.java:569)...

かわりに、新しいエージェント・グループを作成し、接続性エージェントをダウンロードし、InstallerProfile.cfgファイルをダウンロードし、既存のInstallerProfile.cfgファイルをダウンロードしたファイルに置き換えて、接続性エージェントをインストールします。 「接続エージェントのダウンロードとインストール」を参照してください。

エージェントが使用できない問題のトラブルシューティング

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

数値 ステップ 詳細
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 構成ファイルのダウンロード エージェント構成ファイルを再度ダウンロードし、以前のエージェント構成ファイルを置き換えた後、接続エージェントを再起動します。
4

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

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

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

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

接続エージェントの起動が次のエラーで失敗する可能性があります:
java -jar connectivityagent.jar &
[2024-12-09T19:30:16.392Z] [INFO] [ThreadID: 15] [Logger: oracle.wsm.agent.WSMAgent] [SRC Class: oracle.wsm.agent.WSMAgent; Method: processRequest] pool-1-thread-1Entering processRequest() -  12/09/2024 19:30:16:392
[2024-12-09T19:30:16.396Z] [INFO] [ThreadID: 15] [Logger: oracle.wsm.agent.WSMAgent] [SRC Class: oracle.wsm.agent.WSMAgent; Method: processRequest] pool-1-thread-1Exiting processRequest() -  12/09/2024 19:30:16:396
[2024-12-09T19:30:16.473Z] [INFO] [ThreadID: 15] [Logger: oracle.cloud.cpi.agent.util.CpiUtils] [SRC Class: oracle.cloud.cpi.agent.util.CpiUtils; Method: createAuthToken] OAuth token url https://idcs-xxxxxx.identity.oraclecloud.com:443/oauth2/v1/token
[2024-12-09T19:30:46.505Z] [SEVERE] [ThreadID: 15] [Logger: oracle.cloud.cpi.agent.util.CpiUtils] [SRC Class: oracle.cloud.cpi.agent.util.CpiUtils; Method: createAuthToken] IDCS Token Generation: Call to create token failed due to java.net.SocketTimeoutException: Connect timed out
[2024-12-09T19:30:46.507Z] [INFO] [ThreadID: 15] [Logger: oracle.wsm.agent.WSMAgent] [SRC Class: oracle.wsm.agent.WSMAgent; Method: processRequest] pool-1-thread-1Entering processRequest() -  12/09/2024 19:30:46:507
[2024-12-09T19:30:46.507Z] [INFO] [ThreadID: 15] [Logger: oracle.wsm.agent.WSMAgent] [SRC Class: oracle.wsm.agent.WSMAgent; Method: processRequest] pool-1-thread-1Exiting processRequest() -  12/09/2024 19:30:46:507
[2024-12-09T19:30:46.550Z] [SEVERE] [ThreadID: 15] [Logger: oracle.cloud.cpi.agent.install.AgentInstaller] [SRC Class: oracle.cloud.cpi.agent.install.AgentInstaller; Method: checkVersion] Agent Installation Failed !!! Incorrect OIC Username / Password provided.
[2024-12-09T19:30:46.551Z] [SEVERE] [ThreadID: 15] [Logger: oracle.cloud.cpi.agent.ProxyCpiAgentLoader] [SRC Class: oracle.cloud.cpi.agent.ProxyCpiAgentLoader; Method: configureAgent] Agent Installation Failed !!! java.lang.reflect.InvocationTargetException
        at java.base/jdk.internal.reflect.NativeMethodAccessorImpl.invoke0(Native Method)
        at java.base/jdk.internal.reflect.NativeMethod
このエラーは、接続エージェントがOracle Integrationサーバーからエージェント・ステータスを問い合せることができないために発生します。
  1. アイデンティティ・ドメイン、設計時IPアドレスおよびランタイムIPアドレスを許可リストに登録します。
  2. Oracle Integration 3への接続を確認します。
  3. (オプション)構成ファイルを再度ダウンロードし、Oracle Integration 3接続に問題がなければエージェントを再起動します。

接続エージェントの起動が" 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)
...
...

エージェント・ホストからOracle Integration 3への接続が機能していることを確認します。

  1. アイデンティティ・ドメイン、設計時IPアドレスおよびランタイムIPアドレスを許可リストに登録します。
  2. Oracle Integration 3への接続を確認します。
  3. (オプション)構成ファイルを再度ダウンロードし、Oracle Integration 3接続に問題がなければエージェントを再起動します。

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

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

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

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

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

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では、エージェントを別のコンピュートで設定することをお薦めします。

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の下で使用できます。

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

ログの次のコードは、エージェント・ランタイム・メッセージの処理が停止したことを示します。 これは、HTTP 404/401エラー・コードがエージェントによって24時間継続的に受信された場合に発生します。 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 Cloud Infrastructureで実行されている) Oracle Integrationに接続している接続エージェント・インストールの場合、接続エージェントに関連する設計時およびランタイム操作が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

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

ノート:

接続エージェントが一時的な状態に対して回復可能であり、状況が解消されたときに回復するため、これは断続的な障害には適用されません。
  • 次のコマンドを実行します。
    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エラーで失敗した場合は、Oracle Integration 3からエージェント構成ファイルをダウンロードし、接続エージェントを再起動します。