Skip to content

Commit d9d2785

Browse files
authored
Merge pull request #57755 from douglaslMS/sync-agent-updates
Added clarifications about cmd line usage per devs.
2 parents 5059287 + 3ba9e6e commit d9d2785

File tree

1 file changed

+13
-5
lines changed

1 file changed

+13
-5
lines changed

articles/sql-database/sql-database-data-sync-agent.md

Lines changed: 13 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -11,7 +11,7 @@ author: allenwux
1111
ms.author: xiwu
1212
ms.reviewer: douglasl
1313
manager: craigg
14-
ms.date: 11/08/2018
14+
ms.date: 11/12/2018
1515
---
1616
# Data Sync Agent for Azure SQL Data Sync
1717

@@ -25,8 +25,14 @@ To download the Data Sync Agent, go to [SQL Azure Data Sync Agent](https://www.m
2525

2626
To install the Data Sync Agent silently from the command prompt, enter a command similar to the following example. Check the file name of the downloaded .msi file, and provide your own values for the **TARGETDIR** and **SERVICEACCOUNT** arguments.
2727

28+
- If you don't provide a value for **TARGETDIR**, the default value is `C:\Program Files (x86)\Microsoft SQL Data Sync 2.0`.
29+
30+
- If you provide `LocalSystem` as the value of **SERVICEACCOUNT**, use SQL Server authentication when you configure the agent to connect to the on-premises SQL Server.
31+
32+
- If you provide a domain user account or a local user account as the value of **SERVICEACCOUNT**, you also have to provide the password with the **SERVICEPASSWORD** argument. For example, `SERVICEACCOUNT="<domain>\<user>" SERVICEPASSWORD="<password>"`.
33+
2834
```cmd
29-
msiexec /i SQLDataSyncAgent-2.0--ENU.msi TARGETDIR="C:\Program Files (x86)\Microsoft SQL Data Sync 2.0" SERVICEACCOUNT="LocalSystem" /qn
35+
msiexec /i "SQLDataSyncAgent-2.0-x86-ENU.msi" TARGETDIR="C:\Program Files (x86)\Microsoft SQL Data Sync 2.0" SERVICEACCOUNT="LocalSystem" /qn
3036
```
3137

3238
## Sync data with SQL Server on-premises
@@ -85,10 +91,10 @@ If you want to run the local agent from a different computer than it is currentl
8591

8692
- **Cause**. Many scenarios might cause this failure. To determine the specific cause for this failure, look at the logs.
8793

88-
- **Resolution**. To find the specific cause of the failure, generate and look at the Windows Installer logs. You can turn on logging at a command prompt. For example, if the downloaded AgentServiceSetup.msi file is LocalAgentHost.msi, generate and examine log files by using the following command lines:
94+
- **Resolution**. To find the specific cause of the failure, generate and look at the Windows Installer logs. You can turn on logging at a command prompt. For example, if the downloaded installation file is `SQLDataSyncAgent-2.0-x86-ENU.msi`, generate and examine log files by using the following command lines:
8995

90-
- For installs: `msiexec.exe /i SQLDataSyncAgent-Preview-ENU.msi /l\*v LocalAgentSetup.InstallLog`
91-
- For uninstalls: `msiexec.exe /x SQLDataSyncAgent-se-ENU.msi /l\*v LocalAgentSetup.InstallLog`
96+
- For installs: `msiexec.exe /i SQLDataSyncAgent-2.0-x86-ENU.msi /l*v LocalAgentSetup.Log`
97+
- For uninstalls: `msiexec.exe /x SQLDataSyncAgent-2.0-x86-ENU.msi /l*v LocalAgentSetup.Log`
9298

9399
You can also turn on logging for all installations that are performed by Windows Installer. The Microsoft Knowledge Base article [How to enable Windows Installer logging](https://support.microsoft.com/help/223300/how-to-enable-windows-installer-logging) provides a one-click solution to turn on logging for Windows Installer. It also provides the location of the logs.
94100

@@ -270,6 +276,8 @@ SqlDataSyncAgentCommand.exe -action "registerdatabase" -serverName localhost -da
270276

271277
### Unregister a database
272278

279+
When you use this command to unregister a database, it deprovisions the database completely. If the database participates in other sync groups, this operation breaks the other sync groups.
280+
273281
#### Usage
274282

275283
```cmd

0 commit comments

Comments
 (0)