# MLAG

## nv show interface <interface-id> bond mlag

Shows MLAG configuration on the bond interface.

### Command Syntax

Syntax | Description
--- | ---
`<interface-id>` | The interface name.

### Version History

Introduced in Cumulus Linux 5.0.0

### Example

    cumulus@switch:~$ nv show interface bond1 bond mlag
                    operational  applied
    --------------  -----------  -------
    enable                       on
    id              1            1
    peer-interface  hostbond_3
    status          dual

## nv show interface <interface-id> bond mlag consistency-checker

Shows the interface level consistency check parameters.

### Command Syntax

Syntax | Description
--- | ---
`<interface-id>` | The interface name.

### Version History

Introduced in Cumulus Linux 5.1.0

### Example

    cumulus@switch:~$ nv show interface bond1 bond mlag consistency-checker
    Parameter         LocalValue                    PeerValue                     Conflict  Summary
    ----------------  ----------------------------  ----------------------------  --------  -------
    bpdu-guard        off                           off                           -
    bridge-learning   yes                           yes                           -
    clag-id           1                             1                             -
    lacp-actor-mac    44:38:39:42:42:01             44:38:39:42:42:01             -
    lacp-partner-mac  00:02:00:00:00:01             00:02:00:00:00:01             -
    master            br_default                    NOT-SYNCED                    -
    mtu               9100                          9100                          -
    native-vlan       1000                          1000                          -
    restricted-role   no                            no                            -
    vlan-id           1000, 1002, 1004, 1006, 1008  1000, 1002, 1004, 1006, 1008  -

## nv show mlag

Shows global MLAG configuration on the switch.

### Version History

Introduced in Cumulus Linux 5.0.0

### Example

    cumulus@switch:~$ nv show mlag
                    operational                applied
    --------------  -------------------------  -----------------
    enable          on                         on
    debug           off                        off
    init-delay      180                        180
    mac-address     44:38:39:be:ef:aa          44:38:39:BE:EF:AA
    peer-ip         fe80::4ab0:2dff:fec4:375b  linklocal
    priority        32768                      32768
    [backup]        10.10.10.2                 10.10.10.2
    backup-active   True
    backup-reason
    local-id        48:b0:2d:4f:42:28
    local-role      primary
    peer-alive      True
    peer-id         48:b0:2d:c4:37:5b
    peer-interface  peerlink.4094
    peer-priority   32768
    peer-role       secondary
    anycast-ip      36.0.0.2

## nv show mlag backup

Shows the backup IP address configured for the MLAG peer link. The switch uses this backup IP address if the MLAG peer link goes down.

### Version History

Introduced in Cumulus Linux 5.0.0

### Example

    cumulus@switch:~$ nv show mlag backup
                vrf
    ----------  ---
    10.10.10.2

## nv show mlag backup <backup-ip>

Shows information about the MLAG backup IP address specified.

### Command Syntax

Syntax | Description
--- | ---
`<backup-ip>` | The backup IP address for the MLAG peer.

### Version History

Introduced in Cumulus Linux 5.1.0

### Example

    cumulus@switch:~$ nv show mlag backup 10.10.10.2
        operational  applied  pending
    ---  -----------  -------  -------
    vrf               default  default

## nv show mlag consistency-checker

Shows the global consistency check parameters.

### Version History

Introduced in Cumulus Linux 5.1.0

### Example

    cumulus@switch:~$ nv show mlag consistency-checker

    Global Consistency-checker
    =============================
        Parameter               LocalValue                                PeerValue                                 Conflict  Summary
        ----------------------  ----------------------------------------  ----------------------------------------  --------  -------
        anycast-ip              36.0.0.2                                  36.0.0.2                                  -
        bridge-priority         32768                                     32768                                     -
        bridge-stp-mode         rstp                                      rstp                                      -
        bridge-stp-state        on                                        on                                        -
        bridge-type             vlan-aware                                vlan-aware                                -
        clag-pkg-version        1.6.0-cl5.9.0+u7.1718894350.a2a631b98609  1.6.0-cl5.9.0+u7.1718894350.a2a631b98609  -
        clag-protocol-version   1.7.0                                     1.7.0                                     -
        peer-ip                 169.254.0.10                              169.254.0.10                              -
        peerlink-bridge-member  Yes                                       Yes                                       -
        peerlink-mtu            9100                                      9100                                      -
        peerlink-native-vlan    1                                         1                                         -
        peerlink-vlans          1, 1000, 1002, 1004, 1006, 1008           1, 1000, 1002, 1004, 1006, 1008           -
        redirect2-enable        yes                                       yes                                       -
        system-mac              44:38:39:42:42:01                         44:38:39:42:42:01

- In Cumulus Linux 5.5 and earlier, `peerlink-bridge-member` is `Peerlink-master`.
- In Cumulus Linux 5.6 and earlier, `bridge-stp-state` is `bridge-stp`.
- Cumulus Linux 5.7 and later includes consistency-checks for `bridge-stp-mode`.

## nv show mlag consistency-checker global

Shows global MLAG settings for each MLAG peer and indicates if there are any inconsistencies.

### Version History

Introduced in Cumulus Linux 5.1.0

### Example

    cumulus@switch:~$ nv show mlag consistency-checker global
    Parameter              LocalValue                PeerValue                 Conflict  Summary
    ---------------------  ------------------------  ------------------------  --------  -------
    anycast-ip             -                         -                         -
    bridge-priority        32768                     32768                     -
    bridge-stp             on                        on                        -
    bridge-type            vlan-aware                vlan-aware                -
    clag-pkg-version       1.6.0-cl5.4.0u4           1.6.0-cl5.4.0u4           -
    clag-protocol-version  1.6.0                     1.6.0                     -
    peer-ip                fe80::4ab0:2dff:fea4:ac9  fe80::4ab0:2dff:fea4:ac9  -
    peerlink-master        br_default                NOT-SYNCED                -
    peerlink-mtu           9216                      9216                      -
    peerlink-native-vlan   1                         1                         -
    peerlink-vlans         1, 10, 20, 30             1, 10, 20, 30             -
    redirect2-enable       yes                       yes                       -
    system-mac             44:38:39:be:ef:aa         44:38:39:be:ef:aa

## nv show mlag fdb

Shows the dynamic or permanent MAC addresses in the MLAG forwarding database.

### Version History

Introduced in Cumulus Linux 5.0.0

### Example

    cumulus@switch:~$ nv show mlag fdb
    local
    ========
           interface  MAC address        vlan-id
        -  ---------  -----------------  -------
        1  bond3      48:b0:2d:a2:03:9d  1
        2  bond1      48:b0:2d:51:82:fd  1
        3  bond2      48:b0:2d:f9:9e:d1  1

    peer
    =======
            interface  MAC address        vlan-id
        --  ---------  -----------------  -------
        1   bond3      48:b0:2d:a2:03:9d  20
        2   bond2      48:b0:2d:f9:9e:d1  30
        3   bond3      48:b0:2d:a2:03:9d  10
        4   bond3      48:b0:2d:83:8d:b8  1
        5   bond2      48:b0:2d:e6:e6:06  1
        6   bond1      48:b0:2d:6f:6c:13  1
        7   bond2      48:b0:2d:f9:9e:d1  10
        8   bond3      48:b0:2d:a2:03:9d  30
        9   bond1      48:b0:2d:51:82:fd  20
        10  bond1      48:b0:2d:51:82:fd  10
        11  bond2      48:b0:2d:f9:9e:d1  20
        12  bond1      48:b0:2d:51:82:fd  30

    permanent
    ============
           interface  MAC address        vlan-id
        -  ---------  -----------------  -------
        1  peerlink   44:38:39:22:01:78  10
        2  peerlink   44:38:39:22:01:78  20
        3  peerlink   44:38:39:22:01:78  30
        4  vlan10     44:38:39:22:01:7a  10
        5  vlan20     44:38:39:22:01:7a  20
        6  vlan30     44:38:39:22:01:7a  30

## nv show mlag fdb local

Shows the locally learned MAC addresses in the forwarding database.

### Version History

Introduced in Cumulus Linux 5.0.0

### Example

    cumulus@switch:~$ nv show mlag fdb local
       interface  MAC address        vlan-id
    -  ---------  -----------------  -------
    1  bond3      48:b0:2d:a2:03:9d  1
    2  bond1      48:b0:2d:51:82:fd  1
    3  bond2      48:b0:2d:f9:9e:d1  1

## nv show mlag fdb peer

Shows the MAC addresses synchronized from the forwarding database on the MLAG peer.

### Version History

Introduced in Cumulus Linux 5.0.0

### Example

    cumulus@switch:~$ nv show mlag fdb peer
        interface  MAC address        vlan-id
    --  ---------  -----------------  -------
    1   bond3      48:b0:2d:a2:03:9d  20
    2   bond2      48:b0:2d:f9:9e:d1  30
    3   bond3      48:b0:2d:a2:03:9d  10
    4   bond3      48:b0:2d:83:8d:b8  1
    5   bond2      48:b0:2d:e6:e6:06  1
    6   bond1      48:b0:2d:6f:6c:13  1
    7   bond2      48:b0:2d:f9:9e:d1  10
    8   bond3      48:b0:2d:a2:03:9d  30
    9   bond1      48:b0:2d:51:82:fd  20
    10  bond1      48:b0:2d:51:82:fd  10
    11  bond2      48:b0:2d:f9:9e:d1  20
    12  bond1      48:b0:2d:51:82:fd  30

## nv show mlag fdb permanent

Shows the permanent MAC addresses installed in the forwarding database on the MLAG peer.

### Version History

Introduced in Cumulus Linux 5.0.0

### Example

    cumulus@switch:~$ nv show mlag fdb permanent
       interface  MAC address        vlan-id
    -  ---------  -----------------  -------
    1  peerlink   44:38:39:22:01:78  10
    2  peerlink   44:38:39:22:01:78  20
    3  peerlink   44:38:39:22:01:78  30
    4  vlan10     44:38:39:22:01:7a  10
    5  vlan20     44:38:39:22:01:7a  20
    6  vlan30     44:38:39:22:01:7a  30

## nv show mlag lacpdb

Shows the LACP database on the both MLAG peers.

### Version History

Introduced in Cumulus Linux 5.0.0

### Example

    cumulus@switch:~$ nv show mlag lacpdb
    local
    ========
               lacp-bypass  MAC address
        -----  -----------  -----------------
        bond1  0            48:b0:2d:51:82:fd
        bond2  0            48:b0:2d:f9:9e:d1
        bond3  0            48:b0:2d:a2:03:9d

    peer
    =======
               lacp-bypass  MAC address
        -----  -----------  -----------------
        bond1  0            48:b0:2d:51:82:fd
        bond2  0            48:b0:2d:f9:9e:d1
        bond3  0            48:b0:2d:a2:03:9d

## nv show mlag lacpdb local

Shows the LACP database on the local switch.

### Version History

Introduced in Cumulus Linux 5.0.0

### Example

    cumulus@switch:~$ nv show mlag lacpdb local
           lacp-bypass  MAC address
    -----  -----------  -----------------
    bond1  0            48:b0:2d:51:82:fd
    bond2  0            48:b0:2d:f9:9e:d1
    bond3  0            48:b0:2d:a2:03:9d

## nv show mlag lacpdb peer

Shows the LACP database on the peer switch.

### Version History

Introduced in Cumulus Linux 5.0.0

### Example

    cumulus@switch:~$ nv show mlag lacpdb peer
           lacp-bypass  MAC address
    -----  -----------  -----------------
    bond1  0            48:b0:2d:51:82:fd
    bond2  0            48:b0:2d:f9:9e:d1
    bond3  0            48:b0:2d:a2:03:9d

## nv show mlag mdb

Shows the layer 2 multicast database.

### Version History

Introduced in Cumulus Linux 5.0.0

### Example

    cumulus@switch:~$ nv show mlag mdb

## nv show mlag mdb local

Shows the layer 2 multicast database on the local switch.

### Version History

Introduced in Cumulus Linux 5.0.0

### Example

    cumulus@switch:~$ nv show mlag mdb local

## nv show mlag mdb peer

Shows the layer 2 multicast database on the peer switch.

### Version History

Introduced in Cumulus Linux 5.0.0

### Example

    cumulus@switch:~$ nv show mlag mdb peer

## nv show mlag multicast-router-port

Shows the MLAG multicast router ports on both MLAG peers.

### Version History

Introduced in Cumulus Linux 5.0.0

### Example

    cumulus@switch:~$ nv show mlag multicast-router-port
    local
    ========
           age  domain      dual-interface  interface
        -  ---  ----------  --------------  ---------
        1  0    br_default  peerlink        peerlink

    peer
    =======

## nv show mlag multicast-router-port local

Shows MLAG multicast router port information on the local switch.

### Version History

Introduced in Cumulus Linux 5.0.0

### Example

    cumulus@switch:~$ nv show mlag multicast-router-port local
       age  domain      dual-interface  interface
    -  ---  ----------  --------------  ---------
    1  0    br_default  peerlink        peerlink

## nv show mlag multicast-router-port peer

Shows MLAG multicast router port information on the peer switch.

### Version History

Introduced in Cumulus Linux 5.0.0

### Example

    cumulus@switch:~$ nv show mlag multicast-router-port peer

## nv show mlag neighbor

Shows information about permanent and dynamic MLAG neighbors.

### Version History

Introduced in Cumulus Linux 5.0.0

### Example

    cumulus@switch:~$ nv show mlag neighbor
    dynamic
    ==========
           interface  ip-address                 MAC address        vlan-id
        -  ---------  -------------------------  -----------------  -------
        1  vlan20     fe80::4ab0:2dff:fea2:39d   48:b0:2d:a2:03:9d  20
        2  vlan30     fe80::4ab0:2dff:fef9:9ed1  48:b0:2d:f9:9e:d1  30
        3  vlan10     fe80::4ab0:2dff:fea2:39d   48:b0:2d:a2:03:9d  10
        4  vlan10     fe80::4ab0:2dff:fef9:9ed1  48:b0:2d:f9:9e:d1  10
        5  vlan30     fe80::4ab0:2dff:fea2:39d   48:b0:2d:a2:03:9d  30
        6  vlan20     fe80::4ab0:2dff:fe51:82fd  48:b0:2d:51:82:fd  20
        7  vlan10     fe80::4ab0:2dff:fe51:82fd  48:b0:2d:51:82:fd  10
        8  vlan20     fe80::4ab0:2dff:fef9:9ed1  48:b0:2d:f9:9e:d1  20
        9  vlan30     fe80::4ab0:2dff:fe51:82fd  48:b0:2d:51:82:fd  30

    permanent
    ============
            address-family  interface  ip-address                MAC address        vlan-id
        --  --------------  ---------  ------------------------  -----------------  -------
        1   2               vlan10     10.1.10.2                 44:38:39:22:01:7a  10
        2   2               vlan20     10.1.20.2                 44:38:39:22:01:7a  20
        3   2               vlan30     10.1.30.2                 44:38:39:22:01:7a  30
        4   10              vlan10     fe80::4638:39ff:fe22:17a  44:38:39:22:01:7a  10
        5   10              vlan20     fe80::4638:39ff:fe22:17a  44:38:39:22:01:7a  20
        6   10              vlan30     fe80::4638:39ff:fe22:17a  44:38:39:22:01:7a  30
        7   2               vlan10     10.1.10.3                 44:38:39:22:01:78  10
        8   2               vlan20     10.1.20.3                 44:38:39:22:01:78  20
        9   2               vlan30     10.1.30.3                 44:38:39:22:01:78  30
        10  10              vlan10     fe80::4638:39ff:fe22:178  44:38:39:22:01:78  10
        11  10              vlan20     fe80::4638:39ff:fe22:178  44:38:39:22:01:78  20
        12  10              vlan30     fe80::4638:39ff:fe22:178  44:38:39:22:01:78  30

## nv show mlag neighbor dynamic

Shows information about MLAG dynamic neighbors.

### Version History

Introduced in Cumulus Linux 5.0.0

### Example

    cumulus@switch:~$ nv show mlag neighbor dynamic
       interface  ip-address                 MAC address        vlan-id
    -  ---------  -------------------------  -----------------  -------
    1  vlan20     fe80::4ab0:2dff:fea2:39d   48:b0:2d:a2:03:9d  20
    2  vlan30     fe80::4ab0:2dff:fef9:9ed1  48:b0:2d:f9:9e:d1  30
    3  vlan10     fe80::4ab0:2dff:fea2:39d   48:b0:2d:a2:03:9d  10
    4  vlan10     fe80::4ab0:2dff:fef9:9ed1  48:b0:2d:f9:9e:d1  10
    5  vlan30     fe80::4ab0:2dff:fea2:39d   48:b0:2d:a2:03:9d  30
    6  vlan20     fe80::4ab0:2dff:fe51:82fd  48:b0:2d:51:82:fd  20
    7  vlan10     fe80::4ab0:2dff:fe51:82fd  48:b0:2d:51:82:fd  10
    8  vlan20     fe80::4ab0:2dff:fef9:9ed1  48:b0:2d:f9:9e:d1  20
    9  vlan30     fe80::4ab0:2dff:fe51:82fd  48:b0:2d:51:82:fd  30

## nv show mlag neighbor permanent

Shows information about MLAG permanent neighbors.

### Version History

Introduced in Cumulus Linux 5.0.0

### Example

    cumulus@switch:~$ nv show mlag neighbor permanent
        address-family  interface  ip-address                MAC address        vlan-id
    --  --------------  ---------  ------------------------  -----------------  -------
    1   2               vlan10     10.1.10.2                 44:38:39:22:01:7a  10
    2   2               vlan20     10.1.20.2                 44:38:39:22:01:7a  20
    3   2               vlan30     10.1.30.2                 44:38:39:22:01:7a  30
    4   10              vlan10     fe80::4638:39ff:fe22:17a  44:38:39:22:01:7a  10
    5   10              vlan20     fe80::4638:39ff:fe22:17a  44:38:39:22:01:7a  20
    6   10              vlan30     fe80::4638:39ff:fe22:17a  44:38:39:22:01:7a  30
    7   2               vlan10     10.1.10.3                 44:38:39:22:01:78  10
    8   2               vlan20     10.1.20.3                 44:38:39:22:01:78  20
    9   2               vlan30     10.1.30.3                 44:38:39:22:01:78  30
    10  10              vlan10     fe80::4638:39ff:fe22:178  44:38:39:22:01:78  10
    11  10              vlan20     fe80::4638:39ff:fe22:178  44:38:39:22:01:78  20
    12  10              vlan30     fe80::4638:39ff:fe22:178  44:38:39:22:01:78  30

## nv show mlag vni

Shows the MLAG VNIs on both MLAG peers.

### Version History

Introduced in Cumulus Linux 5.0.0

### Example

    cumulus@switch:~$ nv show mlag vni
    local
    ========
           interface  local-ip  vlan-id  vni
        -  ---------  --------  -------  ----
        1  vxlan48    27.0.0.3  1000     1000
        2  vxlan48    27.0.0.3  1002     1002
        3  vxlan48    27.0.0.3  1004     1004
        4  vxlan48    27.0.0.3  1006     1006
        5  vxlan48    27.0.0.3  1008     1008
        6  vxlan48    27.0.0.3  4027     4002
        7  vxlan48    27.0.0.3  4036     4003
        8  vxlan48    27.0.0.3  4043     4001

    peer
    =======
           interface  local-ip  vlan-id  vni
        -  ---------  --------  -------  ----
        1  vxlan48    27.0.0.4  1000     1000
        2  vxlan48    27.0.0.4  1002     1002
        3  vxlan48    27.0.0.4  1004     1004
        4  vxlan48    27.0.0.4  1006     1006
        5  vxlan48    27.0.0.4  1008     1008
        6  vxlan48    27.0.0.4  4027     4002
        7  vxlan48    27.0.0.4  4036     4003
        8  vxlan48    27.0.0.4  4043     4001

## nv show mlag vni local

Shows the MLAG VNIs configured on the local switch.

### Version History

Introduced in Cumulus Linux 5.0.0

### Example

    cumulus@switch:~$ nv show mlag vni local
       interface  local-ip  vlan-id  vni
    -  ---------  --------  -------  ----
    1  vxlan48    27.0.0.3  1000     1000
    2  vxlan48    27.0.0.3  1002     1002
    3  vxlan48    27.0.0.3  1004     1004
    4  vxlan48    27.0.0.3  1006     1006
    5  vxlan48    27.0.0.3  1008     1008
    6  vxlan48    27.0.0.3  4027     4002
    7  vxlan48    27.0.0.3  4036     4003
    8  vxlan48    27.0.0.3  4043     4001

## nv show mlag vni peer

Shows the MLAG VNIs configured on the peer switch.

### Version History

Introduced in Cumulus Linux 5.0.0

### Example

    cumulus@switch:~$ nv show mlag vni peer
       interface  local-ip  vlan-id  vni
    -  ---------  --------  -------  ----
    1  vxlan48    27.0.0.4  1000     1000
    2  vxlan48    27.0.0.4  1002     1002
    3  vxlan48    27.0.0.4  1004     1004
    4  vxlan48    27.0.0.4  1006     1006
    5  vxlan48    27.0.0.4  1008     1008
    6  vxlan48    27.0.0.4  4027     4002
    7  vxlan48    27.0.0.4  4036     4003
    8  vxlan48    27.0.0.4  4043     4001

## nv show nve vxlan mlag

Shows VXLAN source address information.

### Version History

Introduced in Cumulus Linux 5.0.0

### Example

    cumulus@switch:~$ nv show nve vxlan mlag
                    operational  applied   pending
    --------------  -----------  --------  --------
    shared-address  36.0.0.2     36.0.0.2  36.0.0.2