Troubleshooting on-prem clients installation
We've gathered some resources and troubleshooting tips that will help you resolve some problems you might encounter with on-prem client installation.
Tip
For comprehensive information about your on-prem client's installation status, from your terminal, run .\opc-management-tool | echo.
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:
Go to the Shared folder.
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:
Open Task Manager.
In the Details tab, search for
msedgewebview2
Right-click any of the msedgewebview2.exe executables and go to its properties.
In the Compatibility tab, select Run this program as an administrator.
Click OK.
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:
In the On-prem Client Management Tool, uninstall all deamons from the Automation Agent and SAP Extraction tabs.
Close the On-prem Client Management Tool.
Move the on-prem client package to the home folder and try the installation again.
Symptoms
When trying to verify the on-prem client installation using the verification URL received from the IT Admin, Celonis Platform displays the Access denied error.
Cause:
This error occurs when the verification is done by a user with insufficient Celonis Platform rights.
Solution:
Make sure you have Celonis Platform admin rights before you verify the on-prem clients installation.