The Migrator Pro for Active Directory Agent is a key component of Active Directory migration. The agent contacts the Migrator Pro for Active Directory server at regular intervals, called polling, looking for jobs and tasks to perform.

Refer to the Requirements for to verify all workstations and servers meet the requirements for agent installation.

Agent Installation

The agent can be installed using a GPO (Group Policy Object) or manually.

To install the agent with a GPO:

  1. Right-click on the Migrator Pro for Active Directory Agent MSI, point to Share with, and click on specific people.
  2. Add a security group. The "authenticated users" group already includes all computers and is a good group to use. The group you add must have the shared Read permission and NTFS permission.
  3. Click Share.
  4. Click Done.
  5. From the Start menu, point to Administrative Tools and click on Group Policy Management.
  6. Right-click on the domain or OU you will be migrating and click on Create a GPO in this domain, and link it here.
  7. In the New GPO dialog box, enter a Name for the GPO and click OK.
  8. Click on the new GPO and click OK.
  9. Right-click on the GPO and select Edit.
  10. Open Computer Configuration > Policies > Software Settings and right-click on Software Installation and then point to New and click on Package.
  11. In the File Name field, enter the UNC path to the MSI file and click Open.
  12. Select the Migrator Pro for Active Directory Agent and click Open.
  13. In the Deploy Software window, select the Assigned deployment method and click OK.
The computer must be rebooted for the applied group policy to complete the agent installation.

To verify the GPO:

  1. Log on to a workstation within the scope of the GPO using administrator credentials.
  2. From a command prompt on the workstation, run gpresult -r

  3. The Computer Settings section will display the applied group policy.

    A newly applied group policy will not immediately be displayed.

    The Computer Settings section displays the applied group policy, but the agent installation is not completed until the computer is rebooted.

To manually install the agent:

  1. Copy the Migrator Pro for Active Directory Agent MSI file to each computer.
  2. Double-click the file to open the installer.

  3. On the Welcome screen, click Next.

  4. On the Destination Folder screen, click Next.

  5. On the Enter Server URL screen, enter the FQDN of the server running the Migrator Pro for Active Directory service and click Next.

    Leave this screen blank if an SRV record has been created. See Creating SRV Records below for more information.

    If there is an SRV record found in the Domain, any entry manually entered during the agent install for the Server URI will be ignored.

  6. On the Ready to Install the Program screen, click Install.

  7. When the install completes, click Finish.

Refer to the Troubleshooting topic to resolve common agent install issues.

Creating SRV Records

The Migrator Pro for Active Directory Agent uses DNS to "autodiscover" the Migrator Pro for Active Directory server. An SRV (service location) record must be created in DNS to point the clients to the correct server or servers.

To create an SRV record using DNS Manager:

  1. In the DNS Manager, right-click on the DNS server and click on Other New Records.
  2. In the Resource Record Type dialog, select the Service Location (SRV) type and click Create Record.
  3. In the New Resource Record dialog, enter "_btadm" in the Service field.
  4.  Enter the following information for HTTP or HTTPS:

    • For HTTP:

      Protocol: _http

      Priority: 0

      Weight: 0

      Port Number: 80

      Host offering the service: the FQDN of server running the Migrator Pro for Active Directory service.

    • For HTTPS:

      Protocol: _https

      Priority: 0

      Weight: 0

      Port Number: 443

      Host offering the service: the FQDN of server running the Migrator Pro for Active Directory service.

    You can make SRV records using HTTP, HTTPS, or both protocols. Using HTTPS is suggested for increased security. If both protocols are used, the agent will always attempt to use HTTPS first.

  5. Click OK.

Every client running the agent software must be able to resolve the DNS records.

To verify the clients can resolve the SRV DNS records:

  1. Open a command prompt on the client machine.
  2. Run nslookup -q=srv _btadm._http.source.int where "http" is the protocol: http or https, and "source.int" is the name of the source domain.