How to fully reinstall ODMAD dirsync agent (4381266)

How to fully reinstall ODMAD dirsync agent

Sometimes there's a need to fully reinstall Quest ODMAD dirsync agent. How to do that safely?

There are several things that should be taken into an account when dealing with ODMAD dirsync agents:

• dirsync agents are tied to their registration keys/regions. They are not transferrable to another machine. When agent is uninstalled and its registry information deleted, the new registration key must be generated. 
• dirsync agents today can be staggered on the same machine, running multiple instances in order to save on machine. Each agent's instance is stored in the registry under the HKEY_LOCAL_MACHINE\SOFTWARE\Quest\On Demand Migration For Active Directory\ODMAD_DS\Agent# where # is agent's number, starting with 0. This number is not important for the backend and only needed for the agent's service for enumeration. 
• if agent is uninstalled and its registry wiped, then attempt to reinstall the agent with the same Registration Key, will generate the error: "The registration key you entered is already in use"

If agent was uninstalled with the registry wipe, please go to the ODMAD menu, Environments, select the affected environment, Agents and delete/archive the agent. Then generate a new agentID (registration key) there. 

Reinstallation with the new registration key, registry wiping, and deletion/archival of the agent in the ODMAD console is considered a "full reinstall". 

=== DISCLAIMER ===

Support does not provide support for problems that arise from improper modification of the registry. The Windows registry contains information critical to your computer and applications. Make sure you back up the registry before modifying it. For more information on the Windows Registry Editor and how to back up and restore it, refer to Microsoft Article ID 256986 “Description of the Microsoft Windows registry” at Microsoft Support.

Dirsync Agents are having a Display Name, that are shown in environment's Agents list as well as in the registry under each HKEY_LOCAL_MACHINE\SOFTWARE\Quest\On Demand Migration For Active Directory\ODMAD_DS\Agent# entry. If you simply need to remove Agent0 agent, while retaining other 2 instances (when there are 3 agent instances on the same machine for example), please uninstall the instance using standard Add/Remove procedure, then delete the Agent0 registry key. After that, please rename key Agent1 to Agent0, then Agent2 to Agent1. Please make sure that On Demand agent service is stopped while registry is being manipulated. Also, make sure to backup your registry prior to any modifications.