A Robot Agent Doesn't Start
If you're unable to start a robot agent, whether for the first time or after stopping it, use the troubleshooting steps to get back on track.
Issue
You cannot stop the robot agent, either immediately after you installed it or after someone stopped it.
Why It Happens
This issue typically occurs when the robot agent can't connect to Oracle Integration, or when the configuration of the robot agent requires some adjustments. Keep reading for step-by-step instructions on how to troubleshoot.
How to Troubleshoot Errors
The following errors could appear in the command line or the robot agent logs.
Error | What happened | Troubleshooting steps |
---|---|---|
|
The file name of the robot agent's JAR file no
longer contains the robot agent's version number, such as
|
Restore the file name of the JAR file to the original name, including the robot agent's version number. If you aren't sure of the correct format, you can download the agent again and copy the JAR file into your robot agent's directory. See Download the Robot Agent. |
or
|
Oracle Integration was unable to write values to or retrieve values from the computer's local keystore. This error typically appears when a user doesn't have sufficient privileges. For example, one administrator might have downloaded the robot agent, and a second administrator is trying to start the robot agent. The second administrator might not be able to access the credential manager on the computer. |
Run the command prompt as an administrator, and then try starting the robot agent again. See Start the Robot Agent. |
|
One of the following issues occurred:
|
Check whether the folder name or directory contains a space. If so, remove the spaces from the directory, update the command to start the robot agent appropriately, and try again. If no spaces are in the folder name or directory, review the command that you used to start the robot agent. update the command so that it contains the full directory to the JAR file. See Start the Robot Agent. |
or
or
|
The robot agent's version is no longer compatible with Oracle Integration. |
Update to a newer version of the robot agent. See Download the Robot Agent. |
or
|
The environment on which you installed the robot agent doesn't have access to the public internet and is unable to download the required dependencies. |
The environment must be able to access the public internet when you start the robot agent for the first time. Ensure that the computer has access to the public internet, such as by temporarily disabling the VPN, and try starting the robot agent again. Depending on the robot's interactions, it might need access to the public internet in general. See Design Considerations. |
|
This error can occur when you're trying to start the robot agent or trying to start the robot agent as a Windows service.
|
Starting the robot agent The environment must be able to access the public internet when you start the robot agent for the first time. Ensure that the computer has access to the public internet, such as by temporarily disabling the VPN, and try starting the robot agent again. Depending on the robot's interactions, it might need access to the public internet in general. See Design Considerations. Additionally, run the command prompt as an administrator, and then try starting the robot agent again. See Start the Robot Agent. Starting the robot agent as a Windows service |
|
Oracle Integration was unable to update the robot agent's configuration file. Oracle Integration must remove sensitive values from the configuration file and add a comment to the file about the change. |
Run the command prompt as an administrator, and then try starting the robot agent again. See Start the Robot Agent. |
|
An issue occurred during the installation of the robot agent. For example:
|
Confirm that your network allows the computer to access Oracle Integration. See Review Your Network Configuration. Next, confirm that your network allows the computer to access the public internet. This access is required the first time that you start the robot agent. See Start the Robot Agent. Finally, ensure that the person who starts the robot agent has the require file system permissions to save files on the computer. |
|
The file name of the robot agent's JAR file no
longer contains the robot agent's version number, such as
|
Restore the file name of the JAR file to the original name, including the robot agent's version number. If you aren't sure of the correct format, you can download the agent again and copy the JAR file into your robot agent's directory. See Download the Robot Agent. |
|
The |
|
or
|
The command that you used to start the robot agent was missing one or more parameters. For example, the command might not contain a required parameter, or the command contains an environment variable that hasn't been set in the command prompt. |
Update the command so that it contains the correct parameters. See Start the Robot Agent. |
|
Java Development Kit (JDK) 17 isn't installed on the computer or virtual machine. |
Install Java Development Kit (JDK) 17 on the computer or virtual machine. See Meet the Robot Agent's Requirements. |
|
An issue has occurred with the
|
Navigate to the folder that contains the unzipped
files for the robot agent, and delete the
Next, try starting the agent again. |
What to Do if an Error Doesn't Occur
After completing each step, try running the agent again.
Step | Consideration | More information |
---|---|---|
1 |
Does the robot agent's computer meet the system requirements for the robot agent? |
For example, the correct version of the JDK might not be installed, or the JAVA_HOME might not be set. See System Requirements. |
2 |
Does the robot agent's computer have internet access? |
Navigate to a website that your network allows you to access, and confirm that the page loads. If the computer doesn't have internet access, work with a network administrator to correct this issue. |
3 |
Does your network allow the robot agent's computer to access Oracle Integration? |
Sign in to Oracle Integration from the computer that the robot agent is installed on. If you are unable to sign in, your network might restrict access to the internet based on IP address. Work with an administrator to ensure that the egress rules allow access to the inbound IP address for Oracle Integration. Otherwise, the robot agent cannot access Oracle Integration. See Obtain the Inbound and Outbound IP Addresses of the Oracle Integration Instance in Provisioning and Administering Oracle Integration 3. |
4 |
Does a confidential application exist for the robot agent, and is it active? |
A confidential application is an OAuth client application that allows robot agents to securely connect to Oracle Integration using the OAuth protocol. |
5 |
Is the robot agent's configuration file defined correctly? |
For step-by-step instructions on updating the file, see Update the Robot Agent's Configuration File. |
6 |
Is there a space in the folder name or directory where the robot agent is installed? |
Do not include any spaces in the folder name, or you cannot start the robot agent. Additionally, Oracle recommends not including any spaces in the directory path. |
7 |
Is there a space in the home directory of the computer? |
Even if you don't install the robot agent to the home directory, the robot agent must create files in the home directory. The robot agent is unable to create the files if the home directory contains any spaces. For information about how to create a new home directory and specify the new home directory in the startup command for the robot agent, see Start the Robot Agent. |
8 |
Enter a service request |
If you complete all of these steps and the robot agent still won't run, get help from Support by entering a service request (SR). Include the log files for the robot agent with the request. See Download the Log File for a Robot or Robot Agent. |