From a86f3be2748dd66aad4367c3a71ed53fdc7c20e8 Mon Sep 17 00:00:00 2001
From: Chris Puckett <64617662+cpuck@users.noreply.github.com>
Date: Tue, 13 Jan 2026 17:15:04 -0600
Subject: [PATCH] Revise TSG for Update Service memory issues

Updated the troubleshooting guide for the Update Service to address issues related to high memory usage and service termination. Added mitigation steps and PowerShell scripts for validation and cleanup.
---
 ...te-Service-terminated-repeatedly-by-ALM.md | 19 +++++++++++++++++++
 1 file changed, 19 insertions(+)

diff --git a/TSG/Update/Update-Service-terminated-repeatedly-by-ALM.md b/TSG/Update/Update-Service-terminated-repeatedly-by-ALM.md
index 7d0d735..c4b67ca 100644
--- a/TSG/Update/Update-Service-terminated-repeatedly-by-ALM.md
+++ b/TSG/Update/Update-Service-terminated-repeatedly-by-ALM.md
@@ -97,6 +97,24 @@ if ($resourceIds.Count -gt 0)
 }
 ```
 
+## Remove failed Update action plan instances
+Delete all failed Update action plans except for the last failed one.
+
+```
+Import-Module ECEClient -DisableNameChecking 
+$failedUpdates = Get-ActionPlanInstances | ? { $_.Status -eq "Failed" -and $_.ActionPlanName -match "MAS Update" } | sort LastModifiedDateTime -Descending | select -Skip 1
+$instanceIDs = $failedUpdates.InstanceID
+   
+$eceClient = Create-ECEClusterServiceClient  
+$deleteActionPlanInstanceDescription = New-Object Microsoft.AzureStack.Solution.Deploy.EnterpriseCloudEngine.Controllers.Models.DeleteActionPlanInstanceDescription  
+  
+foreach ($actionPlanInstanceId in $instanceIDs) {  
+   # remove old instance  
+   $deleteActionPlanInstanceDescription.ActionPlanInstanceID = $actionPlanInstanceID  
+   $eceClient.DeleteActionPlanInstance($deleteActionPlanInstanceDescription).Wait()  
+}
+```
+
 ## (Last Resort) Increase update service memory limit
 If the problem is still occurring, the final thing to do is to temporarily increase the configured memory limit for the update service.
 
@@ -162,3 +180,4 @@ else
     Write-Host "No changes needed. Existing limits are already set. Warning limit $($memoryWarningLimit)MB and Error limit $($memoryErrorLimit)MB"
 }
 ```
+