✖

- Related Products
- ADManager Plus

  Active Directory Management & Reporting

  Download | Demo
- ADAudit Plus

  Real-time Active Directory Auditing and UBA

  Download | Demo
- EventLog Analyzer

  Real-time Log Analysis & Reporting

  Download | Demo
- Exchange Reporter Plus

  Exchange Server Auditing & Reporting

  Download | Demo
- AD360

  Integrated Identity & Access Management

  Download | Demo
- Log360

  Comprehensive SIEM and UEBA

  Download | Demo

# Installation of the login agent on GINA, macOS, or Linux

## Supported platforms

Before users can reset passwords from their Windows, macOS, or Linux login screens, admins have to deploy the login agent on the users’ machines. The different platforms supported by the login agent are listed below.

### Windows

- Windows 10
- Windows 8.1
- Windows 8
- Windows 7
- Windows Vista

### Linux

- Ubuntu - 16.x-20.x
- Fedora - 27.x-31.x
- CentOS - 7.X

### macOS

- macOS 10.15 Catalina
- macOS 10.14 Mojave
- macOS 10.13 High Sierra
- macOS 10.12 Sierra
- OS X 10.11 El Capitan
- OS X 10.10 Yosemite
- OS X 10.9 Mavericks
- OS X 10.8 Mountain Lion
- Mac OS X 10.7 Lion
- Mac OS X 10.6 Snow Leopard

Note: While the ADSelfService Plus login agent has been officially tested to be compliant with these three Linux distributions, it may support other Linux distributions as well. Please contact the support team (support@adselfserviceplus.com) to check if the Linux distribution used in your organization is supported.

## Different methods to deploy the login agent:

The login agent can be deployed on users' machines in one of the following ways:

### A. From the ADSelfService Plus admin console

- Navigate to Configuration → Administrative Tools → GINA/Mac/Linux (Ctrl+Alt+Del).
- Click GINA/Mac/Linux Installation.
- Select the required Domain from the drop-down.
- Click Add OUs to select the OUs for which the login agent should be installed. Click Ok.
- In the New Installation section, select the computers to which the login agent needs to be pushed.
- Click Install.

Note: ADSelfService Plus now supports three different methods of Windows login agent installation to enhance the success rate. The three methods are:

- Remcom.
- PAExec.
- WMI.

When Remcom fails, PAExec is tried, and if that fails, WMI is implemented.

### B. Manual installation

You can manually install ADSelfService Plus' client software on users' Windows, macOS, and Linux machines.

For Windows clients

- Paste the ADSelfServicePlusClientSoftware.msi file (located at C:\ManageEngine\ADSelfService Plus\bin) in the client machine.
- Begin the Client Software Setup Wizard and complete the required steps.

For macOS clients

- Copy the ADSelfServicePlusMacLoginAgent.pkg file (located at install_dir>/bin/) to the Mac client machine.
- Double-click the ADSelfServicePlusMacLoginAgent.pkg file to begin the installation process.
- Once you click the Install button, you'll be asked to enter your username and password. Please use the account information you use to log on to your Mac.
- Enter the ADSelfService Plus server name and port number when prompted.
- In the window that opens, click Close to complete the installation.

For Linux clients

- Copy the installLinuxAgent.sh and the ADSSPLinuxClient.tar.gz files from this folder: <Install Directory>\bin (default location:
  C:\ManageEngine\ADSelfService Plus\bin).
Note: You need to copy the TAR file based on the client OS architecture. There will be two TAR files:

- ADSSPLinuxClient.tar.gz for i686 clients (32-bit)
- ADSSPLinuxClient64.tar.gz for x86-64 clients (64-bit)

- Paste the copied files in the Home folder of the Linux machine.
- Launch the Linux terminal and execute the following commands:

- sed -i 's/\r$//' installLinuxAgent.sh
- sudo bash installLinuxAgent.sh -install -serverName <adssp-server/IP> -portNumber <adssp-server-port> -protocol <adssp-server-protocol>
Where:

- serverName = The name of the machine that ADSelfService Plus is deployed on
- portNumber = The port number that ADSelfService Plus is running on
- protocol = The protocol with which ADSelfService Plus is running (HTTP or HTTPS)

### C. Via GPO

Click here for the installation steps.

### D. Via SCCM

Click here for the installation steps.

Note: The installation of the login agent via GPO and SCCM deployment methods is only applicable for Windows client software.

## Thanks!

Your request has been submitted to the ADSelfService Plus technical support team. Our technical support people will assist you at the earliest.

#### Need technical assistance?

- Enter your email ID
- Talk to experts

- By clicking 'Talk to experts', you agree to processing of personal data according to the Privacy Policy.

Copyright © 2021, ZOHO Corp. All Rights Reserved.