機械翻訳について

ロボット・エージェントが起動しない

ロボット・エージェントを起動できない場合は、ロボット・エージェントをはじめて起動するか停止したあとで起動するかに関係なく、トラブルシューティング・ステップを使用して順調に戻ります。

問題

ロボット・エージェントは、取り付け直後または誰かが停止した直後に停止することはできません。

なぜ起こるのか

通常、この問題は、ロボット・エージェントがOracle Integrationに接続できないとき、またはロボット・エージェントの構成にいくつかの調整が必要なときに発生します。 トラブルシューティングのステップについては、引き続きお読みください。

エラーのトラブルシューティング方法

コマンド行またはロボット・エージェント・ログに次のエラーが表示されることがあります。

エラー 何が起こったのか トラブルシューティングのステップ

Agent jar version is either blank or not correct

ロボット・エージェントのJARファイルのファイル名には、ロボット・エージェントのバージョン番号(0.1.80など)が含まれなくなりました。

JARファイルのファイル名を、ロボット・エージェントのバージョン番号を含む元の名前にリストアします。 正しい形式がわからない場合は、エージェントを再度ダウンロードして、JARファイルをロボット・エージェントのディレクトリにコピーできます。 「ロボット・エージェントのダウンロード」を参照してください。

An error occurred while storing or trying to retrieve secrets from the local store.

または

An Exception occurred while retrieving secrets. Terminating agent

Oracle Integrationは、コンピュータのローカル・キーストアに値を書き込んだり、値を取得できませんでした。 通常、このエラーは、ユーザーに十分な権限がない場合に表示されます。 たとえば、ある管理者がロボット・エージェントをダウンロードし、2番目の管理者がロボット・エージェントを起動しようとしています。 2人目の管理者がコンピュータ上の資格証明マネージャにアクセスできない可能性があります。

管理者としてコマンド・プロンプトを実行してから、ロボット・エージェントの起動を再試行してください。 Install and Start the Robot Agentを参照してください。

Could not determine the path to the JAR file. Provide full path of the agent jar.

次のいずれかの問題が発生しました:

  • ロボットがインストールされているフォルダ名またはディレクトリには、スペースが含まれます。

  • ロボット・エージェントの起動に使用したコマンドに、ロボット・エージェントのJARファイルの完全なディレクトリが含まれていませんでした。

フォルダ名またはディレクトリにスペースが含まれているかどうかを確認します。 その場合は、ディレクトリからスペースを削除し、コマンドを更新してロボット・エージェントを適切に起動してから、やり直してください。

フォルダ名またはディレクトリにスペースがない場合は、ロボット・エージェントの起動に使用したコマンドを確認します。コマンドをJARファイルへの完全なディレクトリが含まれるように更新します。 Install and Start the Robot Agentを参照してください。

Either latest available version or current running agent version is null.

または

Either minimum supported version is not met or current running agent version is null.

または

Minimum supported agent version is version_number, current running version version_number

ロボット・エージェントのバージョンは、Oracle Integrationと互換性がなくなりました。

ロボット・エージェントの新しいバージョンに更新します。 「ロボット・エージェントのダウンロード」を参照してください。

Error occurred while downloading dependencies like micromamba, robot runtime, rcc, etc.

または

Robot runtime is not available. Please check robot runtime installation before proceeding.

ロボット・エージェントをインストールした環境は、パブリック・インターネットにアクセスできず、必要な依存関係をダウンロードできません。

ロボット・エージェントをはじめて起動するときに、環境がパブリック・インターネットにアクセスできる必要があります。 VPNを一時的に無効にするなどして、コンピュータがパブリック・インターネットにアクセスできることを確認し、ロボット・エージェントを再度起動してください。

ロボットの対話によっては、一般公開インターネットへのアクセスが必要になる場合があります。 設計の考慮事項を参照してください。

Failed creating python virtual environment for flowRT

このエラーは、ロボット・エージェントを起動しようとしているとき、またはロボット・エージェントをWindowsサービスとして起動しようとしたときに発生することがあります。

  • ロボット・エージェントを起動しようとすると、次のいずれかの問題が発生する可能性があります。

    • マシンにネットワーク接続がありません。

    • マシンは、パブリック・インターネットへのアウトバウンド接続を制限します。

    • ロボット・エージェントは、ユーザーホームにサブディレクトリを作成できません。

  • ロボット・エージェントをWindowsサービスとして起動する場合は、必要な環境変数を定義していない可能性があります。

ロボット・エージェントの起動

ロボット・エージェントをはじめて起動するときには、その環境がパブリックインターネットにアクセスできるか、または必要なドメイン名またはCIDR範囲をネットワークの許可リストに追加している必要があります。 次のいずれかのステップを実行します。

  • VPNを一時的に無効にするなど、コンピュータがパブリック・インターネットにアクセスできることを確認します。

  • 必要なWebサイトに環境がアクセスできるように、ネットワークの許可リストを更新します。 ネットワークの許可リストの更新を参照してください。

さらに、管理者としてコマンド・プロンプトを実行します。 次に、ロボット・エージェントをもう一度起動してみてください。 Install and Start the Robot Agentを参照してください。

将来、ロボット・エージェントをもう一度起動すると、エージェントは引き続きパブリックインターネットへのアクセスを必要とする場合があります。 設計の考慮事項を参照してください。

Windowsサービスとしてのロボット・エージェントの起動

「ロボット・エージェントを自動的に起動」を参照してください。

Failed saving the modified InstallerProfile configuration file

Oracle Integrationは、ロボット・エージェントの構成ファイルを更新できませんでした。 Oracle Integrationは、構成ファイルから機密値を削除し、変更に関するコメントをファイルに追加する必要があります。

管理者としてコマンド・プロンプトを実行してから、ロボット・エージェントの起動を再試行してください。 Install and Start the Robot Agentを参照してください。

Failed to create environment in the control room or update Agent.properties file.

ロボット・エージェントのインストール中に問題が発生しました。 たとえば:

  • ロボット・エージェントのインストール・パラメータが正しくありませんでした。

  • ロボット・エージェントはOracle Integrationに登録できませんでした。

  • Agent.propertiesファイルを更新できませんでした。

ネットワークでコンピュータがOracle Integrationにアクセスできるようになっていることを確認します。 「ネットワーク構成の確認」を参照してください。

次に、ネットワークでコンピュータがパブリック・インターネットにアクセスすることを許可していることを確認します。 このアクセスは、ロボット・エージェントをはじめて起動するときに必要です。 Install and Start the Robot Agentを参照してください。

最後に、ロボット・エージェントを起動するユーザーが、コンピュータにファイルを保存するために必要なファイルシステム・アクセス権を持っていることを確認します。

Format of minimum supported version or current running agent version is not correct.

ロボット・エージェントのJARファイルのファイル名には、ロボット・エージェントのバージョン番号(0.1.80など)が含まれなくなりました。

JARファイルのファイル名を、ロボット・エージェントのバージョン番号を含む元の名前にリストアします。 正しい形式がわからない場合は、エージェントを再度ダウンロードして、JARファイルをロボット・エージェントのディレクトリにコピーできます。 「ロボット・エージェントのダウンロード」を参照してください。

Got an exception while generating IDCS Access Token

資格証明マネージャで問題が発生しました。 たとえば:

  • InstallerProfile.cfgファイルで、IDCS_CLIENT_ID=またはIDCS_CLIENT_SECRET=の値を指定していないか、値が正しくない可能性があります。

  • ロボット・エージェントを起動しているユーザーには、資格証明ストアへのアクセス権がありません。

値の確認

InstallerProfile.cfgファイルで使用したIDCS_CLIENT_ID=またはIDCS_CLIENT_SECRET=の値を確認します。

値が欠落または無効な場合は、次のステップを実行します:

  1. ロボット・エージェントをダウンロードし、Agent.propertiesおよびInstallerProfile.cfgファイルをロボット・エージェントをインストールしたディレクトリにコピーします。

    「ロボット・エージェントのダウンロード」を参照してください。

  2. ロボット・エージェントの構成ファイルの更新

  3. ロボット・エージェントをインストールして起動する

管理者としてロボット・エージェントを起動

管理者(またはsudo権限を持つ)としてコマンド・プロンプトを実行し、ロボット・エージェントの再起動を試行します。 Install and Start the Robot Agentを参照してください。

InstallerProfile.cfg or Agent.properties file is either missing fields or has invalid data

InstallerProfile.cfgファイルまたはAgent.propertiesファイルが変更され、有効ではなくなりました。

  1. ロボット・エージェントをダウンロードし、Agent.propertiesおよびInstallerProfile.cfgファイルをロボット・エージェントをインストールしたディレクトリにコピーします。

    「ロボット・エージェントのダウンロード」を参照してください。

  2. ロボット・エージェントの構成ファイルの更新

  3. ロボット・エージェントをインストールして起動する

No value passed to -jar argument for agent jar. Wrong arguments passed

または

Unable to retrieve the -jar argument value. Wrong arguments passed

ロボット・エージェントの起動に使用したコマンドに、1つ以上のパラメータがありませんでした。 たとえば、コマンドに必須パラメータが含まれていない場合や、コマンド・プロンプトに設定されていない環境変数がコマンドに含まれている場合があります。

正しいパラメータが含まれるようにコマンドを更新します。 Install and Start the Robot Agentを参照してください。

RPA Agent is supported on JDK version 1.17 and above, please install or upgrade JDK/JVM to run RPA Agent.

Java Development Kit (JDK) 17は、コンピュータまたは仮想マシンにインストールされていません。

Java Development Kit (JDK) 17をコンピュータまたは仮想マシンにインストールします。 「ロボット・エージェントの要件を満たす」を参照してください。 

User agent set to: Oracle-JavaSDK/2.56.0 (Mac OS X/14.3.1; Java/17.0.8; Java HotSpot(TM) 64-Bit Server VM/17.0.8+9-LTS-211)
Exception in thread "main" com.oracle.bmc.model.BmcException: Error returned by GetAgentVersion operation in Agent service.(401, NotAuthenticated, false) The required information to complete authentication was not provided or was incorrect. (opc-request-id: debugging_identifier/debugging_identifier/debugging_identifier)
Timestamp: timestamp
Client version: robot_agent_version
Request Endpoint: endpoint
Troubleshooting Tips: See https://docs.oracle.com/en-us/iaas/Content/API/References/apierrors.htm#apierrors_401__401_notauthenticated for more information about resolving this error
Also see  for details on this operation's requirements.
To get more info on the failing request, you can enable debug level logs as mentioned in `Using SLF4J for Logging section` in https://docs.oracle.com/en-us/iaas/Content/API/SDKDocs/javasdkconfig.htm.
If you are unable to resolve this Agent issue, please contact Oracle support and provide them this full error message.
	at com.oracle.bmc.http.internal.ResponseHelper.throwIfNotSuccessful(ResponseHelper.java:160)

Agent.propertiesファイルで問題が発生しました。

ロボット・エージェント用の解凍されたファイルを含むフォルダに移動し、Agent.propertiesファイルを削除します。

次に、エージェントを再度起動します。

エラーが発生しない場合の処理

各ステップが完了したら、エージェントの実行を再試行してください。

ステップ 考慮事項 詳細情報

1

ロボット・エージェントのコンピュータは、ロボット・エージェントのシステム要件を満たしていますか。

たとえば、正しいバージョンのJDKがインストールされていないか、JAVA_HOMEが設定されていない可能性があります。

システム要件を参照してください

2

ロボット・エージェントのコンピュータにはインターネット・アクセスがありますか。

ネットワークでアクセス可能なwebサイトに移動し、ページがロードされていることを確認します。

コンピュータがインターネットにアクセスできない場合は、ネットワーク管理者と協力してこの問題を修正してください。

3

ネットワークは、ロボット・エージェントのコンピュータがOracle Integrationにアクセスすることを許可していますか。

ロボット・エージェントがインストールされているコンピュータからOracle Integrationにサインインします。

サインインできない場合は、ネットワークがIPアドレスに基づいてインターネットへのアクセスを制限することがあります。

管理者と協力して、エグレス・ルールでOracle IntegrationのインバウンドIPアドレスへのアクセスが許可されていることを確認します。 それ以外の場合、ロボット・エージェントはOracle Integrationにアクセスできません。

「Oracle Integration 3のプロビジョニングと管理」の「Oracle IntegrationインスタンスのインバウンドIPアドレスおよびアウトバウンドIPアドレスの取得」を参照してください。

4

ロボット・エージェントに機密アプリケーションが存在し、アクティブですか。

機密アプリケーションは、ロボット・エージェントがOAuthプロトコルを使用してOracle Integrationに安全に接続できるようにするOAuthクライアント・アプリケーションです。

「機密アプリケーションがアクティブであることの確認」を参照してください。

5

ロボット・エージェントの構成ファイルは正しく定義されていますか。

ファイルの更新ステップについては、「ロボット・エージェントの構成ファイルの更新」を参照してください。

6

ロボット・エージェントがインストールされているフォルダ名またはディレクトリにスペースがありますか。

フォルダ名にスペースを含めないか、ロボット・エージェントを起動できません。

また、Oracleでは、ディレクトリ・パスにスペースを含めないことをお勧めします。

7

サービス要求の入力

これらのステップをすべて完了しても、ロボット・エージェントがまだ実行されない場合は、サービス・リクエスト(SR)を入力してサポートからヘルプを取得します。 リクエストとともにロボット・エージェントのログファイルを含めます。 「ロボットまたはロボット・エージェントのログファイルのダウンロード」を参照してください。