Introduction

The HA reset command can be executed on either device of an HA pair. Use this command if a node fails, and you have fixed the problem that caused the failover. For example, if an interface fails on a 4100 series device and you migrate to a different interface, then the failed device can be reset. Execute HA reset on the failed device to bring it into un-failed state. This will not cause the device to become active, it will just be available to become active in the event of a failover. If an interface failure is detected again, the device will revert to failed state.

Operation Notes

At least one of the 2 devices in the HA pair must be in failed state or the request will not be accepted. Reset cannot be performed during a deployment. Reset is not allowed if the device is not in an established HA pair. That is neither device can be in single node state, and neither can be in configuration sync state.

To Reset a Device in an HA Pair:

Step 1

Send an HA Reset POST request to either device.

curl -X POST -H "Accept: application/json" -H "Authorization: Bearer ACCESS_TOKEN" https://ftd.example/api/fdm/latest/devices/default/action/ha/reset

{
  "nodeRole" : "HA_SECONDARY",
  "nodeState" : "HA_ACTIVE_NODE",
  "peerNodeState" : "HA_STANDBY_NODE",
  "configStatus" : "UNKNOWN",
  "haHealthStatus" : "CRITICAL",
  "id" : "default",
  "type" : "hastatus",
  "links" : {
    "self" : "ftd.example/api/fdm/latest/devices/default/action/ha/reset/default"
  }
}

Step 2

• If the response to the previous step shows that the failed device is now in standby state, then no other actions need to be performed. Stop here.
• Otherwise, proceed to the next step.

Step 3

Send periodic HA status GET requests until the failed device reports standby state.

curl -H 'Accept: application/json'  -H "Authorization: Bearer ACCESS_TOKEN"  https://ftd.example/api/fdm/latest/devices/default/operational/ha/status/default

{
  "nodeRole" : "HA_SECONDARY",
  "nodeState" : "HA_ACTIVE_NODE",
  "peerNodeState" : "HA_STANDBY_NODE",
  "configStatus" : "IN_SYNC",
  "haHealthStatus" : "HEALTHY",
  "id" : "default",
  "type" : "hastatus",
  "links" : {
    "self" : "ftd.example/api/fdm/latest/devices/default/operational/ha/status/default"
  }
}