MachPanel Knowledgebase

HOW TO:ADSync Utility Update to v5.1.0.0 HF2 (Updated 14th September 2023)



This article provides information on how to update ADSync tool to latest v5.1.0.0 HF2

Applies To

This article applies to ADSync v4.3 or v5.0

Procedure To Update:

You can directly update from v4.3/v5.0 to v5.1.0.0 HF2 using this update.

You will need to download the ZIP file from link given at bottom of this article, Ensure the Zip file is "Unblocked"/"Unlocked" by checking from file Properties. Then Extract and use the appropriate x64 or x86 files based on your server OS.

There are two options:

a. Auto update: If you want to let the update process run automatically, please run ADSync.UpdateInstaller.exe from the extracted files. Please use "Run as Administrator" option. It will perform couple of reboots on its own to complete the update. Also, you need to run registry file (ADSync.PolicyLogger.reg) from update directory once update process is completed.

b. Manual update: To Update manually please follow below steps:

  1. Remove entry “ADSyncPolicy” from “HKEY_LOCAL_MACHINE\System\CurrentControlSet\Control\LSA\Notification Packages“.
  2. Reboot Domain controller.
  3. Replace “ADSyncPolicy.dll, ADSync.PolicyLogger.dll and ADSync.ClientHelper.dll” files in "$windir\System32".
  4. Stop ADSyncSvc using Services.
  5. Replace "ADSync.ClientHelper.dll, ADSync.ConfigStudio.exe and ADSyncSvc.exe" in installation folder of ADSync
    Example "C:\Program Files\MachSol\ADSync".
  6. Add entry “ADSyncPolicy” to  “HKEY_LOCAL_MACHINE\System\CurrentControlSet\Control\LSA\Notification Packages“.
  7. Double click or run “ADSync.PolicyLogger.reg” file to update the linked assembly version in windows registry.
  8. Reboot the machine.
  9. Repeat Step 1-8 for all additional/secondary/backup domain controllers.
Improvements / New Features
  • Custom sync attribute for user sync

  • Security update to clear renewed password from cache on data upload.

  • User mapping screen/UI load time optimizations.

  • Configurable active directory user’s attribute for storage of sync information (previously it was fixed to ‘division’ attribute).

  • Clearance of stored password hash from cache (storage attribute) once data is uploaded to the hosted CP.

  • User mapping restricted on the basis of UPN only. (Previously it was considering display name too for mapping. It was causing mismatched mappings, hence removed).

  • Changed error message with more user friendly one when wrong admin credentials are specified.

Resolved / Fixed Issues
  • Handled error when there is no object in the OU selected for Sync in Client AD.

Download link for ADSync Update Files: ADSync v. HF2


Type: HOW TO
Level: Aadvanced
Last Modified: Last Month
Last Modified By: rehan_waseem
Rated 5 stars based on 1 vote
Article has been viewed 3K times.
Also In This Category