Chat now with support
Chat with Support

Directory Sync Pro for Active Directory 20.11.4 - Installation Guide

Introduction Directory Sync Pro Prerequisites Directory Sync Pro Advanced Network Requirements Migrator Pro Prerequisites Common Requirements for Directory Sync Pro and Migrator Pro Installing Directory Sync Pro and Migrator Pro Upgrading Directory Sync Pro and Migrator Pro Modifying, Repairing and Uninstalling Directory Sync Pro and Migrator Pro Migrator Pro Agent Installation Troubleshooting Appendix A: Configuring Directory Sync Pro in a Non-English Active Directory Environment Appendix B. Installing and Configuring SQL Server Reporting Services Appendix C. STIG Environments Appendix D. Deployment in FIPS Environment Appendix E. Invalid and Expired Licenses

Internet Requirement for Online Help and Video Tutorials

Installing Directory Sync Pro and Migrator Pro

The Directory Sync Pro and Migrator Pro installer can be used to install bothDirectory Sync Pro and Migrator Pro at the same time or individually. Migrator Pro should only be installed at the same time as Directory Sync Pro or if it has previously been installed on the same server.

This guide includes the steps for installing Directory Sync Pro and Migrator Pro at the same time. Installing Directory Sync Pro first and running the installer again to install the Migrator Pro components is another option.

The installer creates a local group on the Directory Sync Pro server named BTDirSyncPro and will add the currently logged in user to the group. Other users or a Domain group can be added to provide access to other users.

It is recommended to select “SQL Server Authentication” during the Directory Sync Pro/Migrator Pro server console installation if multiple people will be accessing the Directory Sync Pro/Migrator Pro web user interfaces.  Otherwise, if “Windows Authentication” is chosen during installation, create a security group in AD and assign DB Owner rights to the Directory Sync Pro SQL databases and add all the users that need access to the console as members.

Installing Directory Sync Pro and Migrator Pro on a Windows Server

  1. Download the installation package from the Quest Support site and save it on the Quest Windows Server.

  2. Double-click the executable to begin installing Migrator Pro. The Welcome screen appears. Click Next to continue.

  1. The License Agreement screen appears. To accept the terms of the license agreement and continue with the install, select “I accept the terms in the license agreement” and click Next.

     

  2. The Setup Type screen appears.

  • Select Default Installation to install Directory Sync Pro and/or Migrator Pro with the default configuration options. A series of screens will appear while installing the needed databases and features. The Install Wizard Completed screen will appear when done.

    The SQL Server Authentication Password screen will appear during installation. Enter a password to use during SQL installation and click Install.

  • Select the Advanced Installation option to review and set the configuration options for the installation. The Install Wizard will continue to the next step.

     

  1. The SQL Option screen appears. Select to use an existing SQL server or to install SQL Express and then click Next. If you choose to install SQL Express, a series of installation screens will appear while SQL Express is being installed.

An existing SQL server must be used in STIG environments. SQL Express does not meet STIG requirements. Please see Appendix C. STIG Environments for more information.

  1. The SQL Server Authentication Password screen will appear during installation. Enter a password to use during SQL installation and click Install.

  2. The Installation screen appears and will remain open. The Recommended Components screen will appear in a separate window. You will be prompted if there are applications using files that need to be updated by the installer.

  3. The Recommended Components for This Computer screen appears. By default, only the Directory Sync Pro components are selected. To install Migrator Pro, select the Directory Sync Pro / Migrator Pro Console, Migrator Pro, and (optionally) Migrator Pro Reports components and click Next to continue.

  4. The Installation Directory screen appears. Both Directory Sync Pro and Migrator Pro are installed in the same directory. Click Browse to choose a different install location. Click Next to continue.

  1. The Device Log Virtual Directory screen appears. Click Browse to choose a different location where device logs will be written. Click Next to continue.

  2. The File Location for Download Jobs screen appears. Click Browse to choose a different location where download jobs will be saved. Click Next to continue.

  1. The Database Server Login screen appears. Enter the SQL Database Server location, credential information, and database name. Click Next to continue. If you choose to install SQL Server Express, the installer will populate the 'sa' account and default password. This password should be changed according to your organizations password complexity policy prior to configuring the product databases on the Database Server Login screen.

  2. The Database Server Login screen appears again, this time for the logging database. Enter the SQL Database Server location for the logging database, credential information, and database name. Click Next to continue.

  1. If you selected to connect using Windows Authentication on the previous screen, a screen to enter domain username and password appears. Enter the domain user in DOMAIN\username format and the password. Click Next to continue.

  2. The SQL Passphrase screen appears if the passphrase was never entered on the current machine. The passphrase is required because once a database has been stamped with a passphrase, subsequent installs that reference the same database require the same passphrase. Enter the passphrase that was used during the initial installation of the SQL database. Click Next to continue.

  1. If you selected to install the optional Reporting feature, the SQL Report Server screen appears. Enter the Report Server URL and select the appropriate Connection Credential and Data Credential options. Clicking the Test button to verify the SSRS connection credential is a best practice. See the Appendix of this document for information on verifying the Report Server URL. Click Next to continue. If SQL Server Reporting Services (SSRS) is not set up, click Skip and OK on the confirmation window.

 

The Connection Credential requires an account that has the Content Manager role and the System Administrator role defined on the SQL Server Reporting Server.

The Data Credential requires an account that has permission on the SQL Server Reporting Services database. These permissions are typically the database-level roles db_datareader and db_datawriter but should be verified by the SQL Server Reporting Services database administrator.

Reports will not appear in the Migrator Pro Console UI if the installation of the Reporting feature is skipped.

To install the Reporting feature at a later time, select to Modify the installation from the Programs and Features page in the Control Panel. 

When an AD credential is used as the Data Credential on the SQL Report Server screen in the Migrator Pro installer, the Windows Credential check box is not checked. This will need to be changed manually in the DataSource in the Report Server after installation is completed.

 

  1. The Ready to Install screen appears. Click Install to begin the installation.

  2. When the installation completes, the InstallShield Wizard Complete message appears. Click Finish.

Also, click Finish on the Installation window.

If upgrading from a previous version of Directory Sync Pro, you must delete the C:\Windows\BTPass folder from all domain controllers being used in the Directory Sync Pro profiles. A new version of BTPass will be pushed to the domain controllers on the next sync.

 

  • The Apps screen or Start Menu is updated and the Migrator Pro and Directory Sync Pro icons are added to the desktop.

    Apps screen:

    Desktop icons:

Upgrading Directory Sync Pro and Migrator Pro

Directory Sync Pro and Migrator Pro can be upgraded to a new version without uninstalling the existing version. The install wizard will detect the necessary changes and manage the upgrade.

Related Documents

The document was helpful.

Select Rating

I easily found the information I needed.

Select Rating