Skip to content

Commit dfda5c0

Browse files
authored
Update troubleshoot-shir-include.md
1 parent ec18e94 commit dfda5c0

File tree

1 file changed

+19
-26
lines changed

1 file changed

+19
-26
lines changed

articles/data-factory/includes/troubleshoot-shir-include.md

Lines changed: 19 additions & 26 deletions
Original file line numberDiff line numberDiff line change
@@ -29,7 +29,7 @@ For failed activities that are running on a self-hosted IR or a shared IR, the s
2929

3030
3. For further assistance, select **Send logs**.
3131

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.
3333

3434
:::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.":::
3535

@@ -428,41 +428,34 @@ For failed activities that are running on a self-hosted IR or a shared IR, the s
428428
429429
* If the error in the event log is "UnauthorizedAccessException," do the following:
430430
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:
449443
`dmgcmd.exe -SwitchServiceAccount "<user>" "<password>"`
450-
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" ""`
451445
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.
456449
457450
* 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:
458451
459452
1. Check the *DIAHostService* logon service account in the Windows service panel.
460453
461-
:::image type="content" source="../media/self-hosted-integration-runtime-troubleshoot-guide/logon-service-account.png" alt-text="Screenshot of the &quot;Log On&quot; 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.":::
462455
463456
1. Check to see whether the logon service account has **Log on as a service** permission to start the Windows service:
464457
465-
:::image type="content" source="../media/self-hosted-integration-runtime-troubleshoot-guide/logon-as-service.png" alt-text="Screenshot of the &quot;Log on as service&quot; 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.":::
466459
467460
- **More information**
468461

0 commit comments

Comments
 (0)