From b42f35764836ed9460faea7483f7e3c0467b1f38 Mon Sep 17 00:00:00 2001
From: Ramgopal Nagaboina <ramgopal.nagaboina.dev@gmail.com>
Date: Wed, 2 Sep 2026 19:19:56 -0400
Subject: [PATCH] engine: do not stall the host command queue on a failed send
 in AgentAttache.sendNext

When sending the next queued request threw AgentUnavailableException, the request
was cancelled but _currentSequence was still set to that dead sequence. No answer
ever arrives for a cancelled command, so sendNext was never driven again and every
later in-sequence command to the host queued behind it and timed out until the
attache was rebuilt. Advance _currentSequence only on a successful send, and on
failure move on to the next queued request.
---
 .../com/cloud/agent/manager/AgentAttache.java |  3 +-
 .../manager/AgentAttacheSendNextTest.java     | 84 +++++++++++++++++++
 2 files changed, 86 insertions(+), 1 deletion(-)
 create mode 100644 engine/orchestration/src/test/java/com/cloud/agent/manager/AgentAttacheSendNextTest.java

diff --git a/engine/orchestration/src/main/java/com/cloud/agent/manager/AgentAttache.java b/engine/orchestration/src/main/java/com/cloud/agent/manager/AgentAttache.java
index 41b35ad0c78f..402bd2b6b9b9 100644
--- a/engine/orchestration/src/main/java/com/cloud/agent/manager/AgentAttache.java
+++ b/engine/orchestration/src/main/java/com/cloud/agent/manager/AgentAttache.java
@@ -532,11 +532,12 @@ protected synchronized void sendNext(final long seq) {
         logger.debug(LOG_SEQ_FORMATTED_STRING, req.getSequence(), "Sending now.  is current sequence.");
         try {
             send(req);
+            _currentSequence = req.getSequence();
         } catch (AgentUnavailableException e) {
             logger.debug(LOG_SEQ_FORMATTED_STRING, req.getSequence(), "Unable to send the next sequence");
             cancel(req.getSequence());
+            sendNext(req.getSequence());
         }
-        _currentSequence = req.getSequence();
     }
 
     public void process(final Answer[] answers) {
diff --git a/engine/orchestration/src/test/java/com/cloud/agent/manager/AgentAttacheSendNextTest.java b/engine/orchestration/src/test/java/com/cloud/agent/manager/AgentAttacheSendNextTest.java
new file mode 100644
index 000000000000..7a02f4c9b97e
--- /dev/null
+++ b/engine/orchestration/src/test/java/com/cloud/agent/manager/AgentAttacheSendNextTest.java
@@ -0,0 +1,84 @@
+// Licensed to the Apache Software Foundation (ASF) under one
+// or more contributor license agreements.  See the NOTICE file
+// distributed with this work for additional information
+// regarding copyright ownership.  The ASF licenses this file
+// to you under the Apache License, Version 2.0 (the
+// "License"); you may not use this file except in compliance
+// with the License.  You may obtain a copy of the License at
+//
+//   http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing,
+// software distributed under the License is distributed on an
+// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+// KIND, either express or implied.  See the License for the
+// specific language governing permissions and limitations
+// under the License.
+package com.cloud.agent.manager;
+
+import org.junit.Assert;
+import org.junit.Test;
+import org.mockito.Mockito;
+
+import com.cloud.agent.transport.Request;
+import com.cloud.exception.AgentUnavailableException;
+import com.cloud.host.Status;
+
+public class AgentAttacheSendNextTest {
+
+    /**
+     * Minimal concrete AgentAttache: send() fails for one designated sequence and succeeds otherwise,
+     * recording the sequence that was actually dispatched.
+     */
+    static class TestAgentAttache extends AgentAttache {
+        Long sentSeq;
+        final long failSeq;
+
+        TestAgentAttache(long failSeq) {
+            super(null, 1L, "uuid-1", "host-1", null, false);
+            this.failSeq = failSeq;
+        }
+
+        @Override
+        public void send(Request req) throws AgentUnavailableException {
+            if (req.getSequence() == failSeq) {
+                throw new AgentUnavailableException("simulated transient link failure", _id);
+            }
+            sentSeq = req.getSequence();
+        }
+
+        @Override
+        public void disconnect(Status state) {
+        }
+
+        @Override
+        protected boolean isClosed() {
+            return false;
+        }
+    }
+
+    @Test
+    public void sendNextAdvancesPastAFailedCommandToTheNextQueued() {
+        long failSeq = 100L;
+        long goodSeq = 200L;
+
+        Request failing = Mockito.mock(Request.class);
+        Mockito.when(failing.getSequence()).thenReturn(failSeq);
+        Request good = Mockito.mock(Request.class);
+        Mockito.when(good.getSequence()).thenReturn(goodSeq);
+
+        TestAgentAttache attache = new TestAgentAttache(failSeq);
+        attache._requests.add(failing);
+        attache._requests.add(good);
+
+        attache.sendNext(1L);
+
+        // A command whose send() failed (and was cancelled) must NOT become _currentSequence: no answer
+        // will ever arrive for it, so every later in-sequence command to this host would queue behind it
+        // and time out. sendNext must move on and dispatch the next queued command instead.
+        Assert.assertEquals("the next queued command should have been dispatched", Long.valueOf(goodSeq), attache.sentSeq);
+        Assert.assertEquals("current sequence must be the successfully sent command, not the failed one",
+                Long.valueOf(goodSeq), attache._currentSequence);
+        Assert.assertTrue("the request queue should be drained", attache._requests.isEmpty());
+    }
+}