Upgrade the IDSync Active Directory Connector

Owned by Fernando Sayago (Unlicensed)
Last updated: Mar 11, 2022 by John Reed (Unlicensed)
4 min read

This guide describes the upgrade process for an IDSync Active Directory Connector

Step-by-step guide

  • Download the most recent version from the Azure content delivery network.

  • Expand the zip file and locate the Identity Syncronizer x64 xxx.exe file

  • Stop all IDSync services (IdentitySyncronizer, AgentService, and Syncronizer.Attendant services), close Identity Syncronizer Management Studio and any other files that are open from c:\program files\identity syncronizer

  • Rename the C:\Program Files\Identity Syncronizer\ directory  (usually, suffixing it with the date it was changed)

  • Run a backup of the Identity Syncronizer database

  • Run Identity Syncronizer x64 xxx.exe file as administrator and confirm that you want to upgrade the current version

Click Next and then Finish.

  • After the installation completes, restart the Syncronizer.Service.exe 

  • Review log file in C:\Program Files\Identity Syncronizer\ to ensure that API calls are resulting in proper responses from Autotask’s new API calls.


  • Use the Agent push function (Agent tab of the IDSync Management Studio) to push the updated IDSync agent and MMC components to each domain controller.


  • Run as Administrator the Syncronizer.Agent.Config.exe from 'C:\Program Files\Identity Syncronizer\'  on each domain controller in your environment (where you have the IDSync Agent installed) to ensure that the agent is installed and configured properly


  • Run as Administrator the Syncronizer.ManagementConsole.Installer.exe from 'C:\Program Files\Identity Syncronizer\'   on each domain controller in your environment (where you have the IDSync Agent installed) to ensure that the Autotask TAB in ADUC is updated on the domain controller


  • Depending on which version of IDSync the customer is currently using, it is possible that the upgrade will also install a new Agent.DLL file. The agent.dll is used for password capture.  That process has been optimized over the past few years and the newer Agent.DLL is desirable.  If the Agent.DLL file was upgraded, the domain controllers should be scheduled to be rebooted whenever is convenient to the customer.  This reboot does not have to happen at the time of the install, but the new Agent.DLL will not be used until after the reboot occurs. 


Autotask API User

The 1.6 API of Autotask requires that the user used to authenticate is an API User and not a regular user.  Here are the instructions on checking this and creating the API Uawe if needed.

API User Setup

SQL Updates

There may be a need to update some record values of Autotask support records.  Run these SQL statements against the IDSync database which will perform the update if needed.

update top (1) autotasktimeformat set value = 1 where value = 19 and gcrecord is null

update top (1) autotasktimeformat set value = 2 where value = 20 and gcrecord is null

update top (1) autotasktimeformat set value = 3 where value = 21 and gcrecord is null

IDSync Management Studio App

Go to the Autotask tab

  • Click on the License Key tab on the left and in the right pane click on the 3-dot ellipse to the right of the license key
  • Click on the Sync UDF’s tab on the left and click on the Sync button at the top.