display vsi name protect-group

Function

The display vsi name protect-group command displays information about the PW protection group of a specified VSI.

Format

display vsi name vsi-name protect-group [ group-name [ verbose | history ] ]

Parameters

Parameter	Description	Value
group-name	Specifies the name of a PW protection group.	The value is a string of 1 to 15 case-sensitive characters, spaces not supported.
verbose	Displays detailed information.	-
history	Displays historical switching information about PWs in a PW protection group.	-
name vsi-name	Specifies a VSI name.	The value is a string of 1 to 31 case-sensitive characters, spaces not supported. When double quotation marks are used around the string, spaces are allowed in the string.

Views

All views

Default Level

1: Monitoring level

Task Name and Operations

Task Name	Operations
l2vpn	read

Usage Guidelines

Usage Scenario

After a PW protection group is configured, run the display vsi protect-group command to view summary or detailed information about the PW protection group of a specified VSI and check whether PW configurations have taken effect. When maintaining a PW protection group, you can check the running status of the group by viewing historical switching information about PWs in the group.

Prerequisites

A PW protection group has been created, and the primary and secondary PWs have been added to the group.

Example

The actual command output varies according to the device. The command output here is only an example.

# Display detailed information about the PW protection group group1 of VSI vsi1.

<HUAWEI> display vsi name vsi1 protect-group group1 verbose
Vsi name           : vsi1
Protect group      : group1
Protect mode       : PW redundancy master
Reroute policy     : delay 30s
Last change time   : 2016-08-09 16:31:32 UTC-08:00
Last change action : 3.3.3.3:333 to 4.4.4.4:444
Last change reason : manual clear switch
Holdoff remain time: --
Reroute remain time: --   

Members            :
 PeerIp:VcId                Pri/Sec   Active              

 4.4.4.4:444                Primary   Active
 3.3.3.3:333                Secondary Inactive

# Display historical switching information about PWs in PW protection group group1 of VSI vsi1.

<HUAWEI> display vsi name vsi1 protect-group group1 history
Vsi name      : v1
Protect group : group1

Date/Time     :  2016-08-09 16:31:32 UTC-08:00
Action        :  3.3.3.3:333 to 4.4.4.4:444
Reason        :  manual clear switch

Date/Time     :  2016-08-09 15:31:32 UTC-08:00
Action        :  4.4.4.4:444 to 3.3.3.3:333
Reason        :  manual force switch

Date/Time     :  2016-08-09 12:31:32 UTC-08:00
Action        :  4.4.4.4:444 to 3.3.3.3:333
Reason        :  PW down

# Display brief information about the PW protection group of VSI vsi1.

<HUAWEI> display vsi name vsi1 protect-group
Protect-group: vsi1
-------------------------------------------------------------------------------
PeerIp:VcId                Pref   Active
-------------------------------------------------------------------------------
2.2.2.2:1                  1      Active
3.3.3.3:1                  2      Inactive

**Table 1** Description of the **display vsi name protect-group** command output
Item	Description
Vsi name	VSI name.
Protect group	Name of a PW protection group.
Protect mode	PW redundancy mode of a PW protection group: PW redundancy master: The PW redundancy mode is master/slave.
Reroute policy	Revertive switching policy of a PW protection group. The default revertive switching delay is 30s. In master/slave mode, you can modify the revertive switching policy by running the reroute command in the protect-group view.
Reroute remain time	Remaining time before a revertive switching is performed. If the value is --, no revertive switching delay is configured.
Last change time	Last PW switching time.
Last change action	Last PW switching action. A PW is uniquely identified by peerIP:VcID.
Last change reason	Reason for last PW switching: manual force switch: The PW switching is triggered by the protect-switch manual command. manual clear switch: PW switching is triggered by the protect-switch clear command. config changed: PW switching is triggered by configuration changes such as PW addition, PW deletion, or PW priority changes. fault detected: PW switching is triggered by failures detected by BFD or VCCV. PW down: PW switching occurs because the active PW goes Down. PW up: PW switching occurs because the active PW goes Up again. receive notification message: PW switching occurs because notification messages are received. tracking admin: PW switching occurs because the protection group of a service VSI is bound to the protection group of an mVSI. recovery from tracking admin: PW switching occurs because the protection group of a service VSI is unbound from the protection group of an mVSI. admin vsi receive notification message: PW switching occurs for a service VSI because the protection group of an mVSI receives notification messages.
Holdoff remain time	Remaining time before a switching is performed. If the value is --, no switching delay is configured.
Members	Members in a PW protection group.
PeerIp:VcId	VC ID, which is a peer IP address of a PW. This pair uniquely identifies a PW.
Pri/Sec	Primary/secondary status of a PW: Primary: The PW is a primary PW. Secondary: The PW is a secondary PW.
Active	Forwarding status of a PW: Active: The PW can send service packets. Inactive: The PW cannot send service packets, but can send OAM packets if the PW is Up.
Date/Time	PW switching time. For example, 2016-08-09 16:31:32 UTC-08:00 indicates that PW switching occurred at 16:31:32 of August 9, 2016 in the UTC-8 time zone.
Action	PW switching action. A PW is uniquely identified by peerIP:VcID.
Reason	Reason for PW switching: manual force switch: The PW switching is triggered by the protect-switch manual command. manual clear switch: PW switching is triggered by the protect-switch clear command. config changed: PW switching is triggered by configuration changes such as PW addition, PW deletion, or PW priority changes. fault detected: PW switching is triggered by failures detected by BFD or VCCV. PW down: PW switching occurs because the active PW goes Down. PW up: PW switching occurs because the active PW goes Up again. receive notification message: PW switching occurs because notification messages are received. tracking admin: PW switching occurs because the protection group of a service VSI is bound to the protection group of an mVSI. recovery from tracking admin: PW switching occurs because the protection group of a service VSI is unbound from the protection group of an mVSI. admin vsi receive notification message: PW switching occurs for a service VSI because the protection group of an mVSI receives notification messages.
Pref	PW priority specified by running the peer preference command in the protect-group view.