Managing Capture Agent
Capture Agent is required to track changes to the user passwords in the Active Directory domain you want to be the authoritative source for password synchronization operations. To synchronize passwords, you must install Capture Agent on each domain controller in the source Active Directory domain.
Whenever a password changes in the source Active Directory domain, the agent captures that change and provides the changed password to the One Identity Quick Connect Sync Engine. In turn, the One Identity Quick Connect Sync Engine uses the provided information to synchronize passwords in the target connected systems according to your settings.
In this section:
Installing Capture Agent manually
You can use this method to manually deploy Capture Agent on each domain controller in the source Active Directory domain.
To manually install Capture Agent
- Run one of the following files supplied with the One Identity Quick Connect Sync Engine installation package:
- On a 32-bit domain controller, run the file QuickConnectCaptureAgent_x86.msi.
- On a 64-bit domain controller, run the file QuickConnectCaptureAgent_x64.msi.
- Step through the wizard to complete the agent installation.
Using Group Policy to install Capture Agent
You can use this method to automatically deploy Capture Agent on each domain controller in the source Active Directory domain. This method is applicable in the following scenarios only:
Table 14: Prerequisites by scenario
|
Scenario 1: AD domain includes either 32- or 64-bit domain controllers |
All the domain controllers must be held in a single organizational unit (for example, the built-in Domain Controllers OU).
At least one group policy object must be linked to the OU holding the domain controllers (for example, the built-in Default Domain Controllers Policy Group Policy object). |
|
Scenario 2: AD domain includes both 32- and 64-bit domain controllers |
The domain controllers must be held in two separate organizational units, each containing domain controllers of the same bitness.
At least one group policy object must be linked to each of the two organizational units. |
The next steps apply to both these scenarios.
To install Capture Agent by using Group Policy
- Save the QuickConnectCaptureAgent_x86.msi and QuickConnectCaptureAgent_x64.msi files supplied in the Quick Connect installation package to a network share accessible from each domain controller in the source Active Directory domain.
- Depending on your scenario, complete the steps in the table:
Table 15:
Steps by scenario
- Use Group Policy Editor to open the group policy object linked to the OU holding the domain controllers on which you want to install Capture Agent.
- In the Group Policy Object Editor console tree, do one of the following:
- In Windows Server 2003 or Windows Server 2003 R2, expand the Computer Configuration node, and then select Software Settings.
- In a later version of Windows Server, expand the Computer Configuration node, then expand Policies, and select Software Settings.
- In the details pane, click Software Installation, on the Action menu point to New, and then click Package.
- Use the dialog box to open one of the following files:
- QuickConnectCaptureAgent_x86.msi if all your domain controllers are 32-bit.
- QuickConnectCaptureAgent_x64.msi if all your domain controllers are 64-bit.
- In the Deploy Software dialog box, select Assigned, and then click OK.
|
- Use Group Policy Object Editor to open the group policy object linked to the OU holding the 32-bit domain controllers.
- Do one of the following in the Group Policy Object Editor console tree:
- In Windows Server 2003 or Windows Server 2003 R2, expand the Computer Configuration node, and then select Software Settings.
- In a later version of Windows Server, expand the Computer Configuration node, then expand Policies, and select Software Settings.
- In the details pane, click Software Installation, on the Action menu point to New, and then click Package.
- Use the dialog box to open the QuickConnectCaptureAgent_x86.msi file.
- In the Deploy Software dialog box, select Assigned, and then click OK.
- Repeat steps 1-5 for the group policy object linked to the OU holding the 64-bit domain controllers. Use the QuickConnectCaptureAgent_x64.msi file to install Capture Agent on these domain controllers.
|
Run the following command at a command prompt to refresh the Group Policy settings:
gpupdate /force
Uninstalling Capture Agent
To uninstall Capture Agent
- On the computer where Capture Agent is installed, open the list of installed programs:
- In Windows Server 2003 or Windows Server 2003 R2, open Add or Remove Programs in Control Panel.
- In a later version of Windows, open Programs and Features in Control Panel.
- In the list of installed programs, select Dell One Identity Quick Connect Capture Agent.
- Uninstall the agent:
- In Windows Server 2003 or Windows Server 2003 R2, click Remove.
- In a later version of Windows, click Uninstall.
- Follow the on-screen instructions to uninstall Capture Agent.
