Troubleshooting the Linux login agent installation

Below is the list of errors that may arise while installing the login agent in Linux machines and the solutions to resolve the error:

• The network path was not found.

• Connection timed out.

• Connection refused.

• Permission denied / Insufficient privileges to the service account.

• Invalid service account credentials.

• Invalid service account credentials.

• The operation failed while setting up dependencies.

1. The network path was not found.

   Possible cause: This error could occur if the target computer could not be contacted.

   Solution:

   • Ensure if such a computer really exists. If so, ensure that it is connected to the network.
   • To check for connectivity, ping this computer from the server where ADSelfService Plus has been installed.

2. Connection timed out.

   Possible cause: The Linux machine, in which you are trying to install the login agent, is shut down or not connected to the domain network.

   Solution:

   • Start the client and ensure that it is connected to the domain network. Check the connection by pinging the machine from the ADSelfService Plus server. Once you're sure there is a connection, try to install the agent again.
   • If the connection to the machine is fine, then check the Linux client's integration with AD.

3. Connection refused.

   Possible cause: SSH server software is not active in the Linux client.

   Solution: Make sure the SSHD service is installed and active in the Linux client.

4. Permission denied / Insufficient privileges to the service account.

   Possible cause: Service account configured in ADSelfService Plus does not have the required root privilege over the targeted Linux client.

   Solution: Provide root privilege to the service account by following the steps below:

   • Go to the Terminal window and execute the command sudo visudo. Then, navigate to the #User privilege specification section. In the %admin ALL=(ALL) ALL replace %admin with the username i.e., <username> ALL=(ALL) ALL.

5. Invalid service account credentials.

   Possible cause: Invalid or expired service account credentials in the Domain Settings.

   Solution: Update the correct service account credentials.

   • Log in to ADSelfservice Plus with admin privileges.
   • Go to Domain Settings.
   • Click the edit button and provide the service account credentials with the required privileges.

6. No authentication details found for the domain.

   Possible cause: Insufficient privileges for the service account in the Domain Settings of ADSelfService Plus.

   Solution: Provide the service account credentials with domain admin privileges.

7. The operation failed while setting up dependencies.

   Possible causes: Poor network connection. The Linux distribution's package manager is unable to contact the software repository or the ADSelfService Plus web portal.

   Solution:

   • The Linux distribution's package manager needs to contact the respective software repository while setting up dependencies. Check network connectivity in the Linux machine. If the network connection is good, check and ensure that the package manager can contact the respective software repository (For instance, Yum for Fedora/CentOS).
   • The lightdm-webkit2-greeter package needs to be installed from the ADSelfService Plus web portal. Please check if the Linux client machine is able to contact it.