G.8032 ERPS Version 2 Commands
This chapter contains the G.8032 (2012) Ethernet Ring Protection Switching (ERPS) version 2 commands.
aclif failover
Use this command to enable failover for the logical interface (LIF) resources, enhancing the LIFs hardware profile for ERPS.
Use the no parameter of this command to disable failover for the LIF resources, providing control over individual LIFs.
For more information, refer to the aclif failover command in the ERPS with CFM Down-MEP over Bridge-Domain section in the OcNOS Key Feature document, Release 6.4.1.
aps-channel level
Use this command to set the maintenance entity group (MEG) level (MEL) to carry in R-APS messages.
Command Syntax
aps-channel level <0-7>
Parameters
<0-7>
Level.
Command Mode
G.8032 configure switch mode
Examples
Here are sample examples of configuring G.8032 ERP instance with Automatic Protection Switching (APS) channel settings in OcNOS device.
OcNOS#configure terminal
OcNOS(config)#g8032 erp-instance instance1
OcNOS(g8032-config-switch)#aps-channel level 2
OcNOS(g8032-config-switch)#end
aps-channel vlan
Use this command to configure APS channel VLAN-ID for the ERP instance.
Use no parameter of this command to remove APS channel VLAN-ID configuration for the ERP instance.
Command Syntax
aps-channel vlan <2-4094> (inner-vlan <2-4094>|)
no aps-channel vlan
Parameters
<2-4094>
VLANID
inner-vlan
Inner vlan
<2-4094>
VLANID
Command Mode
G.8032 configure switch mode.
Applicability
This command was introduced before OcNOS version 5.0.
Examples
OcNOS#configure terminal
OcNOS(config)#g8032 erp-instance instance1
OcNOS(g8032-config-switch)#aps-channel vlan 10 inner-vlan 5
OcNOS(g8032-config-switch)#end
associate-ring
Use this command to configure a single ERPS instance to monitor multiple rings. All the rings associated with the associate-ring command must share the same parent interface as the primary ring mapped to the ERPS instance.
Note: The primary ring or instance is responsible for monitoring and managing multiple associate rings. However, it's important to note that only failures detected by the primary instance will trigger a switchover in all associated rings. Individual failures, such as link shutdowns on ring ports of associate rings, will not independently trigger failover switches in the associate rings. Instead, the primary instance must detect the failure for it to propagate to the associated rings.
For more information, refer to the associate-ring command in the ERPS with CFM Down-MEP over Bridge-Domain section in the OcNOS Key Feature document, Release 6.4.1.
clear g8032 erp-instance
Use this command to clear ERPS instance.
This command is used at an Ethernet ring node for the following operations:
• Clearing an active local administrative command (forced switch or manual switch).
• Triggering reversion before the wait to restore (WTR) or wait to block (WTB) timer expires in the case of revertive operation.
• Triggering reversion in the case of non-revertive operation.
Command Syntax
clear g8032 erp-instance (INSTANCENAME | all)
Parameters
INSTANCENAME
Instance name (maximum 32 characters).
all
Clear all instances.
Command Mode
Exec mode.
Applicability
This command was introduced before OcNOS version 5.0 and was revised in OcNOS version 6.4.1 by adding a new parameter called all.
Examples
The following command clear a specific ERPS instance in the network.
OcNOS#clear g8032 erp-instance INST1
The following command clear all ERPS instance in the network.
OcNOS#clear g8032 erp-instance all
data vlan
Use this command to configure VLANs as data channels.
Use the no form of this command to remove VLAN configuration.
Command Syntax
data vlan VLAN_RANGE
no data vlan VLAN_RANGE
Parameters
VLAN_RANGE
Enter VLAN ID 2-4094 or list of VLAN ID's separated by commas. Eg 2 or 2,4,5 or 50,51,52 etc.
Command Mode
G.8032 configure switch mode.
Applicability
This command was introduced before OcNOS version 5.0.
Examples
Here's an example of configuring G.8032 ERP instance with data VLANs 201, 202, and 203 in OcNOS device.
OcNOS#configure terminal
OcNOS(config)#g8032 erp-instance instance1
OcNOS(g8032-config-switch)#data vlan 201,202,203
OcNOS(g8032-config-switch)#end
debug g8032
Use this command to debug configuration.
Command Syntax
debug g8032 (all|tx|rx|fsm|timers|events|external|hal)
no debug g8032 (all|tx|rx|fsm|timers|events|external|hal)
Parameters
all
All debugging options
events
Protocol event
external
External CFM and NSM events
fsm
Instance Finite State Machine updates
hal
HAL events
rx
Received PDUs
timers
Protocol timer events
tx
Transmitted PDUs
Command Mode
Configure mode and Exec mode
Applicability
This command was introduced in OcNOS version 6.0.0.
Examples
Here's an example of enabling G.8032 debugging for both transmit (tx) and all events in OcNOS device.
OcNOS#configure terminal
OcNOS(config)#debug g8032 tx
OcNOS(config)#debug g8032 all
OcNOS(config)#exit
east-interface
Use this command to set the east port associated to the protection ring.
Command Syntax
east-interface IFNAME
no east-interface
Parameters
IFNAME
Interface name, such as xe1.
Command Mode
G8032 ring config mode.
Applicability
This command was introduced before OcNOS version 5.0.
Examples
The below example demonstrates the configuration of an ERPS ring named RING1 with the assignment of the east interface as ce1.
OcNOS#configure terminal
OcNOS(config)#g8032 ring RING1
OcNOS(g8032-ring-config)#east-interface ce1
OcNOS(g8032-ring-switch)#end
enable-tcn-propagation
Use this command to enable or disable TCN (topology change notification) propagation for an interconnected ring.
Command Syntax
enable-tcn-propagation
no enable-tcn-propagation
Parameters
None
Command Mode
G.8032 configure switch mode
Applicability
This command was introduced in OcNOS version 6.0.0.
Examples
In this example, the configuration for G.8032 ERP instance instance1 includes the enabling of topology change notification (TCN) propagation.
OcNOS#configure terminal
OcNOS(config)#g8032 erp-instance instance1
OcNOS(g8032-config-switch)#enable-tcn-propagation
OcNOS(g8032-config-switch)#end
erps-instance
Use this command to set the ERPS-instance for the sub-interface.
Use no parameter of this command to remove the ERPS-instance configuration from the sub-interface.
Command Syntax
erps-instance INSTANCENAME
no erps-instance
Parameters
INSTANCENAME
Name of the ERPS instance.
Command Mode
Interface mode.
Applicability
This command was introduced in OcNOS version 6.2.0 and was revised in OcNOS version 6.4.1 by removing a parameter called all.
Examples
The following configurations allow the association of an ERPS instance with a sub-interface. By configuring ERPS instances on sub-interfaces, it enables protection switching for specific network segments.
OcNOS#configure terminal
OcNOS(config)#interface xe2.1
OcNOS(config-if)#erps-instance erp1
OcNOS(config-if)#commit
OcNOS(config-if)#end
g8032 erp-instance
Use this command to create an ERP instance and change to G.8032 configure switch mode.
Use the no form of this command to delete an ERP instance.
Command Syntax
g8032 erp-instance INSTANCENAME
no g8032 erp-instance INSTANCENAME
Parameters
INSTANCENAME
Instance name (maximum 32 characters).
Command Mode
Configure mode
Examples
The below example demonstrates the configuration of G.8032 ERP instance with the instance name instance1.
OcNOS#configure terminal
OcNOS(config)#g8032 erp-instance instance1
OcNOS(g8032-config-switch)#end
g8032 erp-instance force-switch
Use this command to configure administrative commands related to force switching within ERPS instances.
Command Syntax
g8032 erp-instance (INSTANCE-NAME | all) force-switch (east-interface | west-interface)
Parameters
INSTANCENAME
Instance name (maximum 32 characters).
all
Apply to all instances.
east-interface
Apply command to east interface.
west-interface
Apply command to west interface.
Command Mode
Exec mode.
Applicability
This command was introduced before OcNOS version 5.0 and was revised in OcNOS version 6.4.1 by adding a new parameter called all.
Examples
The following commands allows to take manual control of ERPS instances and force traffic to switch to a specific interface (east or west) as needed for network protection.
OcNOS#g8032 erp-instance example force-switch east-interface
OcNOS#g8032 erp-instance all force-switch west-interface
g8032 erp-instance manual-switch
Use this command to configure manual protection switching for specific ERPS instances or for all instances on the device.
Command Syntax
g8032 erp-instance (INSTANCE-NAME | all) manual-switch (east-interface | west-interface)
Parameters
INSTANCENAME
Instance name (maximum 32 characters).
all
Apply to all instances.
east-interface
Apply command to east interface.
west-interface
Apply command to west interface.
Command Mode
Exec mode.
Applicability
This command was introduced before OcNOS version 5.0 and was revised in OcNOS version 6.4.1 by adding a new parameter called all.
Examples
The following commands are used to configure specific ERPS instances to perform manual switching on either the west or east interface as needed.
OcNOS#g8032 erp-instance example manual-switch west-interface
OcNOS#g8032 erp-instance all manual-switch east-interface
g8032 ring
Use this command to create a ring and associate east and west interfaces with it. All ERP instances on this ring have the same east and west interfaces,
Use the no form of this command to delete a ring.
Command Syntax
g8032 ring RINGNAME
no g8032 ring RINGNAME
Parameters
ring
Ring.
RINGNAME
Ring name (maximum 37 characters).
Command Mode
Configure mode
Examples
OcNOS#configure terminal
OcNOS(config)#g8032 ring ERPS123
OcNOS(config)#no g8032 ring ERPS123
OcNOS(config)#exit
g8032-profile
Use this command to associate the ERP instance to a profile. After configuring this command, it will take to the ERP profile configuration mode.
Command Syntax
g8032-profile PROFILENAME
Parameters
PROFILENAME
Profile name.
Command Mode
G.8032 configure switch mode
Examples
OcNOS#configure terminal
OcNOS(config)#g8032 erp-instance instance1
OcNOS(g8032-config-switch)#g8032-profile prof_1
OcNOS(g8032-profile-config)#end
g8032 profile
Use this command to associate the ERPS profile to an instance.
Use the no form of this command to delete the ERPS profile from an instance.
Command Syntax
g8032 profile PROFILENAME
Parameters
PROFILENAME
Profile name.
Command Mode
G.8032 configure switch mode
Examples
OcNOS#configure terminal
OcNOS(config)#g8032 erp-instance instance1
OcNOS(g8032-config-switch)#g8032-profile prof_1
hardware-profile aclif failover
Use this command to enable failover for the logical interface (LIF) resources, optimizing ERPS hardware failover ID.
Use the no parameter of this command to disable failover for the LIF resources.
Note: Recommend using per-interface-based Access Control List (ACL) failover on ERPS ring ports instead of a global profile.
For more information, refer to the hardware-profile aclif failover command in the ERPS with CFM Down-MEP over Bridge-Domain section in the OcNOS Key Feature document, Release 6.4.1.
non-virtual-channel
Use this command to make a sub-ring function without a virtual channel.
Use the no form of this command to delete a non-virtual channel.
Command Syntax
non-virtual-channel
no non-virtual-channel
Parameters
None.
Command Mode
G.8032 configure switch mode.
Applicability
This command was introduced before OcNOS version 5.0.
Examples
OcNOS#configure terminal
OcNOS(config)#g8032 erp-instance instance1
OcNOS(g8032-config-switch)#non-virtual-channel
ring
Use this command to associate the ERP instance to a ring.
Command Syntax
ring RINGNAME
Parameters
RINGNAME
Ring name.
Command Mode
G.8032 configure switch mode
Examples
OcNOS#configure terminal
OcNOS(config)#g8032 erp-instance instance1
OcNOS(g8032-config-switch)#ring ring1
ring-id
Use this command to set the ring identifier.
Command Syntax
ring-id <1-239>
Parameters
<1-239>
Ring identifier.
Command Mode
G.8032 configure switch mode.
Applicability
This command was introduced before OcNOS version 5.0.
Examples
OcNOS#configure terminal
OcNOS(config)#g8032 erp-instance instance1
OcNOS(g8032-config-switch)#ring-id 1
ring-type
Use this command to specify the type of the ethernet ring for this ERP instance.
Command Syntax
ring-type (major-ring | sub-ring | sub-ring-vc)
no ring-type
Parameters
major-ring
G.8032 major ring. In this type of rings nodes are connected in full circular topology
sub-ring
G.8032 sub-ring without virtual channel
sub-ring-vc
G.8032 sub-ring with virtual channel
Command Mode
G.8032 configure switch mode.
Applicability
This command was introduced before OcNOS version 5.0.
Examples
OcNOS#configure terminal
OcNOS(config)#g8032 erp-instance instance1
OcNOS(g8032-config-switch)#ring-type major-ring
OcNOS(g8032-config-switch)#ring-type sub-ring-vc
rpl role
Use this command to set the RPL (Ring Protection Link) role of the ring node.
Command Syntax
rpl role ((owner | neighbor | next-neighbor)(east-interface | west-interface) | non-owner )
Parameters
owner
Ring node is the RPL owner.
neighbor
Ring node is neighbor to the RPL owner.
next-neighbor
Ring node is neighbor to the neighbor of the RPL owner.
east-interface
Role assigned to east interface.
west-interface
Role assigned to west interface.
non-owner
Ring node does not own the RPL.
Command Mode
G.8032 configure switch mode.
Applicability
This command was introduced before OcNOS version 5.0.
Examples
OcNOS#configure terminal
OcNOS(config)#g8032 erp-instance instance1
OcNOS(g8032-config-switch)#rpl role owner east-interface
show g8032 erp-instance
Use this command to display details about an ERP instance.
Command Syntax
show g8032 erp-instance ((INSTANCENAME | data-traffic | summary)|)
Parameters
INSTANCENAME
Instance name.
data-traffic
Display data traffic details.
summary
Display summary details.
Command Mode
Exec mode.
Applicability
This command was introduced before OcNOS version 5.0 and revised in OcNOS version 6.4.1 by adding the new parameters data-traffic and summary.
Example
The below command display details about ERP instances:
OcNOS#show g8032 erp-instance
Instance ID State East state West state Ring
------------------------------------------------------------------------------------
phy_erp1 1 PENDING xe24 Blocked xe26 Unblocked PR1
sub_erp1 2 PROTECTION xe25 Blocked - - SR1
erp3 3 PROTECTION xe23 Blocked - - SR2
br_erp1 4 PENDING xe24.1 Blocked xe26.1 Unblocked BR1
Table 3-16 explains the output fields.
Table 3-16: show g8032 erp-instance
Field | Description |
|---|
Instance | Lists the names of the ERP instances. Each instance has a unique name. |
ID | Displays the ID of the ERP instance, which is a numerical identifier. |
State | Indicates the current state of the ERP instance. PENDING state means the instance is waiting for activation, while PROTECTION state means it's actively providing protection. |
East | Shows the interface on the east side (usually the primary side) of the ring. |
State | Displays the east state of the interface, which can be Blocked or Unblocked. In the context of ERP, Blocked means the interface is in standby or backup mode, and Unblocked means it's active. |
West | Shows the interface on the west side (usually the secondary side) of the ring. |
State | Displays the west state of the interface, |
Ring | Specifies the name or identifier of the ring associated with the ERP instance. |
The below command display data traffic details for ERP instances:
OcNOS#show g8032 erp-instance data-traffic
Instance ID Data-vlan East West Ring
-------------------------------------------------------------------------------------
phy_erp1 1 11-19 xe24 (B) xe26 (F) PR1
sub_erp1 2 50-60 xe25 (B) - SR1
br_erp1 4 bridge_domain 1 xe24.1 (B) xe26.1 (F) BR1
bridge_domain 2 xe24.2 xe26.2 BR2
Table 3-17 explains the output fields.
Table 3-17: show g8032 erp-instance data-traffic
Field | Description |
|---|
Instance | Lists the names of the ERP instances. Each instance has a unique name. |
ID | Displays the ID of the ERP instance, which is a numerical identifier. |
Data-vlan | Specifies the range of VLANs associated with data traffic for each ERP instance. |
East | Shows the interface on the east side (usually the primary side) of the ring that handles data traffic. |
West | Shows the interface on the west side (usually the secondary side) of the ring that handles data traffic. |
Ring | Specifies the name or identifier of the ring associated with the ERP instance. |
The below command display details for a specific ERP instance, in this case, erp0:
OcNOS#show g8032 erp-instance erp0
Inst Name : erp3 (3) ,node-id d0:77:ce:df:40:1b ,Profile (1)
Description :
Ring : SUB-RING (subring), OWNER (EAST), virtual (vlan 10, ring 2)
attached (-), attached to (erp1,erp2,erp3), tcn-propagation (0)
State : G8032_ST_PROTECTION
Timer Status : Init (0 min 4 sec), WTR (2 min 2 sec)
East : xe25, Blocked, Down, BPR (0), remote (d0:77:ce:df:40:1e)
West : xe24, Blocked, Down, BPR (0), remote (d0:77:ce:df:40:1f)
East (cfm) : mep-id (1), cc-interval (10ms), domain (10), MA (finance)
West (cfm) : mep-id (1), cc-interval (10ms), domain (10), MA (finance)
Channel : Level (5), vlan (20), RING_ID (2)
Data Vlan : 50-60
Table 3-18 explains the output fields.
Table 3-18: show g8032 erp-instance INSTANCENAME
Field | Description |
|---|
Inst Name | Provides information about the ERP instance, including its name, a numerical identifier, and a unique node ID. The profile number indicates the associated ERP profile. |
Description | Provides a description of the ERP instance. |
Ring | Specifies details about the ring associated with the ERP instance. |
State | Indicates the current state of the ERP instance. |
Timer Status | Displays timer-related information. |
East | Shows the interface on the east side (usually the primary side) of the ring. |
West | Shows the interface on the west side (usually the secondary side) of the ring. |
East(cfm) | Provides CFM-related details for the east side. |
West(cfm) | Provides CFM-related details for the west side. |
Channel | Provides information about the ERP channel, including: ERP level VLAN associated with the channel Ring ID |
Data Vlan | Specifies the range of VLANs associated with data traffic for the ERP instance. |
show g8032 profile
Use this command to display details about a profile.
Command Syntax
show g8032 profile PROFILENAME
Parameters
PROFILENAME
Profile name.
Command Mode
Exec mode.
Applicability
This command was introduced before OcNOS version 5.0.
Examples
OcNOS#show g8032 profile profile1
Profile : profile1
=========
Wait-To-Restore : 5 mins
Hold Off Timer : 0 secs
Guard Timer : 500 ms
Wait-To-Block : 5500 ms
Protection Type : Revertive
show g8032 ring
Use this command to display details about a ring.
Command Syntax
show g8032 ring RINGNAME
Parameters
RINGNAME
Ring name.
Command Mode
Exec mode.
Applicability
This command was introduced before OcNOS version 5.0.
Examples
OcNOS#show g8032 ring ring1
Ring : ring1
==========
East : eth1
West : eth2
ERP Inst : inst1, inst2, inst3
switching mode
Use this command to set the revertive behavior of the ring node.
Command Syntax
switching mode (non-revertive | revertive)
Parameters
revertive
Represents revertive mode operation of a G.8032 ethernet ring.
non-revertive
Represents non-revertive mode operation of a G.8032 ethernet ring.
Command Mode
G.8032 profile configure mode.
Applicability
This command was introduced before OcNOS version 5.0.
Examples
OcNOS#configure terminal
OcNOS(config)#g8032 erp-instance instance1
OcNOS(g8032-config-switch)#switching mode revertive
tcn-to-instance
Use this command to associate TCN instance (topology change notification) propagation for an interconnected ring when configured in non-virtual mode.
Command Syntax
tcn-to-instance INSTANCENANME
Parameters
INSTANCENAME
Instance name.
Command Mode
G.8032 configure switch mode.
Applicability
This command was introduced before OcNOS version 5.0.
Examples
OcNOS#configure terminal
OcNOS(config)#g8032 erp-instance instance1
OcNOS(g8032-config-switch)#tcn-to-instance erp1
timer
Use this command to set timers.
Command Syntax
timer (wait-to-restore <1-12> | hold-off <0-10000> | guard-time <10-2000>)
Parameters
wait-to-restore
Wait-to-restore timer used to verify that a signal failure is not intermittent.
<1-12>
Timer value in minutes.
hold-off
Hold-off timer used to filter intermittent link faults.
<0-10000>
Timer value in a multiple of 100 milliseconds.
guard-time
Guard timer that blocks latent outdated messages from causing unnecessary state changes.
<1-20000>
Timer value in a multiple of 10 milliseconds.
Command Mode
G.8032 profile configure mode
Examples
OcNOS#configure terminal
OcNOS(config)#interface xe3
OcNOS(config-if)#channel-group 2 mode active
OcNOS(config-if)#ethernet cfm domain-type character-string domain-name nod12 level 7 mip-creation none
OcNOS(config-ether-cfm)#g8032 ring lagring
OcNOS(g8032-ring-config)#east-interface po1
OcNOS(g8032-ring-config)#g8032 profile profile1
OcNOS(g8032-profile-config)#timer wait-to-restore 7
OcNOS(g8032-profile-config)#timer hold-off 50
OcNOS(g8032-profile-config)#timer guard-time 300
OcNOS(g8032-profile-config)#timer guard-time 30
OcNOS(g8032-profile-config)#end
virtual-channel
Use this command on a sub-ring to attach it to a major instance.
Use the no form of this command to delete a virtual channel.
Command Syntax
virtual-channel (<2-4094>|) attached-to-instance INSTANCENAME
no virtual-channel
Parameters
<2-4094>
VLAN identifier.
INSTANCENAME
Major instance name.
Command Mode
G.8032 configure switch mode.
Applicability
This command was introduced before OcNOS version 5.0.
Examples
OcNOS#configure terminal
OcNOS(config)#g8032 erp-instance instance1
OcNOS(g8032-config-switch)#virtual-channel 3 attached-to-instance inst1
west-interface
Use this command to set the west port associated to the protection ring.
Command Syntax
west-interface IFNAME
no west-interface
Parameters
IFNAME
Interface name
Command Mode
G8032 ring config mode.
Applicability
This command was introduced before OcNOS version 5.0.
Examples
OcNOS#configure terminal
OcNOS(config)#interface xe2
OcNOS(config-if)#g8032 ring RING1
OcNOS(g8032-ring-config)#west-interface ce1
OcNOS(g8032-ring-config)#end