Skip to main content

Celonis Product Documentation

Troubleshooting on-prem clients installation

We've gathered some resources and troubleshooting tips that will help you resolve your problems with on-prem clients installation.

Symptoms

When trying to open the opc-management-tool.app on MacOS, the following error is displayed:

"opc-management-tool.app" is damaged and can't be opened. You should move it to the Bin.

Cause

The most common root cause of this issue is missing privileges.

Solution

To resolve this problem:

  1. Go to the Shared folder.

  2. Open Terminal and issue the following command:

    xattr -cr opc-management-tool.app

Symptoms

In the On-prem Client Management Tool, when you click Connect to Celonis Platform to request code authorization the following error is displayed:

Error: request for device code authorisation returned status 403 (Forbidden).

Cause

The error usually occurs when a VPN is required for connecting.

Solution

Enable your VPN and try again.

Symptoms:

The On-prem Client Management Tool returns the following error during the installation:

Microsoft Edge can't read and write to it's data directory. 
C:\Users{admin-account}\AppData\Roaming{wails-app-name}.exe\EBWebView"

Cause:

This error can occur when the opc-management-tool.exe is run using a non-admin account.

Solution:

Using a non-admin user account:

  1. Open Task Manager.

  2. In the Details tab, search for

    msedgewebview2
  3. Right-click any of the msedgewebview2.exe executables and go to its properties.

  4. In the Compatibility tab, select Run this program as an administrator.

  5. Click OK.

  6. Open the opc-management-tool.exe again.

Symptoms:

On MacOS, in the On-prem Client Management Tool, when you click Connect to Celonis Platform to request code authorization the error related to launchctl is displayed.

Cause:

This error can occur when the On-prem Client Management Tool is run from a folder on which MacOS has permissions restrictions like the Download folder or Desktop.

Solution:

  1. In the On-prem Client Management Tool, uninstall all deamons from the Automation Agent and SAP Extraction tabs.

  2. Close the On-prem Client Management Tool.

  3. Move the on-prem client package to the home folder and try the installation again.