Bare Metal Transport Node (Server) Status Shows "Install Failed" Due to nsx-baremetal Service Stop

Products

• VMware NSX

Issue/Introduction

A Bare Metal Transport Node displays an "Install Failed" status within the NSX Manager UI. Investigation on the bare metal server reveals that the nsx-baremetal service (the bare metal equivalent of the nsx-opsagent on ESXi hosts) is down or reporting an error state.

Environment

VMware NSX
Bare Metal Transport Nodes

Cause

The nsx-baremetal service has stopped functioning or entered an error state, interrupting communication between the bare metal host and the NSX management plane.

Resolution

 

• Log in to the bare metal server command-line interface (CLI) with root privileges.

• Confirm the nsx-baremetal service is down or in an error state by executing: systemctl status nsx-baremetal

• Restart the nsx-baremetal service to restore operation: systemctl restart nsx-baremetal

• Verify the service has successfully started and is actively running: systemctl status nsx-baremetal

• Retrieve the SSH thumbprint of the bare metal server. This will be required to re-authenticate the node with the NSX Manager.

• Log in to the NSX Manager UI.

• Navigate to System > Nodes.

• Select the target bare metal transport node that was just restarted.

• Click the Install Failed link, and then click Resolve.

• Input the Bare Metal Transport Node credentials (username and password) along with the server thumbprint obtained in Step 5.

• Click Save to re-initiate the connection and resolve the node status.

 

Additional Information

Ensure network connectivity on the required ports (such as SSH TCP/22 and NSX RPC communication) remains unblocked between the NSX Manager and the bare metal server.

 

If the above steps do not resolve the issue, please open a case with Broadcom Support Creating and managing Broadcom cases (142884)

 

If the Bare Metal Transport Node reports Install Failed in the UI please reference Bare Metal server show "Install Failed" in NSX UI (396152)