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:
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
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.