✖
 
 

GINA/Mac/Linux installation

Before users can reset passwords from their Mac logo screen, admins have to deploy the logon agent on the users’ machines in one of the following ways: 

  1. Client software installation from the ADSelfService Plus admin console
    1. Navigate to the  Configuration → Administrative Tools → GINA/Mac/Linux (Ctrl+Alt+Del).
      2. gina-mac-install-consolemode
    2. Click  GINA/Mac/Linux Installation.
    3. In the New Installation section, choose the required  Domain from the drop-down.
    4. Click Add OUs to select the OUs for which the logon agent should be installed. Click Get Computers. 
    5. Now, select the computers to which the logon agent needs to be pushed.
    6. Click Install.
  2. Manual installation of the client software: 

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

    Manual installation for Windows clients
    1. Paste the MSI package (Location: C:\ManageEngine\ADSelfService Plus\bin) in the client machine. 
    2. Begin the Client Software Setup Wizard and complete the required steps. 

    Manual installation for macOS clients
    1. Copy the ADSelfServicePlusMacLoginAgent.pkg (Location: install_dir>/bin/) file to the Mac client machine.
    2. Double-click the ADSelfServicePlusMacLoginAgent.pkg file to begin the installation process. 
    3. 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.
      4. gina-mac-install-manual-mac
    4. Enter the ADSelfService Plus server name and port number when prompted.
      5. gina-mac-install-manual-mac
    5. In the window that opens, click Close to complete the installation.

    Manual installation for Linux clients
    1. Copy the installLinuxAgent.sh, ‌ADSSPLinuxClient.tar.gz from this folder: <Install Directory>\bin (Default location: C:\ManageEngine\ADSelfService Plus\bin). 

      2. Note:

      You need to copy the TAR file based on the client OS architecture. There will be two TAR files: 

      1. ADSSPLinuxClient.tar.gz for i686 clients (32-bit)
      2. ADSSPLinuxClient64.tar.gz for x86-64 clients (64-bit)
    2. Paste the copied files in the Home folder of the Linux machine.
    3. Launch the Linux terminal and execute the following commands:
      1. sed -i 's/\r$//' installLinuxAgent.sh 
      2. sudo bash installLinuxAgent.sh -install -serverName <adssp-server/IP> -portNumber <adssp-server-port> -protocol <adssp-server-protocol>
        3. Where:
        1. serverName = The name of the machine in which ADSelfService Plus is deployed.
        2. portNumber = The port number using which ADSelfService Plus is running. 
        3. protocol = The protocol with which ADSelfService Plus is running (http or https).
  3. Installation via GPO 

    4. Click here for the installation steps.

  4. Installation via SCCM 

    5. Click here for the installation steps.

Copyright © 2020, ZOHO Corp. All Rights Reserved.