Skip to main content
Skip table of contents

Setting up DirSync Client for Windows

System Requirements

To ensure the smooth operation of the Retarus DirSync Client for Windows, ensure your system meets the following requirements:

  • Operating system
    Minimum Windows XP / Server 2003 (Windows 7 or higher, or Windows Server 2008 R2 or higher, are recommended); both 32-bit and 64-bit systems are supported.

  • Microsoft .NET Framework
    Version 4.0 or higher.

  • Memory
    At least 1 GB is recommended, depending on the directory size being queried.

  • Hard disk space
    A minimum of 500 MB of free space is recommended, depending on the size of the log and archive files to be retained.

  • Network requirements

    • Internet access via HTTPS on port 443.

    • Network access to domain controllers’ Active Directory service, typically on Microsoft’s default port 389 (TCP/UDP), or port 3268 (TCP) if querying the Global Catalog.

  • Bandwidth
    A minimum internet bandwidth of 256 kbit/sec is recommended, depending on the size of the directory to be queried.

  • Email capability
    If email logs or error reports are needed, the ability to send email via SMTP is required.

The DirSync Client for Windows does not require a dedicated system and can be run on existing infrastructure machines, provided they meet the above requirements.

Architecture

The software has been programmed in C#, using the .NET Framework version 4. Only native Microsoft libraries have been used. The software neither uses nor depends on third party libraries.

All operational tasks, including querying the directory and transmitting information to Retarus, are managed by a locally installed Windows service at the customer site.

License and liability

The program and its documentation are supplied free of charge as a courtesy of Retarus GmbH with no obligations or liabilities whatsoever. Customers run this software at their own risk and are not entitled to officially request or receive support for this tool. They can request the source code of the software to verify its procedures and operations, and they may compile the source code for their own usage. However, customers are not entitled to alter or distribute the software or any of its sources or to use it or any parts or sources of it for other purposes without the prior and explicit permission by Retarus.

Any information, documentation, or sources that the customers or their agents have possession of are the intellectual property of Retarus and are subject to the privacy regulations and non-disclosure agreements between the customer and Retarus.

Installation

The DirSync Client for Windows can be installed using the provided setup routine.

Administrative user privileges are required to install the client as a service. Any command line prompts must be opened in administrative mode:

  1. Run the RetarusDirSyncSetup.exe installation file and follow the on-screen instructions. The client is installed in the default directory - %ProgramData%\Retarus\DirSync.
    To install the service in a different location, refer to the manual installation steps below.

  2. On the final screen, activate the Start services management console option (or launch the Windows Services management console manually after completing the setup) and start the Retarus DirSync Client for Windows.

Known Issue
On certain systems, an error message displaying "Error Code 1076" may appear when attempting to start the Retarus DirSync Client for Windows for the first time. If this occurs, please try starting the client again, and it should start successfully.

  1. Configuration of the Retarus DirSync Client for Windows is performed by directly editing the configuration file, as detailed in the following sections.

Uninstallation

The Retarus DirSync Client can be uninstalled using the Windows built-in uninstallation functionality. However, note that this process will not automatically delete configuration and log files.

JavaScript errors detected

Please note, these errors can depend on your browser setup.

If this problem persists, please contact our support.