Configuring VRRPv3

By default, when VRRPv3 is enabled on the device, a MO calls /sys/vrrpv3/inst/ is created. This is a VRRPv3 configuration instance. As you create VRRPv3 IDs, additional objects are created under the /sys/vrrpv3/inst/ object.

Enabling VRRPv3

Enabling VRRPv3

POST http://<IP_Address>/api/mo/sys/fm/vrrp.json

{
  "fmEntity": {
    "children": [
      {
        "fmVrrpv3": {
          "attributes": {
            "adminSt": "enabled"
}}}]}}

{
    imdata:[]
}

<System>
  <fm-items>
    <vrrpv3-items>
      <adminSt>enabled</adminSt>
    </vrrpv3-items>
  </fm-items>
</System>

CLI Command

The CLI command below is the equivalent to the payload example displayed in the pane on the right. Click the DME tab in the top-left corner of the right pane to view the JSON payload or the YANG tab to view the XML payload.

feature vrrpv3

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

Disabling VRRPv3

Disabling VRRPv3

POST http://<IP_Address>/api/mo/sys/fm/vrrp.json

{
  "fmEntity": {
    "children": [
      {
        "fmVrrpv3": {
          "attributes": {
            "adminSt": "disabled"
}}}]}}

{
    imdata:[]
}

<System>
  <fm-items>
    <vrrpv3-items>
      <adminSt>disabled</adminSt>
    </vrrpv3-items>
  </fm-items>
</System>

CLI Command

no feature vrrpv3

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/

Creating a VRRPv3 Interface

Creating a VRRPv3 Interface

POST http://<ip_address>/api/mo/sys/vrrpv3/inst.json

{
 "vrrpv3Inst": {
    "children": [
      {
        "vrrpv3Interface": {
          "attributes": {
            "id": "eth1/7"
          },
          "children": [
            {
              "vrrpv3Vr": {
                "attributes": {
                  "af": "ipv4",
                  "id": "10"
}}}]}}]}}

{
    imdata:[]
}

<System>
  <vrrpv3-items>
    <inst-items>
      <if-items>
        <Interface-list>
          <id>eth1/7</id>
          <id-items>
            <Vr-list>
              <id>10</id>
              <af>ipv4</af>
            </Vr-list>
          </id-items>
        </Interface-list>
      </if-items>
    </inst-items>
  </vrrpv3-items>
</System>

The HTTP request shown in this example creates a VRRPv3 instance with a group ID of 10 and an IPv4 address family.

CLI Commands

The CLI commands and options are equivalent to the payload examples displayed in the pane on the right. Click the DME tab in the top-left corner of the right pane to view the JSON payload or the YANG tab to view the XML payload.

interface ethernet1/7
vrrpv3 10 address-family ipv4

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/

Generating a VRRPv3 Interface

Generating a VRRPv3 Interface

POST http://<ip_address>/api/mo/sys/vrrpv3/inst.json

{
  "topSystem": {
    "children": [
      {
        "vrrpv3Entity": {
          "children": [
            {
              "vrrpv3Inst": {
                "children": [
                  {
                    "vrrpv3Interface": {
                      "attributes": {
                        "id": "eth1/7"
                      },
                      "children": [
                        {
                          "vrrpv3Vr": {
                            "attributes": {
                              "af": "ipv6",
                              "id": "123"      
}}}]}}]}}]}},{
        "interfaceEntity": {
          "children": [
            {
              "l1PhysIf": {
                "attributes": {
                  "id": "eth1/7",
                  "layer": "Layer3",
                  "userCfgdFlags": "admin_layer"
}}}]}}]}}

{
    imdata:[]
}

<System>
  <vrrpv3-items>
    <inst-items>
      <if-items>
        <Interface-list>
          <id>eth1/7</id>
          <id-items>
            <Vr-list>
              <id>123</id>
              <af>ipv6</af>
            </Vr-list>
          </id-items>
        </Interface-list>
      </if-items>
    </inst-items>
  </vrrpv3-items>
  <intf-items>
    <phys-items>
      <PhysIf-list>
        <id>eth1/7</id>
        <layer>Layer3</layer>
        <userCfgdFlags>admin_layer</userCfgdFlags>
      </PhysIf-list>
    </phys-items>
  </intf-items>
</System>

CLI Commands

interface ethernet1/7
no switchport
vrrpv3 123 address-family ipv6

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/

Creating a Primary VRRP ID and Address Family

Creating a Primary VRRP ID and Address Family

POST http://<IP_address>/api/mo/sys/vrrpv3/inst.json

{
 "vrrpv3Interface": {
    "attributes": {
      "id": "eth1/7"
    },
    "children": [
      {
        "vrrpv3Vr": {
          "attributes": {
            "af": "ipv4",
            "id": "10",
            "ip": "100.0.1.10"
}}}]}}

{
    imdata:[]
}

<System>
  <vrrpv3-items>
    <inst-items>
      <if-items>
        <Interface-list>
          <id>eth1/7</id>
          <id-items>
            <Vr-list>
              <id>10</id>
              <af>ipv4</af>
              <ip>100.0.1.10</ip>
            </Vr-list>
          </id-items>
        </Interface-list>
      </if-items>
    </inst-items>
  </vrrpv3-items>
</System>

The HTTP request shown in this example creates a Managed Object called "vrrpv3Vr" with an address family attribute (af) of ipv4, an address family ID of "10", and an IP address of 10.10.10.102.

CLI Commands

interface ethernet1/7
vrrpv3 10 address-family ipv4
address 100.0.1.10 primary

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/

Configuring VRRPv3 Control Group for IPv6

Configuring VRRPv3 for IPv6

POST http://<mgmt0_IP>/api/mo/sys/vrrpv3/inst.json

{
"vrrpv3Inst": {
 "children": [
  {
    "vrrpv3Interface": {
      "attributes": {
        "id": "eth1/1"
},
"children": [
{
  "vrrpv3Vr": {
    "attributes": {
      "af": "ipv6",
      "id": "1",
      "ip": "fe80::1",
      "preempt": "disabled",
      "priCfg": "120"
},
"children": [
  {
    "vrrpv3Addr": {
      "attributes": {
        "addr": "1::5"
}}},{
"vrrpv3Addr": {
  "attributes": {
    "addr": "1::2"
}}},{
"vrrpv3Addr": {
  "attributes": {
    "addr": "1::8"
}}},{
"vrrpv3Addr": {
  "attributes": {
    "addr": "1::3"
}}},{
"vrrpv3Addr": {
  "attributes": {
    "addr": "1::7"
}}},{
"vrrpv3Addr": {
  "attributes": {
    "addr": "1::6"
}}},{
"vrrpv3Addr": {
  "attributes": {
    "addr": "1::4"
}}}]}}]}}]}}

{
    imdata:[]
}

<System>
  <vrrpv3-items>
    <inst-items>
      <if-items>
        <Interface-list>
          <id>eth1/1</id>
          <id-items>
            <Vr-list>
              <id>1</id>
              <af>ipv6</af>
              <ip>fe80::1</ip>
              <preempt>disabled</preempt>
              <priCfg>120</priCfg>
              <addr-items>
                <Addr-list>
                  <addr>1::5</addr>
                </Addr-list>
                <Addr-list>
                  <addr>1::2</addr>
                </Addr-list>
                <Addr-list>
                  <addr>1::8</addr>
                </Addr-list>
                <Addr-list>
                  <addr>1::3</addr>
                </Addr-list>
                <Addr-list>
                  <addr>1::7</addr>
                </Addr-list>
                <Addr-list>
                  <addr>1::6</addr>
                </Addr-list>
                <Addr-list>
                  <addr>1::4</addr>
                </Addr-list>
              </addr-items>
            </Vr-list>
          </id-items>
        </Interface-list>
      </if-items>
    </inst-items>
  </vrrpv3-items>
</System>

When configuring a VRRPv3 control group for IPv6, the IP in the payload must be a LINK-Local address. For VRRPv3 IPv6 configurations, link local is the primary address. So global unicast addresses must be the secondary addresses (child MOs).

Note: Secondary IP address support was added from Release 7.0(3)I6(1) where as primary IP and vrrpv3 REST configs are supported from Release 7.0(3)I5(1).

CLI Commands

The CLI commands and options listed below are the equivalent to the payload examples displayed in the pane on the right. Click the DME tab in the top-left corner of the right pane to view the JSON payload or the YANG tab to view the XML payload.

interface ethernet1/1
vrrpv3 1 address-family ipv6
  priority 120
  no preempt
  address fe80::1 primary
  address 1::2
  address 1::3
  address 1::4
  address 1::5
  address 1::6
  address 1::7
  address 1::8

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/

Configuring VRRPv3 Control Group for IPv4

Configuring VRRPv3 for IPv4

POST http://<mgmt0_IP>/api/mo/sys/vrrpv3/inst.json

{
  "vrrpv3Inst": {
    "children": [
      {
        "vrrpv3Interface": {
          "attributes": {
            "id": "eth1/1"
},
"children": [
{
  "vrrpv3Vr": {
    "attributes": {
      "advIntvl": "1100",
      "af": "ipv4",
      "id": "1",
      "ip": "1.1.1.2",
      "preempt": "enabled",
      "preemptDelayMin": "10",
      "priCfg": "150"
},
"children": [
  {
    "vrrpv3Addr": {
      "attributes": {
        "addr": "1.1.1.8"
}}},{
"vrrpv3Addr": {
  "attributes": {
    "addr": "1.1.1.3"
}}},{
"vrrpv3Addr": {
  "attributes": {
    "addr": "1.1.1.7"
}}},{
"vrrpv3Addr": {
  "attributes": {
    "addr": "1.1.1.9"
}}},{
"vrrpv3Addr": {
  "attributes": {
    "addr": "1.1.1.4"
}}},{
"vrrpv3Addr": {
  "attributes": {
    "addr": "1.1.1.5"
}}},{
"vrrpv3Addr": {
  "attributes": {
    "addr": "1.1.1.6"
}}}]}}]}}]}}

{
    imdata:[]
}

<System>
  <vrrpv3-items>
    <inst-items>
      <if-items>
        <Interface-list>
          <id>eth1/1</id>
          <id-items>
            <Vr-list>
              <id>1</id>
              <af>ipv4</af>
              <advIntvl>1100</advIntvl>
              <ip>1.1.1.2</ip>
              <preempt>enabled</preempt>
              <preemptDelayMin>10</preemptDelayMin>
              <priCfg>150</priCfg>
              <addr-items>
                <Addr-list>
                  <addr>1.1.1.8</addr>
                </Addr-list>
                <Addr-list>
                  <addr>1.1.1.3</addr>
                </Addr-list>
                <Addr-list>
                  <addr>1.1.1.7</addr>
                </Addr-list>
                <Addr-list>
                  <addr>1.1.1.9</addr>
                </Addr-list>
                <Addr-list>
                  <addr>1.1.1.4</addr>
                </Addr-list>
                <Addr-list>
                  <addr>1.1.1.5</addr>
                </Addr-list>
                <Addr-list>
                  <addr>1.1.1.6</addr>
                </Addr-list>
              </addr-items>
            </Vr-list>
          </id-items>
        </Interface-list>
      </if-items>
    </inst-items>
  </vrrpv3-items>
</System>

Configures a VRRPv3 control group for IPv4.

CLI Commands

interface ethernet1/1
vrrpv3 1 address-family ipv4
  timers advertise 1100
  priority 150
   preempt delay minimum 10
   address 1.1.1.2 primary
   address 1.1.1.3 secondary
   address 1.1.1.4 secondary
   address 1.1.1.5 secondary
   address 1.1.1.6 secondary
   address 1.1.1.7 secondary
   address 1.1.1.8 secondary
   address 1.1.1.9 secondary

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/

Configuring VRRPv3 Object Tracking

Configuring VRRPv3 Object Tracking

POST http://<mgmt0_IP>/api/mo/sys.json

{
  "topSystem": {
    "children": [
      {
        "vrrpv3Entity": {
          "children": [
            {
              "vrrpv3Inst": {
                "children": [
                  {
                    "vrrpv3Interface": {
                      "attributes": {
                        "id": "vlan123"
                      },
                      "children": [
                        {
                          "vrrpv3Vr": {
                            "attributes": {
                              "af": "ipv4",
                              "id": "123"
                            },
                            "children": [
                              {
                                "vrrpv3ObjectTrack": {
                                  "attributes": {
                                    "decrPrio": "10",
                                    "id": "123"
                                  }
                                }
                              }
                            ]
                          }
                        }
                      ]
                    }
                  }
                ]
              }
            }
          ]
        }
      },
      {
        "interfaceEntity": {
          "children": [
            {
              "sviIf": {
                "attributes": {
                  "id": "vlan123"
                }
              }
            }
          ]
        }
      }
    ]
  }
}

{
    imdata:[]
}

<System>
  <vrrpv3-items>
    <inst-items>
      <if-items>
        <Interface-list>
          <id>vlan123</id>
          <id-items>
            <Vr-list>
              <id>123</id>
              <af>ipv4</af>
              <track-items>
                <ObjectTrack-list>
                  <id>123</id>
                  <decrPrio>10</decrPrio>
                </ObjectTrack-list>
              </track-items>
            </Vr-list>
          </id-items>
        </Interface-list>
      </if-items>
    </inst-items>
  </vrrpv3-items>
  <intf-items>
    <svi-items>
      <If-list>
        <id>vlan123</id>
      </If-list>
    </svi-items>
  </intf-items>
</System>

Note: This example was added in Release 9.2(2)

CLI Commands

The CLI commands are equivalent to the payload examples displayed in the pane on the right. Click the DME tab in the opt-left corner of the pane on the right to view the JSON payload. Click the YANG tab to view the xML payload.

interface vlan 123
vrrpv3 address-family ipv4
track 123

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/

Unconfiguring VRRPv3 Object Tracking

Unconfiguring VRRPv3 Object Tracking

POST http://<mgmt0_IP>/api/mo/sys.json


{
  "topSystem": {
    "children": [
      {
        "vrrpv3Entity": {
          "children": [
            {
              "vrrpv3Inst": {
                "children": [
                  {
                    "vrrpv3Interface": {
                      "attributes": {
                        "id": "vlan123"
                      },
                      "children": [
                        {
                          "vrrpv3Vr": {
                            "attributes": {
                              "af": "ipv4",
                              "id": "123"
                            },
                            "children": [
                              {
                                "vrrpv3ObjectTrack": {
                                  "attributes": {
                                    "id": "123",
                                    "status": "deleted"
                                  }
                                }
                              }
                            ]
                          }
                        }
                      ]
                    }
                  }
                ]
              }
            }
          ]
        }
      },
      {
        "interfaceEntity": {
          "children": [
            {
              "sviIf": {
                "attributes": {
                  "id": "vlan123"
                }
              }
            }
          ]
        }
      }
    ]
  }
}

{
    imdata:[]
}

 <System>
  <vrrpv3-items>
    <inst-items>
      <if-items>
        <Interface-list>
          <id>vlan123</id>
          <id-items>
            <Vr-list>
              <id>123</id>
              <af>ipv4</af>
              <track-items>
                <ObjectTrack-list xc:operation="delete">
                  <id>123</id>
                </ObjectTrack-list>
              </track-items>
            </Vr-list>
          </id-items>
        </Interface-list>
      </if-items>
    </inst-items>
  </vrrpv3-items>
  <intf-items>
    <svi-items>
      <If-list>
        <id>vlan123</id>
      </If-list>
    </svi-items>
  </intf-items>
</System>

Note: This example was added in Release 9.2(2)

CLI Commands

interface vlan 123
vrrpv3 address-family ipv4
no track 123

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/