Skip to content

Commit 0c90e79

Browse files
authored
Merge pull request #97084 from MGoedtel/Task3791332
update troubleshooting article
2 parents 8ba6731 + a25c102 commit 0c90e79

File tree

1 file changed

+14
-14
lines changed

1 file changed

+14
-14
lines changed

articles/automation/troubleshoot/hybrid-runbook-worker.md

Lines changed: 14 additions & 14 deletions
Original file line numberDiff line numberDiff line change
@@ -4,9 +4,9 @@ description: This article provides information troubleshooting Azure Automation
44
services: automation
55
ms.service: automation
66
ms.subservice:
7-
author: bobbytreed
8-
ms.author: robreed
9-
ms.date: 02/12/2019
7+
author: mgoedtel
8+
ms.author: magoedte
9+
ms.date: 11/25/2019
1010
ms.topic: conceptual
1111
manager: carmonm
1212
---
@@ -16,7 +16,7 @@ This article provides information on troubleshooting issues with Hybrid Runbook
1616

1717
## General
1818

19-
The Hybrid Runbook Worker depends on an agent to communicate with your Automation account to register the worker, receive runbook jobs, and report status. For Windows, this agent is the Microsoft Monitoring Agent. For Linux, it's the OMS Agent for Linux.
19+
The Hybrid Runbook Worker depends on an agent to communicate with your Automation account to register the worker, receive runbook jobs, and report status. For Windows, this agent is the Log Analytics agent for Windows (also referred to as the Microsoft Monitoring Agent (MMA)). For Linux, it's the Log Analytics agent for Linux.
2020

2121
### <a name="runbook-execution-fails"></a>Scenario: Runbook execution fails
2222

@@ -77,17 +77,17 @@ If your Hybrid Runbook Worker is an Azure VM, you can use [Managed Identities fo
7777

7878
## Linux
7979

80-
The Linux Hybrid Runbook Worker depends on the OMS Agent for Linux to communicate with your Automation account to register the worker, receive runbook jobs, and report status. If registration of the worker fails, here are some possible causes for the error:
80+
The Linux Hybrid Runbook Worker depends on the [Log Analytics agent for Linux](../../azure-monitor/platform/log-analytics-agent.md) to communicate with your Automation account to register the worker, receive runbook jobs, and report status. If registration of the worker fails, here are some possible causes for the error:
8181

82-
### <a name="oms-agent-not-running"></a>Scenario: The OMS Agent for Linux isn't running
82+
### <a name="oms-agent-not-running"></a>Scenario: The Log Analyics agent for Linux isn't running
8383

8484
#### Issue
8585

86-
The OMS Agent for Linux is not running
86+
The Log Analytics agent for Linux is not running
8787

8888
#### Cause
8989

90-
If the OMS Agent for Linux isn't running, it prevents the Linux Hybrid Runbook Worker from communicating with Azure Automation. The agent may not be running for various reasons.
90+
If the agent isn't running, it prevents the Linux Hybrid Runbook Worker from communicating with Azure Automation. The agent may not be running for various reasons.
9191

9292
#### Resolution
9393

@@ -108,19 +108,19 @@ The following list shows the processes that are started for a Linux Hybrid Runbo
108108

109109
* **diy/worker.conf** - This process is 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 is 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 .
110110

111-
If the OMS Agent for Linux isn't running, run the following command to start the service: `sudo /opt/microsoft/omsagent/bin/service_control restart`.
111+
If the agent isn't running, run the following command to start the service: `sudo /opt/microsoft/omsagent/bin/service_control restart`.
112112

113113
### <a name="class-does-not-exist"></a>Scenario: The specified class does not exist
114114

115-
If you see the error: **The specified class does not exist..** in the `/var/opt/microsoft/omsconfig/omsconfig.log` then the OMS Agent for Linux needs to be updated. Run the following command to reinstall the OMS Agent:
115+
If you see the error: **The specified class does not exist..** in the `/var/opt/microsoft/omsconfig/omsconfig.log` then the Log Analytics agent for Linux needs to be updated. Run the following command to reinstall the agent:
116116

117117
```bash
118118
wget https://raw.githubusercontent.com/Microsoft/OMS-Agent-for-Linux/master/installer/scripts/onboard_agent.sh && sh onboard_agent.sh -w <WorkspaceID> -s <WorkspaceKey>
119119
```
120120

121121
## Windows
122122

123-
The Windows Hybrid Runbook Worker depends on the Microsoft Monitoring Agent to communicate with your Automation account to register the worker, receive runbook jobs, and report status. If registration of the worker fails, here are some possible causes for the error:
123+
The Windows Hybrid Runbook Worker depends on the [Log Analytics agent for Windows](../../azure-monitor/platform/log-analytics-agent.md) to communicate with your Automation account to register the worker, receive runbook jobs, and report status. If registration of the worker fails, here are some possible causes for the error:
124124

125125
### <a name="mma-not-running"></a>Scenario: The Microsoft Monitoring Agent isn't running
126126

@@ -140,15 +140,15 @@ Verify the agent is running by entering the following command in PowerShell: `Ge
140140

141141
#### Issue
142142

143-
In the **Application and Services Logs\Operations Manager** event log, you see event 4502 and EventMessage that contains **Microsoft.EnterpriseManagement.HealthService.AzureAutomation.HybridAgent** with the following description: *The certificate presented by the service \<wsid\>.oms.opinsights.azure.com was not issued by a certificate authority used for Microsoft services. Please contact your network administrator to see if they are running a proxy that intercepts TLS/SSL communication. The article KB3126513 has additional troubleshooting information for connectivity issues.*
143+
In the **Application and Services Logs\Operations Manager** event log, you see event 4502 and EventMessage that contains **Microsoft.EnterpriseManagement.HealthService.AzureAutomation.HybridAgent** with the following description: *The certificate presented by the service \<wsid\>.oms.opinsights.azure.com was not issued by a certificate authority used for Microsoft services. Please contact your network administrator to see if they are running a proxy that intercepts TLS/SSL communication.*
144144

145145
#### Cause
146146

147-
This issue can be caused by your proxy or network firewall blocking communication to Microsoft Azure. Verify the computer has outbound access to *.azure-automation.net on ports 443.
147+
This issue can be caused by your proxy or network firewall blocking communication to Microsoft Azure. Verify the computer has outbound access to *.azure-automation.net on ports 443.
148148

149149
#### Resolution
150150

151-
Logs are stored locally on each hybrid worker at C:\ProgramData\Microsoft\System Center\Orchestrator\7.2\SMA\Sandboxes. You can check if there are any warning or error events in the **Application and Services Logs\Microsoft-SMA\Operations** and **Application and Services Logs\Operations Manager** event log that would indicate a connectivity or other issue that affects onboarding of the role to Azure Automation or issue while under normal operations.
151+
Logs are stored locally on each hybrid worker at C:\ProgramData\Microsoft\System Center\Orchestrator\7.2\SMA\Sandboxes. You can check if there are any warning or error events in the **Application and Services Logs\Microsoft-SMA\Operations** and **Application and Services Logs\Operations Manager** event log that would indicate a connectivity or other issue that affects onboarding of the role to Azure Automation or issue while under normal operations. For additional help troubleshooting issues with the Log Analytics agent, see [Troubleshoot issues with the Log Analytics Windows agent](../../azure-monitor/platform/agent-windows-troubleshoot.md).
152152

153153
[Runbook output and messages](../automation-runbook-output-and-messages.md) are sent to Azure Automation from hybrid workers just like runbook jobs that run in the cloud. You can also enable the Verbose and Progress streams the same way you would for other runbooks.
154154

0 commit comments

Comments
 (0)