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

  1. Click on "Next" to continue

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

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

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

  5. In the Installation Type window, select the install location and click Install.

    6. Mac OS X Login Agent Installation - Install Location

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

    7. Mac OS X Login Agent Installation - Authentication

  7. Enter the ADSelfService Plus server name and port number when prompted

    8. Mac OS X Login Agent Installation - Server Name

    Mac OS X Login Agent Installation - Port Number

  8. In the Summary window, click Close to complete the installation.

    9. Mac OS X Login Agent Installation - Summary

  9. Once the installation is complete, a Reset Password/Unlock Account button will appear on the login screen.

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

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