Ring MAC Operations Commands

disable-aging

Syntax

[no] disable-aging

Context

config>card>mda>ring

Description

This command disables MAC address aging across an Ethernet ring.

As is the case for a Layer 2 switch, learned MACs can be aged out if no packets are sourced from the MAC address for a period of time (the aging time). In each ring, there are independent aging timers for local learned MAC and remote learned MAC entries in the FDB. The disable-aging command turns off aging for local and remote learned MAC addresses.

The no form of this command enables aging on the ring.

Default

no disable-aging

disable-learning

Syntax

[no] disable-learning

Context

config>card>mda>ring

Description

This command disables learning of new MAC addresses in the ring FDB.

When disable-learning is enabled, new source MAC addresses will not be entered in the ring FDB. This is true for both local and remote MAC addresses.

When disable-learning is disabled, new source MAC addresses will be learned and entered into the ring FDB.

This parameter is mainly used in conjunction with the discard-unknown-source command.

The no form of this command enables learning of MAC addresses.

Default

no disable-learning

discard-unknown-source

Syntax

[no] discard-unknown-source

Context

config>card>mda>ring

Description

This command specifies that packets with an unknown source MAC address received on a ring port will be dropped if the source MAC is not already in the FDB (that is, the source MAC was not learned before the discard-unknown-source command was enabled or is not a static entry already created for the packet MAC).

When disabled, the packets are flooded to the other ring port or forwarded to the v-port (if the packets are addressed to the v-port).

The no form of this command disables discard-unknown-source.

Default

no discard-unknown-source

fdb-table-high-wmark

Syntax

fdb-table-high-wmark high-water-mark

no fdb-table-high-wmark

Context

config>card>mda>ring

Description

This command specifies the upper threshold value for learned FDB entries. The high-water-mark is configured as a percentage of the FDB. When the number of FDB entries exceeds the high-water-mark, the system raises a log event.

The no form of this command returns the maximum FDB table high-water-mark to the default (95%).

Default

no fdb-table-high-wmark

Parameters

high-water-mark

specifies the upper threshold for FDB entries as a percentage of FDB table size, which when exceeded, causes the system to raise a log event

Values

0 to 100

fdb-table-size

Syntax

fdb-table-size table-size

no fdb-table-size

Context

config>card>mda>ring

Description

This command specifies the maximum number of MAC entries in the dynamic FDB for the ring.

The no form of this command returns the maximum FDB table size to the default (512).

Default

no fdb-table-size

Parameters

table-size

the maximum number of learned MAC entries in the FDB for the ring

Values

4 to 512

mac-pinning

Syntax

[no] mac-pinning port port-id

Context

config>card>mda>ring

Description

This command keeps MAC address information that has been learned from a source frame in the FDB until the expiry of the mac-aging timer, which is specified using the remote-age command). If a MAC address is pinned and a frame with an existing source MAC address is received from the other ring port, the FDB entry is not altered—the address that was learned from the first source frame is preserved until the expiry of the aging timer. If the aging timer is disabled, then the MAC address remains pinned until the timer is enabled again.

The no form of this command disables mac-pinning.

Default

no mac-pinning

Parameters

port-id

specifies the physical ring port

remote-age

Syntax

remote-age aging-timer

no remote-age

Context

config>card>mda>ring

Description

This command specifies the aging time for remotely learned MAC addresses in the FDB.

As is the case for a Layer 2 switch, learned MAC addresses can be aged out if no packets are sourced from the MAC address for a period of time (the aging time). The remote-age timer specifies the aging time for remotely learned MAC addresses.

The no form of this command returns the remote aging timer to the default value (900 s).

Default

no remote-age

Parameters

aging-timer

the aging time for remote MAC addresses, expressed in seconds

Values

60 to 86400

static-mac

Syntax

[no] static-mac mac ieee-address port port-id [create]

Context

config>card>mda>ring

Description

This command creates a local static MAC entry in the FDB for the specified port. The maximum number of static MAC addresses per ring adapter card is 256.

Static MAC definitions on one edge device are not propagated to other edge devices; that is, each edge device has an independent FDB.

Only one static MAC entry (local or remote) can be defined per MAC address per instance.

By default, no static MAC address entries are defined.

The no form of this command deletes the static MAC entry with the specified MAC address associated with the port from the FDB.

Parameters

ieee-address

specifies the 48-bit MAC address for the static ARP in the form aa:bb:cc:dd:ee:ff or aa-bb-cc-dd-ee-ff where aa, bb, cc, dd, ee and ff are hexadecimal numbers (cannot be all zeros). Allowed values are any non-broadcast, non-multicast MAC, and non-IEEE reserved MAC addresses.

port-id

specifies the port that is associated with the specified MAC address

create

this keyword is mandatory when specifying a static MAC address