terminate process

terminate process name [forceful | graceful] {msm slot}

Description

Terminates the specified process on the switch.

Syntax Description

name Specifies the name of the process to terminate. You can terminate the following processes: bgp, eaps, exsshd (available only when you have installed the SSH module), isis, lldp, netLogin, netTools,ospf, snmpMaster,snmpSubagent, telnetd, thttpd, tftpd, vrrp, and xmld.
forceful Specifies a forceful termination.
graceful Specifies a graceful termination.
slot For a modular chassis, specifies the MSM/MM where the process should be terminated. A specifies the MSM installed in slot A, and B specifies the MSM installed in slot B. On a SummitStack, specifies the target node‘s slot number. The number is a value from 1 to 8.
Note: This parameter is available only on modular switches and SummitStack.

Default

N/A.

Usage Guidelines

If recommended by Extreme Networks Technical Support personnel, you can stop a running process.

The forceful option quickly terminates a process on demand. Unlike the graceful option, the process is immediately shutdown without any of the normal process cleanup. The status of the operation is displayed on the console. After a successful forceful termination of a process, a message similar to the following appears:

Forceful termination success for snmpMaster 

The graceful option terminates the process by allowing it to close all opened connections, notify peers on the network, and other types of process cleanup. After this phase, the process is finally terminated. After a successful graceful termination of a process, a message similar to the following appears:

Successful graceful termination for snmpSubagent 

SummitStack Only

You can issue this command only from the master node. If you issue this command from any other node, the following message appears:

 Error: This command can only be executed on Master. 

To display the status of ExtremeXOS processes on the switch, including how many times a process has been restarted, use the show process {name} {detail} {description} {slot slotid} command.

Depending on the software version running on your switch and the type of switch you have, you can terminate different or additional processes. To see which processes you can terminate, enter terminate process followed by [Tab]. The switch displays a list of available processes.

To restart a process that has been terminated, use the start process command.

Note

Note

Do not terminate a process that was installed since the last reboot unless you have saved your configuration. If you have installed a software module and you terminate the newly installed process without saving your configuration, your module may not be loaded when you attempt to restart the process with the start process command. To preserve a process‘s configuration during a terminate and (re)start cycle, save your switch configuration before terminating the process. Do not save the configuration or change the configuration during the process terminate and re(start) cycle. If you save the configuration after terminating a process, and before the process (re)starts, the configuration for that process is lost.

You can also use the terminate process command when upgrading a software modular package. For more information, see the section Upgrading a Modular Software Package.

Example

The following initiates a graceful termination of the process tftpd:

terminate process tftpd graceful

History

This command was first available in ExtremeXOS 11.0.

Support for terminating the Link Layer Discovery Protocol (lldp), network login (netLogin), and Open Shortest Path First (ospf) processes was added in ExtremeXOS 11.3.

Support for terminating the Border Gateway Protocol (bgp) and Ethernet Automatic Protection Switching (eaps) processes was added in ExtremeXOS 11.4.

Support for terminating the MultiProtocol Label Switch (mpls) and Virtual Router Redundancy Protocol (vrrp) processes was added in ExtremeXOS 11.6.

Support for terminating netTools was added in ExtremeXOS 12.4.

Platform Availability

This command is available on all platforms.