|
2 | 2 | title: Troubleshoot extension-based Hybrid Runbook Worker issues in Azure Automation
|
3 | 3 | description: This article tells how to troubleshoot and resolve issues that arise with Azure Automation extension-based Hybrid Runbook Workers.
|
4 | 4 | services: automation
|
5 |
| -ms.date: 01/03/2024 |
| 5 | +ms.date: 08/26/2024 |
6 | 6 | ms.topic: troubleshooting
|
7 | 7 | ms.custom:
|
8 | 8 | ---
|
@@ -73,34 +73,6 @@ To help troubleshoot issues with extension-based Hybrid Runbook Workers:
|
73 | 73 | /home/hweautomation
|
74 | 74 | ```
|
75 | 75 |
|
76 |
| -
|
77 |
| -### Unable to update Az modules while using the Hybrid Worker |
78 |
| -
|
79 |
| -#### Issue |
80 |
| -
|
81 |
| -The Hybrid Runbook Worker jobs failed as it was unable to import Az modules. |
82 |
| -
|
83 |
| -#### Resolution |
84 |
| -
|
85 |
| -As a workaround, you can follow these steps: |
86 |
| -
|
87 |
| -1. Navigate to the folder: |
88 |
| - > [!TIP] |
89 |
| - > Replace `*` in the below path with the specific version that is installed if you know it. |
90 |
| - ``` |
91 |
| - C:\Program Files\Microsoft Monitoring Agent\Agent\AzureAutomation\*\HybridAgent |
92 |
| - ``` |
93 |
| -
|
94 |
| -1. Edit the file with the name `Orchestrator.Sandbox.exe.config` |
95 |
| -
|
96 |
| -1. Add the following lines inside the `<assemblyBinding>` tag: |
97 |
| -```xml |
98 |
| -<dependentAssembly> |
99 |
| - <assemblyIdentity name="Newtonsoft.Json" publicKeyToken="30ad4fe6b2a6aeed" culture="neutral" /> |
100 |
| - <bindingRedirect oldVersion="0.0.0.0-13.0.0.0" newVersion="13.0.0.0" /> |
101 |
| -</dependentAssembly> |
102 |
| -``` |
103 |
| - |
104 | 76 | ### 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
|
105 | 77 |
|
106 | 78 | #### Issue
|
@@ -411,38 +383,6 @@ This error occurs when you attempt to use a Run As account in a runbook that run
|
411 | 383 | If your Hybrid Runbook Worker is an Azure VM, you can use [runbook authentication with managed identities](../automation-hrw-run-runbooks.md#runbook-auth-managed-identities) 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 [Run runbooks on a Hybrid Runbook Worker](../automation-hrw-run-runbooks.md).
|
412 | 384 |
|
413 | 385 |
|
414 |
| -### Scenario: Set-AzStorageBlobContent fails on a Hybrid Runbook Worker |
415 |
| - |
416 |
| -#### Issue |
417 |
| - |
418 |
| -Runbook fails when it tries to execute `Set-AzStorageBlobContent`, and you receive the following error message: |
419 |
| - |
420 |
| -`Set-AzStorageBlobContent : Failed to open file xxxxxxxxxxxxxxxx: Illegal characters in path` |
421 |
| - |
422 |
| -#### Cause |
423 |
| - |
424 |
| - This error is caused by the long file name behavior of calls to `[System.IO.Path]::GetFullPath()`, which adds UNC paths. |
425 |
| - |
426 |
| -#### Resolution |
427 |
| - |
428 |
| -As a workaround, you can create a configuration file named `OrchestratorSandbox.exe.config` with the following content: |
429 |
| - |
430 |
| -```azurecli |
431 |
| -<configuration> |
432 |
| - <runtime> |
433 |
| - <AppContextSwitchOverrides value="Switch.System.IO.UseLegacyPathHandling=false" /> |
434 |
| - </runtime> |
435 |
| -</configuration> |
436 |
| -``` |
437 |
| - |
438 |
| -Place this file in the same folder as the executable file `OrchestratorSandbox.exe`. For example: |
439 |
| -> [!TIP] |
440 |
| -> Replace `*` in the below path with the specific version that is installed if you know it. |
441 |
| -``` |
442 |
| -%ProgramFiles%\Microsoft Monitoring Agent\Agent\AzureAutomation\*\HybridAgent |
443 |
| -``` |
444 |
| - |
445 |
| - |
446 | 386 | ### Scenario: Microsoft Azure VMs automatically dropped from a hybrid worker group
|
447 | 387 |
|
448 | 388 | #### Issue
|
|
0 commit comments