On-prem Agent troubleshooting
Below you can find some error messages and proposed solutions for frequently occurring issues during setting up the Celonis Agent.
For Action Flows - Agent 1.0.0 and higher (Windows)
You can restart your agent via Windows Services, following these steps:
Search for "Component Services" in the Windows search bar.
Locate "Services(local)" on the left hand side and open it as Admin.
Look for "Celonis SAP Extractor" or "Celonis Agent" and right-click on it.
Click Restart.
If you're seeing the following error message in your logs, it means that your computer can't find an up-to-date Java version. If that's the case, please try the following steps:
 |
Install the latest version of Java if you haven't done so yet.
Uninstall all previous Java versions on your computer.
Restart the Agent via Windows Component Services.
If you're getting stuck in the following screenshot, please follow the steps below:
 |
1. Make sure the following drivers are up and running on your PC:
2. Restart the installation process.
If you're seeing the following screenshot, please make sure to install Java 11 or above on your machine:
 |
Make sure to use this installation (Windows 64-bit installation in the list!) instead of the one you find when simply googling "Java installation".
First, make sure to run the installer as administrator by right-clicking on it and then selecting "Run as Administrator". If that doesn't help and you encounter the following error, please contact Internal IT Support.
 |
Windows cannot access <path> Celonis_SAP_Components_Installer_3.4.0.exeThis is caused by an issue with your machine's privileges. Please contact your internal IT administrator.
2023-04-21 04:33:25.764 [main] INFO c.c.a.c.h.s.ProxyHttpRequestFactoryBase - Proxy not configured, requests will not go through the proxy. 2023-04-21 04:33:47.620 [main] WARN c.c.a.a.c.s.CloudConnectionService - Request failed: POST '/agents' - I/O error on POST request for https://krones-sb.eu-1.celonis.cloud/process-automation-broker/api/v2/agents: Read timed out; nested exception is java.net.SocketTimeoutException: Read timed out2023-04-21 04:33:25.764 [main] INFO c.c.a.c.h.s.ProxyHttpRequestFactoryBase - Proxy not configured, requests will not go through the proxy.2023-04-21 04:33:47.620 [main] WARN c.c.a.a.c.s.CloudConnectionService - Request failed: POST '/agents' - I/O error on POST request for https://krones-sb.eu-1.celonis.cloud/process-automation-broker/api/v2/agents: Read timed out; nested exception is java.net.SocketTimeoutException: Read timed out
Make sure the config proxy value is provided with no quotation marks (" ") and try again.
Unauthenticated proxies are currently not supported by the Agent. Please recheck application-local.yml and your local proxy.yml file that you have linked for the proxy authentication. You can find all the necessary information on Configure Application.yml for Celonis Agent.
Error when configuring unauthenticated Proxy
Caused by: java.lang.IllegalArgumentException: Username may not be null
Correct Setup of Agent with Proxy
As a workaround to start the proxy, insert the following dummy values including the quotation marks in the proxy.yml file:
username ("-") and password ("-") - for unauthenticated proxy access, please do not leave it empty.
proxy.yml
enabled: true host: [placeholder host] port: [placeholder port] user: "-" password: "-"
Download and replace both the JCo Native library file and the JAR file to the 3.1 version.
Minimum version that we support is Jco 3.1 (see Connect to SAP)
Please check out other Troubleshooting areas ...
If the problems concerns a SAP module in your Action Flow, please check out Troubleshooting pages for SAP.
If another action is concerned, please check out the corresponding documentation for that module.
If you cannot find a solution in this documentation, please reach out to the ServiceDesk.
For Action Flows - Agent 1.0.0 and higher - MacOS
Make sure to ONLY have Java 11 installed (e.g. not Java 17).
How to check?
Go the your terminal and enter: java --version
Investigate the output. Find an sample output below, where openjdk 11.0.12 is installed which is necessary for the installation of the agent.
Get it here for macOS x64: https://github.com/adoptium/temurin11-binaries/releases/download/jdk-11.0.12%2B7/OpenJDK11U-jdk_x64_mac_hotspot_11.0.12_7.pkg
When running the service the sapjco3.dylib won't open?
How to overcome this problem:
Click on Cancel.
Go to Apple menu > System Preferences > Security & Privacy > General and then click "Allow Anyway".
Run the service again.
Click Open.