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/automation/troubleshoot/hybrid-runbook-worker.md
+14-17Lines changed: 14 additions & 17 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -22,41 +22,39 @@ The Hybrid Runbook Worker depends on an agent to communicate with your Automatio
22
22
23
23
#### Issue
24
24
25
-
Runbook execution fails and you receive the following error:
25
+
Runbook execution fails and you receive the following error.
26
26
27
27
```error
28
28
"The job action 'Activate' cannot be run, because the process stopped unexpectedly. The job action was attempted three times."
29
29
```
30
30
31
-
Your runbook is suspended shortly after it attempts to execute three times. There are conditions that may interrupt the runbook from completing. The related error message may not include any additional information.
31
+
Your runbook is suspended shortly after it attempts to execute three times. There are conditions that can interrupt the runbook from completing. The related error message might not include any additional information.
32
32
33
33
#### Cause
34
34
35
35
The following are possible causes:
36
36
37
-
* The runbooks can't authenticate with local resources
37
+
* The runbooks can't authenticate with local resources.
38
38
39
-
* The hybrid worker is behind a proxy or firewall
40
-
41
-
* The runbooks can't authenticate with local resources
39
+
* The hybrid worker is behind a proxy or firewall.
42
40
43
41
* The computer configured to run the Hybrid Runbook Worker feature doesn't meet the minimum hardware requirements.
44
42
45
43
#### Resolution
46
44
47
-
Verify the computer has outbound access to *.azure-automation.net on port 443.
45
+
Verify that the computer has outbound access to *.azure-automation.net on port 443.
48
46
49
-
Computers running the Hybrid Runbook Worker should meet the minimum hardware requirements before the worker is configured to host this feature. Runbooks and the background process they use may cause the system to be over-used and cause runbook job delays or timeouts.
47
+
Computers running the Hybrid Runbook Worker should meet the minimum hardware requirements before the worker is configured to host this feature. Runbooks and the background process they use might cause the system to be over-used and cause runbook job delays or timeouts.
50
48
51
-
Confirm the computer that will run the Hybrid Runbook Worker feature meets the minimum hardware requirements. If it does, monitor CPU and memory use to determine any correlation between the performance of Hybrid Runbook Worker processes and Windows. Any memory or CPU pressure may indicate the need to upgrade resources. You can also select a different compute resource that can support the minimum requirements and scale when workload demands indicate an increase is necessary.
49
+
Confirm that the computer to run the Hybrid Runbook Worker feature meets the minimum hardware requirements. If it does, monitor CPU and memory use to determine any correlation between the performance of Hybrid Runbook Worker processes and Windows. Any memory or CPU pressure can indicate the need to upgrade resources. You can also select a different compute resource that supports the minimum requirements and scale when workload demands indicate that an increase is necessary.
52
50
53
-
Check the **Microsoft-SMA** event log for a corresponding event with description *Win32 Process Exited with code [4294967295]*. The cause of this error is you haven't configured authentication in your runbooks or specified the Run As credentials for the Hybrid worker group. Review [Runbook permissions](../automation-hrw-run-runbooks.md#runbook-permissions) to confirm you have correctly configured authentication for your runbooks.
51
+
Check the **Microsoft-SMA** event log for a corresponding event with description *Win32 Process Exited with code [4294967295]*. The cause of this error is that you haven't configured authentication in your runbooks or specified the Run As credentials for the Hybrid Worker group. Review [Runbook permissions](../automation-hrw-run-runbooks.md#runbook-permissions) to confirm that you have correctly configured authentication for your runbooks.
54
52
55
53
### <aname="no-cert-found"></a>Scenario: No certificate was found in the certificate store on Hybrid Runbook Worker
56
54
57
55
#### Issue
58
56
59
-
A runbook running on a Hybrid Runbook Worker fails with the following error message:
57
+
A runbook running on a Hybrid Runbook Worker fails with the following error message.
60
58
61
59
```error
62
60
Connect-AzureRmAccount : No certificate was found in the certificate store with thumbprint 0000000000000000000000000000000000000000
@@ -68,11 +66,11 @@ At line:3 char:1
68
66
```
69
67
#### Cause
70
68
71
-
This error occurs when you attempt to use a [Run As Account](../manage-runas-account.md) in a runbook that runs on a Hybrid Runbook Worker where the Run As Account certificate's not present. Hybrid Runbook Workers don't have the certificate asset locally by default, which is required by the Run As Account to function properly.
69
+
This error occurs when you attempt to use a [Run As account](../manage-runas-account.md) in a runbook that runs on a Hybrid Runbook Worker where the Run As account certificate's not present. Hybrid Runbook Workers don't have the certificate asset locally by default, which is required by the Run As account to operate properly.
72
70
73
71
#### Resolution
74
72
75
-
If your Hybrid Runbook Worker is an Azure VM, you can use [Managed identities for Azure resources](../automation-hrw-run-runbooks.md#managed-identities-for-azure-resources) instead. This scenario simplifies authentication by allowing you to authenticate to Azure resources using the managed identity of the Azure VM instead of the Run As Account. When the Hybrid Runbook Worker is an on-premises machine, you need to install the Run As Account certificate on the machine. To learn how to install the certificate, see the steps to run the PowerShell runbook Export-RunAsCertificateToHybridWorker in [Running runbooks on a Hybrid Runbook Worker](../automation-hrw-run-runbooks.md).
73
+
If your Hybrid Runbook Worker is an Azure VM, you can use [Managed identities for Azure resources](../automation-hrw-run-runbooks.md#managed-identities-for-azure-resources) instead. This scenario simplifies authentication by allowing you to authenticate to Azure resources using the managed identity of the Azure VM instead of the Run As account. When the Hybrid Runbook Worker is an on-premises machine, you need to install the Run As account certificate on the machine. To learn how to install the certificate, see the steps to run the PowerShell runbook Export-RunAsCertificateToHybridWorker in [Running runbooks on a Hybrid Runbook Worker](../automation-hrw-run-runbooks.md).
76
74
77
75
### <aname="error-403-on-registration"></a>Scenario: Error 403 during registration of Hybrid Runbook Worker
78
76
@@ -97,7 +95,7 @@ To verify if the agent’s workspace ID or workspace key has been mistyped, see
97
95
98
96
##### Configuration not downloaded
99
97
100
-
Your Log Analytics workspace and Automation Account must be in a linked region. For a list of supported regions, see [Azure Automation and Log Analytics workspace mappings](../how-to/region-mappings.md).
98
+
Your Log Analytics workspace and Automation account must be in a linked region. For a list of supported regions, see [Azure Automation and Log Analytics workspace mappings](../how-to/region-mappings.md).
101
99
102
100
You might also need to update the date and or time zone of your computer. If you select a custom time range, make sure that the range is in UTC, which can differ from your local time zone.
The following list shows the processes that are started for a Linux Hybrid Runbook Worker. They're all located in the `/var/opt/microsoft/omsagent/state/automationworker/` directory.
129
127
130
-
131
128
***oms.conf** - The worker manager process. It's started directly from DSC.
132
129
133
-
***worker.conf** - The Auto Registered Hybrid worker process, it's started by the worker manager. This process is used by Update Management and is transparent to the user. This process isn't present if the Update Management solution isn't enabled on the machine.
130
+
***worker.conf** - The Auto Registered Hybrid worker process. It's started by the worker manager. This process is used by Update Management and is transparent to the user. This process isn't present if the Update Management solution isn't enabled on the machine.
134
131
135
132
***diy/worker.conf** - The DIY hybrid worker process. The DIY hybrid worker process is used to execute user runbooks on the Hybrid Runbook Worker. It only differs from the Auto registered Hybrid worker process in the key detail that it uses a different configuration. This process isn't present if the Azure Automation solution is disabled and the DIY Linux Hybrid Worker isn't registered.
136
133
@@ -220,7 +217,7 @@ Machine is already registered
220
217
221
218
#### Cause
222
219
223
-
This issue can be caused if the machine is already registered with a different Automation Account or if you try to readd the Hybrid Runbook Worker after removing it from a machine.
220
+
This issue can be caused if the machine is already registered with a different Automation account or if you try to readd the Hybrid Runbook Worker after removing it from a machine.
0 commit comments