Skip to content

Commit ac8ee82

Browse files
Merge pull request #275657 from SnehaSudhirG/17May-HRWUpdate
Added new info
2 parents b068e04 + 723bde2 commit ac8ee82

File tree

2 files changed

+27
-10
lines changed

2 files changed

+27
-10
lines changed

articles/automation/extension-based-hybrid-runbook-worker-install.md

Lines changed: 17 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -4,7 +4,7 @@ description: This article provides information about deploying the extension-bas
44
services: automation
55
ms.subservice: process-automation
66
ms.custom: devx-track-azurepowershell, devx-track-azurecli, devx-track-bicep, linux-related-content
7-
ms.date: 03/20/2024
7+
ms.date: 05/17/2024
88
ms.topic: how-to
99
#Customer intent: As a developer, I want to learn about extension so that I can efficiently deploy Hybrid Runbook Workers.
1010
---
@@ -63,6 +63,21 @@ Azure Automation stores and manages runbooks and then delivers them to one or mo
6363
> [!NOTE]
6464
> Hybrid Runbook Worker is currently not supported for Virtual Machine Scale Sets (VMSS).
6565
66+
67+
### Permissions for Hybrid worker credentials
68+
69+
If extension-based Hybrid Worker is using custom Hybrid Worker credentials, then ensure that following folder permissions are assigned to the custom user to avoid jobs from getting suspended.
70+
71+
| **Resource Type** | **Folder permissions** |
72+
|---|---|
73+
|Azure VM | C:\Packages\Plugins\Microsoft.Azure.Automation.HybridWorker.HybridWorkerForWindows (read and execute)|
74+
| Arc-enabled Server | C:\ProgramData\AzureConnectedMachineAgent\Tokens (read) </br> C:\Packages\Plugins\Microsoft.Azure.Automation.HybridWorker.HybridWorkerForWindows (read and execute).
75+
76+
> [!NOTE]
77+
> When a system has UAC/LUA in place, permissions must be granted directly and not through any group membership. [Learn more](troubleshoot/extension-based-hybrid-runbook-worker.md#scenario-runbooks-go-into-a-suspended-state-on-a-hybrid-runbook-worker-when-using-a-custom-account-on-a-server-with-user-account-control-uac-enabled).
78+
79+
80+
6681
## Network requirements
6782

6883
### Proxy server use
@@ -217,7 +232,7 @@ You can also add machines to an existing hybrid worker group.
217232

218233
To utilize the benefits of extension based Hybrid Workers, you must migrate all existing agent based User Hybrid Workers to extension based Workers. A hybrid worker machine can co-exist on both **Agent based (V1)** and **Extension based (V2)** platforms. The extension based installation doesn't affect the installation or management of an agent based Worker.
219234

220-
To install Hybrid worker extension on an existing agent based hybrid worker, follow these steps:
235+
To install Hybrid worker extension on an existing agent based hybrid worker, ensure the [prerequisites](#prerequisites) are fulfilled before following these steps:
221236

222237
1. Under **Process Automation**, select **Hybrid worker groups**, and then select your existing hybrid worker group to go to the **Hybrid worker group** page.
223238
1. Under **Hybrid worker group**, select **Hybrid Workers** > **+ Add** to go to the **Add machines as hybrid worker** page.

articles/automation/migrate-existing-agent-based-hybrid-worker-to-extension-based-workers.md

Lines changed: 10 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -3,7 +3,7 @@ title: Migrate an existing agent-based hybrid workers to extension-based-workers
33
description: This article provides information on how to migrate an existing agent-based hybrid worker to extension based workers.
44
services: automation
55
ms.subservice: process-automation
6-
ms.date: 03/21/2024
6+
ms.date: 05/17/2024
77
ms.custom: devx-track-azurecli, devx-track-bicep, devx-track-azurepowershell
88
ms.topic: how-to
99
#Customer intent: As a developer, I want to learn about extension so that I can efficiently migrate agent based hybrid workers to extension based workers.
@@ -77,24 +77,26 @@ The purpose of the Extension-based approach is to simplify the installation and
7777
| --------------------- | --------------------- | ------------------- |
7878
| PowerShell Core | To run PowerShell runbooks, PowerShell Core needs to be installed. For instructions, see [Installing PowerShell Core on Linux](/powershell/scripting/install/installing-powershell-core-on-linux) | 6.0.0 |
7979

80-
### Permissions for Hybrid Worker credentials
80+
### Permissions for Hybrid worker credentials
8181

82-
If agent-based Hybrid Worker is using custom Hybrid Worker credentials, then ensure that following permissions are assigned to the custom user to avoid jobs from getting suspended on the extension-based Hybrid Worker.
82+
If extension-based Hybrid Worker is using custom Hybrid Worker credentials, then ensure that following folder permissions are assigned to the custom user to avoid jobs from getting suspended.
83+
84+
| **Resource Type** | **Folder permissions** |
85+
|---|---|
86+
|Azure VM | C:\Packages\Plugins\Microsoft.Azure.Automation.HybridWorker.HybridWorkerForWindows (read and execute)|
87+
| Arc-enabled Server | C:\ProgramData\AzureConnectedMachineAgent\Tokens (read) </br> C:\Packages\Plugins\Microsoft.Azure.Automation.HybridWorker.HybridWorkerForWindows (read and execute).
8388

84-
| **Resource type** | **Folder permissions** |
85-
| --- | --- |
86-
|Azure VM | C:\Packages\Plugins\Microsoft.Azure.Automation.HybridWorker.HybridWorkerForWindows (read and execute) |
87-
|Arc-enabled Server | C:\ProgramData\AzureConnectedMachineAgent\Tokens (read)</br> C:\Packages\Plugins\Microsoft.Azure.Automation.HybridWorker.HybridWorkerForWindows (read and execute) |
8889

8990
> [!NOTE]
91+
> - When a system has UAC/LUA in place, permissions must be granted directly and not through any group membership. [Learn more](troubleshoot/extension-based-hybrid-runbook-worker.md#scenario-runbooks-go-into-a-suspended-state-on-a-hybrid-runbook-worker-when-using-a-custom-account-on-a-server-with-user-account-control-uac-enabled).
9092
> - For the Arc-enabled server, ensure to reassign the permissions as they get removed whenever the ARC agent is updated.
9193
> - Hybrid Runbook Worker is currently not supported for Virtual Machine Scale Sets (VMSS).
9294
9395
## Migrate an existing Agent based Hybrid Worker to Extension based Hybrid Worker
9496

9597
To utilize the benefits of extension based Hybrid Workers, you must migrate all existing agent based User Hybrid Workers to extension based Workers. A hybrid worker machine can co-exist on both **Agent based (V1)** and **Extension based (V2)** platforms. The extension based installation doesn't affect the installation or management of an agent based Worker.
9698

97-
To install Hybrid worker extension on an existing agent based hybrid worker, follow these steps:
99+
To install Hybrid worker extension on an existing agent based hybrid worker, ensure the [prerequisites](#prerequisites) are fulfilled before following these steps:
98100

99101
1. Under **Process Automation**, select **Hybrid worker groups**, and then select your existing hybrid worker group to go to the **Hybrid worker group** page.
100102
1. Under **Hybrid worker group**, select **Hybrid Workers** > **+ Add** to go to the **Add machines as hybrid worker** page.

0 commit comments

Comments
 (0)