Created on

Azure Local – MOC ARB update failed doing solution upgrade


I got this from Microsoft Premium Support. I was working on a Azure Local stack that would not update the MOC ARB to latest version doing the solution update. We ended up skipping the update from the solution update so the rest of the solution update would pass and then work on the MOC ARB afterwards. (I talk about how to skip certain sections of the solution update here: (Use with caution) /blog/wp/azure-local-update-issue-evalcauretryapplicability/)

Locate the issues


We will be using a PowerShell module to test the AKS configuration and remediate issues afterwards. To use Test-SupportAksArcKnownIssues, you must first install and import the Support.AksArc PowerShell module:

Install-Module -Name Support.AksArc
Import-Module Support.AksArc

Then you can run:

Test-SupportAksArcKnownIssues

Output from running the command showed me issues about the image being stuck in “deleting state”:

TestName                                                   Status Message

——–                                                   —— ——-

Validate Failover Cluster Service Responsiveness           Passed Failover Cluster service is responsive.

Validate Missing MOC Cloud Agents                          Passed No missing MOC cloud agents found.

Validate MOC Cloud Agent Running                           Passed MOC Cloud Agent is running

Validate MOC Admin Token Expiry                            Passed MOC admin token is valid. Expiry: 11/16/2025 13:17…

Validate Missing MOC Node Agents                           Passed All MOC nodes have the Node Agent service installe…

Validate Missing MOC Host Agents                           Passed All nodes have MOC host agents installed and healthy.

Validate MOC is on Latest Patch Version                    Failed MOC is not on the latest patch version. Current: 1…

Validate Expired Certificates                              Passed No expired certificates found.

Validate MOC Nodes Not Active                              Passed All MOC nodes are in the ‘Active’ state.

Validate MOC Nodes Sync with Cluster Nodes                 Passed All MOC nodes are in sync with cluster nodes.

Validate Multiple MOC Cloud Agent Instances                Passed No multiple instances of MOC Cloud Agent found.

Validate MOC Powershell Not Stuck in Updating              Passed MOC Powershell is not stuck in updating state.

Validate Windows Event Log Running                         Passed Windows Event Log is running

Validate Gallery Image Stuck In Deleting                   Failed The gallery images are stuck in deleting state and...

Validate Virtual Machine Stuck In Pending                  Passed No virtual machines are stuck in pending state.

Validate Virtual Machine Management Service Responsiveness Passed Virtual Machine Management service is responsive.

Validate Empty MOC Identity Tokens                         Passed No empty MOC identity tokens found.

Validate MOC PowerShell Configuration                      Passed MOC PowerShell configuration is valid.

Remediate issues

I then used this command to start the remediation:

Invoke-SupportAksArcRemediation

After running the command which took about 5 minutes, I ran the test again and it showed no errors now.

Run manual upgrade of MOC ARB

Now that no errors was present, I could then start manuel upgrade of the MOC ARB:

Note that the config file must exist, so you may need to change the path to fit your setup


az login --use-device-code
az arcappliance upgrade hci --config-file "C:\ClusterStorage\Infrastructure_1\Shares\SU1_Infrastructure_1\MocArb\WorkingDirectory\Appliance\hci-appliance.yaml"

Error: Unable to find file release: mariner-2-0

Error: Unable to find file release: ^mariner-2-0-(.*)-vhdx-rpm-(.*)$ with version:  in product release: arc-appliance-stable-releases.

This error was sadly still present even after fixing the issues with the AKS configuration.

This could be about the fact that Microsoft is retiring Azure Linux 2.0 (formerly mariner): https://techcommunity.microsoft.com/blog/azurearcblog/eol-of-azure-linux-2-0-on-azure-kubernetes-service-enabled-by-azure-arc/4434242

It should not be removed yet, since it should be supported the rest of 2025 (still waiting for Microsoft to confirm).

Azure Local 2507 and newer ships with Azure Linux 3.0 and my customers Azure Local stack was at 2504 (20th of september 2025, so it was behind on patching).

I’m currently working with Microsoft to fix the issue and will update this article once we get a valid fix for the issue.

UPDATE 21th september 2025: 2504 can update directly to 2508. And doing this update the MOC ARB got updated from 1.3 to 1.5 and the above error got resolved.