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 . In turn, the uses the provided information to synchronize passwords in the target connected systems according to your settings.
In this section:
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 installation package:
- On a 32-bit domain controller, run the file SyncServiceCaptureAgent_8.0.1_x86.msi.
- On a 64-bit domain controller, run the file SyncServiceCaptureAgent_8.0.1_x64.msi.
You can find these files in the Solutions folder on the Active Roles distribution media.
- Step through the wizard to complete the agent installation.
You can perform an unattended installation of Capture Agent as follows.
To perform an unattended installation
On a 32-bit system, enter the following syntax at a command prompt:
msiexec /i "<Path to SyncServiceCaptureAgent_8.0.1_x86.msi>" /qb
INSTALLDIR="<Path to installation folder>" REBOOT="<Value>"
On a 64-bit system, enter the following syntax at a command prompt:
msiexec /i "<Path to SyncServiceCaptureAgent_8.0.1_x64.msi>" /qb
INSTALLDIR="<Path to installation folder>" REBOOT="<Value>"
In the above syntax:
Table 121: Arguments
INSTALLDIR |
Specifies the installation folder for the Capture Agent. When this argument is omitted, the following default installation folder is used:
%ProgramFiles%\One Identity\Active Roles\8.0.1\SyncServiceCaptureAgent |
REBOOT |
Allows you to suppress a system restart in a situation where a restart is required for the Capture Agent installation to complete.
To suppress the restart, use the following syntax: REBOOT="ReallySupress" |
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 122: 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.
|
To install Capture Agent by using Group Policy
- Save the SyncServiceCaptureAgent_8.0.1_x86.msi and SyncServiceCaptureAgent_8.0.1_x64.msi files 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 123: 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, in Windows Server 2016 or later, 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:
SyncServiceCaptureAgent_8.0.1_x86.msi if all your domain controllers are 32-bit.
or
SyncServiceCaptureAgent_8.0.1_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.
- In the Group Policy Object Editor console tree, in Windows Server 2016 or later, 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, then click Package.
- Use the dialog box to open the SyncServiceCaptureAgent_8.0.1_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 SyncServiceCaptureAgent_8.0.1_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
To uninstall Capture Agent
- To open the list of installed programs on the computer where Capture Agent is installed, in Control Panel, open Programs and Features.
- In the list of installed programs, select One Identity Active Roles 8.0.1 - Synchronization Service Capture Agent x64 or One Identity Active Roles 8.0.1 - Synchronization Service Capture Agent x86.
- Click Uninstall to uninstall the agent.
- Follow the on-screen instructions to uninstall Capture Agent.