Skip to main content

Celonis Product Documentation

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
  • You can restart your agent via Windows Services, following these steps:

  • 1. Search for 'Component Services' in the Windows search bar.

  • 2. Locate 'Services(local)' on the left hand side and open it as 'Admin'.

  • 3. Look for 'Celonis SAP Extractor' or 'Celonis Agent' and right-click on it.

  • 4. Press '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:

50727048.png
  1. Install the latest version of Java if you haven't done so yet.

  2. Deinstall all previous Java versions on your computer.

  3. Restart the Agent via Windows Component Services.

If you're getting stuck in the following screenshot, please follow the steps below:

50726544.png

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:

50726435.png

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.

50726437.png

This is caused by an issue with your machine's privileges. Please contact Internal IT Support.

50726440.png

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, please 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: "-"

Please check out other Troubleshooting areas ...

  1. If the problems concerns a SAP module in your Action Flow, please check out Troubleshooting pages for SAP.

  2. If another action is concerned, please check out the corresponding documentation for that module.

  3. 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 section

When running the service the sapjco3.dylib won't open ?

How to overcome this problem:

1. Click on Cancel

2. Apple menu > System Preferences, click Security & Privacy, then click General and allow anyway

55707941.png

3. run the service again to get another message with 'open' option

55707940.png

4. click open

For Skills - Agent 0.4.4 and lower
Couldn't create SAP Client. Please Contact a Celonis Administrator. x is not a constructor
//
error: this.SapRfcClientConstructorFn is not a constructor

For Windows: Please check if the following Microsoft Visuasl C++ Packages are installed:

Microsoft Visual C++ Redistributable for Visual Studio 2013, available for download here: https://support.microsoft.com/en-us/help/3179560/update-for-visual-c-2013-and-visual-c-redistributable-package. If you are running Celonis Agent on the Extractor Server, please install this redistributable in addition to the one required for the Extractor. (Note: Celonis Agent requires MSVCP120.dll. MSVCP120.dll is part of the Visual C++ Redistributable Package for Visual Studio 2013 (vc_redist 2013) and is often required for running programs developed with Visual C++.)

Microsoft Visual C++ Redistributable Package (x64) for Visual Studio 2015-2019, available for download here: https://support.microsoft.com/en-us/help/2977003/the-latest-supported-visual-c-downloads

For more information, have a look at Set up server for Celonis Agent.

Please ensure that you have downloaded SAP NW RFC SDK:

Ensure that you have downloaded SAP NW RFC SDK 7.5 - available for download via SAP in SAP Note 2573790. This will require an SAP ID account, therefore it might be necessary to involve a stakeholder of your SAP Basis Team to download the SDK.

Verify if the correct operating system and architecture was selected e.g. Windows x64.

Inside the downloaded sdk, copy the lib directory found inside nwrfcsdk and paste it to the sap-lib folder in the agent package.

A way to check if the correct SDK has been installed, is by updating the user/system Path environment variable to contain the nwrfcsdk lib directory, and to try starting the rfcexec.exe file found in nwrfcsdk/bin. If it was installed correctly you will be able to see the following output:

41194756.png

For more information on the download and installation, have a look at Connect to SAP.

For 0.4.4 and higher, if starting the agent as a Windows service: Make sure the SAP NW RFC SDK is added to the Path system environmental variable

As described on the page Connecting to SAP, for an agent running as a windows service, the sap-lib/lib folder needs to be added to the Path system environmental variable.

error: Error: tunneling socket could not be established, cause=Client network socket disconnected ...

Please check if a proxy should be used to connect the Agent:

For more details on how to add proxy details, have a look at Configure Application.yml for Celonis Agent.

info: Task: x finished with errors. Cannot read property 'x' of undefined

(1) Are you using a custom Function Module?

If you are using a custom Function Module and have recently changed the input/output structure of it, please go to agent directory, look for assets/sap/{some hash value}/FUNCTION_MODULE_NAME.json and delete that json. It will be recreated automatically with an updated version.

(2) Please check if the users has the required permissions in SAP to execute the Action:

For more detailed information on SAP user permissions, have a look at SAP User Role CELONIS/AUTOMATION_BASIS or the required permissions described here.

(3) Issues with cached data

The structure of function modules is cached on agent side. To reset the caching, please delete everything within the assets/sap/ folder of the agent directory and restart the agent.

Could not execute RFM function. User XXX has no RFC authorization for

Please check if the users has the required permissions in SAP to execute the Action:

For more detailed information on SAP user permissions, have a look at SAP User Role CELONIS/AUTOMATION_BASIS or the required permissions described here. If you are using SAP release below 7.1, you might have to grant permissions on the corresponding function groups (as it is not possible to set permissions on function module level.

error: 302 - undefined
error: Something went wrong while registering the agent. Please try again later

Please check whether a proxy should be used to handle requests.

If in the host where the Agent is deployed outbound requests are not allowed and have to go through a proxy, the proxy settings have to be configured in the Agent. For more detailed information, have a look at Configure Application.yml for Celonis Agent

Please check the IP whitelisting of your Celonis team.

If you are using IP checks in your Celonis team, please ensure that the required IPs are whitelisted.

Note

This is how your function module dropdown should look like:

41195696.png

However, instead you can see strange characters in the BAPI names:

41195698.png

Please check if you are using the most recent Agent version and update if necessary.

Please update the entire package (all files).

For more detailed information, have a look at Download Celonis Agent Package.

Task: x finished with errors. Validation Error. Dependencies are missing: connection

Please check if your connection is correctly set up.

Please ensure that the user connection you are using is linked to the correct system connection (e.g. SAP) that you created for your Agent.

41195917.png

For more detailed information, have a look at Connections.

maximum number of concurrent executions reached

The number of concurrent executions is set to 100 by default. It can be adjusted in the application.yml.

For more detailed information, have a look at Configure Application.yml for Celonis Agent