G8031 ELPS Commands
This chapter describes the G8031 Ethernet Linear Protection Switching (ELPS) commands.
aps-channel level
Use this command to associate CFM with g8031 protection group to carry APS message.
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
aps-channel level <0-7>
Parameters
<0-7>
Maintainance Endpoint Level.
Command Mode
G8031 Switching Mode.
Applicability
This command was introduced before OcNOS version 5.0.
Examples
(config)#g8031 eps-instance eps1
(g8031-config-eps-instance)#aps-channel level 7
backup
Use this command to configure backup interface (protection port) under cross-connect for bridge-domain case.
Command Syntax
Backup IFPBKPNAME
Parameters
IFPBKPNAME
AC Interface Backup Name.
Default
0 seconds.
Command Mode
Config Backup Crossconnect Mode.
Applicability
This command was introduced in OcNOS version 6.5.2.
Examples
#configure terminal
(config)#cross-connect 1
(config-xc)#interface xe10.1
(config-bkp-xc)#backup xe11.1
clear
Use this command to perform clear operation on g8031 protection group based on instance name.
Command Syntax
clear g8031 eps-instance <INSTANCENAME>
Parameters
<INSTANCENAME>
g8031 instance name.
Command Mode
Exec mode.
Applicability
This command was introduced in OcNOS version 6.5.2.
Examples
# clear g8031 eps-instance eps1
control-vlan
Use this command to configure a contro-vlan for g8031 protection group.
Use the no form of this command to delete control-vlan for a g8031 protection group.
Command Syntax
control-vlan <2-4094>
control vlan <2-4094> inner-vlan <2-4094>
Parameters
<2-4094>
vlan id.
Command Mode
G8031 Instance Mode.
Applicability
This command was introduced in OcNOS version 6.5.2.
Examples
#configure terminal
(config)#g8031 eps-instance eps2
(g8031-config-eps-instance)#control vlan 3
(g8031-config-eps-instance)#control vlan 3 inner-vlan 500
data 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.
• Data vlans have to be configured individually using vlan command i.e Range of vlans not accepted with vlan command.
• 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
data vlan <2-4094>
no data vlan <2-4094>
Parameters
<2-4094>
vlan-id.
Command Mode
G8031 Switching Mode.
Applicability
This command was introduced in OcNOS version 6.5.2.
Examples
#configure terminal
(config)#g8031 eps-instance eps1
(g8031-config-eps-instance)#data vlan 4-20
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
eps-protection-group
Use this command to map configured working/protection port under g8031 instance.
Use the no form of this command to unmap eps-protection group from g8031 instance.
Command Syntax
eps-protection-group <WORD>
no eps-protection-group
Parameters
Word
eps protection group name in string.
Command Mode
G8031 Config EPS Instance Mode.
Applicability
This command was introduced in OcNOS version 6.5.2.
Examples
#configure terminal
(config)#g8031 eps-instance eps1
(g8031-config-eps-instance)#eps-protection-group eps1
exercise
Use this command to perform exercise operation on g8031 protection group based on instance name.
Use the clear command to clear exercise operation from g8031 protection group.
Command Syntax
g8031 eps-instance <INSTANCENAME> exercise
Parameters
<1-32>
g8031 instance name.
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 based on instance name.
Use the clear command to clear force-switch operation from g8031 protection group.
Command Syntax
g8031 eps instance <INSTANCENAME> force-switch
Parameters
<INSTANCENAME>
g8031instance name.
Command Mode
Exec mode
Applicability
This command was introduced in OcNOS version 6.5.2.
Examples
# g8031 eps-instance eps1 force-switch
# clear g8031 eps-instance eps1
g8031-eps
Use this command to map eps protection group under cross-connect were g8031 can be extended over bridge-domain.
Use the no form to unmap eps protection group from cross-connect.
Command Syntax
g8031-eps <EVCID>
no g8031-eps <EVCID>
Parameters
<EVCID>
EVC ID.
Command Mode
Config Backup Crossconnect Mode.
Applicability
This command was introduced in OcNOS version 6.5.2.
Examples
#configure terminal
(config)#cross-connect 1
(config-xc)#interface xe10.1
(config-bkp-xc)#backup xe11.1
(config-bkp-xc)#g8031-eps eps1
g8031 eps-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.
Command Syntax
g8031 eps-instance <INSTANCENAME>
Parameters
<INSTANCENAME>
g8031 instance name.
Command Mode
Config Mode.
Applicability
This command was introduced in OcNOS version 6.5.2.
Examples
(config)#g8031 eps-instance eps1
g8031 eps-protection group
Use this command to configure working/protection port for g8031 eps protection.
Use the no form of this command to remove eps protection group.
Command Syntax
g8031 eps-protection group <WORD>
no g8031 eps-protection group <WORD>
Parameters
<WORD>
EPS protection group name in string.
Command Mode
Config Mode.
Applicability
This command was introduced in OcNOS version 6.5.2.
Examples
#configure terminal
(config)#g8031 eps-protection group eps1
g8031 profile
Use this command to configure g8031 mode, switching mode and timer-status for g8031 protection group.
Use the no form of this command to remove profile.
Command Syntax
g8031 profile <WORD>
no g8031 profile <WORD>
Parameters
WORD
eps profile name in string.
Command Mode
Config Mode.
Applicability
This command was introduced in OcNOS version 6.5.2.
Examples
#configure terminal
(config)#g8031 eps-instance eps1
local-freeze
Use this command to locally freeze the g8031 protection group.
Use the clear command to clear local-freeze from g8031 protection group.
Command Syntax
g8031 eps-instance <INSTANCENAME> local-freeze
clear g8031 eps-instance <INSTANCENAME> local-freeze
Parameters
<INSTANCENAME>
g8031 instance name.
Command Mode
Exec mode
Applicability
This command was introduced in OcNOS version 6.5.2.
Examples
#g8031 eps-instance eps1 local-freeze
#clear g8031 eps-instance eps1 local-freeze
local-lockout
Use this command to configure local lockout for g8031 protection group.
Use the clear command to clear local-lockout operation from g8031 protection group.
Command Syntax
g8031 eps-instance <INSTANCENAME> local-lockout
clear g8031 eps-instance <INSTANCENAME> local-lockout
Parameters
<INSTANCENAME>
g8031 instance name.
Command Mode
Exec mode
Applicability
This command was introduced in OcNOS version 6.5.2.
Examples
# g8031 eps-instance eps1 local-lockout
# clear g8031 eps-instance eps1 local-lockout
lockout
Use this command to lockout for g8031 protection group.
Use the clear command to remove lockout from g8031 protection group.
Command Syntax
g8031 eps-instance <INSTANCENAME> lockout
Parameters
<INSTANCENAME>
g8031 instance name.
Command Mode
Exec mode
Applicability
This command was introduced in OcNOS version 6.5.2.
Examples
# g8031 eps-instance eps1 lockout
# clear g8031 eps-instance eps1
manual-switch-protection
Use this command to perform manual-switch for protection port.
Use the clear command to remove manual switch.
Command Syntax
g8031 eps-instance <INSTANCENAME> manual-switch-protection
Parameters
<INSTANCENAME>
g8031 instance name.
Command Mode
Exec Mode.
Applicability
This command was introduced in OcNOS version 6.5.2.
Examples
# g8031 eps-instance eps1 manual-switch-protection
# clear g8031 eps-instance eps1
manual-switch-working
Use this command to perform manual-switch for working port.
Use the clear command to remove manual switch.
Command Syntax
g8031 eps-instance <INSTANCENAME> manual-switch-working
Parameters
<INSTANCENAME>
g8031 instance name.
Command Mode
Exec Mode.
Applicability
This command was introduced in OcNOS version 6.5.2.
Examples
# g8031 eps-instance eps1 manual-switch-working
# clear g8031 eps-instance eps1
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)
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 Profile Mode.
Applicability
This command was introduced in OcNOS version 6.5.2.
Examples
#configure terminal
(config)#g8031 profile eps1
(g8031-config-profile)#mode one-and-one-bidirectional
protection-port
Use this command to configure a protection-port for a g8031 protection group.
Use the no fform 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 is treated as Active port, and Protection group is in Signal-Failure-Protection State.
• 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.
• Working port should be Layer-2 Physical or LAG interface. Command is also applicable for sub-interface.
• Protection port should be Layer-2 Physical or LAG interface. Command also applicable for sub-interface.
Command Syntax
protection-port IFNAME
no protection-port
Parameters
IFNAME
Interface name.
Command Mode
G8031 Config Protection Mode.
Applicability
This command was introduced in OcNOS version 6.5.2.
Examples
#configure terminal
(config)#g8031 eps-protection group eps1
(g8031-config-protection)#protection-port ge10.1
show g8031 eps-instance
Use this command to display the status of all configured g8031 protection groups.
Command Syntax
show g8031 eps-instance
Parameters
None
Command Mode
Exec mode
Applicability
This command was introduced from OcNOS version 6.5.2.
Examples
#show g8031 eps-instance
EPS-Name Id Mode Working-Path State Protection-Path State Control-VLAN CFM
---------------------------------------------------------------------------------------
eps1 1 1:1,BI xe6.1 Up ge9.1 (A) Up 11 Yes
eps2 1 1:1,BI ge9.2 Up xe6.2 (A) Up 500 Yes
Table 2-13 explains the output fields:
Table 2-13: show g8031 eps-instance bridge output fields
Field | Description |
|---|
EPS Name | Eps instance name |
ID | Protection group id |
Mode | Architecture type - 1+1 or 1:1 and Directional (Uni/Bi) |
Working path | Working port |
Protection path | Protection port |
(A) | Active Path |
CFM | Working/protection MEP is configured and UP (Yes) Working/protection MEP is DOWN (No) |
show g8031 eps-instance <EPS_ID>
Use this command to display the status of a particular g8031 protection group.
Command Syntax
show g8031 eps-instance <EPS_ID>
Parameters
<EPS-ID>
EPS instance name.
Command Mode
Exec mode.
Applicability
This command was introduced in OcNOS version 6.5.2.
Examples
# show g8031 eps-instance eps1
Inst Name : eps1 (1), Profile (eps1), Protection Group (eps1)
Mode & Group : Bridge (1:1), Direction (Bi), Revertive (Yes)
: Working port (xe6.1, Up) Protection port (ge9.1, Up)
Current State : Wait-To-Restore, Request signal (Normal), Active-Path(Protection)
dFOP State - Not in defect mode
Timer Status : WTR (8 min 57 sec),
working_cfm : mep_id (21), cc-interval (3ms), Domain (md001), MA (ma1)
Protection_cfm : mep_id (11), cc-interval (3ms), Domain (md002), MA (ma2)
APS channel Info: vlan (11) Level (7)
APS Statistics : Tx - 18 Rx – 18
Table 2-14 explains the output fields:
Table 2-14: show g8031 eps-instance output fields
Field | Description |
|---|
Inst Name | Protection group instance, profile and protection group name |
Mode & Group | Bridge (1:1 / 1+1),Direction (Uni/Bi), switching mode (revertive/non-revertive) |
Current State | No request/Signal Fail/Wait-to-Restore, Active path (Working/Protection) dFOP state (defect mode). |
Timer Status | WTR/Hold-Off timers |
Working_cfm | Working CFM MEP with mep_id, cc-interval, domain and ma |
Protection-cfm | Working CFM MEP with mep_id, cc-interval, domain and ma |
APS-Channel | Control vlan and APS Level |
Vlan | Data vlan |
APS Statistics | APS PDU TX and RX |
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
Service type: XC (Subinterface)
# show hsl g8031 debug 1
EPS_ID Mode Service Working_port Protection_port Active_port Failover
------+-------+----------------+-----------------+-------------------+------------+--
1 1:1,Bi XC po1.2 sa1.2 Working 40000005
Table 2-15 explains the output fields:
Table 2-15: show hsl g8031 output fields
Field | Description |
|---|
EPS ID | Protection group id |
Mode | Configured g8031 mode on protection group |
Service | XC(Subinterface) / L2 Bridge |
Working port | Working port |
Protection port | Protection port |
Active Ingress | Working/Protection port |
Failover | Egress failover |
switching mode
Use this command to configure revertive/non-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
switching mode (revertive | non-revertive)
no switching mode
Parameters
None
Default
Non-revertive.
Command Mode
G8031 Profile Mode.
Applicability
This command was introduced in OcNOS version 6.5.2.
Examples
#configure terminal
(config)#g8031 profile eps1
(g8031-config-profile)#switching mode revertive
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
G8031 Profile Mode.
Applicability
This command was introduced in OcNOS version 6.5.2.
Examples
#configure terminal
(config)#g8031 profile eps1
(g8031-config-profile)#timer hold-off 2
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.
Note: 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 Profile Mode.
Applicability
This command was introduced in OcNOS version 6.5.2.
Examples
#configure terminal
(config)#g8031 profile eps1
(g8031-config-profile)#timer wait-to-restore 360
working-port
Use this command to configure a working-port for a g8031 protection group.
Use the no form of this command delete working-port for a g8031 protection group.
Command Syntax
working-port IFNAME
no working-port
Parameters
IFNAME
Interface name.
Command Mode
G8031 Config Protection Mode.
Applicability
This command was introduced in OcNOS version 6.5.2.
Examples
#configure terminal
(config)#g8031 eps-protection group eps1
(g8031-config-protection)#working-port xe10