Installing Multiple Data Quality (DQ) Sync Clients with Longrun

This page walks through the steps to install a dev and a test tenant DQ Sync Client on the same application server.

• Network requirements for installing Multiple DQ Sync Clients
• Steps to download and run the DQ Sync Clients
• Common trouble shooting scenarios

Networking Prerequisites

The following set of URLs need to be accessible from the Sync Client installation location.

Example Wildcard

*.n5o.blue
*.augr.aunsight.com

Example Explicit Hostnames

auth.n5o.blue
dq.augr.aunsight.com
live.augr.aunsight.com

Note

These are all examples for *augr.aunsight.com. Your actual hostname may differ.

Protocols

Protocol	Port
HTTPS	443
WSS	443

Guide

Step 1: Download both DQ Sync Client and Longrun to the application server.

 [DQ Sync Client Download](https://s3.amazonaws.com/downloads.n5o.io/releases/syncdq/Naveego.Sync.DQ.3.7.2.zip)

 [Longrun Download](https://s3.amazonaws.com/downloads.n5o.io/tools/longrun.exe)

Step 2: Unpack the DQ Sync zip file contents to C:\Program Files (x86)\Naveego\Sync.

Step 3: Create two new folders in the same directory called DevProcess and TestProcess.

Step 4: Copy the contents of the Process folder into both DevProcess and TestProcess.

Step 5: Copy longrun.exe into C:\Program Files (x86)\Naveego\Sync.

Step 6: Place longrun.json into C:\Program Files (x86)\Naveego\Sync using the example below:

    {
      "dflogurl": "",
      "proxy": "",
      "daemon": {
        "services": [
          {
            "id": "[DEV TENANT ID]-Sync-Client",
            "tenantID": "[DEV TENANT ID]",
            "workingDir": "C:\\Program Files (x86)\\Naveego\\Sync\\DevProcess\\",
            "cmd": "Naveego.Sync.Process.exe C:\\ProgramData\\Naveego\\DevSync\\client.json",
            "runPolicy": {
              "maxAttempts": 10,
              "restartMilliseconds": 1000,
              "restartBackoff": 3
            },
            "logging": {
              "resource": "[DEV TENANT ID] Sync Client",
              "resourceID": "[DEV TENANT ID]-Sync-Client",
              "resourceType": "sync-client"
            }
          },
          {
            "id": "[TEST TENANT ID]-Sync-Client",
            "tenantID": "[TEST TENANT ID]",
            "workingDir": "C:\\Program Files (x86)\\Naveego\\Sync\\TestProcess\\",
            "cmd": "Naveego.Sync.Process.exe C:\\ProgramData\\Naveego\\TestSync\\client.json",
            "runPolicy": {
              "maxAttempts": 10,
              "restartMilliseconds": 1000,
              "restartBackoff": 3
            },
            "logging": {
              "resource": "[TEST TENANT ID] Sync Client",
              "resourceID": "[TEST TENANT ID]-Sync-Client",
              "resourceType": "sync-client"
            }
          }
        ]
      }
    }

Step 7: Create a new folder at C:\ProgramData\Naveego\Sync\DevSync and C:\ProgramData\Naveego\Sync\TestSync.

Step 8: Place the dev Sync Client client.json in the DevSync folder.

    {
      "replicationPointer": 0,
       "authToken": "[REPLACE WITH TOKEN]",
        "authUrl": https://auth.n5o.blue/bearer/oauth2/syncclienttoken,
        "client": {
           "id": "[REPLACE WITH GUID]",
           "name": "[REPLACE WITH NAME]",
           "status": "deploying",
           "host": "",
           "installDate": "2022-11-28T18:56:58.0824276+00:00",
           "repository": "[REPLACE WITH TENANT ID]",
           "apiUrl": https://dq.augr.aunsight.com,
           "liveUrl": https://live.augr.aunsight.com,
           "version": "3.7.2",
           "timeZone": "America/New_York"
      }
    }

Step 9: Place the test Sync Client client.json in the TestSync folder.

Step 10: Open an admin command prompt window.

Step 11: Navigate to cd C:\Program Files (x86)\Naveego\Sync.

Step 12: Install Longrun service longrun.exe install --config "C:\\Program Files (x86)\\Naveego\\Sync\\longrun.json" --name "Naveego Sync".

Step 13: Open Windows Services and alter the newly created service Naveego Sync as desired (change log on, set startup to automatic, etc.).

Step 14: Start Naveego Sync service.

Trouble Shooting

TLS Mismatch

A TLS mismatch happens if you need to force strong cryptography on the application server.

Help Article

Step 1: Open registry editor.

Step 2: Add the below keys to the registry.

Windows Registry Editor Version 5.00

[HKEY_LOCAL_MACHINE\SOFTWARE\WOW6432Node\Microsoft\.NETFramework\v2.0.50727]
"SystemDefaultTlsVersions"=dword:00000001
"SchUseStrongCrypto"=dword:00000001

[HKEY_LOCAL_MACHINE\SOFTWARE\WOW6432Node\Microsoft\.NETFramework\v4.0.30319]
"SystemDefaultTlsVersions"=dword:00000001
"SchUseStrongCrypto"=dword:00000001

[HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\.NETFramework\v2.0.50727]
"SystemDefaultTlsVersions"=dword:00000001
"SchUseStrongCrypto"=dword:00000001

[HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\.NETFramework\v4.0.30319]
"SystemDefaultTlsVersions"=dword:00000001
"SchUseStrongCrypto"=dword:00000001