Manual Installation Of Client Software:

 

An alternative method for the "Client Software Installation" is to manually install the software onto the client machines.


To view the "MSI package" for Windows or "PKG file" for Mac, navigate to the location where the ADSelfService Plus has been installed and select the "Bin" folder.
.

Steps To Be Followed For The Manual Installation Of The Client Software :

 

For Windows Clients:


Copy & paste the 'MSI package' onto the Windows computers (where the Client Software is to be installed), then

  1. Right click on the 'MSI package' & click on 'Install'

  2. The "ADSelfService  Plus Client Software Setup Wizard" will appear. Click

  3. "Next" to continue

  4. Select Installation Folder" page would appear

  5. To select  the "location of your choice" - for the installation of the Client Software - click on "Browse" and select the desired location

  6. Click on "Next" to  continue "ADSelfService Plus Server Details" page would open up

    • Provide the "Name of the ADSelfService Plus Server" in the respective text box provided

    • Follow it up with the "Port Number of the ADSelfService Plus Server".Declare the port number  in the "HTTP" mode ( this version is also compatible with the "HTTPS" mode)

  7. Click on "Next" to continue

  8. "Confirm Installation" page would appear, click on "Next" to go ahead with the installation

  9. This would lead you to the "Installation Complete" page, where the message "ADSelfService Plus Client Software  has been  successfully  installed" would be displayed

  10. Click on "Close" button to exit the "GINA/CP Client Software Setup Wizard".

Manual Installation Via Command Prompt:

 

It is also possible to install the "GINA/CP Client Software" with the help of "Command Prompt" instead of using the "GINA/CP Client Software Setup Wizard".


The command which is executed for the Installation process  is "msiexec /iADSelfServicePlusClientSoftware.msi SERVERNAME=selfservice.xyz.com PORTNO=8888 /qn".


For Mac Clients:


ADSelfService Plus login agent for Mac OS X lets Active Directory domain users using Mac clients to reset their passwords and unlock their accounts from the OS X login screen itself. Please follow the steps given below to deploy the password self-service login agent to Mac clients:


Note: The ADSelfService Plus login agent for Mac supports clients running OS X 10.6 and above.


Installation Steps:

  1. Locate the Mac OS X login agent for password self-service in ADSelfService Plus installation folder. It can be found at <install_dir>/bin/ADSelfServicePlusMacLoginAgent.pkg.

  2. Copy the ADSelfServicePlusMacLoginAgent.pkg file to the Mac clients.

  3. Double-click the ADSelfServicePlusMacLoginAgent.pkg file to begin the installation process.

  4. In the Introduction window, click Continue

  5. Mac OS X Login Agent Installation - Introduction Window
  6. In the Installation Type window, select the install location and click Install.

  7. Mac OS X Login Agent Installation - Install Location
  8. After you click the Install button you will be asked to enter your username and password. Please use the account information you used to log on to your Mac.

  9. Mac OS X Login Agent Installation - Authentication
  10. Enter the ADSelfService Plus server name and port number when prompted

  11. Mac OS X Login Agent Installation - Server Name

    Mac OS X Login Agent Installation - Port Number
  12. In the Summary window, click Close to complete the installation.

  13. Mac OS X Login Agent Installation - Summary
  14. Once the installation is complete, a Reset Password/Unlock Account button will appear on the login screen.

  15. Mac OS X Login Agent Installation - Login Screen

Customization Steps:

This section describes how to customize the various features of the ADSelfService Plus's Mac OS X login agent. Features such as Server Name, Port Number, Button Text & Icon can be customized by editing the file config.plist stored in /Library/Application Support/ADSSPLoginAgent/. Follow the steps below to customize the login agent:


Steps to configure Server Name & Port Number:

  1. Open Terminal

  2. Run this script to change the server name: sudo /usr/libexec/PlistBuddy -c 'set :SERVERNAME 192.168.43.90' "/Library/Application Support/ADSSPLoginAgent/config.plist". Replace 192.168.43.90 with the server name or IP address of ADSelfService Plus server.

  3. Please enter the username and password you used to log on to your Mac client when asked for user credentials.

  4. Run this script to change the port number: sudo /usr/libexec/PlistBuddy -c 'set :PORTNUMBER 8443' "/Library/Application Support/ADSSPLoginAgent/config.plist". Replace 8443 with the port number of ADSelfService Plus.

  5. Go to login screen and confirm the changes.

Steps to customize the Icon & Button Text:

  1. Open Terminal

  2. To change the icon, use this script: sudo /usr/libexec/PlistBuddy -c 'set :IMAGEPATH /Users/testuser/Desktop/sample-icon.png' "/Library/Application Support/ADSSPLoginAgent/config.plist". Replace the path to the image with the path to your own icon.

  3. Please enter the username and password you used to log on to your Mac client when asked for user credentials.

  4. To change the button text(Reset Password/Unlock Account text which will be displayed on the logon screen), use this script: sudo /usr/libexec/PlistBuddy -c 'set :BUTTONTEXT Forgot Password?' "/Library/Application Support/ADSSPLoginAgent/config.plist". Replace Forgot Password? with your own text.

  5. Go to login screen and confirm the changes.

  6. Note: In case, the specified icon source is not available default icon will be loaded.


Uninstallation Steps:

  1. Open Terminal

  2. Open /Library/PrivilegedHelperTools/

  3. Del ADSSPLoginAgent

  4. Go to login screen and confirm the changes.

For Linux Clients


Important

  1. What happens after you install the Linux login agent in your machine?

    • A System User named adssp_linux_logon is created.

    • The following packages will be installed on your system:

      1. LightDM package

      2. lightdm-webkit2-greeter package

      3. python-gi-dev package

      4. Light-locker package

    • The Linux login agent should not be installed using the root account.

Installation Steps

  1. Copy the installLinuxAgent.sh, webkit2_greeter_theme.html and webkit.py files from this folder: Install Directory>\bin (Default location: C:\ManageEngine\ ADSelfService Plus\bin).

  2. Paste the copied files in the Home folder of the Linux machine.

  3. Launch the Linux terminal and execute the following commands:

    sed -i 's/\r$//' installLinuxAgent.sh
    sudo bash installLinuxAgent.sh -install -serverName myserver -portNumber myport -protocol myprotocol

    Where,

    1. serverName = The name of the machine in which ADSelfServicePlus is deployed.

    2. portNumber = The port number using which ADSelfServicePlus is running.

    3. protocol = The protocol using which the ADSelfServicePlus is running (http/https)

    Client Software Parameters (optional)
    1. title = ""(Enter an appropriate title text)

    2. linkText = ""(Enter an appropriate link text)

    3. contextPath = ""(Enter the command "sudo bash installLinuxAgent.sh -contextPath ssp" where 'ssp' is your context path)

  4. Reboot the system.

Customization Steps

  1. Copy the installLinuxAgent.sh, webkit2_greeter_theme.html and webkit.py files from this folder: Install Directory>\bin (Default location: C:\ManageEngine\ ADSelfService Plus\bin).

  2. Paste the copied files in the Home folder of the Linux machine.

  3. Launch the Linux terminal and execute the following commands:

    sed -i 's/\r$//' installLinuxAgent.sh
    sudo bash installLinuxAgent.sh -customize -title 'ManageEngine-ADSelfServicePlus' -linkText 'Reset/Unlock Account' -serverName myserver -portNumber myport -protocol myprotocol

    If you want to change the context path enter following command "sudo bash installLinuxAgent.sh -contextPath ssp" replace 'ssp' with your context path. If you want to remove context path that is previously set, use the following command "sudo bash installLinuxAgent.sh -contextPath noContextPath".

Uninstallation Steps:

  1. Copy the installLinuxAgent.sh file from this folder: Install Directory>\bin (Default location: C:\ManageEngine\ ADSelfService Plus\bin).

  2. Paste the copied files in the Home folder of the Linux machine.

  3. Launch the Linux terminal and execute the following commands:

    sed -i 's/\r$//' installLinuxAgent.sh
    sudo bash installLinuxAgent.sh -uninstall

  4. Reboot the system.

Reinstallation Steps:

  1. Copy the installLinuxAgent.sh file from this folder: Install Directory>\bin (Default location: C:\ManageEngine\ ADSelfService Plus\bin).

  2. Paste the copied files in the Home folder of the Linux machine.

  3. Launch the Linux terminal and execute the following commands:

    sed -i 's/\r$//' installLinuxAgent.sh
    sudo bash installLinuxAgent.sh -reinstall -serverName myserver -portNumber myport -protocol myprotocol

  4. Reboot the system.

Version Check Steps:

  1. Copy the installLinuxAgent.sh file from this folder: Install Directory>\bin (Default location: C:\ManageEngine\ ADSelfService Plus\bin).

  2. Paste the copied files in the Home folder of the Linux machine.

  3. Launch the Linux terminal and execute the following commands:

    sed -i 's/\r$//' installLinuxAgent.sh
    sudo bash installLinuxAgent.sh -version

Copyright © 2019, ZOHO Corp. All Rights Reserved.
ManageEngine