show heartbeat process

show heartbeat process {name}

Description

Displays the health of the ExtremeXOS processes.

Syntax Description


`name`	Specifies the name of the process.

Default

N/A.

Usage Guidelines

The software monitors all of the ExtremeXOS processes running on the switch. This process monitor creates and terminates XOS processes on demand (for example, when you log in or log out of the switch) and restarts processes if an abnormal termination occurs (for example, if your system crashes). The process monitor also ensures that only version-compatible processes and processes with proper licenses are started.

The show heartbeat process command is a resource for providing background system health information because you can view the health of ExtremeXOS processes on the switch.

Use this command to monitor the health of the ExtremeXOS processes. The switch uses two algorithms to collect process health information: polling and reporting. Both polling and reporting measure the heartbeat of the process. Polling occurs when a HELLO message is sent and a HELLO_ACK message is received. The two counts are the same. Reporting occurs when a HELLO_ACK message is sent only. Therefore, no HELLO messages are sent and the HELLO count remains at zero.

The show heartbeat process command displays the following information in a tabular format:

Process Name—The name of the process.
Hello—The number of hello messages sent to the process.
HelloAck—The number of hello acknowledgement messages received by the process manager.
Last Heartbeat Time—The timestamp of the last health check received by the process manager. (Unknown specifies kernel modules and they do not participate in heartbeat monitoring.)

This status information may be useful for your technical support representative if you have a network problem.

You may find it useful to capture the process information under normal operating conditions to establish a baseline. By having a baseline, if you experience a problem, you and your technical support representative can more easily identify the problem.

Example

To display the health of all processes on your system, use the following command:

show heartbeat process

The following is sample output from a switch:

Process Name     Hello HelloAck     Last Heartbeat Time
----------------------------------------------------------------------
aaa              0        254328   Tue Feb 10 05:21:46 2004
acl              50867    50867    Tue Feb 10 05:21:43 2004
bgp              0        0        Wed Feb  4 08:03:18 2004
cfgmgr           25433    25433    Tue Feb 10 05:21:33 2004
cli              84779    84779    Tue Feb 10 05:21:47 2004
cna              20234    20234    Mon Feb  9 00:28:35 2004
devmgr           0        250507   Tue Feb 10 05:21:47 2004
dirser           0        254336   Wed Feb  4 08:03:18 2004
dosprotect       0        254335   Tue Feb 10 05:21:47 2004
eaps             0        254336   Tue Feb 10 05:21:48 2004
edp              50867    50867    Tue Feb 10 05:21:44 2004
elrp             50867    50867    Tue Feb 10 05:21:43 2004
ems              63584    63584    Tue Feb 10 05:21:44 2004
epm              0        0        Wed Feb  4 08:03:18 2004
esrp             50867    50867    Tue Feb 10 05:21:46 2004
...

To display the health of the STP process on your system, use the following command:

show heartbeat process stp

The following is sample output from a switch:

Process Name     Hello HelloAck     Last Heartbeat Time
----------------------------------------------------------------------
stp              50870    50870    Tue Feb 10 05:22:13 2004

History

This command was first available in an ExtremeXOS 10.1.

Platform Availability

This command is available on ExtremeSwitching X435, X440-G2, X450-G2, X460-G2, X465, X590, X620, X670-G2, X690, X695, X870, 5320, 5420, and 5520 series switches.