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
#Customer intent: As a developer, I want to learn about extension so that I can efficiently deploy Hybrid Runbook Workers.
10
10
---
@@ -63,6 +63,21 @@ Azure Automation stores and manages runbooks and then delivers them to one or mo
63
63
> [!NOTE]
64
64
> Hybrid Runbook Worker is currently not supported for Virtual Machine Scale Sets (VMSS).
65
65
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
+
66
81
## Network requirements
67
82
68
83
### Proxy server use
@@ -217,7 +232,7 @@ You can also add machines to an existing hybrid worker group.
217
232
218
233
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.
219
234
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:
221
236
222
237
1. Under **Process Automation**, select **Hybrid worker groups**, and then select your existing hybrid worker group to go to the **Hybrid worker group** page.
223
238
1. Under **Hybrid worker group**, select **Hybrid Workers** > **+ Add** to go to the **Add machines as hybrid worker** page.
#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
| 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 |
79
79
80
-
### Permissions for Hybrid Worker credentials
80
+
### Permissions for Hybrid worker credentials
81
81
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).
83
88
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) |
88
89
89
90
> [!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).
90
92
> - For the Arc-enabled server, ensure to reassign the permissions as they get removed whenever the ARC agent is updated.
91
93
> - Hybrid Runbook Worker is currently not supported for Virtual Machine Scale Sets (VMSS).
92
94
93
95
## Migrate an existing Agent based Hybrid Worker to Extension based Hybrid Worker
94
96
95
97
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.
96
98
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:
98
100
99
101
1. Under **Process Automation**, select **Hybrid worker groups**, and then select your existing hybrid worker group to go to the **Hybrid worker group** page.
100
102
1. Under **Hybrid worker group**, select **Hybrid Workers** > **+ Add** to go to the **Add machines as hybrid worker** page.
0 commit comments