# Agent Installation - Knowledge base

**Endpoint Central Agent Installation Failure - Mac/Linux Troubleshooting Guide**

## Problem

You are unable to install the **Endpoint Central** agent on computers running Mac/Linux operating systems.

## Causes

- **Pre-requisite failures:** SSH and SCP communication not enabled, network connectivity issues, invalid credentials, insufficient permissions.
- **Push failures:** User lacks permission to access specific directories, target computer disconnected, insufficient disk space.

## Resolution

### 1. Pre-requisites failure

**Ensure SSH & SCP communication is enabled:**

- **Linux:** Use the command `systemctl status ssh` or `service ssh status` to check the service status. Refer to [https://www.tecmint.com/install-openssh-server-in-linux/index.html](https://www.tecmint.com/install-openssh-server-in-linux/index.html) for setup instructions.
- **Mac:** Go to *System Preferences > Sharing > Enable File Sharing and Remote Login*.

**Verify remote connectivity:**

- Ensure you can connect to the target computer using its machine name via SSH. If only the IP address works, reconfigure DNS resolution.
- Verify the provided credentials match those in **Endpoint Central** server settings.
- Ensure the specified user has root or sudo access.

**Root user configuration (Linux):**

- Search for the file `/etc/ssh/sshd_config` in the Terminal.
- Ensure `PermitRootLogin` is set to "yes" and `PasswordAuthentication` is set to "yes".

### 2. Push Failure

**Verify user permissions:**

- Login via SSH and check if you can copy files to the `/tmp` directory.

**Check for disconnection or insufficient disk space:**

- Ensure the target computer remains connected throughout the process.
- Verify sufficient disk space on the target computer.

By following the steps for the corresponding 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. | See SSH error details below. |
| Agent endpoint authentication error | Invalid username/password provided. | Use the correct credentials. |

### SSH Error Details

| SSH Error | Description | Resolution |
|---|---|---|
| No such host | Server cannot locate/resolve the hostname. | Verify hostname accuracy. |
| Connection refused | Server cannot connect via SSH on port 22. | Ensure SSH service is running and port 22 is accessible. |
| Timeout | Connection attempt exceeded 30 seconds. | Improve network connectivity or troubleshoot slowness. |

If the problem still persists, you can contact **Endpoint Central** support with the below details:

- Error Screenshot
- Target machine name where the installation failed
- [Server logs](https://www.manageengine.com/products/desktop-central/logs-how-to.html)

## Other KB articles

- [Agent Installation](https://www.manageengine.com/products/desktop-central/knowledge-base.html#agent-installation)
- [Configurations](https://www.manageengine.com/products/desktop-central/knowledge-base.html#windows-configurations)
- [Inventory Management](https://www.manageengine.com/products/desktop-central/knowledge-base.html#inventory-management)
- [Patch Management](https://www.manageengine.com/products/desktop-central/knowledge-base.html#patch-management)
- [Software Distribution](https://www.manageengine.com/products/desktop-central/knowledge-base.html#software-distribution)
- [Service Pack Installation](https://www.manageengine.com/products/desktop-central/knowledge-base.html#service-pack-installation)
- [Desktop Sharing](https://www.manageengine.com/products/desktop-central/knowledge-base.html#remote-desktop-sharing)
- [Active Directory Reports](https://www.manageengine.com/products/desktop-central/knowledge-base.html#active-directory-reports)
- [User Logon Reports](https://www.manageengine.com/products/desktop-central/knowledge-base.html#user-logon-reports)
- [Endpoint Central SP Upgrade](https://www.manageengine.com/products/desktop-central/knowledge-base.html#service-pack-upgrade)
- [Miscellaneous](https://www.manageengine.com/products/desktop-central/knowledge-base.html#miscellaneous)

## 24/5 Support

Support will be available 24 hours a day and five days a week (Monday through Friday), excluding USA & India public holidays.

Tel: +1-888-720-9500  
Email: [endpointcentral-support@manageengine.com](mailto:endpointcentral-support@manageengine.com)

**Speak to us**

- Join the **Endpoint Central** Community to get instant answers for your queries, register with our [Forum](http://forums.manageengine.com/Desktop-Central).
- Look out for the latest happenings in Desktop Management, follow our Tweets on [Twitter](http://twitter.com/DesktopCentral).
- Get to know the latest updates and best practices in Desktop Management through our [Blog](http://blogs.manageengine.com/desktopcentral/index.html).