Troubleshooting on-prem clients installation
This guide provides troubleshooting tips and solutions for common issues encountered during the installation and configuration of on-prem clients (OPC).
Tip
To view a comprehensive status report of your on-prem client installation, run the following command in your terminal: .\opc-management-tool | echo.
Symptoms:
When attempting 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.
Cause:
This is typically caused by insufficient file permissions or MacOS Gatekeeper restrictions.
Solution:
Move the application to the Shared folder.
Open Terminal and execute the following command:
xattr -cr opc-management-tool.app
Symptoms:
In the On-prem Client Management Tool, clicking Connect results in a 403 (Forbidden) error.
Cause:
This error usually occurs when the connection requires an active VPN.
Solution:
Ensure your VPN is enabled and try again.
Symptoms:
Microsoft Edge can't read and write to its data directory.
Cause:
This occurs if opc-management-tool.exe is run without administrative privileges.
Solution:
Open Task Manager and find
msedgewebview2.exein the Details tab.Right-click it, go to Properties > Compatibility, and select Run this program as an administrator.
Symptoms:
Extractor status is "unlinked" with SunCertPathBuilderException in the logs.
Cause:
The network proxy is overriding certificates or Java is missing the required CA certificates.
Solution:
Import the certificates using the Java keytool:
keytool -v -cacerts -storepass changeit -importcert -alias cel_root.pem -file ~/path/to/cert