Skip to content

Commit 3ed8a77

Browse files
authored
Merge pull request #97627 from MGoedtel/Task5833385
updated article per PM input
2 parents 0318a3d + eadb9b0 commit 3ed8a77

File tree

4 files changed

+33
-35
lines changed

4 files changed

+33
-35
lines changed
95.1 KB
Loading
535 KB
Loading

articles/automation/troubleshoot/update-agent-issues-linux.md

Lines changed: 20 additions & 21 deletions
Original file line numberDiff line numberDiff line change
@@ -1,39 +1,39 @@
11
---
2-
title: Understand the Linux agent check results in Azure Update Management
3-
description: Learn how to troubleshoot issues with the Update Management agent.
2+
title: Understand the Linux Hybrid Runbook Worker health in Azure Update Management
3+
description: Learn how to troubleshoot issues with the Hybrid Runbook Worker on Linux that supports Update Management.
44
services: automation
5-
author: bobbytreed
6-
ms.author: robreed
7-
ms.date: 04/22/2019
5+
author: mgoedtel
6+
ms.author: magoedte
7+
ms.date: 12/03/2019
88
ms.topic: conceptual
99
ms.service: automation
1010
ms.subservice: update-management
1111
manager: carmonm
1212
---
1313

14-
# Understand the Linux agent check results in Update Management
14+
# Understand the Linux Hybrid Runbook Worker health in Update Management
1515

16-
There may be many reasons your machine isn't showing **Ready** in Update Management. In Update Management, you can check the health of a Hybrid Worker agent to determine the underlying problem. This article discusses how to run the troubleshooter for Azure machines from the Azure portal and Non-Azure machines in the [offline scenario](#troubleshoot-offline).
16+
There may be many reasons your machine isn't showing **Ready** in Update Management. In Update Management, you can check the health of a Hybrid Runbook Worker agent to determine the underlying problem. This article discusses how to run the troubleshooter for Azure machines from the Azure portal and non-Azure machines in the [offline scenario](#troubleshoot-offline).
1717

1818
The following list are the three readiness states a machine can be in:
1919

20-
* **Ready** - The update agent is deployed and was last seen less than 1 hour ago.
21-
* **Disconnected** - The update agent is deployed and was last seen over 1 hour ago.
22-
* **Not configured** - The update agent isn't found or hasn't finished onboarding.
20+
* **Ready** - The Hybrid Runbook Worker is deployed and was last seen less than 1 hour ago.
21+
* **Disconnected** - The Hybrid Runbook Worker is deployed and was last seen over 1 hour ago.
22+
* **Not configured** - The Hybrid Runbook Worker isn't found or hasn't finished onboarding.
2323

2424
> [!NOTE]
2525
> There may be a slight delay between what the Azure portal shows and the current state of the machine.
2626
2727
## Start the troubleshooter
2828

29-
For Azure machines, clicking the **Troubleshoot** link under the **Update Agent Readiness** column in the portal launches the **Troubleshoot Update Agent** page. For Non-Azure machines, the link brings you to this article. See the offline instructions to troubleshoot a Non-Azure machine.
29+
For Azure machines, clicking the **Troubleshoot** link under the **Update Agent Readiness** column in the portal launches the **Troubleshoot Update Agent** page. For non-Azure machines, the link brings you to this article. See the offline instructions to troubleshoot a non-Azure machine.
3030

3131
![vm list page](../media/update-agent-issues-linux/vm-list.png)
3232

3333
> [!NOTE]
3434
> The checks require the VM to be running. If the VM is not running you are presented with a button to **Start the VM**.
3535
36-
On the **Troubleshoot Update Agent** page, click **Run Checks**, to start the troubleshooter. The troubleshooter uses [Run command](../../virtual-machines/linux/run-command.md) to run a script on the machine to verify the dependencies that the agent has. When the troubleshooter is complete, it returns the result of the checks.
36+
On the **Troubleshoot Update Agent** page, click **Run Checks**, to start the troubleshooter. The troubleshooter uses [Run command](../../virtual-machines/linux/run-command.md) to run a script on the machine to verify the dependencies. When the troubleshooter is complete, it returns the result of the checks.
3737

3838
![Troubleshoot page](../media/update-agent-issues-linux/troubleshoot-page.png)
3939

@@ -45,7 +45,7 @@ When complete, the results are returned in the window. The check sections provid
4545

4646
### Operating system
4747

48-
The OS check, verifies if the Hybrid Runbook Worker is running one of the following Operating Systems:
48+
The operating system check verifies if the Hybrid Runbook Worker is running one of the following Operating Systems:
4949

5050
|Operating system |Notes |
5151
|---------|---------|
@@ -56,14 +56,14 @@ The OS check, verifies if the Hybrid Runbook Worker is running one of the follow
5656

5757
## Monitoring agent service health checks
5858

59-
### OMS agent
59+
### Log Analytics agent
6060

61-
This check ensures that the OMS Agent for Linux is installed. For instructions on how to install it, see [Install the agent for Linux](../../azure-monitor/learn/quick-collect-linux-computer.md#install-the-agent-for-linux
61+
This check ensures that the Log Analytics agent for Linux is installed. For instructions on how to install it, see [Install the agent for Linux](../../azure-monitor/learn/quick-collect-linux-computer.md#install-the-agent-for-linux
6262
).
6363

64-
### OMS Agent status
64+
### Log Analytics agent status
6565

66-
This check ensures that the OMS Agent for Linux is running. If the agent isn't running, you can run the following command to attempt to restart it. For more information on troubleshooting the agent, see [Linux Hybrid Runbook worker troubleshooting](hybrid-runbook-worker.md#linux)
66+
This check ensures that the Log Analytics agent for Linux is running. If the agent isn't running, you can run the following command to attempt to restart it. For more information on troubleshooting the agent, see [Linux Hybrid Runbook worker troubleshooting](hybrid-runbook-worker.md#linux)
6767

6868
```bash
6969
sudo /opt/microsoft/omsagent/bin/service_control restart
@@ -75,7 +75,7 @@ This check determines if the agent is reporting to multiple workspaces. Multi-ho
7575

7676
### Hybrid Runbook Worker
7777

78-
This check verifies if the OMS Agent for Linux has the Hybrid Runbook Worker package. This package is required for Update Management to work.
78+
This check verifies if the Log Analytics agent for Linux has the Hybrid Runbook Worker package. This package is required for Update Management to work.
7979

8080
### Hybrid Runbook Worker status
8181

@@ -95,7 +95,7 @@ This check makes sure that the machine has access to the internet.
9595

9696
### Registration endpoint
9797

98-
This check determines if the agent can properly communicate with the agent service.
98+
This check determines if the Hybrid Runbook Worker can properly communicate with Azure Automation the Log Analytics workspace.
9999

100100
Proxy and firewall configurations must allow the Hybrid Runbook Worker agent to communicate with the registration endpoint. For a list of addresses and ports to open, see [Network planning for Hybrid Workers](../automation-hybrid-runbook-worker.md#network-planning)
101101

@@ -174,5 +174,4 @@ Passed: TCP test for {ods.systemcenteradvisor.com} (port 443) succeeded
174174

175175
## Next steps
176176

177-
To troubleshoot additional issues with your Hybrid Runbook Workers, see [Troubleshoot - Hybrid Runbook Workers](hybrid-runbook-worker.md)
178-
177+
To troubleshoot additional issues with your Hybrid Runbook Workers, see [Troubleshoot - Hybrid Runbook Workers](hybrid-runbook-worker.md)

articles/automation/troubleshoot/update-agent-issues.md

Lines changed: 13 additions & 14 deletions
Original file line numberDiff line numberDiff line change
@@ -1,39 +1,39 @@
11
---
2-
title: Understand the Windows agent check results in Azure Update Management
3-
description: Learn how to troubleshoot issues with the Update Management agent.
2+
title: Understand the Windows Hybrid Runbook Worker health in Azure Update Management
3+
description: Learn how to troubleshoot issues with the Hybrid Runbook Worker on Windows that supports Update Management.
44
services: automation
55
author: mgoedtel
66
ms.author: magoedte
7-
ms.date: 11/25/2019
7+
ms.date: 12/03/2019
88
ms.topic: conceptual
99
ms.service: automation
1010
ms.subservice: update-management
1111
manager: carmonm
1212
---
1313

14-
# Understand the Windows agent check results in Update Management
14+
# Understand the Windows Hybrid Runbook Worker health in Update Management
1515

16-
There may be many reasons your machine isn't showing **Ready** in Update Management. In Update Management, you can check the health of a Hybrid Worker agent to determine the underlying problem. This article discusses how to run the troubleshooter for Azure machines from the Azure portal and Non-Azure machines in the [offline scenario](#troubleshoot-offline).
16+
There may be many reasons your machine isn't showing **Ready** in Update Management. In Update Management, you can check the health of a Hybrid Runbook Worker agent to determine the underlying problem. This article discusses how to run the troubleshooter for Azure machines from the Azure portal and non-Azure machines in the [offline scenario](#troubleshoot-offline).
1717

1818
The following list are the three readiness states a machine can be in:
1919

20-
* **Ready** - The update agent is deployed and was last seen less than 1 hour ago.
21-
* **Disconnected** - The update agent is deployed and was last seen over 1 hour ago.
22-
* **Not configured** - The update agent isn't found or hasn't finished onboarding.
20+
* **Ready** - The Hybrid Runbook Worker is deployed and was last seen less than 1 hour ago.
21+
* **Disconnected** - The Hybrid Runbook Worker is deployed and was last seen over 1 hour ago.
22+
* **Not configured** - The Hybrid Runbook Worker isn't found or hasn't finished onboarding.
2323

2424
> [!NOTE]
2525
> There may be a slight delay between what the Azure portal shows and the current state of the machine.
2626
2727
## Start the troubleshooter
2828

29-
For Azure machines, clicking the **Troubleshoot** link under the **Update Agent Readiness** column in the portal launches the **Troubleshoot Update Agent** page. For Non-Azure machines, the link brings you to this article. See the [offline instructions](#troubleshoot-offline) to troubleshoot a Non-Azure machine.
29+
For Azure machines, clicking the **Troubleshoot** link under the **Update Agent Readiness** column in the portal launches the **Troubleshoot Update Agent** page. For non-Azure machines, the link brings you to this article. See the [offline instructions](#troubleshoot-offline) to troubleshoot a non-Azure machine.
3030

3131
![Update management list of virtual machines](../media/update-agent-issues/vm-list.png)
3232

3333
> [!NOTE]
34-
> To check the health of an agent, the VM must be running. If the VM isn't running, a **Start the VM** button appears.
34+
> To check the health of the Hybrid Runbook Worker, the VM must be running. If the VM isn't running, a **Start the VM** button appears.
3535
36-
On the **Troubleshoot Update Agent** page, select **Run checks** to start the troubleshooter. The troubleshooter uses [Run Command](../../virtual-machines/windows/run-command.md) to run a script on the machine to verify agent dependencies. When the troubleshooter is finished, it returns the result of the checks.
36+
On the **Troubleshoot Update Agent** page, select **Run checks** to start the troubleshooter. The troubleshooter uses [Run Command](../../virtual-machines/windows/run-command.md) to run a script on the machine to verify dependencies. When the troubleshooter is finished, it returns the result of the checks.
3737

3838
![Troubleshoot Update Agent page](../media/update-agent-issues/troubleshoot-page.png)
3939

@@ -45,7 +45,7 @@ Results are shown on the page when they're ready. The checks sections show what'
4545

4646
### Operating system
4747

48-
The operating system check verifies whether the Hybrid Runbook Worker is running one of these operating systems:
48+
The operating system check verifies whether the Hybrid Runbook Worker is running one of the following operating systems:
4949

5050
|Operating system |Notes |
5151
|---------|---------|
@@ -200,5 +200,4 @@ CheckResultMessageArguments : {}
200200

201201
## Next steps
202202

203-
To troubleshoot more issues with your Hybrid Runbook Workers, see [Troubleshoot Hybrid Runbook Workers](hybrid-runbook-worker.md).
204-
203+
To troubleshoot more issues with your Hybrid Runbook Workers, see [Troubleshoot Hybrid Runbook Workers](hybrid-runbook-worker.md).

0 commit comments

Comments
 (0)