Endpoint Central Agent Installation Failure - Mac/Linux Troubleshooting Guide
You are unable to install the Endpoint Central agent on computers running Mac/Linux operating systems.
Ensure SSH & SCP communication is enabled:
Verify remote connectivity:
Root user configuration (Linux):
Verify user permissions:
Check for disconnection or insufficient disk space:
By following the steps for the corresponsing error remarks, you should be able to identify and resolve the issue preventing Endpoint Central Agent installation on your Mac/Linux computers.
Error Message | Description | Resolution | ||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
No Agent Available/Installed | Trying to uninstall a non-existent agent. | Ensure the agent is installed before uninstalling. | ||||||||||||
Agent up to date | Agent already has the latest version. | No action required. | ||||||||||||
AgentUpgrade Required | Lower version agent detected. | Upgrade will be automatic if communication allows, otherwise uninstall and reinstall manually. | ||||||||||||
Agent Need to uninstall & reinstalled | Mismatch between agent version and server details. | Uninstall and reinstall the agent manually. | ||||||||||||
Unable to push installer files | Permission issues, unavailable path, or missing files. | Verify permissions and ensure /tmp is not mounted with "noexec" permission. | ||||||||||||
Install failed due to unknown reason | Unknown error during installation. | Refer to server logs for detailed information. | ||||||||||||
Root permission denied | Insufficient user permissions. | Configure a user with root or sudo access. | ||||||||||||
Uninstall failed due to unknown reason | Unknown error during uninstallation. | Refer to server logs for detailed information. | ||||||||||||
Failed to establish connection | Target computer unreachable from the server. | Ensure the target computer is reachable. | ||||||||||||
Agent install fails if other probe managed agent encountered | Agent already managed by a different probe. | N/A (Agent cannot be managed by this probe). | ||||||||||||
Linux agent installation unknown architecture | Unsupported endpoint architecture. | Linux agent only supports AMD and ARM architectures. | ||||||||||||
Unable to locate the agent directory for uninstallation | Agent not properly installed. | Ensure the agent is properly installed. | ||||||||||||
Agent Installation failed. Incorrect agent OS type error | Incorrect OS type chosen for installation/uninstallation. | Choose the correct OS type. | ||||||||||||
Server to Agent reachability issues | Various connection issues. |
|
||||||||||||
Agent endpoint authentication error | Invalid username/password provided. | Use the correct credentials. |
Other KB articles | 24/5 Support |
---|---|
Support will be available 24hrs a day and five days a week (Monday through Friday), excluding USA & India public holidays. Tel : +1-888-720-9500 Speak to us |