You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: articles/data-factory/includes/troubleshoot-shir-include.md
+19-26Lines changed: 19 additions & 26 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -29,7 +29,7 @@ For failed activities that are running on a self-hosted IR or a shared IR, the s
29
29
30
30
3. For further assistance, select **Send logs**.
31
31
32
-
The **Share the self-hosted integration runtime (IR) logs with Microsoft** window opens.
32
+
The window titled **'Share the self-hosted integration runtime (IR) logs with Microsoft'** opens.
33
33
34
34
:::image type="content" source="../media/self-hosted-integration-runtime-troubleshoot-guide/choose-logs.png" alt-text="Screenshot of the "Share the self-hosted integration runtime (IR) logs with Microsoft" window.":::
35
35
@@ -428,41 +428,34 @@ For failed activities that are running on a self-hosted IR or a shared IR, the s
428
428
429
429
* If the error in the event log is "UnauthorizedAccessException," do the following:
430
430
431
-
1. Check the *DIAHostService* logon service account in the Windows service panel.
432
-
433
-
:::image type="content" source="../media/self-hosted-integration-runtime-troubleshoot-guide/logon-service-account.png" alt-text="Screenshot of the Logon service account properties pane.":::
434
-
435
-
1. Check to see whether the logon service account has read/write permissions for the *%programdata%\Microsoft\DataTransfer\DataManagementGateway* folder.
436
-
437
-
- By default, if the service logon account hasn't been changed, it should have read/write permissions.
438
-
439
-
:::image type="content" source="../media/self-hosted-integration-runtime-troubleshoot-guide/service-permission.png" alt-text="Screenshot of the service permissions pane.":::
440
-
441
-
- If you've changed the service logon account, mitigate the issue by doing the following:
442
-
443
-
a. Perform a clean uninstallation of the current self-hosted IR.
444
-
b. Install the self-hosted IR bits.
445
-
c. Change the service account by doing the following:
446
-
447
-
i. Go to the self-hosted IR installation folder, and then switch to the *Microsoft Integration Runtime\4.0\Shared* folder.
448
-
ii. Open a Command Prompt window by using elevated privileges. Replace *\<user>* and *\<password>* with your own username and password, and then run the following command:
431
+
1. Check the *DIAHostService* logon service account in the Windows service panel.
432
+
:::image type="content" source="../media/self-hosted-integration-runtime-troubleshoot-guide/logon-service-account.png" alt-text="Screenshot of the Logon service account properties pane.":::
433
+
434
+
1. Check to see whether the logon service account has read/write permissions for the *%programdata%\Microsoft\DataTransfer\DataManagementGateway* folder.
435
+
- By default, if the service logon account hasn't been changed, it should have read/write permissions.
436
+
:::image type="content" source="../media/self-hosted-integration-runtime-troubleshoot-guide/service-permission.png" alt-text="Screenshot of the service permissions pane.":::
437
+
- If you've changed the service logon account, mitigate the issue by doing the following:
438
+
a. Perform a clean uninstallation of the current self-hosted IR.
439
+
b. Install the self-hosted IR bits.
440
+
c. Change the service account by doing the following:
441
+
i. Go to the self-hosted IR installation folder, and then switch to the *Microsoft Integration Runtime\4.0\Shared* folder.
442
+
ii. Open a Command Prompt window by using elevated privileges. Replace *\<user>* and *\<password>* with your own username and password, and then run the following command:
iii. If you want to change to the LocalSystem account, be sure to use the correct format for this account: `dmgcmd.exe -SwitchServiceAccount "NT Authority\System" ""`
444
+
iii. If you want to change to the LocalSystem account, be sure to use the correct format for this account: `dmgcmd.exe -SwitchServiceAccount "NT Authority\System" ""`
451
445
Do *not* use this format: `dmgcmd.exe -SwitchServiceAccount "LocalSystem" ""`
452
-
iv. Optionally, because Local System has higher privileges than Administrator, you can also directly change it in "Services".
453
-
v. You can use a local/domain user for the IR service logon account.
454
-
455
-
d. Register the integration runtime.
446
+
iv. Optionally, because Local System has higher privileges than Administrator, you can also directly change it in "Services".
447
+
v. You can use a local/domain user for the IR service logon account.
448
+
d. Register the integration runtime.
456
449
457
450
* If the error is "Service 'Integration Runtime Service' (DIAHostService) failed to start. Verify that you have sufficient privileges to start system services," do the following:
458
451
459
452
1. Check the *DIAHostService* logon service account in the Windows service panel.
460
453
461
-
:::image type="content" source="../media/self-hosted-integration-runtime-troubleshoot-guide/logon-service-account.png" alt-text="Screenshot of the "Log On" pane for the service account.":::
454
+
:::image type="content" source="../media/self-hosted-integration-runtime-troubleshoot-guide/logon-service-account.png" alt-text="Screenshot of the 'Log On' pane for the service account.":::
462
455
463
456
1. Check to see whether the logon service account has **Log on as a service** permission to start the Windows service:
464
457
465
-
:::image type="content" source="../media/self-hosted-integration-runtime-troubleshoot-guide/logon-as-service.png" alt-text="Screenshot of the "Log on as service" properties pane.":::
458
+
:::image type="content" source="../media/self-hosted-integration-runtime-troubleshoot-guide/logon-as-service.png" alt-text="Screenshot of the 'Log on as service' properties pane.":::
0 commit comments