G8031 ELPS Commands
This chapter describes the G8031 Ethernet Linear Protection Switching (ELPS) commands
clear
Use this command to perform clear operation on g8031 protection group.
Command Syntax
clear bridge <1-32> g8031 eps-id <1-32>
Parameters
<1-32>
Bridge name
<1-32>
Protection group id
Command Mode
Exec mode.
Applicability
This command was introduced before OcNOS version 5.0.
Examples
# clear bridge 1 g8031 eps-id 10
debug g8031
Use this command to debug configuration.
Command Syntax
debug g8031 (all|events|fsm|hal|rx|tx)
no debug g8031 (all|events|fsm|hal|rx|tx)
Parameters
all
All debugging options.
events
Protocol related events.
fsm
Instance Finite State Machine updates.
hal
HAL events.
rx
Received PDUs.
tx
Transmitted PDUs.
Command Mode
Exec mode.
Applicability
This command was introduced in OcNOS version 6.0.0.
Examples
# debug g8031 tx
# debug g8031 all
exercise
Use this command to perform exercise operation on g8031 protection group.
Command Syntax
exercise bridge <1-32> g8031 eps-id <1-32>
Parameters
<1-32>
Bridge name
<1-32>
Protection group id
Command Mode
Exec mode.
Applicability
This command was introduced before OcNOS version 5.0.
Examples
# exercise bridge 1 g8031 eps-id 10
force-switch
Use this command to perform force-switch on g8031 protection group.
Command Syntax
force-switch bridge <1-32> g8031 eps-id <1-32>
Parameters
<1-32>
Bridge name
<1-32>
Protection group id
Command Mode
Exec mode
Applicability
This command was introduced before OcNOS version 5.0.
Examples
# force-switch bridge 1 g8031 eps-id 10
g8031 eps-id
Use this command to configure a g8031 protection group.
Use the no form of this command to delete a g8031 protection group.
Command Syntax
g8031 eps-id <1-32> bridge <1-32>
no g8031 eps-id <1-32>
Parameters
<1-32>
Protection group id.
<1-32>
Bridge group for bridging.
Command Mode
Config mode
Applicability
This command was introduced before OcNOS version 5.0.
Examples
#configure terminal
(config)#g8031 eps-id 10 bridge 1
(g8031-config-switching)#
instance
Use this command to set instance-id for a particular g8031 protection group.
Use the no form of this command to remove instance-id for a g8031 protection group.
Note: Once instance is configured, working and protection ports can not be modified.
Command Syntax
instance <1-63>
no instance
Parameters
<1-63>
instance-id
Command Mode
G8031 Switching Mode.
Applicability
This command was introduced before OcNOS version 5.0.
Examples
#configure terminal
(config)#g8031 eps-id 10 bridge 1
(g8031-config-switching)#instance 3
level
Use this command to associate CFM with g8031 protection group.
Use the no form of this command to disassociate CFM from g8031 protection group.
Note: It is mandatory for Working-port MEP and Protection-Port MEP to be in different Maintenance Domain but in same Maintenance Level. Moreover, Maintenance Association Vlan-id should be same as g8031 primary-vlan id. If both the conditions are met then, g8031 protection group can be associated to using the 'level' command.
Command Syntax
level <0-7>
no level
Parameters
<0-7>
domain level.
Command Mode
G8031 Switching Mode.
Applicability
This command was introduced before OcNOS version 5.0.
Examples
#configure terminal
(config)#g8031 eps-id 10 bridge 1
(g8031-config-switching)#mode one-and-one-bidirectional
(g8031-config-switching)#level 3
local-freeze
Use this command to locally freeze the g8031 protection group.
Use the no form of this command to remove local-freeze from g8031 protection group.
Command Syntax
local-freeze
no local-freeze
Parameters
None.
Command Mode
G8031 Switching Mode.
Applicability
This command was introduced before OcNOS version 5.0.
Examples
#configure terminal
(config)#g8031 eps-id 10 bridge 1
(g8031-config-switching)#mode one-and-one-bidirectional
(g8031-config-switching)#local-freeze
lockout
Use this command to lockout the g8031 protection group.
Command Syntax
lockout bridge <1-32> g8031 eps-id <1-32>
Parameters
<1-32>
Bridge name.
<1-32>
Protection group id.
Command Mode
Exec mode.
Applicability
This command was introduced before OcNOS version 5.0.
Examples
# lockout bridge 1 g8031 eps-id 10
manual-switch
Use this command to perform manual-switch on g8031 protection group.
Command Syntax
manual-switch bridge <1-32> g8031 eps-id <1-32>
Parameters
<1-32>
Bridge name
<1-32>
Protection group id
Command Mode
Exec mode.
Applicability
This command was introduced before OcNOS version 5.0.
Examples
# manual-switch bridge 1 g8031 eps-id 10
mode
Use this command to configure mode for g8031 protection group.
Use the no form of this command to mode for g8031 protection group.
Note: Once mode is configured, it can not be changed. Administrator has to explicitly delete and re-configure a new mode.
Command Syntax
mode (one-and-one-bidirectional| one-plus-one-bidirectional| one-plus-one-unidirectional)
no mode
Parameters
one-and-one-bidirectional
1:1 Bidirectional mode
one-plus-one-bidirectional
1+1 Bidirectional mode
one-plus-one-unidirectional
1+1 Unidirectional mode
Command Mode
G8031 Switching Mode.
Applicability
This command was introduced before OcNOS version 5.0.
Examples
#configure terminal
(config)##g8031 eps-id 10 bridge 1
(g8031-config-switching)#mode one-and-one-bidirectional
primary-vlan
Use this command to configure a primary-vlan for g8031 protection group.
Use the no form of this command to delete primary-vlan for a g8031 protection group.
Note: Once mode is configured, primary-vlan can not be modified.
Command Syntax
primary-vlan <2-4094>
no primary-vlan
Parameters
<2-4094>
vlan id
Command Mode
G8031 Switching Mode.
Applicability
This command was introduced before OcNOS version 5.0.
Examples
#configure terminal
(config)#g8031 eps-id 10 bridge 1
(g8031-config-switching)#primary-vlan 3
protection-port
Use this command to configure a protection-port for a g8031 protection group.
Use the no form of this command to delete protection-port for a g8031 protection group.
Note: When both working and protection ports are in Signal-Failure state, Working Port will be treated as Active port i.e Protection group will be in Signal-Failure-Protection State.
Note: Working and Protection Paths between two ELPS end nodes should not coincide i.e When having intermediate nodes it is required that the working path and protection path are configured via different intermediate nodes.
Note: Working port should be Layer-2 Physical or LAG interface. Command is not applicable for subinterface.
Note: Protection port should be Layer-2 Physical or LAG interface. Command is not applicable for subinterface.
Command Syntax
protection-port IFNAME
no protection-port
Parameters
IFNAME
Interface name.
Command Mode
G8031 Switching Mode.
Applicability
This command was introduced before OcNOS version 5.0.
Examples
#configure terminal
(config)#g8031 eps-id 10 bridge 1
(g8031-config-switching)#protection-port xe10
revertive
Use this command to configure revertive switchover-type for g8031 protection group.
Use the no form of this command to set default switchover-type for g8031 protection group.
Command Syntax
revertive
no revertive
Parameters
None.
Default
Non-revertive.
Command Mode
G8031 Switching Mode.
Applicability
This command was introduced before OcNOS version 5.0.
Examples
#configure terminal
(config)#g8031 eps-id 10 bridge 1
(g8031-config-switching)#mode one-and-one-bidirectional
(g8031-config-switching)#revertive
show g8031 eps-id
Use this command to display the status of a particular g8031 protection group.
Command Syntax
show g8031 eps-id <1-32> bridge <1-32>
Parameters
<1-32>
Protection group id.
<1-32>
Bridge name.
Command Mode
Exec mode.
Applicability
This command was introduced before OcNOS version 5.0.
Examples
# show g8031 eps-id 10 bridge 1
=================================== Bridge:1 Eps-id:10 ===================================
Bridge Direction Revertive PVID Total-Vlans Working-Path Protection-Path
----------------------------------------------------------------------------------
1+1 Bi Yes 10 7 xe7 xe8
Active-Path Local-Freeze -Attached Request-Signal Current-State
-----------------------------------------------------------------------------------------
Working No Yes Null Signal Fail for Protection
dFOP State: Not in defect mode
APS Statistics
---------------
L-APS Rx count: 0
L-APS Tx count: 0
Table 2-13 explains the output fields:
Table 2-13: show g8031 eps-id output fields
Field | Description |
|---|
Bridge | Bridge id |
Eps-id | Protection group id |
Bridge | Architecture type - 1+1 or 1:1 |
Direction | Switching type - Bidirectional or Unidirectional |
Revertive | Switchover type revertive |
PVID | Primary vlan |
Total-vlans | Total number of g8031 vlans |
Working-path | Working port name |
Protection-path | Protection port name |
Active-path | Current active path |
Local-freeze | Protection group locally freezed or not |
-attached | Protection group attached to Meps or not |
Request Signal | Null or Normal Signal |
Current state | Protection group State as per State Machine |
dFop State | Defect type |
L-APS Rx count | Number of received g8031 L-APS control pkts |
L-APS Tx count | Number of transmitted g8031 L-APS control pkts |
show g8031 bridge
Use this command to display the status of all configured g8031 protection groups.
Command Syntax
show g8031 bridge <1-32>
Parameters
<1-32>
Bridge name
Command Mode
Exec mode
Applicability
This command was introduced before OcNOS version 5.0.
Examples
# show g8031 bridge 1
=================================== Bridge:1 Eps-id:10 ===================================
Bridge Direction Revertive PVID Total-Vlans Working-Path Protection-Path
----------------------------------------------------------------------------------
1+1 Bi Yes 10 7 xe7 xe8
Active-Path Local-Freeze -Attached Request-Signal Current-State
-----------------------------------------------------------------------------------------
Working No Yes Null Signal Fail for Protection
dFOP State: Not in defect mode
APS Statistics
---------------
L-APS Rx count: 0
L-APS Tx count: 0
=================================== Bridge:1 Eps-id:11 ===================================
Bridge Direction Revertive PVID Total-Vlans Working-Path Protection-Path
----------------------------------------------------------------------------------
1:1 Bi Yes 11 7 xe12 xe11
Active-Path Local-Freeze -Attached Request-Signal Current-State
-----------------------------------------------------------------------------------------
Working No Yes Null Signal Fail for Working
dFOP State: Not in defect mode
APS Statistics
---------------
L-APS Rx count: 1
L-APS Tx count: 2
Table 2-14 explains the output fields:
Table 2-14: show g8031 bridge output fields
Field | Description |
|---|
Bridge | Bridge id |
Eps-id | Protection group id |
Bridge | Architecture type - 1+1 or 1:1 |
Direction | Switching type - Bidirectional or Unidirectional |
Revertive | Switchover type revertive |
PVID | Primary vlan |
Total-vlans | Total number of g8031 vlans |
Working-path | Working port name |
Protection-path | Protection port name |
Active-path | Current active path |
Local-freeze | Protection group locally freezed or not |
Cfm-attached | Protection group attached to Meps or not |
Request Signal | Null or Normal Signal |
Current state | Protection group State as per State Machine |
dFop State | Defect type |
L-APS Rx count | Number of received g8031 L-APS control pkts |
L-APS Tx count | Number of transmitted g8031 L-APS control pkts |
show hsl g8031 debug
Use this command to display debugging related information of a particular g8031 protection group.
Command Syntax
show hsl g8031 debug <1-32>
Parameters
<1-32>
Protection group id
Command Mode
Exec mode
Applicability
This command was introduced before OcNOS version 5.0.
Examples
# show hsl g8031 debug 10
====================================================
G8031 PG:10 Debug Details
====================================================
Mode : 1+1 Bidir (Revertive)
Working Port : 5007
Protection Port : 5008
Active Port : Working-Port
---------------------------------------------------
Ingress Group-ID : 112
Cfm-Allow entry-id : 78 [InPort:5008]
Data-Block entry-id : 79 [InPort:5008]
Egress Group-ID : 115
Split-H entry-id : 80 [SrcPort:5007 DstPort:5008]
---------------------------------------------------
Stp States
Working-Port : Forward
Protection-Port : Forward
---------------------------------------------------
Table 2-15 explains the output fields:
Table 2-15: show hsl g8031 output fields
Field | Description |
|---|
PG | Protection group id |
Mode | Configured g8031 mode on protection group |
Working-Port | Working port ifindex |
Protection port | Protection port ifindex |
Active port | Current active port |
Ingress group id | Ingress bcm field group id. Valid for 1+1 only |
Cfm-allow entry id | Cfm related bcm entry is added in Ingress bcm field group. This displays entry-id of that field entry |
Data-block entry-id | Data traffic related bcm entry is added in Ingress bcm field group. This displays entry-id of that field entry |
Egress group id | Egress bcm field group id. Valid for 1+1 only |
Split-H entry-id | Split-Horizon related entry is added in Egress field group. This displays entry-id of that field entry |
Working-Port | Stp state of working port |
Protection-port | Stp state of protection port |
timer hold-off-time
Use this command to configure hold-off timer for g8031 protection group.
Use the no form of this command to set default hold-off timer value for a g8031 protection group.
Command Syntax
timer hold-off-time <0-10>
no timer hold-off-time
Parameters
<0-10>
Timer value in seconds.
Default
0 seconds.
Command Mode
Config mode.
Applicability
This command was introduced before OcNOS version 5.0.
Examples
#configure terminal
(config)#g8031 eps-id 10 bridge 1
(g8031-config-switching)#mode one-and-one-bidirectional
(g8031-config-switching)#revertive
(g8031-config-switching)#timer hold-off-time 3
timer wait-to-restore
Use this command to configure wait-to-restore timer for a g8031 protection group.
Use the no form of this command to set default wait-to-restore value for a g8031 protection group.
This command is only applicable for revertive mode.
Command Syntax
timer wait-to-restore <300-720>
no timer wait-to-restore
Parameters
<300-720>
Timer value in seconds.
Default
300 seconds.
Command Mode
G8031 Switching Mode.
Applicability
This command was introduced before OcNOS version 5.0.
Examples
#configure terminal
(config)#g8031 eps-id 10 bridge 1
(g8031-config-switching)#mode one-and-one-bidirectional
(g8031-config-switching)#revertive
(g8031-config-switching)#timer wait-to-restore 360
vlan
Use this command to configure protected data vlans for g8031 protection group.
Use the no form of this command to delete a data vlan for g8031 protection group.
Note: Once mode is configured, data vlans can not be modified.
Note: Data vlans have to be configured individually using vlan command i.e Range of vlans not accepted with vlan command.
Note: This command has no impact on data-plane i.e Unprotected vlans are not blocked by g8031 working and protection-ports. It is left upto the administrator to configure only protected vlans with bridge-port configuration of working and protection g8031 ports.
Command Syntax
vlan <2-4094>
no vlan <2-4094>
Parameters
<2-4094>
vlan-id.
Command Mode
G8031 Switching Mode.
Applicability
This command was introduced before OcNOS version 5.0.
Examples
#configure terminal
(config)#g8031 eps-id 10 bridge 1
(g8031-config-switching)#vlan 4
working-port
Use this command to configure a working-port for a g8031 protection group.
Use the no form of this command to delete working-port for a g8031 protection group.
Command Syntax
working-port IFNAME
no working-port
Parameters
IFNAME
Interface name.
Command Mode
G8031 Switching Mode.
Applicability
This command was introduced before OcNOS version 5.0.
Examples
#configure terminal
(config)#g8031 eps-id 10 bridge 1
(g8031-config-switching)#working-port xe10