set link-state track

Use this command to associate downstream ports with upstream ports, defined by a tracked object, in order to facilitate link state changes to the operational status of downstream ports due to link state changes by upstream ports.


set link-state track object-name [downstream port-string]


object-name Specifies a port-group tracked object.
downstream port-string (Optional) Specifies the downstream ports to associate with the upstream ports defined by the tracked object. Only Ethernet ports are supported.


If no downstream ports are specified, none are added to the Link-State application entry.


Command mode.


Devices connected to the switch may have failover capabilities that enhance network redundancy, but require an action by the switch to trigger that functionality. The Link-State application provides a facility that triggers link loss on downstream links if the associated upstream links go down.

The Link-State application associates with downstream links, while the upstream links are associated with tracked objects (part of the Tracked Object Manager). If the Tracked Object Manager detects a state change with the upstream links, the Link-State application is informed. If the upstream links are down, the Link-State application brings down the link to the downstream ports, causing link loss. The downstream device reacts to this and initiates its failover capability. Similarly, if the upstream links are up, the Link-State application attempts to bring up the downstream links. There may be other protocols or applications in the system that prevents the link from coming up.

When the Link-State application needs to influence the operational state of the downstream ports, it sets their operational status to down. In order for this feature to function, you must enable the force link down feature with the set forcelinkdown enable command. You can display the cause for port operation status down with the show port operstatuscause command.

Refer to Tracked Object Commands for details on creating a port-group tracked object for use with the Link-State application.


This example creates a port-group tracked object named ls_group, changes the defaults for delays to the up/down status messages for the object from the Tracked Object Manager, gives it a description, puts it in service, then configures the Link-State application to use that tracked object and associate it with downstream ports.

System(su-config)->track ls_group port-group
System(su-config-track-obj)->delay up 5 down 5
System(su-config-track-obj)->description “link-state group1”
System(su-config-track-obj)->port tg.2.1-4
System(su)->set link-state track ls_group downstream ge.1.1-5