Update lisa/sut_orchestrator/openvmm/node.py

Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>

Author: vyadavmsft

lisa/sut_orchestrator/openvmm/node.py

@@ -120,18 +120,20 @@ def configure_connection(self, node: RemoteNode, log: Logger) -> None:
             port=runbook.network.ssh_port,
             public_port=runbook.network.ssh_port,
         )
-        try:
-            wait_tcp_port_ready(
-                runbook.network.connection_address,
-                runbook.network.ssh_port,
-                log=log,
-                timeout=OPENVMM_CONNECTION_TIMEOUT,
-            )
-        except Exception as identifier_error:
+        is_ready, error_code = wait_tcp_port_ready(
+            runbook.network.connection_address,
+            runbook.network.ssh_port,
+            log=log,
+            timeout=OPENVMM_CONNECTION_TIMEOUT,
+        )
+        if not is_ready:
             raise LisaException(
                 "OpenVMM guest SSH port did not become reachable at "
-                f"{runbook.network.connection_address}:{runbook.network.ssh_port}"
-            ) from identifier_error
+                f"{runbook.network.connection_address}:{runbook.network.ssh_port} "
+                f"(error code: {error_code}). Verify the guest is running, "
+                "networking is configured correctly, and the SSH service is "
+                "listening on the expected port."
+            )
 
     def stop_node(self, node: Node, wait: bool = True) -> None:
         node_context = get_node_context(node)