Configuring HMM

The Host Mobility Manager (HMM) tracks end-host movement by discovering the end host and propagating the end-host reachability information to the other switches (leaf switches) in the fabric.

This section contains payload examples to demonstrate how to use the NX-API REST API to configure HMM on the Cisco Nexus 3000 and 9000 Series switches.

Enabling BGP EVPN

Enabling BGP EVPN
POST http://<IP_Address>/api/node/mo/sys/fm/evpn.json
{
  "fmEvpn": {
    "attributes": {
      "adminSt": "enabled"
    }
  }
}

This example enables BGP EVPN control plane on the switch.


CLI Command

The CLI command below is the equivalent to the payload example displayed in the pane on the right.

[no] nv overlay evpn

For other CLI options, see the Cisco Nexus 9000 Series NX-OS Command Reference: http://www.cisco.com/c/en/us/support/switches/nexus-9000-series-switches/products-command-reference-list.html

See the NX-API DME Model Reference for detailed information about classes and attributes described in the payload: https://developer.cisco.com/site/nx-os/docs/nexus-model-reference/

For information about using the payloads, see the Cisco Nexus 9000 Series NX-OS Programmability Guide https://www.cisco.com/c/en/us/support/switches/nexus-9000-series-switches/products-programming-reference-guides-list.html

Enabling Fabric Forwarding

Enabling Fabric Forwarding
POST http://<IP_Address>/api/node/mo/sys/fm/hmm.json
{
  "fmHmm": {
    "attributes": {
      "adminSt": "enabled"
    }
  }
}

This example enables the fabric forwarding feature.


CLI Command

The CLI command below is the equivalent to the payload example displayed in the pane on the right.

[no] feature fabric forwarding

For other CLI options, see the Cisco Nexus 9000 Series NX-OS Command Reference: http://www.cisco.com/c/en/us/support/switches/nexus-9000-series-switches/products-command-reference-list.html

See the NX-API DME Model Reference for detailed information about classes and attributes described in the payload: https://developer.cisco.com/site/nx-os/docs/nexus-model-reference/

For information about using the payloads, see the Cisco Nexus 9000 Series NX-OS Programmability Guide https://www.cisco.com/c/en/us/support/switches/nexus-9000-series-switches/products-programming-reference-guides-list.html

Configuring an AnyCast Gateway

Configuring an AnyCast Gateway
POST http://<IP_Address>/api/node/mo/sys/hmm/fwdinst.json
{
  "hmmFwdInst": {
    "attributes": {
      "amac": "11:22:33:44:55:66",
      "limitVlanMac": "1024"
    }
  }
}

This example configures an Anycast Gateway.


CLI Commands

The CLI commands and options listed below are the equivalent to the payload example displayed in the pane on the right.

[no] fabric forwarding anycast-gateway-mac <mac>
[no] fabric forwarding limit-vlan-mac <max-limit>

For other CLI options, see the Cisco Nexus 9000 Series NX-OS Command Reference: http://www.cisco.com/c/en/us/support/switches/nexus-9000-series-switches/products-command-reference-list.html

See the NX-API DME Model Reference for detailed information about classes and attributes described in the payload: https://developer.cisco.com/site/nx-os/docs/nexus-model-reference/

For information about using the payloads, see the Cisco Nexus 9000 Series NX-OS Programmability Guide https://www.cisco.com/c/en/us/support/switches/nexus-9000-series-switches/products-programming-reference-guides-list.html

Enabling Duplicate Detection for IP and MAC Addresses

Enabling Duplicate Detection for IP and MAC Addresses
POST http://<IP_Address>/api/node/mo/sys/hmm/fwdinst/evpn.json
{
  "hmmFwdEvpn": {
    "attributes": {
      "ddHmmoves": "25",
      "ddHnsecs": "180"
    }
  }
}


CLI Commands

The CLI commands and options listed below are the equivalent to the payload example displayed in the pane on the right.

[no] fabric forwarding dup-host-ip-addr-detection <mmoves> <nsecs>
[no] fabric forwarding dup-host-recovery-timer <timeout> recover-count <count>

For other CLI options, see the Cisco Nexus 9000 Series NX-OS Command Reference: http://www.cisco.com/c/en/us/support/switches/nexus-9000-series-switches/products-command-reference-list.html

See the NX-API DME Model Reference for detailed information about classes and attributes described in the payload: https://developer.cisco.com/site/nx-os/docs/nexus-model-reference/

For information about using the payloads, see the Cisco Nexus 9000 Series NX-OS Programmability Guide https://www.cisco.com/c/en/us/support/switches/nexus-9000-series-switches/products-programming-reference-guides-list.html

Creating an SVI as an Anycast Gateway

Creating an SVI as an Anycast Gateway
POST http://<IP_Address>/api/node/mo/sys.json
{
  "topSystem": {
    "children": [
      {
        "interfaceEntity": {
          "children": [
            {
              "sviIf": {
                "attributes": {
                  "id": "vlan10"
}}}]}},
      {
        "hmmEntity": {
          "children": [
            {
              "hmmFwdInst": {
                "children": [
                  {
                    "hmmFwdIf": {
                      "attributes": {
                        "id": "vlan10",
                        "mode": "anycastGW"
}}}]}}]}},
      {
        "fmEntity": {
          "children": [
            {
              "fmInterfaceVlan": {
                "attributes": {
                  "adminSt": "enabled"
}}}]}}]}}

This example enables the VLAN network interface feature, creates an SVI, and associates the SVI with the Anycast Gateway.


CLI Commands

The CLI commands and options listed below are the equivalent to the payload example displayed in the pane on the right.

[no] feature interface-vlan
[no] interface vlan 10
[no] fabric forwarding mode anycast-gateway

For other CLI options, see the Cisco Nexus 9000 Series NX-OS Command Reference: http://www.cisco.com/c/en/us/support/switches/nexus-9000-series-switches/products-command-reference-list.html

See the NX-API DME Model Reference for detailed information about classes and attributes described in the payload: https://developer.cisco.com/site/nx-os/docs/nexus-model-reference/

For information about using the payloads, see the Cisco Nexus 9000 Series NX-OS Programmability Guide https://www.cisco.com/c/en/us/support/switches/nexus-9000-series-switches/products-programming-reference-guides-list.html