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
Copy file name to clipboardExpand all lines: azure-local/known-issues.md
+10-10Lines changed: 10 additions & 10 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -10,8 +10,6 @@ ms.reviewer: alkohli
10
10
11
11
# Known issues in Azure Local
12
12
13
-
::: moniker range="=azloc-2506"
14
-
15
13
This article identifies critical known issues and their workarounds in Azure Local.
16
14
17
15
These release notes are continuously updated, and as critical issues requiring a workaround are discovered, they're added. Before you deploy your Azure Local instance, carefully review the information contained here.
@@ -21,6 +19,8 @@ These release notes are continuously updated, and as critical issues requiring a
21
19
22
20
For more information about new features in this release, see [What's new for Azure Local](whats-new.md).
23
21
22
+
::: moniker range="=azloc-2506"
23
+
24
24
## Known issues for version 2506
25
25
26
26
For the 2506 release of Azure Local, Microsoft released two security updates: one for existing deployments and another for new deployments. The following table provides information about different deployment types, their corresponding security updates, and OS builds:
@@ -44,12 +44,12 @@ The following table lists the fixed issues in this release:
44
44
45
45
|Feature|Issue|Workaround/Comments|
46
46
|------|------|----------|
47
-
| Azure Local VMs <!--30035765-->| When creating a VM, there is no option to prompt for password. | Password is prompted when --password is not explicitly passed. This provides customers a more secure way to input password. |
48
-
| Azure Local VMs <!--32130105-->| When creating a VM, `--admin-username` and `--password` are required for guest management enablement. | Unbound requirement for guest management enablement. Now, when creating a VM, --admin-username and --password are required unless the OS disk is provided or the --authentication-type is "ssh". |
49
-
| Azure Local VMs <!--32417179-->| In some cases, VM update operations were incorrectly shown as successful on Portal even though they had failed in the underlying infrastructure. | Improved error reporting to ensure the Portal accurately reflects the true status of VM update operations. |
47
+
| Azure Local VMs <!--30035765-->| When creating a VM, there is no option to prompt for password. | Password is prompted when `--password` is not explicitly passed. This provides customers a more secure way to input password. |
48
+
| Azure Local VMs <!--32130105-->| When creating a VM, `--admin-username` and `--password` are required for guest management enablement. | Unbound requirement for guest management enablement. Now, when creating a VM, `--admin-username` and `--password` are required unless the OS disk is provided or the `--authentication-type` is `ssh`. |
49
+
| Azure Local VMs <!--32417179-->| In some cases, VM update operations were incorrectly shown as successful on the Azure portal even though they had failed in the underlying infrastructure. | Improved error reporting to ensure the Azure portal accurately reflects the true status of VM update operations. |
50
50
| Azure Local VMs <!--32503885-->| Deleting a logical network with an attached AKS cluster would leave behind orphaned on-premises resources. | Properly detects and handles AKS cluster dependencies during logical network deletion to prevent resource leaks. |
51
-
| Azure Local VMs <!--32698064-->| Unable to create VHDs using --download-url | Correctly initializes VHD property before assigning the download URL, ensuring successful disk creation. |
52
-
| Azure Local VMs <!--32195527-->| In some cases, deleting a VM from multiple platforms (Portal, Windows Admin Center, Failover Cluster Manager) could cause its high availability (HA) status to remain stuck in a pending state. | Correctly updates the HA status when the VM is removed from the cluster, preventing it from getting stuck. |
51
+
| Azure Local VMs <!--32698064-->| Unable to create VHDs using `--download-url`| Correctly initializes VHD property before assigning the download URL, ensuring successful disk creation. |
52
+
| Azure Local VMs <!--32195527-->| In some cases, deleting a VM from multiple platforms (Azure portal, Windows Admin Center, Failover Cluster Manager) could cause its high availability (HA) status to remain stuck in a pending state. | Correctly updates the HA status when the VM is removed from the cluster, preventing it from getting stuck. |
53
53
| Azure Local VMs <!--32255591-->| After creating a VM, a temporary ISO file used for guest agent setup was sometimes left attached. | ISO file is automatically removed after VM creation. |
54
54
| Azure Local VMs <!--30846971-->| In some cases, VM deletions did not properly clean up associated network interfaces or disks, leaving behind orphaned resources that blocked reuse of IP addresses and storage. | All dependent resources are correctly detached and deleted when a VM is deleted, preventing resource leaks. |
55
55
| Azure Local VMs <!--30651739-->| Improved validation for the IP address of the infrastructure range. ||
@@ -62,7 +62,7 @@ The following table lists the known issues in this release:
62
62
63
63
|Feature |Issue |Workaround |
64
64
|---------|---------|---------|
65
-
| Security <!--30348397-->| Azure Local might face an issue during normal operations (for example, Update, Repair) while using Defender for Endpoint and when the **Restrict App Execution** setting is enabled for one or more servers in the deployment. | Disable the **Restrict App Execution** setting in the Defender Portal and reboot. If the issue persists, open a support case. |
65
+
| Security <!--30348397-->| Azure Local might face an issue during normal operations (for example, Update, Repair) while using Defender for Endpoint and when the **Restrict App Execution** setting is enabled for one or more servers in the deployment. | Disable the **Restrict App Execution** setting in the Defender portal and reboot. If the issue persists, open a support case. |
66
66
67
67
## Known issues from previous releases
68
68
@@ -74,7 +74,7 @@ The following table lists the known issues from previous releases:
74
74
| Deployment <!--33008717-->| In this release and previous releases, registration fails with the following error when you try to register Azure Local machines with Azure Arc: <br>`AZCMAgent command failed with error: >> exitcode: 42. Additional Info: See https://aka.ms/arc/azcmerror`. | For detailed steps on how to resolve this issue, see the [Troubleshooting guide](https://github.com/Azure/AzureLocal-Supportability/blob/users/kagoyal/tsg-error42/TSG/ArcRegistration/TSG%20%7C%20Arc%20registration%20failing%20with%20error%2042.md). |
75
75
| Azure Local VM management | The Mochostagent service might appear to be running but can get stuck without updating logs for over a month. You can identify this issue by checking the service logs in `C:\programdata\mochostagent\logs` to see if logs are being updated. | Run the following command to restart the mochostagent service: `restart-service mochostagent`. |
76
76
| Update | When viewing the readiness check results for an Azure Local instance via the Azure Update Manager, there might be multiple readiness checks with the same name. |There's no known workaround in this release. Select **View details** to view specific information about the readiness check. |
77
-
| Update | There's an intermittent issue in this release when the Azure portal incorrectly reports the update status as **Failed to update** or **In progress** though the update is complete. |[Connect to your Azure Local instance](./update/update-via-powershell-23h2.md#connect-to-your-azure-local) via a remote PowerShell session. To confirm the update status, run the following PowerShell cmdlets: <br><br> `$Update = get-solutionupdate`\|`? version -eq "<version string>"`<br><br>Replace the version string with the version you're running. For example, "10.2405.0.23". <br><br>`$Update.state`<br><br>If the update status is **Installed**, no further action is required on your part. Azure portal refreshes the status correctly within 24 hours. <br> To refresh the status sooner, follow these steps on one of the nodes. <br>Restart the Cloud Management cluster group.<br>`Stop-ClusterGroup "Cloud Management"`<br>`Start-ClusterGroup "Cloud Management"`|
77
+
| Update | There's an intermittent issue in this release when the Azure portal incorrectly reports the update status as **Failed to update** or **In progress** though the update is complete. |[Connect to your Azure Local instance](./update/update-via-powershell-23h2.md#connect-to-your-azure-local) via a remote PowerShell session. To confirm the update status, run the following PowerShell cmdlets: <br><br> `$Update = get-solutionupdate`\|`? version -eq "<version string>"`<br><br>Replace the version string with the version you're running. For example, "10.2405.0.23". <br><br>`$Update.state`<br><br>If the update status is **Installed**, no further action is required on your part. The Azure portal refreshes the status correctly within 24 hours. <br> To refresh the status sooner, follow these steps on one of the nodes. <br>Restart the Cloud Management cluster group.<br>`Stop-ClusterGroup "Cloud Management"`<br>`Start-ClusterGroup "Cloud Management"`|
78
78
| Add server <!--26852600-->|In this release and previous releases, when adding a machine to the system, isn't possible to update the proxy bypass list string to include the new machine. Updating environment variables proxy bypass list on the hosts won't update the proxy bypass list on Azure resource bridge or AKS. |There's no workaround in this release. If you encounter this issue, contact Microsoft Support to determine next steps.|
79
79
| Azure Local VM management |Arc Extensions on Azure Local VMs stay in "Creating" state indefinitely. | Sign in to the VM, open a command prompt, and type the following: <br> **Windows**: <br> `notepad C:\ProgramData\AzureConnectedMachineAgent\Config\agentconfig.json` <br> **Linux**: <br> `sudo vi /var/opt/azcmagent/agentconfig.json` <br> Next, find the `resourcename` property. Delete the GUID that is appended to the end of the resource name, so this property matches the name of the VM. Then restart the VM.|
80
80
| Azure Local VM management |Restart of Azure Local VM operation completes after approximately 20 minutes although the VM itself restarts in about a minute.| There's no known workaround in this release. |
@@ -1331,4 +1331,4 @@ Here are the known issues from previous releases:
1331
1331
1332
1332
## Next steps
1333
1333
1334
-
- Read the [Deployment overview](./deploy/deployment-introduction.md).
1334
+
- Read the [Deployment overview](./deploy/deployment-introduction.md).
0 commit comments